@iblai/iblai-js 2.3.11 → 2.3.13

package/dist/playwright/index.cjs

@@ -1741,15 +1741,6 @@ async function switchToSandboxTab(page) {
     await test$1.expect(page.getByRole('heading', { name: 'Sandbox' }).or(page.getByText('Sandbox'))).toBeVisible({ timeout: 10000 });
     logger.info('Switched to Sandbox tab');
 }
-/**
- * Switch to the Skills tab inside the edit-mentor modal.
- */
-async function switchToSkillsTab(page) {
-    const tab = page.getByRole('tab', { name: 'Skills', exact: true });
-    await test$1.expect(tab).toBeVisible({ timeout: 10000 });
-    await tab.click();
-    logger.info('Switched to Skills tab');
-}
 // ============================
 // Instance Table Helpers (not-connected state)
 // ============================
@@ -2249,96 +2240,251 @@ async function editAgentPrompt(page, field, content) {
     logger.info(`Edited agent prompt "${field}" with ${content.length} chars`);
 }
 // ============================
-// Skills Tab Helpers
+// Combined Workflow Helpers
+// ============================
+/**
+ * Full workflow: open Sandbox tab, create a new instance, connect the mentor to it.
+ * Returns when the mentor is successfully connected.
+ */
+async function setupSandboxInstance(page, instance) {
+    await switchToSandboxTab(page);
+    await createInstance(page, instance);
+    await connectToInstance(page, instance.name);
+    await verifyConnectedInstanceCard(page);
+    logger.info(`Sandbox setup complete for "${instance.name}"`);
+}
+/**
+ * Full workflow: open Sandbox tab, disconnect the current instance (if any),
+ * then delete it from the table.
+ */
+async function teardownSandboxInstance(page, instanceName) {
+    await switchToSandboxTab(page);
+    // If a connected instance is present, disconnect first
+    const disconnectButton = page.getByRole('button', { name: /^Disconnect$/i });
+    if (await disconnectButton.isVisible().catch(() => false)) {
+        await disconnectInstance(page);
+    }
+    await deleteInstance(page, instanceName);
+    logger.info(`Sandbox teardown complete for "${instanceName}"`);
+}
+
+// Agent Skills helpers — the Skills section of the edit-agent dialog
+// ("Agent Skills" / "Available Skills" sub-tabs, skill CRUD with the
+// General/Resources dialog tabs, skill resources, and the chat `/` skill
+// picker). Kept separate from the Claw sandbox helpers, mirroring the
+// agent-skills / claw split in the data layer.
+//
+// Flake-resistance rules used throughout:
+// - Every dialog is captured ONCE via `page.getByRole('dialog', { name })`
+//   (the accessible name comes from the dialog title only), and all fields
+//   and buttons are resolved from that scoped locator. Dialogs stack here —
+//   New/Edit Skill sits over the edit-agent dialog, resource dialogs sit
+//   over Edit Skill — so unscoped text filters would match several dialogs.
+// - Rows are located via their test ids (`agent-skill-row`,
+//   `available-skill-row`, `skill-resource-row`) filtered by visible name,
+//   never via CSS classes.
+// - All waits are element-renders or toasts — never networkidle/timeouts.
+// - Page-level queries are used only for true portals: toasts, the dropdown
+//   menu contents (they portal to document.body), and the Radix Select
+//   listbox inside resource dialogs.
+// ============================
+// Navigation
 // ============================
 /**
- * Verify the Skills tab content is loaded (either showing skill rows or the empty state).
+ * Switch to the Skills tab inside the edit-agent dialog and wait for the
+ * skills section to render.
+ */
+async function switchToSkillsTab(page) {
+    const tab = page.getByRole('tab', { name: 'Skills', exact: true });
+    await test$1.expect(tab).toBeVisible({ timeout: 10000 });
+    await tab.click();
+    await test$1.expect(page.getByTestId('agent-skills-content')).toBeVisible({ timeout: 10000 });
+    logger.info('Switched to Skills tab');
+}
+/** The Skills section container — scope for rows, sub-tabs, and pagination. */
+function skillsSection(page) {
+    return page.getByTestId('agent-skills-content');
+}
+/** A row on the "Agent Skills" sub-tab, located by the skill's name. */
+function agentSkillRow(page, skillName) {
+    return skillsSection(page)
+        .getByTestId('agent-skill-row')
+        .filter({ hasText: skillName });
+}
+/** A row on the "Available Skills" sub-tab, located by the skill's name. */
+function availableSkillRow(page, skillName) {
+    return skillsSection(page)
+        .getByTestId('available-skill-row')
+        .filter({ hasText: skillName });
+}
+/**
+ * Verify the Skills section is loaded: the section container and its
+ * "Agent Skills" / "Available Skills" sub-tabs are visible.
  */
 async function verifySkillsTabVisible(page) {
-    // Either at least one skill toggle row is visible, or the empty message is shown
-    const hasSkills = await page
-        .getByRole('switch')
+    const section = skillsSection(page);
+    await test$1.expect(section).toBeVisible({ timeout: 10000 });
+    await test$1.expect(page.getByTestId('agent-skills-tab-agent')).toBeVisible({ timeout: 10000 });
+    await test$1.expect(page.getByTestId('agent-skills-tab-available')).toBeVisible({ timeout: 10000 });
+    logger.info('Skills section is visible with Agent/Available sub-tabs');
+}
+/**
+ * Switch to the "Agent Skills" sub-tab (the agent's own skills, with enable
+ * toggles; the default sub-tab) and wait for its panel to render.
+ */
+async function switchToAgentSkillsSubTab(page) {
+    await page.getByTestId('agent-skills-tab-agent').click();
+    await test$1.expect(skillsSection(page)
+        .getByTestId('agent-skill-row')
         .first()
-        .isVisible()
-        .catch(() => false);
-    if (hasSkills) {
-        logger.info('Skills tab is visible with skills rendered');
-        return;
-    }
+        .or(page.getByText(/No skills enabled for this agent yet/i))).toBeVisible({ timeout: 10000 });
+    logger.info('Switched to Agent Skills sub-tab');
+}
+/**
+ * Switch to the "Available Skills" sub-tab (the platform catalog, paged
+ * server-side 10 per page) and wait for its panel to render past the
+ * loading spinner.
+ */
+async function switchToAvailableSkillsSubTab(page) {
+    await page.getByTestId('agent-skills-tab-available').click();
+    await test$1.expect(skillsSection(page)
+        .getByTestId('available-skill-row')
+        .first()
+        .or(page.getByText(/No skills available for this platform/i))).toBeVisible({ timeout: 10000 });
+    logger.info('Switched to Available Skills sub-tab');
+}
+/**
+ * Go to a page of the currently visible skills list via the numbered
+ * IblPagination buttons (the pagination renders nothing on a single page).
+ */
+async function goToSkillsListPage(page, pageNumber) {
+    await skillsSection(page)
+        .getByRole('navigation')
+        .getByText(String(pageNumber), { exact: true })
+        .click();
+    logger.info(`Went to skills list page ${pageNumber}`);
+}
+/**
+ * Verify the "Available Skills" empty state ("No skills available for this
+ * platform…") is shown.
+ */
+async function verifySkillsEmptyState(page) {
     await test$1.expect(page.getByText(/No skills available for this platform/i)).toBeVisible({
         timeout: 10000,
     });
-    logger.info('Skills tab is visible with empty state');
+    logger.info('Available Skills empty state is displayed');
 }
 /**
- * Verify that the "No skills available" empty state is shown.
+ * Verify the "Agent Skills" empty state ("No skills enabled for this agent
+ * yet…") is shown.
  */
