create-message-kit 1.1.5 → 1.1.7-beta.10

package/README.md

@@ -15,3 +15,7 @@ npx create-message-kit@latest
 ```bash
 yarn create message-kit
 ```
+
+```bash [npm]
+npm init message-kit@latest
+```

package/index.js

@@ -14,15 +14,11 @@ const packageJson = JSON.parse(
   fs.readFileSync(resolve(__dirname, "package.json"), "utf8"),
 );
 const version = packageJson.version;
-const pckMessageKitLib = JSON.parse(
-  fs.readFileSync(resolve(__dirname, "../message-kit/package.json"), "utf8"),
-);
-const versionMessageKitLib = pckMessageKitLib.version;
 program
   .name("byob")
   .description("CLI to initialize projects")
   .action(async () => {
-    log.info(pc.cyan(`Welcome to MessageKit v${versionMessageKitLib}!`));
+    log.info(pc.cyan(`Welcome to MessageKit CLI v${version}!`));
     const coolLogo = `
 ███╗   ███╗███████╗███████╗███████╗ █████╗  ██████╗ ███████╗██╗  ██╗██╗████████╗
 ████╗ ████║██╔════╝██╔════╝██╔════╝██╔══██╗██╔════╝ ██╔════╝██║ ██╔╝██║╚══██╔══╝
@@ -183,7 +179,6 @@ function createGitignore(destDir) {
 # Main
 .env
 node_modules/
-.gitignore
 .data/
 dist/
 .DS_Store

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-message-kit",
-  "version": "1.1.5",
+  "version": "1.1.7-beta.10",
   "license": "MIT",
   "type": "module",
   "main": "index.js",

package/templates/agent/src/handler/ens.ts

@@ -1,16 +1,19 @@
-import { HandlerContext } from "@xmtp/message-kit";
-import { getUserInfo, clearInfoCache, isOnXMTP } from "../lib/resolver.js";
+import { HandlerContext, SkillResponse } from "@xmtp/message-kit";
+import { getUserInfo, clearInfoCache, isOnXMTP } from "@xmtp/message-kit";
 import { isAddress } from "viem";
-import { clearMemory } from "../lib/openai.js";
+import { clearMemory } from "@xmtp/message-kit";
 
 export const frameUrl = "https://ens.steer.fun/";
 export const ensUrl = "https://app.ens.domains/";
 export const baseTxUrl = "https://base-tx-frame.vercel.app";
 
-export async function handleEns(context: HandlerContext) {
+export async function handleEns(
+  context: HandlerContext,
+): Promise<SkillResponse | undefined> {
   const {
     message: {
-      content: { command, params, sender },
+      sender,
+      content: { command, params },
     },
   } = context;
   if (command == "reset") {
@@ -84,13 +87,7 @@ export async function handleEns(context: HandlerContext) {
     }
     message += `\n\nWould you like to tip the domain owner for getting there first 🤣?`;
     message = message.trim();
-    if (
-      await isOnXMTP(
-        context.v2client,
-        data?.ensInfo?.ens,
-        data?.ensInfo?.address,
-      )
-    ) {
+    if (await isOnXMTP(context.client, context.v2client, sender?.address)) {
       await context.send(
         `Ah, this domains is in XMTP, you can message it directly: https://converse.xyz/dm/${domain}`,
       );
@@ -115,7 +112,7 @@ export async function handleEns(context: HandlerContext) {
       };
     } else {
       let message = `Looks like ${domain} is already registered!`;
-      await context.skill("/cool " + domain);
+      await context.executeSkill("/cool " + domain);
       return {
         code: 404,
         message,
@@ -145,6 +142,8 @@ export async function handleEns(context: HandlerContext) {
       code: 200,
       message: `${generateCoolAlternatives(domain)}`,
     };
+  } else {
+    return { code: 400, message: "Command not found." };
   }
 }
 

package/templates/agent/src/index.ts

@@ -1,10 +1,10 @@
 import { run, HandlerContext } from "@xmtp/message-kit";
-import { textGeneration, processResponseWithSkill } from "./lib/openai.js";
+import { textGeneration, processMultilineResponse } from "@xmtp/message-kit";
 import { agent_prompt } from "./prompt.js";
