@iblai/iblai-js 2.5.8 → 2.5.9

package/dist/data-layer/playwright/history-tab-helpers.d.ts

@@ -0,0 +1,148 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * Profile History tab Playwright bindings (user profile modal > History).
+ *
+ * The tab has two sub-tabs:
+ *  1. **Conversations** — filter row (agent autocomplete, date range,
+ *     sentiment, topic, Export), a two-column conversation list + transcript
+ *     preview, and numbered pagination.
+ *  2. **Exports** — a table of previously generated `my-chat-history`
+ *     reports with state badges and re-download actions.
+ *
+ * Anti-flake rules baked into every helper:
+ *  - The profile dialog is captured ONCE via `getProfileDialog` — a
+ *    `getByRole('dialog')` + `.filter(...)` pair — and every sub-element is
+ *    resolved from that scoped locator. Page-level queries are used only for
+ *    Radix portals (select dropdowns, toasts).
+ *  - Selectors are role / aria-label / data-testid based only — no CSS
+ *    classes, no `networkidle`; readiness is always "wait for the element".
+ */
+export declare const HISTORY_TAB_LABELS: {
+    /** Tab name in the user profile modal sidebar. */
+    readonly tabName: "History";
+    readonly subTabs: {
+        readonly conversations: "Conversations";
+        readonly exports: "Exports";
+    };
+    readonly filters: {
+        /** Placeholder (and accessible name) of the agent autocomplete input. */
+        readonly searchAgents: "Search Agents";
+        readonly pickDateRange: "Pick a Date Range";
+        /** `aria-label` of the sentiment select trigger. */
+        readonly sentiment: "Filter by Sentiment";
+        /** `aria-label` of the topic select trigger. */
+        readonly topic: "Filter by Topic";
+        readonly export: "Export";
+        readonly exporting: "Exporting...";
+    };
+    readonly regions: {
+        /** `aria-label` of the conversation list region. */
+        readonly list: "Conversation list";
+        /** `aria-label` of the transcript preview region. */
+        readonly preview: "Conversation preview";
+    };
+    /** Per-conversation download button in the preview header. */
+    readonly download: "Download";
+    readonly emptyState: "No conversations found";
+    readonly selectPrompt: "Select a conversation to view details.";
+    readonly toasts: {
+        readonly exportReady: "Your chat history has been downloaded.";
+        readonly exportFailed: "Failed to export chat history. Please try again.";
+    };
+    readonly exports: {
+        readonly columns: {
+            readonly status: "Status";
+            readonly created: "Created";
+            readonly filters: "Filters";
+            readonly expires: "Expires";
+        };
+        readonly states: {
+            readonly completed: "Completed";
+            readonly processing: "Processing";
+            readonly pending: "Pending";
+            readonly failed: "Failed";
+        };
+        readonly empty: "No exports yet.";
+    };
+};
+export type HistorySubTab = 'Conversations' | 'Exports';
+export type HistorySentiment = 'Positive' | 'Neutral' | 'Negative';
+/**
+ * The user profile dialog, captured tag-first (`getByRole('dialog')`) and
+ * narrowed by a solid child — the History tab button — so it never matches
+ * a different dialog stacked on the page.
+ */
+export declare function getProfileDialog(page: Page): Locator;
+/**
+ * Open the History tab inside the (already open) profile dialog and wait
+ * for its Conversations sub-tab to render. Returns the scoped dialog
+ * locator every other helper should be handed.
+ */
+export declare function openHistoryTab(page: Page): Promise<Locator>;
+/**
+ * Switch between the Conversations and Exports sub-tabs, waiting for a
+ * stable landmark of the destination before returning.
+ */
+export declare function switchHistorySubTab(dialog: Locator, subTab: HistorySubTab): Promise<void>;
+export declare function getConversationList(dialog: Locator): Locator;
+export declare function getConversationPreview(dialog: Locator): Locator;
+/** Every conversation row in the list (each row is a `role="button"`). */
+export declare function getConversationRows(dialog: Locator): Locator;
+/**
+ * Wait for the conversation area to settle into one of its two valid
+ * states: at least one row rendered, or the empty state.
+ */
+export declare function waitForConversations(dialog: Locator): Promise<void>;
+/**
+ * Click a conversation row — by zero-based `index`, or the first row whose
+ * text contains `title` — then wait for the transcript preview to show its
+ * per-conversation Download button (the signal the messages have loaded).
+ */
+export declare function selectConversation(dialog: Locator, options?: {
+    index?: number;
+    title?: string;
+}): Promise<void>;
+/**
+ * Download the currently previewed conversation as CSV (client-side file).
+ * Returns the Playwright `Download` so the test can assert on the file.
+ */
+export declare function downloadConversationCsv(dialog: Locator): Promise<import("@playwright/test").Download>;
+/**
+ * Type into the agent autocomplete and pick the result whose label matches
+ * `agentName`, then wait for the picker to collapse into its selected chip.
+ */
+export declare function filterHistoryByAgent(dialog: Locator, agentName: string): Promise<void>;
+/** Clear the agent filter chip and wait for the search input to return. */
+export declare function clearHistoryAgentFilter(dialog: Locator): Promise<void>;
+export declare function filterHistoryBySentiment(dialog: Locator, sentiment: HistorySentiment | 'All Sentiments'): Promise<void>;
+export declare function filterHistoryByTopic(dialog: Locator, topic: string | 'All Topics'): Promise<void>;
+/**
+ * Click Export on the Conversations sub-tab. The report generates
+ * server-side and downloads automatically when ready — pass the returned
+ * promise handling to `waitForHistoryExportDownload` for the full flow.
+ */
+export declare function startHistoryExport(dialog: Locator): Promise<void>;
+/**
+ * Full export flow: click Export, then wait for the report to finish
+ * polling and the browser download to fire. Report generation is a
+ * background task, so the timeout is generous by default.
+ */
+export declare function exportHistoryAndWaitForDownload(dialog: Locator, { timeout }?: {
+    timeout?: number;
+}): Promise<import("@playwright/test").Download>;
+/** The Exports sub-tab's reports table. */
+export declare function getExportsTable(dialog: Locator): Locator;
+/**
+ * Rows of the Exports table matching a state badge label (e.g.
+ * `Completed`), each of which carries its own Download action when done.
+ */
+export declare function getExportRowsByState(dialog: Locator, state: string): Locator;
+/**
+ * Wait until at least one report row reaches the Completed state. Reports
+ * finish asynchronously, so the timeout is generous by default.
+ */
+export declare function waitForCompletedExportRow(dialog: Locator, { timeout }?: {
+    timeout?: number;
+}): Promise<Locator>;
+/** Re-download a completed report from its Exports-table row. */
+export declare function downloadExportedReport(dialog: Locator, row: Locator): Promise<import("@playwright/test").Download>;

