@autenai/sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,308 @@
+/**
+ * Auten SDK — HTTP Client
+ * Fetch-based with retry, error mapping, and rate limit handling.
+ */
+interface ClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+    retries: number;
+}
+declare class HttpClient {
+    private config;
+    constructor(config: ClientConfig);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    del<T>(path: string): Promise<T | void>;
+    private request;
+    private sleep;
+}
+
+/**
+ * Auten SDK — Type Definitions
+ */
+interface AutenConfig {
+    /** Your Auten API key (starts with auten_live_ or auten_test_) */
+    apiKey: string;
+    /** Base URL for the API. Default: https://auten.ai */
+    baseUrl?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+    /** Number of retries on failure. Default: 3 */
+    retries?: number;
+}
+interface Provider {
+    slug: string;
+    name: string;
+    category: string;
+    icon: string | null;
+    accountEmail: string | null;
+    isActive: boolean;
+    connectedAt: string;
+}
+interface ProviderCredentials {
+    provider: string;
+    accessToken: string;
+}
+interface ExecuteResult {
+    provider: string;
+    action: string;
+    result: any;
+    duration?: number;
+}
+interface AIExecuteResult {
+    provider: string;
+    task: string;
+    result: any;
+    duration?: number;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    status: string;
+    isPublished: boolean;
+    schedule: AgentSchedule | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentDetail extends Agent {
+    tools: AgentTool[];
+}
+interface AgentTool {
+    name: string;
+    description: string;
+}
+interface AgentSchedule {
+    cron: string;
+    timezone: string;
+    enabled: boolean;
+    nextRunAt: string | null;
+}
+interface CreateAgentOptions {
+    name: string;
+    description?: string;
+    tools?: Array<{
+        name: string;
+        code: string;
+        description?: string;
+    }>;
+    schedule?: {
+        cron: string;
+        timezone?: string;
+        enabled?: boolean;
+    };
+}
+interface DeployAgentOptions {
+    tools: Array<{
+        name: string;
+        code: string;
+        description?: string;
+    }>;
+    schedule?: {
+        cron?: string;
+        timezone?: string;
+        enabled?: boolean;
+    };
+}
+interface AgentRunResult {
+    executionId: string;
+    status: string;
+}
+interface CreateAgentResult {
+    id: string;
+    name: string;
+    scope: string;
+    status: string;
+    toolCount: number;
+}
+interface DeployResult {
+    id: string;
+    deployed: boolean;
+    tools: string[];
+    version: string;
+}
+
+/**
+ * Auten SDK — Provider Client
+ * Manages provider connections and executes actions.
+ */
+
+declare class ProviderClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all connected providers for the authenticated user.
+     */
+    list(): Promise<Provider[]>;
+    /**
+     * Execute an action on a provider.
+     *
+     * @example
+     * const result = await auten.providers.execute('google-gmail', 'listEmails', { query: 'is:unread' });
+     */
+    execute(slug: string, action: string, params?: Record<string, any>): Promise<ExecuteResult>;
+    /**
+     * Get a valid access token for a provider.
+     * Token is automatically refreshed if expired.
+     *
+     * @example
+     * const { accessToken } = await auten.providers.getCredentials('google-gmail');
+     */
+    getCredentials(slug: string): Promise<ProviderCredentials>;
+}
+
+/**
+ * Auten SDK — Agent Client
+ * Create, deploy, run, and manage agents.
+ */
+
+declare class AgentClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all agents for the authenticated user.
+     */
+    list(): Promise<Agent[]>;
+    /**
+     * Get agent details including tools and schedule.
+     */
+    get(id: string): Promise<AgentDetail>;
+    /**
+     * Create a new agent.
+     *
+     * @example
+     * const agent = await auten.agents.create({
+     *   name: 'Invoice Processor',
+     *   tools: [{ name: 'process-invoice', code: '...' }],
+     *   schedule: { cron: '0 9 * * *', timezone: 'Europe/Vilnius' },
+     * });
+     */
+    create(options: CreateAgentOptions): Promise<CreateAgentResult>;
+    /**
+     * Deploy tools to an existing agent.
+     * Upserts tool code and updates the agent configuration.
+     *
+     * @example
+     * await auten.agents.deploy('agent-id', {
+     *   tools: [{ name: 'fetch-data', code: '...' }],
+     * });
+     */
+    deploy(id: string, options: DeployAgentOptions): Promise<DeployResult>;
+    /**
+     * Trigger an agent run.
+     *
+     * @example
+     * const { executionId } = await auten.agents.run('agent-id', { inputData: '...' });
+     */
+    run(id: string, data?: Record<string, any>): Promise<AgentRunResult>;
+    /**
+     * Get agent status.
+     */
+    status(id: string): Promise<{
+        status: string;
+        lastRunAt?: string;
+    }>;
+    /**
+     * Get agent run history.
+     */
+    history(id: string): Promise<any[]>;
+    /**
+     * Delete an agent and all its knowledge/tools.
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Auten SDK — AI Client
+ * AI-powered provider interactions using natural language.
+ */
+
+declare class AIClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Execute a task using AI to interpret and call the right provider APIs.
+     *
+     * @example
+     * const result = await auten.ai.execute(
+     *   'google-sheets',
+     *   'Find Q1 revenue totals and create a summary row'
+     * );
+     *
+     * @example
+     * const result = await auten.ai.execute(
+     *   'zoho-crm',
+     *   'Find all deals closing this month worth over $10k',
+     *   { currency: 'USD' }
+     * );
+     */
+    execute(provider: string, task: string, context?: Record<string, any>): Promise<AIExecuteResult>;
+}
+
+/**
+ * Auten SDK — Error Classes
+ */
+declare class AutenError extends Error {
+    constructor(message: string);
+}
+declare class AutenApiError extends AutenError {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details: unknown;
+    constructor(code: string, message: string, statusCode: number, details?: unknown);
+}
+declare class AutenAuthError extends AutenApiError {
+    constructor(message: string, code?: string);
+}
+declare class AutenRateLimitError extends AutenApiError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number);
+}
+declare class AutenNotFoundError extends AutenApiError {
+    constructor(message: string);
+}
+
+/**
+ * Auten.ai SDK
+ *
+ * AI-native integrations with managed OAuth.
+ *
+ * @example
+ * ```typescript
+ * import { Auten } from '@autenai/sdk';
+ *
+ * const auten = new Auten({ apiKey: 'auten_live_...' });
+ *
+ * // 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'
+ * );
+ *
+ * // Manage agents
+ * const agents = await auten.agents.list();
+ * await auten.agents.run('agent-id');
+ * ```
+ */
+
+declare class Auten {
+    /** Provider connections and execution */
+    readonly providers: ProviderClient;
+    /** Agent management */
+    readonly agents: AgentClient;
+    /** AI-powered execution */
+    readonly ai: AIClient;
+    private readonly client;
+    constructor(config: AutenConfig);
+}
+
+export { 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 };

