@lagoon-protocol/lagoon-mcp 0.1.0

package/dist/graphql/queries/export.queries.js

@@ -0,0 +1,202 @@
+/**
+ * Export Queries
+ *
+ * GraphQL queries for data export operations.
+ * Supports exporting vaults, transactions, price history, and performance metrics.
+ */
+import { VAULT_FRAGMENT, TRANSACTION_BASE_FRAGMENT } from '../fragments/index.js';
+/**
+ * GraphQL query for vault data export
+ *
+ * Fetches complete vault data for CSV or JSON export.
+ *
+ * Used by: export_data tool (dataType: 'vaults')
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<{ vaults: VaultData[] }>(
+ *   EXPORT_VAULTS_QUERY,
+ *   { addresses: ['0x...', '0x...'], chainId: 1 }
+ * );
+ * ```
+ */
+export const EXPORT_VAULTS_QUERY = `
+  query ExportVaults($addresses: [String!]!, $chainId: Int!) {
+    vaults(where: { address_in: $addresses, chainId_eq: $chainId }) {
+      items {
+        ...VaultFragment
+      }
+    }
+  }
+  ${VAULT_FRAGMENT}
+`;
+/**
+ * GraphQL query for transaction export
+ *
+ * Fetches transaction data with essential fields for export.
+ * Includes deposit, redeem, and request transactions.
+ *
+ * Used by: export_data tool (dataType: 'transactions')
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<TransactionsExportResponse>(
+ *   EXPORT_TRANSACTIONS_QUERY,
+ *   { vault_in: ['0x...'], chainId: 1, first: 1000 }
+ * );
+ * ```
+ */
+export const EXPORT_TRANSACTIONS_QUERY = `
+  query ExportTransactions($vault_in: [Address!]!, $chainId: Int!, $first: Int!) {
+    transactions(
+      where: { vault_in: $vault_in, chainId_eq: $chainId },
+      orderBy: timestamp,
+      orderDirection: desc,
+      first: $first
+    ) {
+      items {
+        ...TransactionBaseFragment
+        data {
+          ... on SettleDeposit {
+            assetsDeposited
+            assetsDepositedUsd
+            sharesMinted
+            vault {
+              id
+              address
+              symbol
+              decimals
+              asset {
+                decimals
+              }
+            }
+          }
+          ... on SettleRedeem {
+            assetsWithdrawed
+            assetsWithdrawedUsd
+            sharesBurned
+            vault {
+              id
+              address
+              symbol
+              decimals
+              asset {
+                decimals
+              }
+            }
+          }
+          ... on DepositRequest {
+            owner
+            assets
+            assetsUsd
+            vault {
+              id
+              address
+              symbol
+              decimals
+              asset {
+                decimals
+              }
+            }
+          }
+          ... on RedeemRequest {
+            owner
+            shares
+            sharesUsd
+            vault {
+              id
+              address
+              symbol
+              decimals
+              asset {
+                decimals
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+  ${TRANSACTION_BASE_FRAGMENT}
+`;
+/**
+ * GraphQL query for price history export
+ *
+ * Fetches historical price data for OHLCV export.
+ *
+ * Used by: export_data tool (dataType: 'price_history')
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<PriceHistoryExportResponse>(
+ *   EXPORT_PRICE_HISTORY_QUERY,
+ *   { vault_in: ['0x...'], first: 1000 }
+ * );
+ * ```
+ */
+export const EXPORT_PRICE_HISTORY_QUERY = `
+  query ExportPriceHistory($vault_in: [Address!]!, $first: Int!) {
+    transactions(
+      where: { vault_in: $vault_in, type_in: [TotalAssetsUpdated] },
+      orderBy: timestamp,
+      orderDirection: asc,
+      first: $first
+    ) {
+      items {
+        timestamp
+        data {
+          ... on TotalAssetsUpdated {
+            totalAssets
+            totalAssetsUsd
+            totalSupply
+            vault {
+              id
+              address
+              symbol
+              decimals
+              asset {
+                decimals
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * GraphQL query for performance metrics export
+ *
+ * Fetches TVL history for performance metric export.
+ *
+ * Used by: export_data tool (dataType: 'performance')
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<PerformanceExportResponse>(
+ *   EXPORT_PERFORMANCE_QUERY,
+ *   { vault_in: ['0x...'], first: 1000 }
+ * );
+ * ```
+ */
+export const EXPORT_PERFORMANCE_QUERY = `
+  query ExportPerformance($vault_in: [Address!]!, $first: Int!) {
+    transactions(
+      where: { vault_in: $vault_in, type_in: [TotalAssetsUpdated] },
+      orderBy: timestamp,
+      orderDirection: asc,
+      first: $first
+    ) {
+      items {
+        timestamp
+        blockNumber
+        data {
+          ... on TotalAssetsUpdated {
+            totalAssetsUsd
+          }
+        }
+      }
+    }
+  }
+`;
+//# sourceMappingURL=export.queries.js.map

