@iblai/data-layer 1.18.0 → 1.18.1

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/data-layer",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "ibl.ai data layer",
   "main": "dist/index.esm.js",
   "types": "dist/index.d.ts",

package/dist/src/features/analytics/types.d.ts

@@ -67,6 +67,12 @@ export interface TranscriptsMessagesDetailsResponse {
         mentor: string;
         mentor_unique_id: string;
         model: string;
+        /**
+         * Provider key of `model` (e.g. `openai`), as the per-turn
+         * `metadata.llm_provider` names it. Not sent by the backend yet; when it
+         * is, the transcript badge resolves its logo from it directly.
+         */
+        llm_provider?: string | null;
         username: string;
         name: string;
         /** Preferred over `name`/`username` in the UI; older deployments omit it. */
@@ -83,14 +89,53 @@ export interface TranscriptsMessagesDetailsResponse {
         session: string;
         user: number;
     };
-    messages: Array<{
-        human: string;
-        ai: string;
-        /** Attachments uploaded with the human turn; a file-only turn has `human: ""`. */
-        human_files?: TranscriptFile[] | null;
-        /** Files produced by the assistant turn (same shape as `human_files`). */
-        ai_files?: TranscriptFile[] | null;
-    }>;
+    messages: TranscriptMessage[];
+}
+/** One human/AI exchange of a transcript, with its attachments and extended context. */
+export interface TranscriptMessage extends TranscriptTurnExtendedContext {
+    human: string;
+    ai: string;
+    /** Attachments uploaded with the human turn; a file-only turn has `human: ""`. */
+    human_files?: TranscriptFile[] | null;
+    /** Files produced by the assistant turn (same shape as `human_files`). */
+    ai_files?: TranscriptFile[] | null;
+}
+/** A document the agent retrieved while producing an AI turn (a RAG source). */
+export interface TranscriptRetrievedDocument {
+    source?: string | null;
+    title?: string | null;
+    snippet?: string | null;
+    score?: number | null;
+    confidence_level?: string | number | null;
+    [key: string]: unknown;
+}
+/** A tool the agent called while producing an AI turn. `input`/`output` are free-form. */
+export interface TranscriptToolCall {
+    name?: string | null;
+    input?: unknown;
+    output?: unknown;
+    [key: string]: unknown;
+}
+/** Backend metadata recorded for an AI turn. Known keys are typed; anything else passes through. */
+export interface TranscriptTurnMetadata {
+    client?: Record<string, unknown> | null;
+    llm_model?: string | null;
+    llm_provider?: string | null;
+    llm_temperature?: number | null;
+    [key: string]: unknown;
+}
+/**
+ * Extended per-turn context — retrieved documents, tool calls, metadata and the
+ * request context — that the backend attaches to each AI turn on the admin
+ * surfaces only (`analytics/messages/details/` and the admin `chat-history/`
+ * list). The learner-facing `my-chat-history` endpoints never carry these.
+ * Every field may be `null` or empty for turns with no retrieval/tool activity.
+ */
+export interface TranscriptTurnExtendedContext {
+    documents?: TranscriptRetrievedDocument[] | null;
+    tool_calls?: TranscriptToolCall[] | null;
+    metadata?: TranscriptTurnMetadata | null;
+    request_context?: Record<string, unknown> | null;
 }
 /** A file attached to a transcript message; `url` is a presigned, time-limited link. */
 export interface TranscriptFile {
@@ -117,6 +162,12 @@ export interface TranscriptsMessagesResponse {
         mentor: string;
         mentor_unique_id: string;
         model: string;
+        /**
+         * Provider key of `model` (e.g. `openai`). Not sent by the backend yet;
+         * when it is, the list card's model badge shows the provider logo from it
+         * instead of inferring the provider from the model name.
+         */
+        llm_provider?: string | null;
         cost: number;
         username: string;
         name: string;
@@ -133,6 +184,14 @@ export interface TranscriptsMessagesResponse {
         platform: number;
         session: string;
         user: number;
+        /**
+         * Rollups of the extended per-turn context, so rows can be badged without
+         * opening the conversation. The generated API client types them as strings;
+         * older backends omit them. Zero / false when there is no extended history.
+         */
+        documents_count?: number | string | null;
+        tool_calls_count?: number | string | null;
+        used_documents?: boolean | string | null;
     }>;
     pagination: {
         page: number;

package/dist/src/features/user-chat-history/types.d.ts

@@ -1,3 +1,4 @@
+import type { TranscriptFile } from '../analytics/types';
 export type UserChatHistoryTopic = {
     id?: number;
     name: string;
@@ -17,6 +18,10 @@ export type UserChatHistoryMessage = {
     ai: string;
     human_message_inserted_at?: string;
     ai_message_inserted_at?: string;
+    /** Files the user attached to the turn (presigned `url`); a file-only turn has `human: ""`. */
+    human_files?: TranscriptFile[] | null;
+    /** Files the assistant produced on the turn. */
+    ai_files?: TranscriptFile[] | null;
 };
 export type UserChatHistorySession = {
     id: string;