create-hybrid 1.2.3

package/README.md

@@ -0,0 +1,98 @@
+# create-hybrid
+
+Create a new Hybrid XMTP agent project with a single command.
+
+## Usage
+
+```bash
+# Create a new project
+npx create hybrid my-agent
+
+# Create in current directory
+npx create hybrid .
+
+# Interactive mode (will prompt for name)
+npx create hybrid
+```
+
+## What it creates
+
+This package creates a new Hybrid XMTP agent project with:
+
+- **TypeScript configuration** - Ready-to-use TypeScript setup
+- **Agent template** - Pre-configured agent with OpenRouter integration
+- **Development scripts** - Build, dev, test, and lint commands
+- **Environment setup** - Template `.env` file with required variables:
+
+```env
+# OpenRouter Configuration
+# Get your OpenRouter API key from https://openrouter.ai/keys
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+
+# XMTP Wallet and Encryption Keys
+# Run 'npx hybrid gen:keys' to generate these values
+XMTP_WALLET_KEY=your_wallet_key_here
+XMTP_ENCRYPTION_KEY=your_encryption_key_here
+
+# XMTP Environment (dev, production)
+XMTP_ENV=production
+
+# Server Configuration
+# PORT=8454
+```
+- **Testing framework** - Vitest configuration for unit tests
+
+## Project structure
+
+```
+my-agent/
+├── src/
+│   ├── agent.ts          # Main agent implementation
+│   └── agent.test.ts     # Example tests
+├── .env                  # Environment variables
+├── .gitignore           # Git ignore rules
+├── package.json         # Dependencies and scripts
+├── tsconfig.json        # TypeScript configuration
+├── vitest.config.ts     # Test configuration
+└── README.md           # Project documentation
+```
+
+## Next steps
+
+After creating your project:
+
+1. **Install dependencies**
+   ```bash
+   cd my-agent
+   npm install
+   ```
+
+2. **Get your OpenRouter API key**
+   - Visit [OpenRouter](https://openrouter.ai/keys)
+   - Create an account and generate an API key
+   - Add it to your `.env` file
+
+3. **Generate XMTP keys**
+   ```bash
+   npm run keys
+   ```
+
+4. **Start development**
+   ```bash
+   npm run dev
+   ```
+
+## Requirements
+
+- Node.js 20 or higher
+- npm, yarn, or pnpm
+
+## Related packages
+
+- [`hybrid`](../core) - The main Hybrid framework
+- [`@hybrd/cli`](../cli) - CLI tools for Hybrid development
+- [`@hybrd/xmtp`](../xmtp) - XMTP client integration
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare function initializeProject(): Promise<void>;
+
+export { initializeProject };

package/dist/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { readFile, readdir, writeFile, mkdir, copyFile, stat } from "fs/promises";
+import { dirname, join } from "path";
+import { createInterface } from "readline";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function prompt(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+}
+function replaceTemplateVariables(content, variables) {
+  return content.replace(
+    /\{\{(\w+)\}\}/g,
+    (match, key) => variables[key] || match
+  );
+}
+async function copyTemplate(sourceDir, targetDir) {
+  const entries = await readdir(sourceDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const sourcePath = join(sourceDir, entry.name);
+    const targetPath = join(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      await mkdir(targetPath, { recursive: true });
+      await copyTemplate(sourcePath, targetPath);
+    } else {
+      await copyFile(sourcePath, targetPath);
+    }
+  }
+}
+async function initializeProject() {
+  console.log("\u{1F680} Creating a new Hybrid project...");
+  const projectNameArg = process.argv[2];
+  let projectName = projectNameArg;
+  if (projectNameArg === "") {
+    console.error("\u274C Project name is required");
+    process.exit(1);
+  }
+  if (!projectName || !projectName.trim()) {
+    while (!projectName || !projectName.trim()) {
+      projectName = await prompt("Enter project name: ");
+      if (!projectName || !projectName.trim()) {
+        console.log("\u274C Project name is required. Please enter a valid name.");
+      }
+    }
+  }
+  const sanitizedName = projectName.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  const currentDir = process.cwd();
+  const projectDir = projectName === "." ? currentDir : join(currentDir, sanitizedName);
+  if (projectName !== ".") {
+    try {
+      const existingFiles = await readdir(projectDir);
+      if (existingFiles.length > 0) {
+        console.error(
+          `\u274C Directory "${sanitizedName}" already exists and is not empty`
+        );
+        console.error(
+          "Please choose a different name or remove the existing directory"
+        );
+        process.exit(1);
+      }
+    } catch {
+    }
+  } else {
+    try {
+      const existingFiles = await readdir(currentDir);
+      const significantFiles = existingFiles.filter(
+        (file) => !file.startsWith(".") && file !== "node_modules" && file !== "package-lock.json" && file !== "yarn.lock" && file !== "pnpm-lock.yaml"
+      );
+      if (significantFiles.length > 0) {
+        console.error(`\u274C Current directory already exists and is not empty`);
+        console.error(
+          "Please choose a different directory or remove existing files"
+        );
+        process.exit(1);
+      }
+    } catch {
+    }
+  }
+  console.log("\u{1F4E6} Copying template files...");
+  const templateDir = join(__dirname, "..", "templates", "agent");
+  try {
+    await stat(templateDir);
+  } catch {
+    console.error("\u274C Template directory not found");
+    process.exit(1);
+  }
+  try {
+    await mkdir(projectDir, { recursive: true });
+    await copyTemplate(templateDir, projectDir);
+    console.log(`\u2705 Template files copied to: ${sanitizedName}`);
+  } catch (error) {
+    console.error("\u274C Failed to copy template files:", error);
+    process.exit(1);
+  }
+  const variables = {
+    projectName: sanitizedName
+  };
+  try {
+    const filesToUpdate = [
+      join(projectDir, "package.json"),
+      join(projectDir, "README.md"),
+      join(projectDir, "src", "agent.ts")
+    ];
+    for (const filePath of filesToUpdate) {
+      try {
+        let content = await readFile(filePath, "utf-8");
+        content = replaceTemplateVariables(content, variables);
+        await writeFile(filePath, content, "utf-8");
+      } catch (error) {
+        console.log(
+          `\u26A0\uFE0F  Could not update ${filePath.split("/").pop()}: file not found`
+        );
+      }
+    }
+    console.log("\u2705 Template variables updated");
+  } catch (error) {
+    console.error("\u274C Failed to update template variables:", error);
+  }
+  console.log("\n\u{1F389} Hybrid project created successfully!");
+  console.log(`
+\u{1F4C2} Project created in: ${projectDir}`);
+  console.log("\n\u{1F4CB} Next steps:");
+  console.log(`1. cd ${sanitizedName}`);
+  console.log(
+    "2. Install dependencies (npm install, yarn install, or pnpm install)"
+  );
+  console.log("3. Get your OpenRouter API key from https://openrouter.ai/keys");
+  console.log("4. Add your API key to the OPENROUTER_API_KEY in .env");
+  console.log("5. Set XMTP_ENV in .env (dev or production)");
+  console.log("6. Generate keys: npm run keys (or yarn/pnpm equivalent)");
+  console.log("7. Start development: npm run dev (or yarn/pnpm equivalent)");
+  console.log(
+    "\n\u{1F4D6} For more information, see the README.md file in your project"
+  );
+}
+async function main() {
+  const nodeVersion = process.versions.node;
+  const [major] = nodeVersion.split(".").map(Number);
+  if (!major || major < 20) {
+    console.error("Error: Node.js version 20 or higher is required");
+    process.exit(1);
+  }
+  try {
+    await initializeProject();
+  } catch (error) {
+    console.error("Failed to initialize project:", error);
+    console.error(
+      "Error details:",
+      error instanceof Error ? error.stack : String(error)
+    );
+    process.exit(1);
+  }
+}
+main().catch((error) => {
+  console.error("CLI error:", error);
+  console.error(
+    "Error details:",
+    error instanceof Error ? error.stack : String(error)
+  );
+  process.exit(1);
+});
+export {
+  initializeProject
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { readFile, readdir, writeFile, mkdir, copyFile, stat } from \"node:fs/promises\"\nimport { dirname, join } from \"node:path\"\nimport { createInterface } from \"node:readline\"\nimport { fileURLToPath } from \"node:url\"\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nfunction prompt(question: string): Promise<string> {\n\tconst rl = createInterface({\n\t\tinput: process.stdin,\n\t\toutput: process.stdout\n\t})\n\n\treturn new Promise((resolve) => {\n\t\trl.question(question, (answer) => {\n\t\t\trl.close()\n\t\t\tresolve(answer)\n\t\t})\n\t})\n}\n\nfunction replaceTemplateVariables(\n\tcontent: string,\n\tvariables: Record<string, string>\n): string {\n\treturn content.replace(\n\t\t/\\{\\{(\\w+)\\}\\}/g,\n\t\t(match, key) => variables[key] || match\n\t)\n}\n\nasync function copyTemplate(sourceDir: string, targetDir: string): Promise<void> {\n\tconst entries = await readdir(sourceDir, { withFileTypes: true })\n\t\n\tfor (const entry of entries) {\n\t\tconst sourcePath = join(sourceDir, entry.name)\n\t\tconst targetPath = join(targetDir, entry.name)\n\t\t\n\t\tif (entry.isDirectory()) {\n\t\t\tawait mkdir(targetPath, { recursive: true })\n\t\t\tawait copyTemplate(sourcePath, targetPath)\n\t\t} else {\n\t\t\tawait copyFile(sourcePath, targetPath)\n\t\t}\n\t}\n}\n\nexport async function initializeProject() {\n\tconsole.log(\"🚀 Creating a new Hybrid project...\")\n\n\tconst projectNameArg = process.argv[2]\n\tlet projectName = projectNameArg\n\n\tif (projectNameArg === \"\") {\n\t\tconsole.error(\"❌ Project name is required\")\n\t\tprocess.exit(1)\n\t}\n\n\tif (!projectName || !projectName.trim()) {\n\t\twhile (!projectName || !projectName.trim()) {\n\t\t\tprojectName = await prompt(\"Enter project name: \")\n\t\t\tif (!projectName || !projectName.trim()) {\n\t\t\t\tconsole.log(\"❌ Project name is required. Please enter a valid name.\")\n\t\t\t}\n\t\t}\n\t}\n\n\tconst sanitizedName = projectName\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9-]/g, \"-\")\n\t\t.replace(/-+/g, \"-\")\n\t\t.replace(/^-|-$/g, \"\")\n\n\tconst currentDir = process.cwd()\n\tconst projectDir =\n\t\tprojectName === \".\" ? currentDir : join(currentDir, sanitizedName)\n\n\tif (projectName !== \".\") {\n\t\ttry {\n\t\t\tconst existingFiles = await readdir(projectDir)\n\t\t\tif (existingFiles.length > 0) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t`❌ Directory \"${sanitizedName}\" already exists and is not empty`\n\t\t\t\t)\n\t\t\t\tconsole.error(\n\t\t\t\t\t\"Please choose a different name or remove the existing directory\"\n\t\t\t\t)\n\t\t\t\tprocess.exit(1)\n\t\t\t}\n\t\t} catch {\n\t\t}\n\t} else {\n\t\ttry {\n\t\t\tconst existingFiles = await readdir(currentDir)\n\t\t\tconst significantFiles = existingFiles.filter(\n\t\t\t\t(file) =>\n\t\t\t\t\t!file.startsWith(\".\") &&\n\t\t\t\t\tfile !== \"node_modules\" &&\n\t\t\t\t\tfile !== \"package-lock.json\" &&\n\t\t\t\t\tfile !== \"yarn.lock\" &&\n\t\t\t\t\tfile !== \"pnpm-lock.yaml\"\n\t\t\t)\n\t\t\tif (significantFiles.length > 0) {\n\t\t\t\tconsole.error(`❌ Current directory already exists and is not empty`)\n\t\t\t\tconsole.error(\n\t\t\t\t\t\"Please choose a different directory or remove existing files\"\n\t\t\t\t)\n\t\t\t\tprocess.exit(1)\n\t\t\t}\n\t\t} catch {\n\t\t}\n\t}\n\n\tconsole.log(\"📦 Copying template files...\")\n\t\n\tconst templateDir = join(__dirname, \"..\", \"templates\", \"agent\")\n\t\n\ttry {\n\t\tawait stat(templateDir)\n\t} catch {\n\t\tconsole.error(\"❌ Template directory not found\")\n\t\tprocess.exit(1)\n\t}\n\n\ttry {\n\t\tawait mkdir(projectDir, { recursive: true })\n\t\tawait copyTemplate(templateDir, projectDir)\n\t\tconsole.log(`✅ Template files copied to: ${sanitizedName}`)\n\t} catch (error) {\n\t\tconsole.error(\"❌ Failed to copy template files:\", error)\n\t\tprocess.exit(1)\n\t}\n\n\tconst variables = {\n\t\tprojectName: sanitizedName\n\t}\n\n\ttry {\n\t\tconst filesToUpdate = [\n\t\t\tjoin(projectDir, \"package.json\"),\n\t\t\tjoin(projectDir, \"README.md\"),\n\t\t\tjoin(projectDir, \"src\", \"agent.ts\")\n\t\t]\n\n\t\tfor (const filePath of filesToUpdate) {\n\t\t\ttry {\n\t\t\t\tlet content = await readFile(filePath, \"utf-8\")\n\t\t\t\tcontent = replaceTemplateVariables(content, variables)\n\t\t\t\tawait writeFile(filePath, content, \"utf-8\")\n\t\t\t} catch (error) {\n\t\t\t\tconsole.log(\n\t\t\t\t\t`⚠️  Could not update ${filePath.split(\"/\").pop()}: file not found`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\n\t\tconsole.log(\"✅ Template variables updated\")\n\t} catch (error) {\n\t\tconsole.error(\"❌ Failed to update template variables:\", error)\n\t}\n\n\tconsole.log(\"\\n🎉 Hybrid project created successfully!\")\n\tconsole.log(`\\n📂 Project created in: ${projectDir}`)\n\tconsole.log(\"\\n📋 Next steps:\")\n\tconsole.log(`1. cd ${sanitizedName}`)\n\tconsole.log(\n\t\t\"2. Install dependencies (npm install, yarn install, or pnpm install)\"\n\t)\n\tconsole.log(\"3. Get your OpenRouter API key from https://openrouter.ai/keys\")\n\tconsole.log(\"4. Add your API key to the OPENROUTER_API_KEY in .env\")\n\tconsole.log(\"5. Set XMTP_ENV in .env (dev or production)\")\n\tconsole.log(\"6. Generate keys: npm run keys (or yarn/pnpm equivalent)\")\n\tconsole.log(\"7. Start development: npm run dev (or yarn/pnpm equivalent)\")\n\n\tconsole.log(\n\t\t\"\\n📖 For more information, see the README.md file in your project\"\n\t)\n}\n\nasync function main() {\n\tconst nodeVersion = process.versions.node\n\tconst [major] = nodeVersion.split(\".\").map(Number)\n\tif (!major || major < 20) {\n\t\tconsole.error(\"Error: Node.js version 20 or higher is required\")\n\t\tprocess.exit(1)\n\t}\n\n\ttry {\n\t\tawait initializeProject()\n\t} catch (error) {\n\t\tconsole.error(\"Failed to initialize project:\", error)\n\t\tconsole.error(\n\t\t\t\"Error details:\",\n\t\t\terror instanceof Error ? error.stack : String(error)\n\t\t)\n\t\tprocess.exit(1)\n\t}\n}\n\nmain().catch((error) => {\n\tconsole.error(\"CLI error:\", error)\n\tconsole.error(\n\t\t\"Error details:\",\n\t\terror instanceof Error ? error.stack : String(error)\n\t)\n\tprocess.exit(1)\n})\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-hybrid",
+  "version": "1.2.3",
+  "description": "Create a new Hybrid XMTP agent project",
+  "type": "module",
+  "bin": {
+    "create-hybrid": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "22.8.6",
+    "tsup": "^8.5.0",
+    "@config/biome": "0.0.0",
+    "@config/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "hybrid",
+    "xmtp",
+    "agent",
+    "cli",
+    "create"
+  ],
+  "author": "Ian Hunter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ian/hybrid.git",
+    "directory": "packages/create-hybrid"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "clean": "rm -rf .turbo dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint --unsafe",
+    "lint:fix": "biome lint --write --unsafe",
+    "format": "biome format --write"
+  }
+}

