@lagoon-protocol/lagoon-mcp 0.2.13 → 0.2.15

package/dist/cache/index.d.ts

@@ -44,6 +44,7 @@ export declare const cacheTTL: {
     readonly riskAnalysis: 900;
     readonly yieldPrediction: 3600;
     readonly portfolioOptimization: 300;
+    readonly composition: 900;
 };
 /**
  * Search filters type for cache key generation
@@ -73,6 +74,7 @@ export declare const cacheKeys: {
     schema: () => string;
     compareVaults: (addresses: string[], chainIds: number[]) => string;
     priceHistory: (address: string, chainId: number, range: string) => string;
+    composition: (address: string) => string;
 };
 /**
  * Generate cache key based on cache tag and parameters

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC;;GAEG;AACH,eAAO,MAAM,KAAK,WAKhB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;CAYX,CAAC;AAEX;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS;yBACC,MAAM,WAAW,MAAM,KAAG,MAAM;6BAE5B,MAAM,KAAG,MAAM;4BAEhB,aAAa,KAAG,MAAM;gCAElB,MAAM,WAAW,MAAM,SAAS,MAAM,KAAG,MAAM;iGAWxE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;KACxB,KAAG,MAAM;kBAGE,MAAM;+BAES,MAAM,EAAE,YAAY,MAAM,EAAE,KAAG,MAAM;4BAMxC,MAAM,WAAW,MAAM,SAAS,MAAM,KAAG,MAAM;CAExE,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAa7F;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAAC,KAAK,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC;;GAEG;AACH,eAAO,MAAM,KAAK,WAKhB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;CAaX,CAAC;AAEX;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS;yBACC,MAAM,WAAW,MAAM,KAAG,MAAM;6BAE5B,MAAM,KAAG,MAAM;4BAEhB,aAAa,KAAG,MAAM;gCAElB,MAAM,WAAW,MAAM,SAAS,MAAM,KAAG,MAAM;iGAWxE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;KACxB,KAAG,MAAM;kBAGE,MAAM;+BAES,MAAM,EAAE,YAAY,MAAM,EAAE,KAAG,MAAM;4BAMxC,MAAM,WAAW,MAAM,SAAS,MAAM,KAAG,MAAM;2BAGhD,MAAM,KAAG,MAAM;CACvC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAa7F;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAAC,KAAK,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/cache/index.js

@@ -50,6 +50,7 @@ export const cacheTTL = {
     riskAnalysis: 900, // 15 minutes - multi-factor calculation, moderate cost
     yieldPrediction: 3600, // 60 minutes - ML-based forecast, expensive computation
     portfolioOptimization: 300, // 5 minutes - user-specific, interactive use case
+    composition: 900, // 15 minutes - protocol composition from Octav API (backend caches 6h)
 };
 /**
  * Cache key generators
@@ -69,6 +70,7 @@ export const cacheKeys = {
         return `compare:${sortedAddresses}:${sortedChainIds}`;
     },
     priceHistory: (address, chainId, range) => `price_history:${address}:${chainId}:${range}`,
+    composition: (address) => `composition:${address.toLowerCase()}`,
 };
 /**
  * Generate cache key based on cache tag and parameters

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;IAC3B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;IACrC,SAAS,EAAE,KAAK,EAAE,2BAA2B;IAC7C,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;CAC9B,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,GAAG,EAAE,sDAAsD;IACtE,aAAa,EAAE,GAAG,EAAE,iDAAiD;IACrE,aAAa,EAAE,GAAG,EAAE,qDAAqD;IACzE,WAAW,EAAE,IAAI,EAAE,qDAAqD;IACxE,YAAY,EAAE,GAAG,EAAE,0CAA0C;IAC7D,MAAM,EAAE,KAAK,EAAE,+CAA+C;IAC9D,UAAU,EAAE,GAAG,EAAE,+CAA+C;IAChE,YAAY,EAAE,IAAI,EAAE,sDAAsD;IAC1E,YAAY,EAAE,GAAG,EAAE,uDAAuD;IAC1E,eAAe,EAAE,IAAI,EAAE,wDAAwD;IAC/E,qBAAqB,EAAE,GAAG,EAAE,kDAAkD;CACtE,CAAC;AASX;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,OAAe,EAAE,OAAe,EAAU,EAAE,CAAC,SAAS,OAAO,IAAI,OAAO,EAAE;IAEtF,aAAa,EAAE,CAAC,OAAe,EAAU,EAAE,CAAC,aAAa,OAAO,EAAE;IAElE,YAAY,EAAE,CAAC,OAAsB,EAAU,EAAE,CAAC,UAAU,OAAO,CAAC,UAAU,EAAE;IAEhF,gBAAgB,EAAE,CAAC,OAAe,EAAE,OAAe,EAAE,KAAa,EAAU,EAAE,CAC5E,QAAQ,OAAO,IAAI,OAAO,IAAI,KAAK,EAAE;IAEvC,YAAY,EAAE,CAAC,EACb,YAAY,EACZ,OAAO,EACP,UAAU,EACV,KAAK,EACL,IAAI,EACJ,OAAO,EACP,cAAc,GASf,EAAU,EAAE,CACX,gBAAgB,YAAY,IAAI,OAAO,IAAI,UAAU,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,cAAc,EAAE;IAEvG,MAAM,EAAE,GAAW,EAAE,CAAC,eAAe;IAErC,aAAa,EAAE,CAAC,SAAmB,EAAE,QAAkB,EAAU,EAAE;QACjE,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,WAAW,eAAe,IAAI,cAAc,EAAE,CAAC;IACxD,CAAC;IAED,YAAY,EAAE,CAAC,OAAe,EAAE,OAAe,EAAE,KAAa,EAAU,EAAE,CACxE,iBAAiB,OAAO,IAAI,OAAO,IAAI,KAAK,EAAE;CACjD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAuC;IACnF,0DAA0D;IAC1D,IAAI,GAAG,KAAK,OAAO,IAAI,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,wCAAwC;IACxC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;SACxC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,YAAY,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,QAAQ,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,82 @@
+/**
+ * Composition Fragment
+ *
+ * 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>;
+/**
+ * @deprecated Use ChainComposition instead - backend API changed
+ * Protocol composition within a vault (legacy structure)
+ */
+export interface ProtocolComposition {
+    protocol: string;
+    valueInUsd: number;
+    repartition: number;
+    details?: ProtocolComposition[];
+}
+/**
+ * @deprecated Use ChainComposition instead - backend API changed
+ * Token/position composition within a vault (legacy structure)
+ */
+export interface TokenComposition {
+    symbol: string;
+    name: string;
+    contract: string;
+    chainKey: string;
+    valueInUsd: number;
+    repartition: number;
+    details?: TokenComposition[];
+}
+/**
+ * @deprecated Use RawVaultComposition instead - backend API changed
+ * Complete composition data for a vault (legacy structure)
+ */
+export interface CompositionData {
+    compositions: ProtocolComposition[];
+    tokenCompositions: TokenComposition[];
+}
+/**
+ * @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

@@ -0,0 +1 @@
+{"version":3,"file":"composition.fragment.d.ts","sourceRoot":"","sources":["../../../src/graphql/fragments/composition.fragment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAOnE;;;GAGG;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;;;GAGG;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;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,0eA6BhC,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Composition Fragment
+ *
+ * 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.
+ */
+/**
+ * @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 {
+    compositions {
+      protocol
+      valueInUsd
+      repartition
+      details {
+        protocol
+        valueInUsd
+        repartition
+      }
+    }
+    tokenCompositions {
+      symbol
+      name
+      contract
+      chainKey
+      valueInUsd
+      repartition
+      details {
+        symbol
+        name
+        contract
+        chainKey
+        valueInUsd
+        repartition
+      }
+    }
+  }
+`;
+//# sourceMappingURL=composition.fragment.js.map

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

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

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

@@ -12,4 +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 { 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"}
+{"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,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,4 +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 - new 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"}
+{"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,+CAA+C;AAC/C,OAAO;AAGL,8DAA8D;AAC9D,oBAAoB,GAIrB,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * Composition Queries
+ *
+ * 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 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: RawVaultComposition | null }>(
+ *   GET_VAULT_COMPOSITION_QUERY,
+ *   { walletAddress: '0x...' }
+ * );
+ * ```
+ */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,37 @@
+/**
+ * Composition Queries
+ *
+ * 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 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: RawVaultComposition | null }>(
+ *   GET_VAULT_COMPOSITION_QUERY,
+ *   { walletAddress: '0x...' }
+ * );
+ * ```
+ */
+export const GET_VAULT_COMPOSITION_QUERY = `
+  query GetVaultComposition($walletAddress: Address!) {
+    vaultComposition(walletAddress: $walletAddress)
+  }
+`;
+//# sourceMappingURL=composition.queries.js.map

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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -12,4 +12,5 @@ export { RISK_ANALYSIS_QUERY } from './risk.queries.js';
 export { YIELD_PREDICTION_QUERY, createYieldPredictionQuery, type PredictionResponseFormat, } from './prediction.queries.js';
 export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QUERY, EXPORT_PERFORMANCE_QUERY, } from './export.queries.js';
 export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, type SearchVaultsResponseFormat, } from './search.queries.js';