package/dist/data-layer/playwright/index.d.ts

@@ -44,5 +44,6 @@ export type { TaskRepeat, TaskStatus } from './tasks-tab-helpers';
 export * from './evaluation-tab-helpers';
 export * from './lti-tab-helpers';
 export * from './human-support-tab-helpers';
+export * from './history-tab-helpers';
 export { createPlaywrightConfig, generateProjectConfig, generateBrowserSetupProjects, getBrowserKey, } from './playwright-config';
 export type { PlatformConfig, CreatePlaywrightConfigOptions } from './playwright-config';

package/dist/data-layer/playwright/memory-admin-helpers.d.ts

@@ -131,6 +131,14 @@ export declare function toggleUserMemoryAdminSetting(page: Page, popup: Locator,
 /**
  * Filter the agents table to one agent via the autocomplete: types the name,
  * clicks the matching option, and gates on the selected chip rendering.
+ *
+ * Retries with progressively shorter PREFIXES of the name. The options come
+ * from a debounced server-side mentors search whose response RTK Query
+ * caches per search term — so when a just-created mentor hasn't reached the
+ * search backend yet, the first (empty) response keeps being served from
+ * cache for as long as the typed term stays the same, and waiting on the
+ * DOM alone can never recover. Each shorter prefix is a DISTINCT term that
+ * forces a fresh fetch, and still matches the mentor server-side.
  */
 export declare function filterAgentMemories(page: Page, agentName: string): Promise<void>;
 /** Clear the agents autocomplete filter (back to the full agents list). */