commune-ai 0.2.65 → 0.2.66

package/README.md

@@ -1,27 +1,10 @@
 # commune-ai
 
-Commune is the **communication infrastructure for agents**. It gives your agent a **unified inbox**
-for **email**, so your agent can talk to humans where they already work. Most teams
-get a working integration in **~15 minutes**.
-
-## Why Commune exists (what it enables)
-Agents are powerful, but users already live in **email**. Commune bridges that gap so:
-- your agent is reachable where humans already work
-- you don’t have to build deliverability, threading, or email plumbing
-- you can ship an agent‑first experience in minutes, not weeks
-
-In practice, Commune lets you:
-- give an agent a real inbox on your domain
-- respond in the correct email thread every time
-- use **conversation state** to make smarter, context‑aware replies
-
-## How it works (mental model)
-1) Commune receives inbound email events.
-2) Commune normalizes them into a **UnifiedMessage**.
-3) Commune sends the UnifiedMessage to your webhook.
-4) Your agent replies using one API call.
-
-> By default, the SDK talks to the hosted Commune API. If you self‑host,\n> pass `baseUrl` to the client.
+Email infrastructure for agents — set up an inbox and send your first email in 30 seconds. Programmatic inboxes (~1 line), consistent threads, setup and verify custom domains, send and receive attachments, structured data extraction.
+
+```bash
+npm install commune-ai
+```
 
 ---
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AttachmentRecord, AttachmentUrl, AttachmentUploadResponse, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload } from './types.js';
+import type { AttachmentRecord, AttachmentUrl, AttachmentUploadResponse, CreateDomainPayload, DomainEntry, InboxEntry, MessageListParams, SendMessagePayload, UnifiedMessage, SearchFilter, SearchOptions, SearchResult, IndexConversationPayload, ThreadListParams, ThreadListResponse } from './types.js';
 export type ClientOptions = {
     baseUrl?: string;
     apiKey: string;
@@ -71,6 +71,13 @@ export declare class CommuneClient {
             success: boolean;
         }>;
     };
+    threads: {
+        list: (params: ThreadListParams) => Promise<ThreadListResponse>;
+        messages: (threadId: string, params?: {
+            limit?: number;
+            order?: "asc" | "desc";
+        }) => Promise<UnifiedMessage[]>;
+    };
     attachments: {
         upload: (content: string, filename: string, mimeType: string) => Promise<AttachmentUploadResponse>;
         get: (attachmentId: string, options?: {

package/dist/client.js

@@ -127,6 +127,34 @@ export class CommuneClient {
                 });
             },
         };
+        this.threads = {
+            list: async (params) => {
+                const response = await this.fetcher(`${this.baseUrl}/v1/threads${buildQuery({
+                    inbox_id: params.inbox_id,
+                    domain_id: params.domain_id,
+                    limit: params.limit,
+                    cursor: params.cursor,
+                    order: params.order,
+                })}`, {
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
+                        ...(this.headers || {}),
+                    },
+                });
+                const data = await response.json();
+                if (!response.ok) {
+                    throw new Error(data?.error || response.statusText);
+                }
+                return data;
+            },
+            messages: async (threadId, params) => {
+                return this.request(`/v1/threads/${encodeURIComponent(threadId)}/messages${buildQuery({
+                    limit: params?.limit,
+                    order: params?.order,
+                })}`);
+            },
+        };
         this.attachments = {
             upload: async (content, filename, mimeType) => {
                 return this.request('/api/attachments/upload', {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CommuneClient } from './client.js';
-export type { ApiError, ApiResponse, AttachmentRecord, Channel, ConversationListParams, CreateDomainPayload, Direction, DomainEntry, DomainWebhook, InboxEntry, InboxWebhook, InboundEmailWebhookPayload, MessageListParams, MessageMetadata, Participant, ParticipantRole, SendMessagePayload, SvixHeaders, UnifiedMessage, } from './types.js';
+export type { ApiError, ApiResponse, AttachmentRecord, Channel, ConversationListParams, CreateDomainPayload, Direction, DomainEntry, DomainWebhook, InboxEntry, InboxWebhook, InboundEmailWebhookPayload, MessageListParams, MessageMetadata, Participant, ParticipantRole, SendMessagePayload, SvixHeaders, Thread, ThreadListParams, ThreadListResponse, UnifiedMessage, } from './types.js';
 export { verifyResendWebhook } from './webhooks.js';
 export { createWebhookHandler } from './listener.js';
 export type { CommuneWebhookEvent, CommuneWebhookHandlerContext, CreateWebhookHandlerOptions, } from './listener.js';

package/dist/types.d.ts

@@ -222,3 +222,27 @@ export interface IndexConversationPayload {
     metadata: ConversationMetadata;
 }
 export type SearchType = 'vector' | 'agent';
+export interface Thread {
+    thread_id: string;
+    subject?: string | null;
+    last_message_at: string;
+    first_message_at?: string | null;
+    message_count: number;
+    snippet?: string | null;
+    last_direction?: Direction | null;
+    inbox_id?: string | null;
+    domain_id?: string | null;
+    has_attachments?: boolean;
+}
+export interface ThreadListResponse {
+    data: Thread[];
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export interface ThreadListParams {
+    inbox_id?: string;
+    domain_id?: string;
+    limit?: number;
+    cursor?: string;
+    order?: 'asc' | 'desc';
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commune-ai",
-  "version": "0.2.65",
-  "description": "SDK-first email infrastructure for agents - threads, history, semantic search, structured data output and attachments.",
+  "version": "0.2.66",
+  "description": "Email infrastructure for agents — set up an inbox and send your first email in 30 seconds. Programmatic inboxes (~1 line), consistent threads, custom domains, attachments, and structured data.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",