@iblai/iblai-js 2.5.1 → 2.5.6

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

@@ -16,6 +16,8 @@ export type { EnvConfig, AuthFlowType } from './env-config';
 export { buildReportUrl, parseReportUrlParams, navigateToReportDownload, verifyPreparingPhase, verifyDownloadingPhase, verifyDonePhase, verifyErrorPhase, clickBackHome, clickDownloadAgain, clickManualDownloadLink, waitForReportDownload, } from './report-download';
 export type { ReportDownloadOptions } from './report-download';
 export { isMemoryTabVisible, switchToMemoryTab, verifyMemoryTabSettings, verifyMemoryTabMemoriesList, openAddMemoryDialog, toggleMemorySwitch, addMemory, deleteFirstMemory, deleteMemoryByContent, archiveFirstMemory, archiveMemoryByContent, getMemoryCount, verifyMemoryExists, verifyMemoryNotExists, } from './memory-test-helpers';
+export { MEMORY_ADMIN_LABELS, memoryAdminGlobalSection, memoryAdminAgentSection, memoryAdminUserRow, memoryAdminAgentRow, memoryRowByContent, isTenantMemoryTabVisible, switchToTenantMemoryTab, switchToMemoryAdminSubTab, searchMemoryAdminUsers, openUserMemoriesPopup, closeUserMemoriesPopup, addUserGlobalMemory, editUserGlobalMemory, deleteUserGlobalMemory, toggleUserMemoryAdminSetting, filterAgentMemories, clearAgentMemoriesFilter, openAgentMemoriesPopup, closeAgentMemoriesPopup, addAgentMemoryFromPopup, } from './memory-admin-helpers';
+export type { MemoryAdminSubTab, MemoryAdminSetting } from './memory-admin-helpers';
 export { isSandboxTabVisible, switchToSandboxTab, verifyInstanceTableVisible, getInstanceRowCount, verifyInstanceTableEmpty, searchInstances, clearInstanceSearch, openInstanceActionsMenu, openNewInstanceDialog, createInstance, cancelNewInstanceDialog, openEditInstanceDialog, editInstance, deleteInstance, cancelDeleteInstance, connectToInstance, disconnectInstance, cancelDisconnectInstance, runInstanceChecks, runConnectedInstanceChecks, getInstanceHealthLabel, getInstanceStatusLabel, verifyConnectDisabledForUnhealthy, verifyConnectedInstanceCard, toggleAutoPush, pushConfiguration, openLLMProviderPicker, selectLLMModel, getCurrentModel, verifyAgentConfigPromptsVisible, openAgentPromptEditModal, editAgentPrompt, setupSandboxInstance, teardownSandboxInstance, } from './claw-sandbox-helpers';
 export type { AgentPromptField } from './claw-sandbox-helpers';
 export { switchToSkillsTab, verifySkillsTabVisible, switchToAgentSkillsSubTab, switchToAvailableSkillsSubTab, goToSkillsListPage, verifySkillsEmptyState, verifyAgentSkillsEmptyState, getSkillRowCount, verifySkillVisible, addSkillToAgent, verifySkillAdded, removeSkillFromAgent, isSkillEnabled, enableSkill, disableSkill, toggleSkill, setCatalogSkillEnabled, openNewSkillDialog, createSkill, openSkillActionsMenu, openEditSkillDialog, editSkill, deleteSkill, cancelDeleteSkill, switchToSkillResourcesSubTab, addTextResource, uploadAssetResource, editTextResource, deleteResource, openSlashSkillPicker, selectSlashSkill, } from './agent-skills-helpers';
