solana-agent-kit-plugin-madeonsol 0.6.1 → 0.7.0

package/dist/actions/kolAlertsRecent.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const kolAlertsRecentAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            window: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        window: z.ZodDefault<z.ZodEnum<["5m", "15m", "1h", "6h", "24h"]>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodEnum<["consensus_cluster", "fresh_token_kol_buy", "heating_up"]>, "many">>;
+        min_severity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        window: "24h" | "1h" | "6h" | "5m" | "15m";
+        types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+        min_severity?: "low" | "medium" | "high" | undefined;
+    }, {
+        limit?: number | undefined;
+        types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+        window?: "24h" | "1h" | "6h" | "5m" | "15m" | undefined;
+        min_severity?: "low" | "medium" | "high" | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        window?: string;
+        types?: string[];
+        min_severity?: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolAlertsRecent.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { kolAlertsRecent } from "../tools/index.js";
+export const kolAlertsRecentAction = {
+    name: "MADEONSOL_KOL_ALERTS_RECENT_ACTION",
+    similes: ["kol alerts", "recent kol alerts", "kol signals", "live kol feed", "kol events"],
+    description: "Live KOL alert feed from MadeOnSol — consensus clusters, fresh-token KOL buys, and heating-up wallets unified into one stream. Sorted by detected_at DESC then severity.",
+    examples: [
+        [
+            { input: { window: "15m", limit: 20 }, output: { status: "success" }, explanation: "Show recent KOL alerts in the last 15 minutes" },
+        ],
+    ],
+    schema: z.object({
+        window: z.enum(["5m", "15m", "1h", "6h", "24h"]).default("15m").describe("Lookback window"),
+        types: z.array(z.enum(["consensus_cluster", "fresh_token_kol_buy", "heating_up"])).optional().describe("Filter to specific alert types"),
+        min_severity: z.enum(["low", "medium", "high"]).optional().describe("Minimum severity to include"),
+        limit: z.number().min(1).max(200).default(50).describe("Max alerts"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolAlertsRecent(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolCompare.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const kolCompareAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            wallets: string[];
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallets: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        wallets: string[];
+    }, {
+        wallets: string[];
+    }>;
+    handler: (agent: unknown, input: {
+        wallets: string[];
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolCompare.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { kolCompare } from "../tools/index.js";
+export const kolCompareAction = {
+    name: "MADEONSOL_KOL_COMPARE_ACTION",
+    similes: ["compare kols", "compare wallets", "kol comparison", "side by side kols"],
+    description: "Side-by-side comparison of 2-5 Solana KOL wallets on MadeOnSol — strategy, winrates, ROI, PnL percentiles. PRO+ adds overlap tokens (bought by 2+ in last 30d). BASIC=2, PRO=4, ULTRA=5.",
+    examples: [
+        [
+            { input: { wallets: ["WalletA", "WalletB"] }, output: { status: "success" }, explanation: "Compare two KOL wallets side-by-side" },
+        ],
+    ],
+    schema: z.object({
+        wallets: z.array(z.string()).min(2).max(5).describe("2-5 wallet addresses"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolCompare(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolFeed.d.ts

@@ -22,8 +22,8 @@ export declare const kolFeedAction: {
         action?: "buy" | "sell" | undefined;
         kol?: string | undefined;
     }, {
-        action?: "buy" | "sell" | undefined;
         limit?: number | undefined;
+        action?: "buy" | "sell" | undefined;
         kol?: string | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/actions/kolTokenEntryOrder.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const kolTokenEntryOrderAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            mint: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        mint: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mint: string;
+        limit: number;
+    }, {
+        mint: string;
+        limit?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        mint: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolTokenEntryOrder.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { kolTokenEntryOrder } from "../tools/index.js";
+export const kolTokenEntryOrderAction = {
+    name: "MADEONSOL_KOL_TOKEN_ENTRY_ORDER_ACTION",
+    similes: ["who bought first", "first kol buyers", "kol entry order", "token entry ranking"],
+    description: "Get the ranked order of KOL first-buyers for a specific Solana token. Each entry includes seconds_after_first relative to the first KOL entry. PRO+ adds percentile_pnl_7d per entry.",
+    examples: [
+        [{ input: { mint: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", limit: 20 }, output: { status: "success" }, explanation: "Who were the first 20 KOLs to buy this token?" }],
+    ],
+    schema: z.object({
+        mint: z.string().describe("Token mint address (base58)"),
+        limit: z.number().min(1).max(200).default(50).describe("Max ranked entries"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolTokenEntryOrder(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/walletTracker.d.ts

@@ -116,10 +116,10 @@ export declare const walletTrackerTradesAction: {
         event_type?: "swap" | "transfer" | undefined;
         before?: number | undefined;
     }, {
+        limit?: number | undefined;
         wallet?: string | undefined;
         action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
         event_type?: "swap" | "transfer" | undefined;
-        limit?: number | undefined;
         before?: number | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/index.d.ts

@@ -5,7 +5,10 @@ import { deployerAlertsAction } from "./actions/deployerAlerts.js";
 import { kolPnlAction } from "./actions/kolPnl.js";
 import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
 import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction } from "./actions/walletTracker.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
+import { kolTokenEntryOrderAction } from "./actions/kolTokenEntryOrder.js";
+import { kolCompareAction } from "./actions/kolCompare.js";
+import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -15,6 +18,9 @@ declare const MadeOnSolPlugin: {
         deployerAlerts: typeof deployerAlerts;
         kolPnl: typeof kolPnl;
         kolTrendingTokens: typeof kolTrendingTokens;
+        kolTokenEntryOrder: typeof kolTokenEntryOrder;
+        kolCompare: typeof kolCompare;
+        kolAlertsRecent: typeof kolAlertsRecent;
         createWebhook: typeof createWebhook;
         listWebhooks: typeof listWebhooks;
         deleteWebhook: typeof deleteWebhook;
@@ -49,8 +55,8 @@ declare const MadeOnSolPlugin: {
             action?: "buy" | "sell" | undefined;
             kol?: string | undefined;
         }, {
-            action?: "buy" | "sell" | undefined;
             limit?: number | undefined;
+            action?: "buy" | "sell" | undefined;
             kol?: string | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -375,10 +381,10 @@ declare const MadeOnSolPlugin: {
             event_type?: "swap" | "transfer" | undefined;
             before?: number | undefined;
         }, {
+            limit?: number | undefined;
             wallet?: string | undefined;
             action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
             event_type?: "swap" | "transfer" | undefined;
-            limit?: number | undefined;
             before?: number | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -431,10 +437,121 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                mint: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            mint: import("zod").ZodString;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            mint: string;
+            limit: number;
+        }, {
+            mint: string;
+            limit?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            mint: string;
+            limit?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                wallets: string[];
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            wallets: import("zod").ZodArray<import("zod").ZodString, "many">;
+        }, "strip", import("zod").ZodTypeAny, {
+            wallets: string[];
+        }, {
+            wallets: string[];
+        }>;
+        handler: (agent: unknown, input: {
+            wallets: string[];
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                window: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            window: import("zod").ZodDefault<import("zod").ZodEnum<["5m", "15m", "1h", "6h", "24h"]>>;
+            types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<["consensus_cluster", "fresh_token_kol_buy", "heating_up"]>, "many">>;
+            min_severity: import("zod").ZodOptional<import("zod").ZodEnum<["low", "medium", "high"]>>;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            window: "24h" | "1h" | "6h" | "5m" | "15m";
+            types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+            min_severity?: "low" | "medium" | "high" | undefined;
+        }, {
+            limit?: number | undefined;
+            types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+            window?: "24h" | "1h" | "6h" | "5m" | "15m" | undefined;
+            min_severity?: "low" | "medium" | "high" | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            window?: string;
+            types?: string[];
+            min_severity?: string;
+            limit?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     })[];
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/index.js

@@ -5,7 +5,10 @@ import { deployerAlertsAction } from "./actions/deployerAlerts.js";
 import { kolPnlAction } from "./actions/kolPnl.js";
 import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
 import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction } from "./actions/walletTracker.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
+import { kolTokenEntryOrderAction } from "./actions/kolTokenEntryOrder.js";
+import { kolCompareAction } from "./actions/kolCompare.js";
+import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -15,6 +18,9 @@ const MadeOnSolPlugin = {
         deployerAlerts,
         kolPnl,
         kolTrendingTokens,
+        kolTokenEntryOrder,
+        kolCompare,
+        kolAlertsRecent,
         createWebhook,
         listWebhooks,
         deleteWebhook,
@@ -33,6 +39,9 @@ const MadeOnSolPlugin = {
         deployerAlertsAction,
         kolPnlAction,
         kolTrendingTokensAction,
+        kolTokenEntryOrderAction,
+        kolCompareAction,
+        kolAlertsRecentAction,
         walletTrackerWatchlistAction,
         walletTrackerAddAction,
         walletTrackerRemoveAction,
@@ -44,6 +53,6 @@ const MadeOnSolPlugin = {
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/tools/index.d.ts

@@ -47,6 +47,19 @@ export declare function kolTrendingTokens(agent: Agent, params?: {
     min_kols?: number;
     limit?: number;
 }): Promise<any>;
+export declare function kolTokenEntryOrder(agent: Agent, params: {
+    mint: string;
+    limit?: number;
+}): Promise<any>;
+export declare function kolCompare(agent: Agent, params: {
+    wallets: string[];
+}): Promise<any>;
+export declare function kolAlertsRecent(agent: Agent, params?: {
+    window?: string;
+    types?: string[];
+    min_severity?: string;
+    limit?: number;
+}): Promise<any>;
 export declare function kolPnl(agent: Agent, params: {
     wallet: string;
     period?: string;

package/dist/tools/index.js

@@ -106,6 +106,23 @@ export async function kolTrendingTokens(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/kol/tokens/trending", params);
 }
+export async function kolTokenEntryOrder(agent, params) {
+    await initAuth(agent);
+    const { mint, ...rest } = params;
+    return query(`/api/x402/kol/tokens/${encodeURIComponent(mint)}/entry-order`, rest);
+}
+export async function kolCompare(agent, params) {
+    await initAuth(agent);
+    return query("/api/x402/kol/compare", { wallets: params.wallets.join(",") });
+}
+export async function kolAlertsRecent(agent, params = {}) {
+    await initAuth(agent);
+    const { types, ...rest } = params;
+    const flat = { ...rest };
+    if (types && types.length > 0)
+        flat.types = types.join(",");
+    return query("/api/x402/kol/alerts/recent", flat);
+}
 export async function kolPnl(agent, params) {
     const qs = params.period ? `?period=${params.period}` : "";
     return restQuery(agent, "GET", `/kol/${params.wallet}/pnl${qs}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-agent-kit-plugin-madeonsol",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",