@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/tools/get-price-history.d.ts

@@ -0,0 +1,29 @@
+/**
+ * get_price_history Tool
+ *
+ * Historical price data with OHLCV (Open, High, Low, Close, Volume) time-series analysis.
+ * Provides price trends and volatility metrics for vault share price over time.
+ *
+ * Use cases:
+ * - Price trend analysis and pattern recognition
+ * - Volatility assessment and risk evaluation
+ * - Historical price point identification for entry/exit decisions
+ * - Performance: ~300-500 tokens per vault per time range
+ *
+ * Cache strategy:
+ * - 30-minute TTL for price history data
+ * - Cache key: price_history:{address}:{chainId}:{timeRange}
+ * - Cache hit rate target: 75-85%
+ * - Cache tags: [CacheTag.VAULT, CacheTag.ANALYTICS] for invalidation
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { PriceHistoryInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeGetPriceHistory function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteGetPriceHistory(container: ServiceContainer): (input: PriceHistoryInput) => Promise<CallToolResult>;
+//# sourceMappingURL=get-price-history.d.ts.map

package/dist/tools/get-price-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-price-history.d.ts","sourceRoot":"","sources":["../../src/tools/get-price-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA6QxD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,cAAc,CAAC,CA8DvD"}

package/dist/tools/get-price-history.js

@@ -0,0 +1,236 @@
+/**
+ * get_price_history Tool
+ *
+ * Historical price data with OHLCV (Open, High, Low, Close, Volume) time-series analysis.
+ * Provides price trends and volatility metrics for vault share price over time.
+ *
+ * Use cases:
+ * - Price trend analysis and pattern recognition
+ * - Volatility assessment and risk evaluation
+ * - Historical price point identification for entry/exit decisions
+ * - Performance: ~300-500 tokens per vault per time range
+ *
+ * Cache strategy:
+ * - 30-minute TTL for price history data
+ * - Cache key: price_history:{address}:{chainId}:{timeRange}
+ * - Cache hit rate target: 75-85%
+ * - Cache tags: [CacheTag.VAULT, CacheTag.ANALYTICS] for invalidation
+ */
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import { PRICE_HISTORY_QUERY } from '../graphql/queries/index.js';
+import { executeToolWithCache } from '../utils/execute-tool-with-cache.js';
+import { CacheTag } from '../core/cache-invalidation.js';
+import { cacheKeys, cacheTTL } from '../cache/index.js';
+/**
+ * Time range constants (in seconds)
+ */
+const TIME_RANGES = {
+    '7d': 7 * 24 * 60 * 60,
+    '30d': 30 * 24 * 60 * 60,
+    '90d': 90 * 24 * 60 * 60,
+    '1y': 365 * 24 * 60 * 60,
+    all: 0, // No time limit
+};
+/**
+ * Type guard for TotalAssetsUpdatedData
+ */
+function isTotalAssetsUpdated(data) {
+    return (typeof data === 'object' && data !== null && 'totalAssetsUsd' in data && 'totalSupply' in data);
+}
+/**
+ * Aggregate transactions into OHLCV time buckets
+ * Groups data by day for cleaner visualization
+ */
+function aggregateOHLCV(transactions) {
+    if (transactions.length === 0)
+        return [];
+    // Group transactions by day (86400 seconds)
+    const dayBuckets = new Map();
+    for (const tx of transactions) {
+        if (!isTotalAssetsUpdated(tx.data))
+            continue;
+        const timestamp = parseInt(tx.timestamp, 10);
+        const dayTimestamp = Math.floor(timestamp / 86400) * 86400;
+        if (!dayBuckets.has(dayTimestamp)) {
+            dayBuckets.set(dayTimestamp, []);
+        }
+        dayBuckets.get(dayTimestamp).push(tx);
+    }
+    // Convert buckets to OHLCV data points
+    const ohlcvData = [];
+    for (const [dayTimestamp, txs] of Array.from(dayBuckets.entries()).sort((a, b) => a[0] - b[0])) {
+        const prices = txs
+            .filter((tx) => isTotalAssetsUpdated(tx.data))
+            .map((tx) => {
+            // Calculate price per share from totalAssetsUsd / totalSupply
+            const totalSupply = parseFloat(tx.data.totalSupply) / 1e18; // Convert from wei to decimal
+            return totalSupply > 0 ? tx.data.totalAssetsUsd / totalSupply : 0;
+        });
+        if (prices.length === 0)
+            continue;
+        const volumes = txs
+            .filter((tx) => isTotalAssetsUpdated(tx.data))
+            .map((tx) => tx.data.totalAssetsUsd);
+        const open = prices[0];
+        const close = prices[prices.length - 1];
+        const high = Math.max(...prices);
+        const low = Math.min(...prices);
+        const volume = volumes.reduce((sum, v) => sum + v, 0) / volumes.length; // Average TVL for the day
+        ohlcvData.push({
+            timestamp: dayTimestamp,
+            open,
+            high,
+            low,
+            close,
+            volume,
+            blockNumber: txs[txs.length - 1].blockNumber,
+        });
+    }
+    return ohlcvData;
+}
+/**
+ * Calculate price statistics from OHLCV data
+ */
+function calculateStatistics(ohlcvData) {
+    if (ohlcvData.length === 0) {
+        return {
+            currentPrice: 0,
+            startPrice: 0,
+            highPrice: 0,
+            lowPrice: 0,
+            averagePrice: 0,
+            percentChange: 0,
+            volatility: 0,
+            totalVolume: 0,
+            dataPoints: 0,
+        };
+    }
+    const prices = ohlcvData.map((d) => d.close);
+    const currentPrice = prices[prices.length - 1];
+    const startPrice = prices[0];
+    const highPrice = Math.max(...ohlcvData.map((d) => d.high));
+    const lowPrice = Math.min(...ohlcvData.map((d) => d.low));
+    const averagePrice = prices.reduce((sum, p) => sum + p, 0) / prices.length;
+    const percentChange = startPrice > 0 ? ((currentPrice - startPrice) / startPrice) * 100 : 0;
+    // Calculate volatility (standard deviation)
+    const squaredDiffs = prices.map((p) => Math.pow(p - averagePrice, 2));
+    const variance = squaredDiffs.reduce((sum, d) => sum + d, 0) / prices.length;
+    const volatility = Math.sqrt(variance);
+    const totalVolume = ohlcvData.reduce((sum, d) => sum + d.volume, 0);
+    return {
+        currentPrice,
+        startPrice,
+        highPrice,
+        lowPrice,
+        averagePrice,
+        percentChange,
+        volatility,
+        totalVolume,
+        dataPoints: ohlcvData.length,
+    };
+}
+/**
+ * Transform raw GraphQL response into markdown-formatted output
+ * Uses closure to capture input values and timestamp filter
+ */
+function createTransformPriceHistoryData(input, timestampGte) {
+    return (data) => {
+        // Filter transactions by timestamp client-side (since API doesn't support timestamp filtering)
+        const filteredItems = timestampGte > 0
+            ? data.transactions.items.filter((item) => parseInt(item.timestamp) >= timestampGte)
+            : data.transactions.items;
+        // Aggregate into OHLCV time-series
+        const ohlcvData = aggregateOHLCV(filteredItems);
+        // Calculate statistics
+        const statistics = calculateStatistics(ohlcvData);
+        // Format output as markdown based on responseFormat
+        const responseFormat = (input.responseFormat ?? 'summary');
+        let markdown = `# Price History: ${input.vaultAddress}\n\n` +
+            `**Chain ID**: ${input.chainId}\n` +
+            `**Time Range**: ${input.timeRange}\n` +
+            `**Data Points**: ${statistics.dataPoints}\n\n` +
+            `## Price Statistics\n\n` +
+            `- **Current Price**: $${statistics.currentPrice.toFixed(6)}\n` +
+            `- **Start Price**: $${statistics.startPrice.toFixed(6)}\n` +
+            `- **High Price**: $${statistics.highPrice.toFixed(6)}\n` +
+            `- **Low Price**: $${statistics.lowPrice.toFixed(6)}\n` +
+            `- **Average Price**: $${statistics.averagePrice.toFixed(6)}\n` +
+            `- **Change**: ${statistics.percentChange > 0 ? '+' : ''}${statistics.percentChange.toFixed(2)}%\n` +
+            `- **Volatility (σ)**: $${statistics.volatility.toFixed(6)}\n` +
+            `- **Total Volume**: $${(statistics.totalVolume / 1000000).toFixed(2)}M\n\n`;
+        // Include OHLCV table for 'summary' and 'detailed' formats
+        if (responseFormat === 'summary' || responseFormat === 'detailed') {
+            markdown +=
+                `## OHLCV Data (Daily)\n\n` +
+                    `| Date | Open | High | Low | Close | Volume |\n` +
+                    `|------|------|------|-----|-------|--------|\n` +
+                    ohlcvData
+                        .map((d) => {
+                        const date = new Date(d.timestamp * 1000).toISOString().split('T')[0];
+                        return `| ${date} | $${d.open.toFixed(6)} | $${d.high.toFixed(6)} | $${d.low.toFixed(6)} | $${d.close.toFixed(6)} | $${(d.volume / 1000000).toFixed(2)}M |`;
+                    })
+                        .join('\n') +
+                    `\n\n`;
+        }
+        markdown += `**Data Completeness**: ${data.transactions.pageInfo.hasNextPage ? 'More data available (truncated at 2000 points)' : 'Complete'}\n`;
+        return { markdown };
+    };
+}
+/**
+ * Create the executeGetPriceHistory function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export function createExecuteGetPriceHistory(container) {
+    return async (input) => {
+        // Calculate timestamp threshold (0 for 'all')
+        const now = Math.floor(Date.now() / 1000);
+        const timeRangeSeconds = TIME_RANGES[input.timeRange];
+        const timestampGte = timeRangeSeconds > 0 ? now - timeRangeSeconds : 0;
+        // Build query variables
+        const variables = {
+            where: {
+                vault_in: [input.vaultAddress],
+                type_in: ['TotalAssetsUpdated'],
+            },
+            orderBy: 'timestamp',
+            orderDirection: 'asc',
+            first: 1000, // GraphQL API limit: 1-1000
+        };
+        const executor = executeToolWithCache({
+            container,
+            cacheKey: (input) => `${cacheKeys.priceHistory(input.vaultAddress, input.chainId, input.timeRange)}:${input.responseFormat || 'summary'}`,
+            cacheTTL: cacheTTL.priceHistory,
+            query: PRICE_HISTORY_QUERY,
+            variables: () => variables,
+            validateResult: (data) => ({
+                valid: !!(data.transactions && data.transactions.items.length > 0),
+                message: data.transactions && data.transactions.items.length > 0
+                    ? undefined
+                    : `No price history data found for vault ${input.vaultAddress} on chain ${input.chainId} in the ${input.timeRange} time range.`,
+            }),
+            transformResult: createTransformPriceHistoryData(input, timestampGte),
+            toolName: 'get_price_history',
+        });
+        // Register cache tags for invalidation
+        const cacheKey = cacheKeys.priceHistory(input.vaultAddress, input.chainId, input.timeRange);
+        container.cacheInvalidator.register(cacheKey, [CacheTag.VAULT, CacheTag.ANALYTICS]);
+        // Execute and get result
+        const result = await executor(input);
+        // Transform JSON output to markdown text format with legal disclaimer
+        // executeToolWithCache returns JSON, but this tool should return markdown
+        if (!result.isError && result.content[0]?.type === 'text') {
+            try {
+                const output = JSON.parse(result.content[0].text);
+                result.content[0].text = output.markdown + getToolDisclaimer('price_history');
+            }
+            catch (error) {
+                // If parsing fails, content is already in the right format
+                console.error('Failed to parse price history output:', error);
+            }
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=get-price-history.js.map

package/dist/tools/get-price-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-price-history.js","sourceRoot":"","sources":["../../src/tools/get-price-history.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-transactions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * get_transactions Tool
+ *
+ * Vault transaction history with flexible filtering, pagination, and ordering.
+ * Supports all transaction types with 5-minute caching.
+ *
+ * Use cases:
+ * - Transaction history for specific vaults
+ * - Filtering by transaction type (deposits, redemptions, etc.)
+ * - Pagination and ordering support
+ * - Performance: ~300-800 tokens per query (depending on result count)
+ *
+ * Cache strategy:
+ * - 5-minute TTL for frequently changing transaction data
+ * - Cache key includes filters, pagination, and ordering
+ * - Cache hit rate target: 60-70%
+ * - Cache tags: [CacheTag.TRANSACTION] for invalidation
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type GetTransactionsInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeGetTransactions function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteGetTransactions(container: ServiceContainer): (input: GetTransactionsInput) => Promise<CallToolResult>;
+//# sourceMappingURL=get-transactions.d.ts.map

package/dist/tools/get-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transactions.d.ts","sourceRoot":"","sources":["../../src/tools/get-transactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmKxD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,cAAc,CAAC,CAoG1D"}

package/dist/tools/get-transactions.js

@@ -0,0 +1,181 @@
+/**
+ * get_transactions Tool
+ *
+ * Vault transaction history with flexible filtering, pagination, and ordering.
+ * Supports all transaction types with 5-minute caching.
+ *
+ * Use cases:
+ * - Transaction history for specific vaults
+ * - Filtering by transaction type (deposits, redemptions, etc.)
+ * - Pagination and ordering support
+ * - Performance: ~300-800 tokens per query (depending on result count)
+ *
+ * Cache strategy:
+ * - 5-minute TTL for frequently changing transaction data
+ * - Cache key includes filters, pagination, and ordering
+ * - Cache hit rate target: 60-70%
+ * - Cache tags: [CacheTag.TRANSACTION] for invalidation
+ */
+import { createHash } from 'crypto';
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import { TRANSACTIONS_QUERY } from '../graphql/queries/index.js';
+import { executeToolWithCache } from '../utils/execute-tool-with-cache.js';
+import { CacheTag } from '../core/cache-invalidation.js';
+import { cacheKeys, cacheTTL } from '../cache/index.js';
+/**
+ * Build the where filter for the transactions query
+ */
+function buildWhereFilter(input) {
+    const where = {
+        chainId_eq: input.chainId,
+        vault_in: [input.vaultAddress.toLowerCase()],
+    };
+    if (input.transactionTypes && input.transactionTypes.length > 0) {
+        where.type_in = input.transactionTypes;
+    }
+    return where;
+}
+/**
+ * Generate a hash of the filters for cache key uniqueness
+ */
+function hashFilters(filters) {
+    const hash = createHash('md5');
+    hash.update(JSON.stringify(filters));
+    return hash.digest('hex').slice(0, 8);
+}
+/**
+ * Transform raw GraphQL response into processed output
+ * Uses closure to capture input parameters
+ */
+function createTransformTransactionsData(input) {
+    return (data) => {
+        const transactions = data.transactions.items;
+        const pageInfo = data.transactions.pageInfo;
+        return {
+            vaultAddress: input.vaultAddress,
+            chainId: input.chainId,
+            transactions: transactions.map((tx) => ({
+                id: tx.id,
+                type: tx.type,
+                timestamp: tx.timestamp,
+                blockNumber: tx.blockNumber,
+                hash: tx.hash,
+                logIndex: tx.logIndex,
+                chain: {
+                    id: tx.chain.id,
+                    name: tx.chain.name,
+                },
+                vault: {
+                    id: tx.data.vault?.id || '',
+                    address: tx.data.vault?.address || input.vaultAddress.toLowerCase(),
+                    symbol: tx.data.vault?.symbol || 'UNKNOWN',
+                },
+                data: (tx.data || {}),
+            })),
+            pageInfo: {
+                hasNextPage: pageInfo.hasNextPage,
+                hasPreviousPage: pageInfo.hasPreviousPage,
+                count: pageInfo.count,
+                totalCount: pageInfo.totalCount,
+            },
+            filters: {
+                transactionTypes: input.transactionTypes,
+                orderBy: input.orderBy || 'blockNumber',
+                orderDirection: input.orderDirection || 'desc',
+            },
+        };
+    };
+}
+/**
+ * Create the executeGetTransactions function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export function createExecuteGetTransactions(container) {
+    // Map to track in-flight requests at tool level (shared across all calls)
+    const inFlightRequests = new Map();
+    return async (input) => {
+        // Extract parameters with defaults
+        const first = input.pagination?.first ?? 100;
+        const skip = input.pagination?.skip ?? 0;
+        const orderBy = input.orderBy ?? 'blockNumber';
+        const orderDirection = input.orderDirection ?? 'desc';
+        // Build where filter
+        const where = buildWhereFilter(input);
+        const filterHash = hashFilters(where);
+        // Generate cache key for deduplication (including responseFormat)
+        const responseFormat = (input.responseFormat ?? 'list');
+        const cacheKey = `${cacheKeys.transactions({
+            vaultAddress: input.vaultAddress.toLowerCase(),
+            chainId: input.chainId,
+            filterHash,
+            first,
+            skip,
+            orderBy,
+            orderDirection,
+        })}:${responseFormat}`;
+        // Check for in-flight request with same key (request deduplication)
+        const inFlight = inFlightRequests.get(cacheKey);
+        if (inFlight) {
+            return await inFlight;
+        }
+        // Create new request promise
+        const requestPromise = (async () => {
+            try {
+                const executor = executeToolWithCache({
+                    container,
+                    cacheKey: () => cacheKey,
+                    cacheTTL: cacheTTL.transactions,
+                    query: TRANSACTIONS_QUERY,
+                    variables: () => ({
+                        first,
+                        skip,
+                        where,
+                        orderBy,
+                        orderDirection,
+                    }),
+                    validateResult: (data) => {
+                        // Missing transactions object entirely = malformed response (error)
+                        if (!data.transactions) {
+                            return {
+                                valid: false,
+                                message: `No transaction data found for vault ${input.vaultAddress}`,
+                                isError: true, // Malformed response structure
+                            };
+                        }
+                        // Null/undefined items array = malformed response (error)
+                        if (data.transactions.items === null || data.transactions.items === undefined) {
+                            return {
+                                valid: false,
+                                message: `No transaction data found for vault ${input.vaultAddress}`,
+                                isError: true, // Malformed response structure
+                            };
+                        }
+                        // Empty array OR has items = valid response (transform will handle empty arrays)
+                        return { valid: true };
+                    },
+                    transformResult: createTransformTransactionsData(input),
+                    toolName: 'get_transactions',
+                });
+                // Register cache tags for invalidation
+                container.cacheInvalidator.register(cacheKey, [CacheTag.TRANSACTION]);
+                const result = await executor(input);
+                // Add legal disclaimer to output
+                if (!result.isError && result.content[0]?.type === 'text') {
+                    result.content[0].text = result.content[0].text + getToolDisclaimer('get_transactions');
+                }
+                return result;
+            }
+            finally {
+                // Clean up in-flight request regardless of success/failure
+                inFlightRequests.delete(cacheKey);
+            }
+        })();
+        // Store in-flight request
+        inFlightRequests.set(cacheKey, requestPromise);
+        // Return the promise
+        return await requestPromise;
+    };
+}
+//# sourceMappingURL=get-transactions.js.map

package/dist/tools/get-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-transactions.js","sourceRoot":"","sources":["../../src/tools/get-transactions.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool Registry (DEPRECATED)
+ *
+ * This file is deprecated. Use src/tools/registry.ts instead.
+ * Kept for backward compatibility only.
+ */
+import { CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * @deprecated Use ToolDefinition from './registry.js' instead
+ */
+export type { ToolDefinition as Tool } from './registry.js';
+/**
+ * @deprecated Use TOOL_REGISTRY from './registry.js' instead
+ * Tool array kept for backward compatibility only
+ */
+export { TOOL_REGISTRY as tools } from './registry.js';
+/**
+ * @deprecated Tool handlers are now managed by the registry
+ * Use registerTools() from './registry.js' instead
+ */
+/**
+ * @deprecated Use registerTools() from './registry.js' instead
+ * This function is kept for backward compatibility only
+ */
+export declare function handleToolCall(request: CallToolRequest): CallToolResult;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAErF;;GAEG;AACH,YAAY,EAAE,cAAc,IAAI,IAAI,EAAE,MAAM,eAAe,CAAC;AAE5D;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAYvE"}

package/dist/tools/index.js

@@ -0,0 +1,32 @@
+/**
+ * Tool Registry (DEPRECATED)
+ *
+ * This file is deprecated. Use src/tools/registry.ts instead.
+ * Kept for backward compatibility only.
+ */
+/**
+ * @deprecated Use TOOL_REGISTRY from './registry.js' instead
+ * Tool array kept for backward compatibility only
+ */
+export { TOOL_REGISTRY as tools } from './registry.js';
+/**
+ * @deprecated Tool handlers are now managed by the registry
+ * Use registerTools() from './registry.js' instead
+ */
+/**
+ * @deprecated Use registerTools() from './registry.js' instead
+ * This function is kept for backward compatibility only
+ */
+export function handleToolCall(request) {
+    const toolName = request.params.name;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Tool "${toolName}" should be called via the MCP server. Use registerTools() from './registry.js'.`,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;GAGG;AACH,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAErC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,QAAQ,kFAAkF;aAC1G;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/tools/optimize-portfolio.d.ts

@@ -0,0 +1,37 @@
+/**
+ * optimize_portfolio Tool
+ *
+ * Portfolio optimization with rebalancing recommendations using parallel vault queries.
+ * Analyzes current holdings and provides optimal allocation strategy based on
+ * per-vault historical data (price history and performance metrics).
+ *
+ * Implementation:
+ * - Executes N parallel GraphQL queries (one per vault) using Promise.all
+ * - Each vault gets up to 1000 transactions of historical data
+ * - Processes per-vault price history for accurate volatility calculation
+ * - Uses per-vault performance data for expected APR estimation
+ *
+ * Use cases:
+ * - Portfolio rebalancing and optimization
+ * - Risk-adjusted allocation strategies (equal_weight, risk_parity, max_sharpe, min_variance)
+ * - Diversification improvement
+ * - Performance enhancement through optimal weighting
+ * - Performance: ~800-1200 tokens per optimization (scales with vault count)
+ *
+ * Cache strategy:
+ * - 30-minute TTL (balances freshness with stability)
+ * - Cache key: portfolio_optimization:{chainId}:{vaultAddresses}:{strategy}
+ * - Cache hit rate target: 70-80%
+ * - Cache tags: [CacheTag.PORTFOLIO, CacheTag.ANALYTICS] for invalidation
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { OptimizePortfolioInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeOptimizePortfolio function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteOptimizePortfolio(container: ServiceContainer): (input: OptimizePortfolioInput) => Promise<CallToolResult>;
+//# sourceMappingURL=optimize-portfolio.d.ts.map

package/dist/tools/optimize-portfolio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-portfolio.d.ts","sourceRoot":"","sources":["../../src/tools/optimize-portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAUhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkexD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,cAAc,CAAC,CA0F5D"}