@autenai/sdk 0.2.0 → 0.4.0

package/dist/index.d.mts

@@ -273,6 +273,158 @@ declare class AIClient {
     chain(task: string, context?: Record<string, any>): Promise<AIChainResult>;
 }
 
+/**
+ * Auten SDK — Webhooks & Events Client
+ * Register webhooks, poll events, listen to provider activity.
+ */
+
+interface Webhook {
+    id: string;
+    event: string;
+    provider: string | null;
+    callbackUrl: string;
+    filter: Record<string, any> | null;
+    createdAt: string;
+}
+interface RegisterWebhookOptions {
+    /** Event to listen for (e.g., "slack:message", "gmail:new_email", "*") */
+    event: string;
+    /** Your callback URL that will receive POST requests */
+    callbackUrl: string;
+    /** Filter to specific provider (optional) */
+    provider?: string;
+    /** Filter by event data fields (optional) */
+    filter?: Record<string, any>;
+}
+interface SdkEvent {
+    id: string;
+    event: string;
+    data: any;
+    provider: string | null;
+    timestamp: string;
+}
+interface PollResult {
+    events: SdkEvent[];
+    count: number;
+    since: string;
+}
+declare class WebhookClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all registered webhooks.
+     */
+    list(): Promise<Webhook[]>;
+    /**
+     * Register a webhook to receive provider events.
+     *
+     * @example
+     * await auten.webhooks.register({
+     *   event: 'slack:message:thread',
+     *   callbackUrl: 'https://myapp.com/api/auten-webhook',
+     *   provider: 'slack',
+     * });
+     */
+    register(options: RegisterWebhookOptions): Promise<Webhook>;
+    /**
+     * Delete a webhook.
+     */
+    delete(id: string): Promise<void>;
+}
+declare class EventClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Poll for new events since a timestamp.
+     * Alternative to webhooks for serverless environments.
+     *
+     * @example
+     * const { events } = await auten.events.poll({
+     *   since: new Date(Date.now() - 60000).toISOString(), // last minute
+     *   provider: 'slack',
+     * });
+     */
+    poll(options?: {
+        since?: string;
+        provider?: string;
+        limit?: number;
+    }): Promise<PollResult>;
+}
+
+/**
+ * Auten SDK — Conversations Client
+ *
+ * Create Slack ↔ Email conversation bridges with one API call.
+ * Auten handles everything: AI email generation, thread tracking,
+ * email replies back to Slack thread.
+ */
+
+interface CreateConversationOptions {
+    /** Customer's name */
+    customerName: string;
+    /** Customer's email */
+    customerEmail: string;
+    /** Customer's phone (optional) */
+    customerPhone?: string;
+    /** Subject or topic */
+    subject?: string;
+    /** Initial message from the customer */
+    message: string;
+    /** Slack channel to post to (default: #general) */
+    channel?: string;
+    /** Your brand/company name (used in AI-generated emails) */
+    brandName?: string;
+    /** Email signature (used in AI-generated emails) */
+    brandSignOff?: string;
+}
+interface Conversation {
+    conversationId: string;
+    customerName: string;
+    customerEmail: string;
+    subject: string | null;
+    status: 'new' | 'open' | 'replied' | 'closed';
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ConversationCreated {
+    conversationId: string;
+    slackChannel: string;
+    slackThreadTs: string;
+    customerEmail: string;
+    status: string;
+    message: string;
+}
+declare class ConversationClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Create a new conversation bridge.
+     *
+     * This posts to Slack and sets up the full bridge:
+     * - You reply in Slack thread → AI generates professional email → sends to customer
+     * - Customer replies to email → appears in Slack thread
+     * - Repeat — full conversation via Slack
+     *
+     * @example
+     * // From a contact form handler:
+     * const conv = await auten.conversations.create({
+     *   customerName: 'Jonas Jonaitis',
+     *   customerEmail: 'jonas@test.lt',
+     *   message: 'Norėčiau sužinoti apie jūsų paslaugas',
+     *   channel: '#sales',
+     *   brandName: 'My Company',
+     *   brandSignOff: 'Pagarbiai,\nMy Company komanda\n+370 600 00000',
+     * });
+     * // That's it. Reply in Slack — AI handles the rest.
+     */
+    create(options: CreateConversationOptions): Promise<ConversationCreated>;
+    /**
+     * List all conversations.
+     */
+    list(): Promise<Conversation[]>;
+}
+
 /**
  * Auten SDK — Error Classes
  */
