@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/utils/csv-generator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * CSV Generator Utility
+ *
+ * Provides CSV formatting and generation for vault data export.
+ * Handles proper escaping, quoting, and formatting for CSV compliance.
+ */
+/**
+ * Escape CSV field value
+ * Handles quotes, commas, newlines according to RFC 4180
+ */
+export declare function escapeCSVField(value: unknown): string;
+/**
+ * Generate CSV header row from column names
+ */
+export declare function generateCSVHeader(columns: string[]): string;
+/**
+ * Generate CSV row from data object
+ */
+export declare function generateCSVRow(data: Record<string, unknown>, columns: string[]): string;
+/**
+ * Generate complete CSV from array of objects
+ */
+export declare function generateCSV(data: Record<string, unknown>[], columns: string[]): string;
+/**
+ * Format vault data for CSV export
+ */
+export interface VaultCSVData extends Record<string, unknown> {
+    address: string;
+    name: string;
+    symbol: string;
+    chainId: number;
+    tvl: number;
+    apr: number;
+    pricePerShare: number;
+    totalAssets: string;
+    totalShares: string;
+    assetSymbol: string;
+    assetAddress: string;
+}
+/**
+ * Generate CSV for vault data
+ */
+export declare function generateVaultCSV(vaults: VaultCSVData[]): string;
+/**
+ * Format transaction data for CSV export
+ */
+export interface TransactionCSVData extends Record<string, unknown> {
+    id: string;
+    type: string;
+    timestamp: string;
+    blockNumber: string;
+    vaultAddress: string;
+    userAddress?: string;
+    amount?: string;
+    shares?: string;
+    assets?: string;
+}
+/**
+ * Generate CSV for transaction data
+ */
+export declare function generateTransactionCSV(transactions: TransactionCSVData[]): string;
+/**
+ * Format price history data for CSV export
+ */
+export interface PriceHistoryCSVData extends Record<string, unknown> {
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+/**
+ * Generate CSV for price history data
+ */
+export declare function generatePriceHistoryCSV(priceData: PriceHistoryCSVData[]): string;
+/**
+ * Format performance metrics for CSV export
+ */
+export interface PerformanceCSVData extends Record<string, unknown> {
+    timestamp: string;
+    totalAssetsUsd: number;
+    blockNumber: string;
+}
+/**
+ * Generate CSV for performance metrics
+ */
+export declare function generatePerformanceCSV(metrics: PerformanceCSVData[]): string;
+//# sourceMappingURL=csv-generator.d.ts.map

package/dist/utils/csv-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-generator.d.ts","sourceRoot":"","sources":["../../src/utils/csv-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgBrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAStF;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAgB/D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAcjF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAIhF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAI5E"}

package/dist/utils/csv-generator.js

@@ -0,0 +1,97 @@
+/**
+ * CSV Generator Utility
+ *
+ * Provides CSV formatting and generation for vault data export.
+ * Handles proper escaping, quoting, and formatting for CSV compliance.
+ */
+/**
+ * Escape CSV field value
+ * Handles quotes, commas, newlines according to RFC 4180
+ */
+export function escapeCSVField(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    const strValue = String(value);
+    // Check if field needs quoting (contains comma, quote, or newline)
+    const needsQuoting = /[",\n\r]/.test(strValue);
+    if (needsQuoting) {
+        // Escape quotes by doubling them and wrap in quotes
+        return `"${strValue.replace(/"/g, '""')}"`;
+    }
+    return strValue;
+}
+/**
+ * Generate CSV header row from column names
+ */
+export function generateCSVHeader(columns) {
+    return columns.map(escapeCSVField).join(',');
+}
+/**
+ * Generate CSV row from data object
+ */
+export function generateCSVRow(data, columns) {
+    return columns.map((col) => escapeCSVField(data[col])).join(',');
+}
+/**
+ * Generate complete CSV from array of objects
+ */
+export function generateCSV(data, columns) {
+    if (data.length === 0) {
+        return generateCSVHeader(columns);
+    }
+    const header = generateCSVHeader(columns);
+    const rows = data.map((row) => generateCSVRow(row, columns));
+    return [header, ...rows].join('\n');
+}
+/**
+ * Generate CSV for vault data
+ */
+export function generateVaultCSV(vaults) {
+    const columns = [
+        'address',
+        'name',
+        'symbol',
+        'chainId',
+        'tvl',
+        'apr',
+        'pricePerShare',
+        'totalAssets',
+        'totalShares',
+        'assetSymbol',
+        'assetAddress',
+    ];
+    return generateCSV(vaults, columns);
+}
+/**
+ * Generate CSV for transaction data
+ */
+export function generateTransactionCSV(transactions) {
+    const columns = [
+        'id',
+        'type',
+        'timestamp',
+        'blockNumber',
+        'vaultAddress',
+        'userAddress',
+        'amount',
+        'shares',
+        'assets',
+    ];
+    return generateCSV(transactions, columns);
+}
+/**
+ * Generate CSV for price history data
+ */
+export function generatePriceHistoryCSV(priceData) {
+    const columns = ['date', 'open', 'high', 'low', 'close', 'volume'];
+    return generateCSV(priceData, columns);
+}
+/**
+ * Generate CSV for performance metrics
+ */
+export function generatePerformanceCSV(metrics) {
+    const columns = ['timestamp', 'totalAssetsUsd', 'blockNumber'];
+    return generateCSV(metrics, columns);
+}
+//# sourceMappingURL=csv-generator.js.map

package/dist/utils/csv-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-generator.js","sourceRoot":"","sources":["../../src/utils/csv-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE/B,mEAAmE;IACnE,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,YAAY,EAAE,CAAC;QACjB,oDAAoD;QACpD,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IAC7C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiB;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAA6B,EAAE,OAAiB;IAC7E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAA+B,EAAE,OAAiB;IAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7D,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAmBD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,OAAO,GAAG;QACd,SAAS;QACT,MAAM;QACN,QAAQ;QACR,SAAS;QACT,KAAK;QACL,KAAK;QACL,eAAe;QACf,aAAa;QACb,aAAa;QACb,aAAa;QACb,cAAc;KACf,CAAC;IAEF,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAiBD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAkC;IACvE,MAAM,OAAO,GAAG;QACd,IAAI;QACJ,MAAM;QACN,WAAW;QACX,aAAa;QACb,cAAc;QACd,aAAa;QACb,QAAQ;QACR,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,OAAO,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAcD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAgC;IACtE,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEnE,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA6B;IAClE,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAE/D,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/disclaimers.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Legal Disclaimers for Financial Analysis Tools
+ *
+ * Provides legally protective disclaimer text for all financial analysis outputs.
+ * Compliant with SEC/FINRA guidelines for financial information disclosure.
+ *
+ * @module disclaimers
+ */
+export type DisclaimerMode = 'full' | 'compact' | 'minimal';
+export interface DisclaimerConfig {
+    mode: DisclaimerMode;
+    toolName: string;
+    includeTimestamp?: boolean;
+}
+/**
+ * Full disclaimer for high-risk financial analysis tools
+ * Use for: analyze_risk, predict_yield, optimize_portfolio, compare_vaults
+ *
+ * Includes:
+ * - Not financial advice statement
+ * - Risk warnings
+ * - Liability limitation
+ * - Professional consultation recommendation
+ * - Data accuracy limitations
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Full legal disclaimer text
+ */
+export declare function getFullFinancialDisclaimer(toolName: string): string;
+/**
+ * Compact disclaimer for medium-risk tools
+ * Use for: search_vaults, vault_performance, get_price_history, get_transactions
+ *
+ * Provides essential legal protection while maintaining readability for data-focused tools.
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Compact legal disclaimer text
+ */
+export declare function getCompactFinancialDisclaimer(toolName: string): string;
+/**
+ * Minimal disclaimer for data retrieval tools
+ * Use for: get_vault_data, user_portfolio, export_data, query_graphql, simulate_vault
+ *
+ * Provides basic legal protection for pure data retrieval operations.
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Minimal legal disclaimer text
+ */
+export declare function getMinimalFinancialDisclaimer(_toolName: string): string;
+/**
+ * Get appropriate disclaimer based on tool risk level
+ *
+ * Automatically determines the appropriate disclaimer level based on tool name
+ * if mode is not explicitly specified.
+ *
+ * @param toolName - Name of the tool (snake_case)
+ * @param mode - Optional override for disclaimer mode
+ * @returns Appropriate disclaimer text for the tool
+ *
+ * @example
+ * ```typescript
+ * const disclaimer = getToolDisclaimer('analyze_risk');
+ * // Returns full disclaimer
+ *
+ * const customDisclaimer = getToolDisclaimer('search_vaults', 'minimal');
+ * // Returns minimal disclaimer (overriding auto-detection)
+ * ```
+ */
+export declare function getToolDisclaimer(toolName: string, mode?: DisclaimerMode): string;
+//# sourceMappingURL=disclaimers.d.ts.map

package/dist/utils/disclaimers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclaimers.d.ts","sourceRoot":"","sources":["../../src/utils/disclaimers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmCnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAStE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKvE;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAyBjF"}

package/dist/utils/disclaimers.js

@@ -0,0 +1,161 @@
+/**
+ * Legal Disclaimers for Financial Analysis Tools
+ *
+ * Provides legally protective disclaimer text for all financial analysis outputs.
+ * Compliant with SEC/FINRA guidelines for financial information disclosure.
+ *
+ * @module disclaimers
+ */
+/**
+ * Full disclaimer for high-risk financial analysis tools
+ * Use for: analyze_risk, predict_yield, optimize_portfolio, compare_vaults
+ *
+ * Includes:
+ * - Not financial advice statement
+ * - Risk warnings
+ * - Liability limitation
+ * - Professional consultation recommendation
+ * - Data accuracy limitations
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Full legal disclaimer text
+ */
+export function getFullFinancialDisclaimer(toolName) {
+    const timestamp = new Date().toISOString();
+    return `
+
+---
+
+⚠️ **IMPORTANT DISCLAIMER - NOT FINANCIAL ADVICE**
+
+This analysis is provided for **informational and educational purposes only** and does NOT constitute financial, investment, legal, or tax advice. The information presented by the ${toolName} tool:
+
+- Is based on historical data and algorithmic analysis that may contain errors or inaccuracies
+- Should NOT be relied upon as the sole basis for any investment decision
+- Does NOT consider your individual financial situation, risk tolerance, or investment objectives
+- Is NOT a recommendation to buy, sell, hold, or trade any digital asset or financial instrument
+
+**Cryptocurrency and DeFi investments carry substantial risk**, including but not limited to:
+- Complete loss of invested capital
+- Smart contract vulnerabilities and exploits
+- Market volatility and illiquidity
+- Regulatory changes and enforcement actions
+- Platform failures and operational risks
+
+**BEFORE MAKING ANY INVESTMENT DECISIONS**:
+1. Conduct your own thorough due diligence and research
+2. Consult with qualified financial, legal, and tax professionals
+3. Only invest capital you can afford to lose completely
+4. Understand the specific risks associated with each vault and protocol
+
+**NO LIABILITY**: We accept no liability whatsoever for any loss, damage, or adverse outcome arising from your use of this information. Past performance does not guarantee future results.
+
+**Data Currency**: Analysis generated at ${timestamp}. Market conditions change rapidly.
+
+---
+`;
+}
+/**
+ * Compact disclaimer for medium-risk tools
+ * Use for: search_vaults, vault_performance, get_price_history, get_transactions
+ *
+ * Provides essential legal protection while maintaining readability for data-focused tools.
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Compact legal disclaimer text
+ */
+export function getCompactFinancialDisclaimer(toolName) {
+    return `
+
+---
+
+⚠️ **DISCLAIMER**: This ${toolName} output is for informational purposes only and is NOT financial advice. Cryptocurrency investments carry substantial risk including complete loss of capital. Conduct your own research and consult qualified professionals before making investment decisions. We accept no liability for losses arising from use of this information.
+
+---
+`;
+}
+/**
+ * Minimal disclaimer for data retrieval tools
+ * Use for: get_vault_data, user_portfolio, export_data, query_graphql, simulate_vault
+ *
+ * Provides basic legal protection for pure data retrieval operations.
+ *
+ * @param toolName - Name of the tool generating the output
+ * @returns Minimal legal disclaimer text
+ */
+export function getMinimalFinancialDisclaimer(_toolName) {
+    return `
+
+*Disclaimer: For informational purposes only. Not financial advice. DYOR and consult professionals before investing.*
+`;
+}
+/**
+ * High-risk financial analysis tools requiring full disclaimers
+ */
+const HIGH_RISK_TOOLS = ['analyze_risk', 'predict_yield', 'optimize_portfolio', 'compare_vaults'];
+/**
+ * Medium-risk tools requiring compact disclaimers
+ */
+const MEDIUM_RISK_TOOLS = [
+    'search_vaults',
+    'vault_performance',
+    'price_history',
+    'get_transactions',
+];
+/**
+ * Low-risk data retrieval tools requiring minimal disclaimers
+ */
+const LOW_RISK_TOOLS = [
+    'vault_data',
+    'user_portfolio',
+    'export_data',
+    'query_graphql',
+    'simulate_vault',
+];
+/**
+ * Get appropriate disclaimer based on tool risk level
+ *
+ * Automatically determines the appropriate disclaimer level based on tool name
+ * if mode is not explicitly specified.
+ *
+ * @param toolName - Name of the tool (snake_case)
+ * @param mode - Optional override for disclaimer mode
+ * @returns Appropriate disclaimer text for the tool
+ *
+ * @example
+ * ```typescript
+ * const disclaimer = getToolDisclaimer('analyze_risk');
+ * // Returns full disclaimer
+ *
+ * const customDisclaimer = getToolDisclaimer('search_vaults', 'minimal');
+ * // Returns minimal disclaimer (overriding auto-detection)
+ * ```
+ */
+export function getToolDisclaimer(toolName, mode) {
+    // Auto-determine mode based on tool name if not specified
+    let disclaimerMode = mode;
+    if (!disclaimerMode) {
+        if (HIGH_RISK_TOOLS.includes(toolName)) {
+            disclaimerMode = 'full';
+        }
+        else if (MEDIUM_RISK_TOOLS.includes(toolName)) {
+            disclaimerMode = 'compact';
+        }
+        else if (LOW_RISK_TOOLS.includes(toolName)) {
+            disclaimerMode = 'minimal';
+        }
+        else {
+            // Default to compact for unknown tools
+            disclaimerMode = 'compact';
+        }
+    }
+    switch (disclaimerMode) {
+        case 'full':
+            return getFullFinancialDisclaimer(toolName);
+        case 'compact':
+            return getCompactFinancialDisclaimer(toolName);
+        case 'minimal':
+            return getMinimalFinancialDisclaimer(toolName);
+    }
+}
+//# sourceMappingURL=disclaimers.js.map

package/dist/utils/disclaimers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disclaimers.js","sourceRoot":"","sources":["../../src/utils/disclaimers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO;;;;;;sLAM6K,QAAQ;;;;;;;;;;;;;;;;;;;;;;2CAsBnJ,SAAS;;;CAGnD,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO;;;;0BAIiB,QAAQ;;;CAGjC,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAAC,SAAiB;IAC7D,OAAO;;;CAGR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,iBAAiB,GAAG;IACxB,eAAe;IACf,mBAAmB;IACnB,eAAe;IACf,kBAAkB;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG;IACrB,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,eAAe;IACf,gBAAgB;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAqB;IACvE,0DAA0D;IAC1D,IAAI,cAAc,GAAG,IAAI,CAAC;IAE1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,IAAI,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,cAAc,GAAG,MAAM,CAAC;QAC1B,CAAC;aAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC;aAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,cAAc,GAAG,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QAC9C,KAAK,SAAS;YACZ,OAAO,6BAA6B,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,SAAS;YACZ,OAAO,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Error Handling Utilities
+ *
+ * Custom error types and formatting for consistent error handling
+ */
+/**
+ * GraphQL error detail structure
+ */
+type GraphQLErrorDetail = {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+};
+/**
+ * GraphQL-specific error with response details
+ */
+export declare class GraphQLError extends Error {
+    errors: GraphQLErrorDetail[];
+    constructor(message: string, errors: GraphQLErrorDetail[]);
+}
+/**
+ * Input validation error
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Cache operation error
+ */
+export declare class CacheError extends Error {
+    constructor(message: string);
+}
+/**
+ * Network/connection error
+ */
+export declare class NetworkError extends Error {
+    constructor(message: string);
+}
+/**
+ * Format error for user-facing display
+ */
+export declare function formatError(error: unknown): string;
+/**
+ * MCP error response type
+ */
+type MCPErrorResponse = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * Standard error response for MCP tools
+ */
+export declare function errorResponse(error: unknown): MCPErrorResponse;
+/**
+ * Log error to stderr (Claude Code captures this)
+ */
+export declare function logError(error: unknown, context?: string): void;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,MAAM,EAAE,kBAAkB,EAAE;gBADnC,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,kBAAkB,EAAE;CAKtC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAsBlD;AAED;;GAEG;AACH,KAAK,gBAAgB,GAAG;IACtB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAU9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAG/D"}

package/dist/utils/errors.js

@@ -0,0 +1,86 @@
+/**
+ * Error Handling Utilities
+ *
+ * Custom error types and formatting for consistent error handling
+ */
+/**
+ * GraphQL-specific error with response details
+ */
+export class GraphQLError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'GraphQLError';
+    }
+}
+/**
+ * Input validation error
+ */
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Cache operation error
+ */
+export class CacheError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CacheError';
+    }
+}
+/**
+ * Network/connection error
+ */
+export class NetworkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Format error for user-facing display
+ */
+export function formatError(error) {
+    if (error instanceof GraphQLError) {
+        return `GraphQL Error: ${error.message}\n${JSON.stringify(error.errors, null, 2)}`;
+    }
+    if (error instanceof ValidationError) {
+        return `Validation Error: ${error.message}`;
+    }
+    if (error instanceof CacheError) {
+        return `Cache Error: ${error.message}`;
+    }
+    if (error instanceof NetworkError) {
+        return `Network Error: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `Error: ${error.message}`;
+    }
+    return `Unknown Error: ${String(error)}`;
+}
+/**
+ * Standard error response for MCP tools
+ */
+export function errorResponse(error) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: formatError(error),
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Log error to stderr (Claude Code captures this)
+ */
+export function logError(error, context) {
+    const prefix = context ? `[${context}]` : '';
+    console.error(`${prefix} ${formatError(error)}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG5B;IAFT,YACE,OAAe,EACR,MAA4B;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,WAAM,GAAN,MAAM,CAAsB;QAGnC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,kBAAkB,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;IAED,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC3C,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;aACzB;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,OAAgB;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC"}