@elizaos/plugin-social-alpha 2.0.3-beta.6 → 2.0.3-beta.7

package/dist/reports.js

@@ -0,0 +1,455 @@
+function formatPrice(price) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: price < 1 ? 6 : 2,
+    maximumFractionDigits: price < 1 ? 6 : 2
+  }).format(price);
+}
+function formatPercent(value) {
+  return `${value >= 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+function formatNumber(value) {
+  return new Intl.NumberFormat("en-US").format(value);
+}
+function formatDate(dateString) {
+  const date = dateString instanceof Date ? dateString : new Date(dateString);
+  return date.toLocaleString();
+}
+function normalizeBalance(balanceStr, decimals) {
+  const balance = typeof balanceStr === "string" ? BigInt(balanceStr) : balanceStr;
+  return Number(balance) / 10 ** decimals;
+}
+function calculateTradeMetrics(transactions, token) {
+  let totalBought = 0;
+  let totalBoughtValue = 0;
+  let totalSold = 0;
+  let totalSoldValue = 0;
+  let totalTransferIn = 0;
+  let totalTransferOut = 0;
+  let volumeUsd = 0;
+  let firstTradeTime = /* @__PURE__ */ new Date();
+  let lastTradeTime = /* @__PURE__ */ new Date(0);
+  for (const tx of transactions) {
+    const normalizedAmount = normalizeBalance(tx.amount, token.decimals || 0);
+    const price = tx.price ? Number.parseFloat(tx.price) : 0;
+    const value = normalizedAmount * price;
+    if (tx.timestamp < firstTradeTime) firstTradeTime = new Date(tx.timestamp);
+    if (tx.timestamp > lastTradeTime) lastTradeTime = new Date(tx.timestamp);
+    switch (tx.type) {
+      case "BUY":
+        totalBought += normalizedAmount;
+        totalBoughtValue += value;
+        volumeUsd += value;
+        break;
+      case "SELL":
+        totalSold += normalizedAmount;
+        totalSoldValue += value;
+        volumeUsd += value;
+        break;
+      case "transfer_in":
+        totalTransferIn += normalizedAmount;
+        break;
+      case "transfer_out":
+        totalTransferOut += normalizedAmount;
+        break;
+    }
+  }
+  const averageEntryPrice = totalBought > 0 ? totalBoughtValue / totalBought : 0;
+  const averageExitPrice = totalSold > 0 ? totalSoldValue / totalSold : 0;
+  const realizedPnL = totalSoldValue - totalSold * averageEntryPrice;
+  const realizedPnLPercent = averageEntryPrice > 0 ? (averageExitPrice - averageEntryPrice) / averageEntryPrice * 100 : 0;
+  return {
+    totalBought,
+    totalBoughtValue,
+    totalSold,
+    totalSoldValue,
+    totalTransferIn,
+    totalTransferOut,
+    averageEntryPrice,
+    averageExitPrice,
+    realizedPnL,
+    realizedPnLPercent,
+    volumeUsd,
+    firstTradeTime,
+    lastTradeTime
+  };
+}
+function calculatePositionPerformance(position, token, transactions) {
+  const normalizedBalance = normalizeBalance(
+    position.balance,
+    token.decimals || 0
+  );
+  const initialPrice = Number.parseFloat(position.initialPrice);
+  const currentPrice = token.price || 0;
+  const trades = calculateTradeMetrics(transactions, token);
+  const currentValue = normalizedBalance * currentPrice;
+  const initialValue = normalizedBalance * initialPrice;
+  const costBasis = normalizedBalance * trades.averageEntryPrice;
+  const unrealizedPnL = currentValue - costBasis;
+  const unrealizedPnLPercent = trades.averageEntryPrice > 0 ? (currentPrice - trades.averageEntryPrice) / trades.averageEntryPrice * 100 : 0;
+  const totalPnL = trades.realizedPnL + unrealizedPnL;
+  const totalCost = trades.totalBought * trades.averageEntryPrice;
+  const totalPnLPercent = totalCost > 0 ? totalPnL / totalCost * 100 : 0;
+  const profitLoss = currentValue - initialValue;
+  const profitLossPercentage = profitLoss / initialValue * 100;
+  const priceChange = currentPrice - initialPrice;
+  const priceChangePercentage = priceChange / initialPrice * 100;
+  return {
+    ...position,
+    token,
+    currentValue,
+    initialValue,
+    profitLoss,
+    profitLossPercentage,
+    priceChange,
+    priceChangePercentage,
+    normalizedBalance,
+    trades,
+    unrealizedPnL,
+    unrealizedPnLPercent,
+    totalPnL,
+    totalPnLPercent
+  };
+}
+function formatTokenPerformance(token) {
+  return `
+  Token: ${token.name || "Unknown"} (${token.symbol || "Unknown"})
+  Address: ${token.address || "N/A"}
+  Chain: ${token.chain || "Unknown"}
+  Last Updated: ${token.updatedAt ? formatDate(token.updatedAt) : "N/A"}
+  Price: ${token.price !== void 0 ? formatPrice(token.price) : "N/A"} (24h: ${token.price24hChange !== void 0 ? formatPercent(token.price24hChange) : "N/A"})
+  Volume: ${token.volume !== void 0 ? formatPrice(token.volume) : "N/A"} (24h: ${token.volume24hChange !== void 0 ? formatPercent(token.volume24hChange) : "N/A"})
+  Liquidity: ${token.liquidity !== void 0 ? formatPrice(token.liquidity) : "N/A"}
+  Holders: ${token.holders !== void 0 ? formatNumber(token.holders) : "N/A"} (24h: ${token.holders24hChange !== void 0 ? formatPercent(token.holders24hChange) : "N/A"})
+  Trades: ${token.trades !== void 0 ? formatNumber(token.trades) : "N/A"}
+  Security Info:
+  - Creator: ${token.metadata?.security?.creatorAddress || "N/A"}
+  - Creation Time: ${token.metadata?.security?.creationTime ? new Date((token.metadata?.security).creationTime * 1e3).toLocaleString() : "N/A"}
+  - Total Supply: ${token.metadata?.security?.totalSupply !== void 0 ? formatNumber((token.metadata?.security).totalSupply) : "N/A"}
+  - Top 10 Holders: ${token.metadata?.security?.top10HolderPercent !== void 0 ? formatPercent((token.metadata?.security).top10HolderPercent) : "N/A"}
+  - Token Standard: ${token.metadata?.security?.isToken2022 ? "Token-2022" : "SPL Token"}
+      `.trim();
+}
+function formatTransactionHistory(transactions, token) {
+  return transactions.sort(
+    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+  ).map((tx) => {
+    const normalizedAmount = normalizeBalance(tx.amount, token.decimals || 0);
+    const price = tx.price ? formatPrice(Number.parseFloat(tx.price)) : "N/A";
+    const value = tx.valueUsd ? formatPrice(tx.valueUsd) : "N/A";
+    return `
+  ${formatDate(tx.timestamp)} - ${tx.type}
+  Amount: ${formatNumber(normalizedAmount)} ${token.symbol}
+  Price: ${price}
+  Value: ${value}
+  TX: ${tx.transactionHash}
+          `.trim();
+  });
+}
+function formatPositionPerformance(position, token, transactions) {
+  const perfData = calculatePositionPerformance(position, token, transactions);
+  return `
+  Position ID: ${position.id}
+  Type: ${position.isSimulation ? "Simulation" : "Real"}
+  Token: ${token.name} (${token.symbol})
+  Wallet: ${position.walletAddress}
+
+  Trading Summary:
+  - Total Bought: ${formatNumber(perfData.trades.totalBought)} ${token.symbol}
+  - Total Sold: ${formatNumber(perfData.trades.totalSold)} ${token.symbol}
+  - Average Entry: ${formatPrice(perfData.trades.averageEntryPrice)}
+  - Average Exit: ${formatPrice(perfData.trades.averageExitPrice)}
+  - Trading Volume: ${formatPrice(perfData.trades.volumeUsd)}
+  - First Trade: ${formatDate(perfData.trades.firstTradeTime)}
+  - Last Trade: ${formatDate(perfData.trades.lastTradeTime)}
+
+  Performance Metrics:
+  - Current Price: ${token.price !== void 0 ? formatPrice(token.price) : "N/A"}
+  - Initial Price: ${formatPrice(Number.parseFloat(position.initialPrice))}
+  - Price Change: ${formatPrice(perfData.priceChange)} (${formatPercent(perfData.priceChangePercentage)})
+
+  Position Value:
+  - Current Balance: ${formatNumber(perfData.normalizedBalance)} ${token.symbol}
+  - Current Value: ${formatPrice(perfData.currentValue)}
+  - Realized P&L: ${formatPrice(perfData.trades.realizedPnL)} (${formatPercent(perfData.trades.realizedPnLPercent)})
+  - Unrealized P&L: ${formatPrice(perfData.unrealizedPnL)} (${formatPercent(perfData.unrealizedPnLPercent)})
+  - Total P&L: ${formatPrice(perfData.totalPnL)} (${formatPercent(perfData.totalPnLPercent)})
+
+  Market Info:
+  - Current Liquidity: ${token.liquidity !== void 0 ? formatPrice(token.liquidity) : "N/A"}
+  - 24h Volume: ${token.volume !== void 0 ? formatPrice(token.volume) : "N/A"}
+
+  Transaction History:
+  ${formatTransactionHistory(transactions, token)}
+      `.trim();
+}
+function formatFullReport(tokens, positions, transactions) {
+  const tokenMap = new Map(tokens.map((token) => [token.address, token]));
+  const txMap = /* @__PURE__ */ new Map();
+  transactions.forEach((tx) => {
+    if (!txMap.has(tx.positionId)) {
+      txMap.set(tx.positionId, []);
+    }
+    txMap.get(tx.positionId)?.push(tx);
+  });
+  const tokenReports = tokens.map((token) => formatTokenPerformance(token));
+  const positionsWithData = positions.flatMap((position) => {
+    const token = tokenMap.get(position.tokenAddress);
+    return token ? [{ position, token, transactions: txMap.get(position.id) || [] }] : [];
+  });
+  const positionReports = positionsWithData.map(
+    ({ position, token, transactions: transactions2 }) => formatPositionPerformance(position, token, transactions2)
+  );
+  const { totalCurrentValue, totalRealizedPnL, totalUnrealizedPnL } = positions.reduce(
+    (acc, position) => {
+      const token = tokenMap.get(position.tokenAddress);
+      if (token) {
+        const perfData = calculatePositionPerformance(
+          position,
+          token,
+          txMap.get(position.id) || []
+        );
+        return {
+          totalCurrentValue: acc.totalCurrentValue + perfData.currentValue,
+          totalRealizedPnL: acc.totalRealizedPnL + perfData.trades.realizedPnL,
+          totalUnrealizedPnL: acc.totalUnrealizedPnL + perfData.unrealizedPnL
+        };
+      }
+      return acc;
+    },
+    {
+      totalCurrentValue: 0,
+      totalRealizedPnL: 0,
+      totalUnrealizedPnL: 0
+    }
+  );
+  const totalPnL = totalRealizedPnL + totalUnrealizedPnL;
+  return {
+    tokenReports,
+    positionReports,
+    totalCurrentValue: formatPrice(totalCurrentValue),
+    totalRealizedPnL: formatPrice(totalRealizedPnL),
+    totalUnrealizedPnL: formatPrice(totalUnrealizedPnL),
+    totalPnL: formatPrice(totalPnL),
+    positionsWithBalance: positionsWithData
+  };
+}
+function formatScore(score) {
+  return score.toFixed(2);
+}
+function formatPercentMetric(value) {
+  return `${(value * 100).toFixed(1)}%`;
+}
+function calculateMetricTrend(current, metric, history) {
+  if (history.length === 0)
+    return { trend: 0, description: "No historical data" };
+  const sortedHistory = history.slice().sort(
+    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+  );
+  const previousValue = sortedHistory[0].metrics[metric];
+  const trend = (current[metric] - previousValue) / previousValue * 100;
+  let description = "stable";
+  if (trend > 5) description = "improving";
+  if (trend < -5) description = "declining";
+  return { trend, description };
+}
+function calculateTrend(current, historicalValues) {
+  if (historicalValues.length === 0) return 0;
+  const previousValue = historicalValues[0];
+  return (current - previousValue) / previousValue * 100;
+}
+function formatTrendArrow(trend) {
+  if (trend > 5) return "\u2191";
+  if (trend < -5) return "\u2193";
+  return "\u2192";
+}
+function calculatePeriodTrends(history, period = null) {
+  if (!period) {
+    const monthlyData = history.reduce(
+      (acc, record) => {
+        const month = new Date(record.timestamp).toISOString().slice(0, 7);
+        const currentData = acc.get(month) ?? {
+          performances: [],
+          successes: 0,
+          total: 0
+        };
+        acc.set(month, {
+          performances: [
+            ...currentData.performances,
+            record.metrics.avgTokenPerformance
+          ],
+          successes: currentData.successes + record.metrics.successfulRecs,
+          total: currentData.total + record.metrics.totalRecommendations
+        });
+        return acc;
+      },
+      /* @__PURE__ */ new Map()
+    );
+    return Array.from(monthlyData.entries()).map(([month, data]) => ({
+      period: month,
+      avgPerformance: data.performances.reduce((a, b) => a + b, 0) / data.performances.length,
+      successRate: data.successes / data.total,
+      recommendations: data.total
+    })).sort((a, b) => b.period.localeCompare(a.period));
+  }
+  const cutoffDate = /* @__PURE__ */ new Date();
+  cutoffDate.setDate(cutoffDate.getDate() - period.days);
+  const periodData = history.filter(
+    (record) => new Date(record.timestamp) >= cutoffDate
+  );
+  if (periodData.length === 0) {
+    return [
+      {
+        period: period.label,
+        avgPerformance: 0,
+        successRate: 0,
+        recommendations: 0
+      }
+    ];
+  }
+  const performances = periodData.map(
+    (record) => record.metrics.avgTokenPerformance
+  );
+  const totalRecommendations = periodData.reduce(
+    (sum, record) => sum + record.metrics.totalRecommendations,
+    0
+  );
+  const successfulRecs = periodData.reduce(
+    (sum, record) => sum + record.metrics.successfulRecs,
+    0
+  );
+  return [
+    {
+      period: period.label,
+      avgPerformance: performances.reduce((a, b) => a + b, 0) / performances.length,
+      successRate: totalRecommendations > 0 ? successfulRecs / totalRecommendations : 0,
+      recommendations: totalRecommendations
+    }
+  ];
+}
+function formatTrends(trends) {
+  return trends.map(
+    (trend) => `
+${trend.period}:
+- Performance: ${formatPercent(trend.avgPerformance)}
+- Success Rate: ${formatPercentMetric(trend.successRate)}
+- Recommendations: ${trend.recommendations}`.trim()
+  ).join("\n\n");
+}
+function formatRecommenderProfile(entity, metrics, history) {
+  const successRate = metrics.successfulRecs / metrics.totalRecommendations;
+  const trustTrend = calculateMetricTrend(metrics, "trustScore", history);
+  const performanceTrend = calculateMetricTrend(
+    metrics,
+    "avgTokenPerformance",
+    history
+  );
+  return `
+Entity Profile: ${entity.metadata?.username || "Unknown"}
+Platform: ${entity.metadata?.platform || "Unknown"}
+ID: ${entity.id}
+
+Performance Metrics:
+- Trust Score: ${formatScore(metrics.trustScore)} (${formatPercent(trustTrend.trend)} ${trustTrend.description})
+- Success Rate: ${formatPercentMetric(successRate)}
+- Recommendations: ${metrics.totalRecommendations} total, ${metrics.successfulRecs} successful
+- Avg Token Performance: ${formatPercent(metrics.avgTokenPerformance)} (${formatPercent(performanceTrend.trend)} ${performanceTrend.description})
+
+Risk Assessment:
+- Consistency Score: ${formatScore(metrics.consistencyScore)}
+
+Activity:
+- Last Active: ${formatDate(metrics.lastUpdated)}
+    `.trim();
+}
+function formatRecommenderReport(entity, metrics, history) {
+  const sortedHistory = [...history].sort(
+    (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+  );
+  const dailyTrends = calculatePeriodTrends(sortedHistory, {
+    label: "24 Hours",
+    days: 1
+  });
+  const weeklyTrends = calculatePeriodTrends(sortedHistory, {
+    label: "7 Days",
+    days: 7
+  });
+  const monthlyTrends = calculatePeriodTrends(sortedHistory);
+  const successTrend = calculateTrend(
+    metrics.successfulRecs / metrics.totalRecommendations,
+    sortedHistory.map(
+      (h) => h.metrics.successfulRecs / h.metrics.totalRecommendations
+    )
+  );
+  const performanceTrend = calculateTrend(
+    metrics.avgTokenPerformance,
+    sortedHistory.map((h) => h.metrics.avgTokenPerformance)
+  );
+  return `
+Username: ${entity.metadata?.username || "Unknown"}
+Platform: ${entity.metadata?.platform || "Unknown"}
+ID: ${entity.id}
+
+=== CURRENT METRICS ===
+Trust Score: ${formatScore(metrics.trustScore)}
+Success Rate: ${formatPercentMetric(metrics.successfulRecs / metrics.totalRecommendations)} (${formatTrendArrow(successTrend)})
+Total Recommendations: ${metrics.totalRecommendations}
+Average Token Performance: ${formatPercent(metrics.avgTokenPerformance)} (${formatTrendArrow(performanceTrend)})
+
+Risk Analysis:
+- Consistency: ${formatScore(metrics.consistencyScore)}
+
+Activity Status:
+- Last Active: ${formatDate(metrics.lastUpdated)}
+
+=== PERFORMANCE TRENDS ===
+${formatTrends(dailyTrends)}
+
+${formatTrends(weeklyTrends)}
+
+Monthly Average Performance:
+${formatTrends(monthlyTrends)}`.trim();
+}
+function formatTopRecommendersOverview(recommenders, metrics, history) {
+  const sortedRecommenders = [...recommenders].sort((a, b) => {
+    if (!a.id || !b.id) return 0;
+    const metricsA = metrics.get(a.id);
+    const metricsB = metrics.get(b.id);
+    if (!metricsA || !metricsB) return 0;
+    return metricsB.trustScore - metricsA.trustScore;
+  });
+  return `
+<top_recommenders>
+${sortedRecommenders.map((entity) => {
+    if (!entity.id) return null;
+    const metric = metrics.get(entity.id);
+    if (!metric) return null;
+    const historicalData = history.get(entity.id) || [];
+    const trustTrend = calculateMetricTrend(
+      metric,
+      "trustScore",
+      historicalData
+    );
+    const performanceTrend = calculateMetricTrend(
+      metric,
+      "avgTokenPerformance",
+      historicalData
+    );
+    return `
+${entity.metadata?.username || "Unknown"} (${entity.metadata?.platform || "Unknown"})
+Trust Score: ${formatScore(metric.trustScore)} (${formatPercent(trustTrend.trend)} ${trustTrend.description})
+Performance Score: ${formatScore(metric.avgTokenPerformance)} (${formatPercent(performanceTrend.trend)} ${performanceTrend.description})
+Success Rate: ${formatPercentMetric(metric.successfulRecs / metric.totalRecommendations)}
+Last Active: ${formatDate(metric.lastUpdated)}
+  `.trim();
+  }).filter((report) => report !== null).join("\n\n")}
+</top_recommenders>`.trim();
+}
+export {
+  formatFullReport,
+  formatRecommenderProfile,
+  formatRecommenderReport,
+  formatTopRecommendersOverview
+};
+//# sourceMappingURL=reports.js.map

package/dist/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reports.ts"],"sourcesContent":["import type { Entity } from \"@elizaos/core\";\nimport type {\n\tMetadataJsonValue,\n\tPositionPerformance,\n\tPositionWithBalance,\n\tRecommenderMetrics,\n\tRecommenderMetricsHistory,\n\tTokenPerformance,\n\tTradeMetrics,\n\tTransaction,\n} from \"./types.js\";\n\n/**\n * Formats a price into a currency format.\n *\n * @param {number} price - The price to be formatted.\n * @returns {string} The price formatted as a currency.\n */\nfunction formatPrice(price: number): string {\n\treturn new Intl.NumberFormat(\"en-US\", {\n\t\tstyle: \"currency\",\n\t\tcurrency: \"USD\",\n\t\tminimumFractionDigits: price < 1 ? 6 : 2,\n\t\tmaximumFractionDigits: price < 1 ? 6 : 2,\n\t}).format(price);\n}\n\n/**\n * Formats a number as a percentage string with two decimal places.\n * @param {number} value - The number to be formatted as a percentage.\n * @returns {string} The formatted percentage string.\n */\nfunction formatPercent(value: number): string {\n\treturn `${value >= 0 ? \"+\" : \"\"}${value.toFixed(2)}%`;\n}\n\n/**\n * Formats a given number into a string representation using the \"en-US\" number format.\n *\n * @param {number} value - The number to be formatted.\n * @returns {string} The formatted number as a string.\n */\nfunction formatNumber(value: number): string {\n\treturn new Intl.NumberFormat(\"en-US\").format(value);\n}\n\n/**\n * Formats a given date string or Date object into a locale-specific string representation.\n *\n * @param {string | Date} dateString - The date string to be formatted or a Date object.\n * @returns {string} The formatted date string.\n */\nfunction formatDate(dateString: string | Date): string {\n\tconst date = dateString instanceof Date ? dateString : new Date(dateString);\n\treturn date.toLocaleString();\n}\n\n/**\n * Function to normalize the balance based on the decimals provided.\n * @param {string | bigint} balanceStr - The balance to normalize, can be a string or bigint.\n * @param {number} decimals - The number of decimal places to normalize to.\n * @returns {number} The normalized balance as a number.\n */\nfunction normalizeBalance(\n\tbalanceStr: string | bigint,\n\tdecimals: number,\n): number {\n\tconst balance =\n\t\ttypeof balanceStr === \"string\" ? BigInt(balanceStr) : balanceStr;\n\treturn Number(balance) / 10 ** decimals;\n}\n\n/**\n * Calculate various trade metrics based on transactions and token performance.\n *\n * @param {Transaction[]} transactions - Array of transactions to calculate metrics for.\n * @param {TokenPerformance} token - Token performance object.\n * @returns {TradeMetrics} Object containing calculated trade metrics.\n */\nfunction calculateTradeMetrics(\n\ttransactions: Transaction[],\n\ttoken: TokenPerformance,\n): TradeMetrics {\n\tlet totalBought = 0;\n\tlet totalBoughtValue = 0;\n\tlet totalSold = 0;\n\tlet totalSoldValue = 0;\n\tlet totalTransferIn = 0;\n\tlet totalTransferOut = 0;\n\tlet volumeUsd = 0;\n\tlet firstTradeTime = new Date();\n\tlet lastTradeTime = new Date(0);\n\n\tfor (const tx of transactions) {\n\t\tconst normalizedAmount = normalizeBalance(tx.amount, token.decimals || 0);\n\t\tconst price = tx.price ? Number.parseFloat(tx.price) : 0;\n\t\tconst value = normalizedAmount * price;\n\n\t\tif (tx.timestamp < firstTradeTime) firstTradeTime = new Date(tx.timestamp);\n\t\tif (tx.timestamp > lastTradeTime) lastTradeTime = new Date(tx.timestamp);\n\n\t\tswitch (tx.type) {\n\t\t\tcase \"BUY\":\n\t\t\t\ttotalBought += normalizedAmount;\n\t\t\t\ttotalBoughtValue += value;\n\t\t\t\tvolumeUsd += value;\n\t\t\t\tbreak;\n\t\t\tcase \"SELL\":\n\t\t\t\ttotalSold += normalizedAmount;\n\t\t\t\ttotalSoldValue += value;\n\t\t\t\tvolumeUsd += value;\n\t\t\t\tbreak;\n\t\t\tcase \"transfer_in\":\n\t\t\t\ttotalTransferIn += normalizedAmount;\n\t\t\t\tbreak;\n\t\t\tcase \"transfer_out\":\n\t\t\t\ttotalTransferOut += normalizedAmount;\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tconst averageEntryPrice =\n\t\ttotalBought > 0 ? totalBoughtValue / totalBought : 0;\n\tconst averageExitPrice = totalSold > 0 ? totalSoldValue / totalSold : 0;\n\tconst realizedPnL = totalSoldValue - totalSold * averageEntryPrice;\n\tconst realizedPnLPercent =\n\t\taverageEntryPrice > 0\n\t\t\t? ((averageExitPrice - averageEntryPrice) / averageEntryPrice) * 100\n\t\t\t: 0;\n\n\treturn {\n\t\ttotalBought,\n\t\ttotalBoughtValue,\n\t\ttotalSold,\n\t\ttotalSoldValue,\n\t\ttotalTransferIn,\n\t\ttotalTransferOut,\n\t\taverageEntryPrice,\n\t\taverageExitPrice,\n\t\trealizedPnL,\n\t\trealizedPnLPercent,\n\t\tvolumeUsd,\n\t\tfirstTradeTime,\n\t\tlastTradeTime,\n\t};\n}\n\n/**\n * Calculate the performance metrics of a given position.\n *\n * @param {PositionWithBalance} position The position with balance information.\n * @param {TokenPerformance} token The performance metrics of the token.\n * @param {Transaction[]} transactions The list of transactions related to the position.\n * @returns {PositionPerformance} The performance metrics of the position including current value, initial value,\n * profit/loss, profit/loss percentage, price change, price change percentage, normalized balance, trade metrics,\n * unrealized profit/loss, unrealized profit/loss percentage, total profit/loss, and total profit/loss percentage.\n */\n\nfunction calculatePositionPerformance(\n\tposition: PositionWithBalance,\n\ttoken: TokenPerformance,\n\ttransactions: Transaction[],\n): PositionPerformance {\n\tconst normalizedBalance = normalizeBalance(\n\t\tposition.balance,\n\t\ttoken.decimals || 0,\n\t);\n\tconst initialPrice = Number.parseFloat(position.initialPrice);\n\tconst currentPrice = token.price || 0;\n\n\tconst trades = calculateTradeMetrics(transactions, token);\n\n\tconst currentValue = normalizedBalance * currentPrice;\n\tconst initialValue = normalizedBalance * initialPrice;\n\n\t// Calculate unrealized P&L based on average entry price\n\tconst costBasis = normalizedBalance * trades.averageEntryPrice;\n\tconst unrealizedPnL = currentValue - costBasis;\n\tconst unrealizedPnLPercent =\n\t\ttrades.averageEntryPrice > 0\n\t\t\t? ((currentPrice - trades.averageEntryPrice) / trades.averageEntryPrice) *\n\t\t\t\t100\n\t\t\t: 0;\n\n\t// Total P&L combines realized and unrealized\n\tconst totalPnL = trades.realizedPnL + unrealizedPnL;\n\tconst totalCost = trades.totalBought * trades.averageEntryPrice;\n\tconst totalPnLPercent = totalCost > 0 ? (totalPnL / totalCost) * 100 : 0;\n\n\tconst profitLoss = currentValue - initialValue;\n\tconst profitLossPercentage = (profitLoss / initialValue) * 100;\n\tconst priceChange = currentPrice - initialPrice;\n\tconst priceChangePercentage = (priceChange / initialPrice) * 100;\n\n\treturn {\n\t\t...position,\n\t\ttoken,\n\t\tcurrentValue,\n\t\tinitialValue,\n\t\tprofitLoss,\n\t\tprofitLossPercentage,\n\t\tpriceChange,\n\t\tpriceChangePercentage,\n\t\tnormalizedBalance,\n\t\ttrades,\n\t\tunrealizedPnL,\n\t\tunrealizedPnLPercent,\n\t\ttotalPnL,\n\t\ttotalPnLPercent,\n\t};\n}\n\n/**\n * Formats the token performance information into a readable string.\n * @param {TokenPerformance} token - The token performance object to format.\n * @returns {string} The formatted token performance information.\n */\nfunction formatTokenPerformance(token: TokenPerformance): string {\n\treturn `\n  Token: ${token.name || \"Unknown\"} (${token.symbol || \"Unknown\"})\n  Address: ${token.address || \"N/A\"}\n  Chain: ${token.chain || \"Unknown\"}\n  Last Updated: ${token.updatedAt ? formatDate(token.updatedAt) : \"N/A\"}\n  Price: ${token.price !== undefined ? formatPrice(token.price) : \"N/A\"} (24h: ${token.price24hChange !== undefined ? formatPercent(token.price24hChange) : \"N/A\"})\n  Volume: ${token.volume !== undefined ? formatPrice(token.volume) : \"N/A\"} (24h: ${token.volume24hChange !== undefined ? formatPercent(token.volume24hChange) : \"N/A\"})\n  Liquidity: ${token.liquidity !== undefined ? formatPrice(token.liquidity) : \"N/A\"}\n  Holders: ${token.holders !== undefined ? formatNumber(token.holders) : \"N/A\"} (24h: ${token.holders24hChange !== undefined ? formatPercent(token.holders24hChange) : \"N/A\"})\n  Trades: ${token.trades !== undefined ? formatNumber(token.trades) : \"N/A\"}\n  Security Info:\n  - Creator: ${(token.metadata?.security as Record<string, MetadataJsonValue> | undefined)?.creatorAddress || \"N/A\"}\n  - Creation Time: ${(token.metadata?.security as Record<string, MetadataJsonValue> | undefined)?.creationTime ? new Date(((token.metadata?.security as Record<string, MetadataJsonValue>).creationTime as number) * 1000).toLocaleString() : \"N/A\"}\n  - Total Supply: ${(token.metadata?.security as Record<string, MetadataJsonValue> | undefined)?.totalSupply !== undefined ? formatNumber((token.metadata?.security as Record<string, MetadataJsonValue>).totalSupply as number) : \"N/A\"}\n  - Top 10 Holders: ${(token.metadata?.security as Record<string, MetadataJsonValue> | undefined)?.top10HolderPercent !== undefined ? formatPercent((token.metadata?.security as Record<string, MetadataJsonValue>).top10HolderPercent as number) : \"N/A\"}\n  - Token Standard: ${(token.metadata?.security as Record<string, MetadataJsonValue> | undefined)?.isToken2022 ? \"Token-2022\" : \"SPL Token\"}\n      `.trim();\n}\n\n/**\n * Formats transaction history data into an array of strings for display.\n * @param {Transaction[]} transactions - The list of transactions to format.\n * @param {TokenPerformance} token - The token performance data used for formatting.\n * @returns {string[]} - An array of formatted strings representing each transaction.\n */\nfunction formatTransactionHistory(\n\ttransactions: Transaction[],\n\ttoken: TokenPerformance,\n): string[] {\n\treturn transactions\n\t\t.sort(\n\t\t\t(a, b) =>\n\t\t\t\tnew Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(),\n\t\t)\n\t\t.map((tx) => {\n\t\t\tconst normalizedAmount = normalizeBalance(tx.amount, token.decimals || 0);\n\t\t\tconst price = tx.price ? formatPrice(Number.parseFloat(tx.price)) : \"N/A\";\n\t\t\tconst value = tx.valueUsd ? formatPrice(tx.valueUsd) : \"N/A\";\n\n\t\t\treturn `\n  ${formatDate(tx.timestamp)} - ${tx.type}\n  Amount: ${formatNumber(normalizedAmount)} ${token.symbol}\n  Price: ${price}\n  Value: ${value}\n  TX: ${tx.transactionHash}\n          `.trim();\n\t\t});\n}\n\n/**\n * Format the performance metrics and details of a position.\n *\n * @param {PositionWithBalance} position The position object containing balance information.\n * @param {TokenPerformance} token The token performance object.\n * @param {Transaction[]} transactions The list of transactions associated with the position.\n * @returns {string} The formatted performance details of the position.\n */\nfunction formatPositionPerformance(\n\tposition: PositionWithBalance,\n\ttoken: TokenPerformance,\n\ttransactions: Transaction[],\n): string {\n\tconst perfData = calculatePositionPerformance(position, token, transactions);\n\n\treturn `\n  Position ID: ${position.id}\n  Type: ${position.isSimulation ? \"Simulation\" : \"Real\"}\n  Token: ${token.name} (${token.symbol})\n  Wallet: ${position.walletAddress}\n\n  Trading Summary:\n  - Total Bought: ${formatNumber(perfData.trades.totalBought)} ${token.symbol}\n  - Total Sold: ${formatNumber(perfData.trades.totalSold)} ${token.symbol}\n  - Average Entry: ${formatPrice(perfData.trades.averageEntryPrice)}\n  - Average Exit: ${formatPrice(perfData.trades.averageExitPrice)}\n  - Trading Volume: ${formatPrice(perfData.trades.volumeUsd)}\n  - First Trade: ${formatDate(perfData.trades.firstTradeTime)}\n  - Last Trade: ${formatDate(perfData.trades.lastTradeTime)}\n\n  Performance Metrics:\n  - Current Price: ${token.price !== undefined ? formatPrice(token.price) : \"N/A\"}\n  - Initial Price: ${formatPrice(Number.parseFloat(position.initialPrice))}\n  - Price Change: ${formatPrice(perfData.priceChange)} (${formatPercent(perfData.priceChangePercentage)})\n\n  Position Value:\n  - Current Balance: ${formatNumber(perfData.normalizedBalance)} ${token.symbol}\n  - Current Value: ${formatPrice(perfData.currentValue)}\n  - Realized P&L: ${formatPrice(perfData.trades.realizedPnL)} (${formatPercent(perfData.trades.realizedPnLPercent)})\n  - Unrealized P&L: ${formatPrice(perfData.unrealizedPnL)} (${formatPercent(perfData.unrealizedPnLPercent)})\n  - Total P&L: ${formatPrice(perfData.totalPnL)} (${formatPercent(perfData.totalPnLPercent)})\n\n  Market Info:\n  - Current Liquidity: ${token.liquidity !== undefined ? formatPrice(token.liquidity) : \"N/A\"}\n  - 24h Volume: ${token.volume !== undefined ? formatPrice(token.volume) : \"N/A\"}\n\n  Transaction History:\n  ${formatTransactionHistory(transactions, token)}\n      `.trim();\n}\n\n/**\n * Formats a full report based on the provided data.\n *\n * @param {TokenPerformance[]} tokens - Array of token performance data.\n * @param {PositionWithBalance[]} positions - Array of positions with balance data.\n * @param {Transaction[]} transactions - Array of transactions data.\n * @returns {{\n *   tokenReports: Object[],\n *   positionReports: Object[],\n *   totalCurrentValue: string,\n *   totalRealizedPnL: string,\n *   totalUnrealizedPnL: string,\n *   totalPnL: string,\n *   positionsWithBalance: Object[],\n * }} Formatted full report containing token reports, position reports, total values, and positions with balance.\n */\nexport function formatFullReport(\n\ttokens: TokenPerformance[],\n\tpositions: PositionWithBalance[],\n\ttransactions: Transaction[],\n) {\n\tconst tokenMap = new Map(tokens.map((token) => [token.address, token]));\n\tconst txMap = new Map<string, Transaction[]>();\n\n\t// Group transactions by position ID\n\ttransactions.forEach((tx) => {\n\t\tif (!txMap.has(tx.positionId)) {\n\t\t\ttxMap.set(tx.positionId, []);\n\t\t}\n\t\ttxMap.get(tx.positionId)?.push(tx);\n\t});\n\n\tconst tokenReports = tokens.map((token) => formatTokenPerformance(token));\n\n\tconst positionsWithData = positions.flatMap((position) => {\n\t\tconst token = tokenMap.get(position.tokenAddress);\n\t\treturn token\n\t\t\t? [{ position, token, transactions: txMap.get(position.id) || [] }]\n\t\t\t: [];\n\t});\n\n\tconst positionReports = positionsWithData.map(\n\t\t({ position, token, transactions }) =>\n\t\t\tformatPositionPerformance(position, token, transactions),\n\t);\n\n\tconst { totalCurrentValue, totalRealizedPnL, totalUnrealizedPnL } =\n\t\tpositions.reduce(\n\t\t\t(acc, position) => {\n\t\t\t\tconst token = tokenMap.get(position.tokenAddress);\n\n\t\t\t\tif (token) {\n\t\t\t\t\tconst perfData = calculatePositionPerformance(\n\t\t\t\t\t\tposition,\n\t\t\t\t\t\ttoken,\n\t\t\t\t\t\ttxMap.get(position.id) || [],\n\t\t\t\t\t);\n\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttotalCurrentValue: acc.totalCurrentValue + perfData.currentValue,\n\t\t\t\t\t\ttotalRealizedPnL:\n\t\t\t\t\t\t\tacc.totalRealizedPnL + perfData.trades.realizedPnL,\n\t\t\t\t\t\ttotalUnrealizedPnL: acc.totalUnrealizedPnL + perfData.unrealizedPnL,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\treturn acc;\n\t\t\t},\n\t\t\t{\n\t\t\t\ttotalCurrentValue: 0,\n\t\t\t\ttotalRealizedPnL: 0,\n\t\t\t\ttotalUnrealizedPnL: 0,\n\t\t\t},\n\t\t);\n\n\tconst totalPnL = totalRealizedPnL + totalUnrealizedPnL;\n\n\treturn {\n\t\ttokenReports,\n\t\tpositionReports,\n\t\ttotalCurrentValue: formatPrice(totalCurrentValue),\n\t\ttotalRealizedPnL: formatPrice(totalRealizedPnL),\n\t\ttotalUnrealizedPnL: formatPrice(totalUnrealizedPnL),\n\t\ttotalPnL: formatPrice(totalPnL),\n\t\tpositionsWithBalance: positionsWithData,\n\t};\n}\n\n/**\n * Formats a numerical score to have exactly two decimal places.\n *\n * @param {number} score - The numerical score to be formatted.\n * @returns {string} The formatted score with two decimal places.\n */\n\nfunction formatScore(score: number): string {\n\treturn score.toFixed(2);\n}\n\n/**\n * Formats a numeric value into a percentage string with one decimal place.\n *\n * @param {number} value - The numeric value to be formatted as a percentage.\n * @returns {string} The formatted percentage string.\n */\nfunction formatPercentMetric(value: number): string {\n\treturn `${(value * 100).toFixed(1)}%`;\n}\n\n/**\n * TypeScript type to retrieve the keys of a given object `T` that have numeric values.\n */\ntype NumericKeys<T> = {\n\t[K in keyof T]: T[K] extends number ? K : never;\n}[keyof T];\n\n/**\n * Represents the numeric keys from the `RecommenderMetrics` type.\n */\ntype RecommenderNumericMetrics = NumericKeys<RecommenderMetrics>;\n\n/**\n * Calculate the trend of a specific metric based on historical data.\n * @template Metric - The type of metric to calculate trend for.\n * @param {RecommenderMetrics} current - The current metrics values.\n * @param {Metric} metric - The specific metric to calculate trend for.\n * @param {RecommenderMetricsHistory[]} history - Array of historical metrics data.\n * @returns {{ trend: number; description: string }} - Object containing trend value and description.\n */\nfunction calculateMetricTrend<Metric extends RecommenderNumericMetrics>(\n\tcurrent: RecommenderMetrics,\n\tmetric: Metric,\n\thistory: RecommenderMetricsHistory[],\n): { trend: number; description: string } {\n\tif (history.length === 0)\n\t\treturn { trend: 0, description: \"No historical data\" };\n\n\tconst sortedHistory = history\n\t\t.slice()\n\t\t.sort(\n\t\t\t(a, b) =>\n\t\t\t\tnew Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(),\n\t\t);\n\n\tconst previousValue = sortedHistory[0].metrics[metric];\n\tconst trend = ((current[metric] - previousValue) / previousValue) * 100;\n\n\tlet description = \"stable\";\n\tif (trend > 5) description = \"improving\";\n\tif (trend < -5) description = \"declining\";\n\n\treturn { trend, description };\n}\n\n/**\n * Calculate the percentage trend between the current value and the first value in the historical values array.\n *\n * @param {number} current - The current value.\n * @param {number[]} historicalValues - An array of historical values.\n * @returns {number} The calculated trend percentage.\n */\nfunction calculateTrend(current: number, historicalValues: number[]): number {\n\tif (historicalValues.length === 0) return 0;\n\tconst previousValue = historicalValues[0];\n\treturn ((current - previousValue) / previousValue) * 100;\n}\n\n/**\n * Formats the trend arrow based on the trend value.\n * An arrow pointing upwards (\"↑\") is returned if the trend is greater than 5.\n * An arrow pointing downwards (\"↓\") is returned if the trend is less than -5.\n * A horizontal arrow (\"→\") is returned if the trend is between -5 and 5 (inclusive).\n *\n * @param trend The value representing the trend\n * @returns The formatted arrow representing the trend direction\n */\nfunction formatTrendArrow(trend: number): string {\n\tif (trend > 5) return \"↑\";\n\tif (trend < -5) return \"↓\";\n\treturn \"→\";\n}\n\n/**\n * Represents a time period with a label and number of days.\n * @typedef {Object} TimePeriod\n * @property {string} label - The label for the time period.\n * @property {number} days - The number of days in the time period.\n */\ntype TimePeriod = {\n\tlabel: string;\n\tdays: number;\n};\n\n/**\n * Calculates and returns trends for a given history of recommended metrics.\n * If a specific period is provided, trends are calculated for that period.\n * If no period is provided, monthly trends are calculated.\n *\n * @param {RecommenderMetricsHistory[]} history - The history of recommended metrics.\n * @param {TimePeriod} period - The time period for which trends should be calculated. If not provided, monthly trends are calculated.\n * @returns {Array<{\n * \tperiod: string;\n * \tavgPerformance: number;\n * \tsuccessRate: number;\n * \trecommendations: number;\n * }>} An array of objects containing period, average performance, success rate, and total recommendations.\n */\nfunction calculatePeriodTrends(\n\thistory: RecommenderMetricsHistory[],\n\tperiod: TimePeriod | null = null,\n): Array<{\n\tperiod: string;\n\tavgPerformance: number;\n\tsuccessRate: number;\n\trecommendations: number;\n}> {\n\t// For monthly grouping\n\tif (!period) {\n\t\tconst monthlyData = history.reduce(\n\t\t\t(acc, record) => {\n\t\t\t\tconst month = new Date(record.timestamp).toISOString().slice(0, 7);\n\n\t\t\t\tconst currentData = acc.get(month) ?? {\n\t\t\t\t\tperformances: [],\n\t\t\t\t\tsuccesses: 0,\n\t\t\t\t\ttotal: 0,\n\t\t\t\t};\n\n\t\t\t\tacc.set(month, {\n\t\t\t\t\tperformances: [\n\t\t\t\t\t\t...currentData.performances,\n\t\t\t\t\t\trecord.metrics.avgTokenPerformance,\n\t\t\t\t\t],\n\t\t\t\t\tsuccesses: currentData.successes + record.metrics.successfulRecs,\n\t\t\t\t\ttotal: currentData.total + record.metrics.totalRecommendations,\n\t\t\t\t});\n\n\t\t\t\treturn acc;\n\t\t\t},\n\t\t\tnew Map<\n\t\t\t\tstring,\n\t\t\t\t{\n\t\t\t\t\tperformances: number[];\n\t\t\t\t\tsuccesses: number;\n\t\t\t\t\ttotal: number;\n\t\t\t\t}\n\t\t\t>(),\n\t\t);\n\n\t\treturn Array.from(monthlyData.entries())\n\t\t\t.map(([month, data]) => ({\n\t\t\t\tperiod: month,\n\t\t\t\tavgPerformance:\n\t\t\t\t\tdata.performances.reduce((a, b) => a + b, 0) /\n\t\t\t\t\tdata.performances.length,\n\t\t\t\tsuccessRate: data.successes / data.total,\n\t\t\t\trecommendations: data.total,\n\t\t\t}))\n\t\t\t.sort((a, b) => b.period.localeCompare(a.period));\n\t}\n\n\t// For daily and weekly periods\n\tconst cutoffDate = new Date();\n\tcutoffDate.setDate(cutoffDate.getDate() - period.days);\n\n\tconst periodData = history.filter(\n\t\t(record) => new Date(record.timestamp) >= cutoffDate,\n\t);\n\n\tif (periodData.length === 0) {\n\t\treturn [\n\t\t\t{\n\t\t\t\tperiod: period.label,\n\t\t\t\tavgPerformance: 0,\n\t\t\t\tsuccessRate: 0,\n\t\t\t\trecommendations: 0,\n\t\t\t},\n\t\t];\n\t}\n\n\tconst performances = periodData.map(\n\t\t(record) => record.metrics.avgTokenPerformance,\n\t);\n\tconst totalRecommendations = periodData.reduce(\n\t\t(sum, record) => sum + record.metrics.totalRecommendations,\n\t\t0,\n\t);\n\tconst successfulRecs = periodData.reduce(\n\t\t(sum, record) => sum + record.metrics.successfulRecs,\n\t\t0,\n\t);\n\n\treturn [\n\t\t{\n\t\t\tperiod: period.label,\n\t\t\tavgPerformance:\n\t\t\t\tperformances.reduce((a, b) => a + b, 0) / performances.length,\n\t\t\tsuccessRate:\n\t\t\t\ttotalRecommendations > 0 ? successfulRecs / totalRecommendations : 0,\n\t\t\trecommendations: totalRecommendations,\n\t\t},\n\t];\n}\n\n/**\n * Formats an array of trends into a string representation.\n *\n * @param {Array<{ period: string; avgPerformance: number; successRate: number; recommendations: number; }>} trends The array of trends to format.\n * @returns {string} The formatted trends as a string with each trend separated by two new lines.\n */\nfunction formatTrends(\n\ttrends: Array<{\n\t\tperiod: string;\n\t\tavgPerformance: number;\n\t\tsuccessRate: number;\n\t\trecommendations: number;\n\t}>,\n): string {\n\treturn trends\n\t\t.map((trend) =>\n\t\t\t`\n${trend.period}:\n- Performance: ${formatPercent(trend.avgPerformance)}\n- Success Rate: ${formatPercentMetric(trend.successRate)}\n- Recommendations: ${trend.recommendations}`.trim(),\n\t\t)\n\t\t.join(\"\\n\\n\");\n}\n\n/**\n * Formats the recommender profile for a given entity based on the provided metrics and history.\n * @param {Entity} entity - The entity for which the profile is being formatted.\n * @param {RecommenderMetrics} metrics - The metrics related to the recommendations for the entity.\n * @param {RecommenderMetricsHistory[]} history - The history of metrics for the entity.\n * @returns {string} The formatted recommender profile string.\n */\nexport function formatRecommenderProfile(\n\tentity: Entity,\n\tmetrics: RecommenderMetrics,\n\thistory: RecommenderMetricsHistory[],\n): string {\n\tconst successRate = metrics.successfulRecs / metrics.totalRecommendations;\n\tconst trustTrend = calculateMetricTrend(metrics, \"trustScore\", history);\n\tconst performanceTrend = calculateMetricTrend(\n\t\tmetrics,\n\t\t\"avgTokenPerformance\",\n\t\thistory,\n\t);\n\n\treturn `\nEntity Profile: ${entity.metadata?.username || \"Unknown\"}\nPlatform: ${entity.metadata?.platform || \"Unknown\"}\nID: ${entity.id}\n\nPerformance Metrics:\n- Trust Score: ${formatScore(metrics.trustScore)} (${formatPercent(trustTrend.trend)} ${trustTrend.description})\n- Success Rate: ${formatPercentMetric(successRate)}\n- Recommendations: ${metrics.totalRecommendations} total, ${metrics.successfulRecs} successful\n- Avg Token Performance: ${formatPercent(metrics.avgTokenPerformance)} (${formatPercent(performanceTrend.trend)} ${performanceTrend.description})\n\nRisk Assessment:\n- Consistency Score: ${formatScore(metrics.consistencyScore)}\n\nActivity:\n- Last Active: ${formatDate(metrics.lastUpdated)}\n    `.trim();\n}\n\n/**\n * Formats a recommender report for an entity with provided metrics and history.\n * @param {Entity} entity - The entity for which the report is being generated.\n * @param {RecommenderMetrics} metrics - The metrics for the entity's recommendations.\n * @param {RecommenderMetricsHistory[]} history - The historical metrics for the entity's recommendations.\n * @returns {string} The formatted recommender report.\n */\nexport function formatRecommenderReport(\n\tentity: Entity,\n\tmetrics: RecommenderMetrics,\n\thistory: RecommenderMetricsHistory[],\n): string {\n\tconst sortedHistory = [...history].sort(\n\t\t(a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(),\n\t);\n\n\t// Calculate performance trends for different time periods\n\tconst dailyTrends = calculatePeriodTrends(sortedHistory, {\n\t\tlabel: \"24 Hours\",\n\t\tdays: 1,\n\t});\n\tconst weeklyTrends = calculatePeriodTrends(sortedHistory, {\n\t\tlabel: \"7 Days\",\n\t\tdays: 7,\n\t});\n\tconst monthlyTrends = calculatePeriodTrends(sortedHistory);\n\n\t// Calculate success trend\n\tconst successTrend = calculateTrend(\n\t\tmetrics.successfulRecs / metrics.totalRecommendations,\n\t\tsortedHistory.map(\n\t\t\t(h) => h.metrics.successfulRecs / h.metrics.totalRecommendations,\n\t\t),\n\t);\n\n\t// Calculate performance trend\n\tconst performanceTrend = calculateTrend(\n\t\tmetrics.avgTokenPerformance,\n\t\tsortedHistory.map((h) => h.metrics.avgTokenPerformance),\n\t);\n\n\treturn `\nUsername: ${entity.metadata?.username || \"Unknown\"}\nPlatform: ${entity.metadata?.platform || \"Unknown\"}\nID: ${entity.id}\n\n=== CURRENT METRICS ===\nTrust Score: ${formatScore(metrics.trustScore)}\nSuccess Rate: ${formatPercentMetric(metrics.successfulRecs / metrics.totalRecommendations)} (${formatTrendArrow(successTrend)})\nTotal Recommendations: ${metrics.totalRecommendations}\nAverage Token Performance: ${formatPercent(metrics.avgTokenPerformance)} (${formatTrendArrow(performanceTrend)})\n\nRisk Analysis:\n- Consistency: ${formatScore(metrics.consistencyScore)}\n\nActivity Status:\n- Last Active: ${formatDate(metrics.lastUpdated)}\n\n=== PERFORMANCE TRENDS ===\n${formatTrends(dailyTrends)}\n\n${formatTrends(weeklyTrends)}\n\nMonthly Average Performance:\n${formatTrends(monthlyTrends)}`.trim();\n}\n\n/**\n * Formats the top recommenders overview based on the provided data.\n *\n * @param {Entity[]} recommenders - The list of recommenders to be formatted\n * @param {Map<string, RecommenderMetrics>} metrics - The map of recommender metrics\n * @param {Map<string, RecommenderMetricsHistory[]>} history - The map of historical metrics data\n * @returns {string} The formatted top recommenders overview\n */\nexport function formatTopRecommendersOverview(\n\trecommenders: Entity[],\n\tmetrics: Map<string, RecommenderMetrics>,\n\thistory: Map<string, RecommenderMetricsHistory[]>,\n): string {\n\tconst sortedRecommenders = [...recommenders].sort((a, b) => {\n\t\tif (!a.id || !b.id) return 0;\n\t\tconst metricsA = metrics.get(a.id);\n\t\tconst metricsB = metrics.get(b.id);\n\t\tif (!metricsA || !metricsB) return 0;\n\t\treturn metricsB.trustScore - metricsA.trustScore;\n\t});\n\n\treturn `\n<top_recommenders>\n${sortedRecommenders\n\t.map((entity) => {\n\t\tif (!entity.id) return null;\n\t\tconst metric = metrics.get(entity.id);\n\t\tif (!metric) return null;\n\t\tconst historicalData = history.get(entity.id) || [];\n\t\tconst trustTrend = calculateMetricTrend(\n\t\t\tmetric,\n\t\t\t\"trustScore\",\n\t\t\thistoricalData,\n\t\t);\n\n\t\tconst performanceTrend = calculateMetricTrend(\n\t\t\tmetric,\n\t\t\t\"avgTokenPerformance\",\n\t\t\thistoricalData,\n\t\t);\n\n\t\treturn `\n${entity.metadata?.username || \"Unknown\"} (${entity.metadata?.platform || \"Unknown\"})\nTrust Score: ${formatScore(metric.trustScore)} (${formatPercent(trustTrend.trend)} ${trustTrend.description})\nPerformance Score: ${formatScore(metric.avgTokenPerformance)} (${formatPercent(performanceTrend.trend)} ${performanceTrend.description})\nSuccess Rate: ${formatPercentMetric(metric.successfulRecs / metric.totalRecommendations)}\nLast Active: ${formatDate(metric.lastUpdated)}\n  `.trim();\n\t})\n\t.filter((report) => report !== null)\n\t.join(\"\\n\\n\")}\n</top_recommenders>`.trim();\n}\n"],"mappings":"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","names":["transactions"]}

