@iblai/iblai-js 1.26.8 → 1.26.10

package/dist/security/playwright/lti-tab-helpers.d.ts

@@ -0,0 +1,270 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * LTI tab helpers — Playwright bindings for the `AgentLtiTab` component from
+ * `@iblai/web-containers`.
+ *
+ * The LTI tab is a peer top-level tab in the Edit Mentor (Agent) dialog with
+ * four sub-tabs: Links, Keys, Tools, and Tool Endpoints. It only renders when
+ * the agent is LTI-accessible (`is_lti_accessible`), so navigation helpers
+ * return `false` rather than throwing when the tab is absent.
+ *
+ * SELECTOR POLICY: every locator below resolves via a stable `data-testid`,
+ * an `aria-label`, or an accessible role+name (tab / button / menuitem /
+ * heading text). No CSS class or structural selectors are used, so these
+ * helpers survive styling changes.
+ *
+ * The helpers assume the Edit Mentor dialog is already open. Call
+ * `switchToLtiTab(page)` first; most helpers accept either the `Page` or the
+ * dialog `Locator` as `scope`.
+ */
+export declare const LTI_LABELS: {
+    /** Left-sidebar tab name. */
+    readonly tabName: "LTI";
+    readonly header: {
+        readonly title: "LTI";
+        readonly description: "Manage LTI agent links, signing keys, tools, and platform endpoints.";
+    };
+    readonly subTabs: {
+        readonly agentLinks: "Links";
+        readonly keys: "Keys";
+        readonly tools: "Tools";
+        readonly toolEndpoints: "Tool Endpoints";
+    };
+    readonly modals: {
+        readonly createLink: "Create LTI Link";
+        readonly editLink: "Edit LTI Link";
+        readonly createKey: "Create LTI Key";
+        readonly keyDetail: "LTI Key";
+        readonly deleteKey: "Delete LTI Key";
+        readonly createTool: "Create LTI Tool";
+        readonly editTool: "Edit LTI Tool";
+    };
+    readonly buttons: {
+        readonly createLink: "Create LTI Link";
+        readonly createKey: "Create LTI Key";
+        readonly createTool: "Create LTI Tool";
+        /** Confirm button inside the delete-key modal. */
+        readonly deleteKey: "Delete";
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+        readonly cancel: "Cancel";
+        readonly close: "Close";
+        readonly save: "Save";
+        readonly create: "Create";
+    };
+    readonly empty: {
+        readonly links: "No LTI link yet for this agent.";
+        readonly keys: "No LTI keys yet.";
+        readonly tools: "No LTI tools yet.";
+    };
+};
+/** data-testid values rendered by the LTI components. */
+export declare const LTI_TEST_IDS: {
+    readonly tabBody: "lti-tab-body";
+    readonly subTabs: "lti-sub-tabs";
+    readonly subTab: {
+        readonly agentLinks: "lti-sub-tab-agent-links";
+        readonly keys: "lti-sub-tab-keys";
+        readonly tools: "lti-sub-tab-tools";
+        readonly toolEndpoints: "lti-sub-tab-tool-endpoints";
+    };
+    readonly links: {
+        readonly section: "lti-links-section";
+        readonly createButton: "lti-link-create-button";
+        readonly empty: "lti-links-empty";
+        readonly row: "lti-link-row";
+        readonly modal: "lti-link-modal";
+        readonly nameInput: "lti-link-name-input";
+    };
+    readonly keys: {
+        readonly section: "lti-keys-section";
+        readonly createButton: "lti-key-create-button";
+        readonly empty: "lti-keys-empty";
+        readonly row: "lti-key-row";
+        readonly createModal: "lti-key-create-modal";
+        readonly createNameInput: "lti-key-name-input";
+        readonly detailModal: "lti-key-detail-modal";
+        readonly detailNameInput: "lti-key-detail-name-input";
+        readonly publicKey: "lti-key-public-key";
+        readonly publicJwk: "lti-key-public-jwk";
+        readonly deleteModal: "lti-key-delete-modal";
+    };
+    readonly tools: {
+        readonly section: "lti-tools-section";
+        readonly createButton: "lti-tool-create-button";
+        readonly empty: "lti-tools-empty";
+        readonly row: "lti-tool-row";
+        readonly modal: "lti-tool-modal";
+        readonly titleInput: "lti-tool-title-input";
+        readonly issuerInput: "lti-tool-issuer-input";
+        readonly clientIdInput: "lti-tool-client-id-input";
+        readonly authLoginInput: "lti-tool-auth-login-input";
+        readonly authTokenInput: "lti-tool-auth-token-input";
+        readonly authAudienceInput: "lti-tool-auth-audience-input";
+        readonly keySetModeUrl: "lti-tool-keyset-mode-url";
+        readonly keySetModeRaw: "lti-tool-keyset-mode-raw";
+        readonly jwksUrlInput: "lti-tool-jwks-url-input";
+        readonly jwksJsonInput: "lti-tool-jwks-json-input";
+        readonly keySelect: "lti-tool-key-select";
+        readonly deploymentIdsInput: "lti-tool-deployment-ids-input";
+    };
+    readonly endpoints: {
+        readonly redirectUri: "lti-endpoint-redirect-uri";
+        readonly login: "lti-endpoint-login";
+        readonly deepLinking: "lti-endpoint-deep-linking";
+        readonly jwks: "lti-endpoint-jwks";
+        readonly url: "lti-endpoint-url";
+    };
+};
+export type LtiSubTab = keyof typeof LTI_TEST_IDS.subTab;
+export type LtiEndpoint = 'redirectUri' | 'login' | 'deepLinking' | 'jwks';
+export type LtiKeySetMode = 'url' | 'raw';
+/** Fields accepted by `createTool` / `editTool`. */
+export interface LtiToolFormData {
+    title: string;
+    issuer: string;
+    clientId: string;
+    authLoginUrl: string;
+    authTokenUrl: string;
+    authAudience?: string;
+    /** Defaults to 'url'. */
+    keySetMode?: LtiKeySetMode;
+    /** Required when keySetMode === 'url'. */
+    jwksUrl?: string;
+    /** Required when keySetMode === 'raw' (raw JWKS JSON string). */
+    jwksJson?: string;
+    /** Name of the signing key to pick from the dropdown. */
+    signingKeyName: string;
+    /** Deployment ids; joined with newlines into the textarea. */
+    deploymentIds?: string[];
+}
+/**
+ * Whether the LTI tab is currently available in the Edit Mentor dialog.
+ * Returns `false` instead of throwing (the tab is hidden unless the agent is
+ * LTI-accessible).
+ */
+export declare function isLtiTabVisible(page: Page): Promise<boolean>;
+/**
+ * Switch to the LTI tab. Assumes the Edit Mentor dialog is open. Waits for the
+ * sub-tab bar to be interactive before returning.
+ */
+export declare function switchToLtiTab(page: Page): Promise<void>;
+/** Locator for a sub-tab trigger. */
+export declare function getLtiSubTab(scope: Page | Locator, subTab: LtiSubTab): Locator;
+/** Switch to one of the four LTI sub-tabs and wait for it to become active. */
+export declare function switchToLtiSubTab(page: Page, subTab: LtiSubTab): Promise<void>;
+export declare function expectLtiHeader(scope: Page | Locator): Promise<void>;
+export declare function getLinksSection(scope: Page | Locator): Locator;
+/** The "Create LTI Link" button (only shown when no link exists yet). */
+export declare function getCreateLinkButton(scope: Page | Locator): Locator;
+export declare function getLinksEmptyState(scope: Page | Locator): Locator;
+/** A link row located by its visible name. */
+export declare function getLinkRow(scope: Page | Locator, name: string): Locator;
+/** The per-row "Edit <name>" pencil button. */
+export declare function getLinkEditButton(scope: Page | Locator, name: string): Locator;
+/** The "Copy target link URI" button shown in a link row. */
+export declare function getLinkCopyTargetUriButton(scope: Page | Locator): Locator;
+export declare function getLinkModal(scope: Page | Locator): Locator;
+export declare function getLinkNameInput(scope: Page | Locator): Locator;
+export declare function openCreateLinkModal(scope: Page | Locator): Promise<void>;
+export declare function openEditLinkModal(scope: Page | Locator, name: string): Promise<void>;
+/** 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. */
+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>;
+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>;
+export declare function getKeysSection(scope: Page | Locator): Locator;
+export declare function getCreateKeyButton(scope: Page | Locator): Locator;
+export declare function getKeysEmptyState(scope: Page | Locator): Locator;
+export declare function getKeyRow(scope: Page | Locator, name: string): Locator;
+/** The per-row three-dots "Actions for <name>" menu trigger. */
+export declare function getKeyActionsTrigger(scope: Page | Locator, name: string): Locator;
+/** Open a key's three-dots menu and return the open menu (portal-rendered). */
+export declare function openKeyActionsMenu(scope: Page | Locator, name: string): Promise<Locator>;
+export declare function getKeyCreateModal(scope: Page | Locator): Locator;
+export declare function getKeyCreateNameInput(scope: Page | Locator): Locator;
+export declare function openCreateKeyModal(scope: Page | Locator): Promise<void>;
+export declare function createKey(scope: Page | Locator, name: string): Promise<void>;
+export declare function getKeyDetailModal(scope: Page | Locator): Locator;
+export declare function getKeyDetailNameInput(scope: Page | Locator): Locator;
+export declare function getKeyPublicKeyField(scope: Page | Locator): Locator;
+export declare function getKeyPublicJwkField(scope: Page | Locator): Locator;
+/** Open the detail (edit) modal for a key via its actions menu → Edit. */
+export declare function openKeyDetail(scope: Page | Locator, name: string): Promise<void>;
+/** Read the displayed public key (PEM) value. */
+export declare function readKeyPublicKey(scope: Page | Locator): Promise<string>;
+/** Read the displayed public JWK value. */
+export declare function readKeyPublicJwk(scope: Page | Locator): Promise<string>;
+/** Rename a key via the detail modal (opens the menu → Edit, then Save). */
+export declare function renameKey(scope: Page | Locator, name: string, newName: string): Promise<void>;
+export declare function closeKeyDetail(scope: Page | Locator): Promise<void>;
+export declare function getKeyDeleteModal(scope: Page | Locator): Locator;
+/** Open the delete confirmation for a key via its actions menu → Delete. */
+export declare function openKeyDelete(scope: Page | Locator, name: string): Promise<void>;
+export declare function confirmKeyDelete(scope: Page | Locator): Promise<void>;
+export declare function cancelKeyDelete(scope: Page | Locator): Promise<void>;
+/** Full delete-key flow (menu → Delete → confirm), expects the modal to close. */
+export declare function deleteKey(scope: Page | Locator, name: string): Promise<void>;
+/**
+ * Assert the delete error (e.g. "key is associated with tool X"). The backend
+ * returns 400/409 and the message is surfaced as a toast (matching the app's
+ * delete-modal convention); the modal stays open so the user can cancel.
+ */
+export declare function expectKeyDeleteError(scope: Page | Locator, message: string): Promise<void>;
+export declare function expectKeysEmpty(scope: Page | Locator): Promise<void>;
+export declare function expectKeyInList(scope: Page | Locator, name: string): Promise<void>;
+export declare function expectKeyNotInList(scope: Page | Locator, name: string): Promise<void>;
+export declare function getToolsSection(scope: Page | Locator): Locator;
+export declare function getCreateToolButton(scope: Page | Locator): Locator;
+export declare function getToolsEmptyState(scope: Page | Locator): Locator;
+export declare function getToolRow(scope: Page | Locator, name: string): Locator;
+export declare function getToolEditButton(scope: Page | Locator, name: string): Locator;
+export declare function getToolModal(scope: Page | Locator): Locator;
+/** Field locators inside the (open) tool modal. */
+export declare const toolFields: {
+    title: (scope: Page | Locator) => Locator;
+    issuer: (scope: Page | Locator) => Locator;
+    clientId: (scope: Page | Locator) => Locator;
+    authLoginUrl: (scope: Page | Locator) => Locator;
+    authTokenUrl: (scope: Page | Locator) => Locator;
+    authAudience: (scope: Page | Locator) => Locator;
+    jwksUrl: (scope: Page | Locator) => Locator;
+    jwksJson: (scope: Page | Locator) => Locator;
+    deploymentIds: (scope: Page | Locator) => Locator;
+};
+export declare function getToolKeySelect(scope: Page | Locator): Locator;
+export declare function openCreateToolModal(scope: Page | Locator): Promise<void>;
+export declare function openEditToolModal(scope: Page | Locator, name: string): Promise<void>;
+/** Pick the JWKS source (URL or raw JSON) in the open tool modal. */
+export declare function selectToolKeySetMode(scope: Page | Locator, mode: LtiKeySetMode): Promise<void>;
+/** Pick a signing key by name from the Radix select in the open tool modal. */
+export declare function selectToolSigningKey(scope: Page | Locator, name: string): Promise<void>;
+/** Fill every field of the open tool modal from `data`. */
+export declare function fillToolForm(scope: Page | Locator, data: LtiToolFormData): Promise<void>;
+export declare function submitToolModal(scope: Page | Locator): Promise<void>;
+/** Full create-tool flow. */
+export declare function createTool(scope: Page | Locator, data: LtiToolFormData): Promise<void>;
+/** Full edit-tool flow (opens via the row's edit pencil, applies overrides). */
+export declare function editTool(scope: Page | Locator, name: string, data: LtiToolFormData): Promise<void>;
+export declare function expectToolsEmpty(scope: Page | Locator): Promise<void>;
+export declare function expectToolInList(scope: Page | Locator, name: string): Promise<void>;
+export declare function expectToolNotInList(scope: Page | Locator, name: string): Promise<void>;
+/** Container for a single platform endpoint row. */
+export declare function getEndpoint(scope: Page | Locator, endpoint: LtiEndpoint): Locator;
+/** The `<code>` element holding an endpoint's URL. */
+export declare function getEndpointUrl(scope: Page | Locator, endpoint: LtiEndpoint): Locator;
+/** The per-endpoint "Copy URL" button. */
+export declare function getEndpointCopyButton(scope: Page | Locator, endpoint: LtiEndpoint): Locator;
+/** Read an endpoint URL string. */
+export declare function readEndpointUrl(scope: Page | Locator, endpoint: LtiEndpoint): Promise<string>;
+/** Click an endpoint's copy button; the button label flips to "Copied". */
+export declare function copyEndpoint(scope: Page | Locator, endpoint: LtiEndpoint): Promise<void>;
+export declare function expectEndpointUrl(scope: Page | Locator, endpoint: LtiEndpoint, url: string): Promise<void>;
+/** Assert all four endpoints render with non-empty URLs. */
+export declare function expectAllEndpointsVisible(scope: Page | Locator): Promise<void>;

