@undesirables/plugin-tcg-oracle 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,434 +1,616 @@
-/**
- * TCG Oracle — ElizaOS Plugin v1.0.0
- * ====================================
- * AI-powered trading card market intelligence for ElizaOS agents.
- * Native TypeScript rewrite of the Python G.A.M.E. SDK version.
- *
- * Features:
- * - Search 370K+ TCG products across 25 games (Pokemon, MTG, Yu-Gi-Oh, etc.)
- * - AI Vision card grading (PSA/Beckett prediction via Qwen VL)
- * - Monte Carlo price simulation (Heston, Merton, Kou stochastic models)
- * - Real-time market snapshots from TCGCSV daily data
- * - License key purchase & verification (Ethereum NFT)
- *
- * @see https://the-undesirables.com
- * @see https://github.com/sailorpepe/elizaos-tcg-oracle-plugin
- */
-import { validateTcgOracleConfig } from "./environment.js";
-// ============================================================
-// Configuration
-// ============================================================
-const SUPPORTED_GAMES = [
-    "Pokemon",
-    "Magic: The Gathering",
-    "Yu-Gi-Oh!",
-    "Lorcana",
-    "One Piece",
-    "Flesh and Blood",
-    "Star Wars: Unlimited",
-    "Dragon Ball Super",
-    "Digimon",
-    "MetaZoo",
-    "Union Arena",
-    "Gundam Card Game",
-    "LoL Riftbound",
+// src/environment.ts
+function validateTcgOracleConfig(runtime) {
+  const url = runtime.getSetting?.("TCG_ORACLE_URL") || process.env.TCG_ORACLE_URL || "";
+  if (!url) {
+    return {
+      valid: false,
+      error: "TCG_ORACLE_URL is required. Set it in your character.json settings or as an environment variable. Example: https://oracle.the-undesirables.com"
+    };
+  }
+  try {
+    new URL(url);
+  } catch {
+    return {
+      valid: false,
+      error: `TCG_ORACLE_URL is not a valid URL: "${url}"`
+    };
+  }
+  return { valid: true };
+}
+
+// src/services.ts
+import { Service } from "@elizaos/core";
+var MarketMonitorService = class _MarketMonitorService extends Service {
+  // Use a string getter to satisfy ElizaOS ServiceType constraints if needed,
+  // or define static serviceType depending on the core version.
+  static serviceType = "TCG_MARKET_MONITOR";
+  get capabilityDescription() {
+    return "Monitors TCG market data for price spikes and trending cards";
+  }
+  static async start(runtime) {
+    const service = new _MarketMonitorService();
+    await service.initialize(runtime);
+    return service;
+  }
+  monitorInterval = null;
+  async initialize(_runtime) {
+    console.log("[TCG Oracle Service] Market Monitor Service initialized.");
+  }
+  async stop() {
+    if (this.monitorInterval) {
+      clearInterval(this.monitorInterval);
+    }
+    console.log("[TCG Oracle Service] Market Monitor Service stopped.");
+  }
+  pollMarket() {
+    console.log("[TCG Oracle Service] Background task: Polling TCG market for price spikes...");
+  }
+};
+
+// src/index.ts
+var SUPPORTED_GAMES = [
+  "Pokemon",
+  "Magic: The Gathering",
+  "Yu-Gi-Oh!",
+  "Lorcana",
+  "One Piece",
+  "Flesh and Blood",
+  "Star Wars: Unlimited",
+  "Dragon Ball Super",
+  "Digimon",
+  "MetaZoo",
+  "Union Arena",
+  "Gundam Card Game",
+  "LoL Riftbound"
 ];
-const SIMULATION_MODELS = ["heston", "merton", "kou"];
-// ============================================================
-// API Client
-// ============================================================
+var SIMULATION_MODELS = ["heston", "merton", "kou"];
 function getBaseUrl(runtime) {
-    return (runtime.getSetting?.("TCG_ORACLE_URL") ||
-        process.env.TCG_ORACLE_URL ||
-        "");
+  return runtime.getSetting?.("TCG_ORACLE_URL") || process.env.TCG_ORACLE_URL || "";
 }
 async function callApi(baseUrl, endpoint, params) {
-    if (!baseUrl) {
-        return {
-            error: "TCG_ORACLE_URL not set. Set it in your character.json settings or as an environment variable. Install the server: pip install undesirables-mcp-server",
-        };
-    }
-    const url = new URL(`${baseUrl}${endpoint}`);
-    for (const [key, value] of Object.entries(params)) {
-        if (value !== undefined && value !== null && value !== "") {
-            url.searchParams.set(key, String(value));
-        }
+  if (!baseUrl) {
+    return {
+      error: "TCG_ORACLE_URL not set. Set it in your character.json settings or as an environment variable. Install the server: pip install undesirables-mcp-server"
+    };
+  }
+  const url = new URL(`${baseUrl}${endpoint}`);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null && value !== "") {
+      url.searchParams.set(key, String(value));
     }
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 30_000);
-        const response = await fetch(url.toString(), {
-            signal: controller.signal,
-            headers: { "User-Agent": "elizaos-tcg-oracle-plugin/1.0.0" },
-        });
-        clearTimeout(timeout);
-        if (!response.ok) {
-            return { error: `API returned HTTP ${response.status}` };
-        }
-        const json = (await response.json());
-        return { data: json.data || json };
+  }
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e4);
+    const response = await fetch(url.toString(), {
+      signal: controller.signal,
+      headers: { "User-Agent": "elizaos-tcg-oracle-plugin/1.0.0" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) {
+      return { error: `API returned HTTP ${response.status}` };
     }
-    catch (err) {
-        if (err.name === "AbortError") {
-            return { error: "TCG Oracle API timed out (30s)" };
-        }
-        return {
-            error: "Failed to connect to TCG Oracle API. Is the server running?",
-        };
+    const json = await response.json();
+    return { data: json.data || json };
+  } catch (err) {
+    if (err.name === "AbortError") {
+      return { error: "TCG Oracle API timed out (30s)" };
     }
+    return {
+      error: "Failed to connect to TCG Oracle API. Is the server running?"
+    };
+  }
 }
-// ============================================================
-// Helper: Truncate data safely before JSON.stringify
-// ============================================================
 function safeStringify(data, maxItems = 10) {
-    if (Array.isArray(data)) {
-        return JSON.stringify(data.slice(0, maxItems), null, 2);
-    }
-    return JSON.stringify(data, null, 2).slice(0, 2000);
+  if (Array.isArray(data)) {
+    return JSON.stringify(data.slice(0, maxItems), null, 2);
+  }
+  return JSON.stringify(data, null, 2).slice(0, 2e3);
 }
-// ============================================================
-// ACTION 1: Search TCG Products
-// ============================================================
-const searchAction = {
-    name: "TCG_ORACLE_SEARCH",
-    description: "Search for trading card products across 25 games including Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, One Piece, and more. Returns product names, set info, and current market prices from 370K+ real products sourced from TCGCSV daily.",
-    similes: [
-        "SEARCH_CARDS",
-        "FIND_CARD",
-        "CARD_LOOKUP",
-        "CARD_SEARCH",
-        "TCG_SEARCH",
-        "FIND_POKEMON",
-        "SEARCH_MTG",
+var searchAction = {
+  name: "TCG_ORACLE_SEARCH",
+  description: "Search for trading card products across 25 games including Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, One Piece, and more. Returns product names, set info, and current market prices from 370K+ real products sourced from TCGCSV daily.",
+  similes: [
+    "SEARCH_CARDS",
+    "FIND_CARD",
+    "CARD_LOOKUP",
+    "CARD_SEARCH",
+    "TCG_SEARCH",
+    "FIND_POKEMON",
+    "SEARCH_MTG"
+  ],
+  parameters: [
+    {
+      name: "query",
+      description: "The card name, set name, or keyword to search for (e.g., 'Charizard', 'Base Set', 'Pikachu VMAX')",
+      required: true,
+      schema: { type: "string" }
+    },
+    {
+      name: "limit",
+      description: "Maximum number of results to return (default: 10, max: 50)",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Search for Charizard cards" } },
+      { name: "{{agentName}}", content: { text: "Searching TCG Oracle for Charizard...", action: "TCG_ORACLE_SEARCH" } }
     ],
-    parameters: [
-        {
-            name: "query",
-            description: "The card name, set name, or keyword to search for (e.g., 'Charizard', 'Base Set', 'Pikachu VMAX')",
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "limit",
-            description: "Maximum number of results to return (default: 10, max: 50)",
-            required: false,
-            schema: { type: "number" },
-        },
+    [
+      { name: "{{user1}}", content: { text: "What Pikachu VMAX cards are available?" } },
+      { name: "{{agentName}}", content: { text: "Looking up Pikachu VMAX products...", action: "TCG_ORACLE_SEARCH" } }
     ],
-    examples: [
-        [
-            { name: "{{user1}}", content: { text: "Search for Charizard cards" } },
-            { name: "{{agentName}}", content: { text: "Searching TCG Oracle for Charizard...", action: "TCG_ORACLE_SEARCH" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "What Pikachu VMAX cards are available?" } },
-            { name: "{{agentName}}", content: { text: "Looking up Pikachu VMAX products...", action: "TCG_ORACLE_SEARCH" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "Find me Base Set holographic cards" } },
-            { name: "{{agentName}}", content: { text: "Searching for Base Set holographic cards...", action: "TCG_ORACLE_SEARCH" } },
-        ],
+    [
+      { name: "{{user1}}", content: { text: "Find me Base Set holographic cards" } },
+      { name: "{{agentName}}", content: { text: "Searching for Base Set holographic cards...", action: "TCG_ORACLE_SEARCH" } }
+    ]
+  ],
+  validate: async (runtime) => {
+    return !!getBaseUrl(runtime);
+  },
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content.text || "";
+    const query = text.replace(/^(search|find|look up|lookup|what|show me)\s+(for\s+)?/i, "").replace(/\s+cards?\s*$/i, "").trim();
+    if (!query) {
+      if (callback) await callback({ text: "What card would you like me to search for?" });
+      return { success: false, error: "No search query provided" };
+    }
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/search", {
+      query,
+      limit: 10
+    });
+    if (result.error) {
+      if (callback) await callback({ text: `Search failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data);
+    const responseText = `Found products matching "${query}":
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_SEARCH");
+    return { success: true, text: responseText, data: { search_results: result.data } };
+  }
+};
+var gradeAction = {
+  name: "TCG_ORACLE_GRADE",
+  description: "Grade a TCG card image using AI vision (Qwen VL model running locally). Predicts PSA and Beckett grading scores by analyzing centering, corners, edges, surface condition, and print quality. Works with Pokemon, MTG, Yu-Gi-Oh, and other TCG cards.",
+  similes: [
+    "GRADE_CARD",
+    "CARD_GRADING",
+    "PSA_GRADE",
+    "BECKETT_GRADE",
+    "RATE_CARD",
+    "EVALUATE_CARD"
+  ],
+  parameters: [
+    {
+      name: "image_url",
+      description: "Direct URL to the card image (PNG, JPG, or WebP)",
+      required: true,
+      schema: { type: "string" }
+    },
+    {
+      name: "game",
+      description: "The TCG game this card belongs to (default: Pokemon)",
+      required: false,
+      schema: { type: "string" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Grade this card: https://example.com/charizard.jpg" } },
+      { name: "{{agentName}}", content: { text: "Analyzing card image for grading...", action: "TCG_ORACLE_GRADE" } }
     ],
-    validate: async (runtime) => {
-        return !!getBaseUrl(runtime);
+    [
+      { name: "{{user1}}", content: { text: "What PSA grade would this get? https://i.imgur.com/card.png" } },
+      { name: "{{agentName}}", content: { text: "Running AI vision grading analysis...", action: "TCG_ORACLE_GRADE" } }
+    ],
+    [
+      { name: "{{user1}}", content: { text: "Rate the condition of this Magic card https://example.com/mtg.jpg" } },
+      { name: "{{agentName}}", content: { text: "Evaluating card condition for Beckett grading...", action: "TCG_ORACLE_GRADE" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content.text || "";
+    const urlMatch = text.match(/https?:\/\/[^\s]+/);
+    if (!urlMatch) {
+      if (callback) await callback({ text: "Please provide a card image URL to grade." });
+      return { success: false, error: "No image URL found in message" };
+    }
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/grade", {
+      image_url: urlMatch[0],
+      game: "Pokemon"
+    });
+    if (result.error) {
+      if (callback) await callback({ text: `Grading failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data);
+    const responseText = `Card grading complete:
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_GRADE");
+    return { success: true, text: responseText, data: { grade_result: result.data } };
+  }
+};
+var simulateAction = {
+  name: "TCG_ORACLE_SIMULATE",
+  description: "Run Monte Carlo simulation on a TCG card's price to predict future value. Uses real drift and volatility computed from TCGCSV historical data. Supports three stochastic models: Heston (stochastic volatility), Merton (jump-diffusion), and Kou (double-exponential jumps). Returns percentile bands (5th, 25th, 50th, 75th, 95th) for the forecast period.",
+  similes: [
+    "SIMULATE_PRICE",
+    "PRICE_PREDICTION",
+    "FORECAST_PRICE",
+    "MONTE_CARLO",
+    "PRICE_FORECAST",
+    "WHAT_WILL_THIS_BE_WORTH"
+  ],
+  parameters: [
+    {
+      name: "card_name",
+      description: "Name of the card to simulate",
+      required: true,
+      schema: { type: "string" }
     },
-    handler: async (runtime, message, _state, _options, callback) => {
-        const text = message.content.text || "";
-        // Extract search query — strip common prefixes
-        const query = text
-            .replace(/^(search|find|look up|lookup|what|show me)\s+(for\s+)?/i, "")
-            .replace(/\s+cards?\s*$/i, "")
-            .trim();
-        if (!query) {
-            if (callback)
-                await callback({ text: "What card would you like me to search for?" });
-            return { success: false, error: "No search query provided" };
-        }
-        const result = await callApi(getBaseUrl(runtime), "/api/v1/search", {
-            query,
-            limit: 10,
-        });
-        if (result.error) {
-            if (callback)
-                await callback({ text: `Search failed: ${result.error}` });
-            return { success: false, error: result.error };
-        }
-        const summary = safeStringify(result.data);
-        const responseText = `Found products matching "${query}":\n\n${summary}`;
-        if (callback)
-            await callback({ text: responseText }, "TCG_ORACLE_SEARCH");
-        return { success: true, text: responseText, data: { search_results: result.data } };
+    {
+      name: "current_price",
+      description: "Current price in USD",
+      required: true,
+      schema: { type: "number" }
     },
-};
-// ============================================================
-// ACTION 2: AI Card Grading
-// ============================================================
-const gradeAction = {
-    name: "TCG_ORACLE_GRADE",
-    description: "Grade a TCG card image using AI vision (Qwen VL model running locally). Predicts PSA and Beckett grading scores by analyzing centering, corners, edges, surface condition, and print quality. Works with Pokemon, MTG, Yu-Gi-Oh, and other TCG cards.",
-    similes: [
-        "GRADE_CARD",
-        "CARD_GRADING",
-        "PSA_GRADE",
-        "BECKETT_GRADE",
-        "RATE_CARD",
-        "EVALUATE_CARD",
-    ],
-    parameters: [
-        {
-            name: "image_url",
-            description: "Direct URL to the card image (PNG, JPG, or WebP)",
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "game",
-            description: "The TCG game this card belongs to (default: Pokemon)",
-            required: false,
-            schema: { type: "string" },
-        },
+    {
+      name: "model",
+      description: "Stochastic model: 'heston', 'merton', or 'kou'",
+      required: false,
+      schema: { type: "string", enumValues: ["heston", "merton", "kou"] }
+    },
+    {
+      name: "days",
+      description: "Forecast horizon in days (default: 30)",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Simulate the price of Charizard VMAX at $350 for 60 days" } },
+      { name: "{{agentName}}", content: { text: "Running Monte Carlo simulation on Charizard VMAX...", action: "TCG_ORACLE_SIMULATE" } }
     ],
-    examples: [
-        [
-            { name: "{{user1}}", content: { text: "Grade this card: https://example.com/charizard.jpg" } },
-            { name: "{{agentName}}", content: { text: "Analyzing card image for grading...", action: "TCG_ORACLE_GRADE" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "What PSA grade would this get? https://i.imgur.com/card.png" } },
-            { name: "{{agentName}}", content: { text: "Running AI vision grading analysis...", action: "TCG_ORACLE_GRADE" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "Rate the condition of this Magic card https://example.com/mtg.jpg" } },
-            { name: "{{agentName}}", content: { text: "Evaluating card condition for Beckett grading...", action: "TCG_ORACLE_GRADE" } },
-        ],
+    [
+      { name: "{{user1}}", content: { text: "What will a PSA 10 Base Set Blastoise worth $800 be in 90 days using merton model?" } },
+      { name: "{{agentName}}", content: { text: "Running Merton jump-diffusion simulation for Blastoise...", action: "TCG_ORACLE_SIMULATE" } }
     ],
-    validate: async (runtime) => !!getBaseUrl(runtime),
-    handler: async (runtime, message, _state, _options, callback) => {
-        const text = message.content.text || "";
-        // Extract URL from message
-        const urlMatch = text.match(/https?:\/\/[^\s]+/);
-        if (!urlMatch) {
-            if (callback)
-                await callback({ text: "Please provide a card image URL to grade." });
-            return { success: false, error: "No image URL found in message" };
-        }
-        const result = await callApi(getBaseUrl(runtime), "/api/v1/grade", {
-            image_url: urlMatch[0],
-            game: "Pokemon",
-        });
-        if (result.error) {
-            if (callback)
-                await callback({ text: `Grading failed: ${result.error}` });
-            return { success: false, error: result.error };
-        }
-        const summary = safeStringify(result.data);
-        const responseText = `Card grading complete:\n\n${summary}`;
-        if (callback)
-            await callback({ text: responseText }, "TCG_ORACLE_GRADE");
-        return { success: true, text: responseText, data: { grade_result: result.data } };
-    },
+    [
+      { name: "{{user1}}", content: { text: "Forecast Lorcana Elsa at $25 for 30 days" } },
+      { name: "{{agentName}}", content: { text: "Simulating Lorcana Elsa price trajectory...", action: "TCG_ORACLE_SIMULATE" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, options, callback) => {
+    const text = message.content.text || "";
+    const priceMatch = text.match(/\$?([\d,]+(?:\.\d{2})?)/);
+    const daysMatch = text.match(/(\d+)\s*days?/i);
+    const modelMatch = text.match(/\b(heston|merton|kou)\b/i);
+    const cardName = text.replace(/simulate|price|forecast|monte carlo|at|\$[\d,.]+|\d+\s*days?|heston|merton|kou/gi, "").replace(/\s+/g, " ").trim() || "Unknown Card";
+    const currentPrice = priceMatch ? parseFloat(priceMatch[1].replace(",", "")) : 0;
+    const days = daysMatch ? parseInt(daysMatch[1]) : 30;
+    const model = modelMatch ? modelMatch[1].toLowerCase() : "heston";
+    if (currentPrice <= 0) {
+      if (callback) await callback({ text: "Please provide a current price for the simulation. Example: 'Simulate Charizard VMAX at $350 for 60 days'" });
+      return { success: false, error: "Invalid or missing current price" };
+    }
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/simulate", {
+      card_name: cardName,
+      current_price: currentPrice,
+      model,
+      days,
+      simulations: 1e4
+    });
+    if (result.error) {
+      if (callback) await callback({ text: `Simulation failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data);
+    const responseText = `Monte Carlo simulation for ${cardName} ($${currentPrice}, ${model} model, ${days} days):
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_SIMULATE");
+    return { success: true, text: responseText, data: { simulation_result: result.data } };
+  }
 };
-// ============================================================
-// ACTION 3: Monte Carlo Price Simulation
-// ============================================================
-const simulateAction = {
-    name: "TCG_ORACLE_SIMULATE",
-    description: "Run Monte Carlo simulation on a TCG card's price to predict future value. Uses real drift and volatility computed from TCGCSV historical data. Supports three stochastic models: Heston (stochastic volatility), Merton (jump-diffusion), and Kou (double-exponential jumps). Returns percentile bands (5th, 25th, 50th, 75th, 95th) for the forecast period.",
-    similes: [
-        "SIMULATE_PRICE",
-        "PRICE_PREDICTION",
-        "FORECAST_PRICE",
-        "MONTE_CARLO",
-        "PRICE_FORECAST",
-        "WHAT_WILL_THIS_BE_WORTH",
-    ],
-    parameters: [
-        {
-            name: "card_name",
-            description: "Name of the card to simulate",
-            required: true,
-            schema: { type: "string" },
-        },
-        {
-            name: "current_price",
-            description: "Current price in USD",
-            required: true,
-            schema: { type: "number" },
-        },
-        {
-            name: "model",
-            description: "Stochastic model: 'heston', 'merton', or 'kou'",
-            required: false,
-            schema: { type: "string", enumValues: ["heston", "merton", "kou"] },
-        },
-        {
-            name: "days",
-            description: "Forecast horizon in days (default: 30)",
-            required: false,
-            schema: { type: "number" },
-        },
+var marketAction = {
+  name: "TCG_ORACLE_MARKET",
+  description: "Retrieve the latest daily market data snapshot from TCGCSV for a specific game. Returns top movers, price changes, volume data, and market trends. Data is refreshed daily via automated pipeline.",
+  similes: [
+    "MARKET_SNAPSHOT",
+    "MARKET_DATA",
+    "TCG_MARKET",
+    "CARD_MARKET",
+    "TOP_MOVERS",
+    "PRICE_CHANGES"
+  ],
+  parameters: [
+    {
+      name: "game",
+      description: "Game name: Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, One Piece, etc",
+      required: false,
+      schema: { type: "string" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Show me the Pokemon market snapshot" } },
+      { name: "{{agentName}}", content: { text: "Pulling the latest Pokemon market data...", action: "TCG_ORACLE_MARKET" } }
     ],
-    examples: [
-        [
-            { name: "{{user1}}", content: { text: "Simulate the price of Charizard VMAX at $350 for 60 days" } },
-            { name: "{{agentName}}", content: { text: "Running Monte Carlo simulation on Charizard VMAX...", action: "TCG_ORACLE_SIMULATE" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "What will a PSA 10 Base Set Blastoise worth $800 be in 90 days using merton model?" } },
-            { name: "{{agentName}}", content: { text: "Running Merton jump-diffusion simulation for Blastoise...", action: "TCG_ORACLE_SIMULATE" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "Forecast Lorcana Elsa at $25 for 30 days" } },
-            { name: "{{agentName}}", content: { text: "Simulating Lorcana Elsa price trajectory...", action: "TCG_ORACLE_SIMULATE" } },
-        ],
+    [
+      { name: "{{user1}}", content: { text: "What's happening in the Yu-Gi-Oh market today?" } },
+      { name: "{{agentName}}", content: { text: "Fetching Yu-Gi-Oh market snapshot...", action: "TCG_ORACLE_MARKET" } }
     ],
-    validate: async (runtime) => !!getBaseUrl(runtime),
-    handler: async (runtime, message, _state, options, callback) => {
-        const text = message.content.text || "";
-        // Try to extract parameters from text
-        const priceMatch = text.match(/\$?([\d,]+(?:\.\d{2})?)/);
-        const daysMatch = text.match(/(\d+)\s*days?/i);
-        const modelMatch = text.match(/\b(heston|merton|kou)\b/i);
-        const cardName = text
-            .replace(/simulate|price|forecast|monte carlo|at|\$[\d,.]+|\d+\s*days?|heston|merton|kou/gi, "")
-            .replace(/\s+/g, " ")
-            .trim() || "Unknown Card";
-        const currentPrice = priceMatch ? parseFloat(priceMatch[1].replace(",", "")) : 0;
-        const days = daysMatch ? parseInt(daysMatch[1]) : 30;
-        const model = modelMatch ? modelMatch[1].toLowerCase() : "heston";
-        if (currentPrice <= 0) {
-            if (callback)
-                await callback({ text: "Please provide a current price for the simulation. Example: 'Simulate Charizard VMAX at $350 for 60 days'" });
-            return { success: false, error: "Invalid or missing current price" };
-        }
-        const result = await callApi(getBaseUrl(runtime), "/api/v1/simulate", {
-            card_name: cardName,
-            current_price: currentPrice,
-            model,
-            days,
-            simulations: 10000,
-        });
-        if (result.error) {
-            if (callback)
-                await callback({ text: `Simulation failed: ${result.error}` });
-            return { success: false, error: result.error };
-        }
-        const summary = safeStringify(result.data);
-        const responseText = `Monte Carlo simulation for ${cardName} ($${currentPrice}, ${model} model, ${days} days):\n\n${summary}`;
-        if (callback)
-            await callback({ text: responseText }, "TCG_ORACLE_SIMULATE");
-        return { success: true, text: responseText, data: { simulation_result: result.data } };
-    },
+    [
+      { name: "{{user1}}", content: { text: "Top movers in Magic: The Gathering" } },
+      { name: "{{agentName}}", content: { text: "Pulling Magic: The Gathering market data...", action: "TCG_ORACLE_MARKET" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content.text?.toLowerCase() || "";
+    let game = "Pokemon";
+    for (const g of SUPPORTED_GAMES) {
+      if (text.includes(g.toLowerCase())) {
+        game = g;
+        break;
+      }
+    }
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/market", { game });
+    if (result.error) {
+      if (callback) await callback({ text: `Market data failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data, 25);
+    const responseText = `Market snapshot for ${game}:
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_MARKET");
+    return { success: true, text: responseText, data: { market_data: result.data } };
+  }
 };
-// ============================================================
-// ACTION 4: Market Snapshot
-// ============================================================
-const marketAction = {
-    name: "TCG_ORACLE_MARKET",
-    description: "Retrieve the latest daily market data snapshot from TCGCSV for a specific game. Returns top movers, price changes, volume data, and market trends. Data is refreshed daily via automated pipeline.",
-    similes: [
-        "MARKET_SNAPSHOT",
-        "MARKET_DATA",
-        "TCG_MARKET",
-        "CARD_MARKET",
-        "TOP_MOVERS",
-        "PRICE_CHANGES",
-    ],
-    parameters: [
-        {
-            name: "game",
-            description: "Game name: Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, One Piece, etc",
-            required: false,
-            schema: { type: "string" },
-        },
+var gradeOrNotAction = {
+  name: "TCG_ORACLE_GRADE_OR_NOT",
+  description: "Answers 'will grading this card make me money?' by combining AI grade prediction with PSA fee schedules, shipping costs, and graded market values. Returns a GO/NO-GO verdict with expected ROI and profit scenarios (best case, predicted, worst case).",
+  similes: [
+    "SHOULD_I_GRADE",
+    "GRADE_ROI",
+    "GRADING_PROFIT",
+    "IS_IT_WORTH_GRADING",
+    "GRADE_OR_NOT"
+  ],
+  parameters: [
+    {
+      name: "card_name",
+      description: "Name of the card to evaluate (e.g., 'Base Set Charizard Holo')",
+      required: true,
+      schema: { type: "string" }
+    },
+    {
+      name: "predicted_grade",
+      description: "Your predicted PSA grade (0 = auto-estimate)",
+      required: false,
+      schema: { type: "number" }
+    },
+    {
+      name: "raw_price",
+      description: "Current raw card value in USD (0 = auto-lookup)",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Should I grade my Base Set Charizard?" } },
+      { name: "{{agentName}}", content: { text: "Running Grade-or-Not analysis...", action: "TCG_ORACLE_GRADE_OR_NOT" } }
     ],
-    examples: [
-        [
-            { name: "{{user1}}", content: { text: "Show me the Pokemon market snapshot" } },
-            { name: "{{agentName}}", content: { text: "Pulling the latest Pokemon market data...", action: "TCG_ORACLE_MARKET" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "What's happening in the Yu-Gi-Oh market today?" } },
-            { name: "{{agentName}}", content: { text: "Fetching Yu-Gi-Oh market snapshot...", action: "TCG_ORACLE_MARKET" } },
-        ],
-        [
-            { name: "{{user1}}", content: { text: "Top movers in Magic: The Gathering" } },
-            { name: "{{agentName}}", content: { text: "Pulling Magic: The Gathering market data...", action: "TCG_ORACLE_MARKET" } },
-        ],
+    [
+      { name: "{{user1}}", content: { text: "Is it worth grading a PSA 8 Pikachu VMAX worth $45?" } },
+      { name: "{{agentName}}", content: { text: "Calculating grading ROI for Pikachu VMAX...", action: "TCG_ORACLE_GRADE_OR_NOT" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content.text || "";
+    const cardName = text.replace(/^(should i|is it worth|grade or not|grading roi|will grading)\s*/i, "").replace(/\s*(make me money|be profitable|worth it)\s*\??$/i, "").replace(/^(grade|grading)\s*/i, "").replace(/\bmy\b/i, "").trim() || "Unknown Card";
+    const priceMatch = text.match(/\$?([\d,]+(?:\.\d{2})?)/);
+    const gradeMatch = text.match(/\bpsa\s*(\d+(?:\.\d)?)\b/i) || text.match(/\bgrade\s*(\d+(?:\.\d)?)\b/i);
+    const params = { card_name: cardName };
+    if (priceMatch) params.raw_price = parseFloat(priceMatch[1].replace(",", ""));
+    if (gradeMatch) params.predicted_grade = parseFloat(gradeMatch[1]);
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/grade-or-not", params);
+    if (result.error) {
+      if (callback) await callback({ text: `Grade-or-Not analysis failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const data = result.data;
+    const verdict = data?.verdict || "Unknown";
+    const explanation = data?.explanation || "";
+    const responseText = `Grade-or-Not verdict for ${cardName}:
+
+${verdict}
+${explanation}
+
+Full analysis:
+${safeStringify(data)}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_GRADE_OR_NOT");
+    return { success: true, text: responseText, data: { grade_or_not: data } };
+  }
+};
+var trendingAction = {
+  name: "TCG_ORACLE_TRENDING",
+  description: "Returns the top trending trading cards by market activity (30-day sales volume, views, and price velocity). Covers all 25 supported TCG games. Useful for spotting market momentum and emerging opportunities.",
+  similes: [
+    "TRENDING_CARDS",
+    "HOT_CARDS",
+    "TOP_MOVERS",
+    "WHATS_TRENDING",
+    "POPULAR_CARDS",
+    "MARKET_TRENDS"
+  ],
+  parameters: [
+    {
+      name: "game",
+      description: "Filter by game name (empty = all games)",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "limit",
+      description: "Number of results (default: 25, max: 100)",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "What Pokemon cards are trending right now?" } },
+      { name: "{{agentName}}", content: { text: "Pulling trending Pokemon cards...", action: "TCG_ORACLE_TRENDING" } }
     ],
-    validate: async (runtime) => !!getBaseUrl(runtime),
-    handler: async (runtime, message, _state, _options, callback) => {
-        const text = message.content.text?.toLowerCase() || "";
-        // Detect game from message
-        let game = "Pokemon";
-        for (const g of SUPPORTED_GAMES) {
-            if (text.includes(g.toLowerCase())) {
-                game = g;
-                break;
-            }
-        }
-        const result = await callApi(getBaseUrl(runtime), "/api/v1/market", { game });
-        if (result.error) {
-            if (callback)
-                await callback({ text: `Market data failed: ${result.error}` });
-            return { success: false, error: result.error };
-        }
-        const summary = safeStringify(result.data, 25);
-        const responseText = `Market snapshot for ${game}:\n\n${summary}`;
-        if (callback)
-            await callback({ text: responseText }, "TCG_ORACLE_MARKET");
-        return { success: true, text: responseText, data: { market_data: result.data } };
+    [
+      { name: "{{user1}}", content: { text: "Show me the hottest cards across all games" } },
+      { name: "{{agentName}}", content: { text: "Fetching trending cards across all TCG games...", action: "TCG_ORACLE_TRENDING" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content?.text?.toLowerCase() || "";
+    let game = "";
+    for (const g of SUPPORTED_GAMES) {
+      if (text.includes(g.toLowerCase())) {
+        game = g;
+        break;
+      }
+    }
+    const params = { limit: 25 };
+    if (game) params.game = game;
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/trending", params);
+    if (result.error) {
+      if (callback) await callback({ text: `Trending cards failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data, 15);
+    const responseText = `Trending cards${game ? ` for ${game}` : " across all games"}:
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_TRENDING");
+    return { success: true, text: responseText, data: { trending: result.data } };
+  }
+};
+var arbGradeAction = {
+  name: "TCG_ORACLE_ARB_GRADE",
+  description: "Scans the TCG database for undervalued raw cards where grading would produce ROI above a threshold. Estimates PSA grades based on price tier and rarity, calculates expected graded values, and returns ranked opportunities sorted by expected profit.",
+  similes: [
+    "GRADING_ARBITRAGE",
+    "FIND_UNDERVALUED",
+    "ARBITRAGE_SCAN",
+    "PROFITABLE_CARDS",
+    "WHAT_TO_GRADE"
+  ],
+  parameters: [
+    {
+      name: "game",
+      description: "TCG game to scan (default: Pokemon)",
+      required: false,
+      schema: { type: "string" }
     },
+    {
+      name: "min_roi",
+      description: "Minimum expected ROI % to flag as opportunity (default: 50)",
+      required: false,
+      schema: { type: "number" }
+    }
+  ],
+  examples: [
+    [
+      { name: "{{user1}}", content: { text: "Find me profitable Pokemon cards to grade" } },
+      { name: "{{agentName}}", content: { text: "Scanning for grading arbitrage opportunities...", action: "TCG_ORACLE_ARB_GRADE" } }
+    ],
+    [
+      { name: "{{user1}}", content: { text: "What Magic cards have the best grading ROI?" } },
+      { name: "{{agentName}}", content: { text: "Running arbitrage scanner on Magic: The Gathering...", action: "TCG_ORACLE_ARB_GRADE" } }
+    ]
+  ],
+  validate: async (runtime) => !!getBaseUrl(runtime),
+  handler: async (runtime, message, _state, _options, callback) => {
+    const text = message.content?.text?.toLowerCase() || "";
+    let game = "Pokemon";
+    for (const g of SUPPORTED_GAMES) {
+      if (text.includes(g.toLowerCase())) {
+        game = g;
+        break;
+      }
+    }
+    const params = {
+      game,
+      min_roi: 50,
+      limit: 20
+    };
+    const result = await callApi(getBaseUrl(runtime), "/api/v1/arb-grade", params);
+    if (result.error) {
+      if (callback) await callback({ text: `Arbitrage scan failed: ${result.error}` });
+      return { success: false, error: result.error };
+    }
+    const summary = safeStringify(result.data, 15);
+    const responseText = `Grading arbitrage opportunities for ${game}:
+
+${summary}`;
+    if (callback) await callback({ text: responseText }, "TCG_ORACLE_ARB_GRADE");
+    return { success: true, text: responseText, data: { arbitrage: result.data } };
+  }
 };
-// ============================================================
-// PROVIDER: TCG Oracle Context
-// ============================================================
-const tcgOracleProvider = {
-    name: "tcg-oracle",
-    description: "Provides TCG Oracle market intelligence context to the agent",
-    get: async (runtime, _message, _state) => {
-        const baseUrl = getBaseUrl(runtime);
-        const status = baseUrl ? "connected" : "not configured";
-        return {
-            text: `[TCG Oracle]
+var tcgOracleProvider = {
+  name: "tcg-oracle",
+  description: "Provides TCG Oracle market intelligence context to the agent",
+  get: async (runtime, _message, _state) => {
+    const baseUrl = getBaseUrl(runtime);
+    const status = baseUrl ? "connected" : "not configured";
+    return {
+      text: `[TCG Oracle v1.1.0]
 Status: ${status}
 Database: 370,158 products across 25 games
 Data source: TCGCSV daily snapshots
 Models: Heston (stochastic vol), Merton (jump-diffusion), Kou (double-exp)
+Actions: search, grade, simulate, market, grade-or-not, trending, arb-grade
 Supported games: ${SUPPORTED_GAMES.join(", ")}
 API: ${baseUrl || "TCG_ORACLE_URL not set"}
 
-The agent can search cards, grade card images, simulate prices via Monte Carlo, and pull market snapshots.`,
-            values: {
-                tcgOracleStatus: status,
-                tcgOracleUrl: baseUrl || "not set",
-                totalProducts: 370158,
-            },
-        };
-    },
+The agent can search cards, grade card images, simulate prices via Monte Carlo, pull market snapshots, check grading ROI, view trending cards, and scan for grading arbitrage opportunities.`,
+      values: {
+        tcgOracleStatus: status,
+        tcgOracleUrl: baseUrl || "not set",
+        totalProducts: 370158
+      }
+    };
+  }
 };
-// ============================================================
-// PLUGIN EXPORT
-// ============================================================
-const tcgOraclePlugin = {
-    name: "@undesirables/plugin-tcg-oracle",
-    description: "TCG Oracle — AI-powered trading card market intelligence for ElizaOS agents. " +
-        "Covers 370K+ products across 25 games with Monte Carlo price simulation " +
-        "(Heston/Merton/Kou), AI vision card grading, and real-time market snapshots. " +
-        "Powered by TCGCSV daily data pipeline.",
-    init: async (config, runtime) => {
-        const validation = validateTcgOracleConfig(runtime);
-        if (!validation.valid) {
-            console.warn(`⚠️ TCG Oracle: ${validation.error}`);
-        }
-        else {
-            console.log(`✅ TCG Oracle connected to ${runtime.getSetting?.("TCG_ORACLE_URL")}`);
-        }
-    },
-    actions: [searchAction, gradeAction, simulateAction, marketAction],
-    providers: [tcgOracleProvider],
-    evaluators: [],
+var tcgOraclePlugin = {
+  name: "@undesirables/plugin-tcg-oracle",
+  description: "TCG Oracle \u2014 AI-powered trading card market intelligence for ElizaOS agents. Covers 370K+ products across 25 games with Monte Carlo price simulation (Heston/Merton/Kou), AI vision card grading with ROI analysis, trending cards feed, grading arbitrage scanner, and real-time market snapshots. Powered by TCGCSV daily data pipeline.",
+  init: async (config, runtime) => {
+    const validation = validateTcgOracleConfig(runtime);
+    if (!validation.valid) {
+      console.warn(`\u26A0\uFE0F TCG Oracle: ${validation.error}`);
+    } else {
+      console.log(`\u2705 TCG Oracle v1.1.0 connected to ${runtime.getSetting?.("TCG_ORACLE_URL")}`);
+    }
+  },
+  actions: [searchAction, gradeAction, simulateAction, marketAction, gradeOrNotAction, trendingAction, arbGradeAction],
+  providers: [tcgOracleProvider],
+  evaluators: [],
+  services: [MarketMonitorService]
+};
+var index_default = tcgOraclePlugin;
+export {
+  SIMULATION_MODELS,
+  SUPPORTED_GAMES,
+  index_default as default
 };
-export default tcgOraclePlugin;
-export { SUPPORTED_GAMES, SIMULATION_MODELS };
 //# sourceMappingURL=index.js.map