-async function verifySkillsEmptyState(page) {
-    await test$1.expect(page.getByText(/No skills available for this platform/i)).toBeVisible({
+async function verifyAgentSkillsEmptyState(page) {
+    await test$1.expect(page.getByText(/No skills enabled for this agent yet/i)).toBeVisible({
         timeout: 10000,
     });
-    logger.info('Skills empty state is displayed');
+    logger.info('Agent Skills empty state is displayed');
 }
 /**
- * Count the number of skill rows rendered in the Skills tab.
- * Each row represents an available (enabled) platform skill.
+ * Count the skill rows on the "Agent Skills" sub-tab (max 10 per page).
  */
 async function getSkillRowCount(page) {
-    const rows = page.locator('div.rounded-lg.border.p-6').filter({ has: page.getByRole('switch') });
-    const count = await rows.count();
-    logger.info(`${count} skill row(s) displayed`);
+    const count = await skillsSection(page).getByTestId('agent-skill-row').count();
+    logger.info(`${count} agent skill row(s) displayed`);
     return count;
 }
 /**
- * Verify that a specific skill row is visible in the Skills tab.
+ * Verify that a specific skill row is visible on the "Agent Skills" sub-tab.
  */
 async function verifySkillVisible(page, skillName) {
-    const row = page
-        .locator('div.rounded-lg.border.p-6')
-        .filter({ hasText: skillName })
-        .filter({ has: page.getByRole('switch') });
-    await test$1.expect(row).toBeVisible({ timeout: 10000 });
+    await test$1.expect(agentSkillRow(page, skillName)).toBeVisible({ timeout: 10000 });
     logger.info(`Skill "${skillName}" is visible`);
 }
+// ============================
+// Attach / Detach / Toggle
+// ============================
+/**
+ * Attach a platform skill to the agent from the "Available Skills" sub-tab.
+ * Waits for the toast and for the row to flip to its "Added" chip.
+ */
+async function addSkillToAgent(page, skillName) {
+    const row = availableSkillRow(page, skillName);
+    await row.getByRole('button', { name: `Add ${skillName} to this agent` }).click();
+    await test$1.expect(page.getByText(`${skillName} added`, { exact: false })).toBeVisible({
+        timeout: 10000,
+    });
+    await test$1.expect(row.getByText('Added', { exact: true })).toBeVisible({ timeout: 10000 });
+    logger.info(`Added skill "${skillName}" to the agent`);
+}
 /**
- * Check if a specific skill is currently enabled for the mentor.
+ * Verify a catalog row shows the "Added" chip (already on the agent, or
+ * shadowed by a same-slug private skill) and offers no Add button.
+ */
+async function verifySkillAdded(page, skillName) {
+    const row = availableSkillRow(page, skillName);
+    await test$1.expect(row.getByText('Added', { exact: true })).toBeVisible({ timeout: 10000 });
+    await test$1.expect(row.getByRole('button', { name: `Add ${skillName} to this agent` })).toBeHidden();
+    logger.info(`Skill "${skillName}" shows as Added`);
+}
+/**
+ * Open the three-dots actions menu for a skill row. The menu content portals
+ * to document.body, so the returned locator is page-level by design.
+ */
+async function openSkillActionsMenu(page, skillName) {
+    const actionsButton = page.getByRole('button', { name: `${skillName} actions` });
+    await test$1.expect(actionsButton).toBeVisible({ timeout: 10000 });
+    await actionsButton.click();
+    const menu = page.getByRole('menu');
+    await test$1.expect(menu).toBeVisible({ timeout: 5000 });
+    return menu;
+}
+/**
+ * Detach a skill from the agent via its row menu ("Remove from Agent") on the
+ * "Agent Skills" sub-tab. Waits for the toast and for the row to disappear.
+ */
+async function removeSkillFromAgent(page, skillName) {
+    const menu = await openSkillActionsMenu(page, skillName);
+    await menu.getByRole('menuitem', { name: /Remove from Agent/i }).click();
+    await test$1.expect(page.getByText(`${skillName} removed`, { exact: false })).toBeVisible({
+        timeout: 10000,
+    });
+    logger.info(`Removed skill "${skillName}" from the agent`);
+}
+/**
+ * Check if a specific skill is currently enabled (its row Switch state) on
+ * the "Agent Skills" sub-tab.
  */
 async function isSkillEnabled(page, skillName) {
-    const switchEl = page.getByLabel(new RegExp(`^${skillName} (enabled|disabled)$`));
+    const switchEl = agentSkillRow(page, skillName).getByRole('switch');
     await test$1.expect(switchEl).toBeVisible({ timeout: 10000 });
     const enabled = await switchEl.isChecked();
     logger.info(`Skill "${skillName}" is ${enabled ? 'enabled' : 'disabled'}`);
     return enabled;
 }
 /**
- * Enable a skill for the current mentor by toggling it on.
- * No-op if already enabled. Waits for the success toast.
+ * Enable an attached skill by flipping its Switch on (PATCHes the assignment;
+ * attaching itself is `addSkillToAgent`). No-op if already enabled.
  */
 async function enableSkill(page, skillName) {
-    const disabledSwitch = page.getByLabel(`${skillName} disabled`);
-    const isDisabled = await disabledSwitch.isVisible().catch(() => false);
-    if (!isDisabled) {
+    if (await isSkillEnabled(page, skillName)) {
         logger.info(`Skill "${skillName}" already enabled`);
         return;
     }
-    await disabledSwitch.click();
+    await agentSkillRow(page, skillName).getByRole('switch').click();
     await test$1.expect(page.getByText(`${skillName} enabled`, { exact: false })).toBeVisible({
         timeout: 10000,
     });
     logger.info(`Enabled skill "${skillName}"`);
 }
 /**
- * Disable a skill for the current mentor by toggling it off.
- * No-op if already disabled. Waits for the success toast.
+ * Disable an attached skill by flipping its Switch off, without detaching it
+ * (detaching is `removeSkillFromAgent`). No-op if already disabled.
  */
 async function disableSkill(page, skillName) {
-    const enabledSwitch = page.getByLabel(`${skillName} enabled`);
-    const isEnabled = await enabledSwitch.isVisible().catch(() => false);
-    if (!isEnabled) {
+    if (!(await isSkillEnabled(page, skillName))) {
         logger.info(`Skill "${skillName}" already disabled`);
         return;
     }
-    await enabledSwitch.click();
+    await agentSkillRow(page, skillName).getByRole('switch').click();
     await test$1.expect(page.getByText(`${skillName} disabled`, { exact: false })).toBeVisible({
         timeout: 10000,
     });
@@ -2358,188 +2504,291 @@ async function toggleSkill(page, skillName) {
     return true;
 }
 /**
- * Open the "New Skill" dialog by clicking the New Skill button in the Skills tab.
- * Returns the dialog locator.
+ * Open the "New Skill" dialog from the Skills section. Returns the dialog
+ * locator — resolve every field from it (the dialog stacks over the
+ * edit-agent dialog, so page-level field queries would be ambiguous).
  */
 async function openNewSkillDialog(page) {
-    const newButton = page.getByRole('button', { name: /^New Skill$/i });
-    await test$1.expect(newButton).toBeVisible({ timeout: 10000 });
-    await newButton.click();
-    const dialog = page.getByRole('dialog').filter({ hasText: 'New Skill' });
+    await skillsSection(page).getByRole('button', { name: /^New Skill$/ }).click();
+    // Accessible name comes from the dialog title only — never matches the
+    // "New Skill" button text inside the edit-agent dialog behind it.
+    const dialog = page.getByRole('dialog', { name: 'New Skill' });
     return waitForDialogReady(page, dialog);
 }
 /**
- * Type content into the RichTextEditor Instruction field.
- * The editor renders as a contenteditable element.
- *
- * `dialog` scopes the lookups to the open skill modal so the
- * contenteditable `.first()` and the "Instruction" label don't match
- * elements on the modal behind it. The keyboard is page-global.
+ * Type content into the RichTextEditor Instruction field (a contenteditable
+ * region). `dialog` scopes the editor lookup to the open skill modal.
  */
 async function fillInstructionEditor(dialog, content) {
     const page = dialog.page();
-    // RichTextEditor uses a contenteditable region
     const editor = dialog.locator('[contenteditable="true"]').first();
-    const hasEditor = await editor.isVisible().catch(() => false);
-    if (hasEditor) {
-        await editor.click();
-        await page.keyboard.press('ControlOrMeta+A');
-        await page.keyboard.press('Delete');
-        if (content) {
-            await page.keyboard.type(content);
-        }
-        return;
+    await test$1.expect(editor).toBeVisible({ timeout: 5000 });
+    await editor.click();
+    await page.keyboard.press('ControlOrMeta+A');
+    await page.keyboard.press('Delete');
+    if (content) {
+        await page.keyboard.type(content);
     }
-    // Fallback: a plain labelled input/textarea named "Instruction"
-    const textarea = dialog.getByLabel('Instruction');
-    await textarea.fill(content);
 }
 /**
- * Fill the skill form fields (name, slug, description, version, instruction).
- * The form is used by both the New and Edit dialogs. `dialog` scopes every
- * field query to the open modal (see fillInstructionEditor).
- * The Instruction field is a rich-text (markdown) editor.
+ * Fill the skill form (used by both the New and Edit dialogs). Every field is
+ * resolved from `dialog`; labels use exact matches so "Name" can never match
+ * a "File Name" field in a stacked resource dialog.
  */
 async function fillSkillForm(dialog, values) {
-    await dialog.getByLabel('Name').fill(values.name);
-    await dialog.getByLabel('Slug').fill(values.slug);
+    if (values.onlyThisAgent !== undefined) {
+        const privateSwitch = dialog.getByRole('switch', { name: 'Only This Agent' });
+        if ((await privateSwitch.isChecked()) !== values.onlyThisAgent) {
+            await privateSwitch.click();
+        }
+    }
+    await dialog.getByLabel('Name', { exact: true }).fill(values.name);
+    await dialog.getByLabel('Slug', { exact: true }).fill(values.slug);
     if (values.version !== undefined) {
-        await dialog.getByLabel('Version').fill(values.version);
+        await dialog.getByLabel('Version', { exact: true }).fill(values.version);
+    }
+    if (values.category !== undefined) {
+        await dialog.getByLabel('Category', { exact: true }).fill(values.category);
     }
     if (values.description !== undefined) {
-        await dialog.getByLabel('Description').fill(values.description);
+        await dialog.getByLabel('Description', { exact: true }).fill(values.description);
     }
     if (values.instruction !== undefined) {
         await fillInstructionEditor(dialog, values.instruction);
     }
 }
 /**
- * Create a new platform-level skill via the Skills tab.
+ * Create a new platform-level skill via the Skills section.
  */
 async function createSkill(page, values) {
     const dialog = await openNewSkillDialog(page);
     await fillSkillForm(dialog, values);
-    const createButton = dialog.getByRole('button', { name: /^Create$/i });
+    const createButton = dialog.getByRole('button', { name: /^Create$/ });
     await test$1.expect(createButton).toBeEnabled({ timeout: 5000 });
     await createButton.click();
     await test$1.expect(page.getByText('Skill created', { exact: false })).toBeVisible({
         timeout: 10000,
     });
+    await test$1.expect(dialog).toBeHidden({ timeout: 5000 });
     logger.info(`Created skill "${values.name}"`);
 }
 /**
- * Open the Actions dropdown for a specific skill row.
- * Returns the dropdown menu locator.
- */
-async function openSkillActionsMenu(page, skillName) {
-    const actionsButton = page.getByRole('button', { name: `${skillName} actions` });
-    await test$1.expect(actionsButton).toBeVisible({ timeout: 10000 });
-    await actionsButton.click();
-    const menu = page.getByRole('menu');
-    await test$1.expect(menu).toBeVisible({ timeout: 5000 });
-    return menu;
-}
-/**
- * Open the Edit Skill dialog from the actions menu.
- * Returns the dialog locator.
+ * Open the Edit Skill dialog for a row (lands on the General sub-tab).
+ * Returns the dialog locator — resolve fields and sub-tabs from it.
  */
 async function openEditSkillDialog(page, skillName) {
-    await openSkillActionsMenu(page, skillName);
-    const editItem = page.getByRole('menuitem', { name: /Edit/i });
-    await test$1.expect(editItem).toBeVisible({ timeout: 5000 });
-    await editItem.click();
-    const dialog = page.getByRole('dialog').filter({ hasText: 'Edit Skill' });
+    const menu = await openSkillActionsMenu(page, skillName);
+    await menu.getByRole('menuitem', { name: /^Edit$/ }).click();
+    const dialog = page.getByRole('dialog', { name: 'Edit Skill' });
     return waitForDialogReady(page, dialog);
 }
 /**
- * Edit an existing platform-level skill.
- * @param skillName - The current name of the skill to edit
- * @param updates - Fields to update on the skill
+ * Edit an existing platform-level skill (General sub-tab fields).
  */
 async function editSkill(page, skillName, updates) {
     const dialog = await openEditSkillDialog(page, skillName);
+    if (updates.onlyThisAgent !== undefined) {
+        const privateSwitch = dialog.getByRole('switch', { name: 'Only This Agent' });
+        if ((await privateSwitch.isChecked()) !== updates.onlyThisAgent) {
+            await privateSwitch.click();
+        }
+    }
     if (updates.name !== undefined) {
-        await dialog.getByLabel('Name').fill(updates.name);
+        await dialog.getByLabel('Name', { exact: true }).fill(updates.name);
     }
     if (updates.slug !== undefined) {
-        await dialog.getByLabel('Slug').fill(updates.slug);
+        await dialog.getByLabel('Slug', { exact: true }).fill(updates.slug);
     }
     if (updates.version !== undefined) {
-        await dialog.getByLabel('Version').fill(updates.version);
+        await dialog.getByLabel('Version', { exact: true }).fill(updates.version);
+    }
+    if (updates.category !== undefined) {
+        await dialog.getByLabel('Category', { exact: true }).fill(updates.category);
     }
     if (updates.description !== undefined) {
-        await dialog.getByLabel('Description').fill(updates.description);
+        await dialog.getByLabel('Description', { exact: true }).fill(updates.description);
     }
     if (updates.instruction !== undefined) {
         await fillInstructionEditor(dialog, updates.instruction);
     }
-    const saveButton = dialog.getByRole('button', { name: /^Save$/i });
+    const saveButton = dialog.getByRole('button', { name: /^Save$/ });
     await test$1.expect(saveButton).toBeEnabled({ timeout: 5000 });
     await saveButton.click();
     await test$1.expect(page.getByText('Skill updated', { exact: false })).toBeVisible({
         timeout: 10000,
     });
-    logger.info(`Edited skill "${skillName}" with updates: ${JSON.stringify(updates)}`);
+    await test$1.expect(dialog).toBeHidden({ timeout: 5000 });
+    logger.info(`Edited skill "${skillName}"`);
 }
 /**
- * Delete a platform-level skill, confirming the deletion dialog.
+ * Delete a platform-level skill via its row menu, confirming the
+ * "Delete Skill" dialog.
  */
 async function deleteSkill(page, skillName) {
-    await openSkillActionsMenu(page, skillName);
-    const deleteItem = page.getByRole('menuitem', { name: /Delete/i });
-    await test$1.expect(deleteItem).toBeVisible({ timeout: 5000 });
-    await deleteItem.click();
-    const dialog = page.getByRole('dialog').filter({ hasText: 'Delete Skill' });
-    await test$1.expect(dialog).toBeVisible({ timeout: 5000 });
-    const confirmButton = dialog.getByRole('button', { name: /^Delete$/i });
-    await test$1.expect(confirmButton).toBeVisible({ timeout: 5000 });
-    await confirmButton.click();
+    const menu = await openSkillActionsMenu(page, skillName);
+    await menu.getByRole('menuitem', { name: /^Delete$/ }).click();
+    const confirm = page.getByRole('dialog', { name: 'Delete Skill' });
+    await test$1.expect(confirm).toBeVisible({ timeout: 5000 });
+    await confirm.getByRole('button', { name: /^Delete$/ }).click();
     await test$1.expect(page.getByText('Skill deleted', { exact: false })).toBeVisible({
         timeout: 10000,
     });
+    await test$1.expect(confirm).toBeHidden({ timeout: 5000 });
     logger.info(`Deleted skill "${skillName}"`);
 }
 /**
  * Open the delete confirmation for a skill and cancel it (no deletion).
  */
 async function cancelDeleteSkill(page, skillName) {
-    await openSkillActionsMenu(page, skillName);
-    const deleteItem = page.getByRole('menuitem', { name: /Delete/i });
-    await deleteItem.click();
-    const dialog = page.getByRole('dialog').filter({ hasText: 'Delete Skill' });
-    await test$1.expect(dialog).toBeVisible({ timeout: 5000 });
-    const cancelButton = dialog.getByRole('button', { name: /Cancel/i });
-    await cancelButton.click();
-    await test$1.expect(dialog).not.toBeVisible({ timeout: 5000 });
+    const menu = await openSkillActionsMenu(page, skillName);
+    await menu.getByRole('menuitem', { name: /^Delete$/ }).click();
+    const confirm = page.getByRole('dialog', { name: 'Delete Skill' });
+    await test$1.expect(confirm).toBeVisible({ timeout: 5000 });
+    await confirm.getByRole('button', { name: /^Cancel$/ }).click();
+    await test$1.expect(confirm).toBeHidden({ timeout: 5000 });
     logger.info(`Cancelled delete of skill "${skillName}"`);
 }
 // ============================
-// Combined Workflow Helpers
+// Skill Resources (Edit Skill → Resources sub-tab)
 // ============================
 /**
- * Full workflow: open Sandbox tab, create a new instance, connect the mentor to it.
- * Returns when the mentor is successfully connected.
+ * Switch the open Edit Skill dialog to its Resources sub-tab. Pass the
+ * dialog returned by `openEditSkillDialog`; returns the resources section
+ * locator to scope row lookups.
  */
-async function setupSandboxInstance(page, instance) {
-    await switchToSandboxTab(page);
-    await createInstance(page, instance);
-    await connectToInstance(page, instance.name);
-    await verifyConnectedInstanceCard(page);
-    logger.info(`Sandbox setup complete for "${instance.name}"`);
+async function switchToSkillResourcesSubTab(editSkillDialog) {
+    await editSkillDialog.getByTestId('skill-dialog-tab-files').click();
+    const section = editSkillDialog.getByTestId('skill-resources-section');
+    await test$1.expect(section).toBeVisible({ timeout: 5000 });
+    logger.info('Switched to the Resources sub-tab');
+    return section;
+}
+/** A resource row inside the Resources sub-tab, located by filename. */
+function resourceRow(section, filename) {
+    return section.getByTestId('skill-resource-row').filter({ hasText: filename });
 }
 /**
- * Full workflow: open Sandbox tab, disconnect the current instance (if any),
- * then delete it from the table.
+ * Open the "New Resource" dialog from the resources section. Returns the
+ * dialog locator (it stacks over the Edit Skill dialog).
  */
-async function teardownSandboxInstance(page, instanceName) {
-    await switchToSandboxTab(page);
-    // If a connected instance is present, disconnect first
-    const disconnectButton = page.getByRole('button', { name: /^Disconnect$/i });
-    if (await disconnectButton.isVisible().catch(() => false)) {
-        await disconnectInstance(page);
+async function openNewResourceDialog(page, resourcesSection) {
+    await resourcesSection.getByRole('button', { name: /^New Resource$/ }).click();
+    const dialog = page.getByRole('dialog', { name: 'New Resource' });
+    await test$1.expect(dialog).toBeVisible({ timeout: 5000 });
+    return dialog;
+}
+/**
+ * Add a text resource (reference/script) via the "New Resource" dialog.
+ * The type Select's listbox portals inside the dialog panel, so options are
+ * resolved from the dialog too.
+ */
+async function addTextResource(page, resourcesSection, { filename, content, type = 'Reference' }) {
+    const dialog = await openNewResourceDialog(page, resourcesSection);
+    if (type !== 'Reference') {
+        await dialog.getByRole('combobox').click();
+        await dialog.getByRole('option', { name: type, exact: true }).click();
     }
-    await deleteInstance(page, instanceName);
-    logger.info(`Sandbox teardown complete for "${instanceName}"`);
+    await dialog.getByLabel('File Name', { exact: true }).fill(filename);
+    await dialog.getByLabel('Content', { exact: true }).fill(content);
+    await dialog.getByRole('button', { name: /^Add Resource$/ }).click();
+    await test$1.expect(page.getByText('Resource added', { exact: false })).toBeVisible({
+        timeout: 10000,
+    });
+    await test$1.expect(dialog).toBeHidden({ timeout: 5000 });
+    await test$1.expect(resourceRow(resourcesSection, filename)).toBeVisible({ timeout: 10000 });
+    logger.info(`Added text resource "${filename}"`);
+}
+/**
+ * Upload a binary asset resource via the "New Resource" dialog. `filePath`
+ * is passed to Playwright's setInputFiles (absolute or test-relative).
+ */
+async function uploadAssetResource(page, resourcesSection, filePath) {
+    const dialog = await openNewResourceDialog(page, resourcesSection);
+    await dialog.getByRole('combobox').click();
+    await dialog.getByRole('option', { name: 'Asset', exact: true }).click();
+    await dialog.getByTestId('resource-file-input').setInputFiles(filePath);
+    await dialog.getByRole('button', { name: /^Upload$/ }).click();
+    await test$1.expect(page.getByText('Resource uploaded', { exact: false })).toBeVisible({
+        timeout: 30000,
+    });
+    await test$1.expect(dialog).toBeHidden({ timeout: 5000 });
+    logger.info(`Uploaded asset resource from "${filePath}"`);
+}
+/**
+ * Open a resource row's three-dots menu. The menu content portals to
+ * document.body (above the dialog), so the returned locator is page-level.
+ */
+async function openResourceActionsMenu(page, resourcesSection, filename) {
+    await resourceRow(resourcesSection, filename)
+        .getByRole('button', { name: `${filename} actions` })
+        .click();
+    const menu = page.getByRole('menu');
+    await test$1.expect(menu).toBeVisible({ timeout: 5000 });
+    return menu;
+}
+/**
+ * Edit a text resource in place via its row menu ("Edit Resource" dialog).
+ */
+async function editTextResource(page, resourcesSection, filename, updates) {
+    const menu = await openResourceActionsMenu(page, resourcesSection, filename);
+    await menu.getByRole('menuitem', { name: /^Edit$/ }).click();
+    const dialog = page.getByRole('dialog', { name: 'Edit Resource' });
+    await test$1.expect(dialog).toBeVisible({ timeout: 5000 });
+    if (updates.filename !== undefined) {
+        await dialog.getByLabel('File Name', { exact: true }).fill(updates.filename);
+    }
+    if (updates.content !== undefined) {
+        await dialog.getByLabel('Content', { exact: true }).fill(updates.content);
+    }
+    await dialog.getByRole('button', { name: /^Save$/ }).click();
+    await test$1.expect(page.getByText('Resource saved', { exact: false })).toBeVisible({
+        timeout: 10000,
+    });
+    await test$1.expect(dialog).toBeHidden({ timeout: 5000 });
+    logger.info(`Edited resource "${filename}"`);
+}
+/**
+ * Delete a resource row via its menu, confirming the "Delete Resource"
+ * dialog. Waits for the toast and for the row to disappear.
+ */
+async function deleteResource(page, resourcesSection, filename) {
+    const menu = await openResourceActionsMenu(page, resourcesSection, filename);
+    await menu.getByRole('menuitem', { name: /^Delete$/ }).click();
+    const confirm = page.getByRole('dialog', { name: 'Delete Resource' });
+    await test$1.expect(confirm).toBeVisible({ timeout: 5000 });
+    await confirm.getByRole('button', { name: /^Delete$/ }).click();
+    await test$1.expect(page.getByText('Resource deleted', { exact: false })).toBeVisible({
+        timeout: 10000,
+    });
+    await test$1.expect(confirm).toBeHidden({ timeout: 5000 });
+    await test$1.expect(resourceRow(resourcesSection, filename)).toBeHidden({ timeout: 10000 });
+    logger.info(`Deleted resource "${filename}"`);
+}
+// ============================
+// Chat `/` Skill Picker
+// ============================
+/**
+ * Type a `/` query into the chat composer and wait for the skill picker
+ * listbox to open (its lazy fetch may show a loading row first on cold
+ * cache — waiting on the listbox element covers both paths).
+ */
+async function openSlashSkillPicker(page, query = '/') {
+    const composer = page.locator('#chat-input-textarea');
+    await test$1.expect(composer).toBeVisible({ timeout: 10000 });
+    await composer.click();
+    await composer.fill(query);
+    await test$1.expect(page.getByTestId('slash-skill-picker')).toBeVisible({ timeout: 15000 });
+    logger.info(`Slash skill picker open for query "${query}"`);
+}
+/**
+ * Pick a skill from the open `/` picker by its visible name. The picker
+ * closes and the composer is left holding the inserted `/slug ` invocation.
+ */
+async function selectSlashSkill(page, skillName) {
+    const picker = page.getByTestId('slash-skill-picker');
+    await picker.getByRole('option', { name: new RegExp(skillName, 'i') }).click();
+    await test$1.expect(picker).toBeHidden({ timeout: 5000 });
+    logger.info(`Selected slash skill "${skillName}"`);
 }
 
 // ============================
@@ -6951,6 +7200,8 @@ exports.addGraderCriterion = addGraderCriterion;
 exports.addManualScore = addManualScore;
 exports.addMemory = addMemory;
 exports.addQaPairsManually = addQaPairsManually;
+exports.addSkillToAgent = addSkillToAgent;
+exports.addTextResource = addTextResource;
 exports.archiveFirstMemory = archiveFirstMemory;
 exports.archiveMemoryByContent = archiveMemoryByContent;
 exports.billingAutoRechargeSection = billingAutoRechargeSection;
@@ -7011,6 +7262,7 @@ exports.deleteInstance = deleteInstance;
 exports.deleteKey = deleteKey;
 exports.deleteMemoryByContent = deleteMemoryByContent;
 exports.deleteQaItem = deleteQaItem;
+exports.deleteResource = deleteResource;
 exports.deleteSkill = deleteSkill;
 exports.deleteTask = deleteTask;
 exports.disableSkill = disableSkill;
@@ -7021,6 +7273,7 @@ exports.editGraderCriterion = editGraderCriterion;
 exports.editInstance = editInstance;
 exports.editLink = editLink;
 exports.editSkill = editSkill;
+exports.editTextResource = editTextResource;
 exports.editTool = editTool;
 exports.enableSkill = enableSkill;
 exports.enableSupport = enableSupport;
@@ -7217,6 +7470,7 @@ exports.goToLastPage = goToLastPage;
 exports.goToNextPage = goToNextPage;
 exports.goToPage = goToPage;
 exports.goToPreviousPage = goToPreviousPage;
+exports.goToSkillsListPage = goToSkillsListPage;
 exports.graderTabBody = graderTabBody;
 exports.inviteUserTest = inviteUserTest;
 exports.isEvaluationTabVisible = isEvaluationTabVisible;
@@ -7275,6 +7529,7 @@ exports.openRunResults = openRunResults;
 exports.openScheduleTaskDialog = openScheduleTaskDialog;
 exports.openScreenSharePromptEditor = openScreenSharePromptEditor;
 exports.openSkillActionsMenu = openSkillActionsMenu;
+exports.openSlashSkillPicker = openSlashSkillPicker;
 exports.openStartEvaluationDialog = openStartEvaluationDialog;
 exports.openTicket = openTicket;
 exports.overrideGradeResult = overrideGradeResult;
@@ -7290,6 +7545,7 @@ exports.refreshEvaluationDetail = refreshEvaluationDetail;
 exports.refreshTickets = refreshTickets;
 exports.reliableClick = reliableClick;
 exports.reliableFill = reliableFill;
+exports.removeSkillFromAgent = removeSkillFromAgent;
 exports.removeTraceScore = removeTraceScore;
 exports.renameKey = renameKey;
 exports.replyToTicket = replyToTicket;
@@ -7316,6 +7572,7 @@ exports.selectLLMModel = selectLLMModel;
 exports.selectLlmProvider = selectLlmProvider;
 exports.selectPrivacyAction = selectPrivacyAction;
 exports.selectPrivateMode = selectPrivateMode;
+exports.selectSlashSkill = selectSlashSkill;
 exports.selectSttProvider = selectSttProvider;
 exports.selectTaskInList = selectTaskInList;
 exports.selectToolKeySetMode = selectToolKeySetMode;
@@ -7358,6 +7615,8 @@ exports.submitLinkModal = submitLinkModal;
 exports.submitLlmJudge = submitLlmJudge;
 exports.submitToolModal = submitToolModal;
 exports.switchToAddItemsSubTab = switchToAddItemsSubTab;
+exports.switchToAgentSkillsSubTab = switchToAgentSkillsSubTab;
+exports.switchToAvailableSkillsSubTab = switchToAvailableSkillsSubTab;
 exports.switchToEvaluationTab = switchToEvaluationTab;
 exports.switchToGraderSubTab = switchToGraderSubTab;
 exports.switchToGraderTab = switchToGraderTab;
@@ -7368,6 +7627,7 @@ exports.switchToPrivacyTab = switchToPrivacyTab;
 exports.switchToPrivateModeTab = switchToPrivateModeTab;
 exports.switchToSandboxTab = switchToSandboxTab;
 exports.switchToScreenShareTab = switchToScreenShareTab;
+exports.switchToSkillResourcesSubTab = switchToSkillResourcesSubTab;
 exports.switchToSkillsTab = switchToSkillsTab;
 exports.switchToSupportTab = switchToSupportTab;
 exports.switchToTasksTab = switchToTasksTab;
@@ -7379,8 +7639,10 @@ exports.toggleAutoPush = toggleAutoPush;
 exports.toggleMemorySwitch = toggleMemorySwitch;
 exports.toggleSkill = toggleSkill;
 exports.toolFields = toolFields;
+exports.uploadAssetResource = uploadAssetResource;
 exports.uploadQaCsv = uploadQaCsv;
 exports.verifyAgentConfigPromptsVisible = verifyAgentConfigPromptsVisible;
+exports.verifyAgentSkillsEmptyState = verifyAgentSkillsEmptyState;
 exports.verifyAuditLogEmptyState = verifyAuditLogEmptyState;
 exports.verifyAuditLogEntryStructure = verifyAuditLogEntryStructure;
 exports.verifyAuditLogGenericError = verifyAuditLogGenericError;
@@ -7400,6 +7662,7 @@ exports.verifyMemoryNotExists = verifyMemoryNotExists;
 exports.verifyMemoryTabMemoriesList = verifyMemoryTabMemoriesList;
 exports.verifyMemoryTabSettings = verifyMemoryTabSettings;
 exports.verifyPreparingPhase = verifyPreparingPhase;
+exports.verifySkillAdded = verifySkillAdded;
 exports.verifySkillVisible = verifySkillVisible;
 exports.verifySkillsEmptyState = verifySkillsEmptyState;
 exports.verifySkillsTabVisible = verifySkillsTabVisible;