package/dist/graphql/queries/export.queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/export.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;IAQ/B,cAAc;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuErC,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC"}

package/dist/graphql/queries/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * GraphQL Queries Index
+ *
+ * Central export point for all GraphQL queries.
+ * Import from this file for convenience: `import { GET_VAULT_DATA_QUERY } from '../graphql/queries'`
+ */
+export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, } from './vault.queries.js';
+export { TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY } from './transaction.queries.js';
+export { GET_VAULT_PERFORMANCE_QUERY, GET_PERIOD_SUMMARIES_QUERY } from './performance.queries.js';
+export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, type PortfolioResponseFormat, SINGLE_VAULT_OPTIMIZATION_QUERY, PORTFOLIO_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
+export { RISK_ANALYSIS_QUERY } from './risk.queries.js';
+export { YIELD_PREDICTION_QUERY, createYieldPredictionQuery, type PredictionResponseFormat, } from './prediction.queries.js';
+export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QUERY, EXPORT_PERFORMANCE_QUERY, } from './export.queries.js';
+export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, type SearchVaultsResponseFormat, } from './search.queries.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/graphql/queries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGnG,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC"}

package/dist/graphql/queries/index.js

@@ -0,0 +1,23 @@
+/**
+ * GraphQL Queries Index
+ *
+ * Central export point for all GraphQL queries.
+ * Import from this file for convenience: `import { GET_VAULT_DATA_QUERY } from '../graphql/queries'`
+ */
+// Vault Queries
+export { GET_VAULT_DATA_QUERY, GET_VAULT_FOR_APR_QUERY, COMPARE_VAULTS_QUERY, } from './vault.queries.js';
+// Transaction Queries
+export { TRANSACTIONS_QUERY, PRICE_HISTORY_QUERY } from './transaction.queries.js';
+// Performance Queries
+export { GET_VAULT_PERFORMANCE_QUERY, GET_PERIOD_SUMMARIES_QUERY } from './performance.queries.js';
+// Portfolio Queries
+export { GET_USER_PORTFOLIO_QUERY, createGetUserPortfolioQuery, SINGLE_VAULT_OPTIMIZATION_QUERY, PORTFOLIO_OPTIMIZATION_QUERY, } from './portfolio.queries.js';
+// Risk Queries
+export { RISK_ANALYSIS_QUERY } from './risk.queries.js';
+// Prediction Queries
+export { YIELD_PREDICTION_QUERY, createYieldPredictionQuery, } from './prediction.queries.js';
+// Export Queries
+export { EXPORT_VAULTS_QUERY, EXPORT_TRANSACTIONS_QUERY, EXPORT_PRICE_HISTORY_QUERY, EXPORT_PERFORMANCE_QUERY, } from './export.queries.js';
+// Search Queries
+export { SEARCH_VAULTS_QUERY, createSearchVaultsQuery, } from './search.queries.js';
+//# sourceMappingURL=index.js.map

package/dist/graphql/queries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/queries/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,sBAAsB;AACtB,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEnG,oBAAoB;AACpB,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAE3B,+BAA+B,EAC/B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GAExB,MAAM,qBAAqB,CAAC"}

