commune-ai 0.2.0 → 0.2.1

package/README.md

@@ -1,6 +1,6 @@
 # commune-ai
 
-**Email infrastructure for AI agents**
+**Our email infrastructure**
 
 Build agents that receive emails, reply in threads, access conversation history, and search across all organizational emails. Most teams get their first agent responding in **~15 minutes**.
 
@@ -29,7 +29,6 @@ Build agents that receive emails, reply in threads, access conversation history,
 - [Reply in email threads](#reply-in-email-threads)
 - [Access conversation history](#access-conversation-history)
 - [Manage Inboxes Programmatically](#manage-inboxes-programmatically)
-- [How Webhooks Work](#how-webhooks-work)
 - [Handle different types of emails](#handle-different-types-of-emails)
 - [Semantic Search (Coming Soon)](#semantic-search-coming-soon)
 - [Complete example](#complete-example)
@@ -302,52 +301,52 @@ await client.inboxes.remove(domainId, inboxId);
 
 ---
 
-## How Webhooks Work
+## Handle different inbox emails
 
-**Understanding the webhook flow:**
+Set up separate webhook endpoints for different inboxes:
 
-1. **Resend Webhooks** → When you verify a domain, the backend creates a webhook at Resend (email service) that points to the Commune backend
-2. **Commune Backend** → Processes the webhook from Resend and looks up inbox configurations
-3. **Your Webhook Endpoint** → If an inbox has a webhook URL set, Commune sends an HTTP POST to your endpoint
+```ts
+const client = new CommuneClient({
+  apiKey: process.env.COMMUNE_API_KEY,
+});
 
-```typescript
-// Webhook flow: Resend → Commune Backend → Your Server
-// Your server uses createWebhookHandler to process webhooks from Commune
-```
+const app = express();
 
-## Handle different types of emails
+// Sales inbox webhook - handles sales@yourdomain.com
+app.post("/webhook/sales", express.raw({ type: "*/*" }), createWebhookHandler({
+  onEvent: async (message, context) => {
+    const sender = message.participants.find(p => p.role === "sender")?.identity;
+    if (!sender) return;
 
-Check which inbox received the email and handle accordingly:
+    await client.messages.send({
+      to: sender,
+      text: "Thanks for your sales inquiry!",
+      conversation_id: message.conversation_id,
+      domainId: context.payload.domainId,
+      inboxId: context.payload.inboxId,
+    });
+  },
+}));
 
-```ts
-app.post("/webhook", express.raw({ type: "*/*" }), createWebhookHandler({
+// Marketing inbox webhook - handles marketing@yourdomain.com
+app.post("/webhook/marketing", express.raw({ type: "*/*" }), createWebhookHandler({
   onEvent: async (message, context) => {
-    const inboxAddress = context.payload.inboxAddress;
-
-    // Handle based on which inbox received the email
-    if (inboxAddress?.includes("support")) {
-      // Handle support emails
-      const sender = message.participants.find(p => p.role === "sender")?.identity;
-      await client.messages.send({
-        to: sender,
-        text: "Thanks for contacting support!",
-        conversation_id: message.conversation_id,
-        domainId: context.payload.domainId,
-        inboxId: context.payload.inboxId,
-      });
-    } else if (inboxAddress?.includes("sales")) {
-      // Handle sales emails
-      const sender = message.participants.find(p => p.role === "sender")?.identity;
-      await client.messages.send({
-        to: sender,
-        text: "Thanks for your sales inquiry!",
-        conversation_id: message.conversation_id,
-        domainId: context.payload.domainId,
-        inboxId: context.payload.inboxId,
-      });
-    }
+    const sender = message.participants.find(p => p.role === "sender")?.identity;
+    if (!sender) return;
+
+    await client.messages.send({
+      to: sender,
+      text: "Thanks for subscribing to our newsletter!",
+      conversation_id: message.conversation_id,
+      domainId: context.payload.domainId,
+      inboxId: context.payload.inboxId,
+    });
   },
 }));
+
+app.listen(3000, () => {
+  console.log("Agent running on port 3000");
+});
 ```
 
 ---
@@ -368,7 +367,7 @@ const results = await client.search({
   query: "What were the pricing questions from last week?",
   limit: 10,
   threshold: 0.7, // Similarity threshold 0-1
-  before: "2024-12-31", // Only search recent emails
+  before: "2024-12-31", // Only search emails before this date
   sender: "customer@example.com", // Filter by sender (optional)
 });
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commune-ai",
-  "version": "0.2.0",
-  "description": "Email infrastructure for AI agents - webhooks, threads, history, and semantic search",
+  "version": "0.2.1",
+  "description": "Our email infrastructure - webhooks, threads, history, and semantic search",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",