+export { GET_VAULT_COMPOSITION_QUERY } from './composition.queries.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/graphql/queries/index.js

@@ -20,4 +20,6 @@ export { YIELD_PREDICTION_QUERY, createYieldPredictionQuery, } from './predictio
 export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QUERY, EXPORT_PERFORMANCE_QUERY, } from './export.queries.js';
 // Search Queries
 export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, } from './search.queries.js';
+// Composition Queries
+export { GET_VAULT_COMPOSITION_QUERY } from './composition.queries.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEnG,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAE3B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEnG,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAE3B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC;AAE7B,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -65,6 +65,28 @@ export declare const GET_USER_PORTFOLIO_QUERY: string;
  * ```
  */
 export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOptimization($vaultAddress: Address!, $chainId: Int!) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n    }\n\n    # Get price history for volatility calculation\n    priceHistory: transactions(\n      where: {\n        vault_in: [$vaultAddress],\n        type_in: [TotalAssetsUpdated]\n      },\n      orderBy: timestamp,\n      orderDirection: asc,\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n            vault {\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\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";
+/**
+ * GraphQL query for single vault composition data
+ *
+ * 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<{ vaultComposition: RawVaultComposition | null }>(
+ *   SINGLE_VAULT_COMPOSITION_QUERY,
+ *   { walletAddress: '0x...' }
+ * );
+ * ```
+ */
+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;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;;;;;;;;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

