@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/tools/search-vaults.d.ts

@@ -0,0 +1,40 @@
+/**
+ * search_vaults Tool
+ *
+ * Vault discovery and filtering with advanced search capabilities.
+ * Supports 20+ filter options with pagination and 10-minute caching.
+ *
+ * Use cases:
+ * - Discover vaults by asset, chain, TVL, curator
+ * - Filter vaults with complex criteria combinations
+ * - Paginate through large result sets
+ * - Sort by TVL, address, chainId, or id
+ * - Performance: ~300-500 tokens per page of results
+ *
+ * Cache strategy:
+ * - 10-minute TTL for balance between freshness and performance
+ * - Cache key: search:{MD5 hash of filters}:{pagination}:{sort}
+ * - Repeated searches with same filters hit cache
+ * - Cache hit rate target: 70-80%
+ * - Cache tags: [CacheTag.VAULT] for invalidation
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { SearchVaultsInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeSearchVaults function with DI container
+ *
+ * This factory function demonstrates the moderate complexity pattern with optimizations:
+ * 1. Custom cache key generation with MD5 hashing
+ * 2. Complex variable mapping with filter transformation
+ * 3. Custom validation for empty results
+ * 4. Cache tag registration for invalidation
+ * 5. NEW: Dynamic fragment selection based on responseFormat
+ * 6. NEW: Fragment-level caching for individual vaults (enables data reuse)
+ * 7. NEW: maxResults override for pagination.first
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteSearchVaults(container: ServiceContainer): (input: SearchVaultsInput) => Promise<CallToolResult>;
+//# sourceMappingURL=search-vaults.d.ts.map

package/dist/tools/search-vaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-vaults.d.ts","sourceRoot":"","sources":["../../src/tools/search-vaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiHxD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,cAAc,CAAC,CA4FvD"}

package/dist/tools/search-vaults.js

@@ -0,0 +1,184 @@
+/**
+ * search_vaults Tool
+ *
+ * Vault discovery and filtering with advanced search capabilities.
+ * Supports 20+ filter options with pagination and 10-minute caching.
+ *
+ * Use cases:
+ * - Discover vaults by asset, chain, TVL, curator
+ * - Filter vaults with complex criteria combinations
+ * - Paginate through large result sets
+ * - Sort by TVL, address, chainId, or id
+ * - Performance: ~300-500 tokens per page of results
+ *
+ * Cache strategy:
+ * - 10-minute TTL for balance between freshness and performance
+ * - Cache key: search:{MD5 hash of filters}:{pagination}:{sort}
+ * - Repeated searches with same filters hit cache
+ * - Cache hit rate target: 70-80%
+ * - Cache tags: [CacheTag.VAULT] for invalidation
+ */
+import { createHash } from 'crypto';
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import { createSearchVaultsQuery } from '../graphql/queries/search.queries.js';
+import { executeToolWithCache } from '../utils/execute-tool-with-cache.js';
+import { CacheTag } from '../core/cache-invalidation.js';
+import { cacheKeys, cacheTTL } from '../cache/index.js';
+import { generateCacheKey } from '../cache/index.js';
+/**
+ * Convert snake_case filters to GraphQL VaultFilterInput format
+ * Handles nested state filters by flattening them
+ */
+function buildGraphQLFilters(filters) {
+    if (!filters) {
+        return {};
+    }
+    const graphqlFilters = {};
+    // Direct pass-through filters (no transformation needed)
+    const directFilters = [
+        'assetSymbol_eq',
+        'assetSymbol_in',
+        'assetId_eq',
+        'assetId_in',
+        'chainId_eq',
+        'chainId_in',
+        'curatorIds_contains',
+        'curatorIds_contains_any',
+        'isVisible_eq',
+        'address_eq',
+        'address_in',
+        'symbol_eq',
+        'symbol_in',
+        'integratorId_eq',
+        'integratorId_in',
+    ];
+    for (const key of directFilters) {
+        if (key in filters && filters[key] !== undefined) {
+            graphqlFilters[key] = filters[key];
+        }
+    }
+    // Handle nested state filters
+    // Note: Backend may not support these - will be tested in Phase 2.5
+    if (filters.state_totalAssetsUsd_gte !== undefined) {
+        graphqlFilters.state_totalAssetsUsd_gte = filters.state_totalAssetsUsd_gte;
+    }
+    if (filters.state_totalAssetsUsd_lte !== undefined) {
+        graphqlFilters.state_totalAssetsUsd_lte = filters.state_totalAssetsUsd_lte;
+    }
+    return graphqlFilters;
+}
+/**
+ * Generate MD5 hash of filter object for cache key
+ * Ensures consistent cache keys for identical filter combinations
+ */
+function hashFilters(filters) {
+    if (!filters || Object.keys(filters).length === 0) {
+        return 'empty';
+    }
+    const sortedFilters = Object.keys(filters)
+        .sort()
+        .reduce((acc, key) => {
+        const typedKey = key;
+        const value = filters[typedKey];
+        if (value !== undefined) {
+            // Safe assignment: we know the key exists in filters and we're assigning its value
+            acc[typedKey] = value;
+        }
+        return acc;
+    }, {});
+    const filterString = JSON.stringify(sortedFilters);
+    return createHash('md5').update(filterString).digest('hex');
+}
+/**
+ * Create the executeSearchVaults function with DI container
+ *
+ * This factory function demonstrates the moderate complexity pattern with optimizations:
+ * 1. Custom cache key generation with MD5 hashing
+ * 2. Complex variable mapping with filter transformation
+ * 3. Custom validation for empty results
+ * 4. Cache tag registration for invalidation
+ * 5. NEW: Dynamic fragment selection based on responseFormat
+ * 6. NEW: Fragment-level caching for individual vaults (enables data reuse)
+ * 7. NEW: maxResults override for pagination.first
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export function createExecuteSearchVaults(container) {
+    return async (input) => {
+        // Apply maxResults to pagination.first (overrides user-provided pagination.first)
+        const effectiveFirst = Number(input.maxResults) || Number(input.pagination?.first) || 100;
+        const pagination = {
+            first: Math.min(effectiveFirst, 100), // Enforce max 100
+            skip: Number(input.pagination?.skip) || 0,
+        };
+        // Determine response format
+        const responseFormat = input.responseFormat === 'summary'
+            ? 'summary'
+            : input.responseFormat === 'full'
+                ? 'full'
+                : 'list';
+        // Generate cache key including responseFormat
+        const filterHash = hashFilters(input.filters);
+        const cacheKey = `${cacheKeys.searchVaults({ filterHash })}:${pagination.first}:${pagination.skip}:${input.orderBy}:${input.orderDirection}:${responseFormat}`;
+        // Register cache tags for invalidation
+        container.cacheInvalidator.register(cacheKey, [CacheTag.VAULT]);
+        // Create executor with dynamic query based on responseFormat
+        const query = createSearchVaultsQuery(responseFormat);
+        const executor = executeToolWithCache({
+            container,
+            cacheKey: () => cacheKey,
+            cacheTTL: cacheTTL.searchResults,
+            query,
+            variables: () => {
+                const whereClause = buildGraphQLFilters(input.filters);
+                return {
+                    first: pagination.first,
+                    skip: pagination.skip,
+                    orderBy: input.orderBy,
+                    orderDirection: input.orderDirection,
+                    where: Object.keys(whereClause).length > 0 ? whereClause : undefined,
+                };
+            },
+            validateResult: (data) => ({
+                valid: !!(data.vaults && data.vaults.items.length > 0),
+                message: data.vaults && data.vaults.items.length > 0
+                    ? undefined
+                    : 'No vaults found matching the specified criteria.',
+            }),
+            toolName: 'search_vaults',
+        });
+        // Execute query
+        const result = await executor(input);
+        // NEW: Fragment-level caching - cache each vault individually for reuse
+        // This enables vault_data tool to reuse vaults from search results
+        if (!result.isError && result.content[0]?.type === 'text') {
+            try {
+                const responseData = JSON.parse(result.content[0].text);
+                if (responseData.vaults?.items && Array.isArray(responseData.vaults.items)) {
+                    // Cache each vault individually with vault-specific key
+                    const vaults = responseData.vaults.items;
+                    vaults.forEach((vault) => {
+                        if (vault.address && vault.chain?.id) {
+                            const vaultCacheKey = generateCacheKey(CacheTag.VAULT, {
+                                address: String(vault.address),
+                                chainId: Number(vault.chain.id),
+                            });
+                            container.cache.set(vaultCacheKey, vault, cacheTTL.vaultData);
+                        }
+                    });
+                }
+            }
+            catch (error) {
+                // If parsing fails, just return the result without fragment caching
+                // This is a non-critical optimization
+            }
+        }
+        // Add legal disclaimer to output
+        if (!result.isError && result.content[0]?.type === 'text') {
+            result.content[0].text = result.content[0].text + getToolDisclaimer('search_vaults');
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=search-vaults.js.map

package/dist/tools/search-vaults.js.map

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

package/dist/tools/simulate-vault.d.ts

@@ -0,0 +1,80 @@
+/**
+ * simulate_vault Tool
+ *
+ * Simulates vault operations with new total assets to model deposit/withdrawal scenarios.
+ * Provides protocol-accurate fee calculations, APR impact analysis, and settlement requirements.
+ *
+ * Use cases:
+ * - Simulate deposit/withdrawal impact on share price
+ * - Model fee accrual scenarios
+ * - Analyze settlement requirements
+ * - Validate protocol calculations
+ * - Performance: ~400-600 tokens per simulation
+ *
+ * Cache strategy:
+ * - No caching (simulations are specific to input parameters and require fresh vault state)
+ *
+ * WHY NO CACHING?
+ * This tool is intentionally non-cached because:
+ * 1. Simulations are parameter-specific (newTotalAssets varies widely)
+ * 2. Vault state changes frequently (stale simulations are misleading)
+ * 3. One-time use simulations (rarely re-requested with same parameters)
+ * 4. SDK-based calculations (fast execution, no benefit from caching)
+ *
+ * @module tools/simulate-vault
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Input schema for simulate_vault tool
+ */
+export declare const simulateVaultInputSchema: z.ZodObject<{
+    vaultAddress: z.ZodString;
+    chainId: z.ZodNumber;
+    newTotalAssets: z.ZodString;
+    settleDeposit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeAPRCalculations: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    vaultAddress: string;
+    chainId: number;
+    settleDeposit: boolean;
+    newTotalAssets: string;
+    includeAPRCalculations: boolean;
+}, {
+    vaultAddress: string;
+    chainId: number;
+    newTotalAssets: string;
+    settleDeposit?: boolean | undefined;
+    includeAPRCalculations?: boolean | undefined;
+}>;
+export type SimulateVaultInput = z.infer<typeof simulateVaultInputSchema>;
+/**
+ * JSON schema for tool registration
+ */
+export declare const simulateVaultJsonSchema: import("zod-to-json-schema").JsonSchema7Type & {
+    $schema?: string | undefined;
+    definitions?: {
+        [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+    } | undefined;
+};
+/**
+ * Create the executeSimulateVault function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ *
+ * @example
+ * ```typescript
+ * const executor = createExecuteSimulateVault(container);
+ * const result = await executor({
+ *   vaultAddress: '0x1234...',
+ *   chainId: 42161,
+ *   newTotalAssets: '2000000000',
+ *   settleDeposit: true,
+ *   includeAPRCalculations: true
+ * });
+ * ```
+ */
+export declare function createExecuteSimulateVault(container: ServiceContainer): (input: SimulateVaultInput) => Promise<CallToolResult>;
+//# sourceMappingURL=simulate-vault.d.ts.map

package/dist/tools/simulate-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate-vault.d.ts","sourceRoot":"","sources":["../../src/tools/simulate-vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAgBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;CAGnC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,cAAc,CAAC,CA+QxD"}

package/dist/tools/simulate-vault.js

@@ -0,0 +1,281 @@
+/**
+ * simulate_vault Tool
+ *
+ * Simulates vault operations with new total assets to model deposit/withdrawal scenarios.
+ * Provides protocol-accurate fee calculations, APR impact analysis, and settlement requirements.
+ *
+ * Use cases:
+ * - Simulate deposit/withdrawal impact on share price
+ * - Model fee accrual scenarios
+ * - Analyze settlement requirements
+ * - Validate protocol calculations
+ * - Performance: ~400-600 tokens per simulation
+ *
+ * Cache strategy:
+ * - No caching (simulations are specific to input parameters and require fresh vault state)
+ *
+ * WHY NO CACHING?
+ * This tool is intentionally non-cached because:
+ * 1. Simulations are parameter-specific (newTotalAssets varies widely)
+ * 2. Vault state changes frequently (stale simulations are misleading)
+ * 3. One-time use simulations (rarely re-requested with same parameters)
+ * 4. SDK-based calculations (fast execution, no benefit from caching)
+ *
+ * @module tools/simulate-vault
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { getToolDisclaimer } from '../utils/disclaimers.js';
+import { simulateVaultManagement } from '../sdk/simulation-service.js';
+import { transformPeriodSummariesToAPRData } from '../sdk/apr-service.js';
+import { formatBigInt, safeBigIntStringify } from '../sdk/math-utils.js';
+import { calculatePricePerShare } from '../sdk/vault-utils.js';
+import { handleToolError } from '../utils/tool-error-handler.js';
+import { GET_PERIOD_SUMMARIES_QUERY } from '../graphql/queries/index.js';
+/**
+ * Input schema for simulate_vault tool
+ */
+export const simulateVaultInputSchema = z.object({
+    vaultAddress: z.string().regex(/^0x[a-fA-F0-9]{40}$/, 'Invalid Ethereum address format'),
+    chainId: z.number().int().positive('Chain ID must be a positive integer'),
+    newTotalAssets: z
+        .string()
+        .regex(/^\d+$/, 'New total assets must be a positive integer string (wei)'),
+    settleDeposit: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Whether to settle pending deposits'),
+    includeAPRCalculations: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Include APR analysis in results'),
+});
+/**
+ * JSON schema for tool registration
+ */
+export const simulateVaultJsonSchema = zodToJsonSchema(simulateVaultInputSchema, 'simulateVaultInput');
+/**
+ * Create the executeSimulateVault function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ *
+ * @example
+ * ```typescript
+ * const executor = createExecuteSimulateVault(container);
+ * const result = await executor({
+ *   vaultAddress: '0x1234...',
+ *   chainId: 42161,
+ *   newTotalAssets: '2000000000',
+ *   settleDeposit: true,
+ *   includeAPRCalculations: true
+ * });
+ * ```
+ */
+export function createExecuteSimulateVault(container) {
+    return async (input) => {
+        try {
+            const { vaultAddress, chainId, newTotalAssets, settleDeposit, includeAPRCalculations } = input;
+            // 1. Fetch vault data
+            const vaultQuery = `
+      query GetVault($vaultAddress: Address!, $chainId: Int!) {
+        vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {
+          address
+          name
+          symbol
+          decimals
+          asset {
+            address
+            symbol
+            name
+            decimals
+          }
+          state {
+            totalSupply
+            totalAssets
+            highWaterMark
+            lastFeeTime
+            managementFee
+            performanceFee
+            version
+            safeAssetBalance
+            pendingSiloBalances {
+              assets
+              shares
+            }
+            pendingSettlement {
+              assets
+              shares
+            }
+          }
+          chain {
+            id
+          }
+        }
+      }
+    `;
+            const vaultData = await container.graphqlClient.request(vaultQuery, {
+                vaultAddress,
+                chainId,
+            });
+            if (!vaultData?.vault) {
+                throw new Error(`Vault not found: ${vaultAddress} on chain ${chainId}`);
+            }
+            const vault = vaultData.vault;
+            // 2. Optionally fetch APR data
+            let aprData;
+            if (includeAPRCalculations) {
+                try {
+                    const periodSummariesData = await container.graphqlClient.request(GET_PERIOD_SUMMARIES_QUERY, {
+                        where: {
+                            vault_in: [vaultAddress],
+                            chainId_eq: chainId,
+                            type_in: ['PeriodSummary'],
+                        },
+                        orderBy: 'timestamp',
+                        orderDirection: 'asc',
+                        first: 1000,
+                    });
+                    if (periodSummariesData?.transactions?.items?.length > 0) {
+                        // Extract PeriodSummary data from transaction items
+                        const periodSummaries = periodSummariesData.transactions.items.map((tx) => ({
+                            timestamp: tx.timestamp,
+                            totalAssetsAtStart: tx.data.totalAssetsAtStart,
+                            totalSupplyAtStart: tx.data.totalSupplyAtStart,
+                        }));
+                        aprData = transformPeriodSummariesToAPRData(periodSummaries, vault);
+                    }
+                }
+                catch (error) {
+                    // Non-fatal: proceed without APR data
+                    console.warn('Failed to fetch APR data:', error);
+                }
+            }
+            // 3. Execute simulation
+            const newTotalAssetsBigInt = BigInt(newTotalAssets);
+            const simulationResult = simulateVaultManagement(vault, newTotalAssetsBigInt, aprData, settleDeposit);
+            // 4. Format response
+            const vaultDecimals = vault.decimals ?? 18;
+            const assetDecimals = vault.asset.decimals;
+            const currentTotalAssets = BigInt(vault.state.totalAssets);
+            const currentTotalSupply = BigInt(vault.state.totalSupply);
+            // Calculate price per share impact using Lagoon SDK
+            let priceImpactPercentage = 0;
+            let priceImpactAbsolute = BigInt(0);
+            let currentPricePerShare = BigInt(0);
+            let newPricePerShare = BigInt(0);
+            if (currentTotalSupply > 0n && simulationResult.totalSupply > 0n) {
+                // Calculate prices using SDK (returns price in asset decimals)
+                currentPricePerShare = calculatePricePerShare(currentTotalAssets, currentTotalSupply, vaultDecimals, assetDecimals);
+                newPricePerShare = calculatePricePerShare(simulationResult.totalAssets, simulationResult.totalSupply, vaultDecimals, assetDecimals);
+                priceImpactAbsolute = newPricePerShare - currentPricePerShare;
+                priceImpactPercentage =
+                    currentPricePerShare > 0n
+                        ? Number((priceImpactAbsolute * 10000n) / currentPricePerShare) / 100
+                        : 0;
+            }
+            else if (simulationResult.totalSupply > 0n) {
+                // New vault case - no current price to compare
+                newPricePerShare = calculatePricePerShare(simulationResult.totalAssets, simulationResult.totalSupply, vaultDecimals, assetDecimals);
+                currentPricePerShare = BigInt(10 ** assetDecimals); // 1.0 in asset decimals
+                priceImpactAbsolute = BigInt(0);
+                priceImpactPercentage = 0;
+            }
+            // Build response
+            const response = {
+                simulation: {
+                    vaultAddress,
+                    chainId,
+                    timestamp: Date.now(),
+                    sdkVersion: '@lagoon-protocol/v0-computation@0.12.0',
+                },
+                currentState: {
+                    totalAssets: vault.state.totalAssets,
+                    totalAssetsFormatted: formatBigInt(currentTotalAssets, assetDecimals),
+                    totalSupply: vault.state.totalSupply,
+                    totalSupplyFormatted: formatBigInt(currentTotalSupply, vaultDecimals),
+                    pricePerShare: (currentPricePerShare ?? BigInt(0)).toString(),
+                    pricePerShareFormatted: formatBigInt(currentPricePerShare ?? BigInt(0), assetDecimals),
+                    managementFee: vault.state.managementFee,
+                    performanceFee: vault.state.performanceFee,
+                    highWaterMark: vault.state.highWaterMark,
+                },
+                simulatedState: {
+                    totalAssets: simulationResult.totalAssets?.toString() ?? vault.state.totalAssets,
+                    totalAssetsFormatted: formatBigInt(simulationResult.totalAssets ?? BigInt(vault.state.totalAssets), assetDecimals),
+                    totalSupply: simulationResult.totalSupply?.toString() ?? vault.state.totalSupply,
+                    totalSupplyFormatted: formatBigInt(simulationResult.totalSupply ?? BigInt(vault.state.totalSupply), vaultDecimals),
+                    pricePerShare: (newPricePerShare ?? BigInt(0)).toString(),
+                    pricePerShareFormatted: formatBigInt(newPricePerShare ?? BigInt(0), assetDecimals),
+                    feesAccrued: {
+                        management: simulationResult.managementFees?.inAssets?.toString() ?? '0',
+                        managementFormatted: formatBigInt(simulationResult.managementFees?.inAssets ?? 0n, assetDecimals),
+                        performance: simulationResult.performanceFees?.inAssets?.toString() ?? '0',
+                        performanceFormatted: formatBigInt(simulationResult.performanceFees?.inAssets ?? 0n, assetDecimals),
+                        total: ((simulationResult.managementFees?.inAssets ?? 0n) +
+                            (simulationResult.performanceFees?.inAssets ?? 0n)).toString(),
+                        totalFormatted: formatBigInt((simulationResult.managementFees?.inAssets ?? 0n) +
+                            (simulationResult.performanceFees?.inAssets ?? 0n), assetDecimals),
+                    },
+                    sharePriceImpact: {
+                        absolute: (priceImpactAbsolute ?? BigInt(0)).toString(),
+                        absoluteFormatted: formatBigInt(priceImpactAbsolute ?? BigInt(0), assetDecimals),
+                        percentage: priceImpactPercentage,
+                        direction: priceImpactAbsolute > 0n
+                            ? 'increase'
+                            : priceImpactAbsolute < 0n
+                                ? 'decrease'
+                                : 'unchanged',
+                    },
+                },
+                settlementAnalysis: {
+                    settleDeposit,
+                    assetsInSafe: vault.state.safeAssetBalance || '0',
+                    pendingSiloBalances: {
+                        assets: vault.state.pendingSiloBalances?.assets || '0',
+                        shares: vault.state.pendingSiloBalances?.shares || '0',
+                    },
+                    pendingSettlement: {
+                        assets: vault.state.pendingSettlement?.assets || '0',
+                        shares: vault.state.pendingSettlement?.shares || '0',
+                    },
+                },
+                ...(includeAPRCalculations &&
+                    aprData && {
+                    aprAnalysis: {
+                        method: 'Lagoon SDK v0.10.1 (protocol-accurate)',
+                        dataSource: 'Lagoon GraphQL period summaries',
+                        ...(aprData.thirtyDay && {
+                            thirtyDay: {
+                                timestamp: aprData.thirtyDay.timestamp,
+                                pricePerShare: aprData.thirtyDay.pricePerShare?.toString() ?? '0',
+                                pricePerShareFormatted: formatBigInt(aprData.thirtyDay.pricePerShare ?? 0n, assetDecimals),
+                            },
+                        }),
+                        ...(aprData.inception && {
+                            inception: {
+                                timestamp: aprData.inception.timestamp,
+                                pricePerShare: aprData.inception.pricePerShare?.toString() ?? '0',
+                                pricePerShareFormatted: formatBigInt(aprData.inception.pricePerShare ?? 0n, assetDecimals),
+                            },
+                        }),
+                    },
+                }),
+            };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: safeBigIntStringify(response) + getToolDisclaimer('simulate_vault'),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error, 'simulate_vault');
+        }
+    };
+}
+//# sourceMappingURL=simulate-vault.js.map

