create-message-kit 1.2.27 → 1.2.29

package/index.js

@@ -7,7 +7,7 @@ import { default as fs } from "fs-extra";
 import { isCancel } from "@clack/prompts";
 import { detect } from "detect-package-manager";
 import pc from "picocolors";
-const defVersion = "1.2.27";
+const defVersion = "1.2.29";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 // Read package.json to get the version
@@ -113,6 +113,10 @@ async function gatherProjectInfo() {
       value: "templates/ens",
       label: "ENS - Template with ENS integration",
     },
+    {
+      value: "templates/paymentagent",
+      label: "Payment Agent - Template for funding an agent wallet",
+    },
   ];
 
   const templateType = await select({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-message-kit",
-  "version": "1.2.27",
+  "version": "1.2.29",
   "license": "MIT",
   "type": "module",
   "main": "index.js",

package/templates/ens/.cursorrules

@@ -34,7 +34,7 @@ export async function handler(context: Context) {
     },
   } = context;
 
-  const data = await context.getUserInfo(domain);
+  const data = await getUserInfo(domain);
 
   if (!data?.address) {
     let message = `Looks like ${domain} is available! Here you can register it: ${ensUrl}${domain} or would you like to see some cool alternatives?`;
@@ -102,14 +102,14 @@ export async function handler(context: Context) {
   } = context;
   let receiverAddress = address;
   if (username) {
-    receiverAddress = (await context.getUserInfo(username))?.address;
+    receiverAddress = (await getUserInfo(username))?.address;
   }
   if (address) {
     // Prioritize address over username
     receiverAddress = address;
   }
 
-  await context.requestPayment(receiverAddress, amount, token);
+  await context.framekit.requestPayment(receiverAddress, amount, token);
 }
 
 

package/templates/ens/src/skills/check.ts

@@ -1,5 +1,4 @@
-import { Context } from "@xmtp/message-kit";
-import type { Skill } from "@xmtp/message-kit";
+import { Context, getUserInfo, Skill } from "@xmtp/message-kit";
 
 const ensUrl = "https://app.ens.domains/";
 
@@ -29,7 +28,7 @@ export async function handler(context: Context) {
     },
   } = context;
 