package/dist/security/playwright/mail-client.d.ts

@@ -0,0 +1,46 @@
+interface MailsacEmail {
+    _id: string;
+    from: Array<{
+        address: string;
+        name?: string;
+    }>;
+    to: Array<{
+        address: string;
+        name?: string;
+    }>;
+    subject: string;
+    inbox: string;
+    received: string;
+    size: number;
+    attachments: string[];
+    ip: string;
+    via: string;
+    folder: string;
+    labels: string[];
+    read: boolean;
+    rtls: boolean;
+    originalInbox: string;
+    spam: boolean;
+}
+export declare class MailsacClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string);
+    /**
+     * Get all emails for a specific inbox
+     * @param inbox - The inbox address (e.g., 'test@mailsac.com' or just 'test')
+     */
+    getEmails(inbox: string): Promise<MailsacEmail[]>;
+    /**
+     * Get a specific email by ID
+     * @param email - The email address
+     * @param messageId - The ID of the email to fetch
+     */
+    getEmailById(email: string, messageId: string): Promise<string>;
+    /**
+     * Delete a specific email by ID
+     * @param emailId - The ID of the email to delete
+     */
+    deleteEmail(emailId: string): Promise<any>;
+}
+export {};

package/dist/security/playwright/memory-test-helpers.d.ts