@@ -297,9 +449,10 @@ declare class AutenNotFoundError extends AutenApiError {
 }
 
 /**
- * Auten.ai SDK
+ * Auten.ai SDK v0.3.0
  *
- * AI-native integrations with managed OAuth.
+ * AI-native integrations with managed OAuth, event-driven webhooks,
+ * and per-user learning.
  *
  * @example
  * ```typescript
@@ -310,20 +463,20 @@ declare class AutenNotFoundError extends AutenApiError {
  * // List connected providers
  * const providers = await auten.providers.list();
  *
- * // Execute provider action
- * const emails = await auten.providers.execute('google-gmail', 'listEmails', {
- *   query: 'is:unread',
- * });
- *
  * // AI-powered execution
- * const result = await auten.ai.execute(
- *   'google-sheets',
- *   'Find Q1 revenue totals'
- * );
+ * const result = await auten.ai.execute('gmail', 'Find unread emails');
+ *
+ * // Cross-provider chain
+ * await auten.ai.chain('Get Gmail emails and post summary to Slack #general');
+ *
+ * // Register webhook for real-time events
+ * await auten.webhooks.register({
+ *   event: 'slack:message',
+ *   callbackUrl: 'https://myapp.com/api/webhook',
+ * });
  *
- * // Manage agents
- * const agents = await auten.agents.list();
- * await auten.agents.run('agent-id');
+ * // Or poll for events
+ * const { events } = await auten.events.poll({ since: lastCheck });
  * ```
  */
 
@@ -334,8 +487,14 @@ declare class Auten {
     readonly agents: AgentClient;
     /** AI-powered execution */
     readonly ai: AIClient;
+    /** Webhook registration */
+    readonly webhooks: WebhookClient;
+    /** Event polling */
+    readonly events: EventClient;
+    /** Conversation bridges (Slack ↔ Email) */
+    readonly conversations: ConversationClient;
     private readonly client;
     constructor(config: AutenConfig);
 }
 
-export { type AIChainResult, type AIChainStep, type AIExecuteResult, type Agent, type AgentDetail, type AgentRunResult, type AgentSchedule, type AgentTool, Auten, AutenApiError, AutenAuthError, type AutenConfig, AutenError, AutenNotFoundError, AutenRateLimitError, type CreateAgentOptions, type CreateAgentResult, type DeployAgentOptions, type DeployResult, type ExecuteResult, type Provider, type ProviderCredentials };
+export { type AIChainResult, type AIChainStep, type AIExecuteResult, type Agent, type AgentDetail, type AgentRunResult, type AgentSchedule, type AgentTool, Auten, AutenApiError, AutenAuthError, type AutenConfig, AutenError, AutenNotFoundError, AutenRateLimitError, type Conversation, type ConversationCreated, type CreateAgentOptions, type CreateAgentResult, type CreateConversationOptions, type DeployAgentOptions, type DeployResult, type ExecuteResult, type PollResult, type Provider, type ProviderCredentials, type RegisterWebhookOptions, type SdkEvent, type Webhook };

package/dist/index.d.ts

@@ -273,6 +273,158 @@ declare class AIClient {
     chain(task: string, context?: Record<string, any>): Promise<AIChainResult>;
 }
 
