@clawnch/clawtomaton 0.3.0 → 0.4.1

package/dist/skills/portfolio.js

@@ -0,0 +1,189 @@
+/**
+ * Skill: portfolio — View multi-token portfolio with P&L and allocation.
+ *
+ * Shows:
+ *   - All token positions with current value and unrealized P&L
+ *   - Realized P&L from past sells
+ *   - Portfolio allocation percentages
+ *   - Concentration warnings
+ *   - Historical performance (if snapshots exist)
+ *
+ * Actions: view, history, record_trade
+ *
+ * The portfolio is populated automatically by handleSkillSideEffects
+ * when the agent executes swaps. The agent can also manually record
+ * trades via the record_trade action for OTC / external transfers.
+ */
+import { ClawnchTrader, ClawnchPrice } from '@clawnch/clawncher-sdk';
+export const portfolioSkill = {
+    name: 'portfolio',
+    description: [
+        'View your multi-token portfolio: positions, P&L, allocation, performance.',
+        'Actions: view (full summary), history (value over time), record_trade (manual entry).',
+        'Positions auto-update on swaps. No gas cost (read-only, except record_trade).',
+    ].join(' '),
+    parameters: [
+        {
+            name: 'action',
+            type: 'string',
+            description: 'One of: view, history, record_trade',
+            required: true,
+        },
+        {
+            name: 'period',
+            type: 'string',
+            description: 'For history: time period — "24h", "7d", "30d" (default "7d")',
+            required: false,
+        },
+        {
+            name: 'token',
+            type: 'address',
+            description: 'Token address (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'symbol',
+            type: 'string',
+            description: 'Token symbol (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'side',
+            type: 'string',
+            description: 'Trade side: buy or sell (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'amount',
+            type: 'string',
+            description: 'Amount traded in token units (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'priceEth',
+            type: 'string',
+            description: 'Price per token in ETH (for record_trade)',
+            required: false,
+        },
+        {
+            name: 'txHash',
+            type: 'string',
+            description: 'Transaction hash (for record_trade)',
+            required: false,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            if (!ctx.stateStore) {
+                return { callId: '', success: false, result: null, error: 'No state store available.' };
+            }
+            const action = params.action;
+            switch (action) {
+                case 'view':
+                    return handleView(ctx);
+                case 'history':
+                    return handleHistory(ctx, params);
+                case 'record_trade':
+                    return handleRecordTrade(ctx, params);
+                default:
+                    return { callId: '', success: false, result: null, error: `Unknown action: ${action}. Use: view, history, record_trade` };
+            }
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+async function handleView(ctx) {
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    // Build price fetcher using ClawnchPrice
+    const { buildClients } = await import('../identity/index.js');
+    const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+    const { publicClient } = buildClients(ctx.identity, rpcUrl);
+    const price = new ClawnchPrice({ publicClient: publicClient, network: 'mainnet' });
+    const priceFetcher = async (token) => {
+        try {
+            const info = await price.getQuickPrice(token);
+            return { priceEth: info.priceInEth, priceUsd: info.priceInUsd };
+        }
+        catch {
+            return null;
+        }
+    };
+    // Get ETH balance
+    let ethBalanceEth = 0;
+    try {
+        const ethBal = await publicClient.getBalance({ address: ctx.identity.address });
+        ethBalanceEth = Number(ethBal) / 1e18;
+    }
+    catch { }
+    const summary = await trader.getSummary(priceFetcher, ethBalanceEth);
+    if (summary.positions.length === 0) {
+        return {
+            callId: '',
+            success: true,
+            result: `No token positions tracked yet.\nETH Balance: ${ethBalanceEth.toFixed(6)} ETH\n\nPositions are automatically recorded when you execute swaps. Use portfolio action=record_trade for manual entries.`,
+        };
+    }
+    return {
+        callId: '',
+        success: true,
+        result: ClawnchTrader.formatSummary(summary),
+    };
+}
+async function handleHistory(ctx, params) {
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    const periodStr = params.period ?? '7d';
+    const periodMs = parsePeriod(periodStr);
+    const perf = trader.getPerformance(periodMs);
+    if (!perf) {
+        return { callId: '', success: true, result: 'No portfolio snapshots yet. Snapshots are taken each heartbeat.' };
+    }
+    const snapshots = trader.getHistory(20);
+    const lines = [
+        `Portfolio performance (${perf.period}):`,
+        `  Start: ${perf.startValue.toFixed(6)} ETH`,
+        `  End: ${perf.endValue.toFixed(6)} ETH`,
+        `  Change: ${perf.changeEth >= 0 ? '+' : ''}${perf.changeEth.toFixed(6)} ETH (${perf.changePct >= 0 ? '+' : ''}${perf.changePct.toFixed(1)}%)`,
+    ];
+    if (snapshots.length > 0) {
+        lines.push(``, `Recent snapshots (${snapshots.length}):`);
+        for (const s of snapshots.slice(-10)) {
+            lines.push(`  ${new Date(s.timestamp).toISOString().slice(0, 16)} | ${s.totalValueEth.toFixed(6)} ETH | ${s.positionCount} positions`);
+        }
+    }
+    return { callId: '', success: true, result: lines.join('\n') };
+}
+async function handleRecordTrade(ctx, params) {
+    const token = params.token;
+    const side = params.side;
+    const amount = params.amount;
+    const priceEth = params.priceEth;
+    const txHash = params.txHash ?? 'manual';
+    if (!token || !side || !amount || !priceEth) {
+        return { callId: '', success: false, result: null, error: 'Missing parameters: token, side, amount, priceEth are required.' };
+    }
+    const trader = new ClawnchTrader(ctx.stateStore.asTraderStorage());
+    const trade = trader.recordTrade({
+        token,
+        symbol: params.symbol,
+        side: side,
+        amount,
+        priceEth: parseFloat(priceEth),
+        txHash,
+    });
+    return {
+        callId: '',
+        success: true,
+        result: `Trade recorded: ${trade.id}\n  ${trade.side} ${trade.amount} @ ${trade.priceEth} ETH = ${trade.valueEth.toFixed(6)} ETH\n  TX: ${trade.txHash}`,
+    };
+}
+function parsePeriod(period) {
+    const match = period.match(/^(\d+)(h|d)$/);
+    if (!match)
+        return 7 * 24 * 60 * 60 * 1000; // default 7d
+    const value = parseInt(match[1]);
+    const unit = match[2];
+    return unit === 'h' ? value * 60 * 60 * 1000 : value * 24 * 60 * 60 * 1000;
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/skills/portfolio.js.map

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

package/dist/skills/watch-activity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Skill: watch_activity — Check recent on-chain activity for a token.
+ *
+ * Fetches recent ERC-20 transfers and Uniswap V4 swaps for the agent's token.
+ * Reports: swap count, transfer count, unique addresses, largest transfer,
+ * total volume, and whale alerts (transfers > 1% of supply).
+ *
+ * No gas cost — pure read operation.
+ */
+import type { SkillDefinition } from '../types.js';
+export declare const watchActivitySkill: SkillDefinition;
+//# sourceMappingURL=watch-activity.d.ts.map

package/dist/skills/watch-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-activity.d.ts","sourceRoot":"","sources":["../../src/skills/watch-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAQ7E,eAAO,MAAM,kBAAkB,EAAE,eAgIhC,CAAC"}

package/dist/skills/watch-activity.js

@@ -0,0 +1,130 @@
+/**
+ * Skill: watch_activity — Check recent on-chain activity for a token.
+ *
+ * Fetches recent ERC-20 transfers and Uniswap V4 swaps for the agent's token.
+ * Reports: swap count, transfer count, unique addresses, largest transfer,
+ * total volume, and whale alerts (transfers > 1% of supply).
+ *
+ * No gas cost — pure read operation.
+ */
+import { ClawnchWatcher, ClawnchReader, } from '@clawnch/clawncher-sdk';
+import { formatEther } from 'viem';
+/** Transfers above this % of supply are flagged as whale moves */
+const WHALE_THRESHOLD_PCT = 1;
+/** Default lookback: 5,000 blocks (~2.8 hours on Base) */
+const DEFAULT_LOOKBACK_BLOCKS = 5000n;
+export const watchActivitySkill = {
+    name: 'watch_activity',
+    description: [
+        'Check recent on-chain activity for a token: swaps, transfers, whale alerts.',
+        'Scans the last ~3 hours of blocks. Reports volume, unique traders,',
+        'and flags large transfers (>1% of supply). No gas cost (read-only).',
+    ].join(' '),
+    parameters: [
+        {
+            name: 'token',
+            type: 'address',
+            description: 'Token address to monitor. Defaults to own token.',
+            required: false,
+        },
+        {
+            name: 'blocks',
+            type: 'number',
+            description: 'Number of blocks to look back. Default: 5000 (~3 hours).',
+            required: false,
+            default: 5000,
+        },
+    ],
+    execute: async (params, ctx) => {
+        try {
+            const tokenAddress = params.token ?? ctx.identity.tokenAddress;
+            if (!tokenAddress) {
+                return { callId: '', success: false, result: null, error: 'No token address. Deploy a token first or specify one.' };
+            }
+            const { buildClients } = await import('../identity/index.js');
+            const rpcUrl = process.env.BASE_RPC_URL ?? 'https://mainnet.base.org';
+            const { publicClient } = buildClients(ctx.identity, rpcUrl);
+            const watcher = new ClawnchWatcher({ publicClient: publicClient, network: 'mainnet' });
+            const reader = new ClawnchReader({ publicClient: publicClient, network: 'mainnet' });
+            // Get pool ID from token rewards
+            const rewards = await reader.getTokenRewards(tokenAddress);
+            if (!rewards) {
+                return { callId: '', success: false, result: null, error: 'No pool found for this token. Is it a Clawncher token?' };
+            }
+            // Compute pool ID
+            const { keccak256, encodeAbiParameters } = await import('viem');
+            const poolId = keccak256(encodeAbiParameters([
+                { type: 'address' },
+                { type: 'address' },
+                { type: 'uint24' },
+                { type: 'int24' },
+                { type: 'address' },
+            ], [
+                rewards.poolKey.currency0,
+                rewards.poolKey.currency1,
+                rewards.poolKey.fee,
+                rewards.poolKey.tickSpacing,
+                rewards.poolKey.hooks,
+            ]));
+            // Determine block range
+            const lookback = BigInt(params.blocks ?? 5000);
+            const currentBlock = await publicClient.getBlockNumber();
+            const fromBlock = currentBlock > lookback ? currentBlock - lookback : 0n;
+            // Fetch activity
+            const activity = await watcher.getTokenActivity(tokenAddress, poolId, {
+                fromBlock,
+                toBlock: currentBlock,
+                transferLimit: 100,
+                swapLimit: 100,
+            });
+            // Get total supply for whale detection
+            const tokenInfo = await reader.getTokenInfo(tokenAddress);
+            const whaleThreshold = tokenInfo.totalSupply / 100n; // 1%
+            // Build report
+            const lines = [
+                `Activity for ${tokenAddress} (last ${lookback} blocks, ~${Math.round(Number(lookback) * 2 / 3600)}h):`,
+                `  Swaps: ${activity.stats.swapCount}`,
+                `  Transfers: ${activity.stats.transferCount}`,
+                `  Unique addresses: ${activity.stats.uniqueAddresses}`,
+            ];
+            if (activity.stats.totalVolume0 > 0n || activity.stats.totalVolume1 > 0n) {
+                lines.push(`  Volume (currency0): ${formatEther(activity.stats.totalVolume0)}`);
+                lines.push(`  Volume (currency1): ${formatEther(activity.stats.totalVolume1)}`);
+            }
+            if (activity.stats.largestTransfer > 0n) {
+                lines.push(`  Largest transfer: ${formatEther(activity.stats.largestTransfer)} tokens`);
+            }
+            // Whale alerts
+            const whaleTransfers = activity.transfers.filter(t => t.amount >= whaleThreshold);
+            if (whaleTransfers.length > 0) {
+                lines.push('');
+                lines.push(`WHALE ALERTS (>${WHALE_THRESHOLD_PCT}% of supply):`);
+                for (const w of whaleTransfers.slice(0, 10)) {
+                    const pct = Number((w.amount * 10000n) / tokenInfo.totalSupply) / 100;
+                    lines.push(`  ${shortenAddr(w.from)} → ${shortenAddr(w.to)}: ${formatEther(w.amount)} (${pct.toFixed(2)}%) [block ${w.blockNumber}]`);
+                }
+            }
+            // Recent swaps summary (last 5)
+            if (activity.swaps.length > 0) {
+                lines.push('');
+                lines.push('Recent swaps:');
+                for (const s of activity.swaps.slice(0, 5)) {
+                    const side = s.amount0 < 0n ? 'sell' : 'buy';
+                    const amt = s.amount0 < 0n ? -s.amount0 : s.amount0;
+                    lines.push(`  ${side} ${formatEther(amt)} [${shortenAddr(s.sender)}, block ${s.blockNumber}]`);
+                }
+            }
+            if (activity.stats.swapCount === 0 && activity.stats.transferCount === 0) {
+                lines.push('  No activity in this period.');
+            }
+            return { callId: '', success: true, result: lines.join('\n') };
+        }
+        catch (err) {
+            return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };
+        }
+    },
+};
+function shortenAddr(addr) {
+    return `${addr.slice(0, 6)}...${addr.slice(-4)}`;
+}
+//# sourceMappingURL=watch-activity.js.map

package/dist/skills/watch-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-activity.js","sourceRoot":"","sources":["../../src/skills/watch-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,GAGd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAgB,MAAM,MAAM,CAAC;AAGjD,kEAAkE;AAClE,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,0DAA0D;AAC1D,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;QACX,6EAA6E;QAC7E,oEAAoE;QACpE,qEAAqE;KACtE,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,UAAU,EAAE;QACV;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0DAA0D;YACvE,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,IAAI;SACd;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAuB,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,YAAY,GAAI,MAAM,CAAC,KAAiB,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC5E,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;YACvH,CAAC;YAED,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0BAA0B,CAAC;YACtE,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE5D,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,YAAY,EAAE,YAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9F,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,YAAY,EAAE,YAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAE5F,iCAAiC;YACjC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;YACvH,CAAC;YAED,kBAAkB;YAClB,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,SAAS,CACtB,mBAAmB,CACjB;gBACE,EAAE,IAAI,EAAE,SAAS,EAAE;gBACnB,EAAE,IAAI,EAAE,SAAS,EAAE;gBACnB,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAClB,EAAE,IAAI,EAAE,OAAO,EAAE;gBACjB,EAAE,IAAI,EAAE,SAAS,EAAE;aACpB,EACD;gBACE,OAAO,CAAC,OAAO,CAAC,SAAS;gBACzB,OAAO,CAAC,OAAO,CAAC,SAAS;gBACzB,OAAO,CAAC,OAAO,CAAC,GAAG;gBACnB,OAAO,CAAC,OAAO,CAAC,WAAW;gBAC3B,OAAO,CAAC,OAAO,CAAC,KAAK;aACtB,CACF,CACe,CAAC;YAEnB,wBAAwB;YACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAgB,IAAI,IAAI,CAAC,CAAC;YACzD,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,cAAc,EAAE,CAAC;YACzD,MAAM,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAEzE,iBAAiB;YACjB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE;gBACpE,SAAS;gBACT,OAAO,EAAE,YAAY;gBACrB,aAAa,EAAE,GAAG;gBAClB,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YAEH,uCAAuC;YACvC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAC1D,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,KAAK;YAE1D,eAAe;YACf,MAAM,KAAK,GAAa;gBACtB,gBAAgB,YAAY,UAAU,QAAQ,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK;gBACvG,YAAY,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE;gBACtC,gBAAgB,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE;gBAC9C,uBAAuB,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE;aACxD,CAAC;YAEF,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,yBAAyB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC,yBAAyB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,QAAQ,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,uBAAuB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC1F,CAAC;YAED,eAAe;YACf,MAAM,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC;YAClF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,mBAAmB,eAAe,CAAC,CAAC;gBACjE,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;oBAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;oBACtE,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;gBACxI,CAAC;YACH,CAAC;YAED,gCAAgC;YAChC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC3C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;oBAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;oBACpD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;gBACjG,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/G,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/skills/xmtp.d.ts

@@ -0,0 +1,24 @@
+/**
+ * XMTP skill — encrypted messaging and payments via the XMTP protocol.
+ *
+ * Messaging actions:
+ *   - send_message:       Send a text message to a conversation by ID
+ *   - send_dm:            Send a DM to an Ethereum address (creates convo if needed)
+ *   - read_messages:      Read recent messages from a conversation
+ *   - list_convos:        List recent conversations with previews
+ *   - check_inbox:        Check for unread messages in the queue
+ *   - reply:              Reply to the most recent message in a conversation
+ *
+ * Payment actions:
+ *   - request_eth:        Request an ETH payment from user via wallet_sendCalls
+ *   - request_token:      Request an ERC-20 token payment via wallet_sendCalls
+ *   - share_tx:           Share a confirmed transaction hash in a conversation
+ *   - check_token_balance: Check an ERC-20 token balance for an address
+ *
+ * The XMTP client is managed by the agent runtime (started at boot,
+ * available via `ctx.xmtpClient`). This skill is the agent's interface
+ * to send/read messages and handle payments.
+ */
+import type { SkillDefinition } from '../types.js';
+export declare const xmtpSkill: SkillDefinition;
+//# sourceMappingURL=xmtp.d.ts.map

package/dist/skills/xmtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmtp.d.ts","sourceRoot":"","sources":["../../src/skills/xmtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAO7E,eAAO,MAAM,SAAS,EAAE,eAoRvB,CAAC"}