plugin-undesirables 1.0.0

package/README.md

@@ -0,0 +1,108 @@
+# plugin-undesirables
+
+> ElizaOS plugin for **The Undesirables** — 4,444 autonomous AI agents on Ethereum.
+
+## What It Does
+
+Adds soul personality, market analysis, Business Pilot (23 modules), Meme Machine, and 15+ skills to any ElizaOS agent.
+
+### Actions
+
+| Action | Trigger | Description |
+|--------|---------|-------------|
+| `UNDESIRABLE_MARKET_ANALYSIS` | "What do you think about ETH?" | Personality-driven market analysis with risk guardrails |
+| `UNDESIRABLE_BUSINESS_PILOT` | "Set up phone answering for my business" | 23 AI-powered business automation modules |
+| `UNDESIRABLE_MEME_MACHINE` | "Create memes for my barbershop" | Content creation, meme templates, industry packs |
+| `UNDESIRABLE_LOAD_SKILL` | "Check my portfolio" | Auto-matches and loads any of 15+ skills |
+
+### Provider
+
+The `soulProvider` automatically injects the agent's personality context (archetype, strategy, adjectives, guardrails) into every conversation.
+
+## Setup
+
+### 1. Install the plugin
+
+```bash
+elizaos plugins add plugin-undesirables
+```
+
+_Or manually:_
+```bash
+npm install plugin-undesirables
+```
+
+### 2. Get your soul workspace
+
+1. Mint an Undesirable: [scatter.art/the-undesirables](https://scatter.art/the-undesirables)
+2. Download your workspace: [the-undesirables.com/soul](https://the-undesirables.com/soul)
+3. Unzip the folder
+
+### 3. Configure
+
+Set the workspace path in your `.env`:
+```bash
+UNDESIRABLES_WORKSPACE=/path/to/your/unzipped/soul/folder
+```
+
+Or in your `character.json`:
+```json
+{
+  "settings": {
+    "UNDESIRABLES_WORKSPACE": "/path/to/soul/0420"
+  },
+  "plugins": ["plugin-undesirables"]
+}
+```
+
+### 4. Run
+
+```bash
+elizaos start --character your-character.json
+```
+
+## Converting Souls to character.json
+
+Use the companion converter script:
+```bash
+# From the MCP server repo
+node soul-to-eliza.js --token 420
+```
+
+This converts any `SOUL.md` into a full ElizaOS `character.json` with personality, style, bio, lore, and message examples.
+
+→ [undesirables-mcp-server](https://github.com/sailorpepe/undesirables-mcp-server)
+
+## Architecture
+
+```
+ElizaOS Agent
+  ├── plugin-undesirables
+  │   ├── Provider: soulProvider (injects personality context)
+  │   ├── Action: MARKET_ANALYSIS
+  │   ├── Action: BUSINESS_PILOT
+  │   ├── Action: MEME_MACHINE
+  │   └── Action: LOAD_SKILL (15+ skills)
+  │
+  └── Soul Workspace (token-gated download)
+      ├── SOUL.md (personality profile)
+      ├── SYSTEM_PROMPT.txt
+      ├── MEMORY.md (persistent)
+      ├── PREDICTIONS_LEDGER.json
+      └── skills/ (15 skill files)
+```
+
+## The Undesirables
+
+4,444 autonomous AI agents on Ethereum. Each one has a unique personality derived from its visual traits.
+
+- **Website**: [the-undesirables.com](https://the-undesirables.com)
+- **Mint**: [scatter.art/the-undesirables](https://scatter.art/the-undesirables)
+- **MCP Server**: [github.com/sailorpepe/undesirables-mcp-server](https://github.com/sailorpepe/undesirables-mcp-server)
+- **Docs**: [the-undesirables.com/docs](https://the-undesirables.com/docs)
+
+EST. 2026 🐸
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The Undesirables — ElizaOS Plugin
+ * ==================================
+ * Adds autonomous AI soul personalities and skills from
+ * The Undesirables NFT collection to any ElizaOS agent.
+ *
+ * Features:
+ * - Load any of 4,444 unique soul personalities
+ * - Market analysis with personality-driven perspective
+ * - Business Pilot — 23 AI-powered business modules
+ * - Meme Machine — content creation & marketing
+ * - Portfolio analysis with risk guardrails
+ * - Persistent memory across sessions
+ *
+ * @see https://the-undesirables.com
+ * @see https://github.com/sailorpepe/undesirables-mcp-server
+ */
+import type { Plugin } from "@elizaos/core";
+interface SoulWorkspace {
+    soulMd: string;
+    systemPrompt: string;
+    memory: string;
+    predictions: any[];
+    skills: Record<string, string>;
+    meta: Record<string, any>;
+}
+declare function loadWorkspace(workspacePath: string): SoulWorkspace;
+declare const undesirablePlugin: Plugin;
+export default undesirablePlugin;
+export { loadWorkspace, SoulWorkspace };
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,MAAM,EAQP,MAAM,eAAe,CAAC;AASvB,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,GAAG,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAMD,iBAAS,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAsE3D;AAiVD,QAAA,MAAM,iBAAiB,EAAE,MAcxB,CAAC;AAEF,eAAe,iBAAiB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,419 @@
+"use strict";
+/**
+ * The Undesirables — ElizaOS Plugin
+ * ==================================
+ * Adds autonomous AI soul personalities and skills from
+ * The Undesirables NFT collection to any ElizaOS agent.
+ *
+ * Features:
+ * - Load any of 4,444 unique soul personalities
+ * - Market analysis with personality-driven perspective
+ * - Business Pilot — 23 AI-powered business modules
+ * - Meme Machine — content creation & marketing
+ * - Portfolio analysis with risk guardrails
+ * - Persistent memory across sessions
+ *
+ * @see https://the-undesirables.com
+ * @see https://github.com/sailorpepe/undesirables-mcp-server
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWorkspace = loadWorkspace;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ============================================================
+// Workspace Loader
+// ============================================================
+function loadWorkspace(workspacePath) {
+    const workspace = {
+        soulMd: "",
+        systemPrompt: "",
+        memory: "",
+        predictions: [],
+        skills: {},
+        meta: {},
+    };
+    const soulPath = path.join(workspacePath, "SOUL.md");
+    if (fs.existsSync(soulPath)) {
+        workspace.soulMd = fs.readFileSync(soulPath, "utf-8");
+        // Parse YAML frontmatter
+        const fmMatch = workspace.soulMd.match(/^---\n([\s\S]*?)\n---/);
+        if (fmMatch) {
+            const lines = fmMatch[1].split("\n");
+            for (const line of lines) {
+                const kvMatch = line.match(/^(\w+):\s*(.+)$/);
+                if (kvMatch) {
+                    let val = kvMatch[2].trim();
+                    if (val.startsWith("[") && val.endsWith("]")) {
+                        val = val
+                            .slice(1, -1)
+                            .split(",")
+                            .map((s) => s.trim().replace(/^["']|["']$/g, ""));
+                    }
+                    else if (val.startsWith('"')) {
+                        val = val.replace(/^"|"$/g, "");
+                    }
+                    else if (!isNaN(Number(val))) {
+                        val = Number(val);
+                    }
+                    workspace.meta[kvMatch[1]] = val;
+                }
+            }
+        }
+    }
+    const systemPath = path.join(workspacePath, "SYSTEM_PROMPT.txt");
+    if (fs.existsSync(systemPath)) {
+        workspace.systemPrompt = fs.readFileSync(systemPath, "utf-8");
+    }
+    const memoryPath = path.join(workspacePath, "MEMORY.md");
+    if (fs.existsSync(memoryPath)) {
+        workspace.memory = fs.readFileSync(memoryPath, "utf-8");
+    }
+    const predictionsPath = path.join(workspacePath, "PREDICTIONS_LEDGER.json");
+    if (fs.existsSync(predictionsPath)) {
+        try {
+            workspace.predictions = JSON.parse(fs.readFileSync(predictionsPath, "utf-8"));
+        }
+        catch {
+            workspace.predictions = [];
+        }
+    }
+    const skillsDir = path.join(workspacePath, "skills");
+    if (fs.existsSync(skillsDir)) {
+        for (const file of fs.readdirSync(skillsDir).filter((f) => f.endsWith(".md"))) {
+            workspace.skills[file.replace(".md", "")] = fs.readFileSync(path.join(skillsDir, file), "utf-8");
+        }
+    }
+    return workspace;
+}
+// ============================================================
+// Global workspace (loaded on init)
+// ============================================================
+let currentWorkspace = null;
+// ============================================================
+// ACTIONS
+// ============================================================
+const marketAnalysisAction = {
+    name: "UNDESIRABLE_MARKET_ANALYSIS",
+    description: "Analyze a market, token, or trading pair using the Undesirable agent's unique personality-driven perspective and risk guardrails.",
+    similes: [
+        "ANALYZE_MARKET",
+        "MARKET_OUTLOOK",
+        "PRICE_ANALYSIS",
+        "TRADING_VIEW",
+        "WHAT_DO_YOU_THINK_ABOUT",
+    ],
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "What do you think about ETH right now?" },
+            },
+            {
+                user: "{{agentName}}",
+                content: {
+                    text: "Let me run my market analysis skill on ETH...",
+                    action: "UNDESIRABLE_MARKET_ANALYSIS",
+                },
+            },
+        ],
+    ],
+    validate: async (_runtime, _message) => {
+        return currentWorkspace !== null;
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        if (!currentWorkspace) {
+            if (callback)
+                callback({ text: "No soul workspace loaded." });
+            return false;
+        }
+        const skill = currentWorkspace.skills["market_analysis"] || "";
+        const context = `You are executing the Market Analysis skill.
+
+${skill}
+
+Your personality context:
+${currentWorkspace.soulMd.slice(0, 2000)}
+
+Recent predictions:
+${JSON.stringify(currentWorkspace.predictions.slice(-3), null, 2)}
+
+The user asks: ${message.content.text}
+
+Respond in character using your archetype, risk tolerance, and guardrails.`;
+        if (callback) {
+            callback({ text: context });
+        }
+        return true;
+    },
+};
+const businessPilotAction = {
+    name: "UNDESIRABLE_BUSINESS_PILOT",
+    description: "Use the Business Pilot skill to recommend and set up AI-powered business tools — phone answering, SMS, invoicing, scheduling, and 23+ modules.",
+    similes: [
+        "SETUP_BUSINESS",
+        "PHONE_ANSWERING",
+        "BUSINESS_AUTOMATION",
+        "SMS_AUTORESPONDER",
+        "INVOICE_CHASER",
+    ],
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: {
+                    text: "I run a barbershop. Help me set up phone answering.",
+                },
+            },
+            {
+                user: "{{agentName}}",
+                content: {
+                    text: "Loading Business Pilot skill for your barbershop...",
+                    action: "UNDESIRABLE_BUSINESS_PILOT",
+                },
+            },
+        ],
+    ],
+    validate: async (_runtime, _message) => {
+        return currentWorkspace !== null && "business_pilot" in (currentWorkspace?.skills || {});
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        if (!currentWorkspace) {
+            if (callback)
+                callback({ text: "No soul workspace loaded." });
+            return false;
+        }
+        const skill = currentWorkspace.skills["business_pilot"] || "";
+        const context = `You are executing the Business Pilot skill.
+
+${skill}
+
+The user asks: ${message.content.text}
+
+Recommend the top 3-5 modules they should set up first with exact commands.`;
+        if (callback) {
+            callback({ text: context });
+        }
+        return true;
+    },
+};
+const memeMachineAction = {
+    name: "UNDESIRABLE_MEME_MACHINE",
+    description: "Generate memes, marketing content, content calendars, and viral social media assets using the Meme Machine skill.",
+    similes: [
+        "CREATE_MEME",
+        "MEME_MARKETING",
+        "CONTENT_CALENDAR",
+        "VIRAL_CONTENT",
+        "BRAND_VOICE",
+    ],
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "Create some memes for my barbershop" },
+            },
+            {
+                user: "{{agentName}}",
+                content: {
+                    text: "Firing up the Meme Machine for barbershop content...",
+                    action: "UNDESIRABLE_MEME_MACHINE",
+                },
+            },
+        ],
+    ],
+    validate: async (_runtime, _message) => {
+        return currentWorkspace !== null && "meme_machine" in (currentWorkspace?.skills || {});
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        if (!currentWorkspace) {
+            if (callback)
+                callback({ text: "No soul workspace loaded." });
+            return false;
+        }
+        const skill = currentWorkspace.skills["meme_machine"] || "";
+        const context = `You are executing the Meme Machine skill.
+
+${skill}
+
+The user asks: ${message.content.text}
+
+Create 3 meme concepts with template, text, caption, and export size.`;
+        if (callback) {
+            callback({ text: context });
+        }
+        return true;
+    },
+};
+const loadSkillAction = {
+    name: "UNDESIRABLE_LOAD_SKILL",
+    description: "Load and execute any of the 15+ skills from the Undesirable soul workspace — market analysis, content creation, portfolio check, entry signals, exit strategy, and more.",
+    similes: [
+        "USE_SKILL",
+        "RUN_SKILL",
+        "EXECUTE_SKILL",
+        "CHECK_PORTFOLIO",
+        "CONTENT_CREATION",
+        "ENTRY_SIGNAL",
+        "EXIT_STRATEGY",
+    ],
+    examples: [
+        [
+            {
+                user: "{{user1}}",
+                content: { text: "Check my portfolio" },
+            },
+            {
+                user: "{{agentName}}",
+                content: {
+                    text: "Loading portfolio check skill...",
+                    action: "UNDESIRABLE_LOAD_SKILL",
+                },
+            },
+        ],
+    ],
+    validate: async (_runtime, _message) => {
+        return currentWorkspace !== null;
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        if (!currentWorkspace) {
+            if (callback)
+                callback({ text: "No soul workspace loaded." });
+            return false;
+        }
+        // Try to match the best skill based on the user's message
+        const text = message.content.text?.toLowerCase() || "";
+        let matchedSkill = "";
+        let matchedName = "";
+        const skillMatches = {
+            check_portfolio: ["portfolio", "balance", "holdings", "how am i doing"],
+            content_creation: ["tweet", "write", "promote", "content", "thread"],
+            entry_signal: ["entry", "should i buy", "good time to buy", "dip"],
+            exit_strategy: ["exit", "sell", "take profit", "stop loss"],
+            conviction_score: ["conviction", "confidence", "how sure"],
+            rebalance_check: ["rebalance", "allocation"],
+            prediction_log: ["predict", "forecast", "call"],
+            risk_assessment: ["risk", "downside", "worst case"],
+            image_generation: ["image", "picture", "generate art"],
+            music_generation: ["music", "song", "beat", "audio"],
+        };
+        for (const [skillName, triggers] of Object.entries(skillMatches)) {
+            if (triggers.some((t) => text.includes(t)) && currentWorkspace.skills[skillName]) {
+                matchedSkill = currentWorkspace.skills[skillName];
+                matchedName = skillName;
+                break;
+            }
+        }
+        if (!matchedSkill) {
+            // Return available skills list
+            const available = Object.keys(currentWorkspace.skills)
+                .filter((k) => k !== "_index")
+                .join(", ");
+            if (callback) {
+                callback({
+                    text: `Available skills: ${available}. Tell me what you need and I'll load the right one.`,
+                });
+            }
+            return true;
+        }
+        const context = `You are executing the ${matchedName.replace(/_/g, " ")} skill.
+
+${matchedSkill}
+
+Your personality context:
+${currentWorkspace.soulMd.slice(0, 1500)}
+
+The user asks: ${message.content.text}
+
+Respond in character using your archetype and guardrails.`;
+        if (callback) {
+            callback({ text: context });
+        }
+        return true;
+    },
+};
+// ============================================================
+// PROVIDERS
+// ============================================================
+const soulProvider = {
+    get: async (runtime, _message) => {
+        // Load workspace from runtime settings if not already loaded
+        if (!currentWorkspace) {
+            const workspacePath = runtime.getSetting?.("UNDESIRABLES_WORKSPACE") ||
+                process.env.UNDESIRABLES_WORKSPACE ||
+                "";
+            if (workspacePath && fs.existsSync(workspacePath)) {
+                currentWorkspace = loadWorkspace(workspacePath);
+                console.log(`🐸 Loaded Undesirable soul: ${currentWorkspace.meta.name || "Unknown"}`);
+            }
+        }
+        if (!currentWorkspace) {
+            return "No Undesirable soul workspace loaded. Set UNDESIRABLES_WORKSPACE env var to your downloaded workspace path.";
+        }
+        return `[SOUL CONTEXT]
+Name: ${currentWorkspace.meta.name || "Unknown Undesirable"}
+Archetype: ${currentWorkspace.meta.archetype || "Unknown"}
+Strategy: ${currentWorkspace.meta.strategy || "Unknown"}
+Token ID: ${currentWorkspace.meta.token_id || "?"}
+Skills loaded: ${Object.keys(currentWorkspace.skills).filter((k) => k !== "_index").length}
+Memory entries: ${currentWorkspace.memory.split("\n").filter((l) => l.trim()).length}
+Predictions: ${currentWorkspace.predictions.length}
+
+Personality: ${(currentWorkspace.meta.adjectives || []).join(", ")}
+
+The agent should respond using the personality and style defined in its soul.
+Collection: The Undesirables — 4,444 autonomous AI agents on Ethereum.
+Website: https://the-undesirables.com`;
+    },
+};
+// ============================================================
+// PLUGIN EXPORT
+// ============================================================
+const undesirablePlugin = {
+    name: "plugin-undesirables",
+    description: "The Undesirables — 4,444 autonomous AI agents on Ethereum. " +
+        "Adds soul personality, market analysis, Business Pilot (23 modules), " +
+        "Meme Machine, and 15+ skills to any ElizaOS agent.",
+    actions: [
+        marketAnalysisAction,
+        businessPilotAction,
+        memeMachineAction,
+        loadSkillAction,
+    ],
+    providers: [soulProvider],
+    evaluators: [],
+};
+exports.default = undesirablePlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "plugin-undesirables",
+  "version": "1.0.0",
+  "description": "ElizaOS plugin for The Undesirables — 4,444 autonomous AI agents on Ethereum. Adds soul personality loading, market analysis, Business Pilot, Meme Machine, and 15+ skills to any ElizaOS agent.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "elizaos",
+    "elizaos-plugins",
+    "ai-agents",
+    "nft",
+    "ethereum",
+    "undesirables",
+    "mcp",
+    "ollama",
+    "autonomous-agents",
+    "defi"
+  ],
+  "author": "The Undesirables (sailorpepe)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sailorpepe/plugin-undesirables"
+  },
+  "homepage": "https://the-undesirables.com",
+  "peerDependencies": {
+    "@elizaos/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}

package/src/elizaos-core.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Local type declarations for @elizaos/core
+ * These are the minimal types needed for the plugin to compile.
+ * At runtime, the actual ElizaOS core provides the real implementations.
+ */
+
+declare module "@elizaos/core" {
+  export interface Plugin {
+    name: string;
+    description: string;
+    actions: Action[];
+    providers: Provider[];
+    evaluators: Evaluator[];
+  }
+
+  export interface Action {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: ActionExample[][];
+    validate: (runtime: IAgentRuntime, message: Memory) => Promise<boolean>;
+    handler: (
+      runtime: IAgentRuntime,
+      message: Memory,
+      state?: State,
+      options?: Record<string, unknown>,
+      callback?: HandlerCallback
+    ) => Promise<boolean>;
+  }
+
+  export interface ActionExample {
+    user: string;
+    content: {
+      text: string;
+      action?: string;
+    };
+  }
+
+  export interface Provider {
+    get: (runtime: IAgentRuntime, message: Memory, state?: State) => Promise<string>;
+  }
+
+  export interface Evaluator {
+    name: string;
+    description: string;
+    similes: string[];
+    examples: ActionExample[][];
+    validate: (runtime: IAgentRuntime, message: Memory) => Promise<boolean>;
+    handler: (runtime: IAgentRuntime, message: Memory) => Promise<any>;
+  }
+
+  export interface IAgentRuntime {
+    getSetting?: (key: string) => string | undefined;
+    [key: string]: any;
+  }
+
+  export interface Memory {
+    content: {
+      text?: string;
+      [key: string]: any;
+    };
+    [key: string]: any;
+  }
+
+  export interface State {
+    [key: string]: any;
+  }
+
+  export type HandlerCallback = (response: { text: string; [key: string]: any }) => void;
+}

package/src/index.ts

@@ -0,0 +1,474 @@
+/**
+ * The Undesirables — ElizaOS Plugin
+ * ==================================
+ * Adds autonomous AI soul personalities and skills from
+ * The Undesirables NFT collection to any ElizaOS agent.
+ *
+ * Features:
+ * - Load any of 4,444 unique soul personalities
+ * - Market analysis with personality-driven perspective
+ * - Business Pilot — 23 AI-powered business modules
+ * - Meme Machine — content creation & marketing
+ * - Portfolio analysis with risk guardrails
+ * - Persistent memory across sessions
+ *
+ * @see https://the-undesirables.com
+ * @see https://github.com/sailorpepe/undesirables-mcp-server
+ */
+
+import type {
+  Plugin,
+  Action,
+  Provider,
+  IAgentRuntime,
+  Memory,
+  State,
+  HandlerCallback,
+  ActionExample,
+} from "@elizaos/core";
+
+import * as fs from "fs";
+import * as path from "path";
+
+// ============================================================
+// Types
+// ============================================================
+
+interface SoulWorkspace {
+  soulMd: string;
+  systemPrompt: string;
+  memory: string;
+  predictions: any[];
+  skills: Record<string, string>;
+  meta: Record<string, any>;
+}
+
+// ============================================================
+// Workspace Loader
+// ============================================================
+
+function loadWorkspace(workspacePath: string): SoulWorkspace {
+  const workspace: SoulWorkspace = {
+    soulMd: "",
+    systemPrompt: "",
+    memory: "",
+    predictions: [],
+    skills: {},
+    meta: {},
+  };
+
+  const soulPath = path.join(workspacePath, "SOUL.md");
+  if (fs.existsSync(soulPath)) {
+    workspace.soulMd = fs.readFileSync(soulPath, "utf-8");
+
+    // Parse YAML frontmatter
+    const fmMatch = workspace.soulMd.match(/^---\n([\s\S]*?)\n---/);
+    if (fmMatch) {
+      const lines = fmMatch[1].split("\n");
+      for (const line of lines) {
+        const kvMatch = line.match(/^(\w+):\s*(.+)$/);
+        if (kvMatch) {
+          let val: any = kvMatch[2].trim();
+          if (val.startsWith("[") && val.endsWith("]")) {
+            val = val
+              .slice(1, -1)
+              .split(",")
+              .map((s: string) => s.trim().replace(/^["']|["']$/g, ""));
+          } else if (val.startsWith('"')) {
+            val = val.replace(/^"|"$/g, "");
+          } else if (!isNaN(Number(val))) {
+            val = Number(val);
+          }
+          workspace.meta[kvMatch[1]] = val;
+        }
+      }
+    }
+  }
+
+  const systemPath = path.join(workspacePath, "SYSTEM_PROMPT.txt");
+  if (fs.existsSync(systemPath)) {
+    workspace.systemPrompt = fs.readFileSync(systemPath, "utf-8");
+  }
+
+  const memoryPath = path.join(workspacePath, "MEMORY.md");
+  if (fs.existsSync(memoryPath)) {
+    workspace.memory = fs.readFileSync(memoryPath, "utf-8");
+  }
+
+  const predictionsPath = path.join(workspacePath, "PREDICTIONS_LEDGER.json");
+  if (fs.existsSync(predictionsPath)) {
+    try {
+      workspace.predictions = JSON.parse(
+        fs.readFileSync(predictionsPath, "utf-8")
+      );
+    } catch {
+      workspace.predictions = [];
+    }
+  }
+
+  const skillsDir = path.join(workspacePath, "skills");
+  if (fs.existsSync(skillsDir)) {
+    for (const file of fs.readdirSync(skillsDir).filter((f) => f.endsWith(".md"))) {
+      workspace.skills[file.replace(".md", "")] = fs.readFileSync(
+        path.join(skillsDir, file),
+        "utf-8"
+      );
+    }
+  }
+
+  return workspace;
+}
+
+// ============================================================
+// Global workspace (loaded on init)
+// ============================================================
+
+let currentWorkspace: SoulWorkspace | null = null;
+
+// ============================================================
+// ACTIONS
+// ============================================================
+
+const marketAnalysisAction: Action = {
+  name: "UNDESIRABLE_MARKET_ANALYSIS",
+  description:
+    "Analyze a market, token, or trading pair using the Undesirable agent's unique personality-driven perspective and risk guardrails.",
+  similes: [
+    "ANALYZE_MARKET",
+    "MARKET_OUTLOOK",
+    "PRICE_ANALYSIS",
+    "TRADING_VIEW",
+    "WHAT_DO_YOU_THINK_ABOUT",
+  ],
+  examples: [
+    [
+      {
+        user: "{{user1}}",
+        content: { text: "What do you think about ETH right now?" },
+      } as ActionExample,
+      {
+        user: "{{agentName}}",
+        content: {
+          text: "Let me run my market analysis skill on ETH...",
+          action: "UNDESIRABLE_MARKET_ANALYSIS",
+        },
+      } as ActionExample,
+    ],
+  ],
+  validate: async (_runtime: IAgentRuntime, _message: Memory) => {
+    return currentWorkspace !== null;
+  },
+  handler: async (
+    runtime: IAgentRuntime,
+    message: Memory,
+    _state: State | undefined,
+    _options: Record<string, unknown> | undefined,
+    callback?: HandlerCallback
+  ) => {
+    if (!currentWorkspace) {
+      if (callback) callback({ text: "No soul workspace loaded." });
+      return false;
+    }
+
+    const skill = currentWorkspace.skills["market_analysis"] || "";
+    const context = `You are executing the Market Analysis skill.
+
+${skill}
+
+Your personality context:
+${currentWorkspace.soulMd.slice(0, 2000)}
+
+Recent predictions:
+${JSON.stringify(currentWorkspace.predictions.slice(-3), null, 2)}
+
+The user asks: ${message.content.text}
+
+Respond in character using your archetype, risk tolerance, and guardrails.`;
+
+    if (callback) {
+      callback({ text: context });
+    }
+    return true;
+  },
+};
+
+const businessPilotAction: Action = {
+  name: "UNDESIRABLE_BUSINESS_PILOT",
+  description:
+    "Use the Business Pilot skill to recommend and set up AI-powered business tools — phone answering, SMS, invoicing, scheduling, and 23+ modules.",
+  similes: [
+    "SETUP_BUSINESS",
+    "PHONE_ANSWERING",
+    "BUSINESS_AUTOMATION",
+    "SMS_AUTORESPONDER",
+    "INVOICE_CHASER",
+  ],
+  examples: [
+    [
+      {
+        user: "{{user1}}",
+        content: {
+          text: "I run a barbershop. Help me set up phone answering.",
+        },
+      } as ActionExample,
+      {
+        user: "{{agentName}}",
+        content: {
+          text: "Loading Business Pilot skill for your barbershop...",
+          action: "UNDESIRABLE_BUSINESS_PILOT",
+        },
+      } as ActionExample,
+    ],
+  ],
+  validate: async (_runtime: IAgentRuntime, _message: Memory) => {
+    return currentWorkspace !== null && "business_pilot" in (currentWorkspace?.skills || {});
+  },
+  handler: async (
+    runtime: IAgentRuntime,
+    message: Memory,
+    _state: State | undefined,
+    _options: Record<string, unknown> | undefined,
+    callback?: HandlerCallback
+  ) => {
+    if (!currentWorkspace) {
+      if (callback) callback({ text: "No soul workspace loaded." });
+      return false;
+    }
+
+    const skill = currentWorkspace.skills["business_pilot"] || "";
+    const context = `You are executing the Business Pilot skill.
+
+${skill}
+
+The user asks: ${message.content.text}
+
+Recommend the top 3-5 modules they should set up first with exact commands.`;
+
+    if (callback) {
+      callback({ text: context });
+    }
+    return true;
+  },
+};
+
+const memeMachineAction: Action = {
+  name: "UNDESIRABLE_MEME_MACHINE",
+  description:
+    "Generate memes, marketing content, content calendars, and viral social media assets using the Meme Machine skill.",
+  similes: [
+    "CREATE_MEME",
+    "MEME_MARKETING",
+    "CONTENT_CALENDAR",
+    "VIRAL_CONTENT",
+    "BRAND_VOICE",
+  ],
+  examples: [
+    [
+      {
+        user: "{{user1}}",
+        content: { text: "Create some memes for my barbershop" },
+      } as ActionExample,
+      {
+        user: "{{agentName}}",
+        content: {
+          text: "Firing up the Meme Machine for barbershop content...",
+          action: "UNDESIRABLE_MEME_MACHINE",
+        },
+      } as ActionExample,
+    ],
+  ],
+  validate: async (_runtime: IAgentRuntime, _message: Memory) => {
+    return currentWorkspace !== null && "meme_machine" in (currentWorkspace?.skills || {});
+  },
+  handler: async (
+    runtime: IAgentRuntime,
+    message: Memory,
+    _state: State | undefined,
+    _options: Record<string, unknown> | undefined,
+    callback?: HandlerCallback
+  ) => {
+    if (!currentWorkspace) {
+      if (callback) callback({ text: "No soul workspace loaded." });
+      return false;
+    }
+
+    const skill = currentWorkspace.skills["meme_machine"] || "";
+    const context = `You are executing the Meme Machine skill.
+
+${skill}
+
+The user asks: ${message.content.text}
+
+Create 3 meme concepts with template, text, caption, and export size.`;
+
+    if (callback) {
+      callback({ text: context });
+    }
+    return true;
+  },
+};
+
+const loadSkillAction: Action = {
+  name: "UNDESIRABLE_LOAD_SKILL",
+  description:
+    "Load and execute any of the 15+ skills from the Undesirable soul workspace — market analysis, content creation, portfolio check, entry signals, exit strategy, and more.",
+  similes: [
+    "USE_SKILL",
+    "RUN_SKILL",
+    "EXECUTE_SKILL",
+    "CHECK_PORTFOLIO",
+    "CONTENT_CREATION",
+    "ENTRY_SIGNAL",
+    "EXIT_STRATEGY",
+  ],
+  examples: [
+    [
+      {
+        user: "{{user1}}",
+        content: { text: "Check my portfolio" },
+      } as ActionExample,
+      {
+        user: "{{agentName}}",
+        content: {
+          text: "Loading portfolio check skill...",
+          action: "UNDESIRABLE_LOAD_SKILL",
+        },
+      } as ActionExample,
+    ],
+  ],
+  validate: async (_runtime: IAgentRuntime, _message: Memory) => {
+    return currentWorkspace !== null;
+  },
+  handler: async (
+    runtime: IAgentRuntime,
+    message: Memory,
+    _state: State | undefined,
+    _options: Record<string, unknown> | undefined,
+    callback?: HandlerCallback
+  ) => {
+    if (!currentWorkspace) {
+      if (callback) callback({ text: "No soul workspace loaded." });
+      return false;
+    }
+
+    // Try to match the best skill based on the user's message
+    const text = message.content.text?.toLowerCase() || "";
+    let matchedSkill = "";
+    let matchedName = "";
+
+    const skillMatches: Record<string, string[]> = {
+      check_portfolio: ["portfolio", "balance", "holdings", "how am i doing"],
+      content_creation: ["tweet", "write", "promote", "content", "thread"],
+      entry_signal: ["entry", "should i buy", "good time to buy", "dip"],
+      exit_strategy: ["exit", "sell", "take profit", "stop loss"],
+      conviction_score: ["conviction", "confidence", "how sure"],
+      rebalance_check: ["rebalance", "allocation"],
+      prediction_log: ["predict", "forecast", "call"],
+      risk_assessment: ["risk", "downside", "worst case"],
+      image_generation: ["image", "picture", "generate art"],
+      music_generation: ["music", "song", "beat", "audio"],
+    };
+
+    for (const [skillName, triggers] of Object.entries(skillMatches)) {
+      if (triggers.some((t) => text.includes(t)) && currentWorkspace.skills[skillName]) {
+        matchedSkill = currentWorkspace.skills[skillName];
+        matchedName = skillName;
+        break;
+      }
+    }
+
+    if (!matchedSkill) {
+      // Return available skills list
+      const available = Object.keys(currentWorkspace.skills)
+        .filter((k) => k !== "_index")
+        .join(", ");
+      if (callback) {
+        callback({
+          text: `Available skills: ${available}. Tell me what you need and I'll load the right one.`,
+        });
+      }
+      return true;
+    }
+
+    const context = `You are executing the ${matchedName.replace(/_/g, " ")} skill.
+
+${matchedSkill}
+
+Your personality context:
+${currentWorkspace.soulMd.slice(0, 1500)}
+
+The user asks: ${message.content.text}
+
+Respond in character using your archetype and guardrails.`;
+
+    if (callback) {
+      callback({ text: context });
+    }
+    return true;
+  },
+};
+
+// ============================================================
+// PROVIDERS
+// ============================================================
+
+const soulProvider: Provider = {
+  get: async (runtime: IAgentRuntime, _message: Memory) => {
+    // Load workspace from runtime settings if not already loaded
+    if (!currentWorkspace) {
+      const workspacePath =
+        (runtime.getSetting?.("UNDESIRABLES_WORKSPACE") as string) ||
+        process.env.UNDESIRABLES_WORKSPACE ||
+        "";
+
+      if (workspacePath && fs.existsSync(workspacePath)) {
+        currentWorkspace = loadWorkspace(workspacePath);
+        console.log(
+          `🐸 Loaded Undesirable soul: ${currentWorkspace.meta.name || "Unknown"}`
+        );
+      }
+    }
+
+    if (!currentWorkspace) {
+      return "No Undesirable soul workspace loaded. Set UNDESIRABLES_WORKSPACE env var to your downloaded workspace path.";
+    }
+
+    return `[SOUL CONTEXT]
+Name: ${currentWorkspace.meta.name || "Unknown Undesirable"}
+Archetype: ${currentWorkspace.meta.archetype || "Unknown"}
+Strategy: ${currentWorkspace.meta.strategy || "Unknown"}
+Token ID: ${currentWorkspace.meta.token_id || "?"}
+Skills loaded: ${Object.keys(currentWorkspace.skills).filter((k) => k !== "_index").length}
+Memory entries: ${currentWorkspace.memory.split("\n").filter((l) => l.trim()).length}
+Predictions: ${currentWorkspace.predictions.length}
+
+Personality: ${(currentWorkspace.meta.adjectives || []).join(", ")}
+
+The agent should respond using the personality and style defined in its soul.
+Collection: The Undesirables — 4,444 autonomous AI agents on Ethereum.
+Website: https://the-undesirables.com`;
+  },
+};
+
+// ============================================================
+// PLUGIN EXPORT
+// ============================================================
+
+const undesirablePlugin: Plugin = {
+  name: "plugin-undesirables",
+  description:
+    "The Undesirables — 4,444 autonomous AI agents on Ethereum. " +
+    "Adds soul personality, market analysis, Business Pilot (23 modules), " +
+    "Meme Machine, and 15+ skills to any ElizaOS agent.",
+  actions: [
+    marketAnalysisAction,
+    businessPilotAction,
+    memeMachineAction,
+    loadSkillAction,
+  ],
+  providers: [soulProvider],
+  evaluators: [],
+};
+
+export default undesirablePlugin;
+export { loadWorkspace, SoulWorkspace };

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}