@iblai/iblai-api 4.388.0-ai → 4.389.0-ai

package/dist/index.cjs.js

@@ -110,7 +110,7 @@ class CancelablePromise {
 
 const OpenAPI = {
   BASE: 'https://base.manager.iblai.app',
-  VERSION: '4.388.0-ai-plus',
+  VERSION: '4.389.0-ai-plus',
   WITH_CREDENTIALS: false,
   CREDENTIALS: 'include',
   TOKEN: undefined,
@@ -20583,7 +20583,7 @@ class AiMentorService{/**
      * Retrieve experiment run details
      * Returns the run header plus every `dataset_run_item` fully expanded with `input`, `expected_output`, `actual_output`, `trace_id`, and per-item `scores`. Also embeds a `pending_judges` array for any in-flight LLM-as-Judge evaluations against this run.
      *
-     * Cost: 1 PG query + 2 ClickHouse queries + 1 score query regardless of run size.
+     * Cost: 1 PG query + 2 ClickHouse queries + 1 score query + 1 identity query, all flat regardless of run size.
      * @returns RunDetailResponse
      * @throws ApiError
      */static aiMentorOrgsUsersEvaluationsDatasetsRunsRetrieve({datasetName,org,runName,userId}){return request(OpenAPI,{method:'GET',url:'/api/ai-mentor/orgs/{org}/users/{user_id}/evaluations/datasets/{dataset_name}/runs/{run_name}/',path:{'dataset_name':datasetName,'org':org,'run_name':runName,'user_id':userId},errors:{403:`Authenticated, but the resource belongs to another tenant.`,404:`Not found within the tenant.`}});}/**

package/dist/index.esm.js

@@ -108,7 +108,7 @@ class CancelablePromise {
 
 const OpenAPI = {
   BASE: 'https://base.manager.iblai.app',
-  VERSION: '4.388.0-ai-plus',
+  VERSION: '4.389.0-ai-plus',
   WITH_CREDENTIALS: false,
   CREDENTIALS: 'include',
   TOKEN: undefined,
@@ -20581,7 +20581,7 @@ class AiMentorService{/**
      * Retrieve experiment run details
      * Returns the run header plus every `dataset_run_item` fully expanded with `input`, `expected_output`, `actual_output`, `trace_id`, and per-item `scores`. Also embeds a `pending_judges` array for any in-flight LLM-as-Judge evaluations against this run.
      *
-     * Cost: 1 PG query + 2 ClickHouse queries + 1 score query regardless of run size.
+     * Cost: 1 PG query + 2 ClickHouse queries + 1 score query + 1 identity query, all flat regardless of run size.
      * @returns RunDetailResponse
      * @throws ApiError
      */static aiMentorOrgsUsersEvaluationsDatasetsRunsRetrieve({datasetName,org,runName,userId}){return request(OpenAPI,{method:'GET',url:'/api/ai-mentor/orgs/{org}/users/{user_id}/evaluations/datasets/{dataset_name}/runs/{run_name}/',path:{'dataset_name':datasetName,'org':org,'run_name':runName,'user_id':userId},errors:{403:`Authenticated, but the resource belongs to another tenant.`,404:`Not found within the tenant.`}});}/**

package/dist/index.umd.js

@@ -114,7 +114,7 @@
 
     const OpenAPI = {
       BASE: 'https://base.manager.iblai.app',
-      VERSION: '4.388.0-ai-plus',
+      VERSION: '4.389.0-ai-plus',
       WITH_CREDENTIALS: false,
       CREDENTIALS: 'include',
       TOKEN: undefined,
@@ -20587,7 +20587,7 @@
          * Retrieve experiment run details
          * Returns the run header plus every `dataset_run_item` fully expanded with `input`, `expected_output`, `actual_output`, `trace_id`, and per-item `scores`. Also embeds a `pending_judges` array for any in-flight LLM-as-Judge evaluations against this run.
          *
-         * Cost: 1 PG query + 2 ClickHouse queries + 1 score query regardless of run size.
+         * Cost: 1 PG query + 2 ClickHouse queries + 1 score query + 1 identity query, all flat regardless of run size.
          * @returns RunDetailResponse
          * @throws ApiError
          */static aiMentorOrgsUsersEvaluationsDatasetsRunsRetrieve({datasetName,org,runName,userId}){return request(OpenAPI,{method:'GET',url:'/api/ai-mentor/orgs/{org}/users/{user_id}/evaluations/datasets/{dataset_name}/runs/{run_name}/',path:{'dataset_name':datasetName,'org':org,'run_name':runName,'user_id':userId},errors:{403:`Authenticated, but the resource belongs to another tenant.`,404:`Not found within the tenant.`}});}/**

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

@@ -1,9 +1,16 @@
+/**
+ * A generated image. ``user`` is the numeric id, so the identity fields
+ * let a client render the owner without a second request.
+ */
 export type AIGeneratedImage = {
     readonly id: number;
     /**
      * edX user ID
      */
     user?: number | null;
+    readonly username: string | null;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     image: string;
     platform?: number | null;
     prompt?: string;

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

@@ -60,6 +60,8 @@ export type Artifact = {
      * Username of the student who owns this artifact
      */
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     readonly session_id: string | null;
     /**
      * Version number of the current version

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

@@ -42,6 +42,8 @@ export type ArtifactList = {
      * Username of the student who owns this artifact
      */
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     readonly session_id: string | null;
     /**
      * Length of the artifact content in characters (bytes for binary artifacts)

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

@@ -1,5 +1,6 @@
 export type ChatHistoryFilterUser = {
     username: string;
     email: string;
+    readonly user_full_name: string | null;
     readonly lti_email: string;
 };

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

@@ -1,12 +1,20 @@
 import type { ChatRunTrackerStatusEnum } from './ChatRunTrackerStatusEnum';
 import type { FailureCategoryEnum } from './FailureCategoryEnum';
 import type { ModalityEnum } from './ModalityEnum';
+/**
+ * A single chat run.
+ *
+ * ``username`` and ``email`` are denormalized onto the row at write time;
+ * only the display name needs resolving, so the mixin's ``user_email`` twin
+ * is dropped in favour of the existing column.
+ */
 export type ChatRunTracker = {
     readonly id: string;
     readonly session_id: string;
     readonly mentor_unique_id: string;
     readonly username: string;
     readonly email: string;
+    readonly user_full_name: string | null;
     readonly platform_key: string;
     readonly generation_id: string;
     readonly modality: ModalityEnum;

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

@@ -25,4 +25,6 @@ export type ConnectedService = {
      * Return the username strings associated with the connection.
      */
     readonly username: Array<string>;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
 };

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

@@ -5,6 +5,7 @@ export type ConversationMessage = {
     id: string;
     user_id: string;
     email: string | null;
+    readonly user_full_name: string | null;
     readonly message_count: number;
     model: string;
     inserted_at: string;

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

@@ -7,6 +7,7 @@ export type Conversations = {
     mentor: string;
     readonly student: string;
     readonly email: string;
+    readonly user_full_name: string | null;
     model: string;
     readonly rating: number;
     platform: string;

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

@@ -3,6 +3,8 @@ import type { CourseCreationTaskStatusEnum } from './CourseCreationTaskStatusEnu
 export type CourseCreationTask = {
     readonly id: number;
     readonly user_id: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     /**
      * edX user ID
      */

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

@@ -9,4 +9,5 @@ export type Dataset = {
     updated_at: string;
     readonly username: string;
     readonly user_email: string;
+    readonly user_full_name: string;
 };

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

@@ -8,4 +8,6 @@ export type DisclaimerAgreement = {
     readonly agreed_at: string;
     readonly platform_key: string;
     readonly user_id: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
 };

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

@@ -1,6 +1,8 @@
 export type ElevenlabsCustomVoiceResponse = {
     name: string;
     readonly owner_student: string | null;
+    readonly owner_email: string | null;
+    readonly owner_full_name: string | null;
     language?: string;
     is_premade?: boolean;
     description?: string;

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

@@ -5,6 +5,8 @@ import type { EntityTypeEnum } from './EntityTypeEnum';
 export type Entity = {
     type?: EntityTypeEnum;
     username?: string;
+    user_email?: string | null;
+    user_full_name?: string | null;
     platform_key?: string;
     platform_name?: string;
     display_name: string;

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

@@ -27,6 +27,8 @@ export type HostingProject = {
     readonly push_state: string;
     readonly push_error: string;
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     readonly created_at: string;
     readonly updated_at: string;
 };

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

@@ -12,6 +12,7 @@ export type JudgeRecord = {
     error_message: string;
     readonly username: string;
     readonly user_email: string;
+    readonly user_full_name: string;
     created_at: string;
     started_at?: string | null;
     completed_at?: string | null;

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

@@ -13,6 +13,8 @@ export type MCPServer = {
      * edX username
      */
     owner?: string | null;
+    readonly owner_email: string | null;
+    readonly owner_full_name: string | null;
     name: string;
     /**
      * A description of the MCP server.

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

@@ -26,6 +26,8 @@ export type MCPServerConnection = {
      * edX username
      */
     user?: string | null;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     mentor?: string | null;
     connected_service?: number | null;
     readonly connected_service_summary: Record<string, any> | null;

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

@@ -4,5 +4,7 @@ export type MemoryComponentMemoryDetail = {
     readonly catalog_item: string;
     readonly mentor_unique_id: string;
     readonly student: string;
+    readonly student_email: string | null;
+    readonly student_full_name: string | null;
     readonly inserted_at: string;
 };

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

@@ -1,6 +1,34 @@
+/**
+ * Adds read-only ``user_email``/``user_full_name`` from a username column.
+ *
+ * For models that store the username but hold no FK to the user, so there is
+ * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
+ * a single child serializer for a whole page, so the first field access reads
+ * every username being serialized and looks them all up at once. A view that
+ * already knows the identities can put a ``user_identity_map`` in serializer
+ * context to skip the query entirely.
+ *
+ * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
+ * this out of the MRO games that subclassing ``Serializer`` into a
+ * ``ModelSerializer`` would introduce.
+ *
+ * **Privacy invariant — resolve only from the row's own stored username.**
+ * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
+ * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
+ * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
+ * so an anonymised row reaches this mixin with nothing to look up and renders
+ * nulls. That is the whole of the protection: nothing here may back-fill the
+ * identity from elsewhere (``session.student``, the request user, …), or an
+ * anonymised row would be re-identified in the response. Privacy mode redacts
+ * conversation *text*, not identity, on the other rows this mixin serves —
+ * a moderation log or run tracker keeps its username by design — so those
+ * resolving an identity is intended, not a leak.
+ */
 export type MemoryStatusView = {
     readonly id: number;
     username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     platform_key: string;
     enabled?: boolean;
 };

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

@@ -20,6 +20,10 @@ export type MentorAuditLogEntry = {
      * Email of the user who performed the action
      */
     actor_email: string | null;
+    /**
+     * Display name of the user who performed the action
+     */
+    actor_full_name: string | null;
     /**
      * Action type: create, update, or delete
      */

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

@@ -1,8 +1,17 @@
 import type { TargetSystemEnum } from './TargetSystemEnum';
+/**
+ * A moderation/safety log row.
+ *
+ * ``ModerationLog`` denormalizes only ``username``, so the email and name
+ * come from the mixin — one query per page, and a row whose user has since
+ * been deleted reports nulls instead of raising. ``email`` keeps its
+ * established name, so the mixin's ``user_email`` twin is dropped.
+ */
 export type ModerationLog = {
     readonly id: number;
     username?: string;
-    readonly email: string;
+    readonly email: string | null;
+    readonly user_full_name: string | null;
     platform_key: string;
     mentor: number;
     prompt: string;

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

@@ -43,6 +43,8 @@ export type NestedArtifact = {
      * Username of the student who owns this artifact
      */
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     readonly session_id: string | null;
     /**
      * Version number of the current version

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

@@ -60,6 +60,8 @@ export type PatchedArtifact = {
      * Username of the student who owns this artifact
      */
     readonly username?: string;
+    readonly user_email?: string | null;
+    readonly user_full_name?: string | null;
     readonly session_id?: string | null;
     /**
      * Version number of the current version

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

@@ -7,6 +7,7 @@ export type PatchedConversations = {
     mentor?: string;
     readonly student?: string;
     readonly email?: string;
+    readonly user_full_name?: string | null;
     model?: string;
     readonly rating?: number;
     platform?: string;

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

@@ -13,6 +13,8 @@ export type PatchedMCPServer = {
      * edX username
      */
     owner?: string | null;
+    readonly owner_email?: string | null;
+    readonly owner_full_name?: string | null;
     name?: string;
     /**
      * A description of the MCP server.

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

@@ -26,6 +26,8 @@ export type PatchedMCPServerConnection = {
      * edX username
      */
     user?: string | null;
+    readonly user_email?: string | null;
+    readonly user_full_name?: string | null;
     mentor?: string | null;
     connected_service?: number | null;
     readonly connected_service_summary?: Record<string, any> | null;

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

@@ -1,10 +1,38 @@
 import type { PeriodicTask } from './PeriodicTask';
 import type { PreviousAgentStatusEnum } from './PreviousAgentStatusEnum';
+/**
+ * Adds read-only ``user_email``/``user_full_name`` from a username column.
+ *
+ * For models that store the username but hold no FK to the user, so there is
+ * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
+ * a single child serializer for a whole page, so the first field access reads
+ * every username being serialized and looks them all up at once. A view that
+ * already knows the identities can put a ``user_identity_map`` in serializer
+ * context to skip the query entirely.
+ *
+ * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
+ * this out of the MRO games that subclassing ``Serializer`` into a
+ * ``ModelSerializer`` would introduce.
+ *
+ * **Privacy invariant — resolve only from the row's own stored username.**
+ * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
+ * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
+ * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
+ * so an anonymised row reaches this mixin with nothing to look up and renders
+ * nulls. That is the whole of the protection: nothing here may back-fill the
+ * identity from elsewhere (``session.student``, the request user, …), or an
+ * anonymised row would be re-identified in the response. Privacy mode redacts
+ * conversation *text*, not identity, on the other rows this mixin serves —
+ * a moderation log or run tracker keeps its username by design — so those
+ * resolving an identity is intended, not a leak.
+ */
 export type PatchedPeriodicAgentCreate = {
     readonly id?: number;
     mentor?: string;
     title?: string;
     readonly username?: string;
+    readonly user_email?: string | null;
+    readonly user_full_name?: string | null;
     description?: string;
     /**
      * Prompt for the periodic agent if any.

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

@@ -29,6 +29,8 @@ export type PatchedProject = {
      */
     readonly owner?: number;
     readonly owner_username?: string;
+    readonly owner_email?: string | null;
+    readonly owner_full_name?: string | null;
     /**
      * Platform this project belongs to
      */

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

@@ -36,6 +36,8 @@ export type PatchedWorkflow = {
      */
     readonly created_by?: number;
     readonly created_by_username?: string;
+    readonly created_by_email?: string | null;
+    readonly created_by_full_name?: string | null;
     readonly created_at?: string;
     readonly updated_at?: string;
     /**

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

@@ -1,11 +1,39 @@
 import type { Mentor } from './Mentor';
 import type { PeriodicTask } from './PeriodicTask';
 import type { PreviousAgentStatusEnum } from './PreviousAgentStatusEnum';
+/**
+ * Adds read-only ``user_email``/``user_full_name`` from a username column.
+ *
+ * For models that store the username but hold no FK to the user, so there is
+ * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
+ * a single child serializer for a whole page, so the first field access reads
+ * every username being serialized and looks them all up at once. A view that
+ * already knows the identities can put a ``user_identity_map`` in serializer
+ * context to skip the query entirely.
+ *
+ * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
+ * this out of the MRO games that subclassing ``Serializer`` into a
+ * ``ModelSerializer`` would introduce.
+ *
+ * **Privacy invariant — resolve only from the row's own stored username.**
+ * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
+ * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
+ * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
+ * so an anonymised row reaches this mixin with nothing to look up and renders
+ * nulls. That is the whole of the protection: nothing here may back-fill the
+ * identity from elsewhere (``session.student``, the request user, …), or an
+ * anonymised row would be re-identified in the response. Privacy mode redacts
+ * conversation *text*, not identity, on the other rows this mixin serves —
+ * a moderation log or run tracker keeps its username by design — so those
+ * resolving an identity is intended, not a leak.
+ */
 export type PeriodicAgent = {
     readonly id: number;
     mentor: Mentor;
     title: string;
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     description?: string;
     /**
      * Prompt for the periodic agent if any.

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

@@ -1,10 +1,38 @@
 import type { PeriodicTask } from './PeriodicTask';
 import type { PreviousAgentStatusEnum } from './PreviousAgentStatusEnum';
+/**
+ * Adds read-only ``user_email``/``user_full_name`` from a username column.
+ *
+ * For models that store the username but hold no FK to the user, so there is
+ * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
+ * a single child serializer for a whole page, so the first field access reads
+ * every username being serialized and looks them all up at once. A view that
+ * already knows the identities can put a ``user_identity_map`` in serializer
+ * context to skip the query entirely.
+ *
+ * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
+ * this out of the MRO games that subclassing ``Serializer`` into a
+ * ``ModelSerializer`` would introduce.
+ *
+ * **Privacy invariant — resolve only from the row's own stored username.**
+ * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
+ * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
+ * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
+ * so an anonymised row reaches this mixin with nothing to look up and renders
+ * nulls. That is the whole of the protection: nothing here may back-fill the
+ * identity from elsewhere (``session.student``, the request user, …), or an
+ * anonymised row would be re-identified in the response. Privacy mode redacts
+ * conversation *text*, not identity, on the other rows this mixin serves —
+ * a moderation log or run tracker keeps its username by design — so those
+ * resolving an identity is intended, not a leak.
+ */
 export type PeriodicAgentCreate = {
     readonly id: number;
     mentor: string;
     title: string;
     readonly username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     description?: string;
     /**
      * Prompt for the periodic agent if any.

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

@@ -29,6 +29,8 @@ export type Project = {
      */
     readonly owner: number;
     readonly owner_username: string;
+    readonly owner_email: string | null;
+    readonly owner_full_name: string | null;
     /**
      * Platform this project belongs to
      */

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

@@ -3,12 +3,20 @@ import type { BlankEnum } from './BlankEnum';
 import type { CrawlerPatternTypeEnum } from './CrawlerPatternTypeEnum';
 import type { NullEnum } from './NullEnum';
 import type { TrainingStatusEnum } from './TrainingStatusEnum';
+/**
+ * A trained document.
+ *
+ * ``DocumentEmbedding`` denormalizes ``username`` and holds no FK to the
+ * user, so the email and name are resolved by the mixin — one query per page.
+ */
 export type RetrieverDocumentEmbedding = {
     readonly id: number;
     metadata?: any;
     document_name?: string | null;
     document_type?: string | null;
     username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     training_status?: (TrainingStatusEnum | BlankEnum | NullEnum) | null;
     pathway: string;
     url?: string | null;

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

@@ -16,6 +16,7 @@ export type Run = {
     status: string;
     readonly username: string;
     readonly user_email: string;
+    readonly user_full_name: string;
     task_id?: string;
     task_record_id?: number | null;
 };

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

@@ -12,6 +12,7 @@ export type RunDetailResponse = {
     status: string;
     readonly username: string;
     readonly user_email: string;
+    readonly user_full_name: string;
     task_id?: string;
     task_record_id?: number | null;
     dataset_run_items: Array<DatasetRunItem>;

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

@@ -14,4 +14,5 @@ export type Score = {
     created_at: string;
     readonly username: string;
     readonly user_email: string;
+    readonly user_full_name: string;
 };

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

@@ -5,4 +5,5 @@ export type ScoreCreateResponse = {
     value: number;
     username: string;
     user_email: string;
+    readonly user_full_name: string;
 };

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

@@ -9,8 +9,9 @@ import type { SpendCapScopeEnum } from './SpendCapScopeEnum';
  * (``current_spend_usd``/``remaining_usd``/``is_exceeded``) are reconciled
  * from ClickHouse and surfaced read-only so a UI can render a progress bar.
  * ``scope``/``platform``/``mentor``/``user`` are set by the view, never the
- * request body; ``mentor_unique_id``/``username`` are echoed read-only so the
- * caller can tell which agent/user a cap belongs to.
+ * request body; ``mentor_unique_id``/``username``/``email``/``user_full_name``
+ * are echoed read-only so the caller can tell which agent/user a cap belongs
+ * to and render it without a second request.
  */
 export type SpendCap = {
     readonly id: number;
@@ -20,6 +21,7 @@ export type SpendCap = {
     readonly mentor_name: string | null;
     readonly username: string | null;
     readonly email: string | null;
+    readonly user_full_name: string | null;
     interval_type: IntervalTypeEnum;
     max_cost_usd: string;
     enforcement?: EnforcementEnum;

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

@@ -3,6 +3,8 @@ export type StarMentor = {
     readonly updated_at: string;
     readonly mentor: string;
     readonly student: string;
+    readonly student_email: string | null;
+    readonly student_full_name: string | null;
     readonly recently_accessed_at: string | null;
     readonly id: number;
     readonly unique_id: string;

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

@@ -1,4 +1,9 @@
+/**
+ * Message counts aggregated per user; the rows are dicts.
+ */
 export type StudentChatMessage = {
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     username: string;
     chat_message_count: number;
 };

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

@@ -1,6 +1,34 @@
+/**
+ * Adds read-only ``user_email``/``user_full_name`` from a username column.
+ *
+ * For models that store the username but hold no FK to the user, so there is
+ * nothing to traverse. Resolution costs **one query per payload**: DRF reuses
+ * a single child serializer for a whole page, so the first field access reads
+ * every username being serialized and looks them all up at once. A view that
+ * already knows the identities can put a ``user_identity_map`` in serializer
+ * context to skip the query entirely.
+ *
+ * ``SerializerMetaclass`` is what collects ``_declared_fields``; it also keeps
+ * this out of the MRO games that subclassing ``Serializer`` into a
+ * ``ModelSerializer`` would introduce.
+ *
+ * **Privacy invariant — resolve only from the row's own stored username.**
+ * Chat privacy's ``ANONYMIZED`` mode removes identity by writing the row with
+ * no username (``ibl_ai_langchain_ext/langchain/memories.py``:
+ * ``None if privacy_mode == ChatPrivacyMode.ANONYMIZED else self.username``),
+ * so an anonymised row reaches this mixin with nothing to look up and renders
+ * nulls. That is the whole of the protection: nothing here may back-fill the
+ * identity from elsewhere (``session.student``, the request user, …), or an
+ * anonymised row would be re-identified in the response. Privacy mode redacts
+ * conversation *text*, not identity, on the other rows this mixin serves —
+ * a moderation log or run tracker keeps its username by design — so those
+ * resolving an identity is intended, not a leak.
+ */
 export type UserAllChatMemoryView = {
     readonly id: number;
     username: string;
+    readonly user_email: string | null;
+    readonly user_full_name: string | null;
     platform_key: string;
     content?: string | null;
     session_id?: string | null;