@lagoon-protocol/lagoon-mcp 0.2.14 → 0.2.16

package/dist/graphql/fragments/composition.fragment.d.ts

@@ -1,11 +1,135 @@
 /**
  * Composition Fragment
  *
- * GraphQL fragment for vault composition data including protocol and token breakdowns.
- * Uses the composition field added by the CompositionModule in the backend.
+ * Type definitions for vault composition data from Octav API.
+ * The backend returns a JSONObject with chains as keys containing composition data.
+ *
+ * Note: The vaultComposition endpoint returns JSONObject type, so no GraphQL fragment
+ * is needed. The response is a flat object keyed by chain name.
+ */
+/**
+ * Chain composition data from Octav API
+ * Each chain entry contains aggregated position values and metadata
+ */
+export interface ChainComposition {
+    /** Display name of the chain (e.g., "Ethereum", "Arbitrum") */
+    name: string;
+    /** Unique key for the chain (e.g., "ethereum", "arbitrum") */
+    key: string;
+    /** Chain ID as string (e.g., "1", "42161") */
+    chainId: string;
+    /** Total USD value of positions on this chain */
+    value: string;
+    /** Percentile ranking of this chain's value */
+    valuePercentile: string;
+    /** Total cost basis (may be "N/A") */
+    totalCostBasis: string;
+    /** Total closed PnL (may be "N/A") */
+    totalClosedPnl: string;
+    /** Total open PnL (may be "N/A") */
+    totalOpenPnl: string;
+}
+/**
+ * Raw vaultComposition response - JSONObject keyed by chain name
+ *
+ * Example:
+ * ```typescript
+ * {
+ *   "ethereum": { name: "Ethereum", key: "ethereum", chainId: "1", value: "6224.80", ... },
+ *   "arbitrum": { name: "Arbitrum", key: "arbitrum", chainId: "42161", value: "3.99", ... },
+ *   "linea": { name: "Linea", key: "linea", chainId: "59144", value: "0", ... },
+ *   // ... 60+ chains
+ * }
+ * ```
+ */
+export type RawVaultComposition = Record<string, ChainComposition>;
+/**
+ * Position category within a chain (e.g., LENDING, YIELD, DEPOSIT, SPOT)
  */