package/dist/index.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Auten SDK — HTTP Client
+ * Fetch-based with retry, error mapping, and rate limit handling.
+ */
+interface ClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+    retries: number;
+}
+declare class HttpClient {
+    private config;
+    constructor(config: ClientConfig);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    del<T>(path: string): Promise<T | void>;
+    private request;
+    private sleep;
+}
+
+/**
+ * Auten SDK — Type Definitions
+ */
+interface AutenConfig {
+    /** Your Auten API key (starts with auten_live_ or auten_test_) */
+    apiKey: string;
+    /** Base URL for the API. Default: https://auten.ai */
+    baseUrl?: string;
+    /** Request timeout in ms. Default: 30000 */
+    timeout?: number;
+    /** Number of retries on failure. Default: 3 */
+    retries?: number;
+}
+interface Provider {
+    slug: string;
+    name: string;
+    category: string;
+    icon: string | null;
+    accountEmail: string | null;
+    isActive: boolean;
+    connectedAt: string;
+}
+interface ProviderCredentials {
+    provider: string;
+    accessToken: string;
+}
+interface ExecuteResult {
+    provider: string;
+    action: string;
+    result: any;
+    duration?: number;
+}
+interface AIExecuteResult {
+    provider: string;
+    task: string;
+    result: any;
+    duration?: number;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    status: string;
+    isPublished: boolean;
+    schedule: AgentSchedule | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AgentDetail extends Agent {
+    tools: AgentTool[];
+}
+interface AgentTool {
+    name: string;
+    description: string;
+}
+interface AgentSchedule {
+    cron: string;
+    timezone: string;
+    enabled: boolean;
+    nextRunAt: string | null;
+}
+interface CreateAgentOptions {
+    name: string;
+    description?: string;
+    tools?: Array<{
+        name: string;
+        code: string;
+        description?: string;
+    }>;
+    schedule?: {
+        cron: string;
+        timezone?: string;
+        enabled?: boolean;
+    };
+}
+interface DeployAgentOptions {
+    tools: Array<{
+        name: string;
+        code: string;
+        description?: string;
+    }>;
+    schedule?: {
+        cron?: string;
+        timezone?: string;
+        enabled?: boolean;
+    };
+}
+interface AgentRunResult {
+    executionId: string;
+    status: string;
+}
+interface CreateAgentResult {
+    id: string;
+    name: string;
+    scope: string;
+    status: string;
+    toolCount: number;
+}
+interface DeployResult {
+    id: string;
+    deployed: boolean;
+    tools: string[];
+    version: string;
+}
+
+/**
+ * Auten SDK — Provider Client
+ * Manages provider connections and executes actions.
+ */
+
+declare class ProviderClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all connected providers for the authenticated user.
+     */
+    list(): Promise<Provider[]>;
+    /**
+     * Execute an action on a provider.
+     *
+     * @example
+     * const result = await auten.providers.execute('google-gmail', 'listEmails', { query: 'is:unread' });
+     */
+    execute(slug: string, action: string, params?: Record<string, any>): Promise<ExecuteResult>;
+    /**
+     * Get a valid access token for a provider.
+     * Token is automatically refreshed if expired.
+     *
+     * @example
+     * const { accessToken } = await auten.providers.getCredentials('google-gmail');
+     */
+    getCredentials(slug: string): Promise<ProviderCredentials>;
+}
+
+/**
+ * Auten SDK — Agent Client
+ * Create, deploy, run, and manage agents.
+ */
+
+declare class AgentClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * List all agents for the authenticated user.
+     */
+    list(): Promise<Agent[]>;
+    /**
+     * Get agent details including tools and schedule.
+     */
+    get(id: string): Promise<AgentDetail>;
+    /**
+     * Create a new agent.
+     *
+     * @example
+     * const agent = await auten.agents.create({
+     *   name: 'Invoice Processor',
+     *   tools: [{ name: 'process-invoice', code: '...' }],
+     *   schedule: { cron: '0 9 * * *', timezone: 'Europe/Vilnius' },
+     * });
+     */
+    create(options: CreateAgentOptions): Promise<CreateAgentResult>;
+    /**
+     * Deploy tools to an existing agent.
+     * Upserts tool code and updates the agent configuration.
+     *
+     * @example
+     * await auten.agents.deploy('agent-id', {
+     *   tools: [{ name: 'fetch-data', code: '...' }],
+     * });
+     */
+    deploy(id: string, options: DeployAgentOptions): Promise<DeployResult>;
+    /**
+     * Trigger an agent run.
+     *
+     * @example
+     * const { executionId } = await auten.agents.run('agent-id', { inputData: '...' });
+     */
+    run(id: string, data?: Record<string, any>): Promise<AgentRunResult>;
+    /**
+     * Get agent status.
+     */
+    status(id: string): Promise<{
+        status: string;
+        lastRunAt?: string;
+    }>;
+    /**
+     * Get agent run history.
+     */
+    history(id: string): Promise<any[]>;
+    /**
+     * Delete an agent and all its knowledge/tools.
+     */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Auten SDK — AI Client
+ * AI-powered provider interactions using natural language.
+ */
+
+declare class AIClient {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Execute a task using AI to interpret and call the right provider APIs.
+     *
+     * @example
+     * const result = await auten.ai.execute(
+     *   'google-sheets',
+     *   'Find Q1 revenue totals and create a summary row'
+     * );
+     *
+     * @example
+     * const result = await auten.ai.execute(
+     *   'zoho-crm',
+     *   'Find all deals closing this month worth over $10k',
+     *   { currency: 'USD' }
+     * );
+     */
+    execute(provider: string, task: string, context?: Record<string, any>): Promise<AIExecuteResult>;
+}
+
+/**
+ * Auten SDK — Error Classes
+ */
+declare class AutenError extends Error {
+    constructor(message: string);
+}
+declare class AutenApiError extends AutenError {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details: unknown;
+    constructor(code: string, message: string, statusCode: number, details?: unknown);
+}
+declare class AutenAuthError extends AutenApiError {
+    constructor(message: string, code?: string);
+}
+declare class AutenRateLimitError extends AutenApiError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number);
+}
+declare class AutenNotFoundError extends AutenApiError {
+    constructor(message: string);
+}
+
+/**
+ * Auten.ai SDK
+ *
+ * AI-native integrations with managed OAuth.
+ *
+ * @example
+ * ```typescript
+ * import { Auten } from '@autenai/sdk';
+ *
+ * const auten = new Auten({ apiKey: 'auten_live_...' });
+ *
+ * // 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'
+ * );
+ *
+ * // Manage agents
+ * const agents = await auten.agents.list();
+ * await auten.agents.run('agent-id');
+ * ```
+ */
+
+declare class Auten {
+    /** Provider connections and execution */
+    readonly providers: ProviderClient;
+    /** Agent management */
+    readonly agents: AgentClient;
+    /** AI-powered execution */
+    readonly ai: AIClient;
+    private readonly client;
+    constructor(config: AutenConfig);
+}
+
+export { 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 };