package/dist/graphql/queries/performance.queries.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Performance Queries
+ *
+ * GraphQL queries for vault performance tracking and historical metrics.
+ * Includes vault performance analysis and period summaries for APR calculations.
+ */
+/**
+ * Vault performance GraphQL query
+ *
+ * Fetches transactions with TotalAssetsUpdated and PeriodSummary data for
+ * historical metrics and trend analysis. Provides time-series performance data.
+ *
+ * Used by: get_vault_performance tool
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<VaultPerformanceResponse>(
+ *   GET_VAULT_PERFORMANCE_QUERY,
+ *   {
+ *     where: {
+ *       vault_in: ['0x...'],
+ *       type_in: ['TotalAssetsUpdated', 'PeriodSummary']
+ *     },
+ *     orderBy: 'timestamp',
+ *     orderDirection: 'asc',
+ *     first: 1000
+ *   }
+ * );
+ * ```
+ */
+export declare const GET_VAULT_PERFORMANCE_QUERY = "\n  query GetVaultPerformance(\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!,\n    $first: Int!\n  ) {\n    transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: $first\n    ) {\n      items {\n        ...TransactionBaseFragment\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssetsUsd\n            totalAssets\n          }\n          ... on PeriodSummary {\n            duration\n            totalAssetsAtStart\n            totalAssetsAtEnd\n            totalSupplyAtStart\n            totalSupplyAtEnd\n            netTotalSupplyAtEnd\n          }\n        }\n      }\n      pageInfo {\n        ...PageInfoMinimalFragment\n      }\n    }\n  }\n  \n  fragment TransactionBaseFragment on Transaction {\n    id\n    type\n    timestamp\n    blockNumber\n    hash\n    logIndex\n    chain {\n      id\n      name\n    }\n  }\n\n  \n  fragment PageInfoMinimalFragment on PageInfo {\n    hasNextPage\n    hasPreviousPage\n  }\n\n";
+/**
+ * Query to fetch period summaries for a vault
+ *
+ * Period summaries contain historical snapshots of vault state at regular intervals.
+ * Used by Lagoon SDK to calculate accurate APR from price per share changes over time.
+ *
+ * Note: The GraphQL API doesn't have a direct 'periodSummaries' query. PeriodSummary data
+ * is fetched through the transactions query with type filtering.
+ *
+ * Used by: get_vault_performance tool (via calculateSDKAPR function)
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<{ transactions: { items: Transaction[] } }>(
+ *   GET_PERIOD_SUMMARIES_QUERY,
+ *   {
+ *     where: {
+ *       vault_in: ['0x...'],
+ *       chainId_eq: 1,
+ *       type_in: ['PeriodSummary']
+ *     },
+ *     orderBy: 'timestamp',
+ *     orderDirection: 'asc',
+ *     first: 1000
+ *   }
+ * );
+ * ```
+ *
+ * @returns Transactions containing PeriodSummary data with timestamp and vault state
+ */
+export declare const GET_PERIOD_SUMMARIES_QUERY = "\n  query GetPeriodSummaries(\n    $where: TransactionFilterInput!,\n    $orderBy: TransactionOrderBy!,\n    $orderDirection: OrderDirection!,\n    $first: Int!\n  ) {\n    transactions(\n      where: $where,\n      orderBy: $orderBy,\n      orderDirection: $orderDirection,\n      first: $first\n    ) {\n      items {\n        timestamp\n        data {\n          ... on PeriodSummary {\n            duration\n            totalAssetsAtStart\n            totalAssetsAtEnd\n            totalSupplyAtStart\n            totalSupplyAtEnd\n            netTotalSupplyAtEnd\n          }\n        }\n      }\n      pageInfo {\n        ...PageInfoMinimalFragment\n      }\n    }\n  }\n  \n  fragment PageInfoMinimalFragment on PageInfo {\n    hasNextPage\n    hasPreviousPage\n  }\n\n";
+//# sourceMappingURL=performance.queries.d.ts.map

package/dist/graphql/queries/performance.queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,2BAA2B,4jCAqCvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,0BAA0B,6wBAgCtC,CAAC"}

package/dist/graphql/queries/performance.queries.js

