commune-ai 0.2.5 → 0.2.6

package/README.md

@@ -234,6 +234,48 @@ interface SearchResult {
 }
 ```
 
+## Spam Protection
+Commune includes built-in spam detection and protection to keep your agent safe from malicious emails and prevent abuse.
+
+### Automatic Spam Detection
+All incoming emails are automatically analyzed for spam patterns:
+- Content analysis (spam keywords, suspicious patterns)
+- URL validation (broken links, phishing detection)
+- Sender reputation tracking
+- Domain blacklist checking
+
+Spam emails are automatically rejected before reaching your webhook, protecting your agent from:
+- Phishing attempts
+- Malicious links
+- Mass spam campaigns
+- Fraudulent content
+
+### Outbound Protection
+Commune also protects your sending reputation:
+- Rate limiting per organization tier
+- Content validation for outbound emails
+- Burst detection for mass mailing
+- Automatic blocking of spam-like content
+
+This ensures your domain maintains high deliverability and isn't flagged by email providers.
+
+### Spam Reporting
+If a spam email gets through, you can report it:
+
+```ts
+import { CommuneClient } from "@commune/sdk";
+const client = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY! });
+
+// Report a message as spam
+await client.reportSpam({
+  message_id: "msg_123",
+  reason: "Unsolicited marketing email",
+  classification: "spam" // or "phishing", "malware", "other"
+});
+```
+
+The system learns from reports and automatically blocks repeat offenders.
+
 ## Context (conversation state)
 Commune stores conversation state so your agent can respond with context.
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AttachmentRecord, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload } from './types.js';
+import type { AttachmentRecord, AttachmentUrl, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload } from './types.js';
 export type ClientOptions = {
     baseUrl?: string;
     apiKey: string;
@@ -72,6 +72,9 @@ export declare class CommuneClient {
         }>;
     };
     attachments: {
-        get: (attachmentId: string) => Promise<AttachmentRecord>;
+        get: (attachmentId: string, options?: {
+            url?: boolean;
+            expiresIn?: number;
+        }) => Promise<AttachmentRecord | AttachmentUrl>;
     };
 }

package/dist/client.js

@@ -128,7 +128,11 @@ export class CommuneClient {
             },
         };
         this.attachments = {
-            get: async (attachmentId) => {
+            get: async (attachmentId, options) => {
+                if (options?.url) {
+                    const expiresIn = options.expiresIn || 3600;
+                    return this.request(`/api/attachments/${encodeURIComponent(attachmentId)}/url?expiresIn=${expiresIn}`);
+                }
                 return this.request(`/api/attachments/${encodeURIComponent(attachmentId)}`);
             },
         };

package/dist/types.d.ts

@@ -42,6 +42,22 @@ export interface AttachmentRecord {
     source: Channel;
     source_url?: string | null;
     download_error?: boolean;
+    storage_type?: 'cloudinary' | 'database';
+    cloudinary_url?: string | null;
+    cloudinary_public_id?: string | null;
+}
+export interface AttachmentMetadata {
+    attachment_id: string;
+    filename: string;
+    mime_type: string;
+    size: number;
+}
+export interface AttachmentUrl {
+    url: string;
+    expiresIn: number;
+    filename: string;
+    mimeType: string;
+    size: number;
 }
 export interface DomainWebhook {
     id?: string;
@@ -142,6 +158,7 @@ export interface InboundEmailWebhookPayload {
     email: unknown;
     message: UnifiedMessage;
     extractedData?: Record<string, any>;
+    attachments?: AttachmentMetadata[];
 }
 export interface ApiError {
     message?: string;
@@ -175,6 +192,9 @@ export interface SearchResult {
         participants: string[];
         threadId: string;
         timestamp: Date;
+        attachmentIds?: string[];
+        hasAttachments?: boolean;
+        attachmentCount?: number;
     };
 }
 export interface ConversationMetadata {
@@ -185,6 +205,9 @@ export interface ConversationMetadata {
     participants: string[];
     threadId: string;
     timestamp: Date;
+    attachmentIds?: string[];
+    hasAttachments?: boolean;
+    attachmentCount?: number;
 }
 export interface IndexConversationPayload {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commune-ai",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Our email infrastructure - webhooks, threads, history, and semantic search",
   "type": "module",
   "main": "dist/index.js",