@clawnch/clawtomaton 0.2.2 → 0.4.0

package/dist/xmtp/client.js

@@ -0,0 +1,282 @@
+/**
+ * XMTP client wrapper for Clawtomaton.
+ *
+ * Manages the XMTP Agent SDK lifecycle: creation, message streaming,
+ * conversation management, and graceful shutdown.
+ *
+ * The agent's existing Ethereum wallet key is used as the XMTP identity —
+ * no new keypair needed.
+ *
+ * IMPORTANT: XMTP creates local SQLite database files that MUST persist
+ * across restarts. Each restart without the DB creates a new installation,
+ * and you're limited to 10 installations per inbox.
+ */
+// Lazy-loaded to keep XMTP optional
+let _Agent = null;
+let _createSigner = null;
+let _createUser = null;
+let _filter = null;
+async function loadXmtpSdk() {
+    if (_Agent)
+        return;
+    const sdk = await import('@xmtp/agent-sdk');
+    _Agent = sdk.Agent;
+    _createSigner = sdk.createSigner;
+    _createUser = sdk.createUser;
+    _filter = sdk.filter;
+}
+// ============================================================================
+// XMTP Client
+// ============================================================================
+export class XmtpClient {
+    agent = null; // XMTP Agent instance
+    config;
+    state;
+    walletKey;
+    started = false;
+    messageQueue = [];
+    maxQueueSize = 100;
+    lastProcessedTime = 0;
+    constructor(config, walletKey, state) {
+        this.config = config;
+        this.walletKey = walletKey;
+        this.state = state;
+    }
+    /**
+     * Initialize and start the XMTP agent.
+     * Begins streaming messages into the internal queue.
+     */
+    async start() {
+        if (this.started)
+            return;
+        await loadXmtpSdk();
+        const user = _createUser(this.walletKey);
+        const signer = _createSigner(user);
+        // Derive encryption key from wallet key (deterministic — same wallet = same key)
+        const encryptionKey = this.config.dbEncryptionKey
+            ? hexToBytes(this.config.dbEncryptionKey)
+            : deriveEncryptionKey(this.walletKey);
+        this.agent = await _Agent.create(signer, {
+            env: this.config.env ?? 'production',
+            dbEncryptionKey: encryptionKey,
+            dbPath: this.config.dbPath ?? undefined,
+            appVersion: 'clawtomaton/0.3.0',
+        });
+        // Stream text messages into our queue
+        this.agent.on('text', async (ctx) => {
+            const senderAddress = await ctx.getSenderAddress();
+            const agentAddress = ctx.getClientAddress();
+            // Don't queue our own messages
+            if (senderAddress?.toLowerCase() === agentAddress?.toLowerCase())
+                return;
+            const msg = {
+                id: ctx.message.id,
+                conversationId: ctx.conversation.id,
+                senderAddress: senderAddress ?? 'unknown',
+                content: ctx.message.content,
+                sentAt: ctx.message.sentAt?.getTime?.() ?? Date.now(),
+                isDm: ctx.isDm?.() ?? true,
+                isGroup: ctx.isGroup?.() ?? false,
+            };
+            this.messageQueue.push(msg);
+            // Cap queue size
+            if (this.messageQueue.length > this.maxQueueSize) {
+                this.messageQueue = this.messageQueue.slice(-this.maxQueueSize);
+            }
+        });
+        // Track new conversations
+        this.agent.on('dm', async (ctx) => {
+            this.state.audit('xmtp_dm', `New DM conversation: ${ctx.conversation.id}`);
+        });
+        this.agent.on('group', async (ctx) => {
+            this.state.audit('xmtp_group', `Added to group: ${ctx.conversation.id}`);
+        });
+        this.agent.on('unhandledError', (error) => {
+            console.error(`[xmtp] Unhandled error: ${error}`);
+            this.state.audit('xmtp_error', String(error));
+        });
+        await this.agent.start();
+        this.started = true;
+        this.lastProcessedTime = Date.now();
+        console.log(`[xmtp] Started — address: ${this.agent.address}`);
+        this.state.audit('xmtp_started', `XMTP agent started. Address: ${this.agent.address}`);
+    }
+    /**
+     * Stop the XMTP agent gracefully.
+     */
+    async stop() {
+        if (!this.started || !this.agent)
+            return;
+        try {
+            await this.agent.stop();
+        }
+        catch (err) {
+            console.error(`[xmtp] Error stopping: ${err}`);
+        }
+        this.started = false;
+        console.log('[xmtp] Stopped.');
+    }
+    /**
+     * Check if there are unprocessed messages in the queue.
+     * Used by the heartbeat to decide whether to wake the agent.
+     */
+    hasUnreadMessages() {
+        return this.messageQueue.length > 0;
+    }
+    /**
+     * Drain all queued messages (marks them as processed).
+     * Returns messages ordered by sentAt.
+     */
+    drainMessages() {
+        const messages = [...this.messageQueue].sort((a, b) => a.sentAt - b.sentAt);
+        this.messageQueue = [];
+        this.lastProcessedTime = Date.now();
+        return messages;
+    }
+    /**
+     * Peek at queued messages without draining.
+     */
+    peekMessages() {
+        return [...this.messageQueue].sort((a, b) => a.sentAt - b.sentAt);
+    }
+    /**
+     * Send a text message to a conversation by ID.
+     */
+    async sendMessage(conversationId, text) {
+        if (!this.started || !this.agent) {
+            throw new Error('XMTP client not started');
+        }
+        const conversation = await this.agent.client.conversations.getConversationById(conversationId);
+        if (!conversation) {
+            throw new Error(`Conversation not found: ${conversationId}`);
+        }
+        await conversation.sendText(text);
+        this.state.audit('xmtp_sent', `Sent message to ${conversationId}: ${text.slice(0, 100)}`);
+    }
+    /**
+     * Send a text message to an address (creates DM if needed).
+     * Uses agent.createDmWithAddress() which handles identity resolution.
+     */
+    async sendToAddress(address, text) {
+        if (!this.started || !this.agent) {
+            throw new Error('XMTP client not started');
+        }
+        const conversation = await this.agent.createDmWithAddress(address);
+        await conversation.sendText(text);
+        const conversationId = conversation.id;
+        this.state.audit('xmtp_sent', `Sent DM to ${address}: ${text.slice(0, 100)}`);
+        return conversationId;
+    }
+    /**
+     * List recent conversations with metadata.
+     */
+    async listConversations(limit = 20) {
+        if (!this.started || !this.agent) {
+            throw new Error('XMTP client not started');
+        }
+        await this.agent.client.conversations.sync();
+        const convos = await this.agent.client.conversations.list();
+        const results = [];
+        for (const convo of convos.slice(0, limit)) {
+            try {
+                const messages = await convo.messages();
+                // Find the last text message (skip system/group_updated messages)
+                const textMessages = messages.filter((m) => typeof m.content === 'string' && m.contentType?.typeId === 'text');
+                const lastMessage = textMessages[textMessages.length - 1];
+                const members = await convo.members();
+                // Check if DM by constructor name (Dm vs Group)
+                const isDm = convo.constructor?.name === 'Dm';
+                results.push({
+                    id: convo.id,
+                    isDm,
+                    memberCount: members.length,
+                    lastMessageAt: lastMessage?.sentAt?.getTime?.() ?? 0,
+                    lastMessagePreview: lastMessage?.content
+                        ? String(lastMessage.content).slice(0, 80)
+                        : undefined,
+                });
+            }
+            catch {
+                results.push({
+                    id: convo.id,
+                    isDm: false,
+                    memberCount: 0,
+                    lastMessageAt: 0,
+                });
+            }
+        }
+        return results.sort((a, b) => b.lastMessageAt - a.lastMessageAt);
+    }
+    /**
+     * Get recent messages from a specific conversation.
+     */
+    async getConversationHistory(conversationId, limit = 20) {
+        if (!this.started || !this.agent) {
+            throw new Error('XMTP client not started');
+        }
+        const conversation = await this.agent.client.conversations.getConversationById(conversationId);
+        if (!conversation) {
+            throw new Error(`Conversation not found: ${conversationId}`);
+        }
+        await conversation.sync();
+        const allMessages = await conversation.messages();
+        // Filter to text messages only (skip group_updated, reactions, etc.)
+        const textMessages = allMessages.filter((m) => typeof m.content === 'string' && m.contentType?.typeId === 'text');
+        // Take the most recent `limit` messages
+        const recent = textMessages.slice(-limit);
+        const isDm = conversation.constructor?.name === 'Dm';
+        const results = [];
+        for (const msg of recent) {
+            results.push({
+                id: msg.id,
+                conversationId,
+                senderAddress: msg.senderInboxId ?? 'unknown',
+                content: msg.content,
+                sentAt: msg.sentAt?.getTime?.() ?? 0,
+                isDm,
+                isGroup: !isDm,
+            });
+        }
+        return results;
+    }
+    /**
+     * Get the XMTP address (same as wallet address).
+     */
+    getAddress() {
+        return this.agent?.address ?? null;
+    }
+    /**
+     * Check if the client is running.
+     */
+    isStarted() {
+        return this.started;
+    }
+    /**
+     * Get the number of queued messages.
+     */
+    getQueueSize() {
+        return this.messageQueue.length;
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Derive a deterministic 32-byte encryption key from the wallet private key.
+ * Uses a simple hash approach — the key is always the same for the same wallet.
+ */
+function deriveEncryptionKey(walletKey) {
+    // Simple derivation: take the raw bytes of the private key
+    // The wallet key is already 32 bytes (64 hex chars after 0x prefix)
+    const hex = walletKey.slice(2);
+    return hexToBytes(`0x${hex}`);
+}
+function hexToBytes(hex) {
+    const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(cleanHex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(cleanHex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=client.js.map

package/dist/xmtp/client.js.map

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

package/dist/xmtp/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * XMTP module — bidirectional encrypted messaging for Clawtomaton agents.
+ *
+ * Agents can receive commands and send updates via XMTP.
+ * Discoverable on Base App, World App, and xmtp.chat.
+ */
+export { XmtpClient } from './client.js';
+export type { XmtpConfig, XmtpMessage, XmtpConversationInfo } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xmtp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/xmtp/index.js

@@ -0,0 +1,8 @@
+/**
+ * XMTP module — bidirectional encrypted messaging for Clawtomaton agents.
+ *
+ * Agents can receive commands and send updates via XMTP.
+ * Discoverable on Base App, World App, and xmtp.chat.
+ */
+export { XmtpClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/xmtp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/xmtp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/xmtp/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Types for the XMTP integration.
+ */
+export interface XmtpConfig {
+    /** XMTP network environment */
+    env?: 'local' | 'dev' | 'production';
+    /**
+     * Path to the XMTP local database directory.
+     * CRITICAL: Must persist across restarts and deploys.
+     * Limited to 10 installations per inbox — each lost DB = new installation.
+     * If not set, defaults to the clawtomaton state directory.
+     */
+    dbPath?: string;
+    /**
+     * Encryption key for the XMTP local database (64 hex chars / 32 bytes).
+     * If not set, derived deterministically from the wallet private key.
+     */
+    dbEncryptionKey?: string;
+    /**
+     * Allowlist of Ethereum addresses that can message the agent.
+     * If empty/undefined, all addresses are allowed.
+     * Case-insensitive comparison.
+     */
+    allowlist?: string[];
+    /**
+     * Maximum number of messages to queue before oldest are dropped.
+     * Default: 100
+     */
+    maxQueueSize?: number;
+}
+export interface XmtpMessage {
+    /** Message ID from XMTP */
+    id: string;
+    /** Conversation ID */
+    conversationId: string;
+    /** Sender's Ethereum address or inbox ID */
+    senderAddress: string;
+    /** Text content */
+    content: string;
+    /** Timestamp in ms */
+    sentAt: number;
+    /** Whether this is a DM */
+    isDm: boolean;
+    /** Whether this is a group chat */
+    isGroup: boolean;
+}
+export interface XmtpConversationInfo {
+    /** Conversation ID */
+    id: string;
+    /** Whether this is a DM (vs group) */
+    isDm: boolean;
+    /** Number of members */
+    memberCount: number;
+    /** Timestamp of last message in ms */
+    lastMessageAt: number;
+    /** Preview of last message (truncated) */
+    lastMessagePreview?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/xmtp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,YAAY,CAAC;IAErC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,oBAAoB;IACnC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/xmtp/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the XMTP integration.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/xmtp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/xmtp/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawnch/clawtomaton",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Clawtomaton — Autonomous AI agents that launch and manage crypto projects on Base",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@clawnch/clawncher-sdk": "^0.1.0",
+    "@clawnch/clawncher-sdk": "^0.2.0",
+    "@xmtp/agent-sdk": "^2.2.0",
     "better-sqlite3": "^11.0.0",
     "viem": "^2.0.0"
   },