@@ -0,0 +1,133 @@
+/**
+ * Performance Queries
+ *
+ * GraphQL queries for vault performance tracking and historical metrics.
+ * Includes vault performance analysis and period summaries for APR calculations.
+ */
+import { TRANSACTION_BASE_FRAGMENT, PAGEINFO_MINIMAL_FRAGMENT } from '../fragments/index.js';
+/**
+ * Vault performance GraphQL query
+ *
+ * Fetches transactions with TotalAssetsUpdated and PeriodSummary data for
+ * historical metrics and trend analysis. Provides time-series performance data.
+ *
+ * Used by: get_vault_performance tool
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<VaultPerformanceResponse>(
+ *   GET_VAULT_PERFORMANCE_QUERY,
+ *   {
+ *     where: {
+ *       vault_in: ['0x...'],
+ *       type_in: ['TotalAssetsUpdated', 'PeriodSummary']
+ *     },
+ *     orderBy: 'timestamp',
+ *     orderDirection: 'asc',
+ *     first: 1000
+ *   }
+ * );
+ * ```
+ */
+export const GET_VAULT_PERFORMANCE_QUERY = `
+  query GetVaultPerformance(
+    $where: TransactionFilterInput!,
+    $orderBy: TransactionOrderBy!,
+    $orderDirection: OrderDirection!,
+    $first: Int!
+  ) {
+    transactions(
+      where: $where,
+      orderBy: $orderBy,
+      orderDirection: $orderDirection,
+      first: $first
+    ) {
+      items {
+        ...TransactionBaseFragment
+        data {
+          ... on TotalAssetsUpdated {
+            totalAssetsUsd
+            totalAssets
+          }
+          ... on PeriodSummary {
+            duration
+            totalAssetsAtStart
+            totalAssetsAtEnd
+            totalSupplyAtStart
+            totalSupplyAtEnd
+            netTotalSupplyAtEnd
+          }
+        }
+      }
+      pageInfo {
+        ...PageInfoMinimalFragment
+      }
+    }
+  }
+  ${TRANSACTION_BASE_FRAGMENT}
+  ${PAGEINFO_MINIMAL_FRAGMENT}
+`;
+/**
+ * Query to fetch period summaries for a vault
+ *
+ * Period summaries contain historical snapshots of vault state at regular intervals.
+ * Used by Lagoon SDK to calculate accurate APR from price per share changes over time.
+ *
+ * Note: The GraphQL API doesn't have a direct 'periodSummaries' query. PeriodSummary data
+ * is fetched through the transactions query with type filtering.
+ *
+ * Used by: get_vault_performance tool (via calculateSDKAPR function)
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<{ transactions: { items: Transaction[] } }>(
+ *   GET_PERIOD_SUMMARIES_QUERY,
+ *   {
+ *     where: {
+ *       vault_in: ['0x...'],
+ *       chainId_eq: 1,
+ *       type_in: ['PeriodSummary']
+ *     },
+ *     orderBy: 'timestamp',
+ *     orderDirection: 'asc',
+ *     first: 1000
+ *   }
+ * );
+ * ```
+ *
+ * @returns Transactions containing PeriodSummary data with timestamp and vault state
+ */
+export const GET_PERIOD_SUMMARIES_QUERY = `
+  query GetPeriodSummaries(
+    $where: TransactionFilterInput!,
+    $orderBy: TransactionOrderBy!,
+    $orderDirection: OrderDirection!,
+    $first: Int!
+  ) {
+    transactions(
+      where: $where,
+      orderBy: $orderBy,
+      orderDirection: $orderDirection,
+      first: $first
+    ) {
+      items {
+        timestamp
+        data {
+          ... on PeriodSummary {
+            duration
+            totalAssetsAtStart
+            totalAssetsAtEnd
+            totalSupplyAtStart
+            totalSupplyAtEnd
+            netTotalSupplyAtEnd
+          }
+        }
+      }
+      pageInfo {
+        ...PageInfoMinimalFragment
+      }
+    }
+  }
+  ${PAGEINFO_MINIMAL_FRAGMENT}
+`;
+//# sourceMappingURL=performance.queries.js.map