@@ -0,0 +1,66 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * Check if the Memory tab is visible in the profile modal.
+ * Returns true if the tab exists and is visible, false otherwise.
+ */
+export declare function isMemoryTabVisible(page: Page): Promise<boolean>;
+/**
+ * Switch to the Memory tab in the profile modal.
+ * Assumes the profile modal is already open and the Memory tab is visible.
+ */
+export declare function switchToMemoryTab(page: Page): Promise<void>;
+/**
+ * Verify that Memory tab settings section is visible with both toggles.
+ */
+export declare function verifyMemoryTabSettings(page: Page): Promise<void>;
+/**
+ * Verify that the "My Memories" section is visible with Add Memory button.
+ */
+export declare function verifyMemoryTabMemoriesList(page: Page): Promise<void>;
+/**
+ * Open the Add Memory dialog from the Memory tab.
+ * Assumes the Memory tab is active.
+ */
+export declare function openAddMemoryDialog(page: Page): Promise<Locator>;
+/**
+ * Toggle a memory setting switch and verify the state changes.
+ * Returns the new checked state.
+ */
+export declare function toggleMemorySwitch(page: Page, switchName: RegExp | string): Promise<boolean>;
+/**
+ * Add a memory via the Add Memory dialog.
+ * Opens the dialog, fills content, saves, and waits for dialog to close.
+ */
+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.
+ */
+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.
+ */
+export declare function deleteMemoryByContent(page: Page, content: string): Promise<void>;
+/**
+ * @deprecated Use `deleteFirstMemory` instead. Archive was renamed to Delete.
+ */
+export declare const archiveFirstMemory: typeof deleteFirstMemory;
+/**
+ * @deprecated Use `deleteMemoryByContent` instead. Archive was renamed to Delete.
+ */
+export declare const archiveMemoryByContent: typeof deleteMemoryByContent;
+/**
+ * Get the count of visible memory items in the list.
+ * Returns 0 if the empty state is shown.
+ */
+export declare function getMemoryCount(page: Page): Promise<number>;
+/**
+ * Verify that a memory with the given content text exists in the list.
+ */
+export declare function verifyMemoryExists(page: Page, content: string): Promise<void>;
+/**
+ * Verify that a memory with the given content text does NOT exist in the list.
+ */
+export declare function verifyMemoryNotExists(page: Page, content: string): Promise<void>;

