npm - @iblai/iblai-js - Versions diffs - 2.5.0 → 2.5.5 - Mend

@iblai/iblai-js 2.5.0 → 2.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

package/dist/data-layer/playwright/index.d.ts +4 -2
package/dist/data-layer/playwright/lti-tab-helpers.d.ts +36 -1
package/dist/data-layer/playwright/memory-admin-helpers.d.ts +153 -0
package/dist/data-layer/playwright/memory-test-helpers.d.ts +8 -7
package/dist/data-layer/playwright/voice-tab-helpers.d.ts +32 -0
package/dist/playwright/index.cjs +550 -26
package/dist/playwright/index.cjs.map +1 -1
package/dist/playwright/index.d.ts +231 -10
package/dist/playwright/index.esm.js +521 -27
package/dist/playwright/index.esm.js.map +1 -1
package/dist/playwright/playwright/index.d.ts +4 -2
package/dist/playwright/playwright/lti-tab-helpers.d.ts +36 -1
package/dist/playwright/playwright/memory-admin-helpers.d.ts +153 -0
package/dist/playwright/playwright/memory-test-helpers.d.ts +8 -7
package/dist/playwright/playwright/voice-tab-helpers.d.ts +32 -0
package/dist/security/playwright/index.d.ts +4 -2
package/dist/security/playwright/lti-tab-helpers.d.ts +36 -1
package/dist/security/playwright/memory-admin-helpers.d.ts +153 -0
package/dist/security/playwright/memory-test-helpers.d.ts +8 -7
package/dist/security/playwright/voice-tab-helpers.d.ts +32 -0
package/dist/web-containers/playwright/index.d.ts +4 -2
package/dist/web-containers/playwright/lti-tab-helpers.d.ts +36 -1
package/dist/web-containers/playwright/memory-admin-helpers.d.ts +153 -0
package/dist/web-containers/playwright/memory-test-helpers.d.ts +8 -7
package/dist/web-containers/playwright/voice-tab-helpers.d.ts +32 -0
package/dist/web-containers/source/index.esm.js +12524 -11248
package/dist/web-containers/source/next/index.esm.js +1740 -444
package/dist/web-utils/playwright/index.d.ts +4 -2
package/dist/web-utils/playwright/lti-tab-helpers.d.ts +36 -1
package/dist/web-utils/playwright/memory-admin-helpers.d.ts +153 -0
package/dist/web-utils/playwright/memory-test-helpers.d.ts +8 -7
package/dist/web-utils/playwright/voice-tab-helpers.d.ts +32 -0
package/package.json +4 -4

package/dist/playwright/index.cjs CHANGED Viewed

