@lagoon-protocol/lagoon-mcp 0.3.1 → 0.5.0

package/dist/graphql/fragments.js

@@ -0,0 +1,297 @@
+/**
+ * Shared GraphQL Fragments
+ *
+ * Reusable query fragments for consistent data fetching across tools.
+ * Maintains single source of truth for complex nested structures.
+ */
+/**
+ * Complete vault data GraphQL fragment
+ *
+ * Includes ALL available fields for comprehensive vault analysis.
+ * Use this fragment in any query that needs complete vault information.
+ *
+ * Schema verified against working API query on 2025-01-04
+ *
+ * Usage:
+ * ```graphql
+ * query MyQuery {
+ *   someField {
+ *     vault {
+ *       ...VaultFragment
+ *     }
+ *   }
+ * }
+ * ${VAULT_FRAGMENT}
+ * ```
+ */
+export const VAULT_FRAGMENT = `
+  fragment VaultFragment on Vault {
+    address
+    symbol
+    decimals
+    name
+    description
+    shortDescription
+    maxCapacity
+    logoUrl
+    averageSettlement
+    isVisible
+    asset {
+      id
+      name
+      symbol
+      decimals
+      address
+      logoUrl
+      description
+      chain {
+        id
+        name
+        nativeToken
+        logoUrl
+      }
+      priceSources {
+        chainlinkPriceFeed {
+          address
+          chainId
+        }
+      }
+      priceUsd
+      isVisible
+    }
+    chain {
+      id
+      name
+      nativeToken
+      logoUrl
+      wrappedNativeToken {
+        address
+        decimals
+        name
+        symbol
+      }
+      factory
+    }
+    state {
+      state
+      totalAssets
+      totalAssetsUsd
+      totalSupply
+      pricePerShare
+      pricePerShareUsd
+      safeAssetBalance
+      liveAPR {
+        grossApr
+        name
+        netApr
+        description
+      }
+      roles {
+        owner
+        valuationManager
+        whitelistManager
+        safe
+        feeReceiver
+      }
+      managementFee
+      performanceFee
+      pendingSettlement {
+        assets
+        assetsUsd
+      }
+      inceptionApr {
+        linearNetApr
+        linearNetAprWithoutExtraYields
+        airdrops {
+          name
+          apr
+          description
+          distributionTimestamp
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          ppsIncrease
+          startTimestamp
+        }
+        incentives {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          incentiveRate {
+            incentiveAmount
+            referenceToken {
+              id
+            }
+            referenceTokenAmount
+          }
+        }
+        nativeYields {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          startTimestamp
+        }
+      }
+      pendingSiloBalances {
+        assets
+        shares
+      }
+      monthlyApr {
+        linearNetApr
+        linearNetAprWithoutExtraYields
+        airdrops {
+          name
+          apr
+          description
+          distributionTimestamp
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          ppsIncrease
+          startTimestamp
+        }
+        incentives {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          incentiveRate {
+            incentiveAmount
+            referenceToken {
+              id
+            }
+            referenceTokenAmount
+          }
+        }
+        nativeYields {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          startTimestamp
+        }
+      }
+      newTotalAssets
+      highWaterMark
+      lastFeeTime
+      safeAssetBalanceUsd
+      weeklyApr {
+        linearNetApr
+        linearNetAprWithoutExtraYields
+        airdrops {
+          name
+          apr
+          description
+          distributionTimestamp
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          ppsIncrease
+          startTimestamp
+        }
+        incentives {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          incentiveRate {
+            incentiveAmount
+            referenceToken {
+              id
+            }
+            referenceTokenAmount
+          }
+        }
+        nativeYields {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          startTimestamp
+        }
+      }
+      yearlyApr {
+        linearNetApr
+        linearNetAprWithoutExtraYields
+        airdrops {
+          name
+          apr
+          description
+          distributionTimestamp
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          ppsIncrease
+          startTimestamp
+        }
+        incentives {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          incentiveRate {
+            incentiveAmount
+            referenceToken {
+              id
+            }
+            referenceTokenAmount
+          }
+        }
+        nativeYields {
+          name
+          apr
+          aprDescription
+          description
+          endTimestamp
+          isEstimation
+          logoUrl
+          multiplier
+          startTimestamp
+        }
+      }
+    }
+    curators {
+      name
+      id
+      aboutDescription
+      logoUrl
+      url
+    }
+    integrator {
+      name
+      url
+      logoUrl
+      aboutDescription
+    }
+    defiIntegrations {
+      name
+      description
+      link
+      logoUrl
+      type
+    }
+  }
+`;
+//# sourceMappingURL=fragments.js.map