package/dist/routes.d.ts

@@ -0,0 +1,3 @@
+import type { Route } from "@elizaos/core";
+export declare const communityInvestorRoutes: Route[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,KAAK,EAGL,MAAM,eAAe,CAAC;AA2EvB,eAAO,MAAM,uBAAuB,EAAE,KAAK,EAM1C,CAAC"}

package/dist/routes.js

@@ -0,0 +1,59 @@
+import { logger } from "@elizaos/core";
+import { ServiceType } from "./types.js";
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function nodeResponse(res) {
+  return res;
+}
+function sendSuccess(res, data, status = 200) {
+  const nodeRes = nodeResponse(res);
+  nodeRes.writeHead(status, { "Content-Type": "application/json" });
+  nodeRes.end(JSON.stringify({ success: true, data }));
+}
+function sendError(res, status, code, message, details) {
+  const nodeRes = nodeResponse(res);
+  nodeRes.writeHead(status, { "Content-Type": "application/json" });
+  nodeRes.end(
+    JSON.stringify({ success: false, error: { code, message, details } })
+  );
+}
+async function getLeaderboardDataHandler(_req, res, runtime) {
+  const service = runtime.getService(
+    ServiceType.COMMUNITY_INVESTOR
+  );
+  if (!service) {
+    return sendError(
+      res,
+      500,
+      "SERVICE_NOT_FOUND",
+      "CommunityInvestorService not found"
+    );
+  }
+  try {
+    const leaderboardData = await service.getLeaderboardData(runtime);
+    sendSuccess(res, leaderboardData);
+  } catch (error) {
+    logger.error(
+      `[API /leaderboard] Error fetching leaderboard data: ${errorMessage(error)}`
+    );
+    sendError(
+      res,
+      500,
+      "LEADERBOARD_ERROR",
+      "Failed to fetch leaderboard data",
+      errorMessage(error)
+    );
+  }
+}
+const communityInvestorRoutes = [
+  {
+    type: "GET",
+    path: "/api/social-alpha/leaderboard",
+    handler: getLeaderboardDataHandler
+  }
+];
+export {
+  communityInvestorRoutes
+};
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routes.ts"],"sourcesContent":["import type {\n\tIAgentRuntime,\n\tRoute,\n\tRouteRequest,\n\tRouteResponse,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport type { CommunityInvestorService } from \"./service.js\";\nimport { ServiceType } from \"./types.js\";\n\ntype JsonResponseBody = Record<string, unknown> | unknown[];\ntype NodeStyleRouteResponse = RouteResponse & {\n\twriteHead(status: number, headers: Record<string, string>): void;\n\tend(chunk?: string): RouteResponse;\n};\n\nfunction errorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction nodeResponse(res: RouteResponse): NodeStyleRouteResponse {\n\treturn res as NodeStyleRouteResponse;\n}\n\n// Helper to send success response\nfunction sendSuccess(res: RouteResponse, data: JsonResponseBody, status = 200) {\n\tconst nodeRes = nodeResponse(res);\n\tnodeRes.writeHead(status, { \"Content-Type\": \"application/json\" });\n\tnodeRes.end(JSON.stringify({ success: true, data }));\n}\n\n// Helper to send error response\nfunction sendError(\n\tres: RouteResponse,\n\tstatus: number,\n\tcode: string,\n\tmessage: string,\n\tdetails?: string,\n) {\n\tconst nodeRes = nodeResponse(res);\n\tnodeRes.writeHead(status, { \"Content-Type\": \"application/json\" });\n\tnodeRes.end(\n\t\tJSON.stringify({ success: false, error: { code, message, details } }),\n\t);\n}\n\nasync function getLeaderboardDataHandler(\n\t_req: RouteRequest,\n\tres: RouteResponse,\n\truntime: IAgentRuntime,\n) {\n\tconst service = runtime.getService<CommunityInvestorService>(\n\t\tServiceType.COMMUNITY_INVESTOR,\n\t);\n\tif (!service) {\n\t\treturn sendError(\n\t\t\tres,\n\t\t\t500,\n\t\t\t\"SERVICE_NOT_FOUND\",\n\t\t\t\"CommunityInvestorService not found\",\n\t\t);\n\t}\n\ttry {\n\t\tconst leaderboardData = await service.getLeaderboardData(runtime);\n\t\t// Return the leaderboard data directly as an array, not wrapped in an object\n\t\tsendSuccess(res, leaderboardData);\n\t} catch (error: unknown) {\n\t\tlogger.error(\n\t\t\t`[API /leaderboard] Error fetching leaderboard data: ${errorMessage(error)}`,\n\t\t);\n\t\tsendError(\n\t\t\tres,\n\t\t\t500,\n\t\t\t\"LEADERBOARD_ERROR\",\n\t\t\t\"Failed to fetch leaderboard data\",\n\t\t\terrorMessage(error),\n\t\t);\n\t}\n}\n\nexport const communityInvestorRoutes: Route[] = [\n\t{\n\t\ttype: \"GET\",\n\t\tpath: \"/api/social-alpha/leaderboard\",\n\t\thandler: getLeaderboardDataHandler,\n\t},\n];\n"],"mappings":"AAMA,SAAS,cAAc;AAEvB,SAAS,mBAAmB;AAQ5B,SAAS,aAAa,OAAwB;AAC7C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC7D;AAEA,SAAS,aAAa,KAA4C;AACjE,SAAO;AACR;AAGA,SAAS,YAAY,KAAoB,MAAwB,SAAS,KAAK;AAC9E,QAAM,UAAU,aAAa,GAAG;AAChC,UAAQ,UAAU,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAChE,UAAQ,IAAI,KAAK,UAAU,EAAE,SAAS,MAAM,KAAK,CAAC,CAAC;AACpD;AAGA,SAAS,UACR,KACA,QACA,MACA,SACA,SACC;AACD,QAAM,UAAU,aAAa,GAAG;AAChC,UAAQ,UAAU,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC;AAChE,UAAQ;AAAA,IACP,KAAK,UAAU,EAAE,SAAS,OAAO,OAAO,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;AAAA,EACrE;AACD;AAEA,eAAe,0BACd,MACA,KACA,SACC;AACD,QAAM,UAAU,QAAQ;AAAA,IACvB,YAAY;AAAA,EACb;AACA,MAAI,CAAC,SAAS;AACb,WAAO;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AACA,MAAI;AACH,UAAM,kBAAkB,MAAM,QAAQ,mBAAmB,OAAO;AAEhE,gBAAY,KAAK,eAAe;AAAA,EACjC,SAAS,OAAgB;AACxB,WAAO;AAAA,MACN,uDAAuD,aAAa,KAAK,CAAC;AAAA,IAC3E;AACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,aAAa,KAAK;AAAA,IACnB;AAAA,EACD;AACD;AAEO,MAAM,0BAAmC;AAAA,EAC/C;AAAA,IACC,MAAM;AAAA,IACN,MAAM;AAAA,IACN,SAAS;AAAA,EACV;AACD;","names":[]}