@autenai/sdk 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -1,500 +0,0 @@
-/**
- * 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;
-    plan?: string;
-    result: any;
-    callsMade?: number;
-    learned?: boolean;
-    cached?: boolean;
-    duration?: number;
-}
-interface AIChainStep {
-    provider: string;
-    task: string;
-    status: 'success' | 'failed' | 'skipped';
-    result?: any;
-    error?: string;
-}
-interface AIChainResult {
-    summary: string;
-    steps: AIChainStep[];
-    totalProviders: number;
-    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>;
-    /**
-     * Execute a cross-provider task using natural language.
-     * AI breaks the task into steps, executes each with the right provider,
-     * and transforms data between them automatically.
-     *
-     * @example
-     * const result = await auten.ai.chain(
-     *   'Paimk Shopify užsakymus ir sudėk į Google Sheets'
-     * );
-     *
-     * @example
-     * const result = await auten.ai.chain(
-     *   'Find Jira bugs from this week, group by severity, and post summary to Slack #dev'
-     * );
-     */
-    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
- */
-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 v0.3.0
- *
- * AI-native integrations with managed OAuth, event-driven webhooks,
- * and per-user learning.
- *
- * @example
- * ```typescript
- * import { Auten } from '@autenai/sdk';
- *
- * const auten = new Auten({ apiKey: 'auten_live_...' });
- *
- * // List connected providers
- * const providers = await auten.providers.list();
- *
- * // AI-powered execution
- * 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',
- * });
- *
- * // Or poll for events
- * const { events } = await auten.events.poll({ since: lastCheck });
- * ```
- */
-
-declare class Auten {
-    /** Provider connections and execution */
-    readonly providers: ProviderClient;
-    /** Agent management */
-    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 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 };