@iblai/iblai-api 4.338.0-ai → 4.338.1-ai

package/dist/index.cjs.js

@@ -110,7 +110,7 @@ class CancelablePromise {
 
 const OpenAPI = {
   BASE: 'https://base.manager.iblai.app',
-  VERSION: '4.338.0-ai-plus',
+  VERSION: '4.338.1-ai-plus',
   WITH_CREDENTIALS: false,
   CREDENTIALS: 'include',
   TOKEN: undefined,
@@ -9992,7 +9992,7 @@ class AiAnalyticsService {
    *
    * **Platform & Mentor Filtered:**
    * ```
-   * # Get total costs for a specific platform and mentor
+   * # Get total costs for a specific platform and agent
    * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
    * ```
    *
@@ -10089,7 +10089,7 @@ class AiAnalyticsService {
    * **Shared optional filters**
    * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
    * - platform_key           – tenant isolation
-   * - mentor_unique_id       – filter to one mentor
+   * - mentor_unique_id       – filter to one agent
    * - username               – filter to a learner
    * - provider / llm_model   – filter to LLM provider / model
    * - all_time               – true → lifetime totals
@@ -10200,14 +10200,14 @@ class AiAnalyticsService {
    * - Flexible filtering by username and/or platform_key
    * - Essential metrics: total cost, sessions, usage period
    * - Provider breakdown (OpenAI, Anthropic, etc.)
-   * - Top mentors/actions by cost
+   * - Top agents/actions by cost
    * - Clean, invoice-ready format
    *
    * **Query Parameters:**
    * - username: Filter by specific username (optional)
    * - platform_key: Filter by platform (optional, but required for platform admins)
    * - start_date, end_date: billing period (defaults to last 30 days)
-   * - include_breakdown: show provider/mentor details (default: true)
+   * - include_breakdown: show provider/agent details (default: true)
    *
    * **Permission Logic:**
    * - Platform admins: Must include platform_key matching their permission scope
@@ -10688,7 +10688,7 @@ class AiAnalyticsService {
    * - Day of week patterns (0=Sunday through 6=Saturday)
    * - Hour of day activity levels (0-23)
    * - Flexible date range filtering
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Message count aggregation
    *
    * **Data Structure:**
@@ -10768,7 +10768,7 @@ class AiAnalyticsService {
     });
   }
   /**
-   * Returns topics overview analytics for a given platform and mentor.
+   * Returns topics overview analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -10802,7 +10802,7 @@ class AiAnalyticsService {
     });
   }
   /**
-   * Returns topic details Analytics for a given platform and mentor.
+   * Returns topic details Analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -10919,7 +10919,7 @@ class AiAnalyticsService {
    * - Real-time active user counting
    * - Percentage change calculations vs previous periods
    * - Flexible date filtering and granularity
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Forward-filled time series data
    *
    * **Supported Metrics:**
@@ -10974,10 +10974,10 @@ class AiAnalyticsService {
    * **Key Features:**
    * - Full-text search across username, email, name, and user ID
    * - Date range filtering for activity periods
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Comprehensive pagination with metadata
    * - CSV export for data analysis
-   * - User aggregation across platforms/mentors
+   * - User aggregation across platforms/agents
    *
    * **Search Capabilities:**
    * - Username matching
@@ -25326,7 +25326,7 @@ class AnalyticsService {
    *
    * **Platform & Mentor Filtered:**
    * ```
-   * # Get total costs for a specific platform and mentor
+   * # Get total costs for a specific platform and agent
    * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
    * ```
    *
@@ -25423,7 +25423,7 @@ class AnalyticsService {
    * **Shared optional filters**
    * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
    * - platform_key           – tenant isolation
-   * - mentor_unique_id       – filter to one mentor
+   * - mentor_unique_id       – filter to one agent
    * - username               – filter to a learner
    * - provider / llm_model   – filter to LLM provider / model
    * - all_time               – true → lifetime totals
@@ -25534,14 +25534,14 @@ class AnalyticsService {
    * - Flexible filtering by username and/or platform_key
    * - Essential metrics: total cost, sessions, usage period
    * - Provider breakdown (OpenAI, Anthropic, etc.)
-   * - Top mentors/actions by cost
+   * - Top agents/actions by cost
    * - Clean, invoice-ready format
    *
    * **Query Parameters:**
    * - username: Filter by specific username (optional)
    * - platform_key: Filter by platform (optional, but required for platform admins)
    * - start_date, end_date: billing period (defaults to last 30 days)
-   * - include_breakdown: show provider/mentor details (default: true)
+   * - include_breakdown: show provider/agent details (default: true)
    *
    * **Permission Logic:**
    * - Platform admins: Must include platform_key matching their permission scope
@@ -25910,7 +25910,7 @@ class AnalyticsService {
    * - Day of week patterns (0=Sunday through 6=Saturday)
    * - Hour of day activity levels (0-23)
    * - Flexible date range filtering
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Message count aggregation
    *
    * **Data Structure:**
@@ -25950,7 +25950,7 @@ class AnalyticsService {
     });
   }
   /**
-   * Returns topics overview analytics for a given platform and mentor.
+   * Returns topics overview analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -25984,7 +25984,7 @@ class AnalyticsService {
     });
   }
   /**
-   * Returns topic details Analytics for a given platform and mentor.
+   * Returns topic details Analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -26033,7 +26033,7 @@ class AnalyticsService {
    * - Real-time active user counting
    * - Percentage change calculations vs previous periods
    * - Flexible date filtering and granularity
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Forward-filled time series data
    *
    * **Supported Metrics:**
@@ -26088,10 +26088,10 @@ class AnalyticsService {
    * **Key Features:**
    * - Full-text search across username, email, name, and user ID
    * - Date range filtering for activity periods
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Comprehensive pagination with metadata
    * - CSV export for data analysis
-   * - User aggregation across platforms/mentors
+   * - User aggregation across platforms/agents
    *
    * **Search Capabilities:**
    * - Username matching

package/dist/index.esm.js

@@ -108,7 +108,7 @@ class CancelablePromise {
 
 const OpenAPI = {
   BASE: 'https://base.manager.iblai.app',
-  VERSION: '4.338.0-ai-plus',
+  VERSION: '4.338.1-ai-plus',
   WITH_CREDENTIALS: false,
   CREDENTIALS: 'include',
   TOKEN: undefined,
@@ -9990,7 +9990,7 @@ class AiAnalyticsService {
    *
    * **Platform & Mentor Filtered:**
    * ```
-   * # Get total costs for a specific platform and mentor
+   * # Get total costs for a specific platform and agent
    * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
    * ```
    *
@@ -10087,7 +10087,7 @@ class AiAnalyticsService {
    * **Shared optional filters**
    * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
    * - platform_key           – tenant isolation
-   * - mentor_unique_id       – filter to one mentor
+   * - mentor_unique_id       – filter to one agent
    * - username               – filter to a learner
    * - provider / llm_model   – filter to LLM provider / model
    * - all_time               – true → lifetime totals
@@ -10198,14 +10198,14 @@ class AiAnalyticsService {
    * - Flexible filtering by username and/or platform_key
    * - Essential metrics: total cost, sessions, usage period
    * - Provider breakdown (OpenAI, Anthropic, etc.)
-   * - Top mentors/actions by cost
+   * - Top agents/actions by cost
    * - Clean, invoice-ready format
    *
    * **Query Parameters:**
    * - username: Filter by specific username (optional)
    * - platform_key: Filter by platform (optional, but required for platform admins)
    * - start_date, end_date: billing period (defaults to last 30 days)
-   * - include_breakdown: show provider/mentor details (default: true)
+   * - include_breakdown: show provider/agent details (default: true)
    *
    * **Permission Logic:**
    * - Platform admins: Must include platform_key matching their permission scope
@@ -10686,7 +10686,7 @@ class AiAnalyticsService {
    * - Day of week patterns (0=Sunday through 6=Saturday)
    * - Hour of day activity levels (0-23)
    * - Flexible date range filtering
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Message count aggregation
    *
    * **Data Structure:**
@@ -10766,7 +10766,7 @@ class AiAnalyticsService {
     });
   }
   /**
-   * Returns topics overview analytics for a given platform and mentor.
+   * Returns topics overview analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -10800,7 +10800,7 @@ class AiAnalyticsService {
     });
   }
   /**
-   * Returns topic details Analytics for a given platform and mentor.
+   * Returns topic details Analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -10917,7 +10917,7 @@ class AiAnalyticsService {
    * - Real-time active user counting
    * - Percentage change calculations vs previous periods
    * - Flexible date filtering and granularity
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Forward-filled time series data
    *
    * **Supported Metrics:**
@@ -10972,10 +10972,10 @@ class AiAnalyticsService {
    * **Key Features:**
    * - Full-text search across username, email, name, and user ID
    * - Date range filtering for activity periods
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Comprehensive pagination with metadata
    * - CSV export for data analysis
-   * - User aggregation across platforms/mentors
+   * - User aggregation across platforms/agents
    *
    * **Search Capabilities:**
    * - Username matching
@@ -25324,7 +25324,7 @@ class AnalyticsService {
    *
    * **Platform & Mentor Filtered:**
    * ```
-   * # Get total costs for a specific platform and mentor
+   * # Get total costs for a specific platform and agent
    * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
    * ```
    *
@@ -25421,7 +25421,7 @@ class AnalyticsService {
    * **Shared optional filters**
    * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
    * - platform_key           – tenant isolation
-   * - mentor_unique_id       – filter to one mentor
+   * - mentor_unique_id       – filter to one agent
    * - username               – filter to a learner
    * - provider / llm_model   – filter to LLM provider / model
    * - all_time               – true → lifetime totals
@@ -25532,14 +25532,14 @@ class AnalyticsService {
    * - Flexible filtering by username and/or platform_key
    * - Essential metrics: total cost, sessions, usage period
    * - Provider breakdown (OpenAI, Anthropic, etc.)
-   * - Top mentors/actions by cost
+   * - Top agents/actions by cost
    * - Clean, invoice-ready format
    *
    * **Query Parameters:**
    * - username: Filter by specific username (optional)
    * - platform_key: Filter by platform (optional, but required for platform admins)
    * - start_date, end_date: billing period (defaults to last 30 days)
-   * - include_breakdown: show provider/mentor details (default: true)
+   * - include_breakdown: show provider/agent details (default: true)
    *
    * **Permission Logic:**
    * - Platform admins: Must include platform_key matching their permission scope
@@ -25908,7 +25908,7 @@ class AnalyticsService {
    * - Day of week patterns (0=Sunday through 6=Saturday)
    * - Hour of day activity levels (0-23)
    * - Flexible date range filtering
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Message count aggregation
    *
    * **Data Structure:**
@@ -25948,7 +25948,7 @@ class AnalyticsService {
     });
   }
   /**
-   * Returns topics overview analytics for a given platform and mentor.
+   * Returns topics overview analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -25982,7 +25982,7 @@ class AnalyticsService {
     });
   }
   /**
-   * Returns topic details Analytics for a given platform and mentor.
+   * Returns topic details Analytics for a given platform and agent.
    *
    * Permission Required:
    * - Platform Admin
@@ -26031,7 +26031,7 @@ class AnalyticsService {
    * - Real-time active user counting
    * - Percentage change calculations vs previous periods
    * - Flexible date filtering and granularity
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Forward-filled time series data
    *
    * **Supported Metrics:**
@@ -26086,10 +26086,10 @@ class AnalyticsService {
    * **Key Features:**
    * - Full-text search across username, email, name, and user ID
    * - Date range filtering for activity periods
-   * - Platform and mentor-specific filtering
+   * - Platform and agent-specific filtering
    * - Comprehensive pagination with metadata
    * - CSV export for data analysis
-   * - User aggregation across platforms/mentors
+   * - User aggregation across platforms/agents
    *
    * **Search Capabilities:**
    * - Username matching

package/dist/index.umd.js

@@ -114,7 +114,7 @@
 
     const OpenAPI = {
       BASE: 'https://base.manager.iblai.app',
-      VERSION: '4.338.0-ai-plus',
+      VERSION: '4.338.1-ai-plus',
       WITH_CREDENTIALS: false,
       CREDENTIALS: 'include',
       TOKEN: undefined,
@@ -9996,7 +9996,7 @@
        *
        * **Platform & Mentor Filtered:**
        * ```
-       * # Get total costs for a specific platform and mentor
+       * # Get total costs for a specific platform and agent
        * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
        * ```
        *
@@ -10093,7 +10093,7 @@
        * **Shared optional filters**
        * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
        * - platform_key           – tenant isolation
-       * - mentor_unique_id       – filter to one mentor
+       * - mentor_unique_id       – filter to one agent
        * - username               – filter to a learner
        * - provider / llm_model   – filter to LLM provider / model
        * - all_time               – true → lifetime totals
@@ -10204,14 +10204,14 @@
        * - Flexible filtering by username and/or platform_key
        * - Essential metrics: total cost, sessions, usage period
        * - Provider breakdown (OpenAI, Anthropic, etc.)
-       * - Top mentors/actions by cost
+       * - Top agents/actions by cost
        * - Clean, invoice-ready format
        *
        * **Query Parameters:**
        * - username: Filter by specific username (optional)
        * - platform_key: Filter by platform (optional, but required for platform admins)
        * - start_date, end_date: billing period (defaults to last 30 days)
-       * - include_breakdown: show provider/mentor details (default: true)
+       * - include_breakdown: show provider/agent details (default: true)
        *
        * **Permission Logic:**
        * - Platform admins: Must include platform_key matching their permission scope
@@ -10692,7 +10692,7 @@
        * - Day of week patterns (0=Sunday through 6=Saturday)
        * - Hour of day activity levels (0-23)
        * - Flexible date range filtering
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Message count aggregation
        *
        * **Data Structure:**
@@ -10772,7 +10772,7 @@
         });
       }
       /**
-       * Returns topics overview analytics for a given platform and mentor.
+       * Returns topics overview analytics for a given platform and agent.
        *
        * Permission Required:
        * - Platform Admin
@@ -10806,7 +10806,7 @@
         });
       }
       /**
-       * Returns topic details Analytics for a given platform and mentor.
+       * Returns topic details Analytics for a given platform and agent.
        *
        * Permission Required:
        * - Platform Admin
@@ -10923,7 +10923,7 @@
        * - Real-time active user counting
        * - Percentage change calculations vs previous periods
        * - Flexible date filtering and granularity
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Forward-filled time series data
        *
        * **Supported Metrics:**
@@ -10978,10 +10978,10 @@
        * **Key Features:**
        * - Full-text search across username, email, name, and user ID
        * - Date range filtering for activity periods
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Comprehensive pagination with metadata
        * - CSV export for data analysis
-       * - User aggregation across platforms/mentors
+       * - User aggregation across platforms/agents
        *
        * **Search Capabilities:**
        * - Username matching
@@ -25330,7 +25330,7 @@
        *
        * **Platform & Mentor Filtered:**
        * ```
-       * # Get total costs for a specific platform and mentor
+       * # Get total costs for a specific platform and agent
        * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
        * ```
        *
@@ -25427,7 +25427,7 @@
        * **Shared optional filters**
        * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
        * - platform_key           – tenant isolation
-       * - mentor_unique_id       – filter to one mentor
+       * - mentor_unique_id       – filter to one agent
        * - username               – filter to a learner
        * - provider / llm_model   – filter to LLM provider / model
        * - all_time               – true → lifetime totals
@@ -25538,14 +25538,14 @@
        * - Flexible filtering by username and/or platform_key
        * - Essential metrics: total cost, sessions, usage period
        * - Provider breakdown (OpenAI, Anthropic, etc.)
-       * - Top mentors/actions by cost
+       * - Top agents/actions by cost
        * - Clean, invoice-ready format
        *
        * **Query Parameters:**
        * - username: Filter by specific username (optional)
        * - platform_key: Filter by platform (optional, but required for platform admins)
        * - start_date, end_date: billing period (defaults to last 30 days)
-       * - include_breakdown: show provider/mentor details (default: true)
+       * - include_breakdown: show provider/agent details (default: true)
        *
        * **Permission Logic:**
        * - Platform admins: Must include platform_key matching their permission scope
@@ -25914,7 +25914,7 @@
        * - Day of week patterns (0=Sunday through 6=Saturday)
        * - Hour of day activity levels (0-23)
        * - Flexible date range filtering
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Message count aggregation
        *
        * **Data Structure:**
@@ -25954,7 +25954,7 @@
         });
       }
       /**
-       * Returns topics overview analytics for a given platform and mentor.
+       * Returns topics overview analytics for a given platform and agent.
        *
        * Permission Required:
        * - Platform Admin
@@ -25988,7 +25988,7 @@
         });
       }
       /**
-       * Returns topic details Analytics for a given platform and mentor.
+       * Returns topic details Analytics for a given platform and agent.
        *
        * Permission Required:
        * - Platform Admin
@@ -26037,7 +26037,7 @@
        * - Real-time active user counting
        * - Percentage change calculations vs previous periods
        * - Flexible date filtering and granularity
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Forward-filled time series data
        *
        * **Supported Metrics:**
@@ -26092,10 +26092,10 @@
        * **Key Features:**
        * - Full-text search across username, email, name, and user ID
        * - Date range filtering for activity periods
-       * - Platform and mentor-specific filtering
+       * - Platform and agent-specific filtering
        * - Comprehensive pagination with metadata
        * - CSV export for data analysis
-       * - User aggregation across platforms/mentors
+       * - User aggregation across platforms/agents
        *
        * **Search Capabilities:**
        * - Username matching

package/dist/types/models/MentorBreakdown.d.ts

@@ -1,5 +1,5 @@
 /**
- * Mentor cost breakdown.
+ * Agent cost breakdown.
  */
 export type MentorBreakdown = {
     mentor: string;

package/dist/types/models/NotificationTemplateDetail.d.ts

@@ -130,7 +130,7 @@ export type NotificationTemplateDetail = {
      */
     readonly available_context: string;
     /**
-     * Default prompt message for AI mentor notifications
+     * Default prompt message for AI agent notifications
      */
     proactive_prompt_message?: string | null;
     /**
@@ -174,7 +174,7 @@ export type NotificationTemplateDetail = {
      */
     periodic_timezone?: string;
     /**
-     * List of mentor configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
+     * List of agent configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
      */
     periodic_mentors?: Array<Record<string, any>>;
     /**

package/dist/types/models/PatchedNotificationTemplateDetail.d.ts

@@ -130,7 +130,7 @@ export type PatchedNotificationTemplateDetail = {
      */
     readonly available_context?: string;
     /**
-     * Default prompt message for AI mentor notifications
+     * Default prompt message for AI agent notifications
      */
     proactive_prompt_message?: string | null;
     /**
@@ -174,7 +174,7 @@ export type PatchedNotificationTemplateDetail = {
      */
     periodic_timezone?: string;
     /**
-     * List of mentor configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
+     * List of agent configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
      */
     periodic_mentors?: Array<Record<string, any>>;
     /**

package/dist/types/services/AiAnalyticsService.d.ts

@@ -4496,7 +4496,7 @@ export declare class AiAnalyticsService {
      *
      * **Platform & Mentor Filtered:**
      * ```
-     * # Get total costs for a specific platform and mentor
+     * # Get total costs for a specific platform and agent
      * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
      * ```
      *
@@ -4620,7 +4620,7 @@ export declare class AiAnalyticsService {
      * **Shared optional filters**
      * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
      * - platform_key           – tenant isolation
-     * - mentor_unique_id       – filter to one mentor
+     * - mentor_unique_id       – filter to one agent
      * - username               – filter to a learner
      * - provider / llm_model   – filter to LLM provider / model
      * - all_time               – true → lifetime totals
@@ -4686,7 +4686,7 @@ export declare class AiAnalyticsService {
          * * `provider` - Group by provider
          * * `llm_model` - Group by LLM model
          * * `username` - Group by username
-         * * `mentor` - Group by mentor
+         * * `mentor` - Group by agent
          * * `platform` - Group by platform
          * * `action` - Group by actions
          */
@@ -4730,14 +4730,14 @@ export declare class AiAnalyticsService {
      * - Flexible filtering by username and/or platform_key
      * - Essential metrics: total cost, sessions, usage period
      * - Provider breakdown (OpenAI, Anthropic, etc.)
-     * - Top mentors/actions by cost
+     * - Top agents/actions by cost
      * - Clean, invoice-ready format
      *
      * **Query Parameters:**
      * - username: Filter by specific username (optional)
      * - platform_key: Filter by platform (optional, but required for platform admins)
      * - start_date, end_date: billing period (defaults to last 30 days)
-     * - include_breakdown: show provider/mentor details (default: true)
+     * - include_breakdown: show provider/agent details (default: true)
      *
      * **Permission Logic:**
      * - Platform admins: Must include platform_key matching their permission scope
@@ -4795,7 +4795,7 @@ export declare class AiAnalyticsService {
          */
         endDate?: string;
         /**
-         * Whether to include provider and mentor breakdown
+         * Whether to include provider and agent breakdown
          */
         includeBreakdown?: boolean;
         /**
@@ -4869,7 +4869,7 @@ export declare class AiAnalyticsService {
         includeEdxProgress?: boolean;
         mentorUniqueId?: string;
         /**
-         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent (mentor) section. Defaults to courses when omitted.
+         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent section. Defaults to courses when omitted.
          */
         metrics?: string;
         /**
@@ -5242,7 +5242,7 @@ export declare class AiAnalyticsService {
      * - Day of week patterns (0=Sunday through 6=Saturday)
      * - Hour of day activity levels (0-23)
      * - Flexible date range filtering
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Message count aggregation
      *
      * **Data Structure:**
@@ -5327,7 +5327,7 @@ export declare class AiAnalyticsService {
         username?: string;
     }): CancelablePromise<TimeSpentPerUserResponse>;
     /**
-     * Returns topics overview analytics for a given platform and mentor.
+     * Returns topics overview analytics for a given platform and agent.
      *
      * Permission Required:
      * - Platform Admin
@@ -5369,7 +5369,7 @@ export declare class AiAnalyticsService {
         usergroupIds?: Array<number> | null;
     }): CancelablePromise<TopicsOverview>;
     /**
-     * Returns topic details Analytics for a given platform and mentor.
+     * Returns topic details Analytics for a given platform and agent.
      *
      * Permission Required:
      * - Platform Admin
@@ -5456,7 +5456,7 @@ export declare class AiAnalyticsService {
         includeEdxProgress?: boolean;
         mentorUniqueId?: string;
         /**
-         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent (mentor) section. Defaults to courses when omitted.
+         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent section. Defaults to courses when omitted.
          */
         metrics?: string;
         /**
@@ -5493,7 +5493,7 @@ export declare class AiAnalyticsService {
      * - Real-time active user counting
      * - Percentage change calculations vs previous periods
      * - Flexible date filtering and granularity
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Forward-filled time series data
      *
      * **Supported Metrics:**
@@ -5551,10 +5551,10 @@ export declare class AiAnalyticsService {
      * **Key Features:**
      * - Full-text search across username, email, name, and user ID
      * - Date range filtering for activity periods
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Comprehensive pagination with metadata
      * - CSV export for data analysis
-     * - User aggregation across platforms/mentors
+     * - User aggregation across platforms/agents
      *
      * **Search Capabilities:**
      * - Username matching

package/dist/types/services/AnalyticsService.d.ts

@@ -172,7 +172,7 @@ export declare class AnalyticsService {
      *
      * **Platform & Mentor Filtered:**
      * ```
-     * # Get total costs for a specific platform and mentor
+     * # Get total costs for a specific platform and agent
      * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
      * ```
      *
@@ -296,7 +296,7 @@ export declare class AnalyticsService {
      * **Shared optional filters**
      * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
      * - platform_key           – tenant isolation
-     * - mentor_unique_id       – filter to one mentor
+     * - mentor_unique_id       – filter to one agent
      * - username               – filter to a learner
      * - provider / llm_model   – filter to LLM provider / model
      * - all_time               – true → lifetime totals
@@ -362,7 +362,7 @@ export declare class AnalyticsService {
          * * `provider` - Group by provider
          * * `llm_model` - Group by LLM model
          * * `username` - Group by username
-         * * `mentor` - Group by mentor
+         * * `mentor` - Group by agent
          * * `platform` - Group by platform
          * * `action` - Group by actions
          */
@@ -406,14 +406,14 @@ export declare class AnalyticsService {
      * - Flexible filtering by username and/or platform_key
      * - Essential metrics: total cost, sessions, usage period
      * - Provider breakdown (OpenAI, Anthropic, etc.)
-     * - Top mentors/actions by cost
+     * - Top agents/actions by cost
      * - Clean, invoice-ready format
      *
      * **Query Parameters:**
      * - username: Filter by specific username (optional)
      * - platform_key: Filter by platform (optional, but required for platform admins)
      * - start_date, end_date: billing period (defaults to last 30 days)
-     * - include_breakdown: show provider/mentor details (default: true)
+     * - include_breakdown: show provider/agent details (default: true)
      *
      * **Permission Logic:**
      * - Platform admins: Must include platform_key matching their permission scope
@@ -471,7 +471,7 @@ export declare class AnalyticsService {
          */
         endDate?: string;
         /**
-         * Whether to include provider and mentor breakdown
+         * Whether to include provider and agent breakdown
          */
         includeBreakdown?: boolean;
         /**
@@ -807,7 +807,7 @@ export declare class AnalyticsService {
      * - Day of week patterns (0=Sunday through 6=Saturday)
      * - Hour of day activity levels (0-23)
      * - Flexible date range filtering
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Message count aggregation
      *
      * **Data Structure:**
@@ -845,7 +845,7 @@ export declare class AnalyticsService {
         usergroupIds?: Array<number> | null;
     }): CancelablePromise<AccessTimesHeatmap>;
     /**
-     * Returns topics overview analytics for a given platform and mentor.
+     * Returns topics overview analytics for a given platform and agent.
      *
      * Permission Required:
      * - Platform Admin
@@ -887,7 +887,7 @@ export declare class AnalyticsService {
         usergroupIds?: Array<number> | null;
     }): CancelablePromise<TopicsOverview>;
     /**
-     * Returns topic details Analytics for a given platform and mentor.
+     * Returns topic details Analytics for a given platform and agent.
      *
      * Permission Required:
      * - Platform Admin
@@ -934,7 +934,7 @@ export declare class AnalyticsService {
      * - Real-time active user counting
      * - Percentage change calculations vs previous periods
      * - Flexible date filtering and granularity
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Forward-filled time series data
      *
      * **Supported Metrics:**
@@ -992,10 +992,10 @@ export declare class AnalyticsService {
      * **Key Features:**
      * - Full-text search across username, email, name, and user ID
      * - Date range filtering for activity periods
-     * - Platform and mentor-specific filtering
+     * - Platform and agent-specific filtering
      * - Comprehensive pagination with metadata
      * - CSV export for data analysis
-     * - User aggregation across platforms/mentors
+     * - User aggregation across platforms/agents
      *
      * **Search Capabilities:**
      * - Username matching

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/iblai-api",
-  "version": "4.338.0-ai",
+  "version": "4.338.1-ai",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "type": "module",

package/sdk_schema.yml

@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   title: ibl-data-manager
-  version: 4.338.0-ai-plus
+  version: 4.338.1-ai-plus
   description: API for iblai
 paths:
   /api/ai-account/connected-services/callback/:
@@ -50917,7 +50917,7 @@ paths:
 
         **Platform & Mentor Filtered:**
         ```
-        # Get total costs for a specific platform and mentor
+        # Get total costs for a specific platform and agent
         GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
         ```
 
@@ -51229,7 +51229,7 @@ paths:
         **Shared optional filters**
         - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
         - platform_key           – tenant isolation
-        - mentor_unique_id       – filter to one mentor
+        - mentor_unique_id       – filter to one agent
         - username               – filter to a learner
         - provider / llm_model   – filter to LLM provider / model
         - all_time               – true → lifetime totals
@@ -51329,7 +51329,7 @@ paths:
           * `provider` - Group by provider
           * `llm_model` - Group by LLM model
           * `username` - Group by username
-          * `mentor` - Group by mentor
+          * `mentor` - Group by agent
           * `platform` - Group by platform
           * `action` - Group by actions
         required: true
@@ -51425,14 +51425,14 @@ paths:
         - Flexible filtering by username and/or platform_key
         - Essential metrics: total cost, sessions, usage period
         - Provider breakdown (OpenAI, Anthropic, etc.)
-        - Top mentors/actions by cost
+        - Top agents/actions by cost
         - Clean, invoice-ready format
 
         **Query Parameters:**
         - username: Filter by specific username (optional)
         - platform_key: Filter by platform (optional, but required for platform admins)
         - start_date, end_date: billing period (defaults to last 30 days)
-        - include_breakdown: show provider/mentor details (default: true)
+        - include_breakdown: show provider/agent details (default: true)
 
         **Permission Logic:**
         - Platform admins: Must include platform_key matching their permission scope
@@ -51493,7 +51493,7 @@ paths:
         schema:
           type: boolean
           default: true
-        description: Whether to include provider and mentor breakdown
+        description: Whether to include provider and agent breakdown
       - in: query
         name: platform_key
         schema:
@@ -51666,7 +51666,7 @@ paths:
           type: string
         description: 'Comma-separated sections to return: courses, programs, pathways,
           agents, skills, credentials, time_spent. `agents` is an alias for the agent
-          (mentor) section. Defaults to courses when omitted.'
+          section. Defaults to courses when omitted.'
       - in: query
         name: overtime
         schema:
@@ -52562,7 +52562,7 @@ paths:
         \ behavior analysis\n        - Support scheduling optimization\n        \n\
         \        **Key Features:**\n        - Day of week patterns (0=Sunday through\
         \ 6=Saturday)\n        - Hour of day activity levels (0-23)\n        - Flexible\
-        \ date range filtering\n        - Platform and mentor-specific filtering\n\
+        \ date range filtering\n        - Platform and agent-specific filtering\n\
         \        - Message count aggregation\n        \n        **Data Structure:**\n\
         \        - `day_of_week`: 0-6 (Sunday-Saturday)\n        - `hour`: 0-23 (24-hour\
         \ format)\n        - `value`: Message count for that time slot\n        "
@@ -52754,7 +52754,7 @@ paths:
     get:
       operationId: analytics_topics_retrieve
       description: |-
-        Returns topics overview analytics for a given platform and mentor.
+        Returns topics overview analytics for a given platform and agent.
 
         Permission Required:
         - Platform Admin
@@ -52856,7 +52856,7 @@ paths:
     get:
       operationId: analytics_topics_details_retrieve
       description: |-
-        Returns topic details Analytics for a given platform and mentor.
+        Returns topic details Analytics for a given platform and agent.
 
         Permission Required:
         - Platform Admin
@@ -53031,7 +53031,7 @@ paths:
           type: string
         description: 'Comma-separated sections to return: courses, programs, pathways,
           agents, skills, credentials, time_spent. `agents` is an alias for the agent
-          (mentor) section. Defaults to courses when omitted.'
+          section. Defaults to courses when omitted.'
       - in: query
         name: overtime
         schema:
@@ -53155,7 +53155,7 @@ paths:
         \ and growth\n        - Time series charts with customizable granularity\n\
         \        \n        **Key Features:**\n        - Real-time active user counting\n\
         \        - Percentage change calculations vs previous periods\n        - Flexible\
-        \ date filtering and granularity\n        - Platform and mentor-specific filtering\n\
+        \ date filtering and granularity\n        - Platform and agent-specific filtering\n\
         \        - Forward-filled time series data\n        \n        **Supported\
         \ Metrics:**\n        - `currently_active`: Users active in last hour\n  \
         \      - `active_users`: Unique users in specified period\n        - `registered_users`:\
@@ -53305,10 +53305,10 @@ paths:
         \ functionality across multiple fields\n        - Flexible date range filtering\n\
         \        - CSV export capability\n\n        **Key Features:**\n        - Full-text\
         \ search across username, email, name, and user ID\n        - Date range filtering\
-        \ for activity periods\n        - Platform and mentor-specific filtering\n\
+        \ for activity periods\n        - Platform and agent-specific filtering\n\
         \        - Comprehensive pagination with metadata\n        - CSV export for\
-        \ data analysis\n        - User aggregation across platforms/mentors\n\n \
-        \       **Search Capabilities:**\n        - Username matching\n        - Email\
+        \ data analysis\n        - User aggregation across platforms/agents\n\n  \
+        \      **Search Capabilities:**\n        - Username matching\n        - Email\
         \ address matching\n        - Full name search\n        - User ID lookup\n\
         \        - Partial string matching (case-insensitive)\n        \n        **Export\
         \ Options:**\n        - JSON response (default)\n        - CSV export (?export=csv)\n\
@@ -108706,7 +108706,7 @@ components:
       - timestamp
     MentorBreakdown:
       type: object
-      description: Mentor cost breakdown.
+      description: Agent cost breakdown.
       properties:
         mentor:
           type: string
@@ -111665,7 +111665,7 @@ components:
         proactive_prompt_message:
           type: string
           nullable: true
-          description: Default prompt message for AI mentor notifications
+          description: Default prompt message for AI agent notifications
         periodic_config:
           type: string
           readOnly: true
@@ -111723,7 +111723,7 @@ components:
             type: object
             additionalProperties: {}
           writeOnly: true
-          description: 'List of mentor configurations: [{"unique_id": "uuid", "prompt":
+          description: 'List of agent configurations: [{"unique_id": "uuid", "prompt":
             "...", "name": "..."}]'
         policy_config:
           type: string
@@ -117397,7 +117397,7 @@ components:
         proactive_prompt_message:
           type: string
           nullable: true
-          description: Default prompt message for AI mentor notifications
+          description: Default prompt message for AI agent notifications
         periodic_config:
           type: string
           readOnly: true
@@ -117455,7 +117455,7 @@ components:
             type: object
             additionalProperties: {}
           writeOnly: true
-          description: 'List of mentor configurations: [{"unique_id": "uuid", "prompt":
+          description: 'List of agent configurations: [{"unique_id": "uuid", "prompt":
             "...", "name": "..."}]'
         policy_config:
           type: string

package/src/core/OpenAPI.ts

@@ -21,7 +21,7 @@ export type OpenAPIConfig = {
 
 export const OpenAPI: OpenAPIConfig = {
     BASE: 'https://base.manager.iblai.app',
-    VERSION: '4.338.0-ai-plus',
+    VERSION: '4.338.1-ai-plus',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/src/models/MentorBreakdown.ts

@@ -3,7 +3,7 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
- * Mentor cost breakdown.
+ * Agent cost breakdown.
  */
 export type MentorBreakdown = {
     mentor: string;

package/src/models/NotificationTemplateDetail.ts

@@ -134,7 +134,7 @@ export type NotificationTemplateDetail = {
      */
     readonly available_context: string;
     /**
-     * Default prompt message for AI mentor notifications
+     * Default prompt message for AI agent notifications
      */
     proactive_prompt_message?: string | null;
     /**
@@ -178,7 +178,7 @@ export type NotificationTemplateDetail = {
      */
     periodic_timezone?: string;
     /**
-     * List of mentor configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
+     * List of agent configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
      */
     periodic_mentors?: Array<Record<string, any>>;
     /**

package/src/models/PatchedNotificationTemplateDetail.ts

@@ -134,7 +134,7 @@ export type PatchedNotificationTemplateDetail = {
      */
     readonly available_context?: string;
     /**
-     * Default prompt message for AI mentor notifications
+     * Default prompt message for AI agent notifications
      */
     proactive_prompt_message?: string | null;
     /**
@@ -178,7 +178,7 @@ export type PatchedNotificationTemplateDetail = {
      */
     periodic_timezone?: string;
     /**
-     * List of mentor configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
+     * List of agent configurations: [{"unique_id": "uuid", "prompt": "...", "name": "..."}]
      */
     periodic_mentors?: Array<Record<string, any>>;
     /**

package/src/services/AiAnalyticsService.ts

@@ -7470,7 +7470,7 @@ export class AiAnalyticsService {
                              *
                              * **Platform & Mentor Filtered:**
                              * ```
-                             * # Get total costs for a specific platform and mentor
+                             * # Get total costs for a specific platform and agent
                              * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
                              * ```
                              *
@@ -7635,7 +7635,7 @@ export class AiAnalyticsService {
                                              * **Shared optional filters**
                                              * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
                                              * - platform_key           – tenant isolation
-                                             * - mentor_unique_id       – filter to one mentor
+                                             * - mentor_unique_id       – filter to one agent
                                              * - username               – filter to a learner
                                              * - provider / llm_model   – filter to LLM provider / model
                                              * - all_time               – true → lifetime totals
@@ -7716,7 +7716,7 @@ export class AiAnalyticsService {
                                                                  * * `provider` - Group by provider
                                                                  * * `llm_model` - Group by LLM model
                                                                  * * `username` - Group by username
-                                                                 * * `mentor` - Group by mentor
+                                                                 * * `mentor` - Group by agent
                                                                  * * `platform` - Group by platform
                                                                  * * `action` - Group by actions
                                                                  */
@@ -7785,14 +7785,14 @@ export class AiAnalyticsService {
                                                              * - Flexible filtering by username and/or platform_key
                                                              * - Essential metrics: total cost, sessions, usage period
                                                              * - Provider breakdown (OpenAI, Anthropic, etc.)
-                                                             * - Top mentors/actions by cost
+                                                             * - Top agents/actions by cost
                                                              * - Clean, invoice-ready format
                                                              *
                                                              * **Query Parameters:**
                                                              * - username: Filter by specific username (optional)
                                                              * - platform_key: Filter by platform (optional, but required for platform admins)
                                                              * - start_date, end_date: billing period (defaults to last 30 days)
-                                                             * - include_breakdown: show provider/mentor details (default: true)
+                                                             * - include_breakdown: show provider/agent details (default: true)
                                                              *
                                                              * **Permission Logic:**
                                                              * - Platform admins: Must include platform_key matching their permission scope
@@ -7857,7 +7857,7 @@ export class AiAnalyticsService {
                                                                                      */
                                                                                     endDate?: string,
                                                                                     /**
-                                                                                     * Whether to include provider and mentor breakdown
+                                                                                     * Whether to include provider and agent breakdown
                                                                                      */
                                                                                     includeBreakdown?: boolean,
                                                                                     /**
@@ -7965,7 +7965,7 @@ export class AiAnalyticsService {
                                                                                     includeEdxProgress?: boolean,
                                                                                     mentorUniqueId?: string,
                                                                                     /**
-                                                                                     * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent (mentor) section. Defaults to courses when omitted.
+                                                                                     * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent section. Defaults to courses when omitted.
                                                                                      */
                                                                                     metrics?: string,
                                                                                     /**
@@ -8544,7 +8544,7 @@ export class AiAnalyticsService {
                                                                                      * - Day of week patterns (0=Sunday through 6=Saturday)
                                                                                      * - Hour of day activity levels (0-23)
                                                                                      * - Flexible date range filtering
-                                                                                     * - Platform and mentor-specific filtering
+                                                                                     * - Platform and agent-specific filtering
                                                                                      * - Message count aggregation
                                                                                      *
                                                                                      * **Data Structure:**
@@ -8686,7 +8686,7 @@ export class AiAnalyticsService {
                                                                                         });
                                                                                     }
                                                                                     /**
-                                                                                     * Returns topics overview analytics for a given platform and mentor.
+                                                                                     * Returns topics overview analytics for a given platform and agent.
                                                                                      *
                                                                                      * Permission Required:
                                                                                      * - Platform Admin
@@ -8752,7 +8752,7 @@ export class AiAnalyticsService {
                                                                                         });
                                                                                     }
                                                                                     /**
-                                                                                     * Returns topic details Analytics for a given platform and mentor.
+                                                                                     * Returns topic details Analytics for a given platform and agent.
                                                                                      *
                                                                                      * Permission Required:
                                                                                      * - Platform Admin
@@ -8880,7 +8880,7 @@ export class AiAnalyticsService {
                                                                                         includeEdxProgress?: boolean,
                                                                                         mentorUniqueId?: string,
                                                                                         /**
-                                                                                         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent (mentor) section. Defaults to courses when omitted.
+                                                                                         * Comma-separated sections to return: courses, programs, pathways, agents, skills, credentials, time_spent. `agents` is an alias for the agent section. Defaults to courses when omitted.
                                                                                          */
                                                                                         metrics?: string,
                                                                                         /**
@@ -8943,7 +8943,7 @@ export class AiAnalyticsService {
                                                                                      * - Real-time active user counting
                                                                                      * - Percentage change calculations vs previous periods
                                                                                      * - Flexible date filtering and granularity
-                                                                                     * - Platform and mentor-specific filtering
+                                                                                     * - Platform and agent-specific filtering
                                                                                      * - Forward-filled time series data
                                                                                      *
                                                                                      * **Supported Metrics:**
@@ -9030,10 +9030,10 @@ export class AiAnalyticsService {
                                                                                      * **Key Features:**
                                                                                      * - Full-text search across username, email, name, and user ID
                                                                                      * - Date range filtering for activity periods
-                                                                                     * - Platform and mentor-specific filtering
+                                                                                     * - Platform and agent-specific filtering
                                                                                      * - Comprehensive pagination with metadata
                                                                                      * - CSV export for data analysis
-                                                                                     * - User aggregation across platforms/mentors
+                                                                                     * - User aggregation across platforms/agents
                                                                                      *
                                                                                      * **Search Capabilities:**
                                                                                      * - Username matching

package/src/services/AnalyticsService.ts

@@ -242,7 +242,7 @@ export class AnalyticsService {
      *
      * **Platform & Mentor Filtered:**
      * ```
-     * # Get total costs for a specific platform and mentor
+     * # Get total costs for a specific platform and agent
      * GET /api/analytics/financial/?metric=total_costs&platform_key=web-app&mentor_unique_id=mentor-123&comparison_days=14
      * ```
      *
@@ -407,7 +407,7 @@ export class AnalyticsService {
                      * **Shared optional filters**
                      * - start_date, end_date   – ISO yyyy-mm-dd (ignored when all_time=true)
                      * - platform_key           – tenant isolation
-                     * - mentor_unique_id       – filter to one mentor
+                     * - mentor_unique_id       – filter to one agent
                      * - username               – filter to a learner
                      * - provider / llm_model   – filter to LLM provider / model
                      * - all_time               – true → lifetime totals
@@ -488,7 +488,7 @@ export class AnalyticsService {
                                          * * `provider` - Group by provider
                                          * * `llm_model` - Group by LLM model
                                          * * `username` - Group by username
-                                         * * `mentor` - Group by mentor
+                                         * * `mentor` - Group by agent
                                          * * `platform` - Group by platform
                                          * * `action` - Group by actions
                                          */
@@ -557,14 +557,14 @@ export class AnalyticsService {
                                      * - Flexible filtering by username and/or platform_key
                                      * - Essential metrics: total cost, sessions, usage period
                                      * - Provider breakdown (OpenAI, Anthropic, etc.)
-                                     * - Top mentors/actions by cost
+                                     * - Top agents/actions by cost
                                      * - Clean, invoice-ready format
                                      *
                                      * **Query Parameters:**
                                      * - username: Filter by specific username (optional)
                                      * - platform_key: Filter by platform (optional, but required for platform admins)
                                      * - start_date, end_date: billing period (defaults to last 30 days)
-                                     * - include_breakdown: show provider/mentor details (default: true)
+                                     * - include_breakdown: show provider/agent details (default: true)
                                      *
                                      * **Permission Logic:**
                                      * - Platform admins: Must include platform_key matching their permission scope
@@ -629,7 +629,7 @@ export class AnalyticsService {
                                                              */
                                                             endDate?: string,
                                                             /**
-                                                             * Whether to include provider and mentor breakdown
+                                                             * Whether to include provider and agent breakdown
                                                              */
                                                             includeBreakdown?: boolean,
                                                             /**
@@ -1151,7 +1151,7 @@ export class AnalyticsService {
                                                          * - Day of week patterns (0=Sunday through 6=Saturday)
                                                          * - Hour of day activity levels (0-23)
                                                          * - Flexible date range filtering
-                                                         * - Platform and mentor-specific filtering
+                                                         * - Platform and agent-specific filtering
                                                          * - Message count aggregation
                                                          *
                                                          * **Data Structure:**
@@ -1216,7 +1216,7 @@ export class AnalyticsService {
                                                             });
                                                         }
                                                         /**
-                                                         * Returns topics overview analytics for a given platform and mentor.
+                                                         * Returns topics overview analytics for a given platform and agent.
                                                          *
                                                          * Permission Required:
                                                          * - Platform Admin
@@ -1282,7 +1282,7 @@ export class AnalyticsService {
                                                             });
                                                         }
                                                         /**
-                                                         * Returns topic details Analytics for a given platform and mentor.
+                                                         * Returns topic details Analytics for a given platform and agent.
                                                          *
                                                          * Permission Required:
                                                          * - Platform Admin
@@ -1355,7 +1355,7 @@ export class AnalyticsService {
                                                          * - Real-time active user counting
                                                          * - Percentage change calculations vs previous periods
                                                          * - Flexible date filtering and granularity
-                                                         * - Platform and mentor-specific filtering
+                                                         * - Platform and agent-specific filtering
                                                          * - Forward-filled time series data
                                                          *
                                                          * **Supported Metrics:**
@@ -1442,10 +1442,10 @@ export class AnalyticsService {
                                                          * **Key Features:**
                                                          * - Full-text search across username, email, name, and user ID
                                                          * - Date range filtering for activity periods
-                                                         * - Platform and mentor-specific filtering
+                                                         * - Platform and agent-specific filtering
                                                          * - Comprehensive pagination with metadata
                                                          * - CSV export for data analysis
-                                                         * - User aggregation across platforms/mentors
+                                                         * - User aggregation across platforms/agents
                                                          *
                                                          * **Search Capabilities:**
                                                          * - Username matching