package/dist/index.js

@@ -0,0 +1,329 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Auten: () => Auten,
+  AutenApiError: () => AutenApiError,
+  AutenAuthError: () => AutenAuthError,
+  AutenError: () => AutenError,
+  AutenNotFoundError: () => AutenNotFoundError,
+  AutenRateLimitError: () => AutenRateLimitError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var AutenError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "AutenError";
+  }
+};
+var AutenApiError = class extends AutenError {
+  code;
+  statusCode;
+  details;
+  constructor(code, message, statusCode, details) {
+    super(message);
+    this.name = "AutenApiError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+  }
+};
+var AutenAuthError = class extends AutenApiError {
+  constructor(message, code = "UNAUTHORIZED") {
+    super(code, message, 401);
+    this.name = "AutenAuthError";
+  }
+};
+var AutenRateLimitError = class extends AutenApiError {
+  retryAfter;
+  constructor(message, retryAfter) {
+    super("RATE_LIMIT_EXCEEDED", message, 429, { retryAfter });
+    this.name = "AutenRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var AutenNotFoundError = class extends AutenApiError {
+  constructor(message) {
+    super("RESOURCE_NOT_FOUND", message, 404);
+    this.name = "AutenNotFoundError";
+  }
+};
+
+// src/client.ts
+var HttpClient = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async del(path) {
+    return this.request("DELETE", path);
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.config.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.config.apiKey}`,
+            "Content-Type": "application/json",
+            "User-Agent": "@auten/sdk"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.status === 204) {
+          return void 0;
+        }
+        const data = await response.json();
+        if (response.ok && data.success) {
+          return data.data;
+        }
+        const errorData = data;
+        const errorCode = errorData.error?.code || "UNKNOWN";
+        const errorMessage = errorData.error?.message || "Unknown error";
+        const errorDetails = errorData.error?.details;
+        if (response.status === 429) {
+          const retryAfter = errorDetails?.retryAfter || 5;
+          if (attempt < this.config.retries) {
+            await this.sleep(retryAfter * 1e3);
+            continue;
+          }
+          throw new AutenRateLimitError(errorMessage, retryAfter);
+        }
+        if (response.status === 401) {
+          throw new AutenAuthError(errorMessage, errorCode);
+        }
+        if (response.status === 404) {
+          throw new AutenNotFoundError(errorMessage);
+        }
+        if (response.status >= 500 && attempt < this.config.retries) {
+          lastError = new AutenApiError(errorCode, errorMessage, response.status, errorDetails);
+          await this.sleep(Math.pow(2, attempt) * 1e3);
+          continue;
+        }
+        throw new AutenApiError(errorCode, errorMessage, response.status, errorDetails);
+      } catch (error) {
+        if (error instanceof AutenApiError) {
+          throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+          lastError = new AutenError(`Request timed out after ${this.config.timeout}ms`);
+        } else {
+          lastError = error;
+        }
+        if (attempt < this.config.retries) {
+          await this.sleep(Math.pow(2, attempt) * 1e3);
+          continue;
+        }
+      }
+    }
+    throw lastError || new AutenError("Request failed after retries");
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/providers.ts
+var ProviderClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all connected providers for the authenticated user.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/providers");
+  }
+  /**
+   * Execute an action on a provider.
+   *
+   * @example
+   * const result = await auten.providers.execute('google-gmail', 'listEmails', { query: 'is:unread' });
+   */
+  async execute(slug, action, params) {
+    return this.client.post(`/api/v1/sdk/providers/${slug}/execute`, {
+      action,
+      params
+    });
+  }
+  /**
+   * Get a valid access token for a provider.
+   * Token is automatically refreshed if expired.
+   *
+   * @example
+   * const { accessToken } = await auten.providers.getCredentials('google-gmail');
+   */
+  async getCredentials(slug) {
+    return this.client.get(`/api/v1/sdk/providers/${slug}/credentials`);
+  }
+};
+
+// src/agents.ts
+var AgentClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all agents for the authenticated user.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/agents");
+  }
+  /**
+   * Get agent details including tools and schedule.
+   */
+  async get(id) {
+    return this.client.get(`/api/v1/sdk/agents/${id}`);
+  }
+  /**
+   * Create a new agent.
+   *
+   * @example
+   * const agent = await auten.agents.create({
+   *   name: 'Invoice Processor',
+   *   tools: [{ name: 'process-invoice', code: '...' }],
+   *   schedule: { cron: '0 9 * * *', timezone: 'Europe/Vilnius' },
+   * });
+   */
+  async create(options) {
+    return this.client.post("/api/v1/sdk/agents", options);
+  }
+  /**
+   * Deploy tools to an existing agent.
+   * Upserts tool code and updates the agent configuration.
+   *
+   * @example
+   * await auten.agents.deploy('agent-id', {
+   *   tools: [{ name: 'fetch-data', code: '...' }],
+   * });
+   */
+  async deploy(id, options) {
+    return this.client.post(`/api/v1/sdk/agents/${id}/deploy`, options);
+  }
+  /**
+   * Trigger an agent run.
+   *
+   * @example
+   * const { executionId } = await auten.agents.run('agent-id', { inputData: '...' });
+   */
+  async run(id, data) {
+    return this.client.post(`/api/v1/agents/${id}/run`, data);
+  }
+  /**
+   * Get agent status.
+   */
+  async status(id) {
+    return this.client.get(`/api/v1/agents/${id}/status`);
+  }
+  /**
+   * Get agent run history.
+   */
+  async history(id) {
+    return this.client.get(`/api/v1/agents/${id}/history`);
+  }
+  /**
+   * Delete an agent and all its knowledge/tools.
+   */
+  async delete(id) {
+    await this.client.del(`/api/v1/sdk/agents/${id}`);
+  }
+};
+
+// src/ai.ts
+var AIClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Execute a task using AI to interpret and call the right provider APIs.
+   *
+   * @example
+   * const result = await auten.ai.execute(
+   *   'google-sheets',
+   *   'Find Q1 revenue totals and create a summary row'
+   * );
+   *
+   * @example
+   * const result = await auten.ai.execute(
+   *   'zoho-crm',
+   *   'Find all deals closing this month worth over $10k',
+   *   { currency: 'USD' }
+   * );
+   */
+  async execute(provider, task, context) {
+    return this.client.post("/api/v1/sdk/ai/execute", {
+      provider,
+      task,
+      context
+    });
+  }
+};
+
+// src/index.ts
+var DEFAULT_BASE_URL = "https://auten.ai";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_RETRIES = 3;
+var Auten = class {
+  /** Provider connections and execution */
+  providers;
+  /** Agent management */
+  agents;
+  /** AI-powered execution */
+  ai;
+  client;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new AutenError("apiKey is required. Get one at https://auten.ai/settings \u2192 API Keys");
+    }
+    this.client = new HttpClient({
+      apiKey: config.apiKey,
+      baseUrl: (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, ""),
+      timeout: config.timeout || DEFAULT_TIMEOUT,
+      retries: config.retries ?? DEFAULT_RETRIES
+    });
+    this.providers = new ProviderClient(this.client);
+    this.agents = new AgentClient(this.client);
+    this.ai = new AIClient(this.client);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Auten,
+  AutenApiError,
+  AutenAuthError,
+  AutenError,
+  AutenNotFoundError,
+  AutenRateLimitError
+});

package/dist/index.mjs

@@ -0,0 +1,297 @@
+// src/errors.ts
+var AutenError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "AutenError";
+  }
+};
+var AutenApiError = class extends AutenError {
+  code;
+  statusCode;
+  details;
+  constructor(code, message, statusCode, details) {
+    super(message);
+    this.name = "AutenApiError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+  }
+};
+var AutenAuthError = class extends AutenApiError {
+  constructor(message, code = "UNAUTHORIZED") {
+    super(code, message, 401);
+    this.name = "AutenAuthError";
+  }
+};
+var AutenRateLimitError = class extends AutenApiError {
+  retryAfter;
+  constructor(message, retryAfter) {
+    super("RATE_LIMIT_EXCEEDED", message, 429, { retryAfter });
+    this.name = "AutenRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var AutenNotFoundError = class extends AutenApiError {
+  constructor(message) {
+    super("RESOURCE_NOT_FOUND", message, 404);
+    this.name = "AutenNotFoundError";
+  }
+};
+
+// src/client.ts
+var HttpClient = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async del(path) {
+    return this.request("DELETE", path);
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.config.retries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.config.apiKey}`,
+            "Content-Type": "application/json",
+            "User-Agent": "@auten/sdk"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.status === 204) {
+          return void 0;
+        }
+        const data = await response.json();
+        if (response.ok && data.success) {
+          return data.data;
+        }
+        const errorData = data;
+        const errorCode = errorData.error?.code || "UNKNOWN";
+        const errorMessage = errorData.error?.message || "Unknown error";
+        const errorDetails = errorData.error?.details;
+        if (response.status === 429) {
+          const retryAfter = errorDetails?.retryAfter || 5;
+          if (attempt < this.config.retries) {
+            await this.sleep(retryAfter * 1e3);
+            continue;
+          }
+          throw new AutenRateLimitError(errorMessage, retryAfter);
+        }
+        if (response.status === 401) {
+          throw new AutenAuthError(errorMessage, errorCode);
+        }
+        if (response.status === 404) {
+          throw new AutenNotFoundError(errorMessage);
+        }
+        if (response.status >= 500 && attempt < this.config.retries) {
+          lastError = new AutenApiError(errorCode, errorMessage, response.status, errorDetails);
+          await this.sleep(Math.pow(2, attempt) * 1e3);
+          continue;
+        }
+        throw new AutenApiError(errorCode, errorMessage, response.status, errorDetails);
+      } catch (error) {
+        if (error instanceof AutenApiError) {
+          throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+          lastError = new AutenError(`Request timed out after ${this.config.timeout}ms`);
+        } else {
+          lastError = error;
+        }
+        if (attempt < this.config.retries) {
+          await this.sleep(Math.pow(2, attempt) * 1e3);
+          continue;
+        }
+      }
+    }
+    throw lastError || new AutenError("Request failed after retries");
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/providers.ts
+var ProviderClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all connected providers for the authenticated user.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/providers");
+  }
+  /**
+   * Execute an action on a provider.
+   *
+   * @example
+   * const result = await auten.providers.execute('google-gmail', 'listEmails', { query: 'is:unread' });
+   */
+  async execute(slug, action, params) {
+    return this.client.post(`/api/v1/sdk/providers/${slug}/execute`, {
+      action,
+      params
+    });
+  }
+  /**
+   * Get a valid access token for a provider.
+   * Token is automatically refreshed if expired.
+   *
+   * @example
+   * const { accessToken } = await auten.providers.getCredentials('google-gmail');
+   */
+  async getCredentials(slug) {
+    return this.client.get(`/api/v1/sdk/providers/${slug}/credentials`);
+  }
+};
+
+// src/agents.ts
+var AgentClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List all agents for the authenticated user.
+   */
+  async list() {
+    return this.client.get("/api/v1/sdk/agents");
+  }
+  /**
+   * Get agent details including tools and schedule.
+   */
+  async get(id) {
+    return this.client.get(`/api/v1/sdk/agents/${id}`);
+  }
+  /**
+   * Create a new agent.
+   *
+   * @example
+   * const agent = await auten.agents.create({
+   *   name: 'Invoice Processor',
+   *   tools: [{ name: 'process-invoice', code: '...' }],
+   *   schedule: { cron: '0 9 * * *', timezone: 'Europe/Vilnius' },
+   * });
+   */
+  async create(options) {
+    return this.client.post("/api/v1/sdk/agents", options);
+  }
+  /**
+   * Deploy tools to an existing agent.
+   * Upserts tool code and updates the agent configuration.
+   *
+   * @example
+   * await auten.agents.deploy('agent-id', {
+   *   tools: [{ name: 'fetch-data', code: '...' }],
+   * });
+   */
+  async deploy(id, options) {
+    return this.client.post(`/api/v1/sdk/agents/${id}/deploy`, options);
+  }
+  /**
+   * Trigger an agent run.
+   *
+   * @example
+   * const { executionId } = await auten.agents.run('agent-id', { inputData: '...' });
+   */
+  async run(id, data) {
+    return this.client.post(`/api/v1/agents/${id}/run`, data);
+  }
+  /**
+   * Get agent status.
+   */
+  async status(id) {
+    return this.client.get(`/api/v1/agents/${id}/status`);
+  }
+  /**
+   * Get agent run history.
+   */
+  async history(id) {
+    return this.client.get(`/api/v1/agents/${id}/history`);
+  }
+  /**
+   * Delete an agent and all its knowledge/tools.
+   */
+  async delete(id) {
+    await this.client.del(`/api/v1/sdk/agents/${id}`);
+  }
+};
+
+// src/ai.ts
+var AIClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Execute a task using AI to interpret and call the right provider APIs.
+   *
+   * @example
+   * const result = await auten.ai.execute(
+   *   'google-sheets',
+   *   'Find Q1 revenue totals and create a summary row'
+   * );
+   *
+   * @example
+   * const result = await auten.ai.execute(
+   *   'zoho-crm',
+   *   'Find all deals closing this month worth over $10k',
+   *   { currency: 'USD' }
+   * );
+   */
+  async execute(provider, task, context) {
+    return this.client.post("/api/v1/sdk/ai/execute", {
+      provider,
+      task,
+      context
+    });
+  }
+};
+
+// src/index.ts
+var DEFAULT_BASE_URL = "https://auten.ai";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_RETRIES = 3;
+var Auten = class {
+  /** Provider connections and execution */
+  providers;
+  /** Agent management */
+  agents;
+  /** AI-powered execution */
+  ai;
+  client;
+  constructor(config) {
+    if (!config.apiKey) {
+      throw new AutenError("apiKey is required. Get one at https://auten.ai/settings \u2192 API Keys");
+    }
+    this.client = new HttpClient({
+      apiKey: config.apiKey,
+      baseUrl: (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, ""),
+      timeout: config.timeout || DEFAULT_TIMEOUT,
+      retries: config.retries ?? DEFAULT_RETRIES
+    });
+    this.providers = new ProviderClient(this.client);
+    this.agents = new AgentClient(this.client);
+    this.ai = new AIClient(this.client);
+  }
+};
+export {
+  Auten,
+  AutenApiError,
+  AutenAuthError,
+  AutenError,
+  AutenNotFoundError,
+  AutenRateLimitError
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@autenai/sdk",
+  "version": "0.1.0",
+  "description": "Auten.ai SDK — AI-native integrations with managed OAuth",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "auten",
+    "ai",
+    "oauth",
+    "integrations",
+    "agents",
+    "automation"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}