import { CredentialResolver } from '../auth/credentials.js';
import type { ComposioSessionLike, ComposioSessionsClient, ComposioToolkitAuthState } from './composio-session-types.js';
import type { ConnectorActionMetadata, ConnectorConnection, ConnectorInstallationPolicy } from './types.js';
export declare function resolveComposioApiKey(resolver?: CredentialResolver): Promise<string | null>;
export declare function assertComposioAccessConfigured(resolver?: CredentialResolver): Promise<'byok' | 'managed'>;
export type ComposioToolkitCatalogItem = {
    slug: string;
    name: string;
    logoUrl?: string;
    isNoAuth: boolean;
    connected: boolean;
    providerConnectionId?: string;
};
export type ComposioAuthorizeResult = {
    toolkit: string;
    connectionId: string;
    connectUrl?: string;
    status: string;
};
export type { ComposioAuthConfigOption, ComposioSessionLike, ComposioSessionsClient, ComposioToolkitAuthState, } from './composio-session-types.js';
export type ComposioSessionContext = {
    principalId: string;
    installationScope?: string;
    providerPrincipalId?: string;
    toolkits?: string[];
    authConfigs?: Record<string, string>;
    connectedAccounts?: Record<string, string[]>;
    callbackUrl?: string;
};
type ClientFactory = () => Promise<ComposioSessionsClient>;
/** Convert local identities to stable opaque Composio user IDs without disclosing user data. */
export declare function createComposioPrincipalId(principalId: string, installationScope?: string): string;
export declare class ComposioSessionsAdapter {
    private readonly createClient;
    constructor(options?: {
        resolver?: CredentialResolver;
        clientFactory?: ClientFactory;
        fileDownloadDir?: string;
    });
    createSession(context: ComposioSessionContext): Promise<ComposioSessionLike>;
    getToolkitAuthState(toolkit: string): Promise<ComposioToolkitAuthState>;
    listToolkitCatalog(context: Omit<ComposioSessionContext, 'toolkits'>): Promise<ComposioToolkitCatalogItem[]>;
    authorize(context: ComposioSessionContext & {
        toolkit: string;
        authConfigId?: string;
        installationId?: string;
        alias?: string;
    }): Promise<ComposioAuthorizeResult>;
    syncConnections(context: Pick<ComposioSessionContext, 'principalId' | 'installationScope'>): Promise<ConnectorConnection[]>;
    revokeConnection(connection: ConnectorConnection): Promise<void>;
    refreshConnection(connection: ConnectorConnection): Promise<ConnectorConnection>;
    executeWithPolicy(input: {
        context: ComposioSessionContext;
        installation: ConnectorInstallationPolicy;
        connection?: ConnectorConnection;
        action: ConnectorActionMetadata;
        args?: Record<string, unknown>;
        agentId?: string;
        sessionKey?: string;
        confirmed?: boolean;
    }): Promise<{
        decision: 'allowed';
        result: unknown;
    } | {
        decision: 'denied' | 'confirmation_required';
        reason: string;
    }>;
}