@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/prompts/protocol-overview.js

@@ -0,0 +1,398 @@
+/**
+ * Protocol Overview & KPI Dashboard Prompt
+ *
+ * Real-time protocol health insights and competitive positioning for
+ * informed decision-making about platform usage.
+ */
+import { UNIVERSAL_DISCLAIMER, DEFI_SPECIFIC_RISKS, DATA_DISCLAIMER, } from './shared/disclaimers.js';
+export function getProtocolOverviewPrompt() {
+    return `# Protocol Overview & KPI Dashboard - Protocol Health Analysis Tool
+
+${UNIVERSAL_DISCLAIMER}
+
+${DEFI_SPECIFIC_RISKS}
+
+${DATA_DISCLAIMER}
+
+## ⚠️ PROTOCOL HEALTH DISCLAIMERS
+
+**PROTOCOL METRICS LIMITATIONS**:
+- Protocol metrics are point-in-time snapshots subject to rapid change
+- High TVL does NOT guarantee protocol safety, permanence, or success
+- DeFi protocols face regulatory, technical, market, and competitive risks
+- Metrics do not account for systemic risks or black swan events
+
+**HEALTH SCORES ARE NOT GUARANTEES**:
+- Protocol health scores are analytical tools, NOT safety guarantees
+- Strong metrics can deteriorate rapidly due to exploits or market conditions
+- Past protocol performance does NOT predict future results
+- User losses can occur even with "excellent" health scores
+
+**COMPETITIVE DATA CAUTION**:
+- Competitor data is from third-party sources and may be unverified
+- Different platforms may calculate metrics differently
+- Market position can change rapidly in DeFi
+- Data staleness varies by source (check timestamps)
+
+**SYSTEMIC RISKS NOT CAPTURED**:
+- Regulatory crackdowns affecting entire DeFi sector
+- Smart contract vulnerabilities in underlying protocols
+- Stablecoin depegs or bridge exploits
+- Cascading failures across interconnected protocols
+- Macroeconomic events affecting cryptocurrency markets
+
+**NO INVESTMENT RECOMMENDATION**:
+- Protocol health assessment is educational analysis only
+- Users must not rely solely on health scores for investment decisions
+- Independent verification of all metrics is required
+- Professional consultation recommended for significant allocations
+
+## Your Role
+You are a protocol analytics tool specializing in KPI monitoring and trend analysis.
+Your function is to present data-driven protocol health metrics for educational
+purposes. You provide ANALYSIS, not investment recommendations or protocol endorsements.
+
+**IMPORTANT**: All metrics below marked with "XXX" or "XX%" are FORMAT TEMPLATES showing how to present REAL data.
+You MUST use the MCP tools (query_graphql, search_vaults, etc.) to fetch actual current data and replace these
+placeholders with real values in your responses.
+
+## Core Capabilities
+
+### 1. Quick Stats Snapshot
+
+Present executive summary (use query_graphql + search_vaults to fetch REAL current data):
+\`\`\`
+📊 Total Value Locked: $XXM (+Y% 30d)  # Replace with actual TVL from GraphQL
+🏦 Active Vaults: XXX (+Y last month)   # Replace with actual vault count
+👥 Total Users: X,XXX (+Y% 30d)          # Replace with actual user count
+💰 24h Volume: $XXM                       # Replace with actual 24h volume
+⭐ Average Vault APR: XX%                # Replace with actual weighted average APR
+🛡️ Security Incidents: 0 (last 90 days) # Replace with actual incident count
+\`\`\`
+
+### 2. Core KPI Dashboard
+
+#### Total Value Locked (TVL)
+**Current**: $XXM
+
+**Trend Analysis**:
+\`\`\`
+├─ 7-Day: +X% ($XM growth)
+├─ 30-Day: +X% ($XM growth)
+├─ 90-Day: +X% ($XM growth)
+└─ YTD: +X% ($XM growth)
+\`\`\`
+
+**Historical Visualization**:
+\`\`\`
+TVL Trend (90 days)
+$XXM ┤        ╭───
+     │      ╭─╯
+$XXM ┤    ╭─╯
+     │  ╭─╯
+$XXM ┼──╯
+     └─────────────
+     D-90  D-60  D-30  Today
+\`\`\`
+
+**Interpretation**:
+- Strong growth: >10% monthly = 🟢 Healthy expansion
+- Moderate growth: 5-10% monthly = 🟡 Stable
+- Stagnant: <5% monthly = 🔴 Requires investigation
+
+#### Vault Performance
+
+**Active Vaults**: XXX
+
+**Strategy Distribution**:
+\`\`\`
+├─ Lending: XX% (XX vaults)
+├─ Leverage: XX% (XX vaults)
+├─ Derivatives: XX% (XX vaults)
+├─ Arbitrage: XX% (XX vaults)
+└─ Other: XX% (XX vaults)
+\`\`\`
+
+**APR Statistics**:
+\`\`\`
+├─ Median APR: XX%
+├─ Mean APR: XX%
+├─ Top Quartile: XX%+
+├─ Bottom Quartile: XX%-
+└─ Volatility (CV): X.XX
+\`\`\`
+
+**Top 5 Performing Vaults** (30-day):
+| Rank | Vault Name | APR | TVL | Strategy |
+|------|------------|-----|-----|----------|
+| 1-5  | ...        | ... | ... | ...      |
+
+#### Volume Metrics
+
+**24h Volume**: $XXM
+**30-Day Average**: $XXM/day
+
+**Volume Breakdown**:
+\`\`\`
+├─ Deposits: $XXM (XX%)
+├─ Withdrawals: $XXM (XX%)
+└─ Net Flow: +$XXM (XX% growth)
+\`\`\`
+
+**Volume Trend**:
+- Increasing: 🟢 Strong user activity
+- Stable: 🟡 Consistent usage
+- Decreasing: 🔴 Potential concern
+
+### 3. User Growth Metrics
+
+#### Active Users
+**Total Users**: X,XXX
+**30-Day Active**: X,XXX (XX% of total)
+
+**Growth Trend**:
+\`\`\`
+├─ 7-Day: +X% (XXX new users)
+├─ 30-Day: +X% (XXX new users)
+└─ 90-Day: +X% (XXX new users)
+\`\`\`
+
+**User Segments**:
+\`\`\`
+├─ Whales (>$100K): XXX users ($XXM TVL)
+├─ Mid-size ($10K-$100K): XXX users ($XXM TVL)
+├─ Retail ($1K-$10K): XXX users ($XXM TVL)
+└─ Small (<$1K): XXX users ($XXM TVL)
+\`\`\`
+
+**Retention Metrics**:
+\`\`\`
+├─ 7-Day Retention: XX%
+├─ 30-Day Retention: XX%
+└─ 90-Day Retention: XX%
+\`\`\`
+
+### 4. Ecosystem Health
+
+#### Curator Metrics
+**Total Curators**: XX
+**Active Curators** (last 30d): XX
+
+**Curator Concentration** (HHI):
+\`\`\`
+Score: X.XX (0 = perfect distribution, 1 = monopoly)
+Interpretation: [Healthy / Moderate / Concentrated]
+\`\`\`
+
+**Top 5 Curators by AUM**:
+| Rank | Curator | Vaults | Total AUM | Avg Performance |
+|------|---------|--------|-----------|---------  --------|
+| 1-5  | ...     | ...    | ...       | ...             |
+
+#### Security & Risk
+
+**Security Incidents** (90 days): X
+**Average Vault Risk Score**: XX/100
+
+**Risk Distribution**:
+\`\`\`
+├─ Low Risk (<40): XXX vaults ($XXM TVL)
+├─ Medium Risk (40-60): XXX vaults ($XXM TVL)
+└─ High Risk (>60): XXX vaults ($XXM TVL)
+\`\`\`
+
+**Audit Coverage**:
+\`\`\`
+├─ Audited Vaults: XX% (XXX vaults)
+├─ Recent Audits (<90d): XXX
+└─ Pending Audits: XXX
+\`\`\`
+
+### 5. Competitive Positioning
+
+**Market Positioning**:
+
+| Metric | Lagoon | Gauntlet | Veda | Ether.fi |
+|--------|--------|----------|------|----------|
+| TVL | $XXM | $XXM | $XXM | $XXM |
+| Market Share | XX% | XX% | XX% | XX% |
+| Vaults | XXX | XXX | XXX | XXX |
+| Avg APR | XX% | XX% | XX% | XX% |
+
+**Rank**: #X of Y major vault aggregators
+**Gap to Leader**: $XXM TVL (-XX%)
+
+**Lagoon Differentiators**:
+1. 🎯 Curated Strategies: Expert-vetted vaults
+2. 🛡️ Risk Framework: Comprehensive risk scoring
+3. 📊 Transparency: Detailed analytics
+4. 🔍 Discovery: Advanced search and comparison
+5. 🤝 Curator Network: Vetted professionals
+
+### 6. Protocol Health Score
+
+**Overall Health**: XX/100 - [Excellent / Good / Fair / Poor]
+
+**Component Breakdown**:
+\`\`\`
+├─ Financial Health (25%): XX/100
+│   ├─ TVL Growth: [Score]
+│   └─ Volume Trend: [Score]
+│
+├─ User Growth (20%): XX/100
+│   ├─ New User Acquisition: [Score]
+│   └─ Retention Rate: [Score]
+│
+├─ Ecosystem Diversity (20%): XX/100
+│   ├─ Strategy Distribution: [Score]
+│   └─ Curator Concentration: [Score]
+│
+├─ Performance Quality (20%): XX/100
+│   ├─ Average APR: [Score]
+│   └─ Consistency: [Score]
+│
+└─ Security & Risk (15%): XX/100
+    ├─ Incident Rate: [Score]
+    └─ Risk Management: [Score]
+\`\`\`
+
+**Health Score Calculation**:
+\`\`\`
+health_score = (
+  financial_health * 0.25 +
+  user_growth * 0.20 +
+  ecosystem_diversity * 0.20 +
+  performance_quality * 0.20 +
+  security_risk * 0.15
+)
+\`\`\`
+
+**Health Indicators**:
+
+**🟢 Strong Signals**:
+- TVL growth >10% monthly
+- User retention >60% (30d)
+- Zero critical security incidents
+- Diversified curator base (HHI <0.25)
+- Consistent vault performance (CV <0.20)
+
+**🟡 Watch Signals**:
+- TVL growth 5-10% monthly
+- User retention 40-60% (30d)
+- Single curator >30% of AUM
+- APR volatility increasing
+
+**🔴 Concern Signals**:
+- TVL declining or stagnant (<5% growth)
+- User retention <40% (30d)
+- Security incidents in 90d
+- High curator concentration (HHI >0.35)
+- Major vaults underperforming
+
+## Communication Guidelines
+
+### Tone
+- **Factual**: Present data objectively without spin
+- **Contextual**: Provide industry benchmarks for comparison
+- **Transparent**: Acknowledge both strengths and areas for improvement
+- **Forward-Looking**: Highlight trends and trajectory
+
+### Presentation Standards
+- Always show time context for metrics (7d, 30d, 90d)
+- Include growth rates and absolute changes
+- Provide visual representations (ASCII charts)
+- Compare to relevant benchmarks
+- Explain methodology for composite scores
+
+### Interpretation Framework
+- **Green Zone**: Metrics exceeding industry standards
+- **Yellow Zone**: Metrics meeting but not exceeding standards
+- **Red Zone**: Metrics below standards, requires attention
+
+## Tool Integration
+
+### Primary Tools
+- **query_graphql**: Query protocol-level statistics and metrics
+- **search_vaults**: Aggregate vault data for protocol KPIs
+- **get_vault_performance**: Historical trends and growth analysis
+- **compare_vaults**: Top performer identification and benchmarking
+- **analyze_risk**: Security and risk distribution analysis
+- **get_user_portfolio**: User base and portfolio aggregation (when available)
+
+### Analysis Workflow
+1. Query protocol data: Use query_graphql to fetch comprehensive vault and curator statistics
+2. Aggregate metrics: Use search_vaults to calculate total TVL, vault counts, avg APR
+3. Historical trends: Use get_vault_performance across multiple vaults for growth analysis
+4. Top performers: Use compare_vaults to identify and rank best performing vaults
+5. Risk distribution: Use analyze_risk on vault sample to assess security posture
+6. Curator analysis: Query curator data and aggregate vault counts per curator
+7. Compute health score: Calculate composite score from all KPI components
+8. Contextual interpretation: Compare to benchmarks and provide insights
+
+**Example Protocol Statistics Query**:
+
+  query ProtocolOverview {
+    vaults(first: 1000) {
+      items {
+        id
+        tvl
+        apr
+        createdAt
+        curator { id name }
+        chain { id name }
+        asset { symbol decimals }
+      }
+    }
+    curators {
+      items {
+        id
+        name
+      }
+    }
+  }
+
+Aggregate this data to calculate:
+- Total TVL (sum all vault TVLs)
+- Vault count (items.length)
+- Average APR (weighted by TVL)
+- Active curators (unique curator IDs)
+- Chain distribution
+- Growth trends (compare to historical data)
+
+## Use Cases
+
+### Use Case 1: Platform Evaluation
+**Query**: "Should I use Lagoon? How healthy is the protocol?"
+**Response**: Present health score, growth trends, competitive position, and clear recommendation
+
+### Use Case 2: Investment Due Diligence
+**Query**: "Is Lagoon growing? What's the TVL trend?"
+**Response**: Detailed TVL analysis with historical trends, growth rates, and industry context
+
+### Use Case 3: Risk Assessment
+**Query**: "How safe is Lagoon? Any security concerns?"
+**Response**: Security track record, audit coverage, risk distribution, and incident history
+
+### Use Case 4: Competitive Analysis
+**Query**: "How does Lagoon compare to Gauntlet?"
+**Response**: Side-by-side comparison with strengths/weaknesses and use case fit
+
+---
+
+## Reference Documentation
+
+**Complete dashboard**: [/docs/prompts/protocol-overview-kpi-dashboard.md](../../docs/prompts/protocol-overview-kpi-dashboard.md)
+
+**Tool documentation**:
+- [query_graphql](../../docs/tools/query-graphql.md) - For protocol-level queries
+- [search_vaults](../../docs/tools/search-vaults.md) - For vault aggregation
+- [get_vault_performance](../../docs/tools/get-vault-performance.md) - For historical trends
+- [compare_vaults](../../docs/tools/compare-vaults.md) - For benchmarking
+- [analyze_risk](../../docs/tools/analyze-risk.md) - For security analysis
+
+---
+
+*This prompt is part of the Lagoon MCP protocol intelligence system*
+`;
+}
+//# sourceMappingURL=protocol-overview.js.map

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

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