package/dist/tools/simulate-vault.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * get_user_portfolio Tool
+ *
+ * Fetch user's complete portfolio across all chains with 5-minute caching.
+ * Optimized for cross-chain portfolio aggregation using single query.
+ *
+ * Use cases:
+ * - Multi-chain portfolio analysis
+ * - User position tracking across all supported chains
+ * - Portfolio value aggregation
+ * - Performance: ~500-1000 tokens per user (depending on position count)
+ *
+ * Cache strategy:
+ * - 5-minute TTL for frequently changing user positions
+ * - Cache key: portfolio:{address}
+ * - Single query returns all chains at once
+ * - Cache hit rate target: 70-80%
+ * - Cache tags: [CacheTag.PORTFOLIO] for invalidation
+ */
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { GetUserPortfolioInput } from '../utils/validators.js';
+import { ServiceContainer } from '../core/container.js';
+/**
+ * Create the executeGetUserPortfolio function with DI container
+ *
+ * @param container - Service container with dependencies
+ * @returns Configured tool executor function
+ */
+export declare function createExecuteGetUserPortfolio(container: ServiceContainer): (input: GetUserPortfolioInput) => Promise<CallToolResult>;
+//# sourceMappingURL=user-portfolio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-portfolio.d.ts","sourceRoot":"","sources":["../../src/tools/user-portfolio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAuHxD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,gBAAgB,GAC1B,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,cAAc,CAAC,CAiF3D"}