-import { getUserInfo } from "./lib/resolver.js";
+import { getUserInfo } from "@xmtp/message-kit";
 
 run(async (context: HandlerContext) => {
-  /*All the commands are handled through the commands file*/
+  /*All the skills are handled through the skills file*/
   /* If its just text, it will be handled by the ensAgent*/
   /* If its a group message, it will be handled by the groupAgent*/
   if (!process?.env?.OPEN_AI_API_KEY) {
@@ -31,7 +31,7 @@ run(async (context: HandlerContext) => {
       userPrompt,
       await agent_prompt(userInfo),
     );
-    await processResponseWithSkill(sender.address, reply, context);
+    await processMultilineResponse(sender.address, reply, context);
   } catch (error) {
     console.error("Error during OpenAI call:", error);
     await context.send("An error occurred while processing your request.");

package/templates/agent/src/lib/gpt.ts

@@ -0,0 +1,161 @@
+import "dotenv/config";
+import type { SkillGroup } from "@xmtp/message-kit";
+import OpenAI from "openai";
+const openai = new OpenAI({
+  apiKey: process.env.OPEN_AI_API_KEY,
+});
+
+type ChatHistoryEntry = { role: string; content: string };
+type ChatHistories = Record<string, ChatHistoryEntry[]>;
+// New ChatMemory class
+class ChatMemory {
+  private histories: ChatHistories = {};
+
+  getHistory(address: string): ChatHistoryEntry[] {
+    return this.histories[address] || [];
+  }
+
+  addEntry(address: string, entry: ChatHistoryEntry) {
+    if (!this.histories[address]) {
+      this.histories[address] = [];
+    }
+    this.histories[address].push(entry);
+  }
+
+  initializeWithSystem(address: string, systemPrompt: string) {
+    if (this.getHistory(address).length === 0) {
+      this.addEntry(address, {
+        role: "system",
+        content: systemPrompt,
+      });
+    }
+  }
+
+  clear() {
+    this.histories = {};
+  }
+}
+
+// Create singleton instance
+export const chatMemory = new ChatMemory();
+
+export const clearMemory = () => {
+  chatMemory.clear();
+};
+
+export const PROMPT_RULES = `You are a helpful and playful agent called {NAME} that lives inside a web3 messaging app called Converse.
+- You can respond with multiple messages if needed. Each message should be separated by a newline character.
+- You can trigger skills by only sending the command in a newline message.
+- Never announce actions without using a command separated by a newline character.
+- Dont answer in markdown format, just answer in plaintext.
+- Do not make guesses or assumptions
+- Only answer if the verified information is in the prompt.
+- Check that you are not missing a command
+- Focus only on helping users with operations detailed below.
+`;
+
+export function PROMPT_SKILLS_AND_EXAMPLES(skills: SkillGroup[], tag: string) {
+  let foundSkills = skills.filter(
+    (skill) => skill.tag == `@${tag.toLowerCase()}`,
+  );
+  if (!foundSkills.length || !foundSkills[0] || !foundSkills[0].skills)
+    return "";
+  let returnPrompt = `\nCommands:\n${foundSkills[0].skills
+    .map((skill) => skill.command)
+    .join("\n")}\n\nExamples:\n${foundSkills[0].skills
+    .map((skill) => skill.examples)
+    .join("\n")}`;
+  return returnPrompt;
+}
+
+export async function textGeneration(
+  memoryKey: string,
+  userPrompt: string,
+  systemPrompt: string,
+) {
+  if (!memoryKey) {
+    clearMemory();
+  }
+  let messages = chatMemory.getHistory(memoryKey);
+  chatMemory.initializeWithSystem(memoryKey, systemPrompt);
+  if (messages.length === 0) {
+    messages.push({
+      role: "system",
+      content: systemPrompt,
+    });
+  }
+  messages.push({
+    role: "user",
+    content: userPrompt,
+  });
+  try {
+    const response = await openai.chat.completions.create({
+      model: "gpt-4o",
+      messages: messages as any,
+    });
+    const reply = response.choices[0].message.content;
+    messages.push({
+      role: "assistant",
+      content: reply || "No response from OpenAI.",
+    });
+    const cleanedReply = parseMarkdown(reply as string);
+    chatMemory.addEntry(memoryKey, {
+      role: "assistant",
+      content: cleanedReply,
+    });
+    return { reply: cleanedReply, history: messages };
+  } catch (error) {
+    console.error("Failed to fetch from OpenAI:", error);
+    throw error;
+  }
+}
+
+export async function processMultilineResponse(
+  memoryKey: string,
+  reply: string,
+  context: any,
+) {
+  if (!memoryKey) {
+    clearMemory();
+  }
+  let messages = reply
+    .split("\n")
+    .map((message: string) => parseMarkdown(message))
+    .filter((message): message is string => message.length > 0);
+
+  console.log(messages);
+  for (const message of messages) {
+    if (message.startsWith("/")) {
+      const response = await context.executeSkill(message);
+      if (response && typeof response.message === "string") {
+        let msg = parseMarkdown(response.message);
+        chatMemory.addEntry(memoryKey, {
+          role: "system",
+          content: msg,
+        });
+        await context.send(response.message);
+      }
+    } else {
+      await context.send(message);
+    }
+  }
+}
+export function parseMarkdown(message: string) {
+  let trimmedMessage = message;
+  // Remove bold and underline markdown
+  trimmedMessage = trimmedMessage?.replace(/(\*\*|__)(.*?)\1/g, "$2");
+  // Remove markdown links, keeping only the URL
+  trimmedMessage = trimmedMessage?.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$2");
+  // Remove markdown headers
+  trimmedMessage = trimmedMessage?.replace(/^#+\s*(.*)$/gm, "$1");
+  // Remove inline code formatting
+  trimmedMessage = trimmedMessage?.replace(/`([^`]+)`/g, "$1");
+  // Remove single backticks at the start or end of the message
+  trimmedMessage = trimmedMessage?.replace(/^`|`$/g, "");
+  // Remove leading and trailing whitespace
+  trimmedMessage = trimmedMessage?.replace(/^\s+|\s+$/g, "");
+  // Remove any remaining leading or trailing whitespace
+  trimmedMessage = trimmedMessage.trim();
+
+  return trimmedMessage;
+}

package/templates/agent/src/lib/openai.ts

@@ -48,7 +48,7 @@ export const chatMemory = new ChatMemory();
 let chatHistories: ChatHistories = {};
 export const PROMPT_RULES = `You are a helpful and playful agent called {NAME} that lives inside a web3 messaging app called Converse.
 - You can respond with multiple messages if needed. Each message should be separated by a newline character.
-- You can trigger commands by only sending the command in a newline message.
+- You can trigger skills by only sending the command in a newline message.
 - Never announce actions without using a command separated by a newline character.
 - Dont answer in markdown format, just answer in plaintext.
 - Do not make guesses or assumptions
@@ -81,7 +81,7 @@ export async function agentResponse(
       userPrompt,
       systemPrompt,
     );
-    await processResponseWithSkill(sender.address, reply, context);
+    await processMultilineResponse(sender.address, reply, context);
   } catch (error) {
     console.error("Error during OpenAI call:", error);
     await context.reply("An error occurred while processing your request.");
@@ -126,7 +126,7 @@ export async function textGeneration(
   }
 }
 
-export async function processResponseWithSkill(
+export async function processMultilineResponse(
   address: string,
   reply: string,
   context: any,

package/templates/agent/src/lib/resolver.ts

@@ -1,5 +1,6 @@
-import { Client } from "@xmtp/xmtp-js";
+import type { Client } from "@xmtp/xmtp-js";
 import { isAddress } from "viem";
+import type { HandlerContext } from "@xmtp/message-kit";
 
 export const converseEndpointURL =
   "https://converse-website-git-endpoit-ephemerahq.vercel.app";
@@ -16,8 +17,8 @@ export type ConverseProfile = {
 export type UserInfo = {
   ensDomain?: string | undefined;
   address?: string | undefined;
+  preferredName: string | undefined;
   converseUsername?: string | undefined;
-  preferredName?: string | undefined;
   ensInfo?: EnsData | undefined;
   avatar?: string | undefined;
 };
@@ -48,12 +49,14 @@ export const clearInfoCache = () => {
 export const getUserInfo = async (
   key: string,
   clientAddress?: string,
+  context?: HandlerContext,
 ): Promise<UserInfo | null> => {
   let data: UserInfo = infoCache.get(key) || {
     ensDomain: undefined,
     address: undefined,
     converseUsername: undefined,
     ensInfo: undefined,
+    preferredName: undefined,
   };
   if (isAddress(clientAddress || "")) {
     data.address = clientAddress;
@@ -74,12 +77,15 @@ export const getUserInfo = async (
   } else {
     data.converseUsername = key;
   }
-
+  data.preferredName = data.ensDomain || data.converseUsername || "Friend";
   let keyToUse = data.address || data.ensDomain || data.converseUsername;
   let cacheData = keyToUse && infoCache.get(keyToUse);
-  console.log("Getting user info", { cacheData, keyToUse, data });
+  //console.log("Getting user info", { cacheData, keyToUse, data });
   if (cacheData) return cacheData;
 
+  context?.send(
+    "Hey there! Give me a sec while I fetch info about you first...",
+  );
   if (keyToUse?.includes(".eth")) {
     const response = await fetch(`https://ensdata.net/${keyToUse}`);
     const ensData: EnsData = (await response.json()) as EnsData;
@@ -102,13 +108,15 @@ export const getUserInfo = async (
       }),
     });
     const converseData = (await response.json()) as ConverseProfile;
-    if (process.env.MSG_LOG)
-      console.log("Converse data", keyToUse, converseData);
+    //if (process.env.MSG_LOG === "true")
+    //console.log("Converse data", keyToUse, converseData);
     data.converseUsername =
       converseData?.formattedName || converseData?.name || undefined;
     data.address = converseData?.address || undefined;
     data.avatar = converseData?.avatar || undefined;
   }
+
+  data.preferredName = data.ensDomain || data.converseUsername || "Friend";
   if (data.address) infoCache.set(data.address, data);
   return data;
 };
@@ -123,7 +131,8 @@ export const isOnXMTP = async (
 
 export const PROMPT_USER_CONTENT = (userInfo: UserInfo) => {
   let { address, ensDomain, converseUsername, preferredName } = userInfo;
-  let prompt = `User context: 
+  let prompt = `
+User context: 
 - Start by fetch their domain from or Convese username
 - Call the user by their name or domain, in case they have one
 - Ask for a name (if they don't have one) so you can suggest domains.
@@ -132,5 +141,11 @@ export const PROMPT_USER_CONTENT = (userInfo: UserInfo) => {
   if (ensDomain) prompt += `\n- User ENS domain is: ${ensDomain}`;
   if (converseUsername)
     prompt += `\n- Converse username is: ${converseUsername}`;
+
+  prompt = prompt.replace("{ADDRESS}", address || "");
+  prompt = prompt.replace("{ENS_DOMAIN}", ensDomain || "");
+  prompt = prompt.replace("{CONVERSE_USERNAME}", converseUsername || "");
+  prompt = prompt.replace("{PREFERRED_NAME}", preferredName || "");
+
   return prompt;
 };

package/templates/agent/src/prompt.ts

@@ -1,6 +1,11 @@
 import { skills } from "./skills.js";
-import { UserInfo, PROMPT_USER_CONTENT } from "./lib/resolver.js";
-import { PROMPT_RULES, PROMPT_SKILLS_AND_EXAMPLES } from "./lib/openai.js";
+import {
+  getUserInfo,
+  UserInfo,
+  PROMPT_USER_CONTENT,
+  PROMPT_RULES,
+  PROMPT_SKILLS_AND_EXAMPLES,
+} from "@xmtp/message-kit";
 
 export async function agent_prompt(userInfo: UserInfo) {
   let { address, ensDomain, converseUsername, preferredName } = userInfo;
@@ -12,7 +17,7 @@ export async function agent_prompt(userInfo: UserInfo) {
   systemPrompt += PROMPT_USER_CONTENT(userInfo);
 
   //Add skills and examples to the prompt
-  systemPrompt += PROMPT_SKILLS_AND_EXAMPLES(skills);
+  systemPrompt += PROMPT_SKILLS_AND_EXAMPLES(skills, "@ens");
 
   systemPrompt += `
 

package/templates/agent/src/skills.ts

@@ -20,6 +20,19 @@ export const skills: SkillGroup[] = [
           },
         },
       },
+      {
+        command: "/exists",
+        adminOnly: true,
+        examples: ["/exists"],
+        handler: handleEns,
+        triggers: ["/exists"],
+        description: "Check if an address is onboarded.",
+        params: {
+          address: {
+            type: "address",
+          },
+        },
+      },
       {
         command: "/info [domain]",
         triggers: ["/info"],

package/templates/group/src/handler/agent.ts

@@ -1,5 +1,5 @@
 import { HandlerContext, AbstractedMember } from "@xmtp/message-kit";
-import { textGeneration } from "../lib/openai.js";
+import { textGeneration } from "@xmtp/message-kit";
 
 export async function handler(context: HandlerContext) {
   if (!process?.env?.OPEN_AI_API_KEY) {
@@ -10,20 +10,26 @@ export async function handler(context: HandlerContext) {
   const {
     message: {
       sender,
-      content: { content, params },
+      content: { params, text },
     },
   } = context;
 
   const systemPrompt = generateSystemPrompt(context);
   try {
-    let userPrompt = params?.prompt ?? content;
+    let userPrompt = params?.prompt ?? text;
 
     const { reply } = await textGeneration(
       sender.address,
       userPrompt,
       systemPrompt,
     );
-    context.skill(reply);
+
+    try {
+      await context.executeSkill(reply);
+    } catch (error) {
+      console.error("Error executing skill:", error);
+      await context.reply("Failed to execute the requested action.");
+    }
   } catch (error) {
     console.error("Error during OpenAI call:", error);
     await context.reply("An error occurred while processing your request.");
@@ -59,7 +65,7 @@ function generateSystemPrompt(context: HandlerContext) {
   Important:
   - If a user asks jokes, make jokes about web3 devs\n
   - If the user asks about performing an action and you can think of a command that would help, answer directly with the command and nothing else. 
-  - Populate the command with the correct or random values. Always return commands with real values only, using usernames with @ and excluding addresses.\n
+  - Populate the command with the correct or random values. Always return skills with real values only, using usernames with @ and excluding addresses.\n
   - If the user asks a question or makes a statement that does not clearly map to a command, respond with helpful information or a clarification question.\n
   - If the user is grateful, respond asking for a tip in a playful manner.
   `;

package/templates/group/src/handler/game.ts

@@ -4,11 +4,10 @@ import { HandlerContext } from "@xmtp/message-kit";
 export async function handler(context: HandlerContext) {
   const {
     message: {
-      content: { command, params },
+      content: { command, params, text },
     },
   } = context;
   if (!command) {
-    const { content: text } = context?.message?.content;
     if (text === "🔎" || text === "🔍") {
       // Send the URL for the requested game
       context.reply("https://framedl.xyz/");
@@ -34,7 +33,7 @@ export async function handler(context: HandlerContext) {
       context.send("Available games: \n/game wordle\n/game slot");
       break;
     default:
-      // Inform the user about unrecognized commands and provide available options
+      // Inform the user about unrecognized skills and provide available options
       context.send(
         "Command not recognized. Available games: wordle, slot, or help.",
       );

package/templates/group/src/handler/group.ts

@@ -0,0 +1,24 @@
+import { HandlerContext } from "@xmtp/message-kit";
+
+export async function handler(context: HandlerContext) {
+  const {
+    skills,
+    group,
+    message: {
+      content: { command },
+    },
+  } = context;
+
+  if (command == "help") {
+    const intro =
+      "Available experiences:\n" +
+      skills
+        ?.flatMap((app) => app.skills)
+        .map((skill) => `${skill.command} - ${skill.description}`)
+        .join("\n") +
+      "\nUse these skills to interact with specific apps.";
+    context.send(intro);
+  } else if (command == "id") {
+    context.send(context.group?.id);
+  }
+}

package/templates/group/src/handler/helpers.ts

@@ -0,0 +1,23 @@
+import { HandlerContext } from "@xmtp/message-kit";
+
+export async function handler(context: HandlerContext) {
+  const {
+    skills,
+    message: {
+      content: { command },
+    },
+  } = context;
+
+  if (command == "help") {
+    const intro =
+      "Available experiences:\n" +
+      skills
+        ?.flatMap((app) => app.skills)
+        .map((skill) => `${skill.command} - ${skill.description}`)
+        .join("\n") +
+      "\nUse these skills to interact with specific apps.";
+    context.send(intro);
+  } else if (command == "id") {
+    context.send(context.group?.id);
+  }
+}

package/templates/group/src/handler/loyalty.ts

@@ -6,10 +6,13 @@ export async function handler(context: HandlerContext, fake?: boolean) {
   const {
     members,
     group,
-    message: { sender, typeId, content },
+    message: {
+      sender,
+      typeId,
+      content: { command, params, text },
+    },
   } = context;
   if (typeId === "text" && group) {
-    const { command } = content;
     if (command === "points") {
       const points = await stack?.getPoints(sender.address);
       context.reply(`You have ${points} points`);
@@ -31,7 +34,7 @@ export async function handler(context: HandlerContext, fake?: boolean) {
       return;
     }
   } else if (typeId === "group_updated" && group) {
-    const { initiatedByInboxId, addedInboxes } = content;
+    const { initiatedByInboxId, addedInboxes } = params;
     const adminAddress = members?.find(
       (member: AbstractedMember) => member.inboxId === initiatedByInboxId,
     );

package/templates/group/src/handler/splitpayment.ts

@@ -1,5 +1,5 @@
 import { HandlerContext } from "@xmtp/message-kit";
-import { textGeneration } from "../lib/openai.js";
+import { textGeneration } from "../lib/gpt.js";
 import { vision } from "../lib/vision.js";
 import { getUserInfo } from "../lib/resolver.js";
 
@@ -10,7 +10,7 @@ export async function handler(context: HandlerContext) {
   }
   const {
     members,
-    skills,
+    skill,
     message: {
       typeId,
       content: { attachment },
@@ -57,7 +57,7 @@ export async function handler(context: HandlerContext) {
       let splitMessages = JSON.parse(reply);
       for (const message of splitMessages) {
         let msg = message as string;
-        if (msg.startsWith("/")) await context.skill(msg);
+        if (msg.startsWith("/")) await skill(msg);
         else await context.send(msg);
       }
     }

package/templates/group/src/handler/tipping.ts

@@ -1,14 +1,21 @@
-import { HandlerContext, AbstractedMember } from "@xmtp/message-kit";
-import { getUserInfo } from "../lib/resolver.js";
+import {
+  HandlerContext,
+  AbstractedMember,
+  SkillResponse,
+} from "@xmtp/message-kit";
+import { getUserInfo } from "@xmtp/message-kit";
 
-export async function handler(context: HandlerContext) {
+export async function handler(context: HandlerContext): Promise<SkillResponse> {
   const {
     members,
     getMessageById,
-    message: { content, sender, typeId },
+    message: {
+      content: { reference, reply, text, params },
+      sender,
+      typeId,
+    },
   } = context;
-  console.log(sender);
-  const msg = await getMessageById(content.reference);
+  const msg = reference ? await getMessageById(reference) : undefined;
   const replyReceiver = members?.find(
     (member) => member.inboxId === msg?.senderInboxId,
   );
@@ -16,34 +23,29 @@ export async function handler(context: HandlerContext) {
     receivers: AbstractedMember[] = [];
   // Handle different types of messages
   if (typeId === "reply" && replyReceiver) {
-    const { content: reply } = content;
-
-    if (reply.includes("degen")) {
+    if (reply?.includes("degen")) {
       receivers = [replyReceiver];
       const match = reply.match(/(\d+)/);
       if (match)
         amount = parseInt(match[0]); // Extract amount from reply
       else amount = 10;
     }
-  } else if (typeId === "text") {
-    const { content: text, params } = content;
-    if (text.startsWith("/tip") && params) {
-      // Process text commands starting with "/tip"
-      const {
-        params: { amount: extractedAmount, username },
-      } = content;
-      amount = extractedAmount || 10; // Default amount if not specified
+  } else if (typeId === "text" && text?.startsWith("/tip") && params) {
+    // Process text skills starting with "/tip"
+    const { amount: extractedAmount, username } = params;
+    amount = extractedAmount || 10; // Default amount if not specified
 
-      receivers = await Promise.all(
-        username.map((username: string) => getUserInfo(username)),
-      );
-    }
+    receivers = await Promise.all(
+      username.map((username: string) => getUserInfo(username)),
+    );
   }
   if (!sender || receivers.length === 0 || amount === 0) {
     context.reply("Sender or receiver or amount not found.");
-    return;
+    return {
+      code: 400,
+      message: "Sender or receiver or amount not found.",
+    };
   }
-  console.log(receivers);
   const receiverAddresses = receivers.map((receiver) => receiver.address);
   // Process sending tokens to each receiver
 
@@ -57,4 +59,8 @@ export async function handler(context: HandlerContext) {
     `You sent ${amount * receiverAddresses.length} tokens in total.`,
     [sender.address],
   );
+  return {
+    code: 200,
+    message: "Success",
+  };
 }

package/templates/group/src/handler/transaction.ts

@@ -1,8 +1,7 @@
-import { HandlerContext } from "@xmtp/message-kit";
-import { getUserInfo } from "../lib/resolver.js";
+import { getUserInfo, HandlerContext, SkillResponse } from "@xmtp/message-kit";
 
 // Main handler function for processing commands
-export async function handler(context: HandlerContext) {
+export async function handler(context: HandlerContext): Promise<SkillResponse> {
   const {
     message: {
       content: { command, params },
@@ -19,13 +18,19 @@ export async function handler(context: HandlerContext) {
         context.reply(
           "Missing required parameters. Please provide amount, token, and username.",
         );
-        return;
+        return {
+          code: 400,
+          message:
+            "Missing required parameters. Please provide amount, token, and username.",
+        };
       }
-      let name = senderInfo.converseUsername || senderInfo.address;
 
       let sendUrl = `${baseUrl}/?transaction_type=send&amount=${amountSend}&token=${tokenSend}&receiver=${senderInfo.address}`;
       context.send(`${sendUrl}`);
-      break;
+      return {
+        code: 200,
+        message: `${sendUrl}`,
+      };
     case "swap":
       // Destructure and validate parameters for the swap command
       const { amount, token_from, token_to } = params; // [!code hl] // [!code focus]
@@ -34,18 +39,32 @@ export async function handler(context: HandlerContext) {
         context.reply(
           "Missing required parameters. Please provide amount, token_from, and token_to.",
         );
-        return;
+        return {
+          code: 400,
+          message:
+            "Missing required parameters. Please provide amount, token_from, and token_to.",
+        };
       }
 
       let swapUrl = `${baseUrl}/?transaction_type=swap&token_from=${token_from}&token_to=${token_to}&amount=${amount}`;
       context.send(`${swapUrl}`);
-      break;
+      return {
+        code: 200,
+        message: `${swapUrl}`,
+      };
     case "show": // [!code hl] // [!code focus]
       // Show the base URL without the transaction path
       context.reply(`${baseUrl.replace("/transaction", "")}`);
-      break;
+      return {
+        code: 200,
+        message: `${baseUrl.replace("/transaction", "")}`,
+      };
     default:
       // Handle unknown commands
       context.reply("Unknown command. Use help to see all available commands.");
+      return {
+        code: 400,
+        message: "Unknown command. Use help to see all available commands.",
+      };
   }
 }

package/templates/group/src/index.ts

@@ -1,57 +1,12 @@
 import { run, HandlerContext } from "@xmtp/message-kit";
-import { handler as splitpayment } from "./handler/splitpayment.js";
 
 // Main function to run the app
-run(
-  async (context: HandlerContext) => {
-    const {
-      message: { typeId },
-    } = context;
-    switch (typeId) {
-      case "reply":
-        handleReply(context);
-        break;
-      case "remoteStaticAttachment":
-        handleAttachment(context);
-        break;
-    }
-    if (!context.group) {
-      context.send("This is a group bot, add this address to a group");
-    }
-  },
-  { attachments: true },
-);
-async function handleReply(context: HandlerContext) {
-  const {
-    v2client,
-    getReplyChain,
-    version,
-    message: {
-      content: { reference },
-    },
-  } = context;
-
-  const { chain, isSenderInChain } = await getReplyChain(
-    reference,
-    version,
-    v2client.address,
-  );
-  //await context.skill(chain);
-}
-
-// Handle attachment messages
-async function handleAttachment(context: HandlerContext) {
-  await splitpayment(context);
-}
-
-export async function helpHandler(context: HandlerContext) {
-  const { skills } = context;
-  const intro =
-    "Available experiences:\n" +
-    skills
-      ?.flatMap((app) => app.skills)
-      .map((skill) => `${skill.command} - ${skill.description}`)
-      .join("\n") +
-    "\nUse these commands to interact with specific apps.";
-  context.send(intro);
-}
+run(async (context: HandlerContext) => {
+  const { group } = context;
+
+  if (!group) {
+    context.send(
+      "This This bot only works in group chats. Please add this bot to a group to continue",
+    );
+  }
+});

package/templates/group/src/lib/gpt.ts

@@ -0,0 +1,161 @@
+import "dotenv/config";
+import type { SkillGroup } from "@xmtp/message-kit";
+import OpenAI from "openai";
+const openai = new OpenAI({
+  apiKey: process.env.OPEN_AI_API_KEY,
+});
+
+type ChatHistoryEntry = { role: string; content: string };
+type ChatHistories = Record<string, ChatHistoryEntry[]>;
+// New ChatMemory class
+class ChatMemory {
+  private histories: ChatHistories = {};
+
+  getHistory(address: string): ChatHistoryEntry[] {
+    return this.histories[address] || [];
+  }
+
+  addEntry(address: string, entry: ChatHistoryEntry) {
+    if (!this.histories[address]) {
+      this.histories[address] = [];
+    }
+    this.histories[address].push(entry);
+  }
+
+  initializeWithSystem(address: string, systemPrompt: string) {
+    if (this.getHistory(address).length === 0) {
+      this.addEntry(address, {
+        role: "system",
+        content: systemPrompt,
+      });
+    }
+  }
+
+  clear() {
+    this.histories = {};
+  }
+}
+
+// Create singleton instance
+export const chatMemory = new ChatMemory();
+
+export const clearMemory = () => {
+  chatMemory.clear();
+};
+
+export const PROMPT_RULES = `You are a helpful and playful agent called {NAME} that lives inside a web3 messaging app called Converse.
+- You can respond with multiple messages if needed. Each message should be separated by a newline character.
+- You can trigger skills by only sending the command in a newline message.
+- Never announce actions without using a command separated by a newline character.
+- Dont answer in markdown format, just answer in plaintext.
+- Do not make guesses or assumptions
+- Only answer if the verified information is in the prompt.
+- Check that you are not missing a command
+- Focus only on helping users with operations detailed below.
+`;
+
+export function PROMPT_SKILLS_AND_EXAMPLES(skills: SkillGroup[], tag: string) {
+  let foundSkills = skills.filter(
+    (skill) => skill.tag == `@${tag.toLowerCase()}`,
+  );
+  if (!foundSkills.length || !foundSkills[0] || !foundSkills[0].skills)
+    return "";
+  let returnPrompt = `\nCommands:\n${foundSkills[0].skills
+    .map((skill) => skill.command)
+    .join("\n")}\n\nExamples:\n${foundSkills[0].skills
+    .map((skill) => skill.examples)
+    .join("\n")}`;
+  return returnPrompt;
+}
+
+export async function textGeneration(
+  memoryKey: string,
+  userPrompt: string,
+  systemPrompt: string,
+) {
+  if (!memoryKey) {
+    clearMemory();
+  }
+  let messages = chatMemory.getHistory(memoryKey);
+  chatMemory.initializeWithSystem(memoryKey, systemPrompt);
+  if (messages.length === 0) {
+    messages.push({
+      role: "system",
+      content: systemPrompt,
+    });
+  }
+  messages.push({
+    role: "user",
+    content: userPrompt,
+  });
+  try {
+    const response = await openai.chat.completions.create({
+      model: "gpt-4o",
+      messages: messages as any,
+    });
+    const reply = response.choices[0].message.content;
+    messages.push({
+      role: "assistant",
+      content: reply || "No response from OpenAI.",
+    });
+    const cleanedReply = parseMarkdown(reply as string);
+    chatMemory.addEntry(memoryKey, {
+      role: "assistant",
+      content: cleanedReply,
+    });
+    return { reply: cleanedReply, history: messages };
+  } catch (error) {
+    console.error("Failed to fetch from OpenAI:", error);
+    throw error;
+  }
+}
+
+export async function processMultilineResponse(
+  memoryKey: string,
+  reply: string,
+  context: any,
+) {
+  if (!memoryKey) {
+    clearMemory();
+  }
+  let messages = reply
+    .split("\n")
+    .map((message: string) => parseMarkdown(message))
+    .filter((message): message is string => message.length > 0);
+
+  console.log(messages);
+  for (const message of messages) {
+    if (message.startsWith("/")) {
+      const response = await context.executeSkill(message);
+      if (response && typeof response.message === "string") {
+        let msg = parseMarkdown(response.message);
+        chatMemory.addEntry(memoryKey, {
+          role: "system",
+          content: msg,
+        });
+        await context.send(response.message);
+      }
+    } else {
+      await context.send(message);
+    }
+  }
+}
+export function parseMarkdown(message: string) {
+  let trimmedMessage = message;
+  // Remove bold and underline markdown
+  trimmedMessage = trimmedMessage?.replace(/(\*\*|__)(.*?)\1/g, "$2");
+  // Remove markdown links, keeping only the URL
+  trimmedMessage = trimmedMessage?.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$2");
+  // Remove markdown headers
+  trimmedMessage = trimmedMessage?.replace(/^#+\s*(.*)$/gm, "$1");
+  // Remove inline code formatting
+  trimmedMessage = trimmedMessage?.replace(/`([^`]+)`/g, "$1");
+  // Remove single backticks at the start or end of the message
+  trimmedMessage = trimmedMessage?.replace(/^`|`$/g, "");
+  // Remove leading and trailing whitespace
+  trimmedMessage = trimmedMessage?.replace(/^\s+|\s+$/g, "");
+  // Remove any remaining leading or trailing whitespace
+  trimmedMessage = trimmedMessage.trim();
+
+  return trimmedMessage;
+}

package/templates/group/src/lib/openai.ts

@@ -48,7 +48,7 @@ export const chatMemory = new ChatMemory();
 let chatHistories: ChatHistories = {};
 export const PROMPT_RULES = `You are a helpful and playful agent called {NAME} that lives inside a web3 messaging app called Converse.
 - You can respond with multiple messages if needed. Each message should be separated by a newline character.
-- You can trigger commands by only sending the command in a newline message.
+- You can trigger skills by only sending the command in a newline message.
 - Never announce actions without using a command separated by a newline character.
 - Dont answer in markdown format, just answer in plaintext.
 - Do not make guesses or assumptions
@@ -81,7 +81,7 @@ export async function agentResponse(
       userPrompt,
       systemPrompt,
     );
-    await processResponseWithSkill(sender.address, reply, context);
+    await processMultilineResponse(sender.address, reply, context);
   } catch (error) {
     console.error("Error during OpenAI call:", error);
     await context.reply("An error occurred while processing your request.");
@@ -126,7 +126,7 @@ export async function textGeneration(
   }
 }
 
-export async function processResponseWithSkill(
+export async function processMultilineResponse(
   address: string,
   reply: string,
   context: any,

package/templates/group/src/lib/resolver.ts

@@ -1,5 +1,6 @@
-import { Client } from "@xmtp/xmtp-js";
+import type { Client } from "@xmtp/xmtp-js";
 import { isAddress } from "viem";
+import type { HandlerContext } from "@xmtp/message-kit";
 
 export const converseEndpointURL =
   "https://converse-website-git-endpoit-ephemerahq.vercel.app";
@@ -16,8 +17,8 @@ export type ConverseProfile = {
 export type UserInfo = {
   ensDomain?: string | undefined;
   address?: string | undefined;
+  preferredName: string | undefined;
   converseUsername?: string | undefined;
-  preferredName?: string | undefined;
   ensInfo?: EnsData | undefined;
   avatar?: string | undefined;
 };
@@ -48,12 +49,14 @@ export const clearInfoCache = () => {
 export const getUserInfo = async (
   key: string,
   clientAddress?: string,
+  context?: HandlerContext,
 ): Promise<UserInfo | null> => {
   let data: UserInfo = infoCache.get(key) || {
     ensDomain: undefined,
     address: undefined,
     converseUsername: undefined,
     ensInfo: undefined,
+    preferredName: undefined,
   };
   if (isAddress(clientAddress || "")) {
     data.address = clientAddress;
@@ -74,12 +77,15 @@ export const getUserInfo = async (
   } else {
     data.converseUsername = key;
   }
-
+  data.preferredName = data.ensDomain || data.converseUsername || "Friend";
   let keyToUse = data.address || data.ensDomain || data.converseUsername;
   let cacheData = keyToUse && infoCache.get(keyToUse);
-  console.log("Getting user info", { cacheData, keyToUse, data });
+  //console.log("Getting user info", { cacheData, keyToUse, data });
   if (cacheData) return cacheData;
 
+  context?.send(
+    "Hey there! Give me a sec while I fetch info about you first...",
+  );
   if (keyToUse?.includes(".eth")) {
     const response = await fetch(`https://ensdata.net/${keyToUse}`);
     const ensData: EnsData = (await response.json()) as EnsData;
@@ -102,13 +108,15 @@ export const getUserInfo = async (
       }),
     });
     const converseData = (await response.json()) as ConverseProfile;
-    if (process.env.MSG_LOG)
-      console.log("Converse data", keyToUse, converseData);
+    /// if (process.env.MSG_LOG === "true")
+    //console.log("Converse data", keyToUse, converseData);
     data.converseUsername =
       converseData?.formattedName || converseData?.name || undefined;
     data.address = converseData?.address || undefined;
     data.avatar = converseData?.avatar || undefined;
   }
+
+  data.preferredName = data.ensDomain || data.converseUsername || "Friend";
   if (data.address) infoCache.set(data.address, data);
   return data;
 };
@@ -123,7 +131,8 @@ export const isOnXMTP = async (
 
 export const PROMPT_USER_CONTENT = (userInfo: UserInfo) => {
   let { address, ensDomain, converseUsername, preferredName } = userInfo;
-  let prompt = `User context: 
+  let prompt = `
+User context: 
 - Start by fetch their domain from or Convese username
 - Call the user by their name or domain, in case they have one
 - Ask for a name (if they don't have one) so you can suggest domains.
@@ -132,5 +141,11 @@ export const PROMPT_USER_CONTENT = (userInfo: UserInfo) => {
   if (ensDomain) prompt += `\n- User ENS domain is: ${ensDomain}`;
   if (converseUsername)
     prompt += `\n- Converse username is: ${converseUsername}`;
+
+  prompt = prompt.replace("{ADDRESS}", address || "");
+  prompt = prompt.replace("{ENS_DOMAIN}", ensDomain || "");
+  prompt = prompt.replace("{CONVERSE_USERNAME}", converseUsername || "");
+  prompt = prompt.replace("{PREFERRED_NAME}", preferredName || "");
+
   return prompt;
 };

package/templates/group/src/lib/vision.ts

@@ -1,5 +1,4 @@
-import dotenv from "dotenv";
-dotenv.config();
+import "dotenv/config";
 
 import OpenAI from "openai";
 const openai = new OpenAI({

package/templates/group/src/skills.ts

@@ -3,7 +3,7 @@ import { handler as agent } from "./handler/agent.js";
 import { handler as transaction } from "./handler/transaction.js";
 import { handler as games } from "./handler/game.js";
 import { handler as loyalty } from "./handler/loyalty.js";
-import { helpHandler } from "./index.js";
+import { handler as groupHelp } from "./handler/helpers.js";
 import type { SkillGroup } from "@xmtp/message-kit";
 
 export const skills: SkillGroup[] = [
@@ -31,6 +31,7 @@ export const skills: SkillGroup[] = [
       },
     ],
   },
+
   {
     name: "Transactions",
     description: "Multipurpose transaction frame built onbase.",
@@ -159,10 +160,18 @@ export const skills: SkillGroup[] = [
         command: "/help",
         triggers: ["/help"],
         examples: ["/help"],
-        handler: helpHandler,
+        handler: groupHelp,
         description: "Get help with the bot.",
         params: {},
       },
+      {
+        command: "/id",
+        adminOnly: true,
+        handler: groupHelp,
+        triggers: ["/id"],
+        description: "Get the group ID.",
+        params: {},
+      },
     ],
   },
 ];