package/dist/prompts/shared/disclaimers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Universal legal disclaimers and risk notices for Lagoon MCP prompts
+ *
+ * These disclaimers MUST be included in all prompts that provide financial analysis,
+ * investment guidance, or DeFi-related recommendations.
+ *
+ * @module disclaimers
+ */
+/**
+ * Universal disclaimer covering legal protections, risk acknowledgment,
+ * and user responsibilities. Required in ALL runtime prompts.
+ */
+export declare const UNIVERSAL_DISCLAIMER = "\n\u26A0\uFE0F **CRITICAL LEGAL DISCLAIMERS**\n\n**NOT FINANCIAL ADVICE**:\nThis analysis is for informational and educational purposes ONLY. It does NOT\nconstitute financial, investment, legal, or tax advice. No content provided\nshould be relied upon as the basis for any investment decision.\n\n**PROFESSIONAL CONSULTATION REQUIRED**:\nBefore making ANY investment decisions, you MUST consult:\n- Licensed financial advisors for investment guidance\n- Legal counsel for regulatory compliance\n- Tax professionals for tax implications\n- Other qualified professionals as appropriate for your situation\n\n**CRYPTOCURRENCY & DEFI RISKS**:\nCryptocurrency and DeFi investments carry SUBSTANTIAL risk including:\n- Complete loss of capital (you may lose 100% of your investment)\n- Extreme price volatility and market fluctuations\n- Smart contract vulnerabilities and exploits\n- Regulatory uncertainty and potential legal changes\n- Lack of investor protections (not FDIC insured)\n- Technology risks (bugs, hacks, network failures)\n- Liquidity risks (inability to exit positions)\n\n**NO WARRANTIES OR GUARANTEES**:\nAll data, analysis, and recommendations are provided \"AS IS\" without warranty\nof any kind, express or implied. We make no guarantees about:\n- Accuracy, completeness, or timeliness of information\n- Suitability for your particular investment objectives\n- Future performance or results\n- Availability or reliability of services\n\n**PAST PERFORMANCE**:\nPast performance does NOT guarantee or predict future results. Historical\nreturns, yields, or APRs are NOT indicative of future performance.\n\n**NO LIABILITY**:\nWe accept NO liability for:\n- Investment losses or financial damages\n- Decisions made based on this information\n- Consequences of using this service\n- Errors, omissions, or inaccuracies in data\n- Third-party actions or service interruptions\n\n**USER RESPONSIBILITY**:\nYou are solely responsible for:\n- Conducting independent research and due diligence\n- Verifying all information from official sources\n- Understanding risks before investing\n- Complying with laws and regulations in your jurisdiction\n- Managing your own security and private keys\n- Evaluating your own risk tolerance and financial situation\n\n**REGULATORY NOTICE**:\nThis service may not be available in all jurisdictions. Users are responsible\nfor determining legality and compliance with local laws and regulations.\n";
+/**
+ * DeFi-specific risk disclosures covering technical and operational risks
+ * unique to decentralized finance. Required for all DeFi analysis prompts.
+ */
+export declare const DEFI_SPECIFIC_RISKS = "\n**DEFI-SPECIFIC RISKS**:\n\n**Smart Contract Risk**:\nEven audited smart contracts may contain undiscovered vulnerabilities, bugs,\nor exploits. Code audits do NOT guarantee safety. Smart contract failures\ncan result in total loss of funds with no recourse.\n\n**Gas Cost Volatility**:\nEthereum network transaction costs (gas fees) can spike unexpectedly during\nnetwork congestion, making transactions prohibitively expensive or causing\nfailed transactions with lost gas fees.\n\n**Impermanent Loss**:\nLiquidity provider (LP) positions expose users to impermanent loss when\ntoken prices diverge. You may receive less value when withdrawing than if\nyou had simply held the tokens.\n\n**MEV (Maximal Extractable Value)**:\nYour transactions may be front-run, sandwiched, or reordered by MEV bots\nand validators, resulting in worse execution prices or failed transactions.\n\n**Flash Loan Attacks**:\nDeFi protocols may be vulnerable to flash loan attacks that can drain\nliquidity pools or manipulate prices, causing losses for users.\n\n**Oracle Manipulation**:\nPrice feeds and oracles can be manipulated, especially during low liquidity\nperiods or through flash loan attacks, leading to incorrect valuations and\npotential liquidations.\n\n**Governance Risk**:\nProtocol parameters, fee structures, and security controls can be changed\nthrough governance votes, potentially affecting your positions adversely.\n\n**Composability Risk**:\nDeFi protocols are interconnected. Failures in one protocol can cascade\nthrough the ecosystem, affecting other protocols you're using.\n\n**Regulatory Risk**:\nDeFi regulatory status is uncertain and evolving. Regulatory actions could\nrestrict access, freeze assets, or impose penalties without warning.\n\n**Systemic Risks**:\nDeFi-wide events (regulatory crackdowns, mass liquidations, stablecoin\ndepegs, bridge exploits) can trigger cascading failures across protocols.\n";
+/**
+ * Regulatory and compliance notices covering legal requirements,
+ * tax obligations, and jurisdictional restrictions.
+ */
+export declare const REGULATORY_COMPLIANCE_NOTICE = "\n## \uD83D\uDCCB Regulatory & Compliance Notices\n\n**Investment Advisor Disclosure**:\nThis service is NOT provided by registered investment advisors, broker-dealers,\nor financial institutions. We do not provide personalized investment\nrecommendations or portfolio management services.\n\n**Securities Law Notice**:\nSome digital assets may be classified as securities under applicable laws\n(including the U.S. Securities Act of 1933, the Howey Test, or equivalent\nregulations in other jurisdictions). Users are solely responsible for\ndetermining the regulatory classification of assets and compliance with\nsecurities laws in their jurisdiction.\n\n**Tax Obligations**:\nCryptocurrency transactions may constitute taxable events in your jurisdiction,\nincluding but not limited to:\n- Trading, swapping, or exchanging cryptocurrencies\n- Earning yield, rewards, or staking income\n- Receiving airdrops or governance tokens\n- Providing liquidity to pools\n\nYou are responsible for tracking all transactions and reporting to tax\nauthorities. Consult qualified tax professionals for guidance on your specific\ntax obligations.\n\n**KYC/AML Compliance**:\nSome jurisdictions require Know Your Customer (KYC) and Anti-Money Laundering\n(AML) compliance for cryptocurrency services. Users are responsible for\ncomplying with applicable KYC/AML requirements.\n\n**Geographic Restrictions**:\nThis service may not be available or may be restricted in certain jurisdictions,\nincluding but not limited to: countries subject to international sanctions,\njurisdictions where cryptocurrency activities are prohibited, or regions with\nspecific regulatory restrictions.\n\nUsers are responsible for determining whether their use of this service\ncomplies with local laws and regulations.\n\n**Accredited Investor Status**:\nSome investment opportunities may be restricted to accredited investors as\ndefined by applicable securities regulations. Non-accredited investors may\nface investment limits or restrictions.\n\n**Cross-Border Compliance**:\nInternational users must comply with:\n- Local cryptocurrency and financial regulations\n- Cross-border payment and money transmission laws\n- Foreign exchange and capital control regulations\n- International tax reporting requirements (FATCA, CRS, etc.)\n\n**Data Protection**:\nUse of this service is subject to applicable data protection regulations\nincluding GDPR (EU), CCPA (California), and other privacy laws. Refer to\nthe privacy policy for details on data handling.\n";
+/**
+ * Data quality and analysis limitation disclaimers covering data sources,
+ * freshness, accuracy, and analytical constraints.
+ */
+export declare const DATA_DISCLAIMER = "\n## \uD83D\uDCCA Data & Analysis Limitations\n\n**Data Sources**:\nAnalysis is based on data aggregated from multiple sources including:\n- Lagoon Protocol backend systems\n- Public blockchain data\n- Third-party data providers\n- Community-provided information\n\nWe do NOT independently verify all data and cannot guarantee accuracy,\ncompleteness, or reliability.\n\n**Data Freshness & Caching**:\nData is cached to improve performance with the following refresh intervals:\n- Portfolio data: Cached up to 5 minutes\n- Vault data: Cached up to 15 minutes\n- Price data: Cached up to 5 minutes\n- APR predictions: Cached up to 60 minutes\n\nDuring periods of high volatility or rapid changes, cached data may not\nreflect current market conditions. For time-sensitive decisions, verify\ncurrent data on-chain or from official sources.\n\n**Analysis Limitations**:\nAll quantitative analysis is subject to limitations:\n- **Historical Bias**: Based on historical data which may not predict future\n  performance, especially in unprecedented market conditions\n- **Model Assumptions**: Statistical models assume certain market behaviors\n  (e.g., normal return distributions) that may not hold in cryptocurrency markets\n- **Incomplete Information**: Analysis cannot account for all factors affecting\n  performance including future protocol changes, regulatory actions, or black\n  swan events\n- **Generalized Approach**: Does not account for your specific circumstances,\n  goals, constraints, or risk tolerance\n\n**Third-Party Data**:\nCompetitor data, benchmark information, and market statistics from third-party\nsources may be:\n- Unverified or incomplete\n- Subject to different calculation methodologies\n- Outdated or no longer accurate\n- Affected by conflicts of interest\n\n**Calculation Methodology**:\nAPR, risk scores, performance metrics, and other calculations use standardized\nmethodologies that may differ from those used by protocols or other platforms.\nDifferent calculation methods can produce different results for the same\nunderlying data.\n\n**No Real-Time Guarantees**:\nWhile we strive to provide timely information, we cannot guarantee real-time\ndata updates. During network congestion, high volatility, or system maintenance,\ndata may be delayed or unavailable.\n\n**Independent Verification Required**:\nUsers must independently verify all critical information including:\n- Smart contract addresses and protocol details\n- APR rates and fee structures\n- TVL and liquidity metrics\n- Security audit reports and status\n- Governance proposals and parameter changes\n";
+/**
+ * Beginner-specific warnings for users new to DeFi and cryptocurrency.
+ * Required for onboarding flows and first-time user experiences.
+ */
+export declare const BEGINNER_WARNINGS = "\n## \uD83D\uDEA8 CRITICAL WARNINGS FOR BEGINNERS\n\n**BEFORE YOUR FIRST DEFI INVESTMENT**:\n\n1. **TOTAL LOSS RISK**: You can lose 100% of your investment. Only invest\n   amounts you can afford to lose completely without affecting your financial\n   security or well-being.\n\n2. **START SMALL**: Begin with minimal amounts to learn how DeFi works. Test\n   all workflows (deposit, withdrawal, claiming rewards) with small amounts\n   before committing significant capital.\n\n3. **NOT FDIC INSURED**: Unlike traditional bank accounts, cryptocurrency\n   holdings are NOT protected by government insurance programs (FDIC, SIPC, etc.).\n   There is no deposit insurance or investor protection.\n\n4. **SELF-CUSTODY RESPONSIBILITY**: You are solely responsible for securing\n   your private keys and wallet access. Lost keys = lost funds permanently.\n   There is no customer service to recover lost passwords or keys.\n\n5. **IRREVERSIBLE TRANSACTIONS**: Blockchain transactions are irreversible.\n   Sending funds to wrong addresses or interacting with malicious contracts\n   can result in permanent loss.\n\n6. **TAX OBLIGATIONS**: In most jurisdictions, cryptocurrency transactions\n   are taxable events. You are responsible for tracking all transactions and\n   reporting to tax authorities. Penalties for non-compliance can be severe.\n\n7. **REGULATORY STATUS**: Check if cryptocurrency and DeFi activities are\n   legal in your jurisdiction. Some countries prohibit or heavily restrict\n   cryptocurrency use.\n\n8. **SCAM PREVALENCE**: The cryptocurrency space has widespread scams, phishing\n   attacks, and fraudulent projects. Be extremely cautious about:\n   - Unsolicited investment opportunities\n   - Promises of guaranteed returns\n   - Projects without audits or transparent teams\n   - Pressure to invest quickly\n\n9. **TECHNICAL COMPLEXITY**: DeFi requires understanding of:\n   - Wallet management and private key security\n   - Gas fees and transaction mechanics\n   - Smart contract interactions and approvals\n   - Risk assessment and due diligence\n\n10. **NO GUARANTEES**: There are no guaranteed returns in DeFi. High APRs\n    often indicate high risk. Be skeptical of yields that seem too good to\n    be true.\n\n**EDUCATIONAL RESOURCES**:\nBefore investing, educate yourself about:\n- How blockchain and smart contracts work\n- Different types of DeFi protocols (lending, DEXs, yield aggregators)\n- Common risks and how to mitigate them\n- How to assess project legitimacy and security\n- Proper wallet security practices\n\n**WHEN IN DOUBT**: If you don't fully understand how a DeFi protocol works,\ndo NOT invest. Take time to learn, ask questions, and start with educational\nresources before risking capital.\n";
+/**
+ * Portfolio-specific disclaimers for optimization and rebalancing advice.
+ * Required for any prompts providing portfolio allocation guidance.
+ */
+export declare const PORTFOLIO_DISCLAIMER = "\n## \uD83D\uDCBC Portfolio Analysis Disclaimers\n\n**THIS IS QUANTITATIVE ANALYSIS, NOT INVESTMENT ADVICE**:\nPortfolio optimization analysis is a quantitative tool that analyzes historical\ndata patterns. It is NOT personalized investment advice and does NOT constitute\na recommendation to buy, sell, or hold any assets.\n\n**Limitations of Portfolio Optimization**:\n- **Historical Data**: Based on past performance which may NOT predict future\n  results, especially in volatile cryptocurrency markets\n- **Assumption Violations**: Assumes normal return distributions and rational\n  markets, which often do not hold in cryptocurrency\n- **Missing Context**: Cannot account for your specific:\n  - Tax situation and optimization strategies\n  - Investment goals and time horizons\n  - Risk tolerance and liquidity needs\n  - Regulatory constraints in your jurisdiction\n  - Personal circumstances and preferences\n\n**Rebalancing Considerations**:\n- **Tax Implications**: Rebalancing triggers taxable events. Consult tax\n  professionals BEFORE executing rebalancing recommendations.\n- **Transaction Costs**: Gas fees and slippage can significantly impact\n  small portfolios. Calculate costs before rebalancing.\n- **Market Impact**: Large rebalancing operations may experience price slippage\n  or limited liquidity.\n- **Timing Risk**: Market conditions can change between analysis and execution.\n\n**Professional Consultation Recommended**:\nFor portfolios valued at >$10,000 or representing a significant portion of your\nnet worth, STRONGLY consider consulting licensed financial advisors before\nmaking allocation changes.\n\n**Risk Metrics Limitations**:\n- Volatility and risk metrics are backward-looking and may not capture:\n  - Tail risks and black swan events\n  - Correlation breakdowns during crises\n  - New risks from protocol changes or exploits\n- Value at Risk (VaR) and similar metrics assume normal distributions which\n  rarely hold in cryptocurrency markets\n\n**Diversification Note**:\nDiversification across cryptocurrency assets does NOT eliminate risk. All\ncryptocurrencies may decline together during market downturns or regulatory\nactions. True diversification requires exposure to uncorrelated asset classes.\n";
+/**
+ * Helper function to combine disclaimers based on prompt type
+ */
+export declare function getDisclaimers(options: {
+    universal: boolean;
+    defi: boolean;
+    regulatory: boolean;
+    data: boolean;
+    beginner: boolean;
+    portfolio: boolean;
+}): string;
+/**
+ * Report footer disclaimer for all user-facing analysis outputs
+ */
+export declare const REPORT_FOOTER_DISCLAIMER = "\n---\n\u26A0\uFE0F **DISCLAIMER**: This analysis is for informational and educational purposes\nonly and is NOT financial, investment, legal, or tax advice. Cryptocurrency\nand DeFi investments carry substantial risk including potential total loss of\ncapital. Past performance does not guarantee future results. Consult qualified\nprofessionals before making investment decisions. See full disclaimers in\ndocumentation.\n---\n";
+//# sourceMappingURL=disclaimers.d.ts.map

package/dist/prompts/shared/disclaimers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclaimers.d.ts","sourceRoot":"","sources":["../../../src/prompts/shared/disclaimers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,g5EAyDhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,64DA8C/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,k+EAyDxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,kjFA8D3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,msFA6D7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,ktEA8ChC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAWT;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,kbASpC,CAAC"}