@owney/sdk 0.7.16-beta.5 → 0.7.16-beta.7

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { Hex } from 'viem';
 import { SIWXConfig } from '@reown/appkit-controllers';
 
 type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
@@ -9,8 +8,6 @@ interface OwneySDKConfig {
      * Example: { 8453: "https://...", 42161: "https://..." }
      */
     zyfaiRpcUrls?: ZyfaiRpcUrlsConfig;
-    /** Optional Owney Yieldseeker proxy base URL override for integration tests. */
-    yieldseekerApiBaseUrl?: string;
     /**
      * Optional override for the Owney routing API base URL used by all routing
      * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
@@ -24,6 +21,16 @@ interface OwneySDKConfig {
      * for apps that don't use the AppKit SIWX modal.
      */
     referralSource?: string;
+    /**
+     * Optional override for the SurfLiquid API base URL (defaults to the
+     * SurfLiquid SDK's production URL). SurfLiquid auth is an httpOnly
+     * SameSite=None cookie set by api.surfliquid.com — a THIRD-PARTY cookie from
+     * the embedding app's origin, which WebKit (all iOS browsers) discards, so
+     * every authenticated SurfLiquid call 401s on iOS. Point this at a
+     * same-origin reverse proxy (e.g. "/api/surf") so the session cookie becomes
+     * first-party. Relative paths resolve against the page origin.
+     */
+    surfliquidApiBaseUrl?: string;
     /**
      * Turn on the SDK's debug logging (default false). Traces the decisions that
      * are otherwise invisible — notably how the organization's agent policy is
@@ -57,7 +64,7 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
-type AgentId = "zyfai" | "yieldseeker";
+type AgentId = "zyfai" | "surfliquid";
 type Asset = string;
 type AgentSupportedAsset = {
     readonly symbol: string;
@@ -68,18 +75,6 @@ type AgentSupportedAssets = {
     readonly chain?: string;
     readonly assets: readonly AgentSupportedAsset[];
 };
-type AvailableAgent = {
-    id: AgentId;
-    isEnabled: boolean;
-    supportedChainIds: readonly number[];
-    supportedAssets: readonly AgentSupportedAssets[];
-};
-type AvailableAgentsOptions = {
-    chainId?: number;
-    asset?: Asset;
-    /** Disabled agents are omitted by default because they cannot accept funds. */
-    includeDisabled?: boolean;
-};
 type DailyApyDays = "7D" | "14D" | "30D";
 type HistoryFilters = {
     fromDate?: string;
@@ -185,6 +180,12 @@ interface OwneyDepositResult {
 }
 interface OwneyMultiDepositResult {
     agentResults: Record<string, OwneyDepositResult>;
+    /**
+     * Per-agent failure messages for agents that errored during a diversified
+     * deposit. Present only when at least one (but not all) agents failed —
+     * the deposit is partial, not total. Omitted when every agent succeeded.
+     */
+    agentErrors?: Record<string, string>;
 }
 interface AgentWithdrawResult {
     txHash?: string;
@@ -209,8 +210,6 @@ interface OwneyPosition {
     pool?: string;
     asset: string;
     amount: string;
-    /** Smallest-unit amount when the provider exposes it alongside `amount`. */
-    amountRaw?: string;
     apy?: number;
     tvl?: number;
     /** Pool liquidity. Prepared slot — Zyfai will add this to its portfolio
@@ -245,13 +244,6 @@ interface AgentBalance {
     totalBalance: string;
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
-    /**
-     * Describes whether `tokens` already includes deployed `positions`.
-     * Consumers must add matching positions only for `tokens-plus-positions`;
-     * doing so for Zyfai would double-count, while omitting it for Yieldseeker
-     * makes its balance disappear as soon as idle funds enter a vault.
-     */
-    balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     tokens: OwneyToken[];
     /**
      * Per-protocol/pool positions when the agent's portfolio payload includes
@@ -266,12 +258,6 @@ interface OwneyBalances {
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
     agentBalances: Record<AgentId, AgentBalance>;
-    /**
-     * Per-agent read failures when an aggregate balance request returned only a
-     * partial result. Callers may display the successful balances, but funding
-     * operations must not interpret a missing agent as having a zero balance.
-     */
-    agentErrors?: Partial<Record<AgentId, string>>;
 }
 interface AgentEarnings {
     smartWallet: `0x${string}`;
@@ -305,12 +291,6 @@ interface OwneyAccountApy {
     totalApy: string;
     agentApy: Record<AgentId, AccountAgentApy>;
     apyByChainAndAsset: ApyByChainAndAsset;
-    /**
-     * Balance-weighted daily APY across the agents that returned a point for each
-     * date. The weights use the selected chain/asset balance when getAccountApy
-     * is asset-scoped, otherwise each agent's total balance.
-     */
-    history?: ApyHistoryPoint[];
 }
 interface AllocationAgentApy {
     /** Account-wide weighted APY for this agent, as a decimal string. */
@@ -409,15 +389,8 @@ interface IAgent {
     readonly id: string;
     readonly supportedChainIds: readonly OwneySupportedChainId[];
     readonly supportedAssets: readonly AgentSupportedAssets[];
-    /**
-     * Describes how `AgentBalance.tokens` relates to `positions`.
-     * Most adapters expose token totals that already include deployed positions.
-     * Providers such as Yieldseeker expose idle wallet tokens separately, so
-     * withdrawal planning must add matching position amounts.
-     */
-    readonly balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
+    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
     /**
      * Apply the organization's agent policy to this user's account.
      *
@@ -482,9 +455,9 @@ declare class OwneySDK {
     private orgAgentConfig;
     private orgAgentConfigPromise;
     private zyfaiRpcUrls?;
-    private yieldseekerApiBaseUrl?;
     private routingApiBaseUrl?;
     private referralSource?;
+    private surfliquidApiBaseUrl?;
     private cachedSponsoredCallback;
     private cachedWethSponsoredCallback;
     private paymasterServiceUrl?;
@@ -555,11 +528,6 @@ declare class OwneySDK {
     private applyOrgPolicyTo;
     private ensureAgentsInitialized;
     private createAgent;
-    /**
-     * Discover the agents actually returned by routing for this organization.
-     * Consumers should use this instead of hardcoding a global agent roster.
-     */
-    getAvailableAgents(options?: AvailableAgentsOptions): Promise<AvailableAgent[]>;
     /**
      * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
      * Deploys the Safe contract and creates a session key if not already set up.
@@ -570,7 +538,7 @@ declare class OwneySDK {
      *   If provided, ALL specified agents must support the chainId or the call
      *   throws before activating any agent.
      */
-    activateAgent(chainId: number, agentId?: AgentId[], asset?: OwneySupportedTokens): Promise<void>;
+    activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
     /**
      * Activate agents ONE AT A TIME, each followed by its org policy.
      *
@@ -585,13 +553,13 @@ declare class OwneySDK {
      * at a time anyway.
      *
      * Every agent is attempted even if an earlier one fails, so one declined
-     * signature can't deny the remaining agents their turn. Once all agents have
-     * had a chance, a partial failure identifies the agents that still need a
-     * retry; if none activated, the original provider error is preserved.
+     * signature can't deny the remaining agents their turn. The first failure is
+     * rethrown (matching the previous `Promise.all` rejection) once all agents
+     * have had a chance to activate.
      */
     private activateAgentsInTurn;
     /**
-     * Deposit funds into a specific agent, or distribute across all agents if agentId is omitted.
+     * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
      * 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)
@@ -599,8 +567,7 @@ declare class OwneySDK {
      * @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 fund all eligible agents. Deposits
-     *   are equal once every agent is funded; first/recovery deposits also honor each agent's floor.
+     * @param options.agentId - Optional. Target agent. Omit to split equally across all agents.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
      */
     deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
@@ -632,7 +599,6 @@ declare class OwneySDK {
     private depositWithFallback;
     private getMinDepositAmount;
     private splitDepositAmount;
-    private formatAgentName;
     private validateMinDepositAmount;
     /**
      * Whether the user already holds a non-zero balance with `agent` for the
@@ -643,6 +609,17 @@ declare class OwneySDK {
     private hasExistingBalance;
     private validateAssetSupport;
     private getEligibleAgents;
+    /**
+     * 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.
+     */
+    getEligibleAgentIds(chainId: number, asset: string): Promise<AgentId[]>;
     /**
      * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
      * Validates that the asset is supported by the target agent(s) on the active chain.
@@ -743,92 +720,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type YieldseekerAuthDependencies = {
-    now?: () => Date;
-    nonce?: () => string;
-};
-
-type YieldseekerFetch = typeof fetch;
-
-type YieldseekerTransaction = {
-    from: `0x${string}`;
-    to: `0x${string}`;
-    data: `0x${string}`;
-    value: string;
-    chainId: number;
-};
-
-type YieldseekerAgentOptions = {
-    baseUrl?: string;
-    fetchFn?: YieldseekerFetch;
-    auth?: YieldseekerAuthDependencies;
-    /** Test seam for the wallet-submission/receipt boundary. */
-    transactionExecutor?: (state: ConnectionState, chainId: number, transaction: YieldseekerTransaction) => Promise<Hex>;
-    /** Test seam for transactions submitted outside transactionExecutor. */
-    unwindReceiptWaiter?: (state: ConnectionState, chainId: number, transactionHash: Hex) => Promise<void>;
-};
-declare class YieldseekerAgent implements IAgent {
-    readonly id = "yieldseeker";
-    readonly balanceComposition: "tokens-plus-positions";
-    readonly supportedChainIds: readonly [8453];
-    readonly supportedAssets: readonly [{
-        readonly chainId: 8453;
-        readonly chain: "BASE";
-        readonly assets: readonly [{
-            readonly symbol: "USDC";
-            readonly minDepositAmount: "10000000";
-        }, {
-            readonly symbol: "WETH";
-            readonly minDepositAmount: "1";
-        }];
-    }];
-    private readonly api;
-    private readonly auth;
-    private readonly transactionExecutor?;
-    private readonly unwindReceiptWaiter?;
-    private readonly agentContexts;
-    private readonly users;
-    private readonly pendingAgents;
-    constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
-    disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
-    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
-    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
-    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, tokenSymbol?: string): Promise<AccountAgentApy>;
-    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
-    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
-    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
-    private userKey;
-    private contextKey;
-    private resolveUser;
-    private forgetUser;
-    private ensureAgent;
-    private findAgent;
-    private resolveAgent;
-    private loadPortfolio;
-    private loadPortfolioContext;
-    private deployAfterFunding;
-    private refreshSnapshotAfterMovement;
-    private agentPath;
-    private walletRequest;
-    private providerRequest;
-    private mapApiError;
-    private submitTransaction;
-    private waitForReceipt;
-    private assertTransaction;
-    private assertAgent;
-    private isOwneyAgent;
-    private assetForAgent;
-    private isTransactionHash;
-    private assertChain;
-    private assertOptionalChain;
-    private assertAsset;
-    private invalidResponse;
-}
-
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_ALL_FAILED" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -894,4 +786,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type WithdrawOptions, YieldseekerAgent, createOwneySIWX, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { Hex } from 'viem';
 import { SIWXConfig } from '@reown/appkit-controllers';
 
 type ZyfaiRpcUrlsConfig = Partial<Record<(typeof SUPPORTED_CHAIN_IDS)[number], string>>;
@@ -9,8 +8,6 @@ interface OwneySDKConfig {
      * Example: { 8453: "https://...", 42161: "https://..." }
      */
     zyfaiRpcUrls?: ZyfaiRpcUrlsConfig;
-    /** Optional Owney Yieldseeker proxy base URL override for integration tests. */
-    yieldseekerApiBaseUrl?: string;
     /**
      * Optional override for the Owney routing API base URL used by all routing
      * calls (defaults to the OWNEY_ROUTING_API_BASE_URL env var, then the
@@ -24,6 +21,16 @@ interface OwneySDKConfig {
      * for apps that don't use the AppKit SIWX modal.
      */
     referralSource?: string;
+    /**
+     * Optional override for the SurfLiquid API base URL (defaults to the
+     * SurfLiquid SDK's production URL). SurfLiquid auth is an httpOnly
+     * SameSite=None cookie set by api.surfliquid.com — a THIRD-PARTY cookie from
+     * the embedding app's origin, which WebKit (all iOS browsers) discards, so
+     * every authenticated SurfLiquid call 401s on iOS. Point this at a
+     * same-origin reverse proxy (e.g. "/api/surf") so the session cookie becomes
+     * first-party. Relative paths resolve against the page origin.
+     */
+    surfliquidApiBaseUrl?: string;
     /**
      * Turn on the SDK's debug logging (default false). Traces the decisions that
      * are otherwise invisible — notably how the organization's agent policy is
@@ -57,7 +64,7 @@ type OwneySupportedChainId = (typeof SUPPORTED_CHAIN_IDS)[number];
 type OwneySupportedChains = (typeof SUPPORTED_CHAINS)[number];
 type OwneySupportedTokens = (typeof SUPPORTED_TOKENS)[number];
 
-type AgentId = "zyfai" | "yieldseeker";
+type AgentId = "zyfai" | "surfliquid";
 type Asset = string;
 type AgentSupportedAsset = {
     readonly symbol: string;
@@ -68,18 +75,6 @@ type AgentSupportedAssets = {
     readonly chain?: string;
     readonly assets: readonly AgentSupportedAsset[];
 };
-type AvailableAgent = {
-    id: AgentId;
-    isEnabled: boolean;
-    supportedChainIds: readonly number[];
-    supportedAssets: readonly AgentSupportedAssets[];
-};
-type AvailableAgentsOptions = {
-    chainId?: number;
-    asset?: Asset;
-    /** Disabled agents are omitted by default because they cannot accept funds. */
-    includeDisabled?: boolean;
-};
 type DailyApyDays = "7D" | "14D" | "30D";
 type HistoryFilters = {
     fromDate?: string;
@@ -185,6 +180,12 @@ interface OwneyDepositResult {
 }
 interface OwneyMultiDepositResult {
     agentResults: Record<string, OwneyDepositResult>;
+    /**
+     * Per-agent failure messages for agents that errored during a diversified
+     * deposit. Present only when at least one (but not all) agents failed —
+     * the deposit is partial, not total. Omitted when every agent succeeded.
+     */
+    agentErrors?: Record<string, string>;
 }
 interface AgentWithdrawResult {
     txHash?: string;
@@ -209,8 +210,6 @@ interface OwneyPosition {
     pool?: string;
     asset: string;
     amount: string;
-    /** Smallest-unit amount when the provider exposes it alongside `amount`. */
-    amountRaw?: string;
     apy?: number;
     tvl?: number;
     /** Pool liquidity. Prepared slot — Zyfai will add this to its portfolio
@@ -245,13 +244,6 @@ interface AgentBalance {
     totalBalance: string;
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
-    /**
-     * Describes whether `tokens` already includes deployed `positions`.
-     * Consumers must add matching positions only for `tokens-plus-positions`;
-     * doing so for Zyfai would double-count, while omitting it for Yieldseeker
-     * makes its balance disappear as soon as idle funds enter a vault.
-     */
-    balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     tokens: OwneyToken[];
     /**
      * Per-protocol/pool positions when the agent's portfolio payload includes
@@ -266,12 +258,6 @@ interface OwneyBalances {
     /** Asset that `totalBalance` is denominated in. Currently always `"usdc"`. */
     totalBalanceAsset: string;
     agentBalances: Record<AgentId, AgentBalance>;
-    /**
-     * Per-agent read failures when an aggregate balance request returned only a
-     * partial result. Callers may display the successful balances, but funding
-     * operations must not interpret a missing agent as having a zero balance.
-     */
-    agentErrors?: Partial<Record<AgentId, string>>;
 }
 interface AgentEarnings {
     smartWallet: `0x${string}`;
@@ -305,12 +291,6 @@ interface OwneyAccountApy {
     totalApy: string;
     agentApy: Record<AgentId, AccountAgentApy>;
     apyByChainAndAsset: ApyByChainAndAsset;
-    /**
-     * Balance-weighted daily APY across the agents that returned a point for each
-     * date. The weights use the selected chain/asset balance when getAccountApy
-     * is asset-scoped, otherwise each agent's total balance.
-     */
-    history?: ApyHistoryPoint[];
 }
 interface AllocationAgentApy {
     /** Account-wide weighted APY for this agent, as a decimal string. */
@@ -409,15 +389,8 @@ interface IAgent {
     readonly id: string;
     readonly supportedChainIds: readonly OwneySupportedChainId[];
     readonly supportedAssets: readonly AgentSupportedAssets[];
-    /**
-     * Describes how `AgentBalance.tokens` relates to `positions`.
-     * Most adapters expose token totals that already include deployed positions.
-     * Providers such as Yieldseeker expose idle wallet tokens separately, so
-     * withdrawal planning must add matching position amounts.
-     */
-    readonly balanceComposition?: "tokens-include-positions" | "tokens-plus-positions";
     disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
+    activateAgent(state: ConnectionState, chainId: number): Promise<void>;
     /**
      * Apply the organization's agent policy to this user's account.
      *
@@ -482,9 +455,9 @@ declare class OwneySDK {
     private orgAgentConfig;
     private orgAgentConfigPromise;
     private zyfaiRpcUrls?;
-    private yieldseekerApiBaseUrl?;
     private routingApiBaseUrl?;
     private referralSource?;
+    private surfliquidApiBaseUrl?;
     private cachedSponsoredCallback;
     private cachedWethSponsoredCallback;
     private paymasterServiceUrl?;
@@ -555,11 +528,6 @@ declare class OwneySDK {
     private applyOrgPolicyTo;
     private ensureAgentsInitialized;
     private createAgent;
-    /**
-     * Discover the agents actually returned by routing for this organization.
-     * Consumers should use this instead of hardcoding a global agent roster.
-     */
-    getAvailableAgents(options?: AvailableAgentsOptions): Promise<AvailableAgent[]>;
     /**
      * Activate the user's smart wallet for the specified agents, or all chain-compatible agents if omitted.
      * Deploys the Safe contract and creates a session key if not already set up.
@@ -570,7 +538,7 @@ declare class OwneySDK {
      *   If provided, ALL specified agents must support the chainId or the call
      *   throws before activating any agent.
      */
-    activateAgent(chainId: number, agentId?: AgentId[], asset?: OwneySupportedTokens): Promise<void>;
+    activateAgent(chainId: number, agentId?: AgentId[]): Promise<void>;
     /**
      * Activate agents ONE AT A TIME, each followed by its org policy.
      *
@@ -585,13 +553,13 @@ declare class OwneySDK {
      * at a time anyway.
      *
      * Every agent is attempted even if an earlier one fails, so one declined
-     * signature can't deny the remaining agents their turn. Once all agents have
-     * had a chance, a partial failure identifies the agents that still need a
-     * retry; if none activated, the original provider error is preserved.
+     * signature can't deny the remaining agents their turn. The first failure is
+     * rethrown (matching the previous `Promise.all` rejection) once all agents
+     * have had a chance to activate.
      */
     private activateAgentsInTurn;
     /**
-     * Deposit funds into a specific agent, or distribute across all agents if agentId is omitted.
+     * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
      * 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)
@@ -599,8 +567,7 @@ declare class OwneySDK {
      * @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 fund all eligible agents. Deposits
-     *   are equal once every agent is funded; first/recovery deposits also honor each agent's floor.
+     * @param options.agentId - Optional. Target agent. Omit to split equally across all agents.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
      */
     deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
@@ -632,7 +599,6 @@ declare class OwneySDK {
     private depositWithFallback;
     private getMinDepositAmount;
     private splitDepositAmount;
-    private formatAgentName;
     private validateMinDepositAmount;
     /**
      * Whether the user already holds a non-zero balance with `agent` for the
@@ -643,6 +609,17 @@ declare class OwneySDK {
     private hasExistingBalance;
     private validateAssetSupport;
     private getEligibleAgents;
+    /**
+     * 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.
+     */
+    getEligibleAgentIds(chainId: number, asset: string): Promise<AgentId[]>;
     /**
      * Withdraw funds from a specific agent, or all agents that support the active chain+asset if agentId is omitted.
      * Validates that the asset is supported by the target agent(s) on the active chain.
@@ -743,92 +720,7 @@ declare class OwneySDK {
     getAllocationApy({ agentId, }?: AllocationApyOptions): Promise<OwneyAllocationApy>;
 }
 
-type YieldseekerAuthDependencies = {
-    now?: () => Date;
-    nonce?: () => string;
-};
-
-type YieldseekerFetch = typeof fetch;
-
-type YieldseekerTransaction = {
-    from: `0x${string}`;
-    to: `0x${string}`;
-    data: `0x${string}`;
-    value: string;
-    chainId: number;
-};
-
-type YieldseekerAgentOptions = {
-    baseUrl?: string;
-    fetchFn?: YieldseekerFetch;
-    auth?: YieldseekerAuthDependencies;
-    /** Test seam for the wallet-submission/receipt boundary. */
-    transactionExecutor?: (state: ConnectionState, chainId: number, transaction: YieldseekerTransaction) => Promise<Hex>;
-    /** Test seam for transactions submitted outside transactionExecutor. */
-    unwindReceiptWaiter?: (state: ConnectionState, chainId: number, transactionHash: Hex) => Promise<void>;
-};
-declare class YieldseekerAgent implements IAgent {
-    readonly id = "yieldseeker";
-    readonly balanceComposition: "tokens-plus-positions";
-    readonly supportedChainIds: readonly [8453];
-    readonly supportedAssets: readonly [{
-        readonly chainId: 8453;
-        readonly chain: "BASE";
-        readonly assets: readonly [{
-            readonly symbol: "USDC";
-            readonly minDepositAmount: "10000000";
-        }, {
-            readonly symbol: "WETH";
-            readonly minDepositAmount: "1";
-        }];
-    }];
-    private readonly api;
-    private readonly auth;
-    private readonly transactionExecutor?;
-    private readonly unwindReceiptWaiter?;
-    private readonly agentContexts;
-    private readonly users;
-    private readonly pendingAgents;
-    constructor(owneyApiKey: string, options?: YieldseekerAgentOptions);
-    disconnect(): Promise<void>;
-    activateAgent(state: ConnectionState, chainId: number, asset?: OwneySupportedTokens): Promise<void>;
-    deposit(state: ConnectionState, chainId: number, amount: string, asset: OwneySupportedTokens, depositCallback?: DepositCallback): Promise<OwneyDepositResult>;
-    withdraw(state: ConnectionState, chainId: number, asset: OwneySupportedTokens, amount?: string): Promise<AgentWithdrawResult>;
-    getBalances(state: ConnectionState, chainId: number): Promise<AgentBalance>;
-    getEarnings(state: ConnectionState, chainId: number): Promise<AgentEarnings>;
-    getAccountApy(state: ConnectionState, chainId: number, days: DailyApyDays, tokenSymbol?: string): Promise<AccountAgentApy>;
-    getHistory(state: ConnectionState, chainId: number, options?: HistoryFilters): Promise<OwneyAgentHistory>;
-    getUserProfile(state: ConnectionState, chainId: number): Promise<AgentUserProfile>;
-    getAgentApy(days: DailyApyDays, options?: AgentApyOptions): Promise<AgentApy>;
-    private userKey;
-    private contextKey;
-    private resolveUser;
-    private forgetUser;
-    private ensureAgent;
-    private findAgent;
-    private resolveAgent;
-    private loadPortfolio;
-    private loadPortfolioContext;
-    private deployAfterFunding;
-    private refreshSnapshotAfterMovement;
-    private agentPath;
-    private walletRequest;
-    private providerRequest;
-    private mapApiError;
-    private submitTransaction;
-    private waitForReceipt;
-    private assertTransaction;
-    private assertAgent;
-    private isOwneyAgent;
-    private assetForAgent;
-    private isTransactionHash;
-    private assertChain;
-    private assertOptionalChain;
-    private assertAsset;
-    private invalidResponse;
-}
-
-type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "AGENT_ACTIVATION_PARTIAL_FAILURE" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_BALANCE_UNAVAILABLE" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "AGENT_API_ERROR" | "AGENT_AUTH_FAILED" | "AGENT_INVALID_RESPONSE" | "AGENT_TIMEOUT" | "AGENT_TRANSACTION_REVERTED" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
+type OwneyErrorCode = "NOT_CONNECTED" | "NO_ACTIVE_CHAIN" | "WALLET_NO_ACCOUNTS" | "WALLET_ADDRESS_REQUIRED" | "WALLET_NOT_DEPLOYED" | "AGENT_NOT_FOUND" | "AGENT_CHAIN_INCOMPATIBLE" | "AGENT_EMPTY_LIST" | "AGENT_DISABLED" | "CHAIN_UNSUPPORTED" | "CHAIN_NO_COMPATIBLE_AGENTS" | "CHAIN_MISMATCH" | "ASSET_UNSUPPORTED" | "ASSET_NO_COMPATIBLE_AGENTS" | "DEPOSIT_AMOUNT_BELOW_MINIMUM" | "DEPOSIT_CALLBACK_REQUIRED" | "DEPOSIT_CALLBACK_INVALID" | "DEPOSIT_NO_PERMITTED_TOKENS" | "DEPOSIT_ALL_FAILED" | "DEPOSIT_INSUFFICIENT_BALANCE" | "WITHDRAW_NO_PERMITTED_TOKENS" | "WITHDRAW_INSUFFICIENT_BALANCE" | "WITHDRAW_ALL_FAILED" | "WITHDRAW_PARTIAL_FAILURE" | "WITHDRAW_FAILED" | "API_ROUTING_ERROR" | "API_ROUTING_FAILED" | "API_NO_AGENTS" | "SPONSOR_REQUEST_FAILED" | "PERMIT2_APPROVAL_REQUIRED" | "SPONSORED_CALLS_UNSUPPORTED" | "SPONSORED_CALLS_NO_ID" | "SPONSORED_CALLS_NO_RECEIPT" | "BALANCE_ALL_FAILED" | "ALLOCATION_ALL_FAILED" | "VALIDATION_INVALID_DAYS";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;
@@ -894,4 +786,4 @@ type OwneySIWXConfig = {
  */
 declare function createOwneySIWX(config: OwneySIWXConfig): SIWXConfig;
 
-export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type AvailableAgent, type AvailableAgentsOptions, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type WithdrawOptions, YieldseekerAgent, createOwneySIWX, setOwneyDebug };
+export { type AccountAgentApy, type AccountApyOptions, type AgentApy, type AgentApyDetails, type AgentBalance, AgentChainIncompatibleError, type AgentEarnings, type AgentHistoryEntry, type AgentHistoryPosition, type AgentId, AgentNotFoundError, type AgentSupportedAsset, type AgentSupportedAssets, type AgentUserProfile, type AgentWithdrawResult, type AgentsApyOptions, type AllocationAgentApy, type AllocationApyOptions, type ApyByChainAndAsset, type ApyHistoryPoint, type Asset, type ConnectionState, type DailyApyDays, type DepositCallback, type DepositOptions, type HistoryAction, type HistoryFilters, type HistoryOptions, type HistoryTransaction, type IAgent, InvalidHistoryCursorError, NotConnectedError, type OwneyAccountApy, type OwneyAgentApy, type OwneyAgentHistory, type OwneyAllocationApy, type OwneyBalances, type OwneyDepositResult, type OwneyEarnings, OwneyError, type OwneyErrorCode, type OwneyMultiDepositResult, type OwneyPosition, OwneySDK, type OwneySDKConfig, type OwneySIWXConfig, type OwneySupportedChainId, type OwneySupportedChains, type OwneySupportedTokens, type OwneyToken, type OwneyUserProfile, type OwneyWithdrawResult, type RebalanceLog, type WithdrawOptions, createOwneySIWX, setOwneyDebug };