@iblai/mcp 1.3.3 → 1.4.0

package/dist/tools/component-info.js

@@ -1391,6 +1391,88 @@ interface PaywallModalProps {
 Wires \`useCreateCheckoutMutation\` from \`@iblai/data-layer\` to redirect to Stripe Checkout. The grid auto-sizes for 1, 2, 3, or 4+ prices.
 
 **File Location**: \`packages/web-containers/src/components/modals/paywall-modal.tsx\``,
+    UpgradePackageModal: `# UpgradePackageModal Component
+
+Centered upgrade dialog presenting a "free upgrade" CTA — typically used to nudge users on the Free plan into the premium tier with no credit-card friction. Wires the \`useStripeUpgrade\` hook (from \`@iblai/iblai-js/web-utils\`) to fetch a Stripe Pricing Page session and redirect to the resolved \`free\` checkout link.
+
+\`\`\`typescript
+import { UpgradePackageModal } from '@iblai/iblai-js/web-containers';
+
+interface UpgradePackageModalProps {
+  open: boolean;
+  onClose: () => void;
+  redirectUrl: string;          // success_url passed to Stripe
+  sourcePlatformKey: string;    // current tenant key
+  mainPlatformKey: string;      // main IBL platform key
+  currentUserEmail: string;     // prefills locked_prefilled_email
+  title?: string;               // default: "Subscribe to unlock full features"
+  description?: string;
+  ctaLabel?: string;            // default: "Upgrade for free"
+  features?: string[];          // bulleted feature list inside the dialog
+  footerNote?: string;          // default: "No credit card required. Cancel anytime."
+  className?: string;
+}
+
+<UpgradePackageModal
+  open={isUpgradeOpen}
+  onClose={() => setIsUpgradeOpen(false)}
+  redirectUrl={\`\${window.location.origin}/billing/success\`}
+  sourcePlatformKey={tenantKey}
+  mainPlatformKey={mainPlatformKey}
+  currentUserEmail={user.email}
+/>
+\`\`\`
+
+The CTA calls \`handleUpgrade('free')\` from \`useStripeUpgrade\` — it resolves the Stripe pricing-page session, picks the \`free\` payment link, appends \`locked_prefilled_email\` and \`client_reference_id\`, and redirects via \`window.location.href\`. Use \`UpgradePackageModal\` for the "free upgrade" path, and \`PaywallModal\` for explicit paid-tier checkout flows.
+
+**File Location**: \`packages/web-containers/src/components/modals/upgrade-package-modal.tsx\``,
+    CreditBalance: `# CreditBalance Component
+
+Plan-aware credit balance dropdown that lives in the navbar. Surfaces remaining/consumed credits, reset date, the current plan badge (Free / Trial / Premium), and the auto-recharge configuration; the action button at the bottom adapts to the user's plan and payment-method state.
+
+\`\`\`typescript
+import { CreditBalance } from '@iblai/iblai-js/web-containers';
+
+interface CreditBalanceProps {
+  tenant: string;             // tenant/platform key
+  username: string;
+  mainPlatformKey: string;    // main IBL platform key (for upgrade flow)
+  currentUserEmail: string;
+  redirectUrl: string;        // success_url for Stripe upgrade
+  className?: string;
+  enabled?: boolean;          // default: true — gate via tenant.show_paywall
+}
+
+// Typically gated on the current tenant's \`show_paywall\` flag
+<CreditBalance
+  tenant={currentTenant.key}
+  username={username}
+  mainPlatformKey={mainPlatformKey}
+  currentUserEmail={user.email}
+  redirectUrl={window.location.href}
+  enabled={Boolean(currentTenant.show_paywall)}
+/>
+\`\`\`
+
+**Behavior:**
+- Renders nothing when \`enabled\` is false or \`tenant\` is empty.
+- Trigger button has \`data-testid="credit-balance-trigger"\` (icon-only). Status dot turns amber at \`balance ≤ 10\` ("low") and red at \`balance ≤ 1\` ("critical"); hidden when "healthy".
+- Dropdown panel has \`data-testid="credit-balance-panel"\` and contains a plan badge with \`data-testid="credit-balance-plan-badge"\`.
+- Action button rules:
+  - **Free** (or \`free_trial\`): single "Upgrade Plan" button (gradient + \`Sparkles\` icon) — calls \`useStripeUpgrade.handleUpgrade('premium')\`.
+  - **Premium with payment method**: pair of "Manage Usage" and "Add Credits" buttons (open \`AutoRechargeModal\` and \`AddCreditsModal\` respectively).
+  - **Premium without payment method**: single "Manage Billing" button — opens the Stripe customer portal in \`payment_method_update\` flow via \`useCreateStripeCustomerPortalMutation\`.
+- Auto Recharge section only renders when there is a payment method on file AND plan is not Free.
+- Re-fetches billing info on every dropdown open via \`refetch()\` from \`useGetAccountBillingInfoQuery\`.
+
+**Data dependencies:**
+- \`useGetAccountBillingInfoQuery({ platform_key })\` — credits, plan, payment method, auto-recharge settings, \`free_trial\` flag.
+- \`useCreateStripeCustomerPortalMutation\` — for the "Manage Billing" path.
+- \`useStripeUpgrade\` (web-utils) — for the "Upgrade Plan" path.
+
+**Related:** \`UpgradePackageModal\`, \`AutoRechargeModal\`, \`AddCreditsModal\`, \`useStripeUpgrade\`, \`useGetAccountBillingInfoQuery\`.
+
+**File Location**: \`packages/web-containers/src/components/credit-balance.tsx\``,
     AnalyticsMonetizationStats: `# AnalyticsMonetizationStats Component
 
 Analytics dashboard tab showing monetization KPIs (revenue, sales count, active paywalls, subscriber count), distribution charts, and paginated subscriber/paywall tables.
@@ -2561,6 +2643,721 @@ import Link from 'next/link';
 \`\`\`
 
 **File Location**: \`packages/web-containers/src/components/course-content/footer.tsx\``,
+    // ============================================================================
+    // EDIT MENTOR MODAL — Extracted Tabs
+    // ============================================================================
+    AgentSettingsProvider: `# AgentSettingsProvider
+
+React context provider that supplies shared identity and config to all agent settings tabs. Wrap tab content with this provider so each tab reads tenantKey, mentorId, username, enableRBAC, and executeGatedAction from context instead of props.
+
+\`\`\`typescript
+import { AgentSettingsProvider } from '@iblai/iblai-js/web-containers/next';
+import type { AgentSettingsContextValue } from '@iblai/iblai-js/web-containers/next';
+
+interface AgentSettingsContextValue {
+  tenantKey: string;
+  mentorId: string;
+  username: string;
+  enableRBAC: boolean;
+  executeGatedAction?: (fn: () => unknown) => unknown;
+}
+
+<AgentSettingsProvider
+  tenantKey={tenantKey}
+  mentorId={activeMentorId}
+  username={username}
+  enableRBAC={config.enableRBAC()}
+  executeGatedAction={(fn) => executeWithTrialCheck(fn)}
+>
+  <SettingsTab ... />
+  <LLMTab ... />
+</AgentSettingsProvider>
+\`\`\`
+
+The \`useAgentSettings()\` hook is also exported for building custom tabs that read from this context.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/agent-settings-context.tsx\``,
+    SettingsTab: `# SettingsTab Component
+
+Agent/mentor settings form with name, description, category, visibility, toggles, image upload, and copy/delete sub-modals. Reads identity from AgentSettingsProvider context — must be wrapped by it.
+
+\`\`\`typescript
+import { SettingsTab } from '@iblai/iblai-js/web-containers/next';
+import type { SettingsTabProps, DeepPartial, SettingsTabLabels } from '@iblai/iblai-js/web-containers/next';
+
+interface SettingsTabProps {
+  onSettingsSaved?: (mentor: unknown) => void;
+  onMentorDeleted?: (deletedMentorId: string) => void;
+  tenants: CopyMentorTenant[];
+  isLoadingTenants?: boolean;
+  onMentorCopied?: (params: {
+    forkedMentorId: string;
+    destinationTenantKey: string;
+    isCrossTenantCopy: boolean;
+  }) => void;
+  labels?: DeepPartial<SettingsTabLabels>;
+}
+
+// With the default "agent" labels:
+<SettingsTab
+  tenants={tenants}
+  onMentorDeleted={handleDelete}
+  onMentorCopied={handleCopy}
+/>
+
+// With custom "mentor" labels:
+import { MENTOR_SETTINGS_TAB_LABELS } from './mentor-labels';
+
+<SettingsTab
+  tenants={tenants}
+  onMentorDeleted={handleDelete}
+  onMentorCopied={handleCopy}
+  labels={MENTOR_SETTINGS_TAB_LABELS}
+/>
+\`\`\`
+
+The label system uses typed nested-object overrides. The package ships \`AGENT_SETTINGS_TAB_LABELS\` as the default; consumer apps pass their own vocabulary via the \`labels\` prop. Use \`resolveSettingsTabLabels(override)\` for deep-merging partial overrides.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/settings-tab.tsx\``,
+    LLMTab: `# LLMTab Component
+
+LLM provider selection grid with search, provider cards, and a modal for choosing specific models. Reads identity from AgentSettingsProvider context — must be wrapped by it.
+
+\`\`\`typescript
+import { LLMTab } from '@iblai/iblai-js/web-containers/next';
+import type { LLMTabProps, LLMProviderDetails, DeepPartial, LLMTabLabels } from '@iblai/iblai-js/web-containers/next';
+
+interface LLMTabProps {
+  showConfigurationHeader?: boolean;
+  getLLMProviderDetails: (providerName: string, llmName?: string) => LLMProviderDetails;
+  labels?: DeepPartial<LLMTabLabels>;
+}
+
+interface LLMProviderDetails {
+  logo: string;
+  name: string;
+}
+
+<LLMTab
+  getLLMProviderDetails={(name) => ({
+    name: name.charAt(0).toUpperCase() + name.slice(1),
+    logo: \`/llm-\${name}-provider.png\`,
+  })}
+  labels={MENTOR_LLM_TAB_LABELS}
+/>
+\`\`\`
+
+\`getLLMProviderDetails\` is host-provided because provider logos live in the consuming app's \`/public\` dir.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/llm-tab.tsx\``,
+    ToolsTab: `# ToolsTab Component
+
+Tool toggle grid for enabling/disabling tools and integrations on an agent. Reads identity from AgentSettingsProvider context — must be wrapped by it.
+
+\`\`\`typescript
+import { ToolsTab } from '@iblai/iblai-js/web-containers/next';
+import type { ToolsTabProps, ToolsTabLabels, DeepPartial } from '@iblai/iblai-js/web-containers/next';
+
+interface ToolsTabProps {
+  labels?: DeepPartial<ToolsTabLabels>;
+}
+
+// With the default "agent" labels:
+<ToolsTab />
+
+// With custom "mentor" labels:
+import { MENTOR_TOOLS_TAB_LABELS } from './mentor-tools-labels';
+
+<ToolsTab labels={MENTOR_TOOLS_TAB_LABELS} />
+\`\`\`
+
+Each tool row has a Switch that toggles the tool slug on the mentor via \`useEditMentorMutation\`. Permissions are gated through \`WithFormPermissions\` using the \`enableRBAC\` flag from context.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/tools-tab.tsx\``,
+    MemoryTab: `# MemoryTab Component
+
+Memory settings tab with an enable toggle and a ManageMemories CRUD subsection (filter by user/date range, add/edit/delete memories, bulk delete). Reads identity from AgentSettingsProvider context — must be wrapped by it.
+
+\`\`\`typescript
+import { MemoryTab } from '@iblai/iblai-js/web-containers/next';
+import type { MemoryTabProps, MemoryTabLabels, DeepPartial } from '@iblai/iblai-js/web-containers/next';
+
+interface MemoryTabProps {
+  labels?: DeepPartial<MemoryTabLabels>;
+}
+
+// With the default "agent" labels:
+<MemoryTab />
+
+// With custom "mentor" labels:
+import { MENTOR_MEMORY_TAB_LABELS } from './mentor-memory-labels';
+
+<MemoryTab labels={MENTOR_MEMORY_TAB_LABELS} />
+\`\`\`
+
+The enable toggle mutates \`enable_memory_component\` on mentor settings. The ManageMemories subsection uses \`useGetMentorMemoriesQuery\`, \`useCreateMentorMemoryMutation\`, \`useUpdateMentorMemoryMutation\`, \`useDeleteMentorMemoryMutation\`, and \`useGetMemoryCategoriesAdminQuery\` to manage memories by category.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/memory-tab.tsx\``,
+    SafetyTab: `# SafetyTab Component
+
+Safety and moderation settings with four prompt cards (Moderation Prompt, Safety Prompt, Moderation Response, Safety Response) and optional Flagged Prompts viewer. Reads identity from AgentSettingsProvider context — must be wrapped by it.
+
+\`\`\`typescript
+import { SafetyTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  SafetyTabProps,
+  SafetyTabLabels,
+  SafetySelectedPrompt,
+  SafetyEditFormValues,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface SafetyTabProps {
+  /** Render a prompt string as rich content (e.g. Markdown). Defaults to plain text. */
+  renderPromptContent?: (content: string) => React.ReactNode;
+  /** Modal for editing a prompt. Host-provided. */
+  EditPromptModal?: React.ComponentType<{
+    isOpen: boolean;
+    onClose: () => void;
+    handleSave: (p: SafetySelectedPrompt, v: SafetyEditFormValues) => void;
+    selectedPrompt: SafetySelectedPrompt;
+    isEditing: boolean;
+  }>;
+  /** Modal showing flagged/moderated prompts. Host-provided. */
+  FlaggedPromptsModal?: React.ComponentType<{
+    isOpen: boolean;
+    onClose: () => void;
+    mentorId: string;
+    tenantKey: string;
+    username: string;
+  }>;
+  /** Whether to show the View Flagged Prompts button. Defaults to true. */
+  showFlaggedPrompts?: boolean;
+  labels?: DeepPartial<SafetyTabLabels>;
+}
+
+<SafetyTab
+  labels={MENTOR_SAFETY_TAB_LABELS}
+  renderPromptContent={(content) => (
+    <Markdown className="text-sm text-gray-700">
+      {parsePrompt(content)}
+    </Markdown>
+  )}
+  EditPromptModal={EditPromptModal}
+  FlaggedPromptsModal={FlaggedPromptsModal}
+/>
+\`\`\`
+
+\`EditPromptModal\`, \`FlaggedPromptsModal\`, and \`renderPromptContent\` are host-provided because they have standalone-specific dependencies (rich-text editing, pagination, notification dialogs) that don't belong in the shared package. The default \`renderPromptContent\` renders plain text.
+
+The moderation/safety toggle switches use \`executeGatedAction\` from context when provided (e.g., for paywall gating on free-trial users).
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/safety-tab.tsx\``,
+    CopyButton: `# CopyButton Component
+
+Small button that copies text to the clipboard and shows "Copied" feedback for a short duration. Used by prompt cards in SafetyTab, PromptsTab, and DisclaimersTab.
+
+\`\`\`typescript
+import { CopyButton } from '@iblai/iblai-js/web-containers/next';
+
+interface CopyButtonProps {
+  text: string;
+  disabled?: boolean;
+}
+
+<CopyButton text={mentor?.system_prompt ?? ''} />
+<CopyButton text="Copy me" disabled={isLoading} />
+\`\`\`
+
+Internally uses \`useCopyToClipboard\` with a 1000ms reset timeout. The aria-label switches between "Copy text to clipboard" and "Text copied to clipboard" based on status.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/copy-button.tsx\``,
+    // ============================================================================
+    // AGENT SEARCH — explore, pick and star AI mentors / agents
+    // ============================================================================
+    AgentSearch: `# AgentSearch Component
+
+Full explore-page drop-in that combines search input, filter row, and the four sections (Starred, Featured, Custom, Default). Reads tenant metadata internally, debounces the search input, and wires star mutations via \`useAgentStar\`.
+
+\`\`\`typescript
+import { AgentSearch } from '@iblai/iblai-js/web-containers/next';
+import type {
+  AgentSearchProps,
+  AgentSearchSection,
+  AgentSearchLabels,
+} from '@iblai/iblai-js/web-containers/next';
+
+<AgentSearch
+  tenantKey={tenantKey}
+  username={username}
+  enableRBAC={enableRBAC}
+  rbacPermissions={rbacPermissions}
+  executeGatedAction={executeWithTrialCheck}
+  mainTenantKey="main"
+  onAgentClick={(agent) => router.push(\`/\${agent.slug}\`)}
+  onCreateAgent={() => setCreateOpen(true)}
+  onUnauthenticatedAction={() => redirectToAuthSpa()}
+  createAgentRbacResource="/mentors/#create"
+  labels={MENTOR_SEARCH_LABELS}
+  include={['starred', 'featured', 'custom', 'default', 'filters']}
+  getLLMProviderName={(key) => providerMap[key] ?? key}
+/>
+\`\`\`
+
+\`include\` defaults to all sections. Terminology defaults to "agent"; host apps override via \`labels\` (either a full bundle or a \`DeepPartial\`).
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/agent-search.tsx\``,
+    AgentCard: `# AgentCard Component
+
+Clickable card for a single agent search result. Renders avatar, name, description, "Updated on …" timestamp, and optionally a \`StarButton\` when \`variant="with-star"\`.
+
+\`\`\`typescript
+import { AgentCard } from '@iblai/iblai-js/web-containers/next';
+import type { AgentCardProps } from '@iblai/iblai-js/web-containers/next';
+
+interface AgentCardProps {
+  agent: AgentSearchResult;
+  onClick: (agent: AgentSearchResult) => void;
+  variant?: 'default' | 'with-star';   // default: 'default'
+  isStarred?: boolean;
+  isTogglingStar?: boolean;
+  onToggleStar?: (agent: AgentSearchResult, e: React.MouseEvent) => void;
+  disableStar?: boolean;
+  updatedOnLabel?: string;             // default: 'Updated on'
+  exploreAriaPrefix?: string;          // default: 'Explore agent:'
+  formatDate?: (dateString: string) => string;
+}
+
+<AgentCard
+  agent={agent}
+  variant="with-star"
+  isStarred={agent.starred}
+  isTogglingStar={togglingAgentId === String(agent.id)}
+  onToggleStar={toggleFavorite}
+  onClick={handleAgentClick}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/agent-card.tsx\``,
+    AgentSearchInput: `# AgentSearchInput Component
+
+Debounce-friendly search input with a magnifier icon that swaps to a spinner while \`isLoading\` is true. Visually labelled for screen readers.
+
+\`\`\`typescript
+import { AgentSearchInput } from '@iblai/iblai-js/web-containers/next';
+import type { AgentSearchInputProps } from '@iblai/iblai-js/web-containers/next';
+
+interface AgentSearchInputProps {
+  value: string;
+  onChange: (value: string) => void;
+  isLoading?: boolean;
+  placeholder?: string;                // default: 'Search'
+  ariaLabel?: string;                  // default: 'Search agents'
+  className?: string;
+}
+
+<AgentSearchInput
+  value={searchQuery}
+  onChange={setSearchQuery}
+  isLoading={isFetching}
+  placeholder={labels.searchPlaceholder}
+  ariaLabel={labels.searchAriaLabel}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/agent-search-input.tsx\``,
+    AgentSearchFilters: `# AgentSearchFilters Component
+
+Horizontal row of dropdown filters driven by the facets returned by \`useAgentSearch\` (Category, Subject, LLM Provider, Type, Featured / Promotion) plus an optional "Created By" (Me / My Organization / Community) filter and a "Clear All" button.
+
+\`\`\`typescript
+import { AgentSearchFilters } from '@iblai/iblai-js/web-containers/next';
+import type {
+  AgentSearchFiltersProps,
+  AgentSearchFiltersState,
+  AgentSearchFiltersLabels,
+  CreatedByFilter,
+} from '@iblai/iblai-js/web-containers/next';
+
+<AgentSearchFilters
+  facets={facets}
+  showCreatedByFilter={communityEnabled}
+  includeMeToCreatedByFilter={hasCustomAgents}
+  onFiltersChange={setFilters}
+  onCreatedByChange={setCreatedBy}
+  labels={labels.filters}
+  getLLMProviderName={(key) => providerMap[key] ?? key}
+/>
+\`\`\`
+
+\`CreatedByFilter\` = \`'me' | 'my-organization' | 'community' | null\`.
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/agent-search-filters.tsx\``,
+    AgentEmptyState: `# AgentEmptyState Component
+
+Simple "no results" card used inside agent-search sections.
+
+\`\`\`typescript
+import { AgentEmptyState } from '@iblai/iblai-js/web-containers/next';
+import type { AgentEmptyStateProps } from '@iblai/iblai-js/web-containers/next';
+
+interface AgentEmptyStateProps {
+  message?: string;   // default: 'Sorry, no agents found!'
+}
+
+<AgentEmptyState message={labels.noResults} />
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/agent-empty-state.tsx\``,
+    StarButton: `# StarButton Component
+
+Small icon-only button used inside \`AgentCard\` (and anywhere else an agent favorite toggle is rendered). Renders a \`Star\` icon when idle and a \`Loader2\` spinner while \`isToggling\`. Wraps a Radix \`Tooltip\` and swaps aria labels + tooltip copy based on state.
+
+\`\`\`typescript
+import { StarButton } from '@iblai/iblai-js/web-containers/next';
+import type { StarButtonProps } from '@iblai/iblai-js/web-containers/next';
+
+interface StarButtonProps {
+  isStarred?: boolean;
+  isToggling?: boolean;
+  disabled?: boolean;
+  onClick: (e: React.MouseEvent) => void;
+  tooltipStarred?: string;      // default: 'Unset as favorite'
+  tooltipUnstarred?: string;    // default: 'Set as favorite'
+  ariaLabelStarred?: string;    // default: 'Remove from favorites'
+  ariaLabelUnstarred?: string;  // default: 'Add to favorites'
+}
+
+<StarButton
+  isStarred={agent.starred}
+  isToggling={togglingAgentId === String(agent.id)}
+  onClick={(e) => toggleFavorite(agent, e)}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/agent-search/star-button.tsx\``,
+    // ============================================================================
+    // EDIT MENTOR MODAL — tab components
+    // Each tab reads identity (tenantKey / mentorId / username / enableRBAC /
+    // executeGatedAction) from <AgentSettingsProvider> via useAgentSettings().
+    // ============================================================================
+    AccessTab: `# AccessTab Component
+
+RBAC access / role management tab for the Edit Mentor Modal. Lists existing access policies, supports adding users or groups, and editing/removing their roles. Reads identity from \`AgentSettingsProvider\`.
+
+\`\`\`typescript
+import { AccessTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  AccessTabProps,
+  AccessTabLabels,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface AccessTabProps {
+  labels?: DeepPartial<AccessTabLabels>;
+  /** Called when the tab fetches RBAC permissions for /users/ and /groups/. */
+  onPermissionsLoaded?: (permissions: object) => void;
+}
+
+<AccessTab
+  labels={MENTOR_ACCESS_TAB_LABELS}
+  onPermissionsLoaded={(perms) => dispatch(rbac.merge(perms))}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/access-tab.tsx\``,
+    ApiTab: `# ApiTab Component
+
+API-key management tab: lists existing keys with their creation date and lets the admin create or revoke them. Reads identity from \`AgentSettingsProvider\` and uses \`useGetApiKeysQuery\` / \`WithPermissions\`. Gated via \`executeGatedAction\` when provided.
+
+\`\`\`typescript
+import { ApiTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  ApiTabProps,
+  ApiTabLabels,
+  ApiKey,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface ApiTabProps {
+  labels?: DeepPartial<ApiTabLabels>;
+}
+
+<ApiTab labels={MENTOR_API_TAB_LABELS} />
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/api-tab.tsx\``,
+    DatasetsTab: `# DatasetsTab Component
+
+Knowledge / training dataset management tab. Shows a searchable paginated table of datasets with train / delete / retrain actions. Because the standalone "Add Resource" modal (Dropbox / Drive / OneDrive pickers) and the standalone pagination component have deep app-specific dependencies, both are injected as props.
+
+\`\`\`typescript
+import { DatasetsTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  DatasetsTabProps,
+  DatasetsTabLabels,
+  Dataset,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface DatasetsTabProps {
+  labels?: DeepPartial<DatasetsTabLabels>;
+  onSelect?: (dataset: Dataset) => void;
+  selectedDatasetId?: string;
+  AddResourceModal?: React.ComponentType<{
+    isOpen: boolean;
+    onClose: () => void;
+    keepParentOpen?: boolean;
+  }>;
+  PaginationComponent?: React.ComponentType<{
+    currentPage: number;
+    totalPages: number;
+    onPageChange: (page: number) => void;
+    disabled: boolean;
+  }>;
+}
+
+<DatasetsTab
+  labels={MENTOR_DATASETS_TAB_LABELS}
+  AddResourceModal={AddResourceModal}
+  PaginationComponent={IblPagination}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/datasets-tab.tsx\``,
+    DisclaimersTab: `# DisclaimersTab Component
+
+User Agreement + Advisory disclaimer management tab. Renders the current disclaimer content with an Edit action, a separate user-agreement card, and supports plain or Markdown rendering via \`renderContent\`.
+
+\`\`\`typescript
+import { DisclaimersTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  DisclaimersTabProps,
+  DisclaimersTabLabels,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface DisclaimersTabProps {
+  labels?: DeepPartial<DisclaimersTabLabels>;
+  defaultDisclaimerContent?: string;
+  renderContent?: (content: string) => React.ReactNode;
+}
+
+<DisclaimersTab
+  labels={MENTOR_DISCLAIMERS_TAB_LABELS}
+  defaultDisclaimerContent={DEFAULT_DISCLAIMER}
+  renderContent={(content) => <Markdown>{content}</Markdown>}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/disclaimers-tab.tsx\``,
+    EmbedTab: `# EmbedTab Component
+
+Embed / share configuration tab. Handles visibility, SSO provider selection, custom floating bubble config, CSS/JS overrides, and generates copy-paste embed snippets via a host-provided \`CopyCodeBlock\` component. URL building and the copyable code renderer are injected because they depend on standalone-specific libs.
+
+\`\`\`typescript
+import { EmbedTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  EmbedTabProps,
+  EmbedTabLabels,
+  EmbedUrlConfig,
+  VisibilityOption,
+  SsoProvider,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface EmbedTabProps {
+  labels?: DeepPartial<EmbedTabLabels>;
+  urls: EmbedUrlConfig;
+  CopyCodeBlock: React.ComponentType<{ code: string }>;
+  visibilityOptions: VisibilityOption[];
+  ssoProviders?: SsoProvider[];
+  isSsoProvidersError?: boolean;
+  supportEmail?: string;
+}
+
+<EmbedTab
+  labels={MENTOR_EMBED_TAB_LABELS}
+  urls={embedUrls}
+  CopyCodeBlock={CopyCodeBlock}
+  visibilityOptions={visibilityOptions}
+  ssoProviders={ssoProviders}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/embed-tab.tsx\``,
+    HistoryTab: `# HistoryTab Component
+
+Chat-history browser for a mentor. Supports date-range / user / session filtering, pagination, optional export, and custom rendering of AI message content (e.g. Markdown). The pagination UI is host-provided.
+
+\`\`\`typescript
+import { HistoryTab } from '@iblai/iblai-js/web-containers/next';
+import type {
+  HistoryTabProps,
+  HistoryTabLabels,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface HistoryTabProps {
+  renderMessageContent?: (content: string) => React.ReactNode;
+  PaginationComponent?: React.ComponentType<{
+    currentPage: number;
+    totalPages: number;
+    onPageChange: (page: number) => void;
+    disabled: boolean;
+    disableNumberedButtons?: boolean;
+  }>;
+  onExport?: (filters: ChatHistoryFilter) => void;
+  isExporting?: boolean;
+  labels?: DeepPartial<HistoryTabLabels>;
+}
+
+<HistoryTab
+  labels={MENTOR_HISTORY_TAB_LABELS}
+  renderMessageContent={(c) => <Markdown>{c}</Markdown>}
+  PaginationComponent={IblPagination}
+  onExport={handleExport}
+  isExporting={isExporting}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/history-tab.tsx\``,
+    PromptsTab: `# PromptsTab Component
+
+Suggested / guided prompts management tab. Supports toggling greeting method (proactive response vs. proactive prompt), adding / editing individual prompts, and rendering prompt bodies as plain text or Markdown via \`renderPromptContent\`.
+
+\`\`\`typescript
+import {
+  PromptsTab,
+  GreetingMethod,
+} from '@iblai/iblai-js/web-containers/next';
+import type {
+  PromptsTabProps,
+  PromptsTabLabels,
+  PromptsSelectedPrompt,
+  PromptsEditFormValues,
+  DeepPartial,
+} from '@iblai/iblai-js/web-containers/next';
+
+interface PromptsTabProps {
+  renderPromptContent?: (content: string) => React.ReactNode;
+  labels?: DeepPartial<PromptsTabLabels>;
+}
+
+<PromptsTab
+  labels={MENTOR_PROMPTS_TAB_LABELS}
+  renderPromptContent={(c) => <Markdown>{parsePrompt(c)}</Markdown>}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js and AgentSettingsProvider wrapper
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/prompts-tab.tsx\``,
+    CopyMentorModal: `# CopyMentorModal Component
+
+Forks a mentor into another tenant. Renders a Dialog with name / visibility / target-tenant inputs, drives \`useForkMentorMutation\` + \`useEditMentorMutation\`, and surfaces toast feedback. Typically launched from \`SettingsTab\`.
+
+\`\`\`typescript
+import { CopyMentorModal } from '@iblai/iblai-js/web-containers/next';
+import type { CopyMentorTenant } from '@iblai/iblai-js/web-containers/next';
+
+interface CopyMentorModalProps {
+  open: boolean;
+  onClose: () => void;
+  tenantKey: string;
+  mentorId: string;
+  username: string;
+  tenants: CopyMentorTenant[];          // { key, name?, is_admin }[]
+  isLoadingTenants?: boolean;
+  onSuccessfulCopy?: (copiedMentorId: string) => void;
+  labels?: CopyMentorModalLabels;
+}
+
+<CopyMentorModal
+  open={isCopyOpen}
+  onClose={() => setCopyOpen(false)}
+  tenantKey={tenantKey}
+  mentorId={mentorId}
+  username={username}
+  tenants={tenants}
+  isLoadingTenants={isLoadingTenants}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/settings-tab/copy-mentor-modal.tsx\``,
+    DeleteMentorModal: `# DeleteMentorModal Component
+
+AlertDialog confirmation for destroying a mentor. Drives \`useDeleteMentorMutation\` and calls back \`onSuccessfulDelete\` after the dialog closes so the host can handle parent-modal close and navigation.
+
+\`\`\`typescript
+import { DeleteMentorModal } from '@iblai/iblai-js/web-containers/next';
+
+interface DeleteMentorModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  tenantKey: string;
+  mentorId: string;
+  username: string;
+  onSuccessfulDelete?: (deletedMentorId: string) => void;
+  labels?: DeleteMentorModalLabels;   // SettingsTabLabels['deleteModal']
+}
+
+<DeleteMentorModal
+  isOpen={isDeleteOpen}
+  onClose={() => setDeleteOpen(false)}
+  tenantKey={tenantKey}
+  mentorId={mentorId}
+  username={username}
+  onSuccessfulDelete={(id) => {
+    setDeleteOpen(false);
+    router.push('/mentors');
+  }}
+/>
+\`\`\`
+
+> **Import from \`@iblai/iblai-js/web-containers/next\`** — requires Next.js
+
+**File Location**: \`packages/web-containers/src/components/modals/edit-mentor-modal/tabs/settings-tab/delete-mentor-modal.tsx\``,
 };
 const UI_PRIMITIVES = [
     'Button',
@@ -2621,6 +3418,13 @@ export function getComponentInfo(componentName) {
         'EdxIframe',
         'CourseContentTabPage',
         'CourseContentLayout',
+        'AgentSettingsProvider',
+        'SettingsTab',
+        'LLMTab',
+        'ToolsTab',
+        'MemoryTab',
+        'SafetyTab',
+        'CopyButton',
     ];
     return `Component "${componentName}" not found.