@iblai/iblai-js 2.2.6 → 2.2.8

package/dist/web-utils/playwright/grader-tab-helpers.d.ts

@@ -0,0 +1,138 @@
+import { Locator, Page } from '@playwright/test';
+/**
+ * Grader tab helpers — Playwright bindings for the standalone
+ * `AgentGraderTab` component from `@iblai/web-containers`.
+ *
+ * The tab is a peer to Tools/LLM/Memory/etc in the edit-agent modal. Its
+ * master toggle attaches/detaches the "Grading" tool on the agent; the gated
+ * content splits into two sub-tabs — Grading setup (configuration form) and
+ * Rubric (criteria table with modal-based add/edit/delete behind a
+ * three-dots row menu).
+ *
+ * Selector policy (flakiness-proof by construction):
+ * - Every query is scoped dialog-first: resolve the edit-agent dialog, then
+ *   the tab body, then the sub-element — never a bare page-wide match. The
+ *   criterion/delete modals portal outside that dialog, so they are located
+ *   by their own testids and all fills happen within the modal locator.
+ * - Stable hooks only: `data-testid`, role + accessible name, labels.
+ *   No CSS class or structural selectors.
+ * - No `waitForTimeout` / `networkidle`. Progress is gated on UI state that
+ *   only exists after the awaited transition: sub-tab section testids, a
+ *   modal closing after a persisted mutation, a rubric row
+ *   appearing/disappearing after the list refetch.
+ */
+export declare const GRADER_LABELS: {
+    readonly tabName: "Grader";
+    readonly capabilityToggle: "Grading";
+    readonly subTabs: {
+        readonly setup: "Grading setup";
+        readonly rubric: "Rubric";
+    };
+    readonly addButton: "Add criterion";
+    readonly menu: {
+        /** aria-label template for a row's three-dots trigger. */
+        readonly actionsAria: (name: string) => string;
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+    };
+    readonly modal: {
+        readonly fields: {
+            readonly name: "Name";
+            readonly criteria: "Criteria";
+            readonly points: "Points";
+        };
+        readonly cancel: "Cancel";
+    };
+    readonly toasts: {
+        readonly toggleOn: "Grading turned on";
+        readonly toggleOff: "Grading turned off — your rubric is kept for next time";
+    };
+    readonly gradingModeOptions: {
+        readonly submission: "A submission";
+        readonly conversation: "The conversation";
+    };
+    readonly feedbackModeOptions: {
+        readonly overall: "Overall feedback only";
+        readonly per_criteria: "Feedback per criterion";
+        readonly both: "Overall + per criterion";
+    };
+};
+export type GraderSubTab = keyof typeof GRADER_LABELS.subTabs;
+export type GraderGradingMode = keyof typeof GRADER_LABELS.gradingModeOptions;
+export type GraderFeedbackMode = keyof typeof GRADER_LABELS.feedbackModeOptions;
+export interface GraderCriterionInput {
+    name: string;
+    criteria: string;
+    points: number;
+}
+/** The Grader tab's body, scoped through the edit-agent dialog. */
+export declare function graderTabBody(page: Page): Locator;
+/**
+ * Returns false if the Grader tab isn't currently rendered in the
+ * edit-agent dialog (host didn't register it, or RBAC hid it).
+ */
+export declare function isGraderTabVisible(page: Page): Promise<boolean>;
+/**
+ * Switch to the Grader top-level tab. Assumes the edit-agent dialog is
+ * open. Completion is gated on the tab body's testid, not on timing.
+ */
+export declare function switchToGraderTab(page: Page): Promise<void>;
+/**
+ * Switch between the Grader tab's two sub-tabs. Completion is gated on the
+ * target section's testid rendering.
+ */
+export declare function switchToGraderSubTab(page: Page, subTab: GraderSubTab): Promise<void>;
+/** Read the current on/off state of the Grading capability toggle. */
+export declare function isGradingEnabled(page: Page): Promise<boolean>;
+/**
+ * Idempotently set the Grading capability toggle. Waits for the success
+ * toast (which only fires after the settings PATCH resolves — the switch
+ * itself flips optimistically and would roll back on failure) and then for
+ * the gated content to reflect the new state.
+ */
+export declare function setGradingEnabled(page: Page, enabled: boolean): Promise<void>;
+/**
+ * Fill and persist the Grading setup form (switches to the setup sub-tab
+ * first). Only the provided fields are changed. Completion is gated on the
+ * Save button returning to disabled: after the config POST/PATCH resolves,
+ * the form rehydrates from the server copy and stops being dirty.
+ */
+export declare function saveGraderConfig(page: Page, values: {
+    instructions?: string;
+    gradingMode?: GraderGradingMode;
+    feedbackMode?: GraderFeedbackMode;
+}): Promise<void>;
+/**
+ * Add a rubric criterion through the Add-criterion modal (switches to the
+ * Rubric sub-tab first). Requires a saved grader configuration — the Add
+ * button is disabled until one exists. Completion is gated on the modal
+ * closing and the new row rendering after the list refetch.
+ */
+export declare function addGraderCriterion(page: Page, criterion: GraderCriterionInput): Promise<void>;
+/**
+ * Edit an existing rubric criterion via its row's three-dots menu → Edit
+ * modal. The row is located by its current name; all three fields are
+ * rewritten. Completion is gated on the modal closing and the updated row
+ * rendering.
+ */
+export declare function editGraderCriterion(page: Page, currentName: string, updates: GraderCriterionInput): Promise<void>;
+/**
+ * Delete a rubric criterion via its row's three-dots menu → confirmation
+ * modal. Completion is gated on the modal closing and the row disappearing
+ * after the server delete + list refetch.
+ */
+export declare function deleteGraderCriterion(page: Page, name: string): Promise<void>;
+/**
+ * Assert the last remaining criterion's Delete menu action is disabled and
+ * the explanatory hint is shown — the backend refuses to delete the final
+ * row, so the UI must block it too. Closes the menu again before returning.
+ */
+export declare function expectLastCriterionDeleteDisabled(page: Page, name: string): Promise<void>;
+/**
+ * Assert whether the amber misconfiguration banner is shown (grading on
+ * with no config yet, or with an empty rubric). The banner sits above the
+ * sub-tabs, so no sub-tab switch is needed.
+ */
+export declare function expectGraderMisconfiguredWarning(page: Page, visible: boolean): Promise<void>;
+/** Assert the rubric's live "total possible points" readout (Rubric sub-tab). */
+export declare function expectGraderTotalPoints(page: Page, total: number): Promise<void>;

