clodds 1.1.0

package/dist/skills/bundled/yoink/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Yoink Skill - Capture the Flag on Base
+ *
+ * Contract: 0x4bBFD120d9f352A0BEd7a014bd67913a2007a878
+ *
+ * Commands:
+ * /yoink                      Yoink the flag!
+ * /yoink status               Current flag holder and stats
+ * /yoink score <address>      Get player score
+ * /yoink cooldown             Check your cooldown
+ */
+export declare function execute(args: string): Promise<string>;
+export declare const tools: ({
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            address?: undefined;
+        };
+        required?: undefined;
+    };
+    execute: () => Promise<string>;
+} | {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            address: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute: ({ address }: {
+        address: string;
+    }) => Promise<string>;
+})[];
+declare const _default: {
+    name: string;
+    description: string;
+    commands: string[];
+    requires: {
+        env: string[];
+    };
+    handle: typeof execute;
+    tools: ({
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                address?: undefined;
+            };
+            required?: undefined;
+        };
+        execute: () => Promise<string>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                address: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        execute: ({ address }: {
+            address: string;
+        }) => Promise<string>;
+    })[];
+};
+export default _default;

package/dist/skills/bundled/yoink/index.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Yoink Skill - Capture the Flag on Base
+ *
+ * Contract: 0x4bBFD120d9f352A0BEd7a014bd67913a2007a878
+ *
+ * Commands:
+ * /yoink                      Yoink the flag!
+ * /yoink status               Current flag holder and stats
+ * /yoink score <address>      Get player score
+ * /yoink cooldown             Check your cooldown
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tools = void 0;
+exports.execute = execute;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const chains_1 = require("viem/chains");
+const YOINK_CONTRACT = '0x4bBFD120d9f352A0BEd7a014bd67913a2007a878';
+const COOLDOWN = 600; // 10 minutes
+const YOINK_ABI = [
+    { inputs: [], name: 'yoink', outputs: [], stateMutability: 'nonpayable', type: 'function' },
+    { inputs: [], name: 'lastYoinkedBy', outputs: [{ type: 'address' }], stateMutability: 'view', type: 'function' },
+    { inputs: [], name: 'lastYoinkedAt', outputs: [{ type: 'uint256' }], stateMutability: 'view', type: 'function' },
+    { inputs: [], name: 'totalYoinks', outputs: [{ type: 'uint256' }], stateMutability: 'view', type: 'function' },
+    { inputs: [], name: 'topYoinker', outputs: [{ type: 'address' }], stateMutability: 'view', type: 'function' },
+    { inputs: [], name: 'mostYoinks', outputs: [{ type: 'uint256' }], stateMutability: 'view', type: 'function' },
+    {
+        inputs: [{ name: 'player', type: 'address' }],
+        name: 'score',
+        outputs: [
+            { name: 'yoinks', type: 'uint256' },
+            { name: 'time', type: 'uint256' },
+            { name: 'lastYoinkedAt', type: 'uint256' },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+function getPublicClient() {
+    return (0, viem_1.createPublicClient)({
+        chain: chains_1.base,
+        transport: (0, viem_1.http)(process.env.BASE_RPC_URL || 'https://mainnet.base.org'),
+    });
+}
+function getWalletClient() {
+    const privateKey = process.env.PRIVATE_KEY;
+    if (!privateKey)
+        throw new Error('PRIVATE_KEY not set');
+    const account = (0, accounts_1.privateKeyToAccount)(privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`);
+    return (0, viem_1.createWalletClient)({
+        account,
+        chain: chains_1.base,
+        transport: (0, viem_1.http)(process.env.BASE_RPC_URL || 'https://mainnet.base.org'),
+    });
+}
+async function handleYoink() {
+    try {
+        const publicClient = getPublicClient();
+        const walletClient = getWalletClient();
+        // Check current holder
+        const currentHolder = await publicClient.readContract({
+            address: YOINK_CONTRACT,
+            abi: YOINK_ABI,
+            functionName: 'lastYoinkedBy',
+        });
+        if (currentHolder.toLowerCase() === walletClient.account.address.toLowerCase()) {
+            return 'You already hold the flag! Cannot yoink from yourself.';
+        }
+        // Check cooldown
+        const lastYoinkedAt = await publicClient.readContract({
+            address: YOINK_CONTRACT,
+            abi: YOINK_ABI,
+            functionName: 'lastYoinkedAt',
+        });
+        const now = Math.floor(Date.now() / 1000);
+        const timeSinceYoink = now - Number(lastYoinkedAt);
+        if (timeSinceYoink < COOLDOWN) {
+            const remaining = COOLDOWN - timeSinceYoink;
+            return `Cooldown active! Wait ${remaining} seconds before yoinking.`;
+        }
+        // Yoink!
+        const hash = await walletClient.writeContract({
+            address: YOINK_CONTRACT,
+            abi: YOINK_ABI,
+            functionName: 'yoink',
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash });
+        return `**YOINK!**\n\n` +
+            `You grabbed the flag from \`${currentHolder.slice(0, 10)}...\`!\n` +
+            `TX: \`${hash}\`\n` +
+            `Status: ${receipt.status === 'success' ? 'Success' : 'Failed'}`;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (msg.includes('SlowDown')) {
+            return 'Cooldown not elapsed! Wait 10 minutes between yoinks.';
+        }
+        if (msg.includes('Unauthorized')) {
+            return 'You already hold the flag!';
+        }
+        return `Yoink failed: ${msg}`;
+    }
+}
+async function handleStatus() {
+    try {
+        const client = getPublicClient();
+        const [holder, lastYoinkedAt, totalYoinks, topYoinker, mostYoinks] = await Promise.all([
+            client.readContract({ address: YOINK_CONTRACT, abi: YOINK_ABI, functionName: 'lastYoinkedBy' }),
+            client.readContract({ address: YOINK_CONTRACT, abi: YOINK_ABI, functionName: 'lastYoinkedAt' }),
+            client.readContract({ address: YOINK_CONTRACT, abi: YOINK_ABI, functionName: 'totalYoinks' }),
+            client.readContract({ address: YOINK_CONTRACT, abi: YOINK_ABI, functionName: 'topYoinker' }),
+            client.readContract({ address: YOINK_CONTRACT, abi: YOINK_ABI, functionName: 'mostYoinks' }),
+        ]);
+        const lastTime = new Date(Number(lastYoinkedAt) * 1000).toLocaleString();
+        const now = Math.floor(Date.now() / 1000);
+        const cooldownRemaining = Math.max(0, COOLDOWN - (now - Number(lastYoinkedAt)));
+        let output = `**Yoink Game Status**\n\n`;
+        output += `**Current Flag Holder:** \`${holder}\`\n`;
+        output += `**Last Yoinked:** ${lastTime}\n`;
+        output += `**Cooldown:** ${cooldownRemaining > 0 ? `${cooldownRemaining}s remaining` : 'Ready!'}\n\n`;
+        output += `**Total Yoinks:** ${totalYoinks}\n`;
+        output += `**Trophy Holder:** \`${topYoinker}\`\n`;
+        output += `**Most Yoinks:** ${mostYoinks}`;
+        return output;
+    }
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function handleScore(address) {
+    if (!address) {
+        return 'Usage: /yoink score <address>';
+    }
+    try {
+        const client = getPublicClient();
+        const [yoinks, time, lastAt] = await client.readContract({
+            address: YOINK_CONTRACT,
+            abi: YOINK_ABI,
+            functionName: 'score',
+            args: [address],
+        });
+        const lastTime = Number(lastAt) > 0
+            ? new Date(Number(lastAt) * 1000).toLocaleString()
+            : 'Never';
+        return `**Player Score**\n\n` +
+            `Address: \`${address}\`\n` +
+            `Yoinks: ${yoinks}\n` +
+            `Time Held: ${Number(time)} seconds\n` +
+            `Last Yoink: ${lastTime}`;
+    }
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function handleCooldown() {
+    try {
+        const client = getPublicClient();
+        const lastYoinkedAt = await client.readContract({
+            address: YOINK_CONTRACT,
+            abi: YOINK_ABI,
+            functionName: 'lastYoinkedAt',
+        });
+        const now = Math.floor(Date.now() / 1000);
+        const remaining = Math.max(0, COOLDOWN - (now - Number(lastYoinkedAt)));
+        if (remaining > 0) {
+            return `Cooldown: ${remaining} seconds remaining\nReady at: ${new Date((Number(lastYoinkedAt) + COOLDOWN) * 1000).toLocaleString()}`;
+        }
+        return 'Cooldown complete! Ready to yoink!';
+    }
+    catch (error) {
+        return `Error: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function execute(args) {
+    const parts = args.trim().split(/\s+/);
+    const command = parts[0]?.toLowerCase() || '';
+    switch (command) {
+        case '':
+            return handleYoink();
+        case 'status':
+            return handleStatus();
+        case 'score':
+            return handleScore(parts[1]);
+        case 'cooldown':
+            return handleCooldown();
+        case 'help':
+        default:
+            return `**Yoink - Capture the Flag**
+
+/yoink                     Yoink the flag!
+/yoink status              Game status
+/yoink score <address>     Player score
+/yoink cooldown            Check cooldown
+
+**Rules:**
+- 10 minute cooldown between yoinks
+- Can't yoink from yourself
+- Most yoinks wins trophy
+
+Contract: \`${YOINK_CONTRACT}\``;
+    }
+}
+exports.tools = [
+    {
+        name: 'yoink_flag',
+        description: 'Yoink the flag in the capture-the-flag game on Base',
+        parameters: { type: 'object', properties: {} },
+        execute: async () => handleYoink(),
+    },
+    {
+        name: 'yoink_status',
+        description: 'Get current Yoink game status - flag holder, total yoinks, trophy holder',
+        parameters: { type: 'object', properties: {} },
+        execute: async () => handleStatus(),
+    },
+    {
+        name: 'yoink_score',
+        description: 'Get a player score in the Yoink game',
+        parameters: {
+            type: 'object',
+            properties: { address: { type: 'string', description: 'Player wallet address' } },
+            required: ['address'],
+        },
+        execute: async ({ address }) => handleScore(address),
+    },
+];
+exports.default = {
+    name: 'yoink',
+    description: 'Yoink - capture the flag game on Base',
+    commands: ['/yoink'],
+    requires: { env: ['PRIVATE_KEY'] },
+    handle: execute,
+    tools: exports.tools,
+};
+//# sourceMappingURL=index.js.map

package/dist/skills/bundled/yoink/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/bundled/yoink/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAsLH,0BA6BC;AAjND,+BAA+F;AAC/F,4CAAoD;AACpD,wCAAmC;AAEnC,MAAM,cAAc,GAAG,4CAAuD,CAAC;AAC/E,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,aAAa;AAEnC,MAAM,SAAS,GAAG;IAChB,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;IAC3F,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;IAChH,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;IAChH,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;IAC9G,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;IAC7G,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;IAC7G;QACE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,IAAI,EAAE,OAAO;QACb,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;SAC3C;QACD,eAAe,EAAE,MAAM;QACvB,IAAI,EAAE,UAAU;KACjB;CACO,CAAC;AAEX,SAAS,eAAe;IACtB,OAAO,IAAA,yBAAkB,EAAC;QACxB,KAAK,EAAE,aAAI;QACX,SAAS,EAAE,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0BAA0B,CAAC;KACxE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAA,8BAAmB,EAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAA2B,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;IACnH,OAAO,IAAA,yBAAkB,EAAC;QACxB,OAAO;QACP,KAAK,EAAE,aAAI;QACX,SAAS,EAAE,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0BAA0B,CAAC;KACxE,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QAEvC,uBAAuB;QACvB,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;YACpD,OAAO,EAAE,cAAc;YACvB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,eAAe;SAC9B,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/E,OAAO,wDAAwD,CAAC;QAClE,CAAC;QAED,iBAAiB;QACjB,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;YACpD,OAAO,EAAE,cAAc;YACvB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,eAAe;SAC9B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,cAAc,GAAG,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAEnD,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;YAC5C,OAAO,yBAAyB,SAAS,2BAA2B,CAAC;QACvE,CAAC;QAED,SAAS;QACT,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;YAC5C,OAAO,EAAE,cAAc;YACvB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,OAAO;SACtB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvE,OAAO,gBAAgB;YACrB,+BAA+B,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU;YACnE,SAAS,IAAI,MAAM;YACnB,WAAW,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,OAAO,uDAAuD,CAAC;QACjE,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YACjC,OAAO,4BAA4B,CAAC;QACtC,CAAC;QACD,OAAO,iBAAiB,GAAG,EAAE,CAAC;IAChC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QAEjC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrF,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;YAC/F,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;YAC/F,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;YAC7F,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;YAC5F,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;SAC7F,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAEhF,IAAI,MAAM,GAAG,2BAA2B,CAAC;QACzC,MAAM,IAAI,8BAA8B,MAAM,MAAM,CAAC;QACrD,MAAM,IAAI,qBAAqB,QAAQ,IAAI,CAAC;QAC5C,MAAM,IAAI,iBAAiB,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,aAAa,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC;QACtG,MAAM,IAAI,qBAAqB,WAAW,IAAI,CAAC;QAC/C,MAAM,IAAI,wBAAwB,UAAU,MAAM,CAAC;QACnD,MAAM,IAAI,oBAAoB,UAAU,EAAE,CAAC;QAE3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAe;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YACvD,OAAO,EAAE,cAAc;YACvB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,OAAO;YACrB,IAAI,EAAE,CAAC,OAAkB,CAAC;SAC3B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;YACjC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE;YAClD,CAAC,CAAC,OAAO,CAAC;QAEZ,OAAO,sBAAsB;YAC3B,cAAc,OAAO,MAAM;YAC3B,WAAW,MAAM,IAAI;YACrB,cAAc,MAAM,CAAC,IAAI,CAAC,YAAY;YACtC,eAAe,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YAC9C,OAAO,EAAE,cAAc;YACvB,GAAG,EAAE,SAAS;YACd,YAAY,EAAE,eAAe;SAC9B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAExE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,aAAa,SAAS,iCAAiC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QACvI,CAAC;QACD,OAAO,oCAAoC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE9C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,EAAE;YACL,OAAO,WAAW,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,YAAY,EAAE,CAAC;QACxB,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,cAAc,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC;QACZ;YACE,OAAO;;;;;;;;;;;;cAYC,cAAc,IAAI,CAAC;IAC/B,CAAC;AACH,CAAC;AAEY,QAAA,KAAK,GAAG;IACnB;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9C,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,0EAA0E;QACvF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9C,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,EAAE;KACpC;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sCAAsC;QACnD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,EAAE;YACjF,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAuB,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;KAC1E;CACF,CAAC;AAEF,kBAAe;IACb,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,uCAAuC;IACpD,QAAQ,EAAE,CAAC,QAAQ,CAAC;IACpB,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE;IAClC,MAAM,EAAE,OAAO;IACf,KAAK,EAAL,aAAK;CACN,CAAC"}

package/dist/skills/executor.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Skill Executor - Central registry for all 110 bundled CLI skill handlers.
+ *
+ * ARCHITECTURE:
+ * - Each skill lives in src/skills/bundled/<name>/index.ts
+ * - Each skill exports default { name, description, commands, handle|handler }
+ * - Skills are loaded lazily via dynamic import() on first use
+ * - Each skill is loaded in its own try/catch so one broken skill can't crash others
+ * - Skills can declare `requires: { env: ['VAR'] }` for pre-flight env checks
+ *
+ * ADDING A NEW SKILL:
+ * 1. Create src/skills/bundled/<name>/index.ts with default export
+ * 2. Add the directory name to SKILL_MANIFEST below
+ * 3. Run `npx tsc --noEmit` to verify
+ *
+ * SKILL HANDLER CONTRACT:
+ * - `handle(args: string)` receives everything AFTER the command prefix
+ *   e.g., "/bf balance" calls handle("balance")
+ * - Must return a Promise<string> (the response text)
+ * - Both `handle` and `handler` method names are accepted (normalizeSkill handles both)
+ * - commands can be string[] or {name, description, usage}[] (normalized to string[])
+ *
+ * BACKING MODULES:
+ * - Most skills wrap real modules in src/ (e.g., execution/, trading/, feeds/, etc.)
+ * - Skills use dynamic imports (await import(...)) inside try/catch so the CLI
+ *   still works even if a backing module's dependencies aren't installed
+ * - When a backing module can't load, the skill falls through to help text
+ */
+export interface SkillHandler {
+    name: string;
+    description: string;
+    commands: string[] | Array<{
+        name: string;
+        description: string;
+        usage: string;
+    }>;
+    /** Handler function (can be named 'handle' or 'handler') */
+    handle?: (args: string) => Promise<string>;
+    handler?: (args: string) => Promise<string>;
+    /** Optional requirements that must be met before the handler runs */
+    requires?: {
+        env?: string[];
+    };
+}
+/** Normalized skill handler with guaranteed handle function */
+interface NormalizedSkillHandler {
+    name: string;
+    description: string;
+    commands: string[];
+    handle: (args: string) => Promise<string>;
+}
+export interface SkillExecutionResult {
+    handled: boolean;
+    response?: string;
+    error?: string;
+    skill?: string;
+    /** If set, the command should be dispatched directly to this tool (bypass LLM) */
+    dispatch?: {
+        tool: string;
+        args: string;
+        argMode: 'raw' | 'parsed';
+    };
+}
+interface DispatchEntry {
+    toolName: string;
+    argMode: 'raw' | 'parsed';
+    skillName: string;
+}
+/**
+ * Register a SKILL.md skill for direct command dispatch.
+ * Called by the SkillManager when loading skills with command-dispatch: tool.
+ */
+export declare function registerDispatchSkill(command: string, entry: DispatchEntry): void;
+/**
+ * Clear all dispatch skill registrations (called on reload).
+ */
+export declare function clearDispatchSkills(): void;
+/**
+ * Get the full skill manifest (list of all bundled skill directory names).
+ * Used by MCP server to expose skills as tools.
+ */
+export declare function getSkillManifest(): string[];
+/**
+ * Execute a skill command
+ *
+ * @param message - The full message text (e.g., "/bf balance")
+ * @returns Result of execution
+ */
+export declare function executeSkillCommand(message: string): Promise<SkillExecutionResult>;
+/**
+ * Get all registered skill handlers
+ */
+export declare function getRegisteredSkills(): NormalizedSkillHandler[];
+/**
+ * Get skill handler by command
+ */
+export declare function getSkillByCommand(command: string): NormalizedSkillHandler | undefined;
+/**
+ * Check if a command is handled by a skill (handler or dispatch)
+ */
+export declare function isSkillCommand(command: string): boolean;
+/**
+ * Get all registered skill commands
+ */
+export declare function getSkillCommands(): Array<{
+    command: string;
+    skill: string;
+    description: string;
+}>;
+/**
+ * Get list of failed skills (for diagnostics)
+ */
+export declare function getFailedSkills(): Array<{
+    name: string;
+    error: string;
+}>;
+export {};