package/dist/security/playwright/navigation.d.ts

@@ -0,0 +1,26 @@
+import { Page } from '@playwright/test';
+export interface SafeWaitForURLOptions {
+    timeout?: number;
+    waitUntil?: 'commit' | 'domcontentloaded' | 'load' | 'networkidle';
+    maxRetries?: number;
+}
+/**
+ * Check if the current browser is Firefox
+ */
+export declare function isFirefox(page: Page): boolean;
+/**
+ * Safe wrapper around page.waitForURL that handles browser-specific navigation errors
+ *
+ * Firefox has stricter navigation lifecycle handling that can cause NS_BINDING_ABORTED
+ * errors when multiple rapid navigations occur (React router redirects, auth redirects).
+ *
+ * Safari can throw "Navigation canceled by policy check" errors during cross-origin
+ * navigations or when security policies interrupt the navigation flow.
+ *
+ * This utility:
+ * 1. Uses `waitUntil: 'commit'` for Firefox (faster, avoids abort)
+ * 2. Includes retry logic for NS_BINDING_ABORTED errors (Firefox)
+ * 3. Handles "Navigation canceled by policy check" errors (Safari)
+ * 4. Checks if URL is already correct before failing
+ */
+export declare function safeWaitForURL(page: Page, urlPattern: string | RegExp | ((url: URL) => boolean), options?: SafeWaitForURLOptions): Promise<void>;