+export interface ProtocolPositionCategory {
+    /** Category name (e.g., "Lending", "Yield", "Deposit", "Spot") */
+    name: string;
+    /** Total USD value in this category */
+    totalValue: string;
+}
 /**
- * Protocol composition within a vault
+ * Chain-level breakdown within a protocol
+ */
+export interface ProtocolChainData {
+    /** Chain display name (e.g., "Ethereum") */
+    name: string;
+    /** Chain key (e.g., "ethereum") */
+    key: string;
+    /** USD value on this chain */
+    value: string;
+    /** Total cost basis (may be "N/A") */
+    totalCostBasis: string;
+    /** Total closed PnL (may be "N/A") */
+    totalClosedPnl: string;
+    /** Total open PnL (may be "N/A") */
+    totalOpenPnl: string;
+    /** Position categories on this chain (keyed by category type) */
+    protocolPositions: Record<string, ProtocolPositionCategory>;
+}
+/**
+ * Protocol-level composition data from Octav API
+ * Represents a DeFi protocol like Spark, Morpho, Yield Basis, or "wallet" for idle assets
+ *
+ * Example protocols: spark, morphoblue, yieldbasis, lagoon, hyperliquid, wallet
+ */
+export interface ProtocolCompositionData {
+    /** Protocol display name (e.g., "Spark", "Morpho", "Yield Basis", "Wallet") */
+    name: string;
+    /** Protocol key/identifier (e.g., "spark", "morphoblue", "wallet") */
+    key: string;
+    /** Total USD value in this protocol */
+    value: string;
+    /** Total cost basis (may be "N/A") */
+    totalCostBasis: string;
+    /** Total closed PnL (may be "N/A") */
+    totalClosedPnl: string;
+    /** Total open PnL (may be "N/A") */
+    totalOpenPnl: string;
+    /** Chain-level breakdown within this protocol */
+    chains: Record<string, ProtocolChainData>;
+}
+/**
+ * Full vaultComposition response structure from Octav API
+ *
+ * Contains two main sections:
+ * - assetByProtocols: Protocol-level breakdown (preferred for analysis)
+ * - chains: Chain-level summary (legacy, kept for backward compatibility)
+ *
+ * Example:
+ * ```typescript
+ * {
+ *   address: "0x...",
+ *   networth: "4970636.89",
+ *   assetByProtocols: {
+ *     "spark": { name: "Spark", value: "1324461.98", chains: { ethereum: {...} } },
+ *     "wallet": { name: "Wallet", value: "6356.97", chains: { ethereum: {...} } },
+ *     // ... other protocols
+ *   },
+ *   chains: {
+ *     "ethereum": { name: "Ethereum", chainId: "1", value: "4970455.03", ... },
+ *     // ... other chains
+ *   }
+ * }
+ * ```
+ */
+export interface VaultCompositionFullResponse {
+    /** Vault/wallet address */
+    address: string;
+    /** Total portfolio net worth in USD */
+    networth: string;
+    /** Protocol-level breakdown (PRIMARY - use for diversification analysis) */
+    assetByProtocols: Record<string, ProtocolCompositionData>;
+    /** Chain-level summary (LEGACY - kept for backward compatibility) */
+    chains: Record<string, ChainComposition>;
+}
+/**
+ * @deprecated Use ChainComposition instead - backend API changed
+ * Protocol composition within a vault (legacy structure)
  */
 export interface ProtocolComposition {
     protocol: string;
@@ -14,7 +138,8 @@ export interface ProtocolComposition {
     details?: ProtocolComposition[];
 }
 /**
- * Token/position composition within a vault
+ * @deprecated Use ChainComposition instead - backend API changed
+ * Token/position composition within a vault (legacy structure)
  */
 export interface TokenComposition {
     symbol: string;
@@ -26,24 +151,16 @@ export interface TokenComposition {
     details?: TokenComposition[];
 }
 /**
- * Complete composition data for a vault
+ * @deprecated Use RawVaultComposition instead - backend API changed
+ * Complete composition data for a vault (legacy structure)
  */
 export interface CompositionData {
     compositions: ProtocolComposition[];
     tokenCompositions: TokenComposition[];
 }
 /**
- * GraphQL fragment for composition data
- *
- * Usage:
- * ```graphql
- * query MyQuery {
- *   composition(address: "0x...") {
- *     ...CompositionFragment
- *   }
- * }
- * ${COMPOSITION_FRAGMENT}
- * ```
+ * @deprecated No longer used - backend returns JSONObject, not a typed GraphQL response
+ * GraphQL fragment for composition data (legacy)
  */
 export declare const COMPOSITION_FRAGMENT = "\n  fragment CompositionFragment on CompositionData {\n    compositions {\n      protocol\n      valueInUsd\n      repartition\n      details {\n        protocol\n        valueInUsd\n        repartition\n      }\n    }\n    tokenCompositions {\n      symbol\n      name\n      contract\n      chainKey\n      valueInUsd\n      repartition\n      details {\n        symbol\n        name\n        contract\n        chainKey\n        valueInUsd\n        repartition\n      }\n    }\n  }\n";
 //# sourceMappingURL=composition.fragment.d.ts.map

package/dist/graphql/fragments/composition.fragment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition.fragment.d.ts","sourceRoot":"","sources":["../../../src/graphql/fragments/composition.fragment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,0eA6BhC,CAAC"}
+{"version":3,"file":"composition.fragment.d.ts","sourceRoot":"","sources":["../../../src/graphql/fragments/composition.fragment.ts"],"names":[],"mappings":"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"}

package/dist/graphql/fragments/composition.fragment.js

@@ -1,21 +1,15 @@
 /**
  * Composition Fragment
  *
- * GraphQL fragment for vault composition data including protocol and token breakdowns.
- * Uses the composition field added by the CompositionModule in the backend.
+ * Type definitions for vault composition data from Octav API.
+ * The backend returns a JSONObject with chains as keys containing composition data.
+ *
+ * Note: The vaultComposition endpoint returns JSONObject type, so no GraphQL fragment
+ * is needed. The response is a flat object keyed by chain name.
  */
 /**
- * GraphQL fragment for composition data
- *
- * Usage:
- * ```graphql
- * query MyQuery {
- *   composition(address: "0x...") {
- *     ...CompositionFragment
- *   }
- * }
- * ${COMPOSITION_FRAGMENT}
- * ```
+ * @deprecated No longer used - backend returns JSONObject, not a typed GraphQL response
+ * GraphQL fragment for composition data (legacy)
  */
 export const COMPOSITION_FRAGMENT = `
   fragment CompositionFragment on CompositionData {

package/dist/graphql/fragments/composition.fragment.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.fragment.js","sourceRoot":"","sources":["../../../src/graphql/fragments/composition.fragment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnC,CAAC"}
+{"version":3,"file":"composition.fragment.js","sourceRoot":"","sources":["../../../src/graphql/fragments/composition.fragment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4KH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnC,CAAC"}

package/dist/graphql/fragments/index.d.ts

@@ -12,5 +12,5 @@ export { TRANSACTION_BASE_FRAGMENT } from './transaction-base.fragment.js';
 export { VAULT_FRAGMENT, type VaultData } from './vault.fragment.js';
 export { VAULT_LIST_FRAGMENT, type VaultListData } from './vault-list.fragment.js';
 export { VAULT_SUMMARY_FRAGMENT, type VaultSummaryData } from './vault-summary.fragment.js';
-export { COMPOSITION_FRAGMENT, type ProtocolComposition, type TokenComposition, type CompositionData, } from './composition.fragment.js';
+export { type ProtocolPositionCategory, type ProtocolChainData, type ProtocolCompositionData, type VaultCompositionFullResponse, type ChainComposition, type RawVaultComposition, COMPOSITION_FRAGMENT, type ProtocolComposition, type TokenComposition, type CompositionData, } from './composition.fragment.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/graphql/fragments/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/fragments/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/fragments/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG5F,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAEjC,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAExB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/graphql/fragments/index.js

@@ -18,6 +18,8 @@ export { TRANSACTION_BASE_FRAGMENT } from './transaction-base.fragment.js';
 export { VAULT_FRAGMENT } from './vault.fragment.js';
 export { VAULT_LIST_FRAGMENT } from './vault-list.fragment.js';
 export { VAULT_SUMMARY_FRAGMENT } from './vault-summary.fragment.js';
-// Composition Fragment
-export { COMPOSITION_FRAGMENT, } from './composition.fragment.js';
+// Composition Fragment - protocol and chain-based types
+export { 
+// Legacy types (deprecated - kept for backward compatibility)
+COMPOSITION_FRAGMENT, } from './composition.fragment.js';
 //# sourceMappingURL=index.js.map

package/dist/graphql/fragments/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/fragments/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAqB,MAAM,6BAA6B,CAAC;AAExF,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,qBAAqB;AACrB,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE3F,4BAA4B;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,6BAA6B,CAAC;AAE5F,uBAAuB;AACvB,OAAO,EACL,oBAAoB,GAIrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/fragments/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAqB,MAAM,6BAA6B,CAAC;AAExF,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,qBAAqB;AACrB,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE3F,4BAA4B;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,6BAA6B,CAAC;AAE5F,wDAAwD;AACxD,OAAO;AASL,8DAA8D;AAC9D,oBAAoB,GAIrB,MAAM,2BAA2B,CAAC"}

package/dist/graphql/queries/composition.queries.d.ts

@@ -1,22 +1,33 @@
 /**
  * Composition Queries
  *
- * GraphQL queries for vault composition data (protocol and token breakdowns).
- * Uses the composition field from the backend CompositionModule.
+ * GraphQL queries for vault composition data from Octav API.
+ * The backend returns a JSONObject with chains as keys containing composition data.
+ *
+ * Note: The vaultComposition endpoint returns JSONObject type, so no GraphQL fragment
+ * is needed. The response is a flat object keyed by chain name.
  */
 /**
  * Get vault composition GraphQL query
  *
- * Fetches protocol and token composition breakdown for a vault.
+ * Fetches cross-chain composition data for a vault from Octav API.
+ * Returns a JSONObject with chain keys (ethereum, arbitrum, etc.) containing:
+ * - name: Chain display name
+ * - key: Chain identifier
+ * - chainId: Chain ID as string
+ * - value: USD value of positions
+ * - valuePercentile: Relative ranking
+ * - totalCostBasis, totalClosedPnl, totalOpenPnl: PnL metrics
+ *
  * Used by: get_vault_composition tool
  *
  * Usage:
  * ```typescript
- * const data = await graphqlClient.request<{ vaultComposition: CompositionData | null }>(
+ * const data = await graphqlClient.request<{ vaultComposition: RawVaultComposition | null }>(
  *   GET_VAULT_COMPOSITION_QUERY,
- *   { vaultAddress: '0x...' }
+ *   { walletAddress: '0x...' }
  * );
  * ```
  */
-export declare const GET_VAULT_COMPOSITION_QUERY = "\n  query GetVaultComposition($vaultAddress: Address!) {\n    vaultComposition(vaultAddress: $vaultAddress) {\n      ...CompositionFragment\n    }\n  }\n  \n  fragment CompositionFragment on CompositionData {\n    compositions {\n      protocol\n      valueInUsd\n      repartition\n      details {\n        protocol\n        valueInUsd\n        repartition\n      }\n    }\n    tokenCompositions {\n      symbol\n      name\n      contract\n      chainKey\n      valueInUsd\n      repartition\n      details {\n        symbol\n        name\n        contract\n        chainKey\n        valueInUsd\n        repartition\n      }\n    }\n  }\n\n";
+export declare const GET_VAULT_COMPOSITION_QUERY = "\n  query GetVaultComposition($walletAddress: Address!) {\n    vaultComposition(walletAddress: $walletAddress)\n  }\n";
 //# sourceMappingURL=composition.queries.d.ts.map

package/dist/graphql/queries/composition.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/composition.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,uoBAOvC,CAAC"}
+{"version":3,"file":"composition.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/composition.queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,2BAA2B,0HAIvC,CAAC"}

package/dist/graphql/queries/composition.queries.js

@@ -1,30 +1,37 @@
 /**
  * Composition Queries
  *
- * GraphQL queries for vault composition data (protocol and token breakdowns).
- * Uses the composition field from the backend CompositionModule.
+ * GraphQL queries for vault composition data from Octav API.
+ * The backend returns a JSONObject with chains as keys containing composition data.
+ *
+ * Note: The vaultComposition endpoint returns JSONObject type, so no GraphQL fragment
+ * is needed. The response is a flat object keyed by chain name.
  */
-import { COMPOSITION_FRAGMENT } from '../fragments/index.js';
 /**
  * Get vault composition GraphQL query
  *
- * Fetches protocol and token composition breakdown for a vault.
+ * Fetches cross-chain composition data for a vault from Octav API.
+ * Returns a JSONObject with chain keys (ethereum, arbitrum, etc.) containing:
+ * - name: Chain display name
+ * - key: Chain identifier
+ * - chainId: Chain ID as string
+ * - value: USD value of positions
+ * - valuePercentile: Relative ranking
+ * - totalCostBasis, totalClosedPnl, totalOpenPnl: PnL metrics
+ *
  * Used by: get_vault_composition tool
  *
  * Usage:
  * ```typescript
- * const data = await graphqlClient.request<{ vaultComposition: CompositionData | null }>(
+ * const data = await graphqlClient.request<{ vaultComposition: RawVaultComposition | null }>(
  *   GET_VAULT_COMPOSITION_QUERY,
- *   { vaultAddress: '0x...' }
+ *   { walletAddress: '0x...' }
  * );
  * ```
  */
 export const GET_VAULT_COMPOSITION_QUERY = `
-  query GetVaultComposition($vaultAddress: Address!) {
-    vaultComposition(vaultAddress: $vaultAddress) {
-      ...CompositionFragment
-    }
+  query GetVaultComposition($walletAddress: Address!) {
+    vaultComposition(walletAddress: $walletAddress)
   }
-  ${COMPOSITION_FRAGMENT}
 `;
 //# sourceMappingURL=composition.queries.js.map

package/dist/graphql/queries/composition.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"composition.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/composition.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;IAMvC,oBAAoB;CACvB,CAAC"}
+{"version":3,"file":"composition.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/composition.queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;CAI1C,CAAC"}

package/dist/graphql/queries/portfolio.queries.d.ts

@@ -68,20 +68,25 @@ export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOpt
 /**
  * GraphQL query for single vault composition data
  *
- * Fetches composition data for a single vault, used in parallel
- * to aggregate portfolio-wide composition metrics.
+ * Fetches cross-chain composition data for a vault from Octav API.
+ * Returns a JSONObject with chain keys containing composition metrics.
+ *
+ * Note: Backend API changed - now uses `walletAddress` parameter and returns
+ * JSONObject type (no fragment needed). Response contains chains as keys with
+ * value, chainId, name, etc.
  *
  * Used by: get_user_portfolio tool (for composition aggregation)
+ *         compare_vaults tool (for diversification analysis)
  *
  * Usage:
  * ```typescript
- * const data = await graphqlClient.request<SingleVaultCompositionResponse>(
+ * const data = await graphqlClient.request<{ vaultComposition: RawVaultComposition | null }>(
  *   SINGLE_VAULT_COMPOSITION_QUERY,
- *   { vaultAddress: '0x...' }
+ *   { walletAddress: '0x...' }
  * );
  * ```
  */
-export declare const SINGLE_VAULT_COMPOSITION_QUERY = "\n  query SingleVaultComposition($vaultAddress: Address!) {\n    vaultComposition(vaultAddress: $vaultAddress) {\n      ...CompositionFragment\n    }\n  }\n  \n  fragment CompositionFragment on CompositionData {\n    compositions {\n      protocol\n      valueInUsd\n      repartition\n      details {\n        protocol\n        valueInUsd\n        repartition\n      }\n    }\n    tokenCompositions {\n      symbol\n      name\n      contract\n      chainKey\n      valueInUsd\n      repartition\n      details {\n        symbol\n        name\n        contract\n        chainKey\n        valueInUsd\n        repartition\n      }\n    }\n  }\n\n";
+export declare const SINGLE_VAULT_COMPOSITION_QUERY = "\n  query SingleVaultComposition($walletAddress: Address!) {\n    vaultComposition(walletAddress: $walletAddress)\n  }\n";
 /**
  * GraphQL query for portfolio optimization data (DEPRECATED)
  *

package/dist/graphql/queries/portfolio.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAqBlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAE,uBAAmC,GAClD,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+BAA+B,s+GAmC3C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,0oBAO1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,0wHAiDxC,CAAC"}
+{"version":3,"file":"portfolio.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAqBlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAE,uBAAmC,GAClD,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+BAA+B,s+GAmC3C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,8BAA8B,6HAI1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,0wHAiDxC,CAAC"}

package/dist/graphql/queries/portfolio.queries.js

@@ -4,7 +4,7 @@
  * GraphQL queries for user portfolio operations.
  * Includes user portfolio data and portfolio optimization queries.
  */
-import { VAULT_FRAGMENT, VAULT_LIST_FRAGMENT, VAULT_SUMMARY_FRAGMENT, COMPOSITION_FRAGMENT, } from '../fragments/index.js';
+import { VAULT_FRAGMENT, VAULT_LIST_FRAGMENT, VAULT_SUMMARY_FRAGMENT } from '../fragments/index.js';
 /**
  * Get fragment and fragment name based on response format for portfolio queries
  */
@@ -139,26 +139,28 @@ export const SINGLE_VAULT_OPTIMIZATION_QUERY = `
 /**
  * GraphQL query for single vault composition data
  *
- * Fetches composition data for a single vault, used in parallel
- * to aggregate portfolio-wide composition metrics.
+ * Fetches cross-chain composition data for a vault from Octav API.
+ * Returns a JSONObject with chain keys containing composition metrics.
+ *
+ * Note: Backend API changed - now uses `walletAddress` parameter and returns
+ * JSONObject type (no fragment needed). Response contains chains as keys with
+ * value, chainId, name, etc.
  *
  * Used by: get_user_portfolio tool (for composition aggregation)
+ *         compare_vaults tool (for diversification analysis)
  *
  * Usage:
  * ```typescript
- * const data = await graphqlClient.request<SingleVaultCompositionResponse>(
+ * const data = await graphqlClient.request<{ vaultComposition: RawVaultComposition | null }>(
  *   SINGLE_VAULT_COMPOSITION_QUERY,
- *   { vaultAddress: '0x...' }
+ *   { walletAddress: '0x...' }
  * );
  * ```
  */
 export const SINGLE_VAULT_COMPOSITION_QUERY = `
-  query SingleVaultComposition($vaultAddress: Address!) {
-    vaultComposition(vaultAddress: $vaultAddress) {
-      ...CompositionFragment
-    }
+  query SingleVaultComposition($walletAddress: Address!) {
+    vaultComposition(walletAddress: $walletAddress)
   }
-  ${COMPOSITION_FRAGMENT}
 `;
 /**
  * GraphQL query for portfolio optimization data (DEPRECATED)

package/dist/graphql/queries/portfolio.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAO/B;;GAEG;AACH,SAAS,qCAAqC,CAAC,cAAuC;IAIpF,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QAC9E,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;QACpF,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QACrE;YACE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAA0C,SAAS;IAEnD,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IAEzF,OAAO;;;;;;;;;mBASU,YAAY;;;;;;;;;;;MAWzB,QAAQ;GACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkC3C,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;;IAM1C,oBAAoB;CACvB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDxC,cAAc;CACjB,CAAC"}
+{"version":3,"file":"portfolio.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAOpG;;GAEG;AACH,SAAS,qCAAqC,CAAC,cAAuC;IAIpF,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QAC9E,KAAK,SAAS;YACZ,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;QACpF,KAAK,MAAM;YACT,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;QACrE;YACE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAA0C,SAAS;IAEnD,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,qCAAqC,CAAC,cAAc,CAAC,CAAC;IAEzF,OAAO;;;;;;;;;mBASU,YAAY;;;;;;;;;;;MAWzB,QAAQ;GACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkC3C,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;CAI7C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDxC,cAAc;CACjB,CAAC"}

package/dist/graphql/queries/risk.queries.d.ts

@@ -33,5 +33,5 @@
  * );
  * ```
  */
-export declare const RISK_ANALYSIS_QUERY = "\n  query RiskAnalysis(\n    $vaultAddress: Address!,\n    $chainId: Int!,\n    $curatorId: String!,\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!\n  ) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n    }\n\n    # Get all vaults for concentration risk calculation\n    allVaults: vaults(where: { chainId_eq: $chainId, isVisible_eq: true }) {\n      items {\n        state {\n          totalAssetsUsd\n        }\n      }\n    }\n\n    # Get curator's other vaults for reputation analysis\n    curatorVaults: vaults(where: { chainId_eq: $chainId, curatorIds_contains: $curatorId }) {\n      items {\n        address\n        state {\n          totalAssetsUsd\n        }\n      }\n    }\n\n    # Get price history for volatility analysis\n    priceHistory: transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: 100\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n          }\n        }\n      }\n    }\n\n    # Get composition data for protocol diversification risk\n    composition: vaultComposition(vaultAddress: $vaultAddress) {\n      ...CompositionFragment\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n  \n  fragment CompositionFragment on CompositionData {\n    compositions {\n      protocol\n      valueInUsd\n      repartition\n      details {\n        protocol\n        valueInUsd\n        repartition\n      }\n    }\n    tokenCompositions {\n      symbol\n      name\n      contract\n      chainKey\n      valueInUsd\n      repartition\n      details {\n        symbol\n        name\n        contract\n        chainKey\n        valueInUsd\n        repartition\n      }\n    }\n  }\n\n";
+export declare const RISK_ANALYSIS_QUERY = "\n  query RiskAnalysis(\n    $vaultAddress: Address!,\n    $chainId: Int!,\n    $curatorId: String!,\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!\n  ) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n    }\n\n    # Get all vaults for concentration risk calculation\n    allVaults: vaults(where: { chainId_eq: $chainId, isVisible_eq: true }) {\n      items {\n        state {\n          totalAssetsUsd\n        }\n      }\n    }\n\n    # Get curator's other vaults for reputation analysis\n    curatorVaults: vaults(where: { chainId_eq: $chainId, curatorIds_contains: $curatorId }) {\n      items {\n        address\n        state {\n          totalAssetsUsd\n        }\n      }\n    }\n\n    # Get price history for volatility analysis\n    priceHistory: transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: 100\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n          }\n        }\n      }\n    }\n\n    # Get composition data for cross-chain diversification risk\n    # Note: Backend API changed - uses walletAddress and returns JSONObject with chains\n    composition: vaultComposition(walletAddress: $vaultAddress)\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      protocolFee\n      isWhitelistActivated\n      whitelist\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
 //# sourceMappingURL=risk.queries.d.ts.map

package/dist/graphql/queries/risk.queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"risk.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/risk.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,mBAAmB,8hJA0D/B,CAAC"}
+{"version":3,"file":"risk.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/risk.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,mBAAmB,2mIAwD/B,CAAC"}

package/dist/graphql/queries/risk.queries.js

@@ -4,7 +4,7 @@
  * GraphQL queries for vault risk analysis.
  * Includes multi-factor risk scoring with vault, protocol, and market data.
  */
-import { VAULT_FRAGMENT, COMPOSITION_FRAGMENT } from '../fragments/index.js';
+import { VAULT_FRAGMENT } from '../fragments/index.js';
 /**
  * GraphQL query for vault risk analysis data
  *
@@ -85,12 +85,10 @@ export const RISK_ANALYSIS_QUERY = `
       }
     }
 
-    # Get composition data for protocol diversification risk
-    composition: vaultComposition(vaultAddress: $vaultAddress) {
-      ...CompositionFragment
-    }
+    # Get composition data for cross-chain diversification risk
+    # Note: Backend API changed - uses walletAddress and returns JSONObject with chains
+    composition: vaultComposition(walletAddress: $vaultAddress)
   }
   ${VAULT_FRAGMENT}
-  ${COMPOSITION_FRAGMENT}
 `;
 //# sourceMappingURL=risk.queries.js.map

package/dist/graphql/queries/risk.queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"risk.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/risk.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwD/B,cAAc;IACd,oBAAoB;CACvB,CAAC"}
+{"version":3,"file":"risk.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/risk.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuD/B,cAAc;CACjB,CAAC"}

package/dist/server.js

@@ -34,7 +34,7 @@ import { getPortfolioOptimizationPrompt } from './prompts/portfolio-optimization
 export function createServer() {
     const server = new McpServer({
         name: 'lagoon-mcp',
-        version: '0.2.14',
+        version: '0.2.16',
     });
     // ==========================================
     // Dependency Injection Container

package/dist/services/analytics/risk.service.d.ts

@@ -5,10 +5,11 @@
  * Demonstrates service layer pattern for complex multi-step operations.
  */
 import { BaseService } from '../base.service.js';
-import { VaultData } from '../../graphql/fragments/index.js';
+import { VaultData, VaultCompositionFullResponse } from '../../graphql/fragments/index.js';
 import { RiskScoreBreakdown } from '../../utils/risk-scoring.js';
 /**
  * Risk analysis input data extracted from GraphQL
+ * Uses assetByProtocols from Octav API for protocol-based diversification analysis
  */
 export interface RiskAnalysisData {
     vault: VaultData;
@@ -37,18 +38,7 @@ export interface RiskAnalysisData {
             };
         }>;
     };
-    composition: {
-        compositions: Array<{
-            protocol: string;
-            repartition: number;
-            valueInUsd: number;
-        }>;
-        tokenCompositions: Array<{
-            symbol: string;
-            repartition: number;
-            valueInUsd: number;
-        }>;
-    } | null;
+    composition: VaultCompositionFullResponse | null;
 }
 /**
  * Comparative risk context for benchmarking

package/dist/services/analytics/risk.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"risk.service.d.ts","sourceRoot":"","sources":["../../../src/services/analytics/risk.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAe,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACnE,aAAa,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACxF,YAAY,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC;gBACpB,cAAc,EAAE,MAAM,CAAC;gBACvB,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;IACF,WAAW,EAAE;QACX,YAAY,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnF,iBAAiB,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvF,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB5F;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB;IA8HzD;;;;;;OAMG;IACH,2BAA2B,CACzB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAC3C,sBAAsB;IAuEzB;;;;;;;OAOG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,kBAAkB,GAAE,OAAc,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IA0B7C;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,0BAA0B,EACrC,cAAc,GAAE,OAAO,GAAG,SAAS,GAAG,UAAsB,GAC3D,MAAM;CAiNV"}
+{"version":3,"file":"risk.service.d.ts","sourceRoot":"","sources":["../../../src/services/analytics/risk.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,SAAS,EACT,4BAA4B,EAE7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAe,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACnE,aAAa,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACxF,YAAY,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC;gBACpB,cAAc,EAAE,MAAM,CAAC;gBACvB,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;IAEF,WAAW,EAAE,4BAA4B,GAAG,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB5F;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB;IAuKzD;;;;;;OAMG;IACH,2BAA2B,CACzB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAC3C,sBAAsB;IAuEzB;;;;;;;OAOG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,kBAAkB,GAAE,OAAc,GACjC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC;IA0B7C;;OAEG;IACH,mBAAmB,CACjB,SAAS,EAAE,0BAA0B,EACrC,cAAc,GAAE,OAAO,GAAG,SAAS,GAAG,UAAsB,GAC3D,MAAM;CAiNV"}

package/dist/services/analytics/risk.service.js

@@ -105,15 +105,45 @@ export class RiskService extends BaseService {
             maxCapacity,
         };
         // Extract composition data for protocol diversification risk
-        const compositions = data.composition?.compositions;
-        const topProtocol = compositions?.[0];
-        const topProtocolPercent = topProtocol?.repartition ?? null;
-        const compositionData = compositions
-            ? {
-                compositions: compositions.map((c) => ({ repartition: c.repartition })),
+        // Uses assetByProtocols from VaultCompositionFullResponse for DeFi protocol analysis
+        // "wallet" protocol (idle assets) is excluded from diversification calculation
+        let compositionData;
+        if (data.composition &&
+            data.composition.assetByProtocols &&
+            Object.keys(data.composition.assetByProtocols).length > 0) {
+            // Filter active protocols (value > 0) and transform to risk format
+            const allProtocols = Object.entries(data.composition.assetByProtocols)
+                .filter(([, protocol]) => {
+                const value = parseFloat(protocol.value);
+                return !isNaN(value) && value > 0;
+            })
+                .map(([key, protocol]) => ({
+                key,
+                value: parseFloat(protocol.value),
+                repartition: 0, // Will calculate after total
+            }));
+            // Calculate total value (including wallet)
+            const totalValue = allProtocols.reduce((sum, p) => sum + p.value, 0);
+            // Calculate repartition (percentage) for each protocol
+            allProtocols.forEach((p) => {
+                p.repartition = totalValue > 0 ? (p.value / totalValue) * 100 : 0;
+            });
+            // Exclude wallet (idle assets) from diversification analysis
+            // Wallet represents undeployed capital, not DeFi protocol concentration
+            const defiProtocols = allProtocols.filter((p) => p.key !== 'wallet');
+            // Recalculate percentages for DeFi-only (for HHI calculation)
+            const defiTotalValue = defiProtocols.reduce((sum, p) => sum + p.value, 0);
+            defiProtocols.forEach((p) => {
+                p.repartition = defiTotalValue > 0 ? (p.value / defiTotalValue) * 100 : 0;
+            });
+            // Sort by value descending to get top protocol
+            defiProtocols.sort((a, b) => b.value - a.value);
+            const topProtocolPercent = defiProtocols[0]?.repartition ?? null;
+            compositionData = {
+                compositions: defiProtocols.map((p) => ({ repartition: p.repartition })),
                 topProtocolPercent,
-            }
-            : undefined;
+            };
+        }
         // Perform risk analysis using utility function
         return analyzeRisk({
             tvl: vaultTVL,