@owney/sdk 0.7.16-beta.7 → 0.7.17-beta.0

package/dist/index.js

@@ -1,29 +1,164 @@
-import {
-  debugLog,
-  fetchAgentKeys,
-  fetchOrgAgentConfig,
-  setOwneyDebug
-} from "./chunk-QA7JUSDB.js";
-import {
-  buildTransferWithAuthorizationTypedData,
-  randomAuthNonce,
-  readTokenMeta
-} from "./chunk-5LU2SHO7.js";
-import {
-  ERC20_ALLOWANCE_ABI,
-  MAX_UINT256,
-  PERMIT2_ADDRESS,
-  buildPermitTransferFromTypedData,
-  randomPermit2Nonce,
-  readErc20Balance,
-  readPermit2Allowance
-} from "./chunk-DBRXNDSB.js";
-import {
-  AgentChainIncompatibleError,
-  AgentNotFoundError,
-  NotConnectedError,
-  OwneyError
-} from "./chunk-GMNQBWUB.js";
+// src/errors.ts
+var OwneyError = class extends Error {
+  code;
+  details;
+  agentId;
+  constructor(code, message, details, agentId) {
+    const prefix = agentId ? `[${code}][agent:${agentId}]` : `[${code}]`;
+    super(`${prefix} ${message}`);
+    this.name = "OwneyError";
+    this.code = code;
+    this.details = details;
+    this.agentId = agentId;
+  }
+};
+var AgentNotFoundError = class extends OwneyError {
+  constructor(agentId, available) {
+    super(
+      "AGENT_NOT_FOUND",
+      `Unknown agent "${agentId}". Available agents: ${available.join(", ")}`,
+      { agentId, available },
+      agentId
+    );
+    this.name = "AgentNotFoundError";
+  }
+};
+var NotConnectedError = class extends OwneyError {
+  constructor() {
+    super("NOT_CONNECTED", "Not connected. Call sdk.connect(provider) first.");
+    this.name = "NotConnectedError";
+  }
+};
+var AgentChainIncompatibleError = class extends OwneyError {
+  incompatibleAgents;
+  connectedChainId;
+  constructor(incompatibleAgents, connectedChainId) {
+    const details = incompatibleAgents.map(
+      ({ agentId, supportedChainIds }) => `"${agentId}" supports chains [${supportedChainIds.join(", ")}]`
+    ).join("; ");
+    super(
+      "AGENT_CHAIN_INCOMPATIBLE",
+      `Chain ${connectedChainId} is not supported by the following agents: ${details}`,
+      { incompatibleAgents, connectedChainId }
+    );
+    this.name = "AgentChainIncompatibleError";
+    this.incompatibleAgents = incompatibleAgents;
+    this.connectedChainId = connectedChainId;
+  }
+};
+
+// src/lib/rate-limit.ts
+function rateLimitDelay(error, now = Date.now()) {
+  const seen = /* @__PURE__ */ new Set();
+  let limited = false;
+  let delay = 0;
+  function visit(value, depth = 0) {
+    if (depth > 6 || value == null) return;
+    if (typeof value === "string") {
+      if (/rate[ _-]?limit|too many requests|HTTP_429|\b429\b/i.test(value))
+        limited = true;
+      return;
+    }
+    if (typeof value !== "object" || seen.has(value)) return;
+    seen.add(value);
+    const record = value;
+    if ([record.status, record.statusCode, record.code].some(
+      (code) => String(code) === "429"
+    )) {
+      limited = true;
+    }
+    for (const key2 of ["retryAfterSeconds", "retryAfter"]) {
+      const seconds = Number(record[key2]);
+      if (Number.isFinite(seconds) && seconds > 0)
+        delay = Math.max(delay, seconds * 1e3);
+    }
+    const retryAt = Number(record.retryAt);
+    if (Number.isFinite(retryAt) && retryAt > now)
+      delay = Math.max(delay, retryAt - now);
+    const headers = record.headers;
+    const header = typeof headers?.get === "function" ? headers.get("Retry-After") : headers?.["retry-after"] ?? headers?.["Retry-After"];
+    if (typeof header === "string" || typeof header === "number") {
+      const seconds = Number(header);
+      const ms = Number.isFinite(seconds) ? seconds * 1e3 : Date.parse(String(header)) - now;
+      if (Number.isFinite(ms) && ms > 0) delay = Math.max(delay, ms);
+    }
+    for (const key2 of [
+      "message",
+      "code",
+      "cause",
+      "details",
+      "response",
+      "data",
+      "fields"
+    ]) {
+      visit(record[key2], depth + 1);
+    }
+    for (const key2 of ["agentErrors", "failures"]) {
+      const entries = record[key2];
+      if (entries && typeof entries === "object") {
+        for (const entry of Object.values(entries)) visit(entry, depth + 1);
+      }
+    }
+  }
+  visit(error);
+  return limited ? delay : void 0;
+}
+
+// src/lib/agent-reads.ts
+var AgentReads = class {
+  inFlight = /* @__PURE__ */ new Map();
+  cooldowns = /* @__PURE__ */ new Map();
+  // A reconnect must not reuse work started by the previous connection.
+  clearInFlight() {
+    this.inFlight.clear();
+  }
+  limited(agentId, until) {
+    return new OwneyError(
+      "AGENT_RATE_LIMITED",
+      "Too many requests. Please wait before trying again.",
+      {
+        statusCode: 429,
+        retryAt: until,
+        retryAfterSeconds: Math.max(0, Math.ceil((until - Date.now()) / 1e3))
+      },
+      agentId
+    );
+  }
+  run(agentId, key2, fetch2) {
+    const cooldown = this.cooldowns.get(agentId);
+    if (cooldown && cooldown.until > Date.now()) {
+      return Promise.reject(this.limited(agentId, cooldown.until));
+    }
+    const requestKey = JSON.stringify([agentId, key2]);
+    const existing = this.inFlight.get(requestKey);
+    if (existing) return existing;
+    const promise = Promise.resolve().then(fetch2).then(
+      (value) => {
+        if (this.cooldowns.get(agentId) === cooldown)
+          this.cooldowns.delete(agentId);
+        return value;
+      },
+      (error) => {
+        const requestedDelay = rateLimitDelay(error);
+        if (requestedDelay === void 0) throw error;
+        const previous = this.cooldowns.get(agentId);
+        const failures = previous && previous.until > Date.now() ? previous.failures : Math.min((previous?.failures ?? 0) + 1, 5);
+        const delay = Math.max(
+          requestedDelay,
+          Math.min(3e4 * 2 ** (failures - 1), 3e5)
+        );
+        const until = Math.max(previous?.until ?? 0, Date.now() + delay);
+        this.cooldowns.set(agentId, { until, failures });
+        throw this.limited(agentId, until);
+      }
+    ).finally(() => {
+      if (this.inFlight.get(requestKey) === promise)
+        this.inFlight.delete(requestKey);
+    });
+    this.inFlight.set(requestKey, promise);
+    return promise;
+  }
+};
 
 // src/agents/zyfai/zyfai.agent.ts
 import { SMART_SESSIONS_VALIDATOR, ZyfaiSDK } from "@zyfai/sdk";