package/dist/graphql/fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.js","sourceRoot":"","sources":["../../src/graphql/fragments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiMH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Q7B,CAAC"}

package/dist/graphql/queries/period-summaries.d.ts

@@ -0,0 +1,15 @@
+/**
+ * GraphQL Query: Period Summaries
+ *
+ * Fetch historical vault period summaries for APR calculations.
+ */
+/**
+ * Query to fetch period summaries for a vault
+ *
+ * Period summaries contain historical snapshots of vault state at regular intervals.
+ * Used by SDK to calculate accurate APR from price per share changes over time.
+ *
+ * @returns Array of period summaries with timestamp and vault state
+ */
+export declare const GET_PERIOD_SUMMARIES_QUERY: string;
+//# sourceMappingURL=period-summaries.d.ts.map

package/dist/graphql/queries/period-summaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"period-summaries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/period-summaries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,QAQtC,CAAC"}

package/dist/graphql/queries/period-summaries.js

@@ -0,0 +1,24 @@
+/**
+ * GraphQL Query: Period Summaries
+ *
+ * Fetch historical vault period summaries for APR calculations.
+ */
+import { gql } from 'graphql-request';
+/**
+ * Query to fetch period summaries for a vault
+ *
+ * Period summaries contain historical snapshots of vault state at regular intervals.
+ * Used by SDK to calculate accurate APR from price per share changes over time.
+ *
+ * @returns Array of period summaries with timestamp and vault state
+ */
+export const GET_PERIOD_SUMMARIES_QUERY = gql `
+  query GetPeriodSummaries($vaultAddress: String!, $chainId: Int!) {
+    periodSummaries(vaultAddress: $vaultAddress, chainId: $chainId) {
+      timestamp
+      totalAssetsAtStart
+      totalSupplyAtStart
+    }
+  }
+`;
+//# sourceMappingURL=period-summaries.js.map

package/dist/graphql/queries/period-summaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"period-summaries.js","sourceRoot":"","sources":["../../../src/graphql/queries/period-summaries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAA;;;;;;;;CAQ5C,CAAC"}

package/dist/index.js