package/dist/security/playwright/page-helpers.d.ts

@@ -0,0 +1,38 @@
+import { Locator, Page } from '@playwright/test';
+import type { RuleObject } from 'axe-core';
+/**
+ * Wait for a page to be fully ready (DOM complete + brief delay for lazy rendering)
+ */
+export declare function waitForPageReady(page: Page, timeout?: number): Promise<void>;
+/**
+ * Check if the current user is an admin by reading localStorage
+ */
+export declare function checkAdminStatus(page: Page): Promise<boolean>;
+/**
+ * Wait for an element to be fully stable (attached, visible, not animating)
+ */
+export declare function waitForElementStable(page: Page, locator: Locator, timeout?: number): Promise<Locator>;
+/**
+ * Click an element with retry logic and stability checks
+ */
+export declare function reliableClick(page: Page, locator: Locator, timeout?: number, maxRetries?: number): Promise<void>;
+/**
+ * Fill an input element with retry logic, clearing first and verifying the value
+ */
+export declare function reliableFill(page: Page, locator: Locator, value: string, timeout?: number, maxRetries?: number): Promise<void>;
+/**
+ * Wait for a dialog element to be visible and its content loaded
+ */
+export declare function waitForDialogReady(page: Page, dialogLocator: Locator, timeout?: number): Promise<Locator>;
+/**
+ * Select a date from a calendar component, navigating months if needed
+ */
+export declare function selectDateFromCalendar(page: Page, dialogLocator: Locator, targetDate: Date, timeout?: number): Promise<void>;
+/**
+ * Run axe-core accessibility checks against a page
+ */
+export declare function expectNoAccessibilityViolations(page: Page): Promise<void>;
+/**
+ * Run axe-core accessibility checks against visible dialogs
+ */
+export declare function expectNoAccessibilityViolationsOnDialogs(page: Page, rules?: RuleObject, exclude?: string[]): Promise<void>;