@@ -136,6 +136,32 @@ export const SINGLE_VAULT_OPTIMIZATION_QUERY = `
   }
   ${VAULT_FRAGMENT}
 `;
+/**
+ * GraphQL query for single vault composition data
+ *
+ * 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<{ vaultComposition: RawVaultComposition | null }>(
+ *   SINGLE_VAULT_COMPOSITION_QUERY,
+ *   { walletAddress: '0x...' }
+ * );
+ * ```
+ */
+export const SINGLE_VAULT_COMPOSITION_QUERY = `
+  query SingleVaultComposition($walletAddress: Address!) {
+    vaultComposition(walletAddress: $walletAddress)
+  }
+`;
 /**
  * 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,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;;;;;;;;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  \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";
+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,84HAoD/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

@@ -84,6 +84,10 @@ export const RISK_ANALYSIS_QUERY = `
         }
       }
     }
+
+    # 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}
 `;

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,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmD/B,cAAc;CACjB,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/prompts/financial-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"financial-analysis.d.ts","sourceRoot":"","sources":["../../src/prompts/financial-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,0BAA0B,IAAI,MAAM,CAudnD"}
+{"version":3,"file":"financial-analysis.d.ts","sourceRoot":"","sources":["../../src/prompts/financial-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,0BAA0B,IAAI,MAAM,CAuiBnD"}

package/dist/prompts/financial-analysis.js

@@ -23,13 +23,14 @@ You are analyzing DeFi vault data from the Lagoon protocol. Use these patterns a
 Complete documentation with parameters, examples, and workflows: /docs/tools/README.md
 
 ### Core Analysis Tools
-- **Risk Assessment**: \`analyze_risk\` → /docs/tools/analyze-risk.md (7-factor scoring)
+- **Risk Assessment**: \`analyze_risk\` → /docs/tools/analyze-risk.md (14-factor scoring with composition)
+- **Vault Composition**: \`get_vault_composition\` → /docs/tools/get-vault-composition.md (Protocol breakdown with HHI)
 - **Vault Simulation**: \`simulate_vault\` → /docs/tools/simulate-vault.md (Protocol-accurate modeling)
 - **Yield Forecasting**: \`predict_yield\` → /docs/tools/predict-yield.md (ML-based predictions)
-- **Vault Comparison**: \`compare_vaults\` → /docs/tools/compare-vaults.md (Side-by-side rankings)
+- **Vault Comparison**: \`compare_vaults\` → /docs/tools/compare-vaults.md (Side-by-side rankings with composition)
 
 ### Portfolio Management
-- **User Portfolio**: \`user_portfolio\` → /docs/tools/user-portfolio.md (Multi-chain aggregation)
+- **User Portfolio**: \`user_portfolio\` → /docs/tools/user-portfolio.md (Multi-chain aggregation with compositionSummary)
 
 ### Discovery & Historical Data
 - **Search Vaults**: \`search_vaults\` → /docs/tools/search-vaults.md (20+ filters)
@@ -72,7 +73,14 @@ When analyzing a user's portfolio:
    - Chain diversification: Multi-chain = better risk profile
    - Curator analysis: Review historical performance and track record
 
-4. **Recommendations**
+4. **Protocol Composition Analysis**
+   - Use \`compositionSummary\` from \`user_portfolio\` for portfolio-wide protocol exposure
+   - Calculate portfolio HHI: <0.15 = High diversification, 0.15-0.25 = Medium, >0.25 = Low
+   - Check for accidental concentration (same protocol in 3+ vaults)
+   - Flag if single protocol >40% of total portfolio value
+   - Identify hidden correlations across vaults
+
+5. **Recommendations**
    - Suggest rebalancing if concentration >30%
    - Highlight underperforming vaults for review
    - Identify high-performing vaults for increased allocation
@@ -89,6 +97,12 @@ Concentration Risk: MEDIUM
 - USDC Vault A: 25% of portfolio
 - WETH Vault B: 35% of portfolio (⚠️ HIGH - consider rebalancing)
 
+Protocol Composition:
+- Portfolio HHI: 0.18 (Medium diversification)
+- Top Protocol: Aave (42% exposure across 3 vaults)
+- ⚠️ Accidental Concentration: Aave appears in 3 vaults
+  - Consider: Single protocol failure affects 42% of portfolio
+
 Top Performers:
 1. WETH Vault B: +15.3% (30d) - Strong Uniswap V3 strategy
 2. USDC Vault A: +9.1% (30d) - Consistent Aave lending returns
@@ -97,6 +111,8 @@ Recommendations:
 - Consider reducing WETH Vault B to <30% allocation
 - Diversify into additional USDC or DAI vaults
 - Monitor WETH Vault B capacity (currently 78% utilized)
+- Reduce Aave exposure by choosing vaults with different underlying protocols
+- Consider Compound or Morpho vaults to improve protocol diversification
 \`\`\`
 
 ---
@@ -234,7 +250,70 @@ Recommendation: Start with option 1 or 2 based on risk tolerance
 
 ---
 
-### 4. Vault Simulation Pattern
+### 4. Protocol Composition Analysis Pattern
+
+When analyzing vault or portfolio composition:
+
+**Tool Integration:**
+- Use \`get_vault_composition\` for individual vault protocol breakdown
+- Use \`user_portfolio\` with \`compositionSummary\` for portfolio-wide analysis
+- Use \`compare_vaults\` for composition comparison between vaults
+
+**Analysis Steps:**
+
+1. **Vault-Level Composition**
+   - Fetch composition data showing underlying protocol allocations
+   - Calculate vault HHI (Herfindahl-Hirschman Index) for concentration
+   - Identify top protocols and their percentage allocation
+   - Assess diversification level: High (<0.15), Medium (0.15-0.25), Low (>0.25)
+
+2. **Portfolio-Level Aggregation**
+   - Aggregate protocol exposure across all user vaults
+   - Weight protocol exposure by position size (USD value)
+   - Calculate portfolio-wide HHI for true diversification
+   - Detect accidental concentration (same protocol in 3+ vaults)
+
+3. **Risk Implications**
+   - Single protocol >40% = HIGH concentration risk
+   - Same protocol in 3+ vaults = Hidden correlation risk
+   - Portfolio HHI >0.25 = Low diversification, vulnerable to protocol failure
+   - Consider smart contract risk multiplied across protocol exposure
+
+4. **Diversification Recommendations**
+   - Suggest vaults with complementary compositions
+   - Identify protocol overlaps to reduce
+   - Recommend alternative protocols for better distribution
+
+**Example Output:**
+\`\`\`
+Vault Composition Analysis: USDC Strategy A
+
+Protocol Breakdown:
+| Protocol | Allocation | Value |
+|----------|------------|-------|
+| Aave V3 | 45% | $2.3M |
+| Compound V3 | 30% | $1.5M |
+| Morpho | 25% | $1.3M |
+
+Diversification Metrics:
+- Vault HHI: 0.34 (Moderate concentration)
+- Diversification Level: Medium
+- Top Protocol: Aave V3 (45%)
+- Protocol Count: 3
+
+Assessment:
+- ✅ Multiple protocols provide some protection
+- ⚠️ Aave exposure at 45% is moderately high
+- Consider: If Aave experiences issues, 45% of vault could be affected
+
+Portfolio Impact (if user holds this vault):
+- This vault would add 45% weighted Aave exposure
+- Check existing Aave exposure in other vaults before investing
+\`\`\`
+
+---
+
+### 5. Vault Simulation Pattern
 
 When modeling deposit/withdrawal scenarios:
 
@@ -420,9 +499,10 @@ Use this structure for comprehensive analysis reports:
 
 ### Tool Selection
 - **Single vault (1-5)**: Use \`get_vault_data\` with caching
+- **Vault composition**: Use \`get_vault_composition\` for protocol breakdown and HHI
 - **Discovery (20+)**: Use \`search_vaults\` with filters
-- **Comparison (2-10)**: Use \`compare_vaults\` for rankings
-- **Portfolio**: Use \`user_portfolio\` for multi-chain aggregation
+- **Comparison (2-10)**: Use \`compare_vaults\` for rankings with composition metrics
+- **Portfolio**: Use \`user_portfolio\` for multi-chain aggregation with \`compositionSummary\`
 - **Custom queries**: Use \`query_graphql\` for power users
 
 📖 Tool selection guide: /docs/tools/README.md

package/dist/prompts/financial-analysis.js.map

@@ -1 +1 @@
-{"version":3,"file":"financial-analysis.js","sourceRoot":"","sources":["../../src/prompts/financial-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,0BAA0B;IACxC,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgcf,wBAAwB;;;;;;;;;;;;;;;CAezB,CAAC;AACF,CAAC"}
+{"version":3,"file":"financial-analysis.js","sourceRoot":"","sources":["../../src/prompts/financial-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,0BAA0B;IACxC,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAghBf,wBAAwB;;;;;;;;;;;;;;;CAezB,CAAC;AACF,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.13',
+        version: '0.2.15',
     });
     // ==========================================
     // Dependency Injection Container