@@ -1618,19 +1618,20 @@ async function openAddMemoryDialog(page) {
     return dialog;
 }
 /**
- * Toggle a memory setting switch and verify the state changes.
- * Returns the new checked state.
+ * Toggle a memory setting switch and verify the state changes. Completion is
+ * gated on `aria-checked` flipping — which only happens once the settings
+ * mutation resolves — rather than on timing. Returns the new checked state.
  */
 async function toggleMemorySwitch(page, switchName) {
     const switchEl = page.getByRole('switch', { name: switchName });
     await test$1.expect(switchEl).toBeVisible({ timeout: 10000 });
     const wasChecked = await switchEl.isChecked();
     await switchEl.click();
-    // Wait for API response
-    await page.waitForTimeout(1000);
-    const isNowChecked = await switchEl.isChecked();
-    logger.info(`Toggled "${switchName}" from ${wasChecked} to ${isNowChecked}`);
-    return isNowChecked;
+    await test$1.expect(switchEl).toHaveAttribute('aria-checked', String(!wasChecked), {
+        timeout: 15000,
+    });
+    logger.info(`Toggled "${switchName}" from ${wasChecked} to ${!wasChecked}`);
+    return !wasChecked;
 }
 /**
  * Add a memory via the Add Memory dialog.
@@ -1650,32 +1651,47 @@ async function addMemory(page, content) {
     logger.info(`Added memory: "${content}"`);
 }
 /**
- * Delete the first visible memory in the list.
- * Hovers to reveal the delete button, then clicks it.
+ * Delete a memory row via its three-dots menu: opens the menu, clicks
+ * Delete, and confirms in the Delete Memory dialog. The confirmation dialog
+ * is resolved into its own Locator first (topmost dialog matching the
+ * title), and completion is gated on it closing after the mutation resolves.
+ */
+async function deleteMemoryRow(page, memoryRow) {
+    const menuTrigger = memoryRow.getByRole('button', { name: /^Memory actions:/ });
+    await test$1.expect(menuTrigger).toBeVisible({ timeout: 5000 });
+    await menuTrigger.click();
+    // The menu portals to <body>; only one dropdown menu is ever open at once.
+    const deleteItem = page.getByRole('menuitem', { name: 'Delete', exact: true });
+    await test$1.expect(deleteItem).toBeVisible({ timeout: 5000 });
+    await deleteItem.click();
+    // Deleting asks for confirmation; the dialog stacks on top of everything.
+    const confirmDialog = page.getByRole('dialog').filter({ hasText: 'Delete Memory' }).last();
+    await test$1.expect(confirmDialog).toBeVisible({ timeout: 5000 });
+    await confirmDialog.getByRole('button', { name: 'Delete', exact: true }).click();
+    await test$1.expect(confirmDialog).toBeHidden({ timeout: 15000 });
+}
+/**
+ * Delete the first visible memory in the list through its three-dots menu,
+ * confirming in the Delete Memory dialog.
  */
 async function deleteFirstMemory(page) {
-    const deleteButton = page.locator('button[aria-label^="Delete memory:"]').first();
-    await test$1.expect(deleteButton).toBeVisible({ timeout: 5000 });
-    await deleteButton.hover();
-    await deleteButton.click();
-    // Wait for delete action to complete
-    await page.waitForTimeout(2000);
+    const memoryRow = page.getByTestId('memory-row').first();
+    await test$1.expect(memoryRow).toBeVisible({ timeout: 5000 });
+    await deleteMemoryRow(page, memoryRow);
     logger.info('Memory deleted successfully');
 }
 /**
- * Delete a specific memory by matching its content text.
- * Finds the memory item containing the text, hovers to reveal
- * the delete button, and clicks it.
+ * Delete a specific memory by matching its content text through its
+ * three-dots menu, confirming in the Delete Memory dialog. Completion is
+ * gated on the row leaving the list after the refetch.
  */
 async function deleteMemoryByContent(page, content) {
-    // Find the memory row containing this text
-    const memoryRow = page.locator('.group').filter({ hasText: content }).first();
+    const memoryRow = page.getByTestId('memory-row').filter({ hasText: content }).first();
     await test$1.expect(memoryRow).toBeVisible({ timeout: 5000 });
-    const deleteButton = memoryRow.locator('button[aria-label^="Delete memory:"]');
-    await deleteButton.hover();
-    await deleteButton.click();
-    // Wait for delete to complete and item to be removed
-    await test$1.expect(memoryRow.getByText(content)).not.toBeVisible({ timeout: 10000 });
+    await deleteMemoryRow(page, memoryRow);
+    await test$1.expect(page.getByTestId('memory-row').filter({ hasText: content })).toBeHidden({
+        timeout: 15000,
+    });
     logger.info(`Deleted memory: "${content}"`);
 }
 /**
@@ -1713,6 +1729,356 @@ async function verifyMemoryNotExists(page, content) {
     logger.info(`Verified memory removed: "${content}"`);
 }
+/**
+ * Tenant-settings **Memory** tab helpers — Playwright bindings for the memory
+ * administration UI from `@iblai/web-containers` (`MemoryAdminTab`):
+ *
+ * - the **Global** sub-tab: tenant users table with server-side search, and a
+ *   per-user popup (`user-memories-modal`) hosting the shared memories list
+ *   plus the user's two memory setting switches, and
+ * - the **Agent** sub-tab: agents table with the shared agent autocomplete
+ *   filter, and a per-agent popup (`agent-memories-modal`) hosting the same
+ *   `ManageMemories` editor the agent settings modal renders.
+ *
+ * Selector policy (flakiness-proof by construction):
+ * - Dialog-first scoping: every popup is resolved into a Locator variable
+ *   first (`openUserMemoriesPopup` / `openAgentMemoriesPopup` return it) and
+ *   all sub-elements are queried from that variable — never a bare page-wide
+ *   match that could hit same-named elements in nested portals. The popups
+ *   stack ON TOP of the tenant settings dialog, and the add/edit/delete
+ *   dialogs stack on top of the popups, so three dialogs can be open at once;
+ *   the innermost ones are resolved by content filter + `.last()` (stacked
+ *   Radix dialogs portal to the end of `<body>` in mount order, making the
+ *   last match the one on top).
+ * - Stable hooks only: `data-testid`, role + accessible name (aria-labels).
+ *   No CSS class or structural selectors.
+ * - No `waitForTimeout` / `networkidle`. Progress is gated on UI state that
+ *   only exists after the awaited transition: a section testid rendering, a
+ *   dialog closing after its mutation resolves, a row appearing or
+ *   disappearing after the list refetch, a switch's `aria-checked` flipping.
+ */
+const MEMORY_ADMIN_LABELS = {
+    /** Tenant settings rail item name. */
+    tabName: 'Memory',
+    subTabs: {
+        global: 'Global',
+        agent: 'Agent',
+    },
+    /** Add button inside the user memories popup (shared list styling). */
+    addMemoryButton: 'Add Memory',
+    menu: {
+        /** aria-label prefix of a memory row's three-dots trigger. */
+        actionsAriaPrefix: 'Memory actions:',
+        edit: 'Edit',
+        delete: 'Delete',
+    },
+    dialogs: {
+        add: 'Add Memory',
+        edit: 'Edit Memory',
+        deleteConfirm: 'Delete Memory',
+    },
+    /**
+     * Switch accessible-name prefixes. The full names carry the current state
+     * ("Auto memory capture enabled"), so helpers match on the prefix.
+     */
+    switches: {
+        autoCapture: /^Auto memory capture/,
+        useMemory: /^Use memory in responses/,
+    },
+};
+const UI_TIMEOUT$2 = 10000;
+const MUTATION_TIMEOUT$2 = 15000;
+// ---------------------------------------------------------------------------
+// Sections and rows
+// ---------------------------------------------------------------------------
+/** The Global sub-tab's body (users table + search). */
+function memoryAdminGlobalSection(page) {
+    return page.getByTestId('memory-admin-global-section');
+}
+/** The Agent sub-tab's body (agents table + autocomplete filter). */
+function memoryAdminAgentSection(page) {
+    return page.getByTestId('memory-admin-agent-section');
+}
+/** A users-table row for the given username. */
+function memoryAdminUserRow(page, username) {
+    return memoryAdminGlobalSection(page).getByTestId(`memory-admin-user-row-${username}`);
+}
+/** An agents-table row for the given agent unique_id. */
+function memoryAdminAgentRow(page, mentorUniqueId) {
+    return memoryAdminAgentSection(page).getByTestId(`memory-admin-agent-row-${mentorUniqueId}`);
+}
+/**
+ * A memory row inside an open popup, found by (part of) its content text.
+ * `scope` is the popup Locator returned by `openUserMemoriesPopup`.
+ */
+function memoryRowByContent(scope, content) {
+    return scope.getByTestId('memory-row').filter({ hasText: content });
+}
+// ---------------------------------------------------------------------------
+// Tab navigation
+// ---------------------------------------------------------------------------
+/**
+ * Returns false when the Memory rail item isn't rendered in the tenant
+ * settings dialog (non-admin viewer).
+ */
+async function isTenantMemoryTabVisible(page) {
+    const railItem = page
+        .getByRole('button', { name: MEMORY_ADMIN_LABELS.tabName, exact: true })
+        .first();
+    try {
+        await test$1.expect(railItem).toBeVisible({ timeout: 5000 });
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Open the Memory tab from the tenant settings rail. Assumes the tenant
+ * settings dialog is already open. Completion is gated on the Global sub-tab
+ * trigger rendering (it appears once the memsearch status check resolves).
+ */
+async function switchToTenantMemoryTab(page) {
+    // Desktop and mobile rails both render the item; the first match is the
+    // desktop one, which is the visible rail on desktop viewports.
+    const railItem = page
+        .getByRole('button', { name: MEMORY_ADMIN_LABELS.tabName, exact: true })
+        .first();
+    await test$1.expect(railItem).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await railItem.click();
+    await test$1.expect(page.getByTestId('memory-admin-sub-tab-global')).toBeVisible({
+        timeout: UI_TIMEOUT$2,
+    });
+    logger.info('Switched to tenant Memory tab');
+}
+/**
+ * Switch between the Memory tab's Global / Agent sub-tabs. Completion is
+ * gated on the target section's testid rendering.
+ */
+async function switchToMemoryAdminSubTab(page, subTab) {
+    const trigger = page.getByTestId(`memory-admin-sub-tab-${subTab}`);
+    await test$1.expect(trigger).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await trigger.click();
+    const section = subTab === 'global' ? memoryAdminGlobalSection(page) : memoryAdminAgentSection(page);
+    await test$1.expect(section).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    logger.info(`Switched to Memory "${subTab}" sub-tab`);
+}
+// ---------------------------------------------------------------------------
+// Global sub-tab: users table + per-user popup
+// ---------------------------------------------------------------------------
+/**
+ * Search the users table and gate on the expected user's row appearing.
+ * Terms shorter than three characters search as empty (the Management tab's
+ * debounce contract), so pass at least three characters.
+ */
+async function searchMemoryAdminUsers(page, term, expectedUsername) {
+    const input = memoryAdminGlobalSection(page).getByTestId('memory-admin-users-search');
+    await test$1.expect(input).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await input.fill(term);
+    await test$1.expect(memoryAdminUserRow(page, expectedUsername)).toBeVisible({
+        timeout: MUTATION_TIMEOUT$2,
+    });
+    logger.info(`Searched memory users for "${term}"`);
+}
+/**
+ * Open the global memories popup for a user's row and return the popup's
+ * Locator — pass it as the `popup` argument of every helper below so their
+ * queries stay pinned to the popup instead of the dialogs underneath.
+ * Completion is gated on the popup's list state rendering (rows, the empty
+ * state, or the loading skeletons resolving into either).
+ */
+async function openUserMemoriesPopup(page, username) {
+    const viewButton = memoryAdminUserRow(page, username).getByTestId(`memory-admin-user-view-${username}`);
+    await test$1.expect(viewButton).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await viewButton.click();
+    const popup = page.getByTestId('user-memories-modal');
+    await test$1.expect(popup).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await test$1.expect(popup.getByTestId('memories-list').or(popup.getByTestId('memories-list-empty'))).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Opened global memories popup for "${username}"`);
+    return popup;
+}
+/** Close the user memories popup (Escape) and gate on it disappearing. */
+async function closeUserMemoriesPopup(page) {
+    const popup = page.getByTestId('user-memories-modal');
+    await test$1.expect(popup).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await page.keyboard.press('Escape');
+    await test$1.expect(popup).toBeHidden({ timeout: UI_TIMEOUT$2 });
+}
+/**
+ * The innermost open dialog whose text matches `title`. Stacked Radix
+ * dialogs portal to the end of `<body>` in mount order, so `.last()` is the
+ * one on top — required here because the add/edit/delete dialogs open above
+ * the popup, which itself sits above the tenant settings dialog.
+ */
+function topDialogByTitle(page, title) {
+    return page.getByRole('dialog').filter({ hasText: title }).last();
+}
+/** Open a memory row's three-dots menu and click one of its actions. */
+async function clickMemoryRowAction(page, row, action) {
+    const trigger = row.getByRole('button', {
+        name: new RegExp(`^${MEMORY_ADMIN_LABELS.menu.actionsAriaPrefix}`),
+    });
+    await test$1.expect(trigger).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await trigger.click();
+    // The menu portals to <body>; only one dropdown menu is ever open at once.
+    const item = page.getByRole('menuitem', { name: action, exact: true });
+    await test$1.expect(item).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await item.click();
+}
+/**
+ * Add a global memory for the popup's user: opens the Add Memory dialog,
+ * fills the content (minimum 10 characters), saves, and gates on the dialog
+ * closing and the new row appearing in the popup's list.
+ */
+async function addUserGlobalMemory(page, popup, content) {
+    const addButton = popup.getByTestId('user-memories-add');
+    await test$1.expect(addButton).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await addButton.click();
+    const dialog = topDialogByTitle(page, MEMORY_ADMIN_LABELS.dialogs.add);
+    await test$1.expect(dialog).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await dialog.locator('#memory-content').fill(content);
+    const saveButton = dialog.getByRole('button', { name: 'Save Memory', exact: true });
+    await test$1.expect(saveButton).toBeEnabled({ timeout: UI_TIMEOUT$2 });
+    await saveButton.click();
+    await test$1.expect(dialog).toBeHidden({ timeout: MUTATION_TIMEOUT$2 });
+    await test$1.expect(memoryRowByContent(popup, content)).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Added global memory: "${content}"`);
+}
+/**
+ * Edit a global memory found by its current content: three-dots → Edit,
+ * replace the content, save, and gate on the dialog closing and the updated
+ * row appearing in the popup's list.
+ */
+async function editUserGlobalMemory(page, popup, currentContent, newContent) {
+    const row = memoryRowByContent(popup, currentContent);
+    await test$1.expect(row).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await clickMemoryRowAction(page, row, MEMORY_ADMIN_LABELS.menu.edit);
+    const dialog = topDialogByTitle(page, MEMORY_ADMIN_LABELS.dialogs.edit);
+    await test$1.expect(dialog).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await dialog.locator('#edit-memory-content').fill(newContent);
+    const saveButton = dialog.getByRole('button', { name: 'Save Memory', exact: true });
+    await test$1.expect(saveButton).toBeEnabled({ timeout: UI_TIMEOUT$2 });
+    await saveButton.click();
+    await test$1.expect(dialog).toBeHidden({ timeout: MUTATION_TIMEOUT$2 });
+    await test$1.expect(memoryRowByContent(popup, newContent)).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Edited global memory to: "${newContent}"`);
+}
+/**
+ * Delete a global memory found by its content: three-dots → Delete, confirm
+ * in the Delete Memory dialog, and gate on the confirmation closing and the
+ * row leaving the popup's list.
+ */
+async function deleteUserGlobalMemory(page, popup, content) {
+    const row = memoryRowByContent(popup, content);
+    await test$1.expect(row).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await clickMemoryRowAction(page, row, MEMORY_ADMIN_LABELS.menu.delete);
+    const confirmDialog = topDialogByTitle(page, MEMORY_ADMIN_LABELS.dialogs.deleteConfirm);
+    await test$1.expect(confirmDialog).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await confirmDialog.getByRole('button', { name: 'Delete', exact: true }).click();
+    await test$1.expect(confirmDialog).toBeHidden({ timeout: MUTATION_TIMEOUT$2 });
+    await test$1.expect(memoryRowByContent(popup, content)).toBeHidden({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Deleted global memory: "${content}"`);
+}
+/**
+ * Toggle one of the user's memory setting switches inside the popup and
+ * gate on its `aria-checked` state flipping (which only happens after the
+ * settings mutation resolves and the query refetches). Returns the new
+ * checked state.
+ */
+async function toggleUserMemoryAdminSetting(page, popup, setting) {
+    const switchEl = popup.getByRole('switch', { name: MEMORY_ADMIN_LABELS.switches[setting] });
+    await test$1.expect(switchEl).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    const wasChecked = await switchEl.isChecked();
+    await switchEl.click();
+    await test$1.expect(switchEl).toHaveAttribute('aria-checked', String(!wasChecked), {
+        timeout: MUTATION_TIMEOUT$2,
+    });
+    logger.info(`Toggled memory setting "${setting}" from ${wasChecked} to ${!wasChecked}`);
+    return !wasChecked;
+}
+// ---------------------------------------------------------------------------
+// Agent sub-tab: agents table + per-agent popup
+// ---------------------------------------------------------------------------
+/**
+ * Filter the agents table to one agent via the autocomplete: types the name,
+ * clicks the matching option, and gates on the selected chip rendering.
+ */
+async function filterAgentMemories(page, agentName) {
+    const section = memoryAdminAgentSection(page);
+    const input = section.getByTestId('agent-memories-filter-input');
+    await test$1.expect(input).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await input.fill(agentName);
+    const option = section
+        .getByTestId('agent-memories-filter-results')
+        .getByRole('button', { name: agentName, exact: true });
+    await test$1.expect(option).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    await option.click();
+    await test$1.expect(section.getByTestId('agent-memories-filter-selected')).toBeVisible({
+        timeout: UI_TIMEOUT$2,
+    });
+    logger.info(`Filtered agent memories to "${agentName}"`);
+}
+/** Clear the agents autocomplete filter (back to the full agents list). */
+async function clearAgentMemoriesFilter(page) {
+    const section = memoryAdminAgentSection(page);
+    const clearButton = section.getByTestId('agent-memories-filter-clear');
+    await test$1.expect(clearButton).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await clearButton.click();
+    await test$1.expect(section.getByTestId('agent-memories-filter-input')).toBeVisible({
+        timeout: UI_TIMEOUT$2,
+    });
+}
+/**
+ * Open the memories popup for an agent's row and return the popup's Locator
+ * — pass it as the `popup` argument of `addAgentMemoryFromPopup` and scope
+ * any further queries to it. Completion is gated on the `ManageMemories`
+ * editor rendering its user filter combobox.
+ */
+async function openAgentMemoriesPopup(page, mentorUniqueId) {
+    const viewButton = memoryAdminAgentRow(page, mentorUniqueId).getByTestId(`memory-admin-agent-view-${mentorUniqueId}`);
+    await test$1.expect(viewButton).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await viewButton.click();
+    const popup = page.getByTestId('agent-memories-modal');
+    await test$1.expect(popup).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await test$1.expect(popup.getByRole('combobox').first()).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Opened agent memories popup for "${mentorUniqueId}"`);
+    return popup;
+}
+/** Close the agent memories popup (Escape) and gate on it disappearing. */
+async function closeAgentMemoriesPopup(page) {
+    const popup = page.getByTestId('agent-memories-modal');
+    await test$1.expect(popup).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await page.keyboard.press('Escape');
+    await test$1.expect(popup).toBeHidden({ timeout: UI_TIMEOUT$2 });
+}
+/**
+ * Add an agent memory through the popup's `ManageMemories` editor: opens its
+ * Add Memory dialog, optionally picks a category, fills the content (minimum
+ * 10 characters), saves, and gates on the dialog closing and the content
+ * appearing in the popup.
+ */
+async function addAgentMemoryFromPopup(page, popup, content, categoryName) {
+    const addButton = popup.getByRole('button', { name: MEMORY_ADMIN_LABELS.addMemoryButton });
+    await test$1.expect(addButton).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    await addButton.click();
+    const dialog = topDialogByTitle(page, MEMORY_ADMIN_LABELS.dialogs.add);
+    await test$1.expect(dialog).toBeVisible({ timeout: UI_TIMEOUT$2 });
+    if (categoryName) {
+        await dialog.getByRole('combobox').click();
+        // Radix Select portals its listbox to <body>; one is open at a time.
+        const option = page.getByRole('option', { name: categoryName, exact: true });
+        await test$1.expect(option).toBeVisible({ timeout: UI_TIMEOUT$2 });
+        await option.click();
+    }
+    await dialog.getByRole('textbox').fill(content);
+    const saveButton = dialog.getByRole('button', { name: 'Save', exact: true });
+    await test$1.expect(saveButton).toBeEnabled({ timeout: UI_TIMEOUT$2 });
+    await saveButton.click();
+    await test$1.expect(dialog).toBeHidden({ timeout: MUTATION_TIMEOUT$2 });
+    await test$1.expect(popup.getByText(content)).toBeVisible({ timeout: MUTATION_TIMEOUT$2 });
+    logger.info(`Added agent memory: "${content}"`);
+}
 // ============================
 // Navigation Helpers
 // ============================
@@ -3864,6 +4230,14 @@ const VOICE_LABELS = {
         openai: 'OpenAI Voice',
         google: 'Google Voice',
     },
+    voiceInstructions: {
+        label: 'Voice Instructions',
+        presets: {
+            warm: 'Warm and encouraging',
+            calm: 'Calm and measured',
+            energetic: 'Energetic and upbeat',
+        },
+    },
     saveVoiceButton: /save voice settings|saving…/i,
     // The "Save" button reads "Save" when no config exists yet and
     // "Save changes" once one does. Helpers match both via a regex.
@@ -4075,6 +4449,62 @@ async function previewVoice(scope, voiceName) {
     await test$1.expect(previewBtn).toBeVisible({ timeout: 10000 });
     await previewBtn.click();
 }
+/**
+ * Open the "Voice Instructions" editor modal from its prompt card on the
+ * Voice sub-tab. The card is only rendered when the OpenAI or Google
+ * provider is selected. Mirrors the Prompts / Screen share card pattern:
+ * an "Edit <label>" button popping the rich-text modal.
+ */
+async function openVoiceInstructionsEditor(scope) {
+    const btn = scope.getByRole('button', { name: `Edit ${VOICE_LABELS.voiceInstructions.label}` });
+    await test$1.expect(btn).toBeVisible({ timeout: 10000 });
+    await btn.click();
+    await test$1.expect(asPage$5(scope).getByText(`Edit ${VOICE_LABELS.voiceInstructions.label}`)).toBeVisible({ timeout: 10000 });
+    logger.info('Opened voice-instructions editor');
+}
+/**
+ * Replace the "Voice Instructions" text via the editor modal and confirm.
+ * The new value is written to local form state; call `saveVoiceSettings`
+ * afterwards to persist. Pass an empty string to clear the stored
+ * instructions (saving then sends `""`).
+ */
+async function setVoiceInstructions(scope, text) {
+    await openVoiceInstructionsEditor(scope);
+    const page = asPage$5(scope);
+    const editor = page.getByRole('dialog').locator('[contenteditable="true"]').first();
+    await test$1.expect(editor).toBeVisible({ timeout: 10000 });
+    await editor.click();
+    await page.keyboard.press('ControlOrMeta+A');
+    await page.keyboard.press('Delete');
+    if (text)
+        await editor.pressSequentially(text);
+    // The modal's Save button — scope to dialog so we don't grab the
+    // outer tab's Save.
+    await page
+        .getByRole('dialog')
+        .getByRole('button', { name: /^save$/i })
+        .click();
+    await test$1.expect(page.getByRole('dialog')).toBeHidden({ timeout: 10000 });
+    logger.info(`Voice instructions set (${text.length} chars)`);
+}
+/**
+ * Assert the voice-instructions prompt card shows the given text.
+ */
+async function expectVoiceInstructionsValue(scope, text) {
+    await test$1.expect(scope.getByTestId('voice-instructions-card')).toContainText(text, {
+        timeout: 10000,
+    });
+}
+/**
+ * Click one of the example preset chips under the voice-instructions
+ * textarea; the chip's canned text replaces the textarea content.
+ */
+async function applyVoiceInstructionsPreset(scope, preset) {
+    const chip = scope.getByTestId(`voice-instructions-preset-${preset}`);
+    await test$1.expect(chip).toBeVisible({ timeout: 10000 });
+    await chip.click();
+    logger.info(`Applied voice-instructions preset "${preset}"`);
+}
 /**
  * Click the Save button on the Voice sub-tab. Asserts the button is
  * enabled first (a no-op on a pristine form would be a test bug).
@@ -6736,6 +7166,14 @@ const LTI_LABELS = {
         keys: 'No LTI keys yet.',
         tools: 'No LTI tools yet.',
     },
+    /** Badge text for the async-create link status. */
+    status: {
+        pending: 'Pending',
+        building: 'Building',
+        ready: 'Ready',
+        failed: 'Failed',
+    },
+    retry: 'Retry',
 };
 /** data-testid values rendered by the LTI components. */
 const LTI_TEST_IDS = {
@@ -6754,6 +7192,9 @@ const LTI_TEST_IDS = {
         row: 'lti-link-row',
         modal: 'lti-link-modal',
         nameInput: 'lti-link-name-input',
+        status: 'lti-link-status',
+        retryButton: 'lti-link-retry-button',
+        refreshButton: 'lti-links-refresh-button',
     },
     keys: {
         section: 'lti-keys-section',
@@ -6900,7 +7341,12 @@ async function submitLinkModal(scope) {
     await submit.click();
     await test$1.expect(getLinkModal(scope)).toBeHidden({ timeout: 15000 });
 }
-/** Full create-link flow. */
+/**
+ * Full create-link flow. Creation is asynchronous on the backend (202 +
+ * celery build): the modal closes immediately and the row appears with a
+ * Pending/Building status badge. Follow with `waitForLinkReady` before
+ * asserting on `target_link_uri` or editing the link.
+ */
 async function createLink(scope, name) {
     await openCreateLinkModal(scope);
     await fillLinkName(scope, name);
@@ -6926,6 +7372,54 @@ async function expectLinkNotInList(scope, name) {
 async function expectLinkTargetUri(scope, name, targetUri) {
     await test$1.expect(getLinkRow(scope, name)).toContainText(targetUri, { timeout: 10000 });
 }
+function getLinkStatusBadge(scope, name) {
+    return getLinkRow(scope, name).getByTestId(LTI_TEST_IDS.links.status);
+}
+async function expectLinkStatus(scope, name, status) {
+    await test$1.expect(getLinkStatusBadge(scope, name)).toHaveAttribute('data-status', status, {
+        timeout: 10000,
+    });
+}
+/** The Refresh button shown in the Links header while a build is in flight. */
+function getLinksRefreshButton(scope) {
+    return getLinksSection(scope).getByTestId(LTI_TEST_IDS.links.refreshButton);
+}
+/** Manually refresh the links list (visible only while a build is in flight). */
+async function refreshLinks(scope) {
+    await getLinksRefreshButton(scope).click();
+}
+/**
+ * Wait for the async link build to finish (`ready`). The build creates an edX
+ * course via celery, so allow a generous timeout (default 3 minutes). The UI
+ * does not auto-poll — this helper clicks the header Refresh button every few
+ * seconds until the row's badge reports `ready` (throws if it turns `failed`).
+ */
+async function waitForLinkReady(scope, name, timeoutMs = 180000) {
+    const badge = getLinkStatusBadge(scope, name);
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        const status = await badge.getAttribute('data-status');
+        if (status === 'ready')
+            break;
+        if (status === 'failed') {
+            throw new Error(`LTI link build failed: ${name}`);
+        }
+        if (Date.now() >= deadline) {
+            throw new Error(`Timed out waiting for LTI link to be ready: ${name} (last: ${status})`);
+        }
+        await asPage$1(scope).waitForTimeout(5000);
+        await refreshLinks(scope);
+    }
+    logger.info(`LTI link ready: ${name}`);
+}
+/**
+ * Retry a failed link build via the row's Retry button (deletes the failed
+ * entity and re-posts the original payload).
+ */
+async function retryFailedLink(scope, name) {
+    await getLinkRow(scope, name).getByTestId(LTI_TEST_IDS.links.retryButton).click();
+    logger.info(`Retried LTI link: ${name}`);
+}
 // ═══════════════════════════════════════════════════════════════════════
 // Sub-tab 2 — Keys
 // ═══════════════════════════════════════════════════════════════════════
@@ -7860,6 +8354,7 @@ exports.EVALS_LABELS = EVALS_LABELS;
 exports.GRADER_LABELS = GRADER_LABELS;
 exports.LTI_LABELS = LTI_LABELS;
 exports.LTI_TEST_IDS = LTI_TEST_IDS;
+exports.MEMORY_ADMIN_LABELS = MEMORY_ADMIN_LABELS;
 exports.MailsacClient = MailsacClient;
 exports.PRIVACY_LABELS = PRIVACY_LABELS;
 exports.SCREENSHARE_LABELS = SCREENSHARE_LABELS;
@@ -7867,16 +8362,19 @@ exports.SPEND_LIMITS_LABELS = SPEND_LIMITS_LABELS;
 exports.SUPPORT_LABELS = SUPPORT_LABELS;
 exports.TASKS_LABELS = TASKS_LABELS;
 exports.VOICE_LABELS = VOICE_LABELS;
+exports.addAgentMemoryFromPopup = addAgentMemoryFromPopup;
 exports.addGraderCriterion = addGraderCriterion;
 exports.addManualScore = addManualScore;
 exports.addMemory = addMemory;
 exports.addQaPairsManually = addQaPairsManually;
 exports.addSkillToAgent = addSkillToAgent;
 exports.addTextResource = addTextResource;
+exports.addUserGlobalMemory = addUserGlobalMemory;
 exports.addUserSpendLimit = addUserSpendLimit;
 exports.addUserSpendLimitFromTenantBilling = addUserSpendLimitFromTenantBilling;
 exports.agentLimitsRow = agentLimitsRow;
 exports.agentLimitsSection = agentLimitsSection;
+exports.applyVoiceInstructionsPreset = applyVoiceInstructionsPreset;
 exports.archiveFirstMemory = archiveFirstMemory;
 exports.archiveMemoryByContent = archiveMemoryByContent;
 exports.billingAutoRechargeSection = billingAutoRechargeSection;
@@ -7896,6 +8394,7 @@ exports.cancelStartEvaluation = cancelStartEvaluation;
 exports.checkAdminStatus = checkAdminStatus;
 exports.checkRunStatus = checkRunStatus;
 exports.clearAgentLimitsFilter = clearAgentLimitsFilter;
+exports.clearAgentMemoriesFilter = clearAgentMemoriesFilter;
 exports.clearDateRangeFilter = clearDateRangeFilter;
 exports.clearGradeResultOverride = clearGradeResultOverride;
 exports.clearInstanceSearch = clearInstanceSearch;
@@ -7910,11 +8409,13 @@ exports.clickDownloadAgain = clickDownloadAgain;
 exports.clickManualDownloadLink = clickManualDownloadLink;
 exports.clickSetSpendLimitForFilteredAgent = clickSetSpendLimitForFilteredAgent;
 exports.closeAgentLimitsPopup = closeAgentLimitsPopup;
+exports.closeAgentMemoriesPopup = closeAgentMemoriesPopup;
 exports.closeBenchmarkItemsDialog = closeBenchmarkItemsDialog;
 exports.closeCreditBalanceDropdown = closeCreditBalanceDropdown;
 exports.closeEvaluationDetailDialog = closeEvaluationDetailDialog;
 exports.closeKeyDetail = closeKeyDetail;
 exports.closeManageBenchmarksDialog = closeManageBenchmarksDialog;
+exports.closeUserMemoriesPopup = closeUserMemoriesPopup;
 exports.closeWithEsc = closeWithEsc;
 exports.confirmEnableChatPrivacyMidSession = confirmEnableChatPrivacyMidSession;
 exports.confirmKeyDelete = confirmKeyDelete;
@@ -7946,6 +8447,7 @@ exports.deleteQaItem = deleteQaItem;
 exports.deleteResource = deleteResource;
 exports.deleteSkill = deleteSkill;
 exports.deleteTask = deleteTask;
+exports.deleteUserGlobalMemory = deleteUserGlobalMemory;
 exports.deleteUserSpendLimit = deleteUserSpendLimit;
 exports.deleteWorkspaceSpendLimit = deleteWorkspaceSpendLimit;
 exports.disableSkill = disableSkill;
@@ -7958,6 +8460,7 @@ exports.editLink = editLink;
 exports.editSkill = editSkill;
 exports.editTextResource = editTextResource;
 exports.editTool = editTool;
+exports.editUserGlobalMemory = editUserGlobalMemory;
 exports.editUserSpendLimit = editUserSpendLimit;
 exports.enableSkill = enableSkill;
 exports.enableSupport = enableSupport;
@@ -8000,6 +8503,7 @@ exports.expectKeysEmpty = expectKeysEmpty;
 exports.expectLastCriterionDeleteDisabled = expectLastCriterionDeleteDisabled;
 exports.expectLinkInList = expectLinkInList;
 exports.expectLinkNotInList = expectLinkNotInList;
+exports.expectLinkStatus = expectLinkStatus;
 exports.expectLinkTargetUri = expectLinkTargetUri;
 exports.expectLinksEmpty = expectLinksEmpty;
 exports.expectLogDetailsStatus = expectLogDetailsStatus;
@@ -8045,6 +8549,7 @@ exports.expectToolsEmpty = expectToolsEmpty;
 exports.expectTotalTasks = expectTotalTasks;
 exports.expectTraceScore = expectTraceScore;
 exports.expectTtsSelectDisabled = expectTtsSelectDisabled;
+exports.expectVoiceInstructionsValue = expectVoiceInstructionsValue;
 exports.expectVoiceProviderSelected = expectVoiceProviderSelected;
 exports.expectVoiceVisible = expectVoiceVisible;
 exports.expectWorkspaceActualSpendStats = expectWorkspaceActualSpendStats;
@@ -8053,6 +8558,7 @@ exports.exportRunCsv = exportRunCsv;
 exports.fillLinkName = fillLinkName;
 exports.fillToolForm = fillToolForm;
 exports.filterAgentLimits = filterAgentLimits;
+exports.filterAgentMemories = filterAgentMemories;
 exports.filterByAction = filterByAction;
 exports.filterByActionAndVerify = filterByActionAndVerify;
 exports.filterByActor = filterByActor;
@@ -8112,6 +8618,7 @@ exports.getLinkModal = getLinkModal;
 exports.getLinkNameInput = getLinkNameInput;
 exports.getLinkRow = getLinkRow;
 exports.getLinksEmptyState = getLinksEmptyState;
+exports.getLinksRefreshButton = getLinksRefreshButton;
 exports.getLinksSection = getLinksSection;
 exports.getLlmJudgeDialog = getLlmJudgeDialog;
 exports.getLlmPickerDialog = getLlmPickerDialog;
@@ -8179,10 +8686,16 @@ exports.isSpendLimitsTabVisible = isSpendLimitsTabVisible;
 exports.isSupportEnabled = isSupportEnabled;
 exports.isSupportTabVisible = isSupportTabVisible;
 exports.isTasksTabVisible = isTasksTabVisible;
+exports.isTenantMemoryTabVisible = isTenantMemoryTabVisible;
 exports.isVoiceTabVisible = isVoiceTabVisible;
 exports.logger = logger;
 exports.loginWithEmailAndPassword = loginWithEmailAndPassword;
 exports.loginWithMicrosoftIdp = loginWithMicrosoftIdp;
+exports.memoryAdminAgentRow = memoryAdminAgentRow;
+exports.memoryAdminAgentSection = memoryAdminAgentSection;
+exports.memoryAdminGlobalSection = memoryAdminGlobalSection;
+exports.memoryAdminUserRow = memoryAdminUserRow;
+exports.memoryRowByContent = memoryRowByContent;
 exports.navigateToAccountComponent = navigateToAccountComponent;
 exports.navigateToAuditLog = navigateToAuditLog;
 exports.navigateToAuditLogAndWaitForData = navigateToAuditLogAndWaitForData;
@@ -8191,6 +8704,7 @@ exports.navigateToReportDownload = navigateToReportDownload;
 exports.openAddItemsDialog = openAddItemsDialog;
 exports.openAddMemoryDialog = openAddMemoryDialog;
 exports.openAgentLimitsManage = openAgentLimitsManage;
+exports.openAgentMemoriesPopup = openAgentMemoriesPopup;
 exports.openAgentPromptEditModal = openAgentPromptEditModal;
 exports.openBenchmarkItems = openBenchmarkItems;
 exports.openCallConfigVoicePicker = openCallConfigVoicePicker;
@@ -8222,6 +8736,8 @@ exports.openSkillActionsMenu = openSkillActionsMenu;
 exports.openSlashSkillPicker = openSlashSkillPicker;
 exports.openStartEvaluationDialog = openStartEvaluationDialog;
 exports.openTicket = openTicket;
+exports.openUserMemoriesPopup = openUserMemoriesPopup;
+exports.openVoiceInstructionsEditor = openVoiceInstructionsEditor;
 exports.overrideGradeResult = overrideGradeResult;
 exports.parseReportUrlParams = parseReportUrlParams;
 exports.previewCallConfigVoiceInline = previewCallConfigVoiceInline;
@@ -8232,6 +8748,7 @@ exports.readEndpointUrl = readEndpointUrl;
 exports.readKeyPublicJwk = readKeyPublicJwk;
 exports.readKeyPublicKey = readKeyPublicKey;
 exports.refreshEvaluationDetail = refreshEvaluationDetail;
+exports.refreshLinks = refreshLinks;
 exports.refreshTickets = refreshTickets;
 exports.reliableClick = reliableClick;
 exports.reliableFill = reliableFill;
@@ -8242,6 +8759,7 @@ exports.replyToTicket = replyToTicket;
 exports.requestSupportTicketViaChat = requestSupportTicketViaChat;
 exports.resetCallConfig = resetCallConfig;
 exports.retry = retry;
+exports.retryFailedLink = retryFailedLink;
 exports.runConnectedInstanceChecks = runConnectedInstanceChecks;
 exports.runInstanceChecks = runInstanceChecks;
 exports.safeWaitForURL = safeWaitForURL;
@@ -8252,6 +8770,7 @@ exports.saveVoiceSettings = saveVoiceSettings;
 exports.scheduleTask = scheduleTask;
 exports.searchBenchmarks = searchBenchmarks;
 exports.searchInstances = searchInstances;
+exports.searchMemoryAdminUsers = searchMemoryAdminUsers;
 exports.searchTasks = searchTasks;
 exports.searchVoices = searchVoices;
 exports.selectBenchmark = selectBenchmark;
@@ -8287,6 +8806,7 @@ exports.setTenantChatPrivacyEnabled = setTenantChatPrivacyEnabled;
 exports.setTicketStatus = setTicketStatus;
 exports.setUseFunctionCallingEnabled = setUseFunctionCallingEnabled;
 exports.setUserSpendLimitEnabled = setUserSpendLimitEnabled;
+exports.setVoiceInstructions = setVoiceInstructions;
 exports.setWorkspaceSpendLimit = setWorkspaceSpendLimit;
 exports.setupSandboxInstance = setupSandboxInstance;
 exports.shouldAddNewRowWhenClickingAddRowButton = shouldAddNewRowWhenClickingAddRowButton;
@@ -8320,6 +8840,7 @@ exports.switchToGraderSubTab = switchToGraderSubTab;
 exports.switchToGraderTab = switchToGraderTab;
 exports.switchToLtiSubTab = switchToLtiSubTab;
 exports.switchToLtiTab = switchToLtiTab;
+exports.switchToMemoryAdminSubTab = switchToMemoryAdminSubTab;
 exports.switchToMemoryTab = switchToMemoryTab;
 exports.switchToPlanAndCredits = switchToPlanAndCredits;
 exports.switchToPrivacyTab = switchToPrivacyTab;
@@ -8332,6 +8853,7 @@ exports.switchToSpendLimitsSubTab = switchToSpendLimitsSubTab;
 exports.switchToSpendLimitsTab = switchToSpendLimitsTab;
 exports.switchToSupportTab = switchToSupportTab;
 exports.switchToTasksTab = switchToTasksTab;
+exports.switchToTenantMemoryTab = switchToTenantMemoryTab;
 exports.switchToVoiceSubTab = switchToVoiceSubTab;
 exports.switchToVoiceTab = switchToVoiceTab;
 exports.switchToWorkspaceSpendLimits = switchToWorkspaceSpendLimits;
@@ -8340,6 +8862,7 @@ exports.test = test;
 exports.toggleAutoPush = toggleAutoPush;
 exports.toggleMemorySwitch = toggleMemorySwitch;
 exports.toggleSkill = toggleSkill;
+exports.toggleUserMemoryAdminSetting = toggleUserMemoryAdminSetting;
 exports.toolFields = toolFields;
 exports.uploadAssetResource = uploadAssetResource;
 exports.uploadQaCsv = uploadQaCsv;
@@ -8375,6 +8898,7 @@ exports.waitForBillingTabReady = waitForBillingTabReady;
 exports.waitForCreditBalanceLoaded = waitForCreditBalanceLoaded;
 exports.waitForDialogReady = waitForDialogReady;
 exports.waitForElementStable = waitForElementStable;
+exports.waitForLinkReady = waitForLinkReady;
 exports.waitForPageLoad = waitForPageLoad;
 exports.waitForPageReady = waitForPageReady;
 exports.waitForReportDownload = waitForReportDownload;