package/dist/security/playwright/playwright-config.d.ts

@@ -0,0 +1,81 @@
+import { type PlaywrightTestConfig } from '@playwright/test';
+export interface PlatformConfig {
+    /** Platform name used in project naming (e.g., 'mentornextjs', 'skills') */
+    name: string;
+    /** Devices to test on. Defaults to all 4 desktop browsers */
+    devices?: string[];
+    /** Dependencies for this platform (e.g., ['setup']) */
+    dependencies?: string[];
+    /** Additional test file patterns to match */
+    otherTestMatch?: string[];
+    /** Test files to ignore */
+    testIgnore?: string[];
+}
+export interface CreatePlaywrightConfigOptions {
+    /** Directory containing test files (relative to config file) */
+    testDir?: string;
+    /** Devices to use across all platforms. Defaults to Chrome, Firefox, Safari, Edge */
+    devices?: string[];
+    /** Platform configurations */
+    platforms: PlatformConfig[];
+    /** Path to custom reporter module (relative to config file). Defaults to './custom-reporter' */
+    customReporterPath?: string;
+    /** Additional cleanup or post-test projects */
+    extraProjects?: Array<{
+        name: string;
+        devices?: string[];
+        dependencies: string[];
+        testMatch: string[];
+    }>;
+}
+/** Extract browser key from device name (e.g., 'Desktop Chrome' -> 'chrome') */
+export declare function getBrowserKey(deviceName: string): string;
+/**
+ * Generate per-browser setup projects for Playwright authentication.
+ * Each browser gets its own auth setup project (setup-chrome, setup-firefox, etc.)
+ */
+export declare function generateBrowserSetupProjects(devicesToUse: string[]): {
+    name: string;
+    testMatch: RegExp;
+    use: {
+        viewport: import("@playwright/test").ViewportSize;
+        userAgent: string;
+        deviceScaleFactor: number;
+        isMobile: boolean;
+        hasTouch: boolean;
+        defaultBrowserType: "chromium" | "firefox" | "webkit";
+    };
+}[];
+/**
+ * Generate a Playwright project config for a platform + device combination.
+ */
+export declare function generateProjectConfig(platform: string, deviceName: string, dependencies?: string[], otherTestMatch?: string[], testIgnoreMatch?: string[]): {
+    name: string;
+    testMatch: string[];
+    use: {
+        storageState: string;
+        viewport: import("@playwright/test").ViewportSize;
+        userAgent: string;
+        deviceScaleFactor: number;
+        isMobile: boolean;
+        hasTouch: boolean;
+        defaultBrowserType: "chromium" | "firefox" | "webkit";
+    };
+    dependencies: string[];
+    testIgnore: string[];
+};
+/**
+ * Create a complete Playwright configuration for an IBL.ai application.
+ *
+ * Usage:
+ * ```ts
+ * import { createPlaywrightConfig } from '@iblai/iblai-js/playwright';
+ *
+ * export default createPlaywrightConfig({
+ *   platforms: [
+ *     { name: 'skills', dependencies: ['setup'], otherTestMatch: ['**skills/*\/*.spec.ts'] },
+ *   ],
+ * });
+ * ```
+ */
+export declare function createPlaywrightConfig(options: CreatePlaywrightConfigOptions): PlaywrightTestConfig;

package/dist/security/playwright/privacy-tab-helpers.d.ts

