@undesirables/plugin-tcg-oracle 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             The Undesirables LLC
+Licensed Work:        plugin-undesirables
+                      The Licensed Work is (c) 2026 The Undesirables LLC
+Additional Use Grant: You may use the Licensed Work for non-production purposes,
+                      personal projects, and evaluation. Production use requires
+                      a commercial license from The Undesirables LLC.
+Change Date:          2030-04-24
+Change License:       MIT
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+For more information on the Business Source License, please visit:
+https://mariadb.com/bsl11/

package/README.md

@@ -0,0 +1,119 @@
+# @undesirables/plugin-tcg-oracle
+
+![TCG Oracle Banner](./images/banner.jpg)
+
+[![npm](https://img.shields.io/npm/v/@undesirables/plugin-tcg-oracle)](https://www.npmjs.com/package/@undesirables/plugin-tcg-oracle)
+[![License: BUSL-1.1](https://img.shields.io/badge/License-BUSL--1.1-blue)](LICENSE)
+
+> Give any ElizaOS agent real trading card market intelligence — search 370K+ products, grade cards with AI vision, and simulate future prices with Monte Carlo models.
+
+---
+
+## Why This Exists
+
+The trading card market is worth **$50 billion** and growing. Millions of people buy, sell, and grade cards every day. But the tools available to them are fragmented: you check prices on one site, send cards to PSA for $50+ and wait weeks for a grade, and have no way to forecast whether a card is going up or down.
+
+This plugin gives your ElizaOS agent the ability to do all of that in one conversation:
+
+1. **"Search for Charizard cards"** → Instantly searches 370K+ real products across 25 games
+2. **"Grade this card"** → AI vision analyzes centering, corners, edges, surface → predicts PSA/Beckett score
+3. **"Simulate Charizard VMAX at $350 for 60 days"** → Runs 10,000 Monte Carlo simulations using Heston, Merton, or Kou stochastic models → returns percentile price bands
+4. **"Show me the Pokemon market"** → Pulls the latest daily market snapshot with top movers and volume trends
+
+No API keys required from third parties. You just point it at the TCG Oracle server (self-hosted or public).
+
+---
+
+## Quick Start
+
+```bash
+npm install @undesirables/plugin-tcg-oracle
+```
+
+Add to your ElizaOS character file:
+
+```json
+{
+  "plugins": ["@undesirables/plugin-tcg-oracle"],
+  "settings": {
+    "TCG_ORACLE_URL": "https://oracle.the-undesirables.com"
+  }
+}
+```
+
+Start your agent:
+
+```bash
+elizaos start --character your-character.json
+```
+
+That's it. Your agent can now search cards, grade images, and run simulations.
+
+---
+
+## Actions
+
+| Action | What It Does | Example Prompt |
+|--------|-------------|----------------|
+| `TCG_ORACLE_SEARCH` | Search 370K+ products by card name, set, or keyword | "Search for Base Set Charizard" |
+| `TCG_ORACLE_GRADE` | Grade a card image URL — returns PSA/Beckett prediction | "Grade this card: https://..." |
+| `TCG_ORACLE_SIMULATE` | Monte Carlo price forecast with 3 stochastic models | "Simulate Charizard at $350 for 60 days" |
+| `TCG_ORACLE_MARKET` | Pull the latest daily market snapshot for any game | "Show me the Pokemon market" |
+
+---
+
+## Supported Games (25)
+
+Pokémon · Magic: The Gathering · Yu-Gi-Oh! · Disney Lorcana · One Piece · Flesh and Blood · Star Wars: Unlimited · Dragon Ball Super · Digimon · MetaZoo · Union Arena · Gundam Card Game · LoL Riftbound · and 12 more via TCGCSV
+
+---
+
+## How the Data Works
+
+All market data comes from [TCGCSV](https://tcgcsv.com) — a community project that snapshots pricing data daily for 25 TCG games. Our GitLab CI pipeline automatically refreshes this data every 24 hours. The full dataset (370K+ products) is also available on [Kaggle](https://www.kaggle.com/datasets/sailorpepe/tcg-market-intelligence).
+
+**Monte Carlo models explained:**
+- **Heston** — Models volatility itself as stochastic (volatility changes over time). Best for cards with unpredictable hype cycles.
+- **Merton** — Adds random jumps to the price process. Best for cards that can spike on tournament results or reprints.
+- **Kou** — Uses double-exponential jump distribution. Best for modeling asymmetric risk (big upside spikes vs gradual decline).
+
+---
+
+## Self-Hosting
+
+You can run your own TCG Oracle server instead of using the public API:
+
+```bash
+pip install undesirables-mcp-server
+undesirables-mcp --workspace ./my-workspace
+```
+
+Then point `TCG_ORACLE_URL` to `http://localhost:8000`.
+
+---
+
+## Configuration
+
+| Setting | Description | Required |
+|---------|-------------|----------|
+| `TCG_ORACLE_URL` | Base URL of the TCG Oracle API | Yes |
+
+---
+
+## Architecture
+
+This is a **native TypeScript** ElizaOS plugin. It runs natively in the ElizaOS Node.js runtime — no Python subprocess, no external CLI tools. It calls the TCG Oracle REST API via `fetch()` with 30-second timeouts and structured `parameters` for v2 LLM parameter extraction.
+
+---
+
+## Related Projects
+
+- [undesirables-mcp-server](https://github.com/sailorpepe/undesirables-mcp-server) — 36-tool MCP server (Glama Registry, PyPI)
+- [plugin-undesirables](https://github.com/sailorpepe/plugin-undesirables) — Soul personality plugin for ElizaOS
+- [tcg-oracle-tools](https://pypi.org/project/tcg-oracle-tools/) — Python SDK for TCG market analysis
+
+---
+
+## License
+
+[BUSL-1.1](LICENSE) — Business Source License 1.1. Copyright © 2026 The Undesirables LLC.

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.js

@@ -0,0 +1,184 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// Mock fetch globally
+const mockFetch = vi.fn();
+vi.stubGlobal("fetch", mockFetch);
+describe("plugin-tcg-oracle", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("Plugin Structure", () => {
+        it("should export a valid ElizaOS v2 plugin", async () => {
+            const plugin = (await import("./index.js")).default;
+            expect(plugin.name).toBe("@undesirables/plugin-tcg-oracle");
+            expect(plugin.description).toBeTruthy();
+            expect(plugin.actions).toHaveLength(4);
+            expect(plugin.providers).toHaveLength(1);
+            expect(plugin.evaluators).toEqual([]);
+        });
+        it("should have correct action names", async () => {
+            const plugin = (await import("./index.js")).default;
+            const names = plugin.actions.map((a) => a.name);
+            expect(names).toContain("TCG_ORACLE_SEARCH");
+            expect(names).toContain("TCG_ORACLE_GRADE");
+            expect(names).toContain("TCG_ORACLE_SIMULATE");
+            expect(names).toContain("TCG_ORACLE_MARKET");
+        });
+        it("should have a named provider", async () => {
+            const plugin = (await import("./index.js")).default;
+            const provider = plugin.providers[0];
+            expect(provider.name).toBe("tcg-oracle");
+            expect(provider.description).toBeTruthy();
+            expect(typeof provider.get).toBe("function");
+        });
+        it("actions should have examples with v2 format (name + content)", async () => {
+            const plugin = (await import("./index.js")).default;
+            for (const action of plugin.actions) {
+                expect(action.examples).toBeDefined();
+                expect(action.examples.length).toBeGreaterThanOrEqual(1);
+                for (const exampleGroup of action.examples) {
+                    for (const example of exampleGroup) {
+                        expect(example).toHaveProperty("name");
+                        expect(example).toHaveProperty("content");
+                    }
+                }
+            }
+        });
+        it("all actions should have structured parameters", async () => {
+            const plugin = (await import("./index.js")).default;
+            for (const action of plugin.actions) {
+                expect(action.parameters).toBeDefined();
+                expect(action.parameters.length).toBeGreaterThanOrEqual(1);
+                for (const param of action.parameters) {
+                    expect(param).toHaveProperty("name");
+                    expect(param).toHaveProperty("description");
+                    expect(param).toHaveProperty("schema");
+                }
+            }
+        });
+        it("all actions should have similes for discoverability", async () => {
+            const plugin = (await import("./index.js")).default;
+            for (const action of plugin.actions) {
+                expect(action.similes).toBeDefined();
+                expect(action.similes.length).toBeGreaterThanOrEqual(3);
+            }
+        });
+    });
+    describe("Action Validation", () => {
+        it("search action should reject when TCG_ORACLE_URL is not set", async () => {
+            const plugin = (await import("./index.js")).default;
+            const searchAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_SEARCH");
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue(""),
+                agentId: "test-agent",
+            };
+            const isValid = await searchAction.validate(mockRuntime);
+            expect(isValid).toBe(false);
+        });
+        it("search action should accept when TCG_ORACLE_URL is set", async () => {
+            const plugin = (await import("./index.js")).default;
+            const searchAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_SEARCH");
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const isValid = await searchAction.validate(mockRuntime);
+            expect(isValid).toBe(true);
+        });
+    });
+    describe("API Client Error Handling", () => {
+        it("search handler should return error when API is unreachable", async () => {
+            const plugin = (await import("./index.js")).default;
+            const searchAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_SEARCH");
+            mockFetch.mockRejectedValueOnce(new Error("ECONNREFUSED"));
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const mockMessage = {
+                content: { text: "Search for Charizard" },
+            };
+            let callbackText = "";
+            const mockCallback = vi.fn(async (response) => {
+                callbackText = response.text;
+            });
+            const result = await searchAction.handler(mockRuntime, mockMessage, undefined, undefined, mockCallback);
+            expect(result).toBeDefined();
+            expect(result.success).toBe(false);
+        });
+        it("search handler should handle API timeout (AbortError)", async () => {
+            const plugin = (await import("./index.js")).default;
+            const searchAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_SEARCH");
+            const abortError = new Error("The operation was aborted");
+            abortError.name = "AbortError";
+            mockFetch.mockRejectedValueOnce(abortError);
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const mockMessage = {
+                content: { text: "Search for Charizard" },
+            };
+            const mockCallback = vi.fn();
+            const result = await searchAction.handler(mockRuntime, mockMessage, undefined, undefined, mockCallback);
+            expect(result).toBeDefined();
+            expect(result.success).toBe(false);
+            expect(result.error).toContain("timed out");
+        });
+        it("grade handler should reject messages without image URLs", async () => {
+            const plugin = (await import("./index.js")).default;
+            const gradeAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_GRADE");
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const mockMessage = {
+                content: { text: "Grade my card please" },
+            };
+            const mockCallback = vi.fn();
+            const result = await gradeAction.handler(mockRuntime, mockMessage, undefined, undefined, mockCallback);
+            expect(result).toBeDefined();
+            expect(result.success).toBe(false);
+            expect(result.error).toContain("No image URL");
+        });
+        it("simulate handler should reject when no price is provided", async () => {
+            const plugin = (await import("./index.js")).default;
+            const simAction = plugin.actions.find((a) => a.name === "TCG_ORACLE_SIMULATE");
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const mockMessage = {
+                content: { text: "Simulate Charizard price" },
+            };
+            const mockCallback = vi.fn();
+            const result = await simAction.handler(mockRuntime, mockMessage, undefined, undefined, mockCallback);
+            expect(result).toBeDefined();
+            expect(result.success).toBe(false);
+        });
+    });
+    describe("Provider", () => {
+        it("should return connected status when URL is configured", async () => {
+            const plugin = (await import("./index.js")).default;
+            const provider = plugin.providers[0];
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue("https://oracle.the-undesirables.com"),
+                agentId: "test-agent",
+            };
+            const result = await provider.get(mockRuntime, {}, {});
+            expect(result.text).toContain("connected");
+            expect(result.values?.tcgOracleStatus).toBe("connected");
+        });
+        it("should return not configured status when URL is missing", async () => {
+            const plugin = (await import("./index.js")).default;
+            const provider = plugin.providers[0];
+            const mockRuntime = {
+                getSetting: vi.fn().mockReturnValue(""),
+                agentId: "test-agent",
+            };
+            const result = await provider.get(mockRuntime, {}, {});
+            expect(result.text).toContain("not configured");
+            expect(result.values?.tcgOracleStatus).toBe("not configured");
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/__tests__/index.test.js.map

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

package/dist/environment.d.ts

@@ -0,0 +1,10 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Validates that the TCG Oracle plugin has all required configuration.
+ * Called during plugin init and before each action.
+ */
+export declare function validateTcgOracleConfig(runtime: IAgentRuntime): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBpC"}

package/dist/environment.js

@@ -0,0 +1,27 @@
+/**
+ * Validates that the TCG Oracle plugin has all required configuration.
+ * Called during plugin init and before each action.
+ */
+export 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 };
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsB;IAEtB,MAAM,GAAG,GACN,OAAO,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAY;QAClD,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,EAAE,CAAC;IAEL,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EACH,qEAAqE;gBACrE,6EAA6E;SAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,uCAAuC,GAAG,GAAG;SACrD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 type { Plugin } from "@elizaos/core";
+declare const SUPPORTED_GAMES: readonly ["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"];
+declare const SIMULATION_MODELS: readonly ["heston", "merton", "kou"];
+declare const tcgOraclePlugin: Plugin;
+export default tcgOraclePlugin;
+export { SUPPORTED_GAMES, SIMULATION_MODELS };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EACV,MAAM,EAUP,MAAM,eAAe,CAAC;AAMvB,QAAA,MAAM,eAAe,6NAcX,CAAC;AAEX,QAAA,MAAM,iBAAiB,sCAAuC,CAAC;AAoc/D,QAAA,MAAM,eAAe,EAAE,MAkBtB,CAAC;AAEF,eAAe,eAAe,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,434 @@
+/**
+ * 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",
+];
+const SIMULATION_MODELS = ["heston", "merton", "kou"];
+// ============================================================
+// API Client
+// ============================================================
+function getBaseUrl(runtime) {
+    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));
+        }
+    }
+    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 };
+    }
+    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);
+}
+// ============================================================
+// 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",
+    ],
+    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" } },
+        ],
+        [
+            { 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" } },
+        ],
+    ],
+    validate: async (runtime) => {
+        return !!getBaseUrl(runtime);
+    },
+    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 } };
+    },
+};
+// ============================================================
+// 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" },
+        },
+    ],
+    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" } },
+        ],
+    ],
+    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 } };
+    },
+};
+// ============================================================
+// 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" },
+        },
+    ],
+    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" } },
+        ],
+    ],
+    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 } };
+    },
+};
+// ============================================================
+// 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" },
+        },
+    ],
+    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" } },
+        ],
+    ],
+    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 } };
+    },
+};
+// ============================================================
+// 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]
+Status: ${status}
+Database: 370,158 products across 25 games
+Data source: TCGCSV daily snapshots
+Models: Heston (stochastic vol), Merton (jump-diffusion), Kou (double-exp)
+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,
+            },
+        };
+    },
+};
+// ============================================================
+// 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: [],
+};
+export default tcgOraclePlugin;
+export { SUPPORTED_GAMES, SIMULATION_MODELS };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAe3D,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D,MAAM,eAAe,GAAG;IACtB,SAAS;IACT,sBAAsB;IACtB,WAAW;IACX,SAAS;IACT,WAAW;IACX,iBAAiB;IACjB,sBAAsB;IACtB,mBAAmB;IACnB,SAAS;IACT,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,eAAe;CACP,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAE/D,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D,SAAS,UAAU,CAAC,OAAsB;IACxC,OAAO,CACJ,OAAO,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAY;QAClD,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,EAAE,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,OAAe,EACf,QAAgB,EAChB,MAAuC;IAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EACH,uJAAuJ;SAC1J,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,EAAE,YAAY,EAAE,iCAAiC,EAAE;SAC7D,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,qBAAqB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;QACrD,CAAC;QACD,OAAO;YACL,KAAK,EAAE,6DAA6D;SACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,qDAAqD;AACrD,+DAA+D;AAE/D,SAAS,aAAa,CAAC,IAAS,EAAE,QAAQ,GAAG,EAAE;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAE/D,MAAM,YAAY,GAAW;IAC3B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,kPAAkP;IACpP,OAAO,EAAE;QACP,cAAc;QACd,WAAW;QACX,aAAa;QACb,aAAa;QACb,YAAY;QACZ,cAAc;QACd,YAAY;KACb;IACD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,mGAAmG;YAChH,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAmB;YACvF,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,uCAAuC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SACpI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,wCAAwC,EAAE,EAAmB;YACnG,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qCAAqC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SAClI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,oCAAoC,EAAE,EAAmB;YAC/F,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,6CAA6C,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SAC1I;KACF;IACD,QAAQ,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;QACzC,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,MAAc,EACd,QAAkC,EAClC,QAA0B,EACS,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAExC,+CAA+C;QAC/C,MAAM,KAAK,GAAG,IAAI;aACf,OAAO,CAAC,yDAAyD,EAAE,EAAE,CAAC;aACtE,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;aAC7B,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,4CAA4C,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;QAC/D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE;YAClE,KAAK;YACL,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,kBAAkB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,4BAA4B,KAAK,SAAS,OAAO,EAAE,CAAC;QAEzE,IAAI,QAAQ;YAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACtF,CAAC;CACF,CAAC;AAEF,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;AAE/D,MAAM,WAAW,GAAW;IAC1B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,uPAAuP;IACzP,OAAO,EAAE;QACP,YAAY;QACZ,cAAc;QACd,WAAW;QACX,eAAe;QACf,WAAW;QACX,eAAe;KAChB;IACD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,sDAAsD;YACnE,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,oDAAoD,EAAE,EAAmB;YAC/G,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qCAAqC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAmB;SACjI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,6DAA6D,EAAE,EAAmB;YACxH,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,uCAAuC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAmB;SACnI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,mEAAmE,EAAE,EAAmB;YAC9H,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,kDAAkD,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAmB;SAC9I;KACF;IACD,QAAQ,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACjE,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,MAAc,EACd,QAAkC,EAClC,QAA0B,EACS,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAExC,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,2CAA2C,EAAE,CAAC,CAAC;YACpF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE;YACjE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;YACtB,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,mBAAmB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,6BAA6B,OAAO,EAAE,CAAC;QAE5D,IAAI,QAAQ;YAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACpF,CAAC;CACF,CAAC;AAEF,+DAA+D;AAC/D,yCAAyC;AACzC,+DAA+D;AAE/D,MAAM,cAAc,GAAW;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,+VAA+V;IACjW,OAAO,EAAE;QACP,gBAAgB;QAChB,kBAAkB;QAClB,gBAAgB;QAChB,aAAa;QACb,gBAAgB;QAChB,yBAAyB;KAC1B;IACD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,8BAA8B;YAC3C,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE;SACpE;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,wCAAwC;YACrD,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0DAA0D,EAAE,EAAmB;YACrH,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qDAAqD,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAmB;SACpJ;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,oFAAoF,EAAE,EAAmB;YAC/I,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,2DAA2D,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAmB;SAC1J;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0CAA0C,EAAE,EAAmB;YACrG,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,6CAA6C,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAmB;SAC5I;KACF;IACD,QAAQ,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACjE,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,MAAc,EACd,OAAiC,EACjC,QAA0B,EACS,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAExC,sCAAsC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAE1D,MAAM,QAAQ,GACZ,IAAI;aACD,OAAO,CAAC,kFAAkF,EAAE,EAAE,CAAC;aAC/F,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE,IAAI,cAAc,CAAC;QAE9B,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAElE,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,2GAA2G,EAAE,CAAC,CAAC;YACpJ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE;YACpE,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,YAAY;YAC3B,KAAK;YACL,IAAI;YACJ,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,sBAAsB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,8BAA8B,QAAQ,MAAM,YAAY,KAAK,KAAK,WAAW,IAAI,cAAc,OAAO,EAAE,CAAC;QAE9H,IAAI,QAAQ;YAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAC5E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,iBAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACzF,CAAC;CACF,CAAC;AAEF,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;AAE/D,MAAM,YAAY,GAAW;IAC3B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,oMAAoM;IACtM,OAAO,EAAE;QACP,iBAAiB;QACjB,aAAa;QACb,YAAY;QACZ,aAAa;QACb,YAAY;QACZ,eAAe;KAChB;IACD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qCAAqC,EAAE,EAAmB;YAChG,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,2CAA2C,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SACxI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,gDAAgD,EAAE,EAAmB;YAC3G,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,sCAAsC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SACnI;QACD;YACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,oCAAoC,EAAE,EAAmB;YAC/F,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,6CAA6C,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAmB;SAC1I;KACF;IACD,QAAQ,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACjE,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,MAAc,EACd,QAAkC,EAClC,QAA0B,EACS,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAEvD,2BAA2B;QAC3B,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACnC,IAAI,GAAG,CAAC,CAAC;gBACT,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9E,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,uBAAuB,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,uBAAuB,IAAI,QAAQ,OAAO,EAAE,CAAC;QAElE,IAAI,QAAQ;YAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACnF,CAAC;CACF,CAAC;AAEF,+DAA+D;AAC/D,+BAA+B;AAC/B,+DAA+D;AAE/D,MAAM,iBAAiB,GAAa;IAClC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,8DAA8D;IAC3E,GAAG,EAAE,KAAK,EACR,OAAsB,EACtB,QAAgB,EAChB,MAAa,EACY,EAAE;QAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAExD,OAAO;YACL,IAAI,EAAE;UACF,MAAM;;;;mBAIG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;OACtC,OAAO,IAAI,wBAAwB;;2GAEiE;YACrG,MAAM,EAAE;gBACN,eAAe,EAAE,MAAM;gBACvB,YAAY,EAAE,OAAO,IAAI,SAAS;gBAClC,aAAa,EAAE,MAAM;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D,MAAM,eAAe,GAAW;IAC9B,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,+EAA+E;QAC/E,0EAA0E;QAC1E,+EAA+E;QAC/E,wCAAwC;IAC1C,IAAI,EAAE,KAAK,EAAE,MAA8B,EAAE,OAAsB,EAAE,EAAE;QACrE,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,kBAAkB,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,6BAA6B,OAAO,CAAC,UAAU,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC;IAClE,SAAS,EAAE,CAAC,iBAAiB,CAAC;IAC9B,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,eAAe,eAAe,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@undesirables/plugin-tcg-oracle",
+  "version": "1.0.0",
+  "description": "ElizaOS plugin for TCG Oracle — AI-powered trading card market intelligence. Covers 370K+ products across 25 games with Monte Carlo price simulation (Heston/Merton/Kou), AI vision card grading, and real-time market snapshots.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "images",
+    "plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "elizaos",
+    "elizaos-plugins",
+    "ai-agents",
+    "tcg",
+    "trading-cards",
+    "pokemon",
+    "magic-the-gathering",
+    "yugioh",
+    "monte-carlo",
+    "card-grading",
+    "market-intelligence",
+    "price-prediction"
+  ],
+  "author": "The Undesirables LLC (sailorpepe)",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sailorpepe/elizaos-tcg-oracle-plugin"
+  },
+  "homepage": "https://the-undesirables.com",
+  "peerDependencies": {
+    "@elizaos/core": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@elizaos/core": "2.0.0-alpha.77",
+    "typescript": "^5.4.0",
+    "vitest": "^3.2.4"
+  }
+}

package/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "@undesirables/plugin-tcg-oracle",
+  "version": "1.0.0",
+  "description": "ElizaOS plugin for TCG Oracle — AI-powered trading card market intelligence with Monte Carlo simulation and AI vision grading for 370K+ products across 25 games.",
+  "author": "The Undesirables LLC",
+  "license": "BUSL-1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sailorpepe/elizaos-tcg-oracle-plugin"
+  },
+  "homepage": "https://the-undesirables.com",
+  "keywords": [
+    "elizaos",
+    "elizaos-plugins",
+    "tcg",
+    "trading-cards",
+    "monte-carlo",
+    "card-grading",
+    "market-intelligence"
+  ],
+  "peerDependencies": {
+    "@elizaos/core": ">=1.0.0"
+  }
+}