@muxoai/sdk 1.2.3 → 1.4.2

package/dist/providers/composio-sdk.d.ts

@@ -0,0 +1,162 @@
+import { Composio } from "@composio/core";
+import type { MuxoConfig } from "../config.js";
+import type { MuxoTool, RiskLevel } from "../types.js";
+import { parseComposioWebhookEnvelope, type ComposioToolkitMetadata, type ComposioTriggerEventRecord, type ComposioTriggerSubscription, type ComposioTriggerType, type ComposioWebhookEventType } from "../composio-catalog.js";
+export type { ComposioToolkitMetadata, ComposioTriggerEventRecord, ComposioTriggerSubscription, ComposioTriggerType, ComposioWebhookEventType, };
+export declare class ComposioSdkAdapter {
+    private readonly config;
+    private liveToolsCache;
+    private sdkClients;
+    private readonly customAuthConfigs;
+    private readonly activeTriggers;
+    private readonly triggerEvents;
+    constructor(config: MuxoConfig);
+    private hydrateEnterpriseSampleActions;
+    private resolveApiKey;
+    private get headers();
+    private getHeaders;
+    getComposioClient(composioApiKey?: string | null): Composio | null;
+    getSdkInfo(composioApiKey?: string | null): {
+        sdkPackage: "@composio/core";
+        sdkVersion: string;
+        configured: boolean;
+        usingCustomerByok: boolean;
+        baseUrl: string;
+        curatedToolCount: number;
+        cachedToolCount: number;
+        capabilities: string[];
+    };
+    getWebhookConfigInfo(): {
+        webhookUrl: string;
+        legacyWebhookUrl: string;
+        version: "V3";
+        events: ComposioWebhookEventType[];
+        secretConfigured: boolean;
+        subscriptionId: string | null;
+        projectId: string | null;
+        orgId: string | null;
+        userId: string | null;
+    };
+    getCuratedTools(): MuxoTool[];
+    static classifyActionRisk(upstreamSlug: string, description?: string): RiskLevel;
+    listToolkits(params?: {
+        category?: string;
+        search?: string;
+        composioApiKey?: string | null;
+    }): Promise<{
+        toolkits: ComposioToolkitMetadata[];
+        total: number;
+        source: "composio_v3_sdk" | "muxo_enterprise_catalog";
+    }>;
+    createCustomAuthConfig(params: {
+        workspaceId: string;
+        toolkitSlug: string;
+        name?: string;
+        authScheme: "OAUTH2" | "API_KEY";
+        scopeMode?: "read_only" | "full_access";
+        customScopes?: string[];
+        credentials?: Record<string, string>;
+        composioApiKey?: string | null;
+    }): Promise<{
+        authConfigId: string;
+        toolkitSlug: string;
+        authScheme: string;
+        scopeMode: "read_only" | "full_access";
+        scopes: string[];
+        source: "composio_v3_sdk" | "muxo_managed";
+    }>;
+    listTriggerTypes(providerSlug?: string): ComposioTriggerType[];
+    /**
+     * Check what configuration is required for a trigger (`composio.triggers.getType(slug)`).
+     */
+    getTriggerType(triggerSlug: string, composioApiKey?: string | null): Promise<ComposioTriggerType & {
+        source: "composio_v3_sdk" | "muxo_trigger_catalog";
+    }>;
+    /**
+     * Create a trigger with required config (`composio.triggers.create(userId, slug, { triggerConfig })`)
+     * and optionally subscribe to real-time trigger events (`composio.triggers.subscribe`).
+     */
+    enableTrigger(params: {
+        workspaceId: string;
+        userId?: string;
+        triggerSlug: string;
+        providerSlug: string;
+        connectedAccountId?: string;
+        webhookUrl?: string;
+        config?: Record<string, unknown>;
+        subscribe?: boolean;
+        composioApiKey?: string | null;
+    }): Promise<ComposioTriggerSubscription>;
+    /**
+     * Subscribe to real-time trigger events via `@composio/core` (`composio.triggers.subscribe`).
+     */
+    subscribeToTriggerEvents(params: {
+        workspaceId: string;
+        triggerId?: string;
+        toolkits?: string[];
+        onEvent?: (data: Record<string, unknown>) => void;
+        composioApiKey?: string | null;
+    }): Promise<{
+        subscribed: boolean;
+        triggerId?: string;
+    }>;
+    /**
+     * Verify an incoming Composio webhook payload and HMAC-SHA256 signature.
+     */
+    verifyWebhook(params: {
+        rawPayload: string;
+        signatureHeader?: string | null;
+        webhookIdHeader?: string | null;
+        webhookTimestampHeader?: string | null;
+        secret?: string | null;
+        toleranceSeconds?: number;
+    }): Promise<{
+        verified: boolean;
+        reason?: string;
+        envelope: ReturnType<typeof parseComposioWebhookEnvelope>;
+    }>;
+    disableTriggersMatching(params: {
+        workspaceId?: string;
+        triggerId?: string;
+        triggerSlug?: string;
+        connectedAccountId?: string;
+    }): number;
+    listActiveTriggers(workspaceId: string): ComposioTriggerSubscription[];
+    recordTriggerEvent(record: ComposioTriggerEventRecord): void;
+    listTriggerEvents(workspaceId: string, limit?: number): ComposioTriggerEventRecord[];
+    private mapRawComposioItemToMuxoTool;
+    searchTools(query?: string, limit?: number, composioApiKey?: string | null, toolkit?: string): Promise<MuxoTool[]>;
+    inspectTool(slug: string, composioApiKey?: string | null): Promise<MuxoTool | null>;
+    startConnection(params: {
+        workspaceId: string;
+        providerSlug: string;
+        callbackUrl?: string;
+        composioApiKey?: string | null;
+    }): Promise<{
+        providerSlug: string;
+        providerName: string;
+        status: "pending" | "active";
+        redirectUrl: string | null;
+        callbackUrl: string;
+        externalAccountId: string | null;
+        message: string;
+    }>;
+    getConnectedAccountStatus(externalAccountId: string, composioApiKey?: string | null): Promise<{
+        id: string;
+        providerSlug: string;
+        status: "active" | "pending" | "expired";
+    } | null>;
+    listLiveConnections(workspaceId: string, composioApiKey?: string | null): Promise<Array<{
+        providerSlug: string;
+        providerName: string;
+        status: "active" | "pending" | "expired";
+        externalAccountId: string;
+    }>>;
+    executeTool(params: {
+        workspaceId: string;
+        tool: MuxoTool;
+        input: Record<string, unknown>;
+        connectedAccountId?: string | null;
+        composioApiKey?: string | null;
+    }): Promise<Record<string, unknown>>;
+}