@@ -0,0 +1,95 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * Privacy tab helpers — Playwright bindings for the `AgentPrivacyTab`
+ * component from `@iblai/web-containers`.
+ *
+ * All UI strings below mirror `AGENT_PRIVACY_TAB_LABELS` from
+ * `@iblai/web-containers/next`. If a consumer renames a label via the
+ * `labels` prop, override these constants per spec — don't edit this file.
+ *
+ * The helpers assume the Edit Mentor dialog is already open. Call
+ * `switchToPrivacyTab(page)` first; from then on, every helper accepts
+ * either the `Page` or the dialog `Locator`.
+ */
+export declare const PRIVACY_LABELS: {
+    readonly tabName: "Privacy";
+    readonly headerTitle: "Privacy";
+    readonly actionLabel: "When PII is detected";
+    readonly blockMessageLabel: "Block Message";
+    readonly entitiesLabel: "Entity Types";
+    readonly outputFilterLabel: "Also filter AI responses";
+    readonly entitiesEmptyHint: "Using defaults.";
+    readonly actionOptions: {
+        readonly redact: "Redact";
+        readonly mask: "Mask";
+        readonly block: "Block";
+    };
+    readonly entityChips: {
+        readonly PERSON: "Person";
+        readonly EMAIL_ADDRESS: "Email";
+        readonly PHONE_NUMBER: "Phone";
+        readonly US_SSN: "SSN";
+        readonly CREDIT_CARD: "Credit Card";
+        readonly LOCATION: "Location";
+        readonly DATE_TIME: "Date / Time";
+        readonly US_PASSPORT: "Passport";
+        readonly US_DRIVER_LICENSE: "Driver's License";
+        readonly IP_ADDRESS: "IP Address";
+        readonly IBAN_CODE: "IBAN";
+        readonly MEDICAL_LICENSE: "Medical License";
+        readonly US_BANK_NUMBER: "Bank Number";
+    };
+};
+export type PrivacyAction = keyof typeof PRIVACY_LABELS.actionOptions;
+export type PrivacyEntity = keyof typeof PRIVACY_LABELS.entityChips;
+/**
+ * Check whether the Privacy tab is currently rendered in the Edit Mentor
+ * dialog. Returns false instead of throwing so consumers can guard
+ * conditionally rendered tabs.
+ */
+export declare function isPrivacyTabVisible(page: Page): Promise<boolean>;
+/**
+ * Switch to the Privacy tab. Assumes the Edit Mentor dialog is open.
+ *
+ * The Privacy Router on/off toggle lives on the Settings tab — this tab
+ * only shows dependent PII-handling fields when the router is enabled.
+ * Confirm landing via the tab body's testid rather than any inner label,
+ * since the field labels are conditional.
+ */
+export declare function switchToPrivacyTab(page: Page): Promise<void>;
+/**
+ * Assert that all dependent privacy fields are hidden — the case when the
+ * Privacy Router is disabled (on the Settings tab).
+ */
+export declare function expectPrivacyFieldsHidden(scope: Page | Locator): Promise<void>;
+/**
+ * Assert that the action selector, entities, and output filter are visible —
+ * the case when the master toggle is on.
+ */
+export declare function expectPrivacyFieldsVisible(scope: Page | Locator): Promise<void>;
+/**
+ * Pick a value in the "When PII is detected" select. The block-message
+ * textarea will appear / disappear automatically based on the selection.
+ */
+export declare function selectPrivacyAction(scope: Page | Locator, action: PrivacyAction): Promise<void>;
+/**
+ * Type a custom block message and commit it. The field saves on blur, so
+ * this helper blurs the textarea after typing.
+ */
+export declare function setBlockMessage(scope: Page | Locator, text: string): Promise<void>;
+/**
+ * Locator for a single entity chip. Chips are buttons with
+ * `role="checkbox"` and an `aria-label` matching the user-facing chip text.
+ */
+export declare function getEntityChip(scope: Page | Locator, entity: PrivacyEntity): Locator;
+/**
+ * Toggle an entity chip until it matches the desired selected state.
+ */
+export declare function setEntitySelected(scope: Page | Locator, entity: PrivacyEntity, selected: boolean): Promise<void>;
+export declare function expectEntitySelected(scope: Page | Locator, entity: PrivacyEntity, selected: boolean): Promise<void>;
+/**
+ * Locator for the "Also filter AI responses" switch.
+ */
+export declare function getOutputFilterSwitch(scope: Page | Locator): Locator;
+export declare function setOutputFilterEnabled(scope: Page | Locator, enabled: boolean): Promise<void>;
+export declare function expectOutputFilterEnabled(scope: Page | Locator, enabled: boolean): Promise<void>;