+/**
+ * Auten SDK — Webhooks & Events Client
+ * Register webhooks, poll events, listen to provider activity.
+ */
+
+interface Webhook {
+    id: string;
+    event: string;
+    provider: string | null;
+    callbackUrl: string;
+    filter: Record<string, any> | null;
+    createdAt: string;
+}
+interface RegisterWebhookOptions {
+    /** Event to listen for (e.g., "slack:message", "gmail:new_email", "*") */
+    event: string;
+    /** Your callback URL that will receive POST requests */
+    callbackUrl: string;
+    /** Filter to specific provider (optional) */
+    provider?: string;
+    /** Filter by event data fields (optional) */
+    filter?: Record<string, any>;
+}
+interface SdkEvent {
+    id: string;
+    event: string;
+    data: any;
+    provider: string | null;
+    timestamp: string;
+}
+interface PollResult {
+    events: SdkEvent[];
+    count: number;
+    since: string;
+}
+declare class WebhookClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all registered webhooks.
+     */
+    list(): Promise<Webhook[]>;
+    /**
+     * Register a webhook to receive provider events.
+     *
+     * @example
+     * await auten.webhooks.register({
+     *   event: 'slack:message:thread',
+     *   callbackUrl: 'https://myapp.com/api/auten-webhook',
+     *   provider: 'slack',
+     * });
+     */
+    register(options: RegisterWebhookOptions): Promise<Webhook>;
+    /**
+     * Delete a webhook.
+     */
+    delete(id: string): Promise<void>;
+}
+declare class EventClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Poll for new events since a timestamp.
+     * Alternative to webhooks for serverless environments.
+     *
+     * @example
+     * const { events } = await auten.events.poll({
+     *   since: new Date(Date.now() - 60000).toISOString(), // last minute
+     *   provider: 'slack',
+     * });
+     */
+    poll(options?: {
+        since?: string;
+        provider?: string;
+        limit?: number;
+    }): Promise<PollResult>;
+}
+
+/**
+ * Auten SDK — Conversations Client
+ *
+ * Create Slack ↔ Email conversation bridges with one API call.
+ * Auten handles everything: AI email generation, thread tracking,
+ * email replies back to Slack thread.
+ */
+
+interface CreateConversationOptions {
+    /** Customer's name */
+    customerName: string;
+    /** Customer's email */
+    customerEmail: string;
+    /** Customer's phone (optional) */
+    customerPhone?: string;
+    /** Subject or topic */
+    subject?: string;
+    /** Initial message from the customer */
+    message: string;
+    /** Slack channel to post to (default: #general) */
+    channel?: string;
+    /** Your brand/company name (used in AI-generated emails) */
+    brandName?: string;
+    /** Email signature (used in AI-generated emails) */
+    brandSignOff?: string;
+}
+interface Conversation {
+    conversationId: string;
+    customerName: string;
+    customerEmail: string;
+    subject: string | null;
+    status: 'new' | 'open' | 'replied' | 'closed';
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ConversationCreated {
+    conversationId: string;
+    slackChannel: string;
+    slackThreadTs: string;
+    customerEmail: string;
+    status: string;
+    message: string;
+}
+declare class ConversationClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Create a new conversation bridge.
+     *
+     * This posts to Slack and sets up the full bridge:
+     * - You reply in Slack thread → AI generates professional email → sends to customer
+     * - Customer replies to email → appears in Slack thread
+     * - Repeat — full conversation via Slack
+     *
+     * @example
+     * // From a contact form handler:
+     * const conv = await auten.conversations.create({
+     *   customerName: 'Jonas Jonaitis',
+     *   customerEmail: 'jonas@test.lt',
+     *   message: 'Norėčiau sužinoti apie jūsų paslaugas',
+     *   channel: '#sales',
+     *   brandName: 'My Company',
+     *   brandSignOff: 'Pagarbiai,\nMy Company komanda\n+370 600 00000',
+     * });
+     * // That's it. Reply in Slack — AI handles the rest.
+     */
+    create(options: CreateConversationOptions): Promise<ConversationCreated>;
+    /**
+     * List all conversations.
+     */
+    list(): Promise<Conversation[]>;
+}
+
 /**
  * Auten SDK — Error Classes
  */
@@ -297,9 +449,10 @@ declare class AutenNotFoundError extends AutenApiError {
 }
 
 /**
- * Auten.ai SDK
+ * Auten.ai SDK v0.3.0
  *
- * AI-native integrations with managed OAuth.
+ * AI-native integrations with managed OAuth, event-driven webhooks,
+ * and per-user learning.
  *
  * @example
  * ```typescript
@@ -310,20 +463,20 @@ declare class AutenNotFoundError extends AutenApiError {
  * // List connected providers
  * const providers = await auten.providers.list();
  *
- * // Execute provider action
- * const emails = await auten.providers.execute('google-gmail', 'listEmails', {
- *   query: 'is:unread',
- * });
- *
  * // AI-powered execution
- * const result = await auten.ai.execute(
- *   'google-sheets',
- *   'Find Q1 revenue totals'
- * );
+ * const result = await auten.ai.execute('gmail', 'Find unread emails');
+ *
+ * // Cross-provider chain
+ * await auten.ai.chain('Get Gmail emails and post summary to Slack #general');
+ *
+ * // Register webhook for real-time events
+ * await auten.webhooks.register({
+ *   event: 'slack:message',
+ *   callbackUrl: 'https://myapp.com/api/webhook',
+ * });
  *
- * // Manage agents
- * const agents = await auten.agents.list();
- * await auten.agents.run('agent-id');
+ * // Or poll for events
+ * const { events } = await auten.events.poll({ since: lastCheck });
  * ```
  */
 