package/dist/graphql/queries/performance.queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.queries.js","sourceRoot":"","sources":["../../../src/graphql/queries/performance.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmCvC,yBAAyB;IACzB,yBAAyB;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BtC,yBAAyB;CAC5B,CAAC"}

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

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

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

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

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

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

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

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

package/dist/graphql/queries/portfolio.queries.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Portfolio Queries
+ *
+ * GraphQL queries for user portfolio operations.
+ * Includes user portfolio data and portfolio optimization queries.
+ */
+/**
+ * Response format type for user portfolio query
+ */
+export type PortfolioResponseFormat = 'list' | 'summary' | 'full';
+/**
+ * Create user portfolio GraphQL query with dynamic fragment selection
+ *
+ * Fetches complete user portfolio with vault positions and metadata.
+ * Fragment selection optimizes token usage based on required detail level.
+ *
+ * Used by: get_user_portfolio tool
+ *
+ * @param responseFormat - Detail level: 'list' (~60 tokens/vault), 'summary' (~170 tokens/vault), 'full' (~600 tokens/vault)
+ * @returns GraphQL query string with appropriate fragment
+ *
+ * Usage:
+ * ```typescript
+ * const query = createGetUserPortfolioQuery('summary'); // Balanced data
+ * const data = await graphqlClient.request<UserPortfolioResponse>(
+ *   query,
+ *   { where: { user_eq: '0x...' } }
+ * );
+ * ```
+ *
+ * Token optimization:
+ * - list: ~60 tokens/position (minimal vault data)
+ * - summary: ~170 tokens/position (balanced - includes curators, descriptions)
+ * - full: ~600 tokens/position (complete vault data)
+ *
+ * For a user with 10 positions:
+ * - list: 600 tokens (90% reduction)
+ * - summary: 1,700 tokens (72% reduction)
+ * - full: 6,000 tokens (current behavior)
+ */
+export declare function createGetUserPortfolioQuery(responseFormat?: PortfolioResponseFormat): string;
+/**
+ * User portfolio GraphQL query (legacy - uses full fragment)
+ *
+ * @deprecated Use createGetUserPortfolioQuery('full') instead for explicit fragment selection
+ *
+ * This maintains backward compatibility for existing code.
+ * Consider migrating to createGetUserPortfolioQuery() for better token efficiency.
+ */
+export declare const GET_USER_PORTFOLIO_QUERY: string;
+/**
+ * GraphQL query for single vault optimization data
+ *
+ * Fetches one vault with its historical price and performance metrics
+ * for portfolio optimization calculations. Used in parallel queries.
+ *
+ * Used by: optimize_portfolio tool (per-vault queries)
+ *
+ * Usage:
+ * ```typescript
+ * const data = await graphqlClient.request<SingleVaultOptimizationResponse>(
+ *   SINGLE_VAULT_OPTIMIZATION_QUERY,
+ *   { vaultAddress: '0x...', chainId: 1 }
+ * );
+ * ```
+ */
+export declare const SINGLE_VAULT_OPTIMIZATION_QUERY = "\n  query SingleVaultOptimization($vaultAddress: Address!, $chainId: Int!) {\n    vault: vaultByAddress(address: $vaultAddress, chainId: $chainId) {\n      ...VaultFragment\n    }\n\n    # Get price history for volatility calculation\n    priceHistory: transactions(\n      where: {\n        vault_in: [$vaultAddress],\n        type_in: [TotalAssetsUpdated]\n      },\n      orderBy: timestamp,\n      orderDirection: asc,\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            totalAssets\n            totalAssetsUsd\n            totalSupply\n            vault {\n              decimals\n              asset {\n                decimals\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
+/**
+ * GraphQL query for portfolio optimization data (DEPRECATED)
+ *
+ * This query is deprecated in favor of SINGLE_VAULT_OPTIMIZATION_QUERY
+ * executed in parallel for each vault. Multi-vault queries cannot
+ * distinguish which transactions belong to which vault.
+ *
+ * @deprecated Use SINGLE_VAULT_OPTIMIZATION_QUERY with Promise.all instead
+ */
+export declare const PORTFOLIO_OPTIMIZATION_QUERY = "\n  query PortfolioOptimization($vaultAddresses: [Address!]!, $chainId: Int!) {\n    vaults(where: { address_in: $vaultAddresses, chainId_eq: $chainId }) {\n      items {\n        ...VaultFragment\n      }\n    }\n\n    # Get price history for volatility calculation\n    priceHistory: transactions(\n      where: {\n        vault_in: $vaultAddresses,\n        type_in: [\"TotalAssetsUpdated\"]\n      },\n      orderBy: \"timestamp\",\n      orderDirection: \"asc\",\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on TotalAssetsUpdated {\n            pricePerShareUsd\n          }\n        }\n      }\n    }\n\n    # Get APR data for return estimation\n    performanceData: transactions(\n      where: {\n        vault_in: $vaultAddresses,\n        type_in: [\"PeriodSummary\"]\n      },\n      orderBy: \"timestamp\",\n      orderDirection: \"asc\",\n      first: 1000\n    ) {\n      items {\n        timestamp\n        data {\n          ... on PeriodSummary {\n            linearNetApr\n          }\n        }\n      }\n    }\n  }\n  \n  fragment VaultFragment on Vault {\n    address\n    symbol\n    decimals\n    name\n    description\n    shortDescription\n    maxCapacity\n    logoUrl\n    averageSettlement\n    isVisible\n    asset {\n      ...AssetInfoFragment\n    }\n    chain {\n      ...ChainInfoFragment\n    }\n    state {\n      state\n      totalAssets\n      totalAssetsUsd\n      totalSupply\n      pricePerShare\n      pricePerShareUsd\n      safeAssetBalance\n      liveAPR {\n        grossApr\n        name\n        netApr\n        description\n      }\n      roles {\n        owner\n        valuationManager\n        whitelistManager\n        safe\n        feeReceiver\n      }\n      managementFee\n      performanceFee\n      pendingSettlement {\n        assets\n        assetsUsd\n        shares\n      }\n      inceptionApr {\n        ...APRBreakdownFragment\n      }\n      pendingSiloBalances {\n        assets\n        shares\n      }\n      monthlyApr {\n        ...APRBreakdownFragment\n      }\n      newTotalAssets\n      highWaterMark\n      lastFeeTime\n      safeAssetBalanceUsd\n      weeklyApr {\n        ...APRBreakdownFragment\n      }\n      yearlyApr {\n        ...APRBreakdownFragment\n      }\n    }\n    curators {\n      name\n      id\n      aboutDescription\n      logoUrl\n      url\n    }\n    integrator {\n      name\n      url\n      logoUrl\n      aboutDescription\n    }\n    defiIntegrations {\n      name\n      description\n      link\n      logoUrl\n      type\n    }\n  }\n  \n  fragment AssetInfoFragment on Asset {\n    id\n    name\n    symbol\n    decimals\n    address\n    logoUrl\n    description\n    isVisible\n    priceUsd\n    chain {\n      id\n      name\n      nativeToken\n      logoUrl\n    }\n  }\n\n  \n  fragment ChainInfoFragment on Chain {\n    id\n    name\n    nativeToken\n    logoUrl\n    wrappedNativeToken {\n      address\n      decimals\n      name\n      symbol\n    }\n    factory\n  }\n\n  \n  fragment APRBreakdownFragment on APRs {\n    linearNetApr\n    linearNetAprWithoutExtraYields\n    airdrops {\n      name\n      apr\n      description\n      distributionTimestamp\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      ppsIncrease\n      startTimestamp\n    }\n    incentives {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      incentiveRate {\n        incentiveAmount\n        referenceToken {\n          id\n        }\n        referenceTokenAmount\n      }\n    }\n    nativeYields {\n      name\n      apr\n      aprDescription\n      description\n      endTimestamp\n      isEstimation\n      logoUrl\n      multiplier\n      startTimestamp\n    }\n  }\n\n\n";
+//# sourceMappingURL=portfolio.queries.d.ts.map

package/dist/graphql/queries/portfolio.queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio.queries.d.ts","sourceRoot":"","sources":["../../../src/graphql/queries/portfolio.queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAqBlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,GAAE,uBAAmC,GAClD,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+BAA+B,s6GAmC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,0sHAiDxC,CAAC"}