-  const data = await context.getUserInfo(domain);
+  const data = await getUserInfo(domain);
 
   if (!data?.address) {
     let message = `Looks like ${domain} is available! Here you can register it: ${ensUrl}${domain} or would you like to see some cool alternatives?`;

package/templates/ens/src/skills/info.ts

@@ -1,6 +1,4 @@
-import { Context } from "@xmtp/message-kit";
-
-import type { Skill } from "@xmtp/message-kit";
+import { Context, getUserInfo, Skill } from "@xmtp/message-kit";
 
 // [!region define]
 export const info: Skill[] = [
@@ -36,7 +34,7 @@ export async function handler(context: Context) {
     },
   } = context;
 
-  const data = await context.getUserInfo(domain);
+  const data = await getUserInfo(domain);
   if (!data?.address) {
     return {
       code: 404,

package/templates/ens/src/skills/pay.ts

@@ -1,5 +1,4 @@
-import { Context } from "@xmtp/message-kit";
-import type { Skill } from "@xmtp/message-kit";
+import { Context, getUserInfo, Skill } from "@xmtp/message-kit";
 
 export const pay: Skill[] = [
   {
@@ -55,7 +54,7 @@ export async function handler(context: Context) {
   } = context;
   let receiverAddress = address;
   if (username) {
-    receiverAddress = (await context.getUserInfo(username))?.address;
+    receiverAddress = (await getUserInfo(username))?.address;
   }
   if (address) {
     //Prioritize address over username
@@ -63,8 +62,8 @@ export async function handler(context: Context) {
   }
   if (skill === "tip") {
     let tipAmount = 1;
-    await context.requestPayment(receiverAddress, tipAmount);
+    await context.framekit.requestPayment(receiverAddress, tipAmount);
   } else if (skill === "pay") {
-    await context.requestPayment(receiverAddress, amount, token);
+    await context.framekit.requestPayment(receiverAddress, amount, token);
   }
 }

package/templates/ens/src/skills/renew.ts

@@ -1,6 +1,4 @@
-import { Context } from "@xmtp/message-kit";
-
-import type { Skill } from "@xmtp/message-kit";
+import { Context, getUserInfo, Skill } from "@xmtp/message-kit";
 
 const frameUrl = "https://ens.steer.fun/";
 
@@ -37,7 +35,7 @@ export async function handler(context: Context) {
     };
   }
 
-  const data = await context.getUserInfo(domain);
+  const data = await getUserInfo(domain);
 
   if (!data?.address || data?.address !== sender?.address) {
     return {

package/templates/paymentagent/.cursorrules

@@ -0,0 +1,209 @@
+# MessageKit
+
+# Skill Examples
+
+### Check if a Domain is Available
+
+
+import { ensUrl } from "../index.js";
+import { Context } from "@xmtp/message-kit";
+import type { Skill } from "@xmtp/message-kit";
+
+// Define Skill
+export const checkDomain: Skill[] = [
+  {
+    skill: "check",
+    handler: handler,
+    examples: ["/check vitalik.eth", "/check fabri.base.eth"],
+    description: "Check if a domain is available.",
+    params: {
+      domain: {
+        type: "string",
+      },
+    },
+  },
+];
+
+// Handler Implementation
+export async function handler(context: Context) {
+  const {
+    message: {
+      content: {
+        params: { domain },
+      },
+    },
+  } = context;
+
+  const data = await getUserInfo(domain);
+
+  if (!data?.address) {
+    let message = `Looks like ${domain} is available! Here you can register it: ${ensUrl}${domain} or would you like to see some cool alternatives?`;
+    return {
+      code: 200,
+      message,
+    };
+  } else {
+    let message = `Looks like ${domain} is already registered!`;
+    await context.executeSkill("/cool " + domain);
+    return {
+      code: 404,
+      message,
+    };
+  }
+}
+
+### Generate a payment request
+
+
+import { Context } from "@xmtp/message-kit";
+import type { Skill } from "@xmtp/message-kit";
+
+// Define Skill
+export const paymentRequest: Skill[] = [
+  {
+    skill: "pay",
+    examples: [
+      "/pay 10 vitalik.eth",
+      "/pay 1 usdc to 0xC60E6Bb79322392761BFe3081E302aEB79B30B03",
+    ],
+    description:
+      "Send a specified amount of a cryptocurrency to a destination address. \nWhen tipping, you can assume it's 1 USDC.",
+    handler: handler,
+    params: {
+      amount: {
+        default: 10,
+        type: "number",
+      },
+      token: {
+        default: "usdc",
+        type: "string",
+        values: ["eth", "dai", "usdc", "degen"], // Accepted tokens
+      },
+      username: {
+        default: "",
+        type: "username",
+      },
+      address: {
+        default: "",
+        type: "address",
+      },
+    },
+  },
+];
+
+// Handler Implementation
+export async function handler(context: Context) {
+  const {
+    message: {
+      content: {
+        params: { amount, token, username, address },
+      },
+    },
+  } = context;
+  let receiverAddress = address;
+  if (username) {
+    receiverAddress = (await getUserInfo(username))?.address;
+  }
+  if (address) {
+    // Prioritize address over username
+    receiverAddress = address;
+  }
+
+  await context.framekit.requestPayment(receiverAddress, amount, token);
+}
+
+
+# Docs
+
+# Structure
+
+## File structure
+
+Each app consists of the following files:
+
+```
+agent/
+├── src/
+│   └── index.ts
+│   └── prompt.ts # Optional
+│   └── plugins/ # Optional
+│       └── ...
+│   └── skills/ # Optional
+│       └── ...
+│   └── vibes/ # Optional
+│       └── ...
+├── tsconfig.json
+├── package.json
+└── .env
+```
+
+## Agent
+
+This is the main function that runs the listener.
+
+```jsx
+import { Agent, run, Context } from "@xmtp/message-kit";
+
+const agent: Agent = {
+  name: "Agent Name",
+  tag: "@bot",
+  description: "Agent Description",
+  skills: [skill1, skill2],
+  onMessage: async (context: Context) => {
+        /* Logs every message in a conversation.
+        If not declared, the agent will automatically use the defined skills.
+        Alternatively, you can implement your own logic here. */
+    },
+  config: {
+    // Optional parameters
+  },
+};
+//starts the agent
+run(agent);
+```
+
+#### Config parameters
+
+- `privateKey`: the private key of the agent wallet, like any normal wallet private key.
+- `experimental`: experimental features like logging all group messages. Default is `false`.
+- `attachments`: to receive attachments. Default is `false`.
+- `gptModel`: model to be used. Default is `gpt-4o`.
+- `client`: Optional parameters to pass to the XMTP client.
+- `agent`: Custom agent to be used. Default is to create the skills in the `src/skills.ts` file.
+- `hideInitLogMessage`: hide the init log message with messagekit logo and stuff
+- `memberChange`: if true, member changes will be enabled, like adding members to the group
+
+## Skills
+
+Skills are the actions of the agent. They are defined in the `src/skills/your-skill.ts` file.
+
+```tsx
+import { Skill } from "@xmtp/message-kit";
+
+export const checkDomain: Skill[] = [
+  {
+    skill: // name of the skill
+    handler: // function to handle the skill
+    examples: // examples of the skill
+    description: // description of the skill
+    params: // params of the skill
+  },
+];
+```
+
+## Vibes
+
+Vibes are the personalities of the agent. They are defined in the `src/vibes/your-vibe.ts` file.
+
+```tsx
+import { Vibe } from "@xmtp/message-kit";
+
+export const chill: Vibe = {
+  vibe: // name of the vibe
+  description: // description of the vibe
+  tone: // tone of the vibe
+  style: // style of the vibe
+};
+```
+
+> See [Vibes](/community/vibes) for more information.

package/templates/paymentagent/.env.example

@@ -0,0 +1,2 @@
+KEY= # the private key of the agent wallet
+TEST_ENCRYPTION_KEY= # a different private key for encryption

package/templates/paymentagent/.yarnrc.yml

@@ -0,0 +1,9 @@
+compressionLevel: mixed
+
+enableGlobalCache: false
+
+enableTelemetry: false
+
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-4.5.1.cjs

package/templates/paymentagent/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "paymentagent",
+  "private": true,
+  "description": "A human agent for managing your funds",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w & sleep 1 && NODE_NO_WARNINGS=1 node --watch dist/index.js",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@xmtp/message-kit": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.2",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/templates/paymentagent/src/index.ts

@@ -0,0 +1,19 @@
+import { run, Agent, concierge } from "@xmtp/message-kit";
+import { degen } from "./vibes/degen.js";
+import { systemPrompt } from "./prompt.js";
+
+const agent: Agent = {
+  name: "Human Agent",
+  tag: "@bot",
+  description: "An agent that performs payments and transfers in usdc. .",
+  intro:
+    "You are a helpful agent called {agent_name} that helps people with their agent wallets. You can help them fund their wallets, check their balance and making transfers. All in usdc.",
+  vibe: degen,
+  systemPrompt,
+  skills: [concierge],
+  config: {
+    walletService: true,
+  },
+};
+
+run(agent);

package/templates/paymentagent/src/prompt.ts

@@ -0,0 +1,10 @@
+export const systemPrompt = `{intro}
+
+{vibe}
+
+{rules}
+
+{user_context}
+
+{skills}
+`;

package/templates/paymentagent/src/vibes/degen.ts

@@ -0,0 +1,10 @@
+import { Vibe } from "@xmtp/message-kit";
+
+export const degen: Vibe = {
+  vibe: "Degen",
+  description:
+    "A high-energy, risk-embracing personality from the crypto trading world. This vibe combines technical knowledge with meme culture, FOMO-driven enthusiasm, and an 'apes together strong' mentality. Always bullish, never sleeping, and ready to APE into the next big thing.",
+  tone: "enthusiastic and bold, like a trader who just discovered a 100x gem at 3AM",
+  style:
+    "casual and meme-heavy, peppered with crypto slang like 'gm', 'wagmi', and 'probably nothing', while maintaining genuine helpfulness",
+};

package/templates/simple/.cursorrules

@@ -34,7 +34,7 @@ export async function handler(context: Context) {
     },
   } = context;
 
-  const data = await context.getUserInfo(domain);
+  const data = await getUserInfo(domain);
 
   if (!data?.address) {
     let message = `Looks like ${domain} is available! Here you can register it: ${ensUrl}${domain} or would you like to see some cool alternatives?`;
@@ -102,14 +102,14 @@ export async function handler(context: Context) {
   } = context;
   let receiverAddress = address;
   if (username) {
-    receiverAddress = (await context.getUserInfo(username))?.address;
+    receiverAddress = (await getUserInfo(username))?.address;
   }
   if (address) {
     // Prioritize address over username
     receiverAddress = address;
   }
 
-  await context.requestPayment(receiverAddress, amount, token);
+  await context.framekit.requestPayment(receiverAddress, amount, token);
 }