@@ -27,8 +29,8 @@ export { PRIVACY_LABELS, isPrivacyTabVisible, switchToPrivacyTab, expectPrivacyF
 export type { PrivacyAction, PrivacyEntity } from './privacy-tab-helpers';
 export { CHAT_PRIVACY_LABELS, getChatPrivacyToggle, expectChatPrivacyToggleVisible, expectChatPrivacyState, expectChatPrivacySource, expectChatPrivacyLocked, clickChatPrivacyToggle, getChatPrivacyConfirmDialog, expectChatPrivacyConfirmDialogOpen, confirmEnableChatPrivacyMidSession, cancelEnableChatPrivacyMidSession, isPrivateModeTabVisible, switchToPrivateModeTab, getPrivateModeCard, selectPrivateMode, expectPrivateModeSelected, expectPrivateModeTabReady, getTenantChatPrivacySwitch, getTenantChatPrivacyRow, expectTenantChatPrivacyVisible, expectTenantChatPrivacyEnabled, setTenantChatPrivacyEnabled, } from './chat-privacy-helpers';
 export type { ChatPrivacyMode, ChatPrivacySource, ChatPrivacyToggleState, } from './chat-privacy-helpers';
-export { VOICE_LABELS, isVoiceTabVisible, switchToVoiceTab, switchToVoiceSubTab, getVoiceProviderCard, selectVoiceProvider, expectVoiceProviderSelected, openMentorVoicePicker, openCallConfigVoicePicker, previewMentorVoiceInline, previewCallConfigVoiceInline, expectMentorVoiceTriggerShows, expectCallConfigVoiceTriggerShows, searchVoices, getVoiceRow, expectVoiceVisible, selectVoice, previewVoice, saveVoiceSettings, getCallConfigForm, expectCallConfigVisible, selectCallMode, setCallLanguage, selectLlmProvider, selectTtsProvider, selectSttProvider, expectTtsSelectDisabled, expectSttSelectDisabled, setUseFunctionCallingEnabled, setEnableVideo, saveCallConfig, resetCallConfig, } from './voice-tab-helpers';
-export type { VoiceProvider, CallMode, TtsProvider, SttProvider, LlmProvider, } from './voice-tab-helpers';
+export { VOICE_LABELS, isVoiceTabVisible, switchToVoiceTab, switchToVoiceSubTab, getVoiceProviderCard, selectVoiceProvider, expectVoiceProviderSelected, openMentorVoicePicker, openCallConfigVoicePicker, previewMentorVoiceInline, previewCallConfigVoiceInline, expectMentorVoiceTriggerShows, expectCallConfigVoiceTriggerShows, searchVoices, getVoiceRow, expectVoiceVisible, selectVoice, previewVoice, openVoiceInstructionsEditor, setVoiceInstructions, expectVoiceInstructionsValue, applyVoiceInstructionsPreset, saveVoiceSettings, getCallConfigForm, expectCallConfigVisible, selectCallMode, setCallLanguage, selectLlmProvider, selectTtsProvider, selectSttProvider, expectTtsSelectDisabled, expectSttSelectDisabled, setUseFunctionCallingEnabled, setEnableVideo, saveCallConfig, resetCallConfig, } from './voice-tab-helpers';
+export type { VoiceProvider, VoiceInstructionsPreset, CallMode, TtsProvider, SttProvider, LlmProvider, } from './voice-tab-helpers';
 export { SCREENSHARE_LABELS, isScreenShareTabVisible, switchToScreenShareTab, openScreenSharePromptEditor, setScreenSharePrompt, saveScreenSharePrompts, expectScreenShareDisabledHint, } from './screenshare-tab-helpers';
 export type { ScreenSharePromptField } from './screenshare-tab-helpers';
 export { graderTabBody, isGraderTabVisible, switchToGraderTab, switchToGraderSubTab, isGradingEnabled, setGradingEnabled, saveGraderConfig, addGraderCriterion, editGraderCriterion, deleteGraderCriterion, expectLastCriterionDeleteDisabled, expectGraderMisconfiguredWarning, expectGraderTotalPoints, filterGradeResultsByEmail, expectGradeResultRow, overrideGradeResult, clearGradeResultOverride, GRADER_LABELS, } from './grader-tab-helpers';

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

@@ -57,6 +57,14 @@ export declare const LTI_LABELS: {
         readonly keys: "No LTI keys yet.";
         readonly tools: "No LTI tools yet.";
     };
+    /** Badge text for the async-create link status. */
+    readonly status: {
+        readonly pending: "Pending";
+        readonly building: "Building";
+        readonly ready: "Ready";
+        readonly failed: "Failed";
+    };
+    readonly retry: "Retry";
 };
 /** data-testid values rendered by the LTI components. */
 export declare const LTI_TEST_IDS: {
@@ -75,6 +83,9 @@ export declare const LTI_TEST_IDS: {
         readonly row: "lti-link-row";
         readonly modal: "lti-link-modal";
         readonly nameInput: "lti-link-name-input";
+        readonly status: "lti-link-status";
+        readonly retryButton: "lti-link-retry-button";
+        readonly refreshButton: "lti-links-refresh-button";
     };
     readonly keys: {
         readonly section: "lti-keys-section";
@@ -171,7 +182,12 @@ export declare function openEditLinkModal(scope: Page | Locator, name: string):
 /** Type a name into the (already-open) link modal. */
 export declare function fillLinkName(scope: Page | Locator, name: string): Promise<void>;
 export declare function submitLinkModal(scope: Page | Locator): Promise<void>;
-/** 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.
+ */
 export declare function createLink(scope: Page | Locator, name: string): Promise<void>;
 /** Full rename-link flow (opens via the row's edit pencil). */
 export declare function editLink(scope: Page | Locator, currentName: string, newName: string): Promise<void>;
@@ -179,6 +195,25 @@ export declare function expectLinksEmpty(scope: Page | Locator): Promise<void>;
 export declare function expectLinkInList(scope: Page | Locator, name: string): Promise<void>;
 export declare function expectLinkNotInList(scope: Page | Locator, name: string): Promise<void>;
 export declare function expectLinkTargetUri(scope: Page | Locator, name: string, targetUri: string): Promise<void>;
+/** Status badge for a link's async-create build. */
+export type LtiLinkStatus = 'pending' | 'building' | 'ready' | 'failed';
+export declare function expectLinkStatus(scope: Page | Locator, name: string, status: LtiLinkStatus): Promise<void>;
+/** The Refresh button shown in the Links header while a build is in flight. */
+export declare function getLinksRefreshButton(scope: Page | Locator): Locator;
+/** Manually refresh the links list (visible only while a build is in flight). */
+export declare function refreshLinks(scope: Page | Locator): Promise<void>;
+/**
+ * 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`).
+ */
+export declare function waitForLinkReady(scope: Page | Locator, name: string, timeoutMs?: number): Promise<void>;
+/**
+ * Retry a failed link build via the row's Retry button (deletes the failed
+ * entity and re-posts the original payload).
+ */
+export declare function retryFailedLink(scope: Page | Locator, name: string): Promise<void>;
 export declare function getKeysSection(scope: Page | Locator): Locator;
 export declare function getCreateKeyButton(scope: Page | Locator): Locator;
 export declare function getKeysEmptyState(scope: Page | Locator): Locator;

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

@@ -0,0 +1,153 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * 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.
+ */
+export declare const MEMORY_ADMIN_LABELS: {
+    /** Tenant settings rail item name. */
+    readonly tabName: "Memory";
+    readonly subTabs: {
+        readonly global: "Global";
+        readonly agent: "Agent";
+    };
+    /** Add button inside the user memories popup (shared list styling). */
+    readonly addMemoryButton: "Add Memory";
+    readonly menu: {
+        /** aria-label prefix of a memory row's three-dots trigger. */
+        readonly actionsAriaPrefix: "Memory actions:";
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+    };
+    readonly dialogs: {
+        readonly add: "Add Memory";
+        readonly edit: "Edit Memory";
+        readonly deleteConfirm: "Delete Memory";
+    };
+    /**
+     * Switch accessible-name prefixes. The full names carry the current state
+     * ("Auto memory capture enabled"), so helpers match on the prefix.
+     */
+    readonly switches: {
+        readonly autoCapture: RegExp;
+        readonly useMemory: RegExp;
+    };
+};
+export type MemoryAdminSubTab = keyof typeof MEMORY_ADMIN_LABELS.subTabs;
+export type MemoryAdminSetting = keyof typeof MEMORY_ADMIN_LABELS.switches;
+/** The Global sub-tab's body (users table + search). */
+export declare function memoryAdminGlobalSection(page: Page): Locator;
+/** The Agent sub-tab's body (agents table + autocomplete filter). */
+export declare function memoryAdminAgentSection(page: Page): Locator;
+/** A users-table row for the given username. */
+export declare function memoryAdminUserRow(page: Page, username: string): Locator;
+/** An agents-table row for the given agent unique_id. */
+export declare function memoryAdminAgentRow(page: Page, mentorUniqueId: string): Locator;
+/**
+ * A memory row inside an open popup, found by (part of) its content text.
+ * `scope` is the popup Locator returned by `openUserMemoriesPopup`.
+ */
+export declare function memoryRowByContent(scope: Locator, content: string): Locator;
+/**
+ * Returns false when the Memory rail item isn't rendered in the tenant
+ * settings dialog (non-admin viewer).
+ */
+export declare function isTenantMemoryTabVisible(page: Page): Promise<boolean>;
+/**
+ * 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).
+ */
+export declare function switchToTenantMemoryTab(page: Page): Promise<void>;
+/**
+ * Switch between the Memory tab's Global / Agent sub-tabs. Completion is
+ * gated on the target section's testid rendering.
+ */
+export declare function switchToMemoryAdminSubTab(page: Page, subTab: MemoryAdminSubTab): Promise<void>;
+/**
+ * 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.
+ */
+export declare function searchMemoryAdminUsers(page: Page, term: string, expectedUsername: string): Promise<void>;
+/**
+ * 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).
+ */
+export declare function openUserMemoriesPopup(page: Page, username: string): Promise<Locator>;
+/** Close the user memories popup (Escape) and gate on it disappearing. */
+export declare function closeUserMemoriesPopup(page: Page): Promise<void>;
+/**
+ * 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.
+ */
+export declare function addUserGlobalMemory(page: Page, popup: Locator, content: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function editUserGlobalMemory(page: Page, popup: Locator, currentContent: string, newContent: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function deleteUserGlobalMemory(page: Page, popup: Locator, content: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function toggleUserMemoryAdminSetting(page: Page, popup: Locator, setting: MemoryAdminSetting): Promise<boolean>;
+/**
+ * Filter the agents table to one agent via the autocomplete: types the name,
+ * clicks the matching option, and gates on the selected chip rendering.
+ */
+export declare function filterAgentMemories(page: Page, agentName: string): Promise<void>;
+/** Clear the agents autocomplete filter (back to the full agents list). */
+export declare function clearAgentMemoriesFilter(page: Page): Promise<void>;
+/**
+ * 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.
+ */
+export declare function openAgentMemoriesPopup(page: Page, mentorUniqueId: string): Promise<Locator>;
+/** Close the agent memories popup (Escape) and gate on it disappearing. */
+export declare function closeAgentMemoriesPopup(page: Page): Promise<void>;
+/**
+ * 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.
+ */
+export declare function addAgentMemoryFromPopup(page: Page, popup: Locator, content: string, categoryName?: string): Promise<void>;

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

@@ -23,8 +23,9 @@ export declare function verifyMemoryTabMemoriesList(page: Page): Promise<void>;
  */
 export declare function openAddMemoryDialog(page: Page): Promise<Locator>;
 /**
- * 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.
  */
 export declare function toggleMemorySwitch(page: Page, switchName: RegExp | string): Promise<boolean>;
 /**
@@ -33,14 +34,14 @@ export declare function toggleMemorySwitch(page: Page, switchName: RegExp | stri
  */
 export declare function addMemory(page: Page, content: string): Promise<void>;
 /**
- * Delete the first visible memory in the list.
- * Hovers to reveal the delete button, then clicks it.
+ * Delete the first visible memory in the list through its three-dots menu,
+ * confirming in the Delete Memory dialog.
  */
 export declare function deleteFirstMemory(page: Page): Promise<void>;
 /**
- * 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.
  */
 export declare function deleteMemoryByContent(page: Page, content: string): Promise<void>;
 /**

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

@@ -36,6 +36,14 @@ export declare const VOICE_LABELS: {
         readonly openai: "OpenAI Voice";
         readonly google: "Google Voice";
     };
+    readonly voiceInstructions: {
+        readonly label: "Voice Instructions";
+        readonly presets: {
+            readonly warm: "Warm and encouraging";
+            readonly calm: "Calm and measured";
+            readonly energetic: "Energetic and upbeat";
+        };
+    };
     readonly saveVoiceButton: RegExp;
     readonly callConfigSaveCreate: "Save";
     readonly callConfigSaveUpdate: "Save changes";
@@ -65,6 +73,7 @@ export declare const VOICE_LABELS: {
     };
 };
 export type VoiceProvider = keyof typeof VOICE_LABELS.providers;
+export type VoiceInstructionsPreset = keyof typeof VOICE_LABELS.voiceInstructions.presets;
 export type CallMode = keyof typeof VOICE_LABELS.modeOptions;
 export type TtsProvider = keyof typeof VOICE_LABELS.ttsOptions;
 export type SttProvider = TtsProvider;
@@ -160,6 +169,29 @@ export declare function selectVoice(scope: Page | Locator, voiceName: string): P
  * Playwright.
  */
 export declare function previewVoice(scope: Page | Locator, voiceName: string): Promise<void>;
+/**
+ * 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.
+ */
+export declare function openVoiceInstructionsEditor(scope: Page | Locator): Promise<void>;
+/**
+ * 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 `""`).
+ */
+export declare function setVoiceInstructions(scope: Page | Locator, text: string): Promise<void>;
+/**
+ * Assert the voice-instructions prompt card shows the given text.
+ */
+export declare function expectVoiceInstructionsValue(scope: Page | Locator, text: string): Promise<void>;
+/**
+ * Click one of the example preset chips under the voice-instructions
+ * textarea; the chip's canned text replaces the textarea content.
+ */
+export declare function applyVoiceInstructionsPreset(scope: Page | Locator, preset: VoiceInstructionsPreset): Promise<void>;
 /**
  * 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).