lumnisai 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -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 {
@@ -1159,4 +1395,4 @@ declare class ProgressTracker {
 }
 
 export = LumnisClient;
-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, 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, displayProgress, formatProgressEntry };

package/dist/index.mjs

@@ -202,19 +202,27 @@ class IntegrationsResource {
   /**
    * Check the status of a specific connection
    */
-  async getConnectionStatus(userId, appName) {
+  async getConnectionStatus(params) {
+    const { userId, appName, provider } = params;
+    const queryParams = new URLSearchParams();
+    if (provider)
+      queryParams.append("provider", provider);
+    const query = queryParams.toString() ? `?${queryParams.toString()}` : "";
     return this.http.get(
-      `/integrations/connections/${encodeURIComponent(userId)}/${appName.toUpperCase()}`
+      `/integrations/connections/${encodeURIComponent(userId)}/${appName.toUpperCase()}${query}`
     );
   }
   /**
    * Get all connections for a user
    */
-  async getUserConnections(userId, appFilter) {
-    const params = new URLSearchParams();
+  async getUserConnections(params) {
+    const { userId, provider, appFilter } = params;
+    const queryParams = new URLSearchParams();
+    if (provider)
+      queryParams.append("provider", provider);
     if (appFilter)
-      params.append("app_filter", appFilter);
-    const query = params.toString() ? `?${params.toString()}` : "";
+      queryParams.append("app_filter", appFilter);
+    const query = queryParams.toString() ? `?${queryParams.toString()}` : "";
     return this.http.get(
       `/integrations/connections/${encodeURIComponent(userId)}${query}`
     );
@@ -252,23 +260,41 @@ class IntegrationsResource {
     const urlParams = new URLSearchParams();
     if (params?.includeAvailable)
       urlParams.append("include_available", "true");
+    if (params?.provider)
+      urlParams.append("provider", params.provider);
     const query = urlParams.toString() ? `?${urlParams.toString()}` : "";
     return this.http.get(`/integrations/apps${query}`);
   }
+  /**
+   * List available integration providers
+   */
+  async listProviders() {
+    return this.http.get("/integrations/providers");
+  }
   /**
    * Check if a specific app is enabled
    */
-  async checkAppEnabled(appName) {
+  async checkAppEnabled(params) {
+    const { appName, provider } = params;
+    const queryParams = new URLSearchParams();
+    if (provider)
+      queryParams.append("provider", provider);
+    const query = queryParams.toString() ? `?${queryParams.toString()}` : "";
     return this.http.get(
-      `/integrations/apps/${appName.toUpperCase()}/enabled`
+      `/integrations/apps/${appName.toUpperCase()}/enabled${query}`
     );
   }
   /**
    * Enable or disable an app for the tenant
    */
-  async updateAppStatus(appName, enabled) {
+  async updateAppStatus(params) {
+    const { appName, enabled, provider } = params;
+    const queryParams = new URLSearchParams();
+    queryParams.append("enabled", String(enabled));
+    if (provider)
+      queryParams.append("provider", provider);
     return this.http.put(
-      `/integrations/apps/${appName.toUpperCase()}?enabled=${enabled}`
+      `/integrations/apps/${appName.toUpperCase()}?${queryParams.toString()}`
     );
   }
   /**
@@ -281,14 +307,14 @@ class IntegrationsResource {
     );
   }
   // Aliases for backward compatibility with client methods
-  async isAppEnabled(appName) {
-    return this.checkAppEnabled(appName);
+  async isAppEnabled(appName, provider) {
+    return this.checkAppEnabled({ appName, provider });
   }
   async setAppEnabled(appName, data) {
-    return this.updateAppStatus(appName, data.enabled);
+    return this.updateAppStatus({ appName, enabled: data.enabled, provider: data.provider });
   }
   async listConnections(userId, params) {
-    return this.getUserConnections(userId, params?.appFilter);
+    return this.getUserConnections({ userId, appFilter: params?.appFilter, provider: params?.provider });
   }
 }
 
@@ -577,6 +603,116 @@ class ResponsesResource {
   }
 }
 
+class SkillsResource {
+  constructor(http) {
+    this.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
+   */
+  async create(skillData, options) {
+    const params = {};
+    if (options?.userId) {
+      params.user_id = options.userId;
+    }
+    return this.http.post("/skills", skillData, { params });
+  }
+  /**
+   * 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
+   */
+  async list(params) {
+    const queryParams = {};
+    if (params?.category)
+      queryParams.category = params.category;
+    if (params?.isActive !== void 0)
+      queryParams.is_active = params.isActive;
+    if (params?.page)
+      queryParams.page = params.page;
+    if (params?.pageSize)
+      queryParams.page_size = params.pageSize;
+    return this.http.get("/skills", { params: queryParams });
+  }
+  /**
+   * Get a skill guideline by ID
+   * @param skillId - The skill ID
+   */
+  async get(skillId) {
+    return this.http.get(`/skills/${skillId}`);
+  }
+  /**
+   * Update a skill guideline
+   * @param skillId - The skill ID
+   * @param updates - Fields to update
+   */
+  async update(skillId, updates) {
+    return this.http.put(`/skills/${skillId}`, updates);
+  }
+  /**
+   * Delete a skill guideline
+   * @param skillId - The skill ID
+   */
+  async delete(skillId) {
+    await this.http.delete(`/skills/${skillId}`);
+  }
+  /**
+   * Create a skill usage record
+   * @param usageData - Skill usage data
+   */
+  async createUsage(usageData) {
+    return this.http.post("/skills/usage", usageData);
+  }
+  /**
+   * 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
+   */
+  async listUsage(params) {
+    const queryParams = {};
+    if (params?.skillId)
+      queryParams.skill_id = params.skillId;
+    if (params?.responseId)
+      queryParams.response_id = params.responseId;
+    if (params?.page)
+      queryParams.page = params.page;
+    if (params?.pageSize)
+      queryParams.page_size = params.pageSize;
+    return this.http.get("/skills/usage", { params: queryParams });
+  }
+  /**
+   * Update a skill usage record
+   * @param usageId - The usage record ID
+   * @param updates - Fields to update
+   */
+  async updateUsage(usageId, updates) {
+    return this.http.put(`/skills/usage/${usageId}`, updates);
+  }
+  /**
+   * Get skill effectiveness metrics
+   * @param request - Analytics request parameters
+   */
+  async getAnalytics(request) {
+    const queryParams = {};
+    if (request?.skillId)
+      queryParams.skill_id = request.skillId;
+    if (request?.tenantId)
+      queryParams.tenant_id = request.tenantId;
+    if (request?.daysBack)
+      queryParams.days_back = request.daysBack;
+    return this.http.get("/skills/analytics", { params: queryParams });
+  }
+}
+
 class TenantInfoResource {
   constructor(http) {
     this.http = http;
@@ -875,6 +1011,7 @@ class LumnisClient {
   integrations;
   modelPreferences;
   mcpServers;
+  skills;
   _scopedUserId;
   _defaultScope;
   constructor(options = {}) {
@@ -904,6 +1041,7 @@ class LumnisClient {
     this.integrations = new IntegrationsResource(this.http);
     this.modelPreferences = new ModelPreferencesResource(this.http);
     this.mcpServers = new MCPServersResource(this.http);
+    this.skills = new SkillsResource(this.http);
   }
   forUser(userId) {
     return new LumnisClient({
@@ -1081,7 +1219,7 @@ class LumnisClient {
     return this.integrations.initiateConnection(params);
   }
   async getConnectionStatus(userId, appName) {
-    return this.integrations.getConnectionStatus(userId, appName);
+    return this.integrations.getConnectionStatus({ userId, appName });
   }
   async listConnections(userId, params) {
     return this.integrations.listConnections(userId, params);
@@ -1118,6 +1256,22 @@ class LumnisClient {
   async testMcpServer(serverId) {
     return this.mcpServers.testConnection(serverId);
   }
+  // Skills methods
+  async createSkill(skillData, options) {
+    return this.skills.create(skillData, options);
+  }
+  async getSkill(skillId) {
+    return this.skills.get(skillId);
+  }
+  async listSkills(params) {
+    return this.skills.list(params);
+  }
+  async updateSkill(skillId, updates) {
+    return this.skills.update(skillId, updates);
+  }
+  async deleteSkill(skillId) {
+    return this.skills.delete(skillId);
+  }
 }
 function createSimpleProgressCallback() {
   let lastStatus;
@@ -1158,6 +1312,15 @@ function createSimpleProgressCallback() {
   };
 }
 
+var ProviderType = /* @__PURE__ */ ((ProviderType2) => {
+  ProviderType2["COMPOSIO"] = "composio";
+  ProviderType2["UNIPILE"] = "unipile";
+  ProviderType2["NANGO"] = "nango";
+  ProviderType2["ARCADE"] = "arcade";
+  ProviderType2["MERGE"] = "merge";
+  return ProviderType2;
+})(ProviderType || {});
+
 function displayProgress(update, indent = "	") {
   if (update.state === "tool_update") {
     if (update.toolCalls && update.toolCalls.length > 0) {
@@ -1253,4 +1416,4 @@ class ProgressTracker {
   }
 }
 
-export { AuthenticationError, InternalServerError, LocalFileNotSupportedError, LumnisClient, LumnisError, NotFoundError, ProgressTracker, RateLimitError, ValidationError, LumnisClient as default, displayProgress, formatProgressEntry };
+export { AuthenticationError, InternalServerError, LocalFileNotSupportedError, LumnisClient, LumnisError, NotFoundError, ProgressTracker, ProviderType, RateLimitError, ValidationError, LumnisClient as default, displayProgress, formatProgressEntry };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lumnisai",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Official Node.js SDK for the Lumnis AI API",
   "author": "Lumnis AI",
   "license": "MIT",
@@ -66,6 +66,7 @@
     "release": "bumpp && pnpm publish",
     "start": "tsx src/index.ts",
     "test": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "example:skills": "tsx examples/skills-example.ts"
   }
 }