@@ -334,8 +487,14 @@ declare class Auten {
     readonly agents: AgentClient;
     /** AI-powered execution */
     readonly ai: AIClient;
+    /** Webhook registration */
+    readonly webhooks: WebhookClient;
+    /** Event polling */
+    readonly events: EventClient;
+    /** Conversation bridges (Slack ↔ Email) */
+    readonly conversations: ConversationClient;
     private readonly client;
     constructor(config: AutenConfig);
 }
 
-export { type AIChainResult, type AIChainStep, type AIExecuteResult, type Agent, type AgentDetail, type AgentRunResult, type AgentSchedule, type AgentTool, Auten, AutenApiError, AutenAuthError, type AutenConfig, AutenError, AutenNotFoundError, AutenRateLimitError, type CreateAgentOptions, type CreateAgentResult, type DeployAgentOptions, type DeployResult, type ExecuteResult, type Provider, type ProviderCredentials };
+export { type AIChainResult, type AIChainStep, type AIExecuteResult, type Agent, type AgentDetail, type AgentRunResult, type AgentSchedule, type AgentTool, Auten, AutenApiError, AutenAuthError, type AutenConfig, AutenError, AutenNotFoundError, AutenRateLimitError, type Conversation, type ConversationCreated, type CreateAgentOptions, type CreateAgentResult, type CreateConversationOptions, type DeployAgentOptions, type DeployResult, type ExecuteResult, type PollResult, type Provider, type ProviderCredentials, type RegisterWebhookOptions, type SdkEvent, type Webhook };

package/dist/index.js

@@ -312,6 +312,97 @@ var AIClient = class {
   }
 };
 
+// src/webhooks.ts
+var WebhookClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all registered webhooks.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/webhooks");
+  }
+  /**
+   * Register a webhook to receive provider events.
+   *
+   * @example
+   * await auten.webhooks.register({
+   *   event: 'slack:message:thread',
+   *   callbackUrl: 'https://myapp.com/api/auten-webhook',
+   *   provider: 'slack',
+   * });
+   */
+  async register(options) {
+    return this.client.post("/api/v1/sdk/webhooks", options);
+  }
+  /**
+   * Delete a webhook.
+   */
+  async delete(id) {
+    await this.client.del(`/api/v1/sdk/webhooks?id=${id}`);
+  }
+};
+var EventClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Poll for new events since a timestamp.
+   * Alternative to webhooks for serverless environments.
+   *
+   * @example
+   * const { events } = await auten.events.poll({
+   *   since: new Date(Date.now() - 60000).toISOString(), // last minute
+   *   provider: 'slack',
+   * });
+   */
+  async poll(options) {
+    const params = new URLSearchParams();
+    if (options?.since) params.set("since", options.since);
+    if (options?.provider) params.set("provider", options.provider);
+    if (options?.limit) params.set("limit", String(options.limit));
+    const query = params.toString();
+    return this.client.get(`/api/v1/sdk/events${query ? "?" + query : ""}`);
+  }
+};
+
+// src/conversations.ts
+var ConversationClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new conversation bridge.
+   *
+   * This posts to Slack and sets up the full bridge:
+   * - You reply in Slack thread → AI generates professional email → sends to customer
+   * - Customer replies to email → appears in Slack thread
+   * - Repeat — full conversation via Slack
+   *
+   * @example
+   * // From a contact form handler:
+   * const conv = await auten.conversations.create({
+   *   customerName: 'Jonas Jonaitis',
+   *   customerEmail: 'jonas@test.lt',
+   *   message: 'Norėčiau sužinoti apie jūsų paslaugas',
+   *   channel: '#sales',
+   *   brandName: 'My Company',
+   *   brandSignOff: 'Pagarbiai,\nMy Company komanda\n+370 600 00000',
+   * });
+   * // That's it. Reply in Slack — AI handles the rest.
+   */
+  async create(options) {
+    return this.client.post("/api/v1/sdk/conversations", options);
+  }
+  /**
+   * List all conversations.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/conversations");
+  }
+};
+
 // src/index.ts
 var DEFAULT_BASE_URL = "https://auten.ai";
 var DEFAULT_TIMEOUT = 3e4;
@@ -323,6 +414,12 @@ var Auten = class {
   agents;
   /** AI-powered execution */
   ai;