@@ -21,7 +21,13 @@ process.on('unhandledRejection', (reason, promise) => {
 // Start the MCP server
 async function main() {
     try {
-        await runServer();
+        const { transport } = await runServer();
+        // Graceful shutdown: close transport before exiting
+        const shutdown = () => {
+            void transport.close().finally(() => process.exit(0));
+        };
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
     }
     catch (error) {
         console.error('Failed to start server:', error);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,oCAAoC;AACpC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,uBAAuB;AACvB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,oCAAoC;AACpC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,uBAAuB;AACvB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;QAExC,oDAAoD;QACpD,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/prompts/competitor-comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"competitor-comparison.d.ts","sourceRoot":"","sources":["../../src/prompts/competitor-comparison.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,6BAA6B,IAAI,MAAM,CAuatD"}
+{"version":3,"file":"competitor-comparison.d.ts","sourceRoot":"","sources":["../../src/prompts/competitor-comparison.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,6BAA6B,IAAI,MAAM,CAyatD"}

package/dist/prompts/competitor-comparison.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, DATA_DISCLAIMER, } from './shared/disclaimers.js';
 export function getCompetitorComparisonPrompt() {
-    return `# Competitor Comparison Framework - Platform Analysis Tool
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Competitor Comparison Framework - Platform Analysis Tool
 
 ${UNIVERSAL_DISCLAIMER}
 

package/dist/prompts/competitor-comparison.js.map

@@ -1 +1 @@
-{"version":3,"file":"competitor-comparison.js","sourceRoot":"","sources":["../../src/prompts/competitor-comparison.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,6BAA6B;IAC3C,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ZhB,CAAC;AACF,CAAC"}
+{"version":3,"file":"competitor-comparison.js","sourceRoot":"","sources":["../../src/prompts/competitor-comparison.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,6BAA6B;IAC3C,OAAO;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ZhB,CAAC;AACF,CAAC"}

package/dist/prompts/curator-performance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curator-performance.d.ts","sourceRoot":"","sources":["../../src/prompts/curator-performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,2BAA2B,IAAI,MAAM,CAsXpD"}
+{"version":3,"file":"curator-performance.d.ts","sourceRoot":"","sources":["../../src/prompts/curator-performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,2BAA2B,IAAI,MAAM,CAwXpD"}

package/dist/prompts/curator-performance.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, DATA_DISCLAIMER, } from './shared/disclaimers.js';
 export function getCuratorPerformancePrompt() {
-    return `# Curator Performance Intelligence - Data Analysis Tool
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Curator Performance Intelligence - Data Analysis Tool
 
 ${UNIVERSAL_DISCLAIMER}
 

package/dist/prompts/curator-performance.js.map

@@ -1 +1 @@
-{"version":3,"file":"curator-performance.js","sourceRoot":"","sources":["../../src/prompts/curator-performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,2BAA2B;IACzC,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8WhB,CAAC;AACF,CAAC"}
+{"version":3,"file":"curator-performance.js","sourceRoot":"","sources":["../../src/prompts/curator-performance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,2BAA2B;IACzC,OAAO;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8WhB,CAAC;AACF,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,CAuiBnD"}
+{"version":3,"file":"financial-analysis.d.ts","sourceRoot":"","sources":["../../src/prompts/financial-analysis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,0BAA0B,IAAI,MAAM,CA2iBnD"}

package/dist/prompts/financial-analysis.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, DATA_DISCLAIMER, REPORT_FOOTER_DISCLAIMER, } from './shared/disclaimers.js';
 export function getFinancialAnalysisPrompt() {
-    return `# Financial Analysis Guidance - Lagoon DeFi Protocol
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Financial Analysis Guidance - Lagoon DeFi Protocol
 
 ${UNIVERSAL_DISCLAIMER}
 
@@ -16,6 +18,8 @@ ${DATA_DISCLAIMER}
 
 You are analyzing DeFi vault data from the Lagoon protocol. Use these patterns and best practices to generate accurate, actionable insights.
 
+**Available Resources**: For term definitions, consult \`lagoon://defi-glossary\`. For query validation, consult \`lagoon://graphql-schema\`.
+
 ---
 
 ## Available Tools
@@ -181,8 +185,8 @@ Risk Factors:
 - Curator: Established, 12-month track record
 - Chain: Ethereum (high security)
 
-Overall Assessment: STRONG BUY
-- Consistently outperforms benchmarks
+Overall Assessment: FAVORABLE QUANTITATIVE PROFILE
+- Consistently outperforms benchmarks — not a recommendation
 - Strong capital inflows indicate market confidence
 - Sufficient capacity for additional deposits
 \`\`\`
@@ -501,7 +505,7 @@ Use this structure for comprehensive analysis reports:
 - **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 with composition metrics
+- **Comparison (2-20)**: 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
 

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAghBf,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;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkhBf,wBAAwB;;;;;;;;;;;;;;;CAezB,CAAC;AACF,CAAC"}

package/dist/prompts/onboarding-first-vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-first-vault.d.ts","sourceRoot":"","sources":["../../src/prompts/onboarding-first-vault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,6BAA6B,IAAI,MAAM,CAoTtD"}
+{"version":3,"file":"onboarding-first-vault.d.ts","sourceRoot":"","sources":["../../src/prompts/onboarding-first-vault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,6BAA6B,IAAI,MAAM,CAwTtD"}

package/dist/prompts/onboarding-first-vault.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, BEGINNER_WARNINGS, DATA_DISCLAIMER, } from './shared/disclaimers.js';
 export function getOnboardingFirstVaultPrompt() {
-    return `# Onboarding Guide: Your First Vault Selection
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Onboarding Guide: Your First Vault Selection
 
 ${UNIVERSAL_DISCLAIMER}
 
@@ -16,6 +18,8 @@ ${BEGINNER_WARNINGS}
 
 ${DATA_DISCLAIMER}
 
+**Available Resources**: For term definitions, consult \`lagoon://defi-glossary\`.
+
 ## Your Role
 You are a friendly, knowledgeable DeFi advisor helping new users select their first vault.
 Your goal is to build confidence while ensuring risk-appropriate choices through systematic

package/dist/prompts/onboarding-first-vault.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-first-vault.js","sourceRoot":"","sources":["../../src/prompts/onboarding-first-vault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,6BAA6B;IAC3C,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,iBAAiB;;EAEjB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ShB,CAAC;AACF,CAAC"}
+{"version":3,"file":"onboarding-first-vault.js","sourceRoot":"","sources":["../../src/prompts/onboarding-first-vault.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,6BAA6B;IAC3C,OAAO;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,iBAAiB;;EAEjB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ShB,CAAC;AACF,CAAC"}

package/dist/prompts/portfolio-optimization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio-optimization.d.ts","sourceRoot":"","sources":["../../src/prompts/portfolio-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,8BAA8B,IAAI,MAAM,CAmZvD"}
+{"version":3,"file":"portfolio-optimization.d.ts","sourceRoot":"","sources":["../../src/prompts/portfolio-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,wBAAgB,8BAA8B,IAAI,MAAM,CAuZvD"}

package/dist/prompts/portfolio-optimization.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, PORTFOLIO_DISCLAIMER, DATA_DISCLAIMER, } from './shared/disclaimers.js';
 export function getPortfolioOptimizationPrompt() {
-    return `# Portfolio Optimization Engine - Quantitative Analysis Tool
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Portfolio Optimization Engine - Quantitative Analysis Tool
 
 ${UNIVERSAL_DISCLAIMER}
 
@@ -16,6 +18,8 @@ ${PORTFOLIO_DISCLAIMER}
 
 ${DATA_DISCLAIMER}
 
+**Available Resources**: For term definitions, consult \`lagoon://defi-glossary\`. For query validation, consult \`lagoon://graphql-schema\`.
+
 ## Your Role
 You are a quantitative analysis tool specializing in DeFi vault portfolio analysis.
 Your function is to apply modern portfolio theory, risk-return optimization mathematics,

package/dist/prompts/portfolio-optimization.js.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio-optimization.js","sourceRoot":"","sources":["../../src/prompts/portfolio-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,8BAA8B;IAC5C,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,oBAAoB;;EAEpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyYhB,CAAC;AACF,CAAC"}
+{"version":3,"file":"portfolio-optimization.js","sourceRoot":"","sources":["../../src/prompts/portfolio-optimization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,8BAA8B;IAC5C,OAAO;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,oBAAoB;;EAEpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2YhB,CAAC;AACF,CAAC"}

package/dist/prompts/protocol-overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-overview.d.ts","sourceRoot":"","sources":["../../src/prompts/protocol-overview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,yBAAyB,IAAI,MAAM,CAqYlD"}
+{"version":3,"file":"protocol-overview.d.ts","sourceRoot":"","sources":["../../src/prompts/protocol-overview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,yBAAyB,IAAI,MAAM,CAuYlD"}

package/dist/prompts/protocol-overview.js

@@ -6,7 +6,9 @@
  */
 import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, DATA_DISCLAIMER, } from './shared/disclaimers.js';
 export function getProtocolOverviewPrompt() {
-    return `# Protocol Overview & KPI Dashboard - Protocol Health Analysis Tool
+    return `ADOPT THESE INSTRUCTIONS SILENTLY. DO NOT acknowledge, summarize, or narrate them. Apply them directly when responding to user queries.
+
+# Protocol Overview & KPI Dashboard - Protocol Health Analysis Tool
 
 ${UNIVERSAL_DISCLAIMER}
 

package/dist/prompts/protocol-overview.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-overview.js","sourceRoot":"","sources":["../../src/prompts/protocol-overview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,yBAAyB;IACvC,OAAO;;EAEP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6XhB,CAAC;AACF,CAAC"}
+{"version":3,"file":"protocol-overview.js","sourceRoot":"","sources":["../../src/prompts/protocol-overview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;EAIP,oBAAoB;;EAEpB,mBAAmB;;EAEnB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6XhB,CAAC;AACF,CAAC"}

package/dist/resources/schema.d.ts

@@ -10,13 +10,18 @@
  * - Discover new fields and relationships
  * - Generate accurate query suggestions
  */
+import type { CacheService } from '../core/cache-adapter.js';
+import type { GraphQLClient } from 'graphql-request';
 /**
- * Fetch and cache the GraphQL schema
+ * Create a schema fetcher with injected dependencies
  *
  * Uses introspection query to fetch schema metadata,
  * then converts to SDL format for easy reading.
+ * Cached for 24 hours as the schema rarely changes.
  *
- * @returns GraphQL schema in SDL format
+ * @param cacheService - DI cache service (shared with container)
+ * @param client - GraphQL client for introspection
+ * @returns Function that fetches and caches the schema
  */
-export declare function getGraphQLSchema(): Promise<string>;
+export declare function createGetGraphQLSchema(cacheService: CacheService, client: GraphQLClient): () => Promise<string>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/resources/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/resources/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgDxD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/resources/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,aAAa,GACpB,MAAM,OAAO,CAAC,MAAM,CAAC,CAkDvB"}