@autenai/sdk 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -273,6 +273,84 @@ 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 — Error Classes
  */
@@ -297,9 +375,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 +389,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 +413,12 @@ declare class Auten {
     readonly agents: AgentClient;
     /** AI-powered execution */
     readonly ai: AIClient;
+    /** Webhook registration */
+    readonly webhooks: WebhookClient;
+    /** Event polling */
+    readonly events: EventClient;
     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 CreateAgentOptions, type CreateAgentResult, 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,84 @@ 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 — Error Classes
  */
@@ -297,9 +375,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 +389,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 +413,12 @@ declare class Auten {
     readonly agents: AgentClient;
     /** AI-powered execution */
     readonly ai: AIClient;
+    /** Webhook registration */
+    readonly webhooks: WebhookClient;
+    /** Event polling */
+    readonly events: EventClient;
     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 CreateAgentOptions, type CreateAgentResult, 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,61 @@ 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/index.ts
 var DEFAULT_BASE_URL = "https://auten.ai";
 var DEFAULT_TIMEOUT = 3e4;
@@ -323,6 +378,10 @@ var Auten = class {
   agents;
   /** AI-powered execution */
   ai;
+  /** Webhook registration */
+  webhooks;
+  /** Event polling */
+  events;
   client;
   constructor(config) {
     if (!config.apiKey) {
@@ -337,6 +396,8 @@ 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);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -281,6 +281,61 @@ 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/index.ts
 var DEFAULT_BASE_URL = "https://auten.ai";
 var DEFAULT_TIMEOUT = 3e4;
@@ -292,6 +347,10 @@ var Auten = class {
   agents;
   /** AI-powered execution */
   ai;
+  /** Webhook registration */
+  webhooks;
+  /** Event polling */
+  events;
   client;
   constructor(config) {
     if (!config.apiKey) {
@@ -306,6 +365,8 @@ 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);
   }
 };
 export {

package/package.json

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