@iblai/iblai-js 2.18.0 → 2.19.0

package/dist/web-containers/source/next/index.esm.js

@@ -96692,6 +96692,7 @@ var analyticsAccessTimeHeatmap$3 = {
 	tooltipActiveUsers: "{count} active users"
 };
 var analyticsAnalyticsAuditLogStats$3 = {
+	anonymous: "Anonymous",
 	scopeAgent: "Agent",
 	scopeAriaLabel: "Audit log scope",
 	scopePlatform: "Platform",
@@ -96820,6 +96821,7 @@ var analyticsAgentScopeLink$3 = {
 	scopeToAgent: "View analytics for {name}"
 };
 var analyticsAnalyticsMemoryStats$3 = {
+	anonymous: "Anonymous",
 	noPermission: "You do not have permission to view user memories.",
 	scopeLabel: "Memory scope",
 	scopeMentor: "This Agent",
@@ -97034,6 +97036,7 @@ var analyticsAnalyticsTopicsStats$3 = {
 	topicsRankedFooter: "{shown} of {total} topics · ranked by message volume"
 };
 var analyticsAnalyticsTranscriptsStats$3 = {
+	anonymous: "Anonymous",
 	justNow: "Just now",
 	minutesAgo: "{count} min ago",
 	hoursAgo: "{count} hour{count, plural, one {} other {s}} ago",
@@ -103973,6 +103976,7 @@ var analyticsAccessTimeHeatmap$2 = {
 	tooltipActiveUsers: "{count} utilisateurs actifs"
 };
 var analyticsAnalyticsAuditLogStats$2 = {
+	anonymous: "Anonyme",
 	scopeAgent: "Agent",
 	scopeAriaLabel: "Portée du journal d'audit",
 	scopePlatform: "Plateforme",
@@ -104101,6 +104105,7 @@ var analyticsAgentScopeLink$2 = {
 	scopeToAgent: "Voir les analyses de {name}"
 };
 var analyticsAnalyticsMemoryStats$2 = {
+	anonymous: "Anonyme",
 	noPermission: "Vous n'avez pas l'autorisation de consulter les mémoires des utilisateurs.",
 	scopeLabel: "Portée de la mémoire",
 	scopeMentor: "Cet agent",
@@ -104315,6 +104320,7 @@ var analyticsAnalyticsTopicsStats$2 = {
 	topicsRankedFooter: "{shown} sur {total} sujets · classés par volume de messages"
 };
 var analyticsAnalyticsTranscriptsStats$2 = {
+	anonymous: "Anonyme",
 	justNow: "À l'instant",
 	minutesAgo: "Il y a {count} min",
 	hoursAgo: "Il y a {count} heure{count, plural, one {} other {s}}",
@@ -111254,6 +111260,7 @@ var analyticsAccessTimeHeatmap$1 = {
 	tooltipActiveUsers: "{count} usuarios activos"
 };
 var analyticsAnalyticsAuditLogStats$1 = {
+	anonymous: "Anónimo",
 	scopeAgent: "Agente",
 	scopeAriaLabel: "Alcance del registro de auditoría",
 	scopePlatform: "Plataforma",
@@ -111382,6 +111389,7 @@ var analyticsAgentScopeLink$1 = {
 	scopeToAgent: "Ver analíticas de {name}"
 };
 var analyticsAnalyticsMemoryStats$1 = {
+	anonymous: "Anónimo",
 	noPermission: "No tienes permiso para ver los recuerdos de los usuarios.",
 	scopeLabel: "Alcance de la memoria",
 	scopeMentor: "Este agente",
@@ -111596,6 +111604,7 @@ var analyticsAnalyticsTopicsStats$1 = {
 	topicsRankedFooter: "{shown} de {total} temas · ordenados por volumen de mensajes"
 };
 var analyticsAnalyticsTranscriptsStats$1 = {
+	anonymous: "Anónimo",
 	justNow: "Ahora mismo",
 	minutesAgo: "Hace {count} min",
 	hoursAgo: "Hace {count} hora{count, plural, one {} other {s}}",
@@ -118535,6 +118544,7 @@ var analyticsAccessTimeHeatmap = {
 	tooltipActiveUsers: "{count} 位活跃用户"
 };
 var analyticsAnalyticsAuditLogStats = {
+	anonymous: "匿名",
 	scopeAgent: "智能体",
 	scopeAriaLabel: "审计日志范围",
 	scopePlatform: "平台",
@@ -118663,6 +118673,7 @@ var analyticsAgentScopeLink = {
 	scopeToAgent: "查看 {name} 的分析"
 };
 var analyticsAnalyticsMemoryStats = {
+	anonymous: "匿名",
 	noPermission: "您没有查看用户记忆的权限。",
 	scopeLabel: "记忆范围",
 	scopeMentor: "当前智能体",
@@ -118877,6 +118888,7 @@ var analyticsAnalyticsTopicsStats = {
 	topicsRankedFooter: "共 {total} 个主题，显示 {shown} 个 · 按消息量排序"
 };
 var analyticsAnalyticsTranscriptsStats = {
+	anonymous: "匿名",
 	justNow: "刚刚",
 	minutesAgo: "{count} 分钟前",
 	hoursAgo: "{count} 小时前",
@@ -221826,7 +221838,7 @@ function RetrievedDocumentsButton({ sessionId = '', documents, className, label,
                     // Safe inside clickable transcript rows: the row must not react.
                     event.stopPropagation();
                     setIsOpen(true);
-                }, "data-testid": "retrieved-documents-button", children: [jsx(FileText, { className: "h-4 w-4 text-blue-600" }), jsx("span", { children: label !== null && label !== void 0 ? label : t('retrievedDocumentsButton.title') })] }), jsx(Dialog, { open: isOpen, onOpenChange: setIsOpen, children: jsxs(DialogContent, { className: "flex max-h-[80vh] flex-col gap-0 p-0 sm:max-w-[425px] md:max-w-[600px]", children: [jsx(DialogHeader, { className: "border-b px-4 py-2", children: jsxs(DialogTitle, { className: "flex items-center gap-2 text-base font-medium text-[#646464]", children: [jsx(FileText, { className: "h-5 w-5 text-blue-600" }), t('retrievedDocumentsButton.title')] }) }), jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", "data-testid": "retrieved-documents-scroll", children: jsx(DocumentSidebar, { isModal: true, sessionId: sessionId, documents: documents }) })] }) })] }));
+                }, "data-testid": "retrieved-documents-button", children: [jsx(FileText, { className: "h-4 w-4 text-blue-600" }), jsx("span", { children: label !== null && label !== void 0 ? label : t('retrievedDocumentsButton.title') })] }), jsx(Dialog, { open: isOpen, onOpenChange: setIsOpen, children: jsxs(DialogContent, { className: "flex max-h-[80vh] flex-col gap-0 p-0 sm:max-w-[425px] md:max-w-[600px]", children: [jsx(DialogHeader, { className: "border-b border-gray-200 px-4 py-2", children: jsxs(DialogTitle, { className: "flex items-center gap-2 text-base font-medium text-[#646464]", children: [jsx(FileText, { className: "h-5 w-5 text-blue-600" }), t('retrievedDocumentsButton.title')] }) }), jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", "data-testid": "retrieved-documents-scroll", children: jsx(DocumentSidebar, { isModal: true, sessionId: sessionId, documents: documents }) })] }) })] }));
 }
 
 var COLLAPSIBLE_NAME = "Collapsible";
@@ -222288,6 +222300,11 @@ function useLlmDisplayName({ llmName, llmConfig, org, userId, mentorId, }) {
  * white circle (the catalogue's artwork, or the bot icon when it has none)
  * beside the model's display name. Read-only; used on admin transcripts to
  * name the model a turn ran on.
+ *
+ * It sets no font size, weight or colour of its own and sizes the logo in
+ * `em`, so it reads as one more fact in whatever row holds it — a `text-xs
+ * text-gray-500` transcript card or the details panel — rather than as a
+ * larger, bolder pill beside them. Pass `className` for the nav bar's look.
  */
 function LlmModelBadge({ model, provider, tenantKey, mentorId, className, }) {
     var _a, _b;
@@ -222308,9 +222325,9 @@ function LlmModelBadge({ model, provider, tenantKey, mentorId, className, }) {
     const label = displayName || providerDetails.displayName;
     if (!label)
         return null;
-    return (jsxs("span", { className: cn('inline-flex max-w-full items-center gap-2 text-sm font-medium text-[#646464]', className), title: providerDetails.displayName && providerDetails.displayName !== label
+    return (jsxs("span", { className: cn('inline-flex max-w-full items-center gap-[0.5em] align-middle', className), title: providerDetails.displayName && providerDetails.displayName !== label
             ? `${label} · ${providerDetails.displayName}`
-            : label, "data-testid": "llm-model-badge", children: [jsx("span", { className: "flex h-6 w-6 flex-shrink-0 items-center justify-center rounded-full bg-white", children: providerDetails.logo ? (jsx("img", { src: providerDetails.logo, alt: `${label} model logo`, className: "h-5 w-5 object-contain", height: 32, width: 32, loading: "lazy" })) : (jsx(Bot, { className: "h-4 w-4", "aria-hidden": "true" })) }), jsx("span", { className: "max-w-[220px] truncate", children: label })] }));
+            : label, "data-testid": "llm-model-badge", children: [jsx("span", { className: "flex h-[1.5em] w-[1.5em] flex-shrink-0 items-center justify-center rounded-full bg-white", children: providerDetails.logo ? (jsx("img", { src: providerDetails.logo, alt: `${label} model logo`, className: "h-[1.25em] w-[1.25em] object-contain", height: 32, width: 32, loading: "lazy" })) : (jsx(Bot, { className: "h-[1em] w-[1em]", "aria-hidden": "true" })) }), jsx("span", { className: "max-w-[220px] truncate", children: label })] }));
 }
 
 /** SPAs whose users have coursework, so the profile leads with a Gradebook tab. */
@@ -222356,17 +222373,18 @@ function UserProfileDialog({ tenantKey, username, isOpen, onClose, customization
 function UserProfileLink({ tenantKey, username, display, className, testId, customization, currentSPA, }) {
     const t = useT();
     const [isOpen, setIsOpen] = React__default.useState(false);
+    // The text truncates inside an `inline-flex` box: an `inline-block` with
+    // hidden overflow puts its baseline on its bottom edge, so the value would
+    // ride above the "User:" label beside it.
     if (!username) {
-        // `inline-block`, or `truncate`'s `overflow: hidden` has nothing to clip:
-        // an inline box takes its width from its own text.
-        return (jsx("span", { className: cn('inline-block max-w-full truncate', className), "data-testid": testId, children: display }));
+        return (jsx("span", { className: cn('inline-flex max-w-full', className), "data-testid": testId, children: jsx("span", { className: "min-w-0 truncate", children: display }) }));
     }
     return (jsxs(Fragment$1, { children: [jsx("button", { type: "button", onClick: (event) => {
                     event.stopPropagation();
                     setIsOpen(true);
                 }, 
                 // Rows that open on Enter/Space would otherwise swallow the key press.
-                onKeyDown: (event) => event.stopPropagation(), className: cn('max-w-full cursor-pointer truncate text-left hover:text-blue-600 hover:underline focus:text-blue-600 focus:outline-none', className), "aria-label": t('tabsUserstab.viewProfileAriaLabel', { name: display }), "data-testid": testId, children: display }), jsx(UserProfileDialog, { tenantKey: tenantKey, username: username, isOpen: isOpen, onClose: () => setIsOpen(false), customization: customization, currentSPA: currentSPA })] }));
+                onKeyDown: (event) => event.stopPropagation(), className: cn('inline-flex max-w-full cursor-pointer text-left hover:text-blue-600 hover:underline focus:text-blue-600 focus:outline-none', className), "aria-label": t('tabsUserstab.viewProfileAriaLabel', { name: display }), "data-testid": testId, children: jsx("span", { className: "min-w-0 truncate", children: display }) }), jsx(UserProfileDialog, { tenantKey: tenantKey, username: username, isOpen: isOpen, onClose: () => setIsOpen(false), customization: customization, currentSPA: currentSPA })] }));
 }
 
 const AdvancedPagination = ({ currentPage, totalPages, onPageChange, totalCount, itemsPerPage, itemLabel = 'items', variant = 'default', className, }) => {
@@ -259773,6 +259791,154 @@ AnalyticsScopeContext.Provider;
 
 Array.from({ length: 24 }, (_, i) => i);
 
+/**
+ * One place that decides how a user is shown.
+ *
+ * Backend payloads name their user in a dozen ways — `email` / `lti_email` /
+ * `user_email`, `username` / `student` / `lti_username`, `name` /
+ * `full_name` / `user_full_name`, or a nested `user` object — and most of
+ * them can be empty, `null`, or a placeholder like "None". Every surface used
+ * to pick through those on its own. `resolveUserIdentity()` takes whatever
+ * the payload is and returns what to show, what to open a profile on, and
+ * the avatar initial, so the rule lives here and can be tweaked once.
+ *
+ * Default rule: a real full name first (see {@link hasDistinctName}), else
+ * email → username → the anonymous label.
+ */
+const DEFAULT_USER_IDENTITY_ORDER = ['email', 'name', 'username'];
+/** Order used when the payload carries a real name (see {@link hasDistinctName}). */
+const NAME_FIRST_ORDER = ['name', 'email', 'username'];
+/**
+ * Lower-case letters and digits of any script, accents and punctuation dropped,
+ * so "Conrad Mugabe" / "conrad.mugabe" and "José" / "jose" compare equal.
+ */
+const identityKey = (value) => (value !== null && value !== void 0 ? value : '')
+    .normalize('NFKD')
+    .replace(/[^\p{L}\p{N}]/gu, '')
+    .toLowerCase();
+/**
+ * Whether `name` is a real name rather than a restatement of the username.
+ *
+ * Many payloads fill the name field with the username ("conradmugabe" →
+ * "Conrad Mugabe", "fayyaz_4_ibleducation_com"), which tells an admin nothing
+ * the email does not. A name that matches none of the usernames on the record
+ * is the most recognisable thing on it — including for LTI learners, whose
+ * minted `<opaque-id>@edx-lti-1p3.com` address and username identify nobody.
+ */
+function hasDistinctName(name, ...usernames) {
+    const key = identityKey(name);
+    if (!key)
+        return false;
+    return usernames.every((username) => key !== identityKey(username));
+}
+const DEFAULT_ANONYMOUS_LABEL = 'Anonymous';
+/** Values backends emit instead of "nothing". Compared case-insensitively. */
+const PLACEHOLDERS = new Set([
+    '',
+    'none',
+    'null',
+    'undefined',
+    'n/a',
+    'na',
+    '-',
+    'anonymous',
+    'anonymoususer',
+]);
+/**
+ * `local@domain.tld` with no whitespace, checked with a single pass rather than
+ * a backtracking pattern (CodeQL flags `[^@]+@[^@]+\.[^@]+` as polynomial on
+ * adversarial input).
+ */
+const isEmailLike = (value) => {
+    const text = value.trim();
+    if (!text || /\s/.test(text))
+        return false;
+    const at = text.indexOf('@');
+    if (at <= 0 || at !== text.lastIndexOf('@') || at === text.length - 1)
+        return false;
+    const domain = text.slice(at + 1);
+    const dot = domain.indexOf('.');
+    // A dot somewhere inside the domain, with something after the last one.
+    return dot > 0 && !domain.endsWith('.');
+};
+/** Trimmed string, or undefined for blanks, non-strings and placeholders. */
+const clean = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return PLACEHOLDERS.has(trimmed.toLowerCase()) ? undefined : trimmed;
+};
+const firstOf = (...candidates) => {
+    for (const candidate of candidates) {
+        const value = clean(candidate);
+        if (value)
+            return value;
+    }
+    return undefined;
+};
+const nested = (source) => source.user && typeof source.user === 'object' ? source.user : undefined;
+/**
+ * Resolve how a user should be displayed from any payload that names one.
+ *
+ * - `email`: `lti_email`, `email`, `user_email`, the nested `user`'s email —
+ *   or a username field that turns out to hold an email address.
+ * - `username`: `lti_username`, `username`, `student`, `user_username`, the
+ *   nested `user`'s username, or a bare string `user` value (a numeric id is
+ *   ignored).
+ * - `name`: `user_full_name`, `full_name`, `name`, `first_name last_name`, or
+ *   the nested `user`'s name.
+ * - `profileUsername`: the first *platform* username (never an LTI claim).
+ *
+ * A string source is treated as an email when it looks like one, else as a
+ * username. Placeholder strings ("None", "-", "anonymous"…) count as absent.
+ *
+ * The default order flips to name → email → username when the record carries a
+ * real name (see {@link hasDistinctName}): "Joseph Oti" is more use to an admin
+ * than his address, while a name that merely repeats the username is not, so
+ * those records keep showing the email. An explicit `order` is always obeyed.
+ */
+function resolveUserIdentity(source, options = {}) {
+    var _a, _b;
+    const anonymousLabel = options.anonymousLabel || DEFAULT_ANONYMOUS_LABEL;
+    const order = ((_a = options.order) === null || _a === void 0 ? void 0 : _a.length) ? options.order : DEFAULT_USER_IDENTITY_ORDER;
+    const record = source && typeof source === 'object' ? source : { user: source !== null && source !== void 0 ? source : null };
+    const inner = nested(record);
+    // A bare `user` value is a username — unless it is a numeric id, which
+    // names nobody: transcript rows carry `user: 1` beside `username: null`,
+    // and showing "1" for that person is worse than "Anonymous".
+    const bareString = typeof record.user === 'string' ? clean(record.user) : undefined;
+    const bareUser = bareString && !/^\d+$/.test(bareString) ? bareString : undefined;
+    let email = firstOf(record.lti_email, record.email, record.user_email, inner === null || inner === void 0 ? void 0 : inner.lti_email, inner === null || inner === void 0 ? void 0 : inner.email, inner === null || inner === void 0 ? void 0 : inner.user_email);
+    const platformUsername = firstOf(record.username, record.student, record.user_username, inner === null || inner === void 0 ? void 0 : inner.username, inner === null || inner === void 0 ? void 0 : inner.student, inner === null || inner === void 0 ? void 0 : inner.user_username, bareUser && !isEmailLike(bareUser) ? bareUser : undefined);
+    let username = firstOf(record.lti_username, inner === null || inner === void 0 ? void 0 : inner.lti_username, platformUsername);
+    const composed = [clean(record.first_name), clean(record.last_name)].filter(Boolean).join(' ');
+    const name = firstOf(record.user_full_name, record.full_name, record.name, composed, inner === null || inner === void 0 ? void 0 : inner.user_full_name, inner === null || inner === void 0 ? void 0 : inner.full_name, inner === null || inner === void 0 ? void 0 : inner.name);
+    // A bare string that looks like an email is an email, and so is a
+    // "username" field that actually carries one.
+    if (!email && bareUser && isEmailLike(bareUser))
+        email = bareUser;
+    if (!email && username && isEmailLike(username)) {
+        email = username;
+        username = undefined;
+    }
+    const facts = { email, username, name };
+    // Every username on the record counts: the platform one a profile opens on
+    // and the LTI claim that would be displayed.
+    const labelOrder = !((_b = options.order) === null || _b === void 0 ? void 0 : _b.length) && hasDistinctName(name, platformUsername, username)
+        ? NAME_FIRST_ORDER
+        : order;
+    const label = labelOrder.map((field) => facts[field]).find(Boolean);
+    return {
+        label: label !== null && label !== void 0 ? label : anonymousLabel,
+        email,
+        username,
+        name,
+        profileUsername: platformUsername,
+        initial: (label !== null && label !== void 0 ? label : anonymousLabel).charAt(0).toUpperCase() || 'A',
+        isAnonymous: !label,
+    };
+}
+
 const asArray = (value) => (Array.isArray(value) ? value : []);
 const hasEntries = (value) => !!value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0;
 /** Rollup counts as the conversation-list endpoint reports them: numbers, numeric strings or `null`. */
@@ -260084,7 +260250,7 @@ function SectionHeading({ icon, children }) {
     return (jsxs("h4", { className: "mb-2 flex items-center gap-1.5 text-xs font-semibold tracking-wide text-gray-700 uppercase", children: [icon, children] }));
 }
 const MODEL_KEYS = new Set(['llm_model', 'llm_provider']);
-function MetadataSection({ metadata, renderModel, }) {
+function MetadataSection({ metadata, renderModel, tenantKey, mentorId, }) {
     var _a, _b;
     const t = useT();
     const labelFor = useFieldLabels();
@@ -260092,7 +260258,9 @@ function MetadataSection({ metadata, renderModel, }) {
     const model = ((_a = metadata.llm_model) !== null && _a !== void 0 ? _a : '').trim() || undefined;
     const provider = ((_b = metadata.llm_provider) !== null && _b !== void 0 ? _b : '').trim() || undefined;
     const hasModel = !!(model || provider);
-    return (jsxs("section", { "data-testid": "transcript-turn-metadata", children: [jsx(SectionHeading, { icon: jsx(Info$3, { className: "h-3.5 w-3.5", "aria-hidden": "true" }), children: t('analyticsTranscriptTurnDetails.metadata') }), hasModel && (jsx("div", { "data-testid": "transcript-turn-model", className: "mb-2", children: (renderModel !== null && renderModel !== void 0 ? renderModel : defaultRenderModel)({ model, provider }) })), jsx(DetailRows, { entries: rest, labelFor: labelFor })] }));
+    return (jsxs("section", { "data-testid": "transcript-turn-metadata", children: [jsx(SectionHeading, { icon: jsx(Info$3, { className: "h-3.5 w-3.5", "aria-hidden": "true" }), children: t('analyticsTranscriptTurnDetails.metadata') }), hasModel && (jsx("div", { "data-testid": "transcript-turn-model", className: "mb-2", children: renderModel
+                    ? renderModel({ model, provider })
+                    : defaultRenderModel({ model, provider, tenantKey, mentorId }) })), jsx(DetailRows, { entries: rest, labelFor: labelFor })] }));
 }
 function RequestContextSection({ requestContext }) {
     const t = useT();
@@ -260107,7 +260275,7 @@ function RequestContextSection({ requestContext }) {
  */
 const defaultRenderDocuments = (documents) => (jsx(RetrievedDocumentsButton, { documents: toRetrievedDocuments(documents) }));
 const defaultRenderToolCalls = (toolCalls) => (jsx(ToolCallIndicator, { toolCalls: toToolCallInfos(toolCalls), showResults: true }));
-const defaultRenderModel = ({ model, provider }) => (jsx(LlmModelBadge, { model: model, provider: provider }));
+const defaultRenderModel = ({ model, provider, tenantKey, mentorId, }) => jsx(LlmModelBadge, { model: model, provider: provider, tenantKey: tenantKey, mentorId: mentorId });
 const defaultRenderFiles = (files) => (jsx(TranscriptFileCards, { files: files }));
 /**
  * Collapsible "Sources / Tools / Metadata" panel for one AI turn of an admin
@@ -260117,7 +260285,7 @@ const defaultRenderFiles = (files) => (jsx(TranscriptFileCards, { files: files }
  * renders nothing at all when every field is null or empty, so it is safe to
  * drop under every AI bubble.
  */
-function TranscriptTurnDetails({ turn, className, defaultOpen = false, renderDocuments, renderToolCalls, renderModel, renderFiles, }) {
+function TranscriptTurnDetails({ turn, className, defaultOpen = false, renderDocuments, renderToolCalls, renderModel, renderFiles, tenantKey, mentorId, }) {
     const t = useT();
     const labelFor = useFieldLabels();
     const [open, setOpen] = React__default.useState(defaultOpen);
@@ -260131,7 +260299,7 @@ function TranscriptTurnDetails({ turn, className, defaultOpen = false, renderDoc
     const requestContext = hasEntries(turn === null || turn === void 0 ? void 0 : turn.request_context) ? turn === null || turn === void 0 ? void 0 : turn.request_context : null;
     return (jsx(DetailCtx.Provider, { value: detailContext, children: jsxs(Collapsible, { open: open, onOpenChange: setOpen, className: cn('mt-2', className), "data-testid": "transcript-turn-details", children: [jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [jsx(CollapsibleTrigger, { asChild: true, children: jsxs(Button$1, { type: "button", variant: "outline", size: "sm", className: "flex items-center gap-2 border-gray-200 bg-white text-gray-700 hover:bg-gray-50", "aria-expanded": open, children: [jsx(ChevronDown, { className: cn('h-4 w-4 transition-transform', open && 'rotate-180'), "aria-hidden": "true" }), open
                                         ? t('analyticsTranscriptTurnDetails.hideDetails')
-                                        : t('analyticsTranscriptTurnDetails.showDetails')] }) }), documents.length > 0 && (jsx("div", { "data-testid": "transcript-turn-sources", className: "contents", children: (renderDocuments !== null && renderDocuments !== void 0 ? renderDocuments : defaultRenderDocuments)(documents) })), jsx(TranscriptRollupBadges, { documentsCount: 0, toolCallsCount: toolCalls.length })] }), jsxs(CollapsibleContent, { className: "mt-2 space-y-5 rounded-lg border border-gray-200 bg-white p-3", children: [toolCalls.length > 0 && (jsx("div", { "data-testid": "transcript-turn-tools", children: (renderToolCalls !== null && renderToolCalls !== void 0 ? renderToolCalls : defaultRenderToolCalls)(toolCalls) })), metadata && jsx(MetadataSection, { metadata: metadata, renderModel: renderModel }), requestContext && jsx(RequestContextSection, { requestContext: requestContext })] })] }) }));
+                                        : t('analyticsTranscriptTurnDetails.showDetails')] }) }), documents.length > 0 && (jsx("div", { "data-testid": "transcript-turn-sources", className: "contents", children: (renderDocuments !== null && renderDocuments !== void 0 ? renderDocuments : defaultRenderDocuments)(documents) })), jsx(TranscriptRollupBadges, { documentsCount: 0, toolCallsCount: toolCalls.length })] }), jsxs(CollapsibleContent, { className: "mt-2 space-y-5 rounded-lg border border-gray-200 bg-white p-3", children: [toolCalls.length > 0 && (jsx("div", { "data-testid": "transcript-turn-tools", children: (renderToolCalls !== null && renderToolCalls !== void 0 ? renderToolCalls : defaultRenderToolCalls)(toolCalls) })), metadata && (jsx(MetadataSection, { metadata: metadata, renderModel: renderModel, tenantKey: tenantKey, mentorId: mentorId })), requestContext && jsx(RequestContextSection, { requestContext: requestContext })] })] }) }));
 }
 /**
  * "Documents · N" / "Tools · N" chips for a conversation row, from the
@@ -260147,118 +260315,6 @@ function TranscriptRollupBadges({ documentsCount, toolCallsCount, className, })
     return (jsxs("span", { className: cn('inline-flex flex-wrap items-center gap-1.5', className), "data-testid": "transcript-rollup-badges", children: [documents > 0 && (jsxs(Badge, { variant: "outline", className: "gap-1 border-transparent bg-blue-50 font-normal text-blue-700", "data-testid": "transcript-sources-badge", children: [jsx(FileText, { className: "h-3 w-3", "aria-hidden": "true" }), t('analyticsTranscriptTurnDetails.sourcesBadge', { count: documents })] })), tools > 0 && (jsxs(Badge, { variant: "outline", className: "gap-1 border-transparent bg-amber-50 font-normal text-amber-800", "data-testid": "transcript-tools-badge", children: [jsx(Wrench, { className: "h-3 w-3", "aria-hidden": "true" }), t('analyticsTranscriptTurnDetails.toolsBadge', { count: tools })] }))] }));
 }
 
-/**
- * One place that decides how a user is shown.
- *
- * Backend payloads name their user in a dozen ways — `email` / `lti_email` /
- * `user_email`, `username` / `student` / `lti_username`, `name` /
- * `full_name` / `user_full_name`, or a nested `user` object — and most of
- * them can be empty, `null`, or a placeholder like "None". Every surface used
- * to pick through those on its own. `resolveUserIdentity()` takes whatever
- * the payload is and returns what to show, what to open a profile on, and
- * the avatar initial, so the rule lives here and can be tweaked once.
- *
- * Default rule: email → full name → username → the anonymous label.
- */
-const DEFAULT_USER_IDENTITY_ORDER = ['email', 'name', 'username'];
-const DEFAULT_ANONYMOUS_LABEL = 'Anonymous';
-/** Values backends emit instead of "nothing". Compared case-insensitively. */
-const PLACEHOLDERS = new Set([
-    '',
-    'none',
-    'null',
-    'undefined',
-    'n/a',
-    'na',
-    '-',
-    'anonymous',
-    'anonymoususer',
-]);
-/**
- * `local@domain.tld` with no whitespace, checked with a single pass rather than
- * a backtracking pattern (CodeQL flags `[^@]+@[^@]+\.[^@]+` as polynomial on
- * adversarial input).
- */
-const isEmailLike = (value) => {
-    const text = value.trim();
-    if (!text || /\s/.test(text))
-        return false;
-    const at = text.indexOf('@');
-    if (at <= 0 || at !== text.lastIndexOf('@') || at === text.length - 1)
-        return false;
-    const domain = text.slice(at + 1);
-    const dot = domain.indexOf('.');
-    // A dot somewhere inside the domain, with something after the last one.
-    return dot > 0 && !domain.endsWith('.');
-};
-/** Trimmed string, or undefined for blanks, non-strings and placeholders. */
-const clean = (value) => {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    return PLACEHOLDERS.has(trimmed.toLowerCase()) ? undefined : trimmed;
-};
-const firstOf = (...candidates) => {
-    for (const candidate of candidates) {
-        const value = clean(candidate);
-        if (value)
-            return value;
-    }
-    return undefined;
-};
-const nested = (source) => source.user && typeof source.user === 'object' ? source.user : undefined;
-/**
- * Resolve how a user should be displayed from any payload that names one.
- *
- * - `email`: `lti_email`, `email`, `user_email`, the nested `user`'s email —
- *   or a username field that turns out to hold an email address.
- * - `username`: `lti_username`, `username`, `student`, `user_username`, the
- *   nested `user`'s username, or a bare string/number `user` value.
- * - `name`: `user_full_name`, `full_name`, `name`, `first_name last_name`, or
- *   the nested `user`'s name.
- * - `profileUsername`: the first *platform* username (never an LTI claim).
- *
- * A string source is treated as an email when it looks like one, else as a
- * username. Placeholder strings ("None", "-", "anonymous"…) count as absent.
- */
-function resolveUserIdentity(source, options = {}) {
-    var _a;
-    const anonymousLabel = options.anonymousLabel || DEFAULT_ANONYMOUS_LABEL;
-    const order = ((_a = options.order) === null || _a === void 0 ? void 0 : _a.length) ? options.order : DEFAULT_USER_IDENTITY_ORDER;
-    const record = source && typeof source === 'object' ? source : { user: source !== null && source !== void 0 ? source : null };
-    const inner = nested(record);
-    // A bare `user` value is an id or username; numeric ids are still shown.
-    const bareUser = typeof record.user === 'number' && Number.isFinite(record.user)
-        ? String(record.user)
-        : typeof record.user === 'string'
-            ? clean(record.user)
-            : undefined;
-    let email = firstOf(record.lti_email, record.email, record.user_email, inner === null || inner === void 0 ? void 0 : inner.lti_email, inner === null || inner === void 0 ? void 0 : inner.email, inner === null || inner === void 0 ? void 0 : inner.user_email);
-    const platformUsername = firstOf(record.username, record.student, record.user_username, inner === null || inner === void 0 ? void 0 : inner.username, inner === null || inner === void 0 ? void 0 : inner.student, inner === null || inner === void 0 ? void 0 : inner.user_username, bareUser && !isEmailLike(bareUser) ? bareUser : undefined);
-    let username = firstOf(record.lti_username, inner === null || inner === void 0 ? void 0 : inner.lti_username, platformUsername);
-    const composed = [clean(record.first_name), clean(record.last_name)].filter(Boolean).join(' ');
-    const name = firstOf(record.user_full_name, record.full_name, record.name, composed, inner === null || inner === void 0 ? void 0 : inner.user_full_name, inner === null || inner === void 0 ? void 0 : inner.full_name, inner === null || inner === void 0 ? void 0 : inner.name);
-    // A bare string that looks like an email is an email, and so is a
-    // "username" field that actually carries one.
-    if (!email && bareUser && isEmailLike(bareUser))
-        email = bareUser;
-    if (!email && username && isEmailLike(username)) {
-        email = username;
-        username = undefined;
-    }
-    const facts = { email, username, name };
-    const label = order.map((field) => facts[field]).find(Boolean);
-    return {
-        label: label !== null && label !== void 0 ? label : anonymousLabel,
-        email,
-        username,
-        name,
-        profileUsername: platformUsername,
-        initial: (label !== null && label !== void 0 ? label : anonymousLabel).charAt(0).toUpperCase() || 'A',
-        isAnonymous: !label,
-    };
-}
-
 const AnalyticsSettingsContext = createContext({});
 AnalyticsSettingsContext.Provider;
 
@@ -279113,7 +279169,7 @@ function AgentHistoryTab({ renderMessageContent, PaginationComponent, onExport,
     // Use mentor summaries data for rating and tags
     const averageRating = (mentorSummaries === null || mentorSummaries === void 0 ? void 0 : mentorSummaries.rating) || 0;
     const topicTags = (mentorSummaries === null || mentorSummaries === void 0 ? void 0 : mentorSummaries.tags) || [];
-    // Who the previewed conversation belongs to (email → full name → username → Anonymous).
+    // Who the previewed conversation belongs to (the shared identity rule).
     const identityOptions = { anonymousLabel: labels.conversation.anonymous };
     const selectedOwner = resolveUserIdentity(selectedConversation, identityOptions);
     const previewOwner = resolveUserIdentity(previewConversationContent, identityOptions);
@@ -279175,11 +279231,11 @@ function AgentHistoryTab({ renderMessageContent, PaginationComponent, onExport,
                                                                         jsx(RetrievedDocumentsButton, { documents: documents, label: labels.conversation.documentsChip(rollup.documentsCount), className: "h-6 gap-1 rounded-md border-transparent bg-blue-50 px-2 text-xs font-normal text-blue-700 hover:bg-blue-100 [&_svg]:h-3 [&_svg]:w-3" })), jsx(TranscriptRollupBadges, { documentsCount: 0, toolCallsCount: rollup.toolCallsCount })] }))] }), jsx("div", { className: "flex items-center gap-2 text-sm text-gray-600", children: jsx(ChevronRight, { className: "h-4 w-4" }) })] }, conversation.id));
                                             }) }), totalPages > 1 && PaginationComponent && (jsx("div", { className: "my-2", children: jsx(PaginationComponent, { currentPage: currentPage, totalPages: totalPages, onPageChange: handlePageChange, disabled: isChatHistoryFetching || isChatHistoryLoading, disableNumberedButtons: isMobile }) }))] }), jsx("div", { className: "scrollbar-hide hidden max-h-[500px] flex-col overflow-y-auto rounded-lg border bg-white p-6 shadow-sm md:flex", tabIndex: 0, role: "region", "aria-label": t('tabsHistoryTab.conversationPreviewLabel'), children: selectedConversation && previewConversationContent ? (jsxs(Fragment$1, { children: [jsxs("div", { className: "mb-4", children: [jsx("h3", { className: "mb-1 text-base font-semibold text-gray-700", children: ((_m = selectedConversation.messages[0]) === null || _m === void 0 ? void 0 : _m.human) || labels.conversation.title }), jsx("span", { className: "text-sm text-gray-500", children: format$1(new Date(selectedConversation.inserted_at), "MMM dd, yyyy 'at' h:mm a") }), jsx(RetrievedDocumentsButton, { sessionId: selectedConversation.id, documents: conversationDocuments(selectedConversation.messages).length > 0
                                                             ? conversationDocuments(selectedConversation.messages)
-                                                            : undefined, className: "mt-2" })] }), jsxs("div", { className: "space-y-6", children: [selectedConversation.messages.map((message, index) => (jsxs("div", { className: "space-y-4", children: [jsxs("div", { className: "flex items-start gap-3", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-blue-100", children: jsx("span", { className: "text-sm font-medium text-blue-600", children: selectedOwner.initial }) }), jsxs("div", { className: "flex-1", children: [jsx("div", { className: "font-medium text-gray-700", children: jsx(UserProfileLink, { tenantKey: tenantKey, username: selectedOwner.profileUsername, display: selectedOwner.label, currentSPA: currentSPA }) }), jsx("p", { className: "mt-1 text-sm whitespace-pre-line text-gray-500", children: message.human }), jsx(TranscriptFileCards, { files: attachmentCards(message.human_files) })] })] }), jsxs("div", { className: "flex items-start gap-3 border-t border-gray-200 pt-4", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-gray-100", children: jsx("span", { className: "text-sm font-medium text-gray-600", children: t('tabsHistoryTab.aiAvatarLabel') }) }), jsxs("div", { className: "flex-1", children: [jsx("div", { className: "font-medium text-gray-700", children: labels.conversation.aiAgent }), jsx("div", { className: "mt-1 text-sm text-gray-500", children: renderAiContent(message.ai) }), jsx(TranscriptFileCards, { files: attachmentCards(message.ai_files) }), jsx(TranscriptTurnDetails, { turn: message })] })] })] }, index))), (selectedConversation === null || selectedConversation === void 0 ? void 0 : selectedConversation.memory_tracked) && (jsxs("div", { className: "border-t border-gray-200 pt-4", children: [jsxs(Button$1, { variant: "outline", onClick: () => setShowConversationMemory(!showConversationMemory), className: "flex w-full items-center justify-center gap-2 border-gray-200 text-gray-700 hover:bg-gray-50", children: [jsx(Brain, { className: "h-4 w-4" }), showConversationMemory ? labels.memory.hide : labels.memory.show] }), showConversationMemory && (jsx("div", { className: "mt-4 space-y-6", children: isConversationMemoryLoading ? (jsx("div", { className: "flex items-center justify-center py-4", children: jsx(Spinner, {}) })) : ((_o = conversationMemory === null || conversationMemory === void 0 ? void 0 : conversationMemory.entries) === null || _o === void 0 ? void 0 : _o.length) ? (jsx(Fragment$1, { children: conversationMemory.entries.map((entry, index) => (jsxs("div", { children: [jsx("h4", { className: "mb-3 font-semibold text-gray-900", children: entry.key }), jsx("ul", { className: "space-y-2", children: jsx("li", { className: "flex items-start gap-2 text-sm text-gray-600", children: entry.value }) })] }, index))) })) : (jsx("div", { className: "text-sm text-gray-500", children: labels.memory.notAvailable })) }))] }))] })] })) : (jsx("div", { className: "flex h-full items-center justify-center text-gray-500", children: labels.conversation.selectPrompt })) })] }))] }) }), jsx(Dialog, { open: isConversationPreviewModalOpen, onOpenChange: setIsConversationPreviewModalOpen, children: jsxs(DialogContent, { className: "scrollbar-hide mx-auto max-h-[80vh] max-w-[90vw] overflow-x-hidden overflow-y-auto", children: [jsx(DialogHeader, { children: jsx(DialogTitle, { className: "text-lg font-semibold text-gray-900", children: previewConversationContent
+                                                            : undefined, className: "mt-2" })] }), jsxs("div", { className: "space-y-6", children: [selectedConversation.messages.map((message, index) => (jsxs("div", { className: "space-y-4", children: [jsxs("div", { className: "flex items-start gap-3", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-blue-100", children: jsx("span", { className: "text-sm font-medium text-blue-600", children: selectedOwner.initial }) }), jsxs("div", { className: "flex-1", children: [jsx("div", { className: "font-medium text-gray-700", children: jsx(UserProfileLink, { tenantKey: tenantKey, username: selectedOwner.profileUsername, display: selectedOwner.label, currentSPA: currentSPA }) }), jsx("p", { className: "mt-1 text-sm whitespace-pre-line text-gray-500", children: message.human }), jsx(TranscriptFileCards, { files: attachmentCards(message.human_files) })] })] }), jsxs("div", { className: "flex items-start gap-3 border-t border-gray-200 pt-4", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-gray-100", children: jsx("span", { className: "text-sm font-medium text-gray-600", children: t('tabsHistoryTab.aiAvatarLabel') }) }), jsxs("div", { className: "flex-1", children: [jsx("div", { className: "font-medium text-gray-700", children: labels.conversation.aiAgent }), jsx("div", { className: "mt-1 text-sm text-gray-500", children: renderAiContent(message.ai) }), jsx(TranscriptFileCards, { files: attachmentCards(message.ai_files) }), jsx(TranscriptTurnDetails, { turn: message, tenantKey: tenantKey, mentorId: mentorId })] })] })] }, index))), (selectedConversation === null || selectedConversation === void 0 ? void 0 : selectedConversation.memory_tracked) && (jsxs("div", { className: "border-t border-gray-200 pt-4", children: [jsxs(Button$1, { variant: "outline", onClick: () => setShowConversationMemory(!showConversationMemory), className: "flex w-full items-center justify-center gap-2 border-gray-200 text-gray-700 hover:bg-gray-50", children: [jsx(Brain, { className: "h-4 w-4" }), showConversationMemory ? labels.memory.hide : labels.memory.show] }), showConversationMemory && (jsx("div", { className: "mt-4 space-y-6", children: isConversationMemoryLoading ? (jsx("div", { className: "flex items-center justify-center py-4", children: jsx(Spinner, {}) })) : ((_o = conversationMemory === null || conversationMemory === void 0 ? void 0 : conversationMemory.entries) === null || _o === void 0 ? void 0 : _o.length) ? (jsx(Fragment$1, { children: conversationMemory.entries.map((entry, index) => (jsxs("div", { children: [jsx("h4", { className: "mb-3 font-semibold text-gray-900", children: entry.key }), jsx("ul", { className: "space-y-2", children: jsx("li", { className: "flex items-start gap-2 text-sm text-gray-600", children: entry.value }) })] }, index))) })) : (jsx("div", { className: "text-sm text-gray-500", children: labels.memory.notAvailable })) }))] }))] })] })) : (jsx("div", { className: "flex h-full items-center justify-center text-gray-500", children: labels.conversation.selectPrompt })) })] }))] }) }), jsx(Dialog, { open: isConversationPreviewModalOpen, onOpenChange: setIsConversationPreviewModalOpen, children: jsxs(DialogContent, { className: "scrollbar-hide mx-auto max-h-[80vh] max-w-[90vw] overflow-x-hidden overflow-y-auto", children: [jsx(DialogHeader, { children: jsx(DialogTitle, { className: "text-lg font-semibold text-gray-900", children: previewConversationContent
                                     ? ((_p = previewConversationContent.messages[0]) === null || _p === void 0 ? void 0 : _p.human) || labels.conversation.title
                                     : labels.conversation.title }) }), jsx("div", { className: "mx-auto max-w-full overflow-x-hidden", children: previewConversationContent && (jsxs("div", { className: "scrollbar-hide space-y-4 overflow-y-auto", children: [jsx("div", { className: "text-sm text-gray-500", children: format$1(new Date(previewConversationContent.inserted_at), "MMM dd, yyyy 'at' h:mm a") }), jsx(RetrievedDocumentsButton, { sessionId: previewConversationContent.id, documents: conversationDocuments(previewConversationContent.messages).length > 0
                                             ? conversationDocuments(previewConversationContent.messages)
-                                            : undefined }), previewConversationContent.messages.map((message, index) => (jsxs("div", { className: "space-y-4", children: [jsxs("div", { className: "flex items-start gap-3", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-blue-100", children: jsx("span", { className: "text-sm font-medium text-blue-600", children: previewOwner.initial }) }), jsxs("div", { className: "overflow-x-hidden", children: [jsx("div", { className: "truncate font-medium text-gray-900", children: jsx(UserProfileLink, { tenantKey: tenantKey, username: previewOwner.profileUsername, display: previewOwner.label, currentSPA: currentSPA }) }), jsx("p", { className: "mt-1 text-sm whitespace-pre-line text-gray-900", children: message.human }), jsx(TranscriptFileCards, { files: attachmentCards(message.human_files) })] })] }), jsxs("div", { className: "flex items-start gap-3 border-t border-gray-200 pt-4", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-gray-100", children: jsx("span", { className: "text-sm font-medium text-gray-600", children: t('tabsHistoryTab.aiAvatarLabel') }) }), jsxs("div", { className: "overflow-x-hidden", children: [jsx("div", { className: "font-medium text-gray-900", children: labels.conversation.aiAgent }), jsx("div", { className: "mt-1 text-sm text-gray-900", children: renderAiContent(message.ai) }), jsx(TranscriptFileCards, { files: attachmentCards(message.ai_files) }), jsx(TranscriptTurnDetails, { turn: message })] })] })] }, index)))] })) })] }) })] }));
+                                            : undefined }), previewConversationContent.messages.map((message, index) => (jsxs("div", { className: "space-y-4", children: [jsxs("div", { className: "flex items-start gap-3", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-blue-100", children: jsx("span", { className: "text-sm font-medium text-blue-600", children: previewOwner.initial }) }), jsxs("div", { className: "overflow-x-hidden", children: [jsx("div", { className: "truncate font-medium text-gray-900", children: jsx(UserProfileLink, { tenantKey: tenantKey, username: previewOwner.profileUsername, display: previewOwner.label, currentSPA: currentSPA }) }), jsx("p", { className: "mt-1 text-sm whitespace-pre-line text-gray-900", children: message.human }), jsx(TranscriptFileCards, { files: attachmentCards(message.human_files) })] })] }), jsxs("div", { className: "flex items-start gap-3 border-t border-gray-200 pt-4", children: [jsx("div", { className: "flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full bg-gray-100", children: jsx("span", { className: "text-sm font-medium text-gray-600", children: t('tabsHistoryTab.aiAvatarLabel') }) }), jsxs("div", { className: "overflow-x-hidden", children: [jsx("div", { className: "font-medium text-gray-900", children: labels.conversation.aiAgent }), jsx("div", { className: "mt-1 text-sm text-gray-900", children: renderAiContent(message.ai) }), jsx(TranscriptFileCards, { files: attachmentCards(message.ai_files) }), jsx(TranscriptTurnDetails, { turn: message, tenantKey: tenantKey, mentorId: mentorId })] })] })] }, index)))] })) })] }) })] }));
 }
 
 const ANONYMOUS_USERNAME = 'anonymous';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/iblai-js",
-  "version": "2.18.0",
+  "version": "2.19.0",
   "description": "Unified JavaScript SDK for IBL.ai — re-exports data-layer, web-containers, and web-utils under a single package",
   "type": "module",
   "engines": {
@@ -76,10 +76,10 @@
     "axios": "1.13.6",
     "dotenv": "16.6.1",
     "winston": "3.19.0",
-    "@iblai/data-layer": "1.19.0",
-    "@iblai/mcp": "1.16.0",
-    "@iblai/web-containers": "1.25.0",
-    "@iblai/web-utils": "2.4.8"
+    "@iblai/mcp": "1.17.0",
+    "@iblai/web-containers": "1.26.0",
+    "@iblai/data-layer": "1.19.1",
+    "@iblai/web-utils": "2.5.0"
   },
   "peerDependencies": {
     "@iblai/iblai-api": "4.166.0-ai",