@autenai/sdk 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,424 +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 — 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;
-    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 PollResult, type Provider, type ProviderCredentials, type RegisterWebhookOptions, type SdkEvent, type Webhook };