package/dist/web-utils/playwright/index.d.ts

@@ -29,6 +29,8 @@ export { VOICE_LABELS, isVoiceTabVisible, switchToVoiceTab, switchToVoiceSubTab,
 export type { VoiceProvider, 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, GRADER_LABELS, } from './grader-tab-helpers';
+export type { GraderCriterionInput, GraderGradingMode, GraderFeedbackMode, GraderSubTab, } from './grader-tab-helpers';
 export { billingPlanSection, billingCreditsSection, billingAutoRechargeSection, getBillingPlanLabel, getBillingAutoRechargeStatus, waitForBillingTabReady, expectBillingPlanSection, expectBillingCreditsSection, expectBillingAutoRechargeSection, expectBillingTabForFreePlan, expectBillingTabForTrialPlan, expectBillingTabForPremiumPlan, expectBillingTabForCurrentPlan, clickBillingUpgrade, clickBillingAddCredits, clickBillingManageBilling, clickBillingManageUsage, } from './billing-tab-helpers';
 export type { BillingAutoRechargeStatus } from './billing-tab-helpers';
 export { TASKS_LABELS, isTasksTabVisible, switchToTasksTab, getScheduleTaskButton, getSearchInput, getTaskRow, expectTotalTasks, expectCompletedTasks, expectFailedTasks, expectTasksEmpty, expectTaskInList, expectTaskNotInList, selectTaskInList, expectTaskStatus, searchTasks, openScheduleTaskDialog, scheduleTask, expectScheduleStartTimeInPastError, deleteTask, expectLogsForTask, expectNoLogsForSelectedTask, openFirstLogDetails, expectLogDetailsStatus, } from './tasks-tab-helpers';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iblai/iblai-js",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "Unified JavaScript SDK for IBL.ai — re-exports data-layer, web-containers, and web-utils under a single package",
   "type": "module",
   "engines": {
@@ -76,10 +76,10 @@
     "axios": "1.13.6",
     "dotenv": "16.6.1",
     "winston": "3.19.0",
-    "@iblai/data-layer": "1.11.1",
-    "@iblai/web-containers": "1.15.8",
-    "@iblai/web-utils": "2.1.5",
-    "@iblai/mcp": "1.8.4"
+    "@iblai/data-layer": "1.11.2",
+    "@iblai/mcp": "1.8.5",
+    "@iblai/web-containers": "1.15.9",
+    "@iblai/web-utils": "2.1.7"
   },
   "peerDependencies": {
     "@radix-ui/react-dialog": "^1.1.7",