@@ -77,6 +212,23 @@ var SupportedAssets = [
   }
 ];
 
+// src/lib/debug.ts
+var configuredDebug = false;
+function setOwneyDebug(enabled) {
+  configuredDebug = enabled;
+}
+function isOwneyDebug() {
+  return globalThis.__OWNEY_DEBUG__ === true || configuredDebug;
+}
+function debugLog(scope, message, data) {
+  if (!isOwneyDebug()) return;
+  if (data === void 0) {
+    console.log(`[${scope}] ${message}`);
+  } else {
+    console.log(`[${scope}] ${message}`, data);
+  }
+}
+
 // src/lib/utils.ts
 var isValidChainId = (chainId) => {
   if (!SUPPORTED_CHAIN_IDS.includes(chainId)) {
@@ -88,12 +240,6 @@ var isValidChainId = (chainId) => {
   }
   return chainId;
 };
-function isSameAsset(tokenSymbol, asset) {
-  const token = tokenSymbol.toLowerCase();
-  const target = asset.toLowerCase();
-  if (token === target) return true;
-  return target === "weth" && token === "eth" || target === "eth" && token === "weth";
-}
 function hexToDecimal(hex, decimals = 6) {
   const normalized = hex.startsWith("0x") || hex.startsWith("0X") ? hex : `0x${hex}`;
   const parsed = BigInt(normalized);
@@ -886,7 +1032,10 @@ var ZyfaiAgent = class _ZyfaiAgent {
   // successful decode is cached forever; failures are NOT cached so a transient
   // RPC error retries on the next fetch.
   withdrawAmountCache = /* @__PURE__ */ new Map();
-  earningsRefreshInFlight = null;
+  earningsReads = /* @__PURE__ */ new Map();
+  earningsRefreshes = /* @__PURE__ */ new Map();
+  earningsSnapshot = null;
+  earningsGeneration = 0;
   constructor(apiKey, rpcUrls, referralSource) {
     this.rpcUrls = rpcUrls ?? DEFAULT_ZYFAI_RPC_URLS;
     this.sdk = new ZyfaiSDK({
@@ -1131,6 +1280,10 @@ var ZyfaiAgent = class _ZyfaiAgent {
   }
   // --- IAgent: Connection lifecycle ---
   async disconnect() {
+    this.earningsGeneration++;
+    this.earningsReads.clear();
+    this.earningsRefreshes.clear();
+    this.earningsSnapshot = null;
     if (this.connectedAddress && this.connectedChainId !== null) {
       clearSession(this.connectedAddress, this.connectedChainId);
     }
@@ -1327,37 +1480,6 @@ var ZyfaiAgent = class _ZyfaiAgent {
       );
     }
   }
-  /**
-   * Records the deposit with Zyfai, retrying transient failures.
-   *
-   * This runs AFTER the transfer has already landed on-chain, so it must never
-   * fail the deposit — the funds moved. But it is also the ONLY source of the
-   * "Top up wallet" entry the history is built from: Zyfai auto-deploys the
-   * balance it detects either way, so when this call is lost the user's deposit
-   * never appears in Activity (an earlier withdrawal stays the newest row) and
-   * nothing ever backfills it. Retry, then log loudly enough to be recoverable.
-   */
-  async logDepositWithRetry(chainId, txHash, amount, tokenAddress) {
-    const ATTEMPTS = 3;
-    const RETRY_DELAY_MS = 1e3;
-    for (let attempt = 1; attempt <= ATTEMPTS; attempt++) {
-      try {
-        await (tokenAddress ? this.sdk.logDeposit(chainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(chainId, txHash, amount));
-        return;
-      } catch (logError) {
-        if (attempt === ATTEMPTS) {
-          console.error(
-            "[owney-sdk] Deposit landed on-chain but logDeposit failed \u2014 it will be missing from Zyfai history:",
-            { txHash, chainId, amount, tokenAddress, error: logError }
-          );
-          return;
-        }
-        await new Promise(
-          (resolve) => setTimeout(resolve, RETRY_DELAY_MS * attempt)
-        );
-      }
-    }
-  }
   /**
    * True when `smartWallet` is the backend-managed pool wallet Zyfai assigned
    * to this EOA — the "new wallet" kind that is predeployed on the chains it
@@ -1661,12 +1783,14 @@ var ZyfaiAgent = class _ZyfaiAgent {
         );
         const txHash = await depositCallback(smartWallet, validChainId, amount);
         const tokenAddress = asset === "WETH" ? WETH_ADDRESS_BY_CHAIN[validChainId] : void 0;
-        await this.logDepositWithRetry(
-          validChainId,
-          txHash,
-          amount,
-          tokenAddress
-        );
+        try {
+          await (tokenAddress ? this.sdk.logDeposit(validChainId, txHash, amount, tokenAddress) : this.sdk.logDeposit(validChainId, txHash, amount));
+        } catch (logError) {
+          console.warn(
+            "[owney-sdk] Deposit landed on-chain but logDeposit failed (non-fatal):",
+            logError
+          );
+        }
         return { txHash, smartWallet, amount };
       }
       await this.ensureWalletDeployed(this.getAddress(), validChainId);
@@ -1708,26 +1832,59 @@ var ZyfaiAgent = class _ZyfaiAgent {
     const raw = await this.sdk.getPortfolio(this.getAddress());
     return mapBalances(raw, validChainId, smartWallet);
   }
+  earningsKey(state, chainId, smartWallet) {
+    return JSON.stringify([
+      state.walletAddress?.toLowerCase(),
+      chainId,
+      smartWallet.toLowerCase()
+    ]);
+  }
+  readEarnings(key2, smartWallet) {
+    const existing = this.earningsReads.get(key2);
+    if (existing) return existing;
+    const generation = this.earningsGeneration;
+    const pending = Promise.resolve().then(() => this.sdk.getOnchainEarnings(smartWallet)).then((raw) => {
+      if (generation === this.earningsGeneration) {
+        this.earningsSnapshot = { key: key2, raw, at: Date.now() };
+      }
+      return raw;
+    }).finally(() => {
+      if (this.earningsReads.get(key2) === pending)
+        this.earningsReads.delete(key2);
+    });
+    this.earningsReads.set(key2, pending);
+    return pending;
+  }
   async getEarnings(state, chainId) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-    const raw = await this.sdk.getOnchainEarnings(smartWallet);
+    const raw = await this.readEarnings(
+      this.earningsKey(state, chainId, smartWallet),
+      smartWallet
+    );
     return mapEarnings(raw, smartWallet);
   }
   async refreshEarnings(state, chainId) {
-    if (this.earningsRefreshInFlight) return this.earningsRefreshInFlight;
-    this.earningsRefreshInFlight = (async () => {
-      const { smartWallet } = await this.resolveSmartWallet(state, chainId);
-      const current = await this.sdk.getOnchainEarnings(smartWallet);
+    const { smartWallet } = await this.resolveSmartWallet(state, chainId);
+    const key2 = this.earningsKey(state, chainId, smartWallet);
+    const existing = this.earningsRefreshes.get(key2);
+    if (existing) return existing;
+    const generation = this.earningsGeneration;
+    const pending = (async () => {
+      const recent = this.earningsSnapshot;
+      const current = recent?.key === key2 && Date.now() - recent.at < 5e3 ? recent.raw : await this.readEarnings(key2, smartWallet);
       const lastCheck = current.data.lastCheckTimestamp ? Date.parse(current.data.lastCheckTimestamp) : Number.NaN;
       const isFresh = Number.isFinite(lastCheck) && Date.now() - lastCheck < EARNINGS_REFRESH_COOLDOWN_MS;
       const earnings = isFresh ? current : await this.sdk.calculateOnchainEarnings(smartWallet);
+      if (!isFresh && generation === this.earningsGeneration) {
+        this.earningsSnapshot = { key: key2, raw: earnings, at: Date.now() };
+      }
       return mapEarnings(earnings, smartWallet);
-    })();
-    try {
-      return await this.earningsRefreshInFlight;
-    } finally {
-      this.earningsRefreshInFlight = null;
-    }
+    })().finally(() => {
+      if (this.earningsRefreshes.get(key2) === pending)
+        this.earningsRefreshes.delete(key2);
+    });
+    this.earningsRefreshes.set(key2, pending);
+    return pending;
   }
   async getAccountApy(state, chainId, days, tokenSymbol) {
     const { smartWallet } = await this.resolveSmartWallet(state, chainId);
@@ -1847,9 +2004,73 @@ var ZyfaiAgent = class _ZyfaiAgent {
   }
 };
 
-// src/lib/health-report.ts
+// src/lib/routing-api.ts
 var ROUTING_API_BASE_URL = "https://owney-routing-api-243946518160.europe-west4.run.app";
-async function reportAgentFailure(apiKey, agentType, errorCode, baseUrl = ROUTING_API_BASE_URL) {
+async function fetchOrgAgentConfig(apiKey, baseUrl = ROUTING_API_BASE_URL) {
+  const url = `${baseUrl}/api/v1/agent/org-config`;
+  try {
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "x-owney-api-key": `${apiKey}`
+      }
+    });
+    if (!res.ok) {
+      if (res.status !== 404) {
+        console.warn(
+          `[owney-sdk] Could not read org agent config (${res.status}); leaving user profiles unchanged.`
+        );
+      }
+      return null;
+    }
+    const json = await res.json();
+    const policy = json.success ? json.data ?? null : null;
+    debugLog(
+      "owney-sdk",
+      policy ? "org agent config: loaded" : "org agent config: none set by this partner \u2014 user profiles will be left as they are",
+      policy ?? void 0
+    );
+    return policy;
+  } catch (error) {
+    console.warn(
+      "[owney-sdk] Could not read org agent config (non-fatal):",
+      error instanceof Error ? error.message : String(error)
+    );
+    return null;
+  }
+}
+async function fetchAgentKeys(apiKey, baseUrl = ROUTING_API_BASE_URL) {
+  const url = `${baseUrl}/api/v1/agent/keys`;
+  const res = await fetch(url, {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json",
+      "x-owney-api-key": `${apiKey}`
+    }
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new OwneyError(
+      "API_ROUTING_ERROR",
+      `Routing API error ${res.status}: ${text}`,
+      { statusCode: res.status, responseBody: text }
+    );
+  }
+  const json = await res.json();
+  if (!json.success) {
+    throw new OwneyError(
+      "API_ROUTING_FAILED",
+      `Routing API request failed: ${json.message}`,
+      { message: json.message }
+    );
+  }
+  return json.data;
+}
+
+// src/lib/health-report.ts
+var ROUTING_API_BASE_URL2 = "https://owney-routing-api-243946518160.europe-west4.run.app";
+async function reportAgentFailure(apiKey, agentType, errorCode, baseUrl = ROUTING_API_BASE_URL2) {
   try {
     await fetch(`${baseUrl}/api/v1/agent/health-report`, {
       method: "POST",
@@ -1883,10 +2104,11 @@ async function withFailureReporting(apiKey, agentType, fn, baseUrl) {
 // src/lib/helpers/withdraw-helper.ts
 import { parseUnits } from "viem";
 function projectAgentBalancesForAsset(agents, aggregated, chainId, asset, decimals) {
+  const target = asset.toUpperCase();
   return agents.map((agent) => {
     const agentBalance = aggregated[agent.id];
     const tokenBalance = agentBalance?.tokens.find(
-      (t) => t.chainId === chainId && isSameAsset(t.asset, asset)
+      (t) => t.chainId === chainId && t.asset.toUpperCase() === target
     );
     if (!tokenBalance) return { agent, balance: 0n };
     return { agent, balance: parseUnits(tokenBalance.amount, decimals) };
@@ -2003,10 +2225,46 @@ import {
 } from "viem";
 import { base as base2, arbitrum as arbitrum2, mainnet as mainnet2 } from "viem/chains";
 
+// src/lib/transfer-auth.ts
+import { bytesToHex } from "viem";
+var ERC20_META_ABI = [
+  { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] },
+  { type: "function", name: "version", stateMutability: "view", inputs: [], outputs: [{ name: "", type: "string" }] }
+];
+function buildTransferWithAuthorizationTypedData(input) {
+  return {
+    domain: { name: input.tokenName, version: input.tokenVersion, chainId: input.chainId, verifyingContract: input.token },
+    types: {
+      TransferWithAuthorization: [
+        { name: "from", type: "address" },
+        { name: "to", type: "address" },
+        { name: "value", type: "uint256" },
+        { name: "validAfter", type: "uint256" },
+        { name: "validBefore", type: "uint256" },
+        { name: "nonce", type: "bytes32" }
+      ]
+    },
+    primaryType: "TransferWithAuthorization",
+    message: input.message
+  };
+}
+async function readTokenMeta(publicClient, token) {
+  const [tokenName, tokenVersion] = await Promise.all([
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "name" }),
+    publicClient.readContract({ address: token, abi: ERC20_META_ABI, functionName: "version" }).catch(() => "2")
+  ]);
+  return { tokenName, tokenVersion };
+}
+function randomAuthNonce() {
+  const bytes = new Uint8Array(32);
+  globalThis.crypto.getRandomValues(bytes);
+  return bytesToHex(bytes);
+}
+
 // src/lib/sponsor-client.ts
-var ROUTING_API_BASE_URL2 = "https://owney-routing-api-243946518160.europe-west4.run.app";
+var ROUTING_API_BASE_URL3 = "https://owney-routing-api-243946518160.europe-west4.run.app";
 async function postSponsorTransferAuth(input) {
-  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL2;
+  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL3;
   let res;
   try {
     res = await fetch(`${base3}/api/v1/sponsor/erc20-transfer-auth`, {
@@ -2046,7 +2304,7 @@ async function postSponsorTransferAuth(input) {
   return parsed.data;
 }
 async function postSponsorPermit2Transfer(input) {
-  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL2;
+  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL3;
   let res;
   try {
     res = await fetch(`${base3}/api/v1/sponsor/permit2-transfer`, {
@@ -2084,7 +2342,7 @@ async function postSponsorPermit2Transfer(input) {
   return parsed.data;
 }
 async function getSponsorRelayerAddress(input) {
-  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL2;
+  const base3 = input.baseUrl ?? ROUTING_API_BASE_URL3;
   let res;
   try {
     res = await fetch(
@@ -2120,6 +2378,84 @@ async function getSponsorRelayerAddress(input) {
   return parsed.data.relayer;
 }
 
+// src/lib/permit2.ts
+import { bytesToHex as bytesToHex2 } from "viem";
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+var MAX_UINT256 = 2n ** 256n - 1n;
+var ERC20_ALLOWANCE_ABI = [
+  {
+    type: "function",
+    name: "allowance",
+    stateMutability: "view",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256" }]
+  },
+  {
+    type: "function",
+    name: "approve",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  }
+];
+function buildPermitTransferFromTypedData(input) {
+  return {
+    domain: {
+      name: "Permit2",
+      chainId: input.chainId,
+      verifyingContract: PERMIT2_ADDRESS
+    },
+    types: {
+      PermitTransferFrom: [
+        { name: "permitted", type: "TokenPermissions" },
+        { name: "spender", type: "address" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" }
+      ],
+      TokenPermissions: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint256" }
+      ]
+    },
+    primaryType: "PermitTransferFrom",
+    message: input.message
+  };
+}
+function randomPermit2Nonce() {
+  const bytes = new Uint8Array(32);
+  globalThis.crypto.getRandomValues(bytes);
+  return BigInt(bytesToHex2(bytes));
+}
+async function readPermit2Allowance(publicClient, token, owner) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "allowance",
+    args: [owner, PERMIT2_ADDRESS]
+  });
+}
+async function readErc20Balance(publicClient, token, owner) {
+  return publicClient.readContract({
+    address: token,
+    abi: ERC20_ALLOWANCE_ABI,
+    functionName: "balanceOf",
+    args: [owner]
+  });
+}
+
 // src/lib/chain-guard.ts
 var CHAIN_NAMES = {
   1: "Ethereum",
@@ -2438,7 +2774,6 @@ var VIEM_CHAIN2 = {
   42161: arbitrum2,
   1: mainnet2
 };
-var AGENT_ELIGIBILITY_ORDER = ["surfliquid", "zyfai"];
 var SPONSORED_WETH_BY_CHAIN = {
   8453: "0x4200000000000000000000000000000000000006",
   42161: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1",
@@ -2467,11 +2802,21 @@ var OwneySDK = class {
   zyfaiRpcUrls;
   routingApiBaseUrl;
   referralSource;
-  surfliquidApiBaseUrl;
   cachedSponsoredCallback = null;
   cachedWethSponsoredCallback = null;
   paymasterServiceUrl;
   cachedSponsoredCallsCallbacks = /* @__PURE__ */ new Map();
+  agentReads = new AgentReads();
+  activationChecks = /* @__PURE__ */ new Map();
+  readAgent(agent, method, fetch2, params = null) {
+    const key2 = JSON.stringify([
+      this.state?.walletAddress.toLowerCase() ?? null,
+      this.state?.chainId ?? null,
+      method,
+      params
+    ]);
+    return this.agentReads.run(agent.id, key2, fetch2);
+  }
   initializingAgentsPromise = null;
   constructor(config) {
     this.apiKey = config.apiKey;
@@ -2480,7 +2825,6 @@ var OwneySDK = class {
     this.routingApiBaseUrl = config.routingApiBaseUrl;
     this.paymasterServiceUrl = config.paymasterServiceUrl;
     this.referralSource = config.referralSource;
-    this.surfliquidApiBaseUrl = config.surfliquidApiBaseUrl;
   }
   /**
    * Establish connection state for all subsequent SDK calls.
@@ -2499,6 +2843,8 @@ var OwneySDK = class {
         "No accounts found. Ensure the wallet is unlocked and connected."
       );
     }
+    this.agentReads.clearInFlight();
+    this.activationChecks.clear();
     this.state = { provider, walletAddress, chainId: null };
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
@@ -2514,6 +2860,8 @@ var OwneySDK = class {
     }
     this.activeAgents.clear();
     this.disabledAgents.clear();
+    this.agentReads.clearInFlight();
+    this.activationChecks.clear();
     this.state = null;
     this.cachedSponsoredCallback = null;
     this.cachedWethSponsoredCallback = null;
@@ -2716,8 +3064,8 @@ var OwneySDK = class {
           this.routingApiBaseUrl
         );
         this.disabledAgents.clear();
-        for (const { key: key2, agent_type, project_name, is_enabled } of agentKeys) {
-          const agent = await this.createAgent(agent_type, key2, project_name);
+        for (const { key: key2, agent_type, is_enabled } of agentKeys) {
+          const agent = this.createAgent(agent_type, key2);
           if (!agent) continue;
           this.agents.set(agent_type, agent);
           if (is_enabled === false) {
@@ -2738,25 +3086,42 @@ var OwneySDK = class {
       this.initializingAgentsPromise = null;
     }
   }
-  async createAgent(agentId, key2, projectName) {
+  createAgent(agentId, key2) {
     if (agentId === "zyfai") {
       return new ZyfaiAgent(key2, this.zyfaiRpcUrls, this.referralSource);
     }
-    if (agentId === "surfliquid") {
-      if (!projectName) return null;
-      const { SurfLiquidAgent } = await import("./surfliquid.agent-5GY7A6HY.js");
-      return new SurfLiquidAgent({
-        projectName,
-        appId: key2,
-        // Same-origin proxy override — SurfLiquid auth is an httpOnly cookie,
-        // which WebKit (iOS) discards when it is third-party. See
-        // OwneySDKConfig.surfliquidApiBaseUrl.
-        apiBaseUrl: this.surfliquidApiBaseUrl,
-        apiKey: this.apiKey,
-        routingApiBaseUrl: this.routingApiBaseUrl
+    return null;
+  }
+  /**
+   * Discover the agents actually returned by routing for this organization.
+   * Consumers should use this instead of hardcoding a global agent roster.
+   */
+  async getAvailableAgents(options = {}) {
+    await this.ensureAgentsInitialized();
+    const { chainId, asset, includeDisabled = false } = options;
+    const available = [];
+    for (const [id, agent] of this.agents) {
+      const isEnabled = !this.isAgentDisabled(id);
+      if (!includeDisabled && !isEnabled) continue;
+      if (chainId !== void 0 && !agent.supportedChainIds.includes(chainId)) {
+        continue;
+      }
+      if (asset !== void 0) {
+        const supportsAsset = agent.supportedAssets.some(
+          (entry) => (chainId === void 0 || entry.chainId === chainId) && entry.assets.some((candidate) => candidate.symbol === asset)
+        );
+        if (!supportsAsset) {
+          continue;
+        }
+      }
+      available.push({
+        id,
+        isEnabled,
+        supportedChainIds: agent.supportedChainIds,
+        supportedAssets: agent.supportedAssets
       });
     }
-    return null;
+    return available;
   }
   // --- Account lifecycle ---
   /**
@@ -2805,9 +3170,7 @@ var OwneySDK = class {
         this.activeAgents.add(id);
       }
       state.chainId = chainId;
-      this.activateAgentsInTurn(agents, state, chainId).catch((error) => {
-        console.error("activateAgent background init failed:", error);
-      });
+      await this.activateAgentsInTurn(agents, state, chainId);
       return;
     }
     const compatible = [...this.agents.values()].filter(
@@ -2828,11 +3191,7 @@ var OwneySDK = class {
     const enabledCompatible = compatible.filter(
       (agent) => !this.isAgentDisabled(agent.id)
     );
-    this.activateAgentsInTurn(enabledCompatible, state, chainId).catch(
-      (error) => {
-        console.error("activateAgent background init failed:", error);
-      }
-    );
+    await this.activateAgentsInTurn(enabledCompatible, state, chainId);
   }
   /**
    * Activate agents ONE AT A TIME, each followed by its org policy.
@@ -2869,7 +3228,7 @@ var OwneySDK = class {
     if (firstError !== null) throw firstError;
   }
   /**
-   * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
+   * Deposit into a specific agent, or distribute across all eligible agents.
    * Validates that the asset is supported and amount meets minimums for the target agent(s).
    * @param options - Deposit parameters
    * @param options.amount - Amount to deposit in smallest unit (e.g. "100000000" for 100 USDC)
@@ -2877,7 +3236,8 @@ var OwneySDK = class {
    * @param options.depositCallback - Callback that performs the token transfer and returns a tx hash.
    *   When agentId is omitted, this callback is invoked once per eligible agent with that agent's
    *   split amount and smart wallet address — expect multiple wallet prompts.
-   * @param options.agentId - Optional. Target agent. Omit to split equally across all agents.
+   * @param options.agentId - Optional explicit target. Otherwise split equally,
+   *   or fund remaining agents when a recovery deposit cannot meet every minimum.
    * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
    */
   async deposit(options) {
@@ -2915,7 +3275,7 @@ var OwneySDK = class {
     });
     const exemptFlags = await Promise.all(
       eligibleAgents.map(
-        (a) => this.hasExistingBalance(a, state, chainId, asset)
+        (a) => this.hasExistingBalance(a, state, chainId, asset, true)
       )
     );
     const exempt = new Set(
@@ -2929,15 +3289,42 @@ var OwneySDK = class {
       exempt
     );
     if (agentAmounts.length === 0) {
+      const agentsRequiringActivation = eligibleAgents.filter(
+        (agent) => !exempt.has(agent.id)
+      );
+      const perAgentMinimum = agentsRequiringActivation.reduce(
+        (highest, agent) => {
+          const minimum = this.getMinDepositAmount(agent, chainId, asset);
+          return minimum > highest ? minimum : highest;
+        },
+        0n
+      );
+      const minimumRequired = agentsRequiringActivation.length > 0 ? (perAgentMinimum > 0n ? perAgentMinimum : 1n) * BigInt(agentsRequiringActivation.length) : BigInt(eligibleAgents.length);
       throw new OwneyError(
         "DEPOSIT_AMOUNT_BELOW_MINIMUM",
-        `Amount "${amount}" cannot satisfy minimum deposit requirements for any eligible agent.`,
-        { amount }
+        `Amount "${amount}" cannot activate every eligible agent. The combined minimum is "${minimumRequired.toString()}" for ${asset}.`,
+        {
+          amount,
+          asset,
+          chainId,
+          minDepositAmount: minimumRequired.toString(),
+          perAgentDepositAmount: perAgentMinimum.toString(),
+          agentMinimums: agentsRequiringActivation.map((agent) => ({
+            agentId: agent.id,
+            minDepositAmount: this.getMinDepositAmount(
+              agent,
+              chainId,
+              asset
+            ).toString()
+          }))
+        }
       );
     }
     const agentResults = {};
-    const agentErrors = {};
-    for (const { agent, amount: agentAmount } of agentAmounts) {
+    for (const [
+      index,
+      { agent, amount: agentAmount }
+    ] of agentAmounts.entries()) {
       try {
         agentResults[agent.id] = await this.depositWithFallback(
           agent,
@@ -2949,17 +3336,22 @@ var OwneySDK = class {
           depositCallback
         );
       } catch (error) {
-        agentErrors[agent.id] = error instanceof Error ? error.message : String(error);
+        if (Object.keys(agentResults).length === 0) throw error;
+        throw new OwneyError(
+          "DEPOSIT_PARTIAL_FAILURE",
+          "Some deposits completed before another agent failed. Check activity and balances before depositing again; the failed transfer may still settle.",
+          {
+            agentResults,
+            failedAgentId: agent.id,
+            failedAmount: agentAmount,
+            unattemptedAgentIds: agentAmounts.slice(index + 1).map(({ agent: agent2 }) => agent2.id),
+            cause: error
+          },
+          agent.id
+        );
       }
     }
-    if (Object.keys(agentResults).length === 0) {
-      throw new OwneyError(
-        "DEPOSIT_ALL_FAILED",
-        `All ${agentAmounts.length} agent deposit(s) failed.`,
-        { agentErrors }
-      );
-    }
-    return Object.keys(agentErrors).length > 0 ? { agentResults, agentErrors } : { agentResults };
+    return { agentResults };
   }
   /**
    * Invokes `agent.deposit` with the resolved sponsored callback, composing
@@ -3030,6 +3422,17 @@ var OwneySDK = class {
   }
   splitDepositAmount(totalAmount, agents, chainId, asset, exempt = /* @__PURE__ */ new Set()) {
     if (agents.length === 0) return [];
+    const agentsRequiringActivation = agents.filter(
+      (agent) => !exempt.has(agent.id)
+    );
+    if (agentsRequiringActivation.length === agents.length) {
+      const highestMinimum2 = agents.reduce((highest, agent) => {
+        const minimum = this.getMinDepositAmount(agent, chainId, asset);
+        return minimum > highest ? minimum : highest;
+      }, 0n);
+      const minimumRequired2 = (highestMinimum2 > 0n ? highestMinimum2 : 1n) * BigInt(agents.length);
+      if (totalAmount < minimumRequired2) return [];
+    }
     const perAgent = totalAmount / BigInt(agents.length);
     const remainder = totalAmount % BigInt(agents.length);
     const splits = agents.map((agent, i) => ({
@@ -3037,18 +3440,26 @@ var OwneySDK = class {
       amount: i === agents.length - 1 ? perAgent + remainder : perAgent
     }));
     const valid = splits.filter(
-      (s) => exempt.has(s.agent.id) || s.amount >= this.getMinDepositAmount(s.agent, chainId, asset)
+      (s) => s.amount > 0n && (exempt.has(s.agent.id) || s.amount >= this.getMinDepositAmount(s.agent, chainId, asset))
     );
     if (valid.length === agents.length) {
       return splits.map((s) => ({ agent: s.agent, amount: String(s.amount) }));
     }
-    return this.splitDepositAmount(
-      totalAmount,
-      valid.map((s) => s.agent),
-      chainId,
-      asset,
-      exempt
-    );
+    const targets = agentsRequiringActivation.length > 0 ? agentsRequiringActivation : agents;
+    const highestMinimum = targets.reduce((highest, agent) => {
+      const minimum = this.getMinDepositAmount(agent, chainId, asset);
+      return minimum > highest ? minimum : highest;
+    }, 0n);
+    const minimumRequired = (highestMinimum > 0n ? highestMinimum : 1n) * BigInt(targets.length);
+    if (totalAmount < minimumRequired) return [];
+    const targetShare = totalAmount / BigInt(targets.length);
+    const targetRemainder = totalAmount % BigInt(targets.length);
+    return targets.map((agent, index) => ({
+      agent,
+      amount: String(
+        targetShare + (index === targets.length - 1 ? targetRemainder : 0n)
+      )
+    }));
   }
   async validateMinDepositAmount(agent, state, chainId, asset, amount) {
     const minDepositAmount = this.getMinDepositAmount(agent, chainId, asset);
@@ -3073,14 +3484,29 @@ var OwneySDK = class {
    * per-agent minimum. Fails closed: any error reading balances returns
    * false, so the minimum is enforced as today.
    */
-  async hasExistingBalance(agent, state, chainId, asset) {
+  async hasExistingBalance(agent, state, chainId, asset, requireReliableRead = false) {
     try {
       const balance = await agent.getBalances(state, chainId);
+      const target = asset.toLowerCase();
       const token = balance.tokens.find(
-        (t) => t.chainId === chainId && isSameAsset(t.asset, asset)
+        (t) => t.chainId === chainId && t.asset.toLowerCase() === target
       );
-      return !!token && Number(token.amount) > 0;
-    } catch {
+      const targetChainName = agent.supportedAssets.find((entry) => entry.chainId === chainId)?.chain?.trim().toUpperCase();
+      const position = (balance.positions ?? []).find((p) => {
+        const positionChain = p.chain.trim().toUpperCase();
+        const matchesChain = positionChain === String(chainId) || targetChainName !== void 0 && positionChain === targetChainName;
+        return matchesChain && p.asset.toLowerCase() === target && Number(p.amount) > 0;
+      });
+      return !!token && Number(token.amount) > 0 || !!position;
+    } catch (error) {
+      if (requireReliableRead) {
+        throw new OwneyError(
+          "DEPOSIT_BALANCE_UNAVAILABLE",
+          "Could not verify every agent balance. No deposit was submitted. Try again once balances are available.",
+          { agentId: agent.id, chainId, asset, cause: error },
+          agent.id
+        );
+      }
       return false;
     }
   }
@@ -3116,34 +3542,6 @@ var OwneySDK = class {
     }
     return eligible;
   }
-  /**
-   * Agent ids the routing API provisioned for this org that support the given
-   * chain + asset, ordered by preference ({@link AGENT_ELIGIBILITY_ORDER},
-   * surfliquid first). Returns `[]` when the org has no compatible agent — never
-   * throws on an empty org. Loads agent keys on first call (apiKey only, no
-   * wallet), so the UI can resolve which agent to use before the user connects.
-   *
-   * This is the source of truth for agent availability: an agent appears here
-   * iff the routing API returned its key. No per-app feature flags.
-   */
-  async getEligibleAgentIds(chainId, asset) {
-    try {
-      await this.ensureAgentsInitialized();
-    } catch (error) {
-      if (error instanceof OwneyError && error.code === "API_NO_AGENTS") {
-        return [];
-      }
-      throw error;
-    }
-    return [...this.agents.values()].filter((agent) => {
-      const chainAssets = agent.supportedAssets.find(
-        (sa) => sa.chainId === chainId
-      );
-      return chainAssets?.assets.some((a) => a.symbol === asset) ?? false;
-    }).map((agent) => agent.id).sort(
-      (a, b) => AGENT_ELIGIBILITY_ORDER.indexOf(a) - AGENT_ELIGIBILITY_ORDER.indexOf(b)
-    );
-  }
   // --- Fund operations ---
   /**
    * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
@@ -3180,17 +3578,9 @@ var OwneySDK = class {
     }
     const eligibleAgents = this.getEligibleAgents(chainId, asset);
     if (!amount) {
-      const aggregated2 = await this.getBalances();
-      const funded = projectAgentBalancesForAsset(
-        eligibleAgents,
-        aggregated2.agentBalances,
-        chainId,
-        asset,
-        assetInfo.decimals
-      ).filter((b) => b.balance > 0n);
       const results2 = {};
       const agentErrors2 = {};
-      for (const { agent } of funded) {
+      for (const agent of eligibleAgents) {
         try {
           results2[agent.id] = await agent.withdraw(state, chainId, token);
         } catch (err) {
@@ -3212,10 +3602,9 @@ var OwneySDK = class {
           { asset, agentErrors: agentErrors2 }
         );
       }
-      const totalWithdrawn = funded.filter(({ agent }) => results2[agent.id] !== void 0).reduce((sum, { balance }) => sum + balance, 0n);
       return {
         agentResult: results2,
-        totalWithdrawn: totalWithdrawn.toString()
+        totalWithdrawn: sumWithdrawnAmount(results2).toString()
       };
     }
     const requested = BigInt(amount);
@@ -3320,7 +3709,8 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      const result = await this.getAgent(agentId).getBalances(state, chainId);
+      const agent = this.getAgent(agentId);
+      const result = await this.readAgent(agent, "balances", () => agent.getBalances(state, chainId));
       return result;
     }
     let totalBalance = 0;
@@ -3328,12 +3718,13 @@ var OwneySDK = class {
     const entries = [...this.getActiveAgents().entries()];
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
-        const b = await agent.getBalances(state, chainId);
+        const b = await this.readAgent(agent, "balances", () => agent.getBalances(state, chainId));
         return [id, b];
       })
     );
     let successCount = 0;
     const agentErrors = {};
+    const agentFailures = [];
     for (let i = 0; i < balanceResults.length; i++) {
       const settledResult = balanceResults[i];
       const [agentId2] = entries[i];
@@ -3345,13 +3736,14 @@ var OwneySDK = class {
         continue;
       }
       const reason = settledResult.reason;
+      agentFailures.push(reason);
       agentErrors[agentId2] = reason instanceof Error ? reason.message : String(reason);
     }
     if (successCount === 0) {
       throw new OwneyError(
         "BALANCE_ALL_FAILED",
         "Failed to fetch balances for all active agents.",
-        { agentErrors }
+        { agentErrors, failures: agentFailures }
       );
     }
     return {
@@ -3369,14 +3761,15 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      return this.getAgent(agentId).getEarnings(state, chainId);
+      const agent = this.getAgent(agentId);
+      return this.readAgent(agent, "earnings", () => agent.getEarnings(state, chainId));
     }
     let totalEarnings = 0;
     const results = {};
     const entries = [...this.getActiveAgents().entries()];
     const earningsResults = await Promise.all(
       entries.map(async ([id, agent]) => {
-        const e = await agent.getEarnings(state, chainId);
+        const e = await this.readAgent(agent, "earnings", () => agent.getEarnings(state, chainId));
         return [id, e];
       })
     );
@@ -3396,7 +3789,11 @@ var OwneySDK = class {
   async refreshEarnings(agentId) {
     const state = this.requireState();
     const chainId = this.requireChainId();
-    const refreshAgent = (agent) => agent.refreshEarnings?.(state, chainId) ?? agent.getEarnings(state, chainId);
+    const refreshAgent = (agent) => this.readAgent(
+      agent,
+      agent.refreshEarnings ? "refreshEarnings" : "earnings",
+      () => agent.refreshEarnings?.(state, chainId) ?? agent.getEarnings(state, chainId)
+    );
     if (agentId) return refreshAgent(this.getAgent(agentId));
     let totalEarnings = 0;
     const agentEarnings = {};
@@ -3427,11 +3824,12 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      return this.getAgent(agentId).getAccountApy(
-        state,
-        chainId,
-        days,
-        tokenSymbol
+      const agent = this.getAgent(agentId);
+      return this.readAgent(
+        agent,
+        "accountApy",
+        () => agent.getAccountApy(state, chainId, days, tokenSymbol),
+        { days, tokenSymbol }
       );
     }
     const activeAgents = this.getActiveAgents();
@@ -3439,18 +3837,18 @@ var OwneySDK = class {
     const [apyResults, balanceResults] = await Promise.all([
       Promise.all(
         entries.map(async ([id, agent]) => {
-          const apy = await agent.getAccountApy(
-            state,
-            chainId,
-            days,
-            tokenSymbol
+          const apy = await this.readAgent(
+            agent,
+            "accountApy",
+            () => agent.getAccountApy(state, chainId, days, tokenSymbol),
+            { days, tokenSymbol }
           );
           return [id, apy];
         })
       ),
       Promise.all(
         entries.map(async ([id, agent]) => {
-          const b = await agent.getBalances(state, chainId);
+          const b = await this.readAgent(agent, "balances", () => agent.getBalances(state, chainId));
           return [id, Number(b.totalBalance)];
         })
       )
@@ -3507,7 +3905,8 @@ var OwneySDK = class {
     const chainId = this.requireChainId();
     const { agentId, filters } = options ?? {};
     if (agentId) {
-      return this.getAgent(agentId).getHistory(state, chainId, filters);
+      const agent = this.getAgent(agentId);
+      return this.readAgent(agent, "history", () => agent.getHistory(state, chainId, filters), filters);
     }
     const activeAgents = [...this.getActiveAgents().values()];
     const cursorMap = filters?.cursor ? decodeMultiAgentCursor(filters.cursor) : {};
@@ -3517,10 +3916,13 @@ var OwneySDK = class {
         if (filters?.cursor && agentCursor === void 0) {
           return { agentId: agent.id, page: null };
         }
-        const page = await agent.getHistory(state, chainId, {
-          ...filters,
-          cursor: agentCursor
-        });
+        const agentFilters = { ...filters, cursor: agentCursor };
+        const page = await this.readAgent(
+          agent,
+          "history",
+          () => agent.getHistory(state, chainId, agentFilters),
+          agentFilters
+        );
         return { agentId: agent.id, page };
       })
     );
@@ -3560,13 +3962,14 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      return this.getAgent(agentId).getUserProfile(state, chainId);
+      const agent = this.getAgent(agentId);
+      return this.readAgent(agent, "profile", () => agent.getUserProfile(state, chainId));
     }
     const results = {};
     const entries = [...this.getActiveAgents().entries()];
     const profileResults = await Promise.all(
       entries.map(async ([id, agent]) => {
-        const p = await agent.getUserProfile(state, chainId);
+        const p = await this.readAgent(agent, "profile", () => agent.getUserProfile(state, chainId));
         return [id, p];
       })
     );
@@ -3589,7 +3992,20 @@ var OwneySDK = class {
     const chainId = this.requireChainId();
     const agent = this.getAgent(agentId);
     if (typeof agent.ensureAutoSelectProtocols !== "function") return false;
-    return agent.ensureAutoSelectProtocols(state, chainId, asset);
+    const key2 = JSON.stringify([
+      state.walletAddress.toLowerCase(),
+      agentId,
+      chainId,
+      asset
+    ]);
+    const existing = this.activationChecks.get(key2);
+    if (existing) return existing;
+    const pending = Promise.resolve().then(() => agent.ensureAutoSelectProtocols(state, chainId, asset)).finally(() => {
+      if (this.activationChecks.get(key2) === pending)
+        this.activationChecks.delete(key2);
+    });
+    this.activationChecks.set(key2, pending);
+    return pending;
   }
   /**
    * One-time, user-paid approval of Permit2 on the sponsored WETH token for
@@ -3660,13 +4076,14 @@ var OwneySDK = class {
     await this.ensureAgentsInitialized();
     const agentOptions = { tokenSymbol, chainId };
     if (agentId) {
-      return this.getAgent(agentId).getAgentApy(days, agentOptions);
+      const agent = this.getAgent(agentId);
+      return this.readAgent(agent, "agentApy", () => agent.getAgentApy(days, agentOptions), { days, ...agentOptions });
     }
     const results = {};
     const agentEntries = [...this.agents.entries()];
     const apyResults = await Promise.all(
       agentEntries.map(async ([id, agent]) => {
-        const apy = await agent.getAgentApy(days, agentOptions);
+        const apy = await this.readAgent(agent, "agentApy", () => agent.getAgentApy(days, agentOptions), { days, ...agentOptions });
         return [id, apy];
       })
     );
@@ -3693,7 +4110,7 @@ var OwneySDK = class {
     const entries = [...activeAgents.entries()];
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
-        const b = await agent.getBalances(state, chainId);
+        const b = await this.readAgent(agent, "balances", () => agent.getBalances(state, chainId));
         return [id, b.positions ?? []];
       })
     );
@@ -3701,6 +4118,7 @@ var OwneySDK = class {
     const allPositions = [];
     let successCount = 0;
     const agentErrors = {};
+    const agentFailures = [];
     for (let i = 0; i < balanceResults.length; i++) {
       const settled = balanceResults[i];
       const [aid] = entries[i];
@@ -3715,6 +4133,7 @@ var OwneySDK = class {
         successCount += 1;
       } else {
         const reason = settled.reason;
+        agentFailures.push(reason);
         agentErrors[aid] = reason instanceof Error ? reason.message : String(reason);
         console.error(`getAllocationApy agent "${aid}" failed:`, reason);
       }
@@ -3723,7 +4142,7 @@ var OwneySDK = class {
       throw new OwneyError(
         "ALLOCATION_ALL_FAILED",
         "Failed to fetch allocation APY: all agents failed.",
-        { agentErrors }
+        { agentErrors, failures: agentFailures }
       );
     }
     const overall = computeAllocationApy(allPositions);