lumnisai 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -50,7 +50,7 @@ interface TenantDetailsResponse {
     updatedAt: string;
 }
 
-type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'E2B_API_KEY';
+type ApiProvider = 'OPENAI_API_KEY' | 'ANTHROPIC_API_KEY' | 'EXA_API_KEY' | 'COHERE_API_KEY' | 'CORESIGNAL_API_KEY' | 'GOOGLE_API_KEY' | 'SERPAPI_API_KEY' | 'GROQ_API_KEY' | 'NVIDIA_API_KEY' | 'FIREWORKS_API_KEY' | 'MISTRAL_API_KEY' | 'TOGETHER_API_KEY' | 'XAI_API_KEY' | 'PPLX_API_KEY' | 'HUGGINGFACE_API_KEY' | 'DEEPSEEK_API_KEY' | 'IBM_API_KEY' | 'E2B_API_KEY';
 interface StoreApiKeyRequest {
     provider: ApiProvider;
     apiKey: string;
@@ -73,11 +73,24 @@ interface DeleteApiKeyResponse {
     message: string;
 }
 
+/**
+ * Integration provider types
+ */
+declare enum ProviderType {
+    COMPOSIO = "composio",
+    UNIPILE = "unipile",
+    NANGO = "nango",// Future
+    ARCADE = "arcade",// Future
+    MERGE = "merge"
+}
 type ConnectionStatus = 'pending' | 'active' | 'failed' | 'expired' | 'not_connected';
 interface InitiateConnectionRequest {
     userId: string;
     appName: string;
+    provider?: ProviderType;
     redirectUrl?: string;
+    successRedirectUrl?: string;
+    failureRedirectUrl?: string;
     authMode?: string;
     connectionParams?: Record<string, any>;
 }
@@ -93,10 +106,14 @@ interface ConnectionStatusResponse {
     errorMessage?: string | null;
 }
 interface ConnectionInfo {
+    connectionId: string | null;
+    tenantId: string;
+    userId: string;
+    provider: ProviderType;
     appName: string;
     status: ConnectionStatus;
-    connectedAt?: string | null;
-    errorMessage?: string | null;
+    connectedAt: string | null;
+    metadata: Record<string, any>;
 }
 interface UserConnectionsResponse {
     userId: string;
@@ -104,6 +121,7 @@ interface UserConnectionsResponse {
 }
 interface GetToolsRequest {
     userId: string;
+    provider?: ProviderType;
     appFilter?: string[];
 }
 interface ToolInfo {
@@ -120,6 +138,7 @@ interface GetToolsResponse {
 interface DisconnectRequest {
     userId: string;
     appName: string;
+    provider?: ProviderType;
 }
 interface DisconnectResponse {
     success: boolean;
@@ -137,12 +156,15 @@ interface ConnectionCallbackResponse {
     message: string;
 }
 interface AppsListResponse {
-    enabledApps: string[];
-    totalEnabled: number;
+    providers: Record<string, string[]>;
+    totalProviders: number;
+    enabledApps?: string[];
+    totalEnabled?: number;
     availableApps?: string[];
     totalAvailable?: number;
 }
 interface AppEnabledResponse {
+    provider: ProviderType;
     appName: string;
     enabled: boolean;
     message: string;
@@ -153,6 +175,29 @@ interface UpdateAppStatusResponse {
     message: string;
     updatedAt: string;
 }
+interface ListProvidersResponse {
+    providers: string[];
+    total: number;
+}
+interface GetConnectionStatusParams {
+    userId: string;
+    appName: string;
+    provider?: ProviderType;
+}
+interface GetUserConnectionsParams {
+    userId: string;
+    provider?: ProviderType;
+    appFilter?: string;
+}
+interface CheckAppEnabledParams {
+    appName: string;
+    provider?: ProviderType;
+}
+interface UpdateAppStatusParams {
+    appName: string;
+    enabled: boolean;
+    provider?: ProviderType;
+}
 
 type MCPTransport = 'stdio' | 'streamable_http' | 'sse';
 type MCPScope = 'tenant' | 'user';
@@ -270,6 +315,7 @@ interface AgentConfig {
     useCognitiveTools?: boolean;
     enableTaskValidation?: boolean;
     generateComprehensiveOutput?: boolean;
+    skillIds?: string[];
 }
 interface ModelOverrides {
     [key: string]: string;
@@ -385,6 +431,107 @@ interface FeedbackListResponse {
     note: string;
 }
 
+interface SkillGuidelineBase {
+    name: string;
+    description: string;
+    content: string;
+    category?: string;
+    version: string;
+}
+interface SkillGuidelineCreate extends SkillGuidelineBase {
+}
+interface SkillGuidelineUpdate {
+    name?: string;
+    description?: string;
+    content?: string;
+    category?: string;
+    version?: string;
+    isActive?: boolean;
+}
+interface SkillGuidelineResponse extends SkillGuidelineBase {
+    id: string;
+    tenantId?: string;
+    userId?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SkillGuidelineListResponse {
+    skills: SkillGuidelineResponse[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+interface SkillUsageBase {
+    responseId: string;
+    skillId: string;
+    skillName: string;
+}
+interface SkillUsageCreate extends SkillUsageBase {
+    tenantId: string;
+    userId?: string;
+    relevanceScore?: number;
+}
+interface SkillUsageUpdate {
+    plannerSelected?: boolean;
+    usageReasoning?: string;
+    priority?: number;
+    executionOutcome?: 'success' | 'partial' | 'failed' | 'cancelled' | 'not_executed';
+    effectivenessScore?: number;
+    feedbackNotes?: string;
+}
+interface SkillUsageResponse extends SkillUsageBase {
+    id: string;
+    tenantId: string;
+    userId?: string;
+    relevanceScore?: number;
+    retrievedAt?: string;
+    plannerSelected: boolean;
+    usageReasoning?: string;
+    priority?: number;
+    selectedAt?: string;
+    executionOutcome?: string;
+    effectivenessScore?: number;
+    feedbackNotes?: string;
+    executedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SkillUsageListResponse {
+    usages: SkillUsageResponse[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+interface SkillEffectivenessMetrics {
+    skillId?: string;
+    totalRetrievals: number;
+    totalSelections: number;
+    successfulExecutions: number;
+    selectionRate: number;
+    successRate: number;
+    avgEffectiveness: number;
+    usageFrequency: number;
+}
+interface SkillAnalyticsRequest {
+    skillId?: string;
+    tenantId?: string;
+    daysBack?: number;
+}
+interface SelectedSkill {
+    skillId: string;
+    skillName: string;
+    relevanceScore: number;
+    usageReasoning: string;
+    priority: number;
+}
+interface SkillRetrievalMetadata {
+    skillId: string;
+    skillName: string;
+    relevanceScore: number;
+    content: string;
+}
+
 interface ThreadObject {
     threadId: UUID;
     tenantId: UUID;
@@ -722,11 +869,11 @@ declare class IntegrationsResource {
     /**
      * Check the status of a specific connection
      */
-    getConnectionStatus(userId: string, appName: string): Promise<ConnectionStatusResponse>;
+    getConnectionStatus(params: GetConnectionStatusParams): Promise<ConnectionStatusResponse>;
     /**
      * Get all connections for a user
      */
-    getUserConnections(userId: string, appFilter?: string): Promise<UserConnectionsResponse>;
+    getUserConnections(params: GetUserConnectionsParams): Promise<UserConnectionsResponse>;
     /**
      * Get available tools for a user based on connections
      */
@@ -744,25 +891,32 @@ declare class IntegrationsResource {
      */
     listApps(params?: {
         includeAvailable?: boolean;
+        provider?: string;
     }): Promise<AppsListResponse>;
+    /**
+     * List available integration providers
+     */
+    listProviders(): Promise<ListProvidersResponse>;
     /**
      * Check if a specific app is enabled
      */
-    checkAppEnabled(appName: string): Promise<AppEnabledResponse>;
+    checkAppEnabled(params: CheckAppEnabledParams): Promise<AppEnabledResponse>;
     /**
      * Enable or disable an app for the tenant
      */
-    updateAppStatus(appName: string, enabled: boolean): Promise<UpdateAppStatusResponse>;
+    updateAppStatus(params: UpdateAppStatusParams): Promise<UpdateAppStatusResponse>;
     /**
      * Get required fields for non-OAuth authentication (future)
      */
     getNonOAuthRequiredFields(appName: string, authScheme: string): Promise<any>;
-    isAppEnabled(appName: string): Promise<AppEnabledResponse>;
+    isAppEnabled(appName: string, provider?: string): Promise<AppEnabledResponse>;
     setAppEnabled(appName: string, data: {
         enabled: boolean;
+        provider?: string;
     }): Promise<UpdateAppStatusResponse>;
     listConnections(userId: string, params?: {
         appFilter?: string;
+        provider?: string;
     }): Promise<UserConnectionsResponse>;
 }
 
@@ -910,6 +1064,80 @@ declare class ResponsesResource {
     }): Promise<FeedbackListResponse>;
 }
 
+declare class SkillsResource {
+    private readonly http;
+    constructor(http: Http);
+    /**
+     * Create a new skill guideline
+     * @param skillData - Skill guideline data
+     * @param options - Optional parameters
+     * @param options.userId - Optional user ID for skill ownership
+     */
+    create(skillData: SkillGuidelineCreate, options?: {
+        userId?: string;
+    }): Promise<SkillGuidelineResponse>;
+    /**
+     * List skill guidelines with optional filtering
+     * @param params - Optional filter parameters
+     * @param params.category - Filter by skill category
+     * @param params.isActive - Filter by active status
+     * @param params.page - Page number for pagination
+     * @param params.pageSize - Number of items per page
+     */
+    list(params?: {
+        category?: string;
+        isActive?: boolean;
+        page?: number;
+        pageSize?: number;
+    }): Promise<SkillGuidelineListResponse>;
+    /**
+     * Get a skill guideline by ID
+     * @param skillId - The skill ID
+     */
+    get(skillId: string): Promise<SkillGuidelineResponse>;
+    /**
+     * Update a skill guideline
+     * @param skillId - The skill ID
+     * @param updates - Fields to update
+     */
+    update(skillId: string, updates: SkillGuidelineUpdate): Promise<SkillGuidelineResponse>;
+    /**
+     * Delete a skill guideline
+     * @param skillId - The skill ID
+     */
+    delete(skillId: string): Promise<void>;
+    /**
+     * Create a skill usage record
+     * @param usageData - Skill usage data
+     */
+    createUsage(usageData: SkillUsageCreate): Promise<SkillUsageResponse>;
+    /**
+     * List skill usage records
+     * @param params - Optional filter parameters
+     * @param params.skillId - Filter by skill ID
+     * @param params.responseId - Filter by response ID
+     * @param params.page - Page number for pagination
+     * @param params.pageSize - Number of items per page
+     */
+    listUsage(params?: {
+        skillId?: string;
+        responseId?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<SkillUsageListResponse>;
+    /**
+     * Update a skill usage record
+     * @param usageId - The usage record ID
+     * @param updates - Fields to update
+     */
+    updateUsage(usageId: string, updates: SkillUsageUpdate): Promise<SkillUsageResponse>;
+    /**
+     * Get skill effectiveness metrics
+     * @param request - Analytics request parameters
+     */
+    getAnalytics(request?: SkillAnalyticsRequest): Promise<SkillEffectivenessMetrics>;
+}
+
 declare class TenantInfoResource {
     private readonly http;
     constructor(http: Http);
@@ -1024,6 +1252,7 @@ declare class LumnisClient {
     readonly integrations: IntegrationsResource;
     readonly modelPreferences: ModelPreferencesResource;
     readonly mcpServers: MCPServersResource;
+    readonly skills: SkillsResource;
     private readonly _scopedUserId?;
     private readonly _defaultScope;
     constructor(options?: LumnisClientOptions);
@@ -1070,6 +1299,13 @@ declare class LumnisClient {
     deleteMcpServer(serverId: string): Promise<void>;
     listMcpServerTools(serverId: string): Promise<MCPToolListResponse>;
     testMcpServer(serverId: string): Promise<TestConnectionResponse>;
+    createSkill(skillData: SkillGuidelineCreate, options?: {
+        userId?: string;
+    }): Promise<SkillGuidelineResponse>;
+    getSkill(skillId: string): Promise<SkillGuidelineResponse>;
+    listSkills(params?: Parameters<SkillsResource['list']>[0]): Promise<SkillGuidelineListResponse>;
+    updateSkill(skillId: string, updates: SkillGuidelineUpdate): Promise<SkillGuidelineResponse>;
+    deleteSkill(skillId: string): Promise<void>;
 }
 
 interface LumnisErrorOptions {
@@ -1158,4 +1394,4 @@ declare class ProgressTracker {
     reset(): void;
 }
 
-export { type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, type ChunkingStrategy, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ContentType, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DisconnectRequest, type DisconnectResponse, type DuplicateHandling, type Email, type ErrorResponse, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type GetToolsRequest, type GetToolsResponse, type InitiateConnectionRequest, type InitiateConnectionResponse, IntegrationsResource, InternalServerError, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type Message, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NotFoundError, type PaginationInfo, type PaginationParams, type Plan, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type Scope, type StoreApiKeyRequest, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type UUID, type UpdateAppStatusResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, LumnisClient as default, displayProgress, formatProgressEntry };
+export { type AgentConfig, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BillingStatus, type BulkDeleteRequest, type BulkDeleteResponse, type BulkUploadResponse, type CancelResponseResponse, type CheckAppEnabledParams, type ChunkingStrategy, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ContentType, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type DatabaseStatus, type DeleteApiKeyResponse, type DisconnectRequest, type DisconnectResponse, type DuplicateHandling, type Email, type ErrorResponse, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type GetConnectionStatusParams, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InitiateConnectionRequest, type InitiateConnectionResponse, IntegrationsResource, InternalServerError, type ListProvidersResponse, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type Message, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NotFoundError, type PaginationInfo, type PaginationParams, type Plan, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, ProviderType, RateLimitError, type RateLimitErrorOptions, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, type Scope, type SelectedSkill, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type StoreApiKeyRequest, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type UUID, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, ValidationError, LumnisClient as default, displayProgress, formatProgressEntry };