+  /** Webhook registration */
+  webhooks;
+  /** Event polling */
+  events;
+  /** Conversation bridges (Slack ↔ Email) */
+  conversations;
   client;
   constructor(config) {
     if (!config.apiKey) {
@@ -337,6 +434,9 @@ var Auten = class {
     this.providers = new ProviderClient(this.client);
     this.agents = new AgentClient(this.client);
     this.ai = new AIClient(this.client);
+    this.webhooks = new WebhookClient(this.client);
+    this.events = new EventClient(this.client);
+    this.conversations = new ConversationClient(this.client);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -281,6 +281,97 @@ var AIClient = class {
   }
 };
 
+// src/webhooks.ts
+var WebhookClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all registered webhooks.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/webhooks");
+  }
+  /**
+   * Register a webhook to receive provider events.
+   *
+   * @example
+   * await auten.webhooks.register({
+   *   event: 'slack:message:thread',
+   *   callbackUrl: 'https://myapp.com/api/auten-webhook',
+   *   provider: 'slack',
+   * });
+   */
+  async register(options) {
+    return this.client.post("/api/v1/sdk/webhooks", options);
+  }
+  /**
+   * Delete a webhook.
+   */
+  async delete(id) {
+    await this.client.del(`/api/v1/sdk/webhooks?id=${id}`);
+  }
+};
+var EventClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Poll for new events since a timestamp.
+   * Alternative to webhooks for serverless environments.
+   *
+   * @example
+   * const { events } = await auten.events.poll({
+   *   since: new Date(Date.now() - 60000).toISOString(), // last minute
+   *   provider: 'slack',
+   * });
+   */
+  async poll(options) {
+    const params = new URLSearchParams();
+    if (options?.since) params.set("since", options.since);
+    if (options?.provider) params.set("provider", options.provider);
+    if (options?.limit) params.set("limit", String(options.limit));
+    const query = params.toString();
+    return this.client.get(`/api/v1/sdk/events${query ? "?" + query : ""}`);
+  }
+};
+
+// src/conversations.ts
+var ConversationClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new conversation bridge.
+   *
+   * This posts to Slack and sets up the full bridge:
+   * - You reply in Slack thread → AI generates professional email → sends to customer
+   * - Customer replies to email → appears in Slack thread
+   * - Repeat — full conversation via Slack
+   *
+   * @example
+   * // From a contact form handler:
+   * const conv = await auten.conversations.create({
+   *   customerName: 'Jonas Jonaitis',
+   *   customerEmail: 'jonas@test.lt',
+   *   message: 'Norėčiau sužinoti apie jūsų paslaugas',
+   *   channel: '#sales',
+   *   brandName: 'My Company',
+   *   brandSignOff: 'Pagarbiai,\nMy Company komanda\n+370 600 00000',
+   * });
+   * // That's it. Reply in Slack — AI handles the rest.
+   */
+  async create(options) {
+    return this.client.post("/api/v1/sdk/conversations", options);
+  }
+  /**
+   * List all conversations.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/conversations");
+  }
+};
+
 // src/index.ts
 var DEFAULT_BASE_URL = "https://auten.ai";
 var DEFAULT_TIMEOUT = 3e4;
@@ -292,6 +383,12 @@ var Auten = class {
   agents;
   /** AI-powered execution */
   ai;
+  /** Webhook registration */
+  webhooks;
+  /** Event polling */
+  events;
+  /** Conversation bridges (Slack ↔ Email) */
+  conversations;
   client;
   constructor(config) {
     if (!config.apiKey) {
@@ -306,6 +403,9 @@ var Auten = class {
     this.providers = new ProviderClient(this.client);
     this.agents = new AgentClient(this.client);
     this.ai = new AIClient(this.client);
+    this.webhooks = new WebhookClient(this.client);
+    this.events = new EventClient(this.client);
+    this.conversations = new ConversationClient(this.client);
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autenai/sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Auten.ai SDK — AI-native integrations with managed OAuth",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",