package/templates/agent/README.md

@@ -0,0 +1,164 @@
+# {{projectName}}
+
+A Hybrid XMTP agent built with TypeScript and AI capabilities.
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Node.js 20 or higher
+- npm or yarn
+
+### Installation
+
+```bash
+# Install dependencies
+npm install
+```
+
+### Setup
+
+1. **Get your OpenRouter API key**
+   - Visit [OpenRouter](https://openrouter.ai/keys) and create an account
+   - Generate an API key
+   - Add it to your `.env` file
+
+2. **Generate XMTP keys**
+   ```bash
+   npm run keys
+   # or
+   npx hybrid gen:keys
+   ```
+
+3. **Update environment variables**
+   Edit the `.env` file with your API key and generated keys.
+
+### Development
+
+```bash
+# Start development server with auto-reload
+npm run dev
+
+# Build for production
+npm run build
+
+# Start production server
+npm start
+```
+
+## 📁 Project Structure
+
+```
+{{projectName}}/
+├── src/
+│   └── agent.ts          # Main agent implementation
+├── dist/                 # Compiled JavaScript (after build)
+├── .env                  # Environment variables
+├── package.json          # Dependencies and scripts
+├── tsconfig.json         # TypeScript configuration
+├── vitest.config.ts      # Test configuration
+└── README.md            # This file
+```
+
+## 🛠️ Available Scripts
+
+- `npm run dev` - Start development server with hot reload
+- `npm run build` - Build the project for production
+- `npm run start` - Start the production server
+- `npm run test` - Run tests
+- `npm run test:watch` - Run tests in watch mode
+- `npm run test:coverage` - Run tests with coverage report
+- `npm run lint` - Lint and fix code
+- `npm run format` - Format code
+- `npm run typecheck` - Check TypeScript types
+
+## 🤖 Agent Configuration
+
+The agent is configured in `src/agent.ts`. You can customize:
+
+- **AI Model**: Change the model in the `openrouter()` call
+- **Instructions**: Modify the agent's system prompt
+- **Message Filtering**: Adjust which messages the agent responds to
+- **Port**: Change the server port in `.env`
+
+### Example Customizations
+
+```typescript
+const agent = new Agent({
+  name: "My Custom Agent",
+  model: openrouter("anthropic/claude-3-haiku"), // Different model
+  instructions: "You are a helpful assistant that specializes in..."
+})
+```
+
+## 🔧 Environment Variables
+
+Create a `.env` file with:
+
+```env
+# Required
+OPENROUTER_API_KEY=your_openrouter_api_key_here
+XMTP_WALLET_KEY=your_generated_wallet_key
+XMTP_ENCRYPTION_KEY=your_generated_encryption_key
+
+# Optional
+XMTP_ENV=dev
+PORT=8454
+```
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run with coverage
+npm run test:coverage
+```
+
+## 📚 Key Concepts
+
+### Message Filtering
+
+The agent uses a filter function to determine which messages to respond to:
+
+```typescript
+const filter = async ({ message }) => {
+  // Return true to respond, false to ignore
+  const content = message.content?.toString()
+
+  // Example: Only respond to messages mentioning the bot
+  return content?.toLowerCase().includes('@bot')
+}
+```
+
+### Agent Instructions
+
+The system prompt tells the AI how to behave:
+
+```typescript
+const agent = new Agent({
+  instructions: "You are a helpful XMTP agent that..."
+})
+```
+
+## 🔗 Useful Links
+
+- [Hybrid Documentation](https://github.com/your-org/hybrid)
+- [XMTP Documentation](https://docs.xmtp.org/)
+- [OpenRouter Models](https://openrouter.ai/docs#models)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see LICENSE file for details

package/templates/agent/package.json

@@ -0,0 +1,37 @@
+{
+	"name": "{{projectName}}",
+	"version": "0.0.0",
+	"private": true,
+	"description": "A Hybrid XMTP agent",
+	"type": "module",
+	"scripts": {
+		"clean": "hybrid clean",
+		"dev": "hybrid dev",
+		"build": "hybrid build",
+		"start": "hybrid start",
+		"keys": "hybrid gen:keys --write",
+		"test": "vitest",
+		"test:watch": "vitest --watch",
+		"lint": "biome lint --write",
+		"lint:check": "biome lint",
+		"format": "biome format --write",
+		"format:check": "biome format --check",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@openrouter/ai-sdk-provider": "^1.1.2",
+		"hybrid": "^1.2.2"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@types/node": "^22.0.0",
+		"@hybrd/cli": "^1.2.2",
+		"typescript": "^5.8.3",
+		"vitest": "^3.2.4"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"author": "",
+	"license": "MIT"
+}

package/templates/agent/src/agent.test.ts

@@ -0,0 +1,11 @@
+import { describe, expect, it } from "vitest"
+import { agent } from "./agent.js"
+
+describe("Agent", () => {
+	it("should generate a response", async () => {
+		const response = await agent.generate("Hello, how are you?")
+		expect(response).toBeDefined()
+		expect(typeof response).toBe("string")
+		expect(response.length).toBeGreaterThan(0)
+	})
+})

package/templates/agent/src/agent.ts

@@ -0,0 +1,52 @@
+import { createOpenRouter } from "@openrouter/ai-sdk-provider"
+import { Agent, type MessageListenerConfig, type Reaction } from "hybrid"
+
+export const openrouter = createOpenRouter({
+	apiKey: process.env.OPENROUTER_API_KEY
+})
+
+const agent = new Agent({
+	name: "{{projectName}}",
+	model: openrouter("x-ai/grok-4"),
+	instructions:
+		"You are a XMTP agent that responds to messages and reactions. Try and be as conversational as possible."
+})
+
+const filter: MessageListenerConfig["filter"] = async ({ message }) => {
+	const messageContent = message.content?.toString()
+	const contentTypeId = message.contentType?.typeId
+	const isMessage = contentTypeId === "text"
+	const isReaction = contentTypeId === "reaction"
+	const isReply = contentTypeId === "reply"
+
+	if (isReply) {
+		return true
+	}
+
+	if (isReaction) {
+		const { content, action } = message.content as Reaction
+
+		if (action === "added") {
+			if (content.toLowerCase().includes("👍")) {
+				return true
+			}
+		}
+	}
+
+	if (isMessage) {
+		const lowerContent = messageContent?.toLowerCase()
+		const mentionPatterns = ["@bot"]
+
+		return mentionPatterns.some((pattern) => lowerContent?.includes(pattern))
+	}
+
+	return false
+}
+
+agent.listen({
+	port: process.env.PORT || "8454",
+	filter
+})
+
+export { agent }
+export default agent

package/templates/agent/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "noEmit": false,
+    "declaration": true,
+    "skipLibCheck": true,
+    "isolatedModules": false,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}

package/templates/agent/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+	test: {
+		globals: true,
+		environment: "node"
+	}
+})