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

package/dist/index.cjs

@@ -2673,19 +2673,27 @@ function assetAddressValue(record, address) {
   );
   return entry?.[1] ?? "0";
 }
-function position(value, asset) {
+function position(value, asset, baseAssetDecimals) {
   const option = value?.yieldOption;
   if (!option || typeof option.provider !== "string" || typeof option.name !== "string" || typeof option.address !== "string" || !(0, import_viem5.isAddress)(option.address)) {
     return invalid("yield positions", "missing vault metadata");
   }
-  const decimals = YIELDSEEKER_ASSET_METADATA[asset].decimals;
   return {
     chain: "BASE",
     protocol: option.provider,
     protocolId: option.address,
     pool: option.name,
     asset,
-    amount: decimal(value.assetsRaw, decimals, "yield positions"),
+    // `assetsRaw` is the ERC-4626 vault-share quantity, whose decimals can
+    // differ from the underlying asset. Yieldseeker already converts it to
+    // underlying base-asset units in `assetsBase`; pair that value with the
+    // snapshot's corresponding `baseAssetDecimals` for display. Keep the raw
+    // share quantity separately because withdraw-from-position expects it.
+    amount: decimal(
+      value.assetsBase,
+      baseAssetDecimals,
+      "yield positions"
+    ),
     amountRaw: String(value.assetsRaw),
     apy: percent(option.riskAdjustedApy),
     tvl: Number(option.totalDepositsUsd),
@@ -2709,7 +2717,13 @@ function mapYieldseekerBalances(contexts) {
       amount: decimal(idle, metadata.decimals, "snapshot")
     });
     positions.push(
-      ...context.positions.map((entry) => position(entry, context.asset))
+      ...context.positions.map(
+        (entry) => position(
+          entry,
+          context.asset,
+          context.snapshot.baseAssetDecimals
+        )
+      )
     );
     totalUsd += usd(
       raw(context.snapshot.totalValueBase, "snapshot"),
@@ -2956,6 +2970,18 @@ function mapYieldseekerAgentApy(options, days) {
 
 // src/agents/yieldseeker/yieldseeker.agent.ts
 var OWNEY_AGENT_NAME = "owney";
+var YIELDSEEKER_USERNAME_PREFIX = "owney_";
+var YIELDSEEKER_USERNAME_RANDOM_LENGTH = 14;
+var YIELDSEEKER_USERNAME_CREATE_ATTEMPTS = 3;
+function generateYieldseekerUsername() {
+  const suffix = globalThis.crypto.randomUUID().replaceAll("-", "").slice(0, YIELDSEEKER_USERNAME_RANDOM_LENGTH).toLowerCase();
+  return `${YIELDSEEKER_USERNAME_PREFIX}${suffix}`;
+}
+function isUsernameConflict(error) {
+  if (!(error instanceof YieldseekerApiError)) return false;
+  const code = error.providerCode.toUpperCase();
+  return code.includes("USERNAME") && (code.includes("TAKEN") || code.includes("EXIST") || code.includes("UNAVAILABLE") || code.includes("IN_USE"));
+}
 var YIELDSEEKER_AGENT_WALLET_ABI = [
   {
     type: "function",
@@ -3295,21 +3321,26 @@ var YieldseekerAgent = class {
         throw this.mapApiError(error);
       }
       let created;
-      try {
-        created = await this.providerRequest(
-          state,
-          chainId,
-          "/users",
-          {
-            method: "POST",
-            body: {
-              walletAddress,
-              username: `owney-${walletAddress.slice(2).toLowerCase()}`
+      for (let attempt = 0; attempt < YIELDSEEKER_USERNAME_CREATE_ATTEMPTS; attempt += 1) {
+        try {
+          created = await this.providerRequest(
+            state,
+            chainId,
+            "/users",
+            {
+              method: "POST",
+              body: {
+                walletAddress,
+                username: generateYieldseekerUsername()
+              }
             }
-          }
-        );
-      } catch (createError) {
-        throw this.mapApiError(createError);
+          );
+          break;
+        } catch (createError) {
+          const canRetry = isUsernameConflict(createError) && attempt + 1 < YIELDSEEKER_USERNAME_CREATE_ATTEMPTS;
+          if (canRetry) continue;
+          throw this.mapApiError(createError);
+        }
       }
       user = created?.user ?? null;
     }
@@ -4644,17 +4675,25 @@ var OwneySDK = class {
    * 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. The first failure is
-   * rethrown (matching the previous `Promise.all` rejection) once all agents
-   * have had a chance to activate.
+   * 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.
    */
   async activateAgentsInTurn(agents, state, chainId, asset) {
     let firstError = null;
+    const activatedAgentIds = [];
+    const failedAgents = [];
     for (const agent of agents) {
       try {
         await agent.activateAgent(state, chainId, asset);
         await this.applyOrgPolicyTo(agent, state, chainId);
+        activatedAgentIds.push(agent.id);
       } catch (error) {
+        failedAgents.push({
+          agentId: agent.id,
+          code: error instanceof OwneyError ? error.code : void 0,
+          message: error instanceof Error ? error.message : String(error)
+        });
         if (firstError === null) {
           firstError = error;
         } else {
@@ -4662,10 +4701,19 @@ var OwneySDK = class {
         }
       }
     }
-    if (firstError !== null) throw firstError;
+    if (firstError === null) return;
+    if (activatedAgentIds.length === 0) throw firstError;
+    const failedAgentIds = failedAgents.map(({ agentId }) => agentId);
+    const activeNames = activatedAgentIds.map(this.formatAgentName).join(", ");
+    const remainingNames = failedAgentIds.map(this.formatAgentName).join(", ");
+    throw new OwneyError(
+      "AGENT_ACTIVATION_PARTIAL_FAILURE",
+      `${activeNames} activated, but ${remainingNames} still needs activation. Try again and approve the remaining wallet request.`,
+      { activatedAgentIds, failedAgentIds, failures: failedAgents }
+    );
   }
   /**
-   * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
+   * Deposit funds into a specific agent, or distribute 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)
@@ -4673,7 +4721,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. 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.
    * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
    */
   async deposit(options) {
@@ -4725,10 +4774,35 @@ 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 = perAgentMinimum * BigInt(agentsRequiringActivation.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 = {};
@@ -4814,6 +4888,20 @@ 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 * 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) => ({
@@ -4826,13 +4914,29 @@ var OwneySDK = class {
     if (valid2.length === agents.length) {
       return splits.map((s) => ({ agent: s.agent, amount: String(s.amount) }));
     }
-    return this.splitDepositAmount(
-      totalAmount,
-      valid2.map((s) => s.agent),
-      chainId,
-      asset,
-      exempt
+    const targets = agentsRequiringActivation.length > 0 ? agentsRequiringActivation : valid2.map((s) => s.agent);
+    const highestMinimum = targets.reduce(
+      (highest, agent) => {
+        const minimum = this.getMinDepositAmount(agent, chainId, asset);
+        return minimum > highest ? minimum : highest;
+      },
+      0n
     );
+    const minimumRequired = highestMinimum * 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)
+      )
+    }));
+  }
+  formatAgentName(agentId) {
+    if (agentId === "zyfai") return "Zyfai";
+    if (agentId === "yieldseeker") return "Yieldseeker";
+    return agentId;
   }
   async validateMinDepositAmount(agent, state, chainId, asset, amount) {
     const minDepositAmount = this.getMinDepositAmount(agent, chainId, asset);
@@ -4864,7 +4968,20 @@ var OwneySDK = class {
       const token = balance.tokens.find(
         (t) => t.chainId === chainId && t.asset.toLowerCase() === target
       );
-      return !!token && Number(token.amount) > 0;
+      const chainNameById = {
+        1: "ETHEREUM",
+        8453: "BASE",
+        42161: "ARBITRUM"
+      };
+      const targetChainName = chainNameById[chainId];
+      const position2 = (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 || !!position2;
     } catch {
       return false;
     }
@@ -5087,8 +5204,12 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      const result = await this.getAgent(agentId).getBalances(state, chainId);
-      return result;
+      const agent = this.getAgent(agentId);
+      const result = await agent.getBalances(state, chainId);
+      return {
+        ...result,
+        balanceComposition: agent.balanceComposition ?? "tokens-include-positions"
+      };
     }
     let totalBalance = 0;
     const results = {};
@@ -5096,7 +5217,13 @@ var OwneySDK = class {
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
         const b = await agent.getBalances(state, chainId);
-        return [id, b];
+        return [
+          id,
+          {
+            ...b,
+            balanceComposition: agent.balanceComposition ?? "tokens-include-positions"
+          }
+        ];
       })
     );
     let successCount = 0;

package/dist/index.d.cts

@@ -245,6 +245,13 @@ 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
@@ -578,13 +585,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. The first failure is
-     * rethrown (matching the previous `Promise.all` rejection) once all agents
-     * have had a chance to activate.
+     * 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.
      */
     private activateAgentsInTurn;
     /**
-     * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
+     * Deposit funds into a specific agent, or distribute 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)
@@ -592,7 +599,8 @@ 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 split equally across all agents.
+     * @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.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
      */
     deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
@@ -624,6 +632,7 @@ 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
@@ -819,7 +828,7 @@ declare class YieldseekerAgent implements IAgent {
     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" | "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" | "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";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.d.ts

@@ -245,6 +245,13 @@ 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
@@ -578,13 +585,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. The first failure is
-     * rethrown (matching the previous `Promise.all` rejection) once all agents
-     * have had a chance to activate.
+     * 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.
      */
     private activateAgentsInTurn;
     /**
-     * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
+     * Deposit funds into a specific agent, or distribute 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)
@@ -592,7 +599,8 @@ 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 split equally across all agents.
+     * @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.
      * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
      */
     deposit(options: DepositOptions): Promise<OwneyDepositResult | OwneyMultiDepositResult>;
@@ -624,6 +632,7 @@ 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
@@ -819,7 +828,7 @@ declare class YieldseekerAgent implements IAgent {
     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" | "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" | "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";
 declare class OwneyError extends Error {
     readonly code: OwneyErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.js

@@ -2652,19 +2652,27 @@ function assetAddressValue(record, address) {
   );
   return entry?.[1] ?? "0";
 }
-function position(value, asset) {
+function position(value, asset, baseAssetDecimals) {
   const option = value?.yieldOption;
   if (!option || typeof option.provider !== "string" || typeof option.name !== "string" || typeof option.address !== "string" || !isAddress(option.address)) {
     return invalid("yield positions", "missing vault metadata");
   }
-  const decimals = YIELDSEEKER_ASSET_METADATA[asset].decimals;
   return {
     chain: "BASE",
     protocol: option.provider,
     protocolId: option.address,
     pool: option.name,
     asset,
-    amount: decimal(value.assetsRaw, decimals, "yield positions"),
+    // `assetsRaw` is the ERC-4626 vault-share quantity, whose decimals can
+    // differ from the underlying asset. Yieldseeker already converts it to
+    // underlying base-asset units in `assetsBase`; pair that value with the
+    // snapshot's corresponding `baseAssetDecimals` for display. Keep the raw
+    // share quantity separately because withdraw-from-position expects it.
+    amount: decimal(
+      value.assetsBase,
+      baseAssetDecimals,
+      "yield positions"
+    ),
     amountRaw: String(value.assetsRaw),
     apy: percent(option.riskAdjustedApy),
     tvl: Number(option.totalDepositsUsd),
@@ -2688,7 +2696,13 @@ function mapYieldseekerBalances(contexts) {
       amount: decimal(idle, metadata.decimals, "snapshot")
     });
     positions.push(
-      ...context.positions.map((entry) => position(entry, context.asset))
+      ...context.positions.map(
+        (entry) => position(
+          entry,
+          context.asset,
+          context.snapshot.baseAssetDecimals
+        )
+      )
     );
     totalUsd += usd(
       raw(context.snapshot.totalValueBase, "snapshot"),
@@ -2935,6 +2949,18 @@ function mapYieldseekerAgentApy(options, days) {
 
 // src/agents/yieldseeker/yieldseeker.agent.ts
 var OWNEY_AGENT_NAME = "owney";
+var YIELDSEEKER_USERNAME_PREFIX = "owney_";
+var YIELDSEEKER_USERNAME_RANDOM_LENGTH = 14;
+var YIELDSEEKER_USERNAME_CREATE_ATTEMPTS = 3;
+function generateYieldseekerUsername() {
+  const suffix = globalThis.crypto.randomUUID().replaceAll("-", "").slice(0, YIELDSEEKER_USERNAME_RANDOM_LENGTH).toLowerCase();
+  return `${YIELDSEEKER_USERNAME_PREFIX}${suffix}`;
+}
+function isUsernameConflict(error) {
+  if (!(error instanceof YieldseekerApiError)) return false;
+  const code = error.providerCode.toUpperCase();
+  return code.includes("USERNAME") && (code.includes("TAKEN") || code.includes("EXIST") || code.includes("UNAVAILABLE") || code.includes("IN_USE"));
+}
 var YIELDSEEKER_AGENT_WALLET_ABI = [
   {
     type: "function",
@@ -3274,21 +3300,26 @@ var YieldseekerAgent = class {
         throw this.mapApiError(error);
       }
       let created;
-      try {
-        created = await this.providerRequest(
-          state,
-          chainId,
-          "/users",
-          {
-            method: "POST",
-            body: {
-              walletAddress,
-              username: `owney-${walletAddress.slice(2).toLowerCase()}`
+      for (let attempt = 0; attempt < YIELDSEEKER_USERNAME_CREATE_ATTEMPTS; attempt += 1) {
+        try {
+          created = await this.providerRequest(
+            state,
+            chainId,
+            "/users",
+            {
+              method: "POST",
+              body: {
+                walletAddress,
+                username: generateYieldseekerUsername()
+              }
             }
-          }
-        );
-      } catch (createError) {
-        throw this.mapApiError(createError);
+          );
+          break;
+        } catch (createError) {
+          const canRetry = isUsernameConflict(createError) && attempt + 1 < YIELDSEEKER_USERNAME_CREATE_ATTEMPTS;
+          if (canRetry) continue;
+          throw this.mapApiError(createError);
+        }
       }
       user = created?.user ?? null;
     }
@@ -4627,17 +4658,25 @@ var OwneySDK = class {
    * 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. The first failure is
-   * rethrown (matching the previous `Promise.all` rejection) once all agents
-   * have had a chance to activate.
+   * 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.
    */
   async activateAgentsInTurn(agents, state, chainId, asset) {
     let firstError = null;
+    const activatedAgentIds = [];
+    const failedAgents = [];
     for (const agent of agents) {
       try {
         await agent.activateAgent(state, chainId, asset);
         await this.applyOrgPolicyTo(agent, state, chainId);
+        activatedAgentIds.push(agent.id);
       } catch (error) {
+        failedAgents.push({
+          agentId: agent.id,
+          code: error instanceof OwneyError ? error.code : void 0,
+          message: error instanceof Error ? error.message : String(error)
+        });
         if (firstError === null) {
           firstError = error;
         } else {
@@ -4645,10 +4684,19 @@ var OwneySDK = class {
         }
       }
     }
-    if (firstError !== null) throw firstError;
+    if (firstError === null) return;
+    if (activatedAgentIds.length === 0) throw firstError;
+    const failedAgentIds = failedAgents.map(({ agentId }) => agentId);
+    const activeNames = activatedAgentIds.map(this.formatAgentName).join(", ");
+    const remainingNames = failedAgentIds.map(this.formatAgentName).join(", ");
+    throw new OwneyError(
+      "AGENT_ACTIVATION_PARTIAL_FAILURE",
+      `${activeNames} activated, but ${remainingNames} still needs activation. Try again and approve the remaining wallet request.`,
+      { activatedAgentIds, failedAgentIds, failures: failedAgents }
+    );
   }
   /**
-   * Deposit funds into a specific agent, or split equally across all agents if agentId is omitted.
+   * Deposit funds into a specific agent, or distribute 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)
@@ -4656,7 +4704,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. 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.
    * @returns {OwneyDepositResult} for a single agent, or {OwneyMultiDepositResult} with per-agent results
    */
   async deposit(options) {
@@ -4708,10 +4757,35 @@ 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 = perAgentMinimum * BigInt(agentsRequiringActivation.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 = {};
@@ -4797,6 +4871,20 @@ 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 * 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) => ({
@@ -4809,13 +4897,29 @@ var OwneySDK = class {
     if (valid2.length === agents.length) {
       return splits.map((s) => ({ agent: s.agent, amount: String(s.amount) }));
     }
-    return this.splitDepositAmount(
-      totalAmount,
-      valid2.map((s) => s.agent),
-      chainId,
-      asset,
-      exempt
+    const targets = agentsRequiringActivation.length > 0 ? agentsRequiringActivation : valid2.map((s) => s.agent);
+    const highestMinimum = targets.reduce(
+      (highest, agent) => {
+        const minimum = this.getMinDepositAmount(agent, chainId, asset);
+        return minimum > highest ? minimum : highest;
+      },
+      0n
     );
+    const minimumRequired = highestMinimum * 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)
+      )
+    }));
+  }
+  formatAgentName(agentId) {
+    if (agentId === "zyfai") return "Zyfai";
+    if (agentId === "yieldseeker") return "Yieldseeker";
+    return agentId;
   }
   async validateMinDepositAmount(agent, state, chainId, asset, amount) {
     const minDepositAmount = this.getMinDepositAmount(agent, chainId, asset);
@@ -4847,7 +4951,20 @@ var OwneySDK = class {
       const token = balance.tokens.find(
         (t) => t.chainId === chainId && t.asset.toLowerCase() === target
       );
-      return !!token && Number(token.amount) > 0;
+      const chainNameById = {
+        1: "ETHEREUM",
+        8453: "BASE",
+        42161: "ARBITRUM"
+      };
+      const targetChainName = chainNameById[chainId];
+      const position2 = (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 || !!position2;
     } catch {
       return false;
     }
@@ -5070,8 +5187,12 @@ var OwneySDK = class {
     const state = this.requireState();
     const chainId = this.requireChainId();
     if (agentId) {
-      const result = await this.getAgent(agentId).getBalances(state, chainId);
-      return result;
+      const agent = this.getAgent(agentId);
+      const result = await agent.getBalances(state, chainId);
+      return {
+        ...result,
+        balanceComposition: agent.balanceComposition ?? "tokens-include-positions"
+      };
     }
     let totalBalance = 0;
     const results = {};
@@ -5079,7 +5200,13 @@ var OwneySDK = class {
     const balanceResults = await Promise.allSettled(
       entries.map(async ([id, agent]) => {
         const b = await agent.getBalances(state, chainId);
-        return [id, b];
+        return [
+          id,
+          {
+            ...b,
+            balanceComposition: agent.balanceComposition ?? "tokens-include-positions"
+          }
+        ];
       })
     );
     let successCount = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owney/sdk",
-  "version": "0.7.16-beta.3",
+  "version": "0.7.16-beta.5",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",