@iblai/mcp 1.3.4 → 1.4.1

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.
@@ -2587,8 +2669,8 @@ interface AgentSettingsContextValue {
   enableRBAC={config.enableRBAC()}
   executeGatedAction={(fn) => executeWithTrialCheck(fn)}
 >
-  <SettingsTab ... />
-  <LLMTab ... />
+  <AgentSettingsTab ... />
+  <AgentLLMTab ... />
 </AgentSettingsProvider>
 \`\`\`
 
@@ -2597,15 +2679,15 @@ The \`useAgentSettings()\` hook is also exported for building custom tabs that r
 > **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
+    AgentSettingsTab: `# AgentSettingsTab 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';
+import { AgentSettingsTab } from '@iblai/iblai-js/web-containers/next';
+import type { AgentSettingsTabProps, DeepPartial, SettingsTabLabels } from '@iblai/iblai-js/web-containers/next';
 
-interface SettingsTabProps {
+interface AgentSettingsTabProps {
   onSettingsSaved?: (mentor: unknown) => void;
   onMentorDeleted?: (deletedMentorId: string) => void;
   tenants: CopyMentorTenant[];
@@ -2619,7 +2701,7 @@ interface SettingsTabProps {
 }
 
 // With the default "agent" labels:
-<SettingsTab
+<AgentSettingsTab
   tenants={tenants}
   onMentorDeleted={handleDelete}
   onMentorCopied={handleCopy}
@@ -2628,7 +2710,7 @@ interface SettingsTabProps {
 // With custom "mentor" labels:
 import { MENTOR_SETTINGS_TAB_LABELS } from './mentor-labels';
 
-<SettingsTab
+<AgentSettingsTab
   tenants={tenants}
   onMentorDeleted={handleDelete}
   onMentorCopied={handleCopy}
@@ -2641,15 +2723,15 @@ The label system uses typed nested-object overrides. The package ships \`AGENT_S
 > **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
+    AgentLLMTab: `# AgentLLMTab 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';
+import { AgentLLMTab } from '@iblai/iblai-js/web-containers/next';
+import type { AgentLLMTabProps, LLMProviderDetails, DeepPartial, LLMTabLabels } from '@iblai/iblai-js/web-containers/next';
 
-interface LLMTabProps {
+interface AgentLLMTabProps {
   showConfigurationHeader?: boolean;
   getLLMProviderDetails: (providerName: string, llmName?: string) => LLMProviderDetails;
   labels?: DeepPartial<LLMTabLabels>;
@@ -2660,7 +2742,7 @@ interface LLMProviderDetails {
   name: string;
 }
 
-<LLMTab
+<AgentLLMTab
   getLLMProviderDetails={(name) => ({
     name: name.charAt(0).toUpperCase() + name.slice(1),
     logo: \`/llm-\${name}-provider.png\`,
@@ -2674,25 +2756,25 @@ interface LLMProviderDetails {
 > **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
+    AgentToolsTab: `# AgentToolsTab 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';
+import { AgentToolsTab } from '@iblai/iblai-js/web-containers/next';
+import type { AgentToolsTabProps, ToolsTabLabels, DeepPartial } from '@iblai/iblai-js/web-containers/next';
 
-interface ToolsTabProps {
+interface AgentToolsTabProps {
   labels?: DeepPartial<ToolsTabLabels>;
 }
 
 // With the default "agent" labels:
-<ToolsTab />
+<AgentToolsTab />
 
 // With custom "mentor" labels:
 import { MENTOR_TOOLS_TAB_LABELS } from './mentor-tools-labels';
 
-<ToolsTab labels={MENTOR_TOOLS_TAB_LABELS} />
+<AgentToolsTab 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.
@@ -2700,25 +2782,25 @@ Each tool row has a Switch that toggles the tool slug on the mentor via \`useEdi
 > **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
+    AgentMemoryTab: `# AgentMemoryTab 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';
+import { AgentMemoryTab } from '@iblai/iblai-js/web-containers/next';
+import type { AgentMemoryTabProps, MemoryTabLabels, DeepPartial } from '@iblai/iblai-js/web-containers/next';
 
-interface MemoryTabProps {
+interface AgentMemoryTabProps {
   labels?: DeepPartial<MemoryTabLabels>;
 }
 
 // With the default "agent" labels:
-<MemoryTab />
+<AgentMemoryTab />
 
 // With custom "mentor" labels:
 import { MENTOR_MEMORY_TAB_LABELS } from './mentor-memory-labels';
 
-<MemoryTab labels={MENTOR_MEMORY_TAB_LABELS} />
+<AgentMemoryTab 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.
@@ -2726,21 +2808,21 @@ The enable toggle mutates \`enable_memory_component\` on mentor settings. The Ma
 > **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
+    AgentSafetyTab: `# AgentSafetyTab 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 { AgentSafetyTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  SafetyTabProps,
+  AgentSafetyTabProps,
   SafetyTabLabels,
   SafetySelectedPrompt,
   SafetyEditFormValues,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface SafetyTabProps {
+interface AgentSafetyTabProps {
   /** 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. */
@@ -2764,7 +2846,7 @@ interface SafetyTabProps {
   labels?: DeepPartial<SafetyTabLabels>;
 }
 
-<SafetyTab
+<AgentSafetyTab
   labels={MENTOR_SAFETY_TAB_LABELS}
   renderPromptContent={(content) => (
     <Markdown className="text-sm text-gray-700">
@@ -2785,7 +2867,7 @@ The moderation/safety toggle switches use \`executeGatedAction\` from context wh
 **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.
+Small button that copies text to the clipboard and shows "Copied" feedback for a short duration. Used by prompt cards in AgentSafetyTab, AgentPromptsTab, and AgentDisclaimersTab.
 
 \`\`\`typescript
 import { CopyButton } from '@iblai/iblai-js/web-containers/next';
@@ -2985,25 +3067,25 @@ interface StarButtonProps {
     // Each tab reads identity (tenantKey / mentorId / username / enableRBAC /
     // executeGatedAction) from <AgentSettingsProvider> via useAgentSettings().
     // ============================================================================
-    AccessTab: `# AccessTab Component
+    AgentAccessTab: `# AgentAccessTab 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 { AgentAccessTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  AccessTabProps,
+  AgentAccessTabProps,
   AccessTabLabels,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface AccessTabProps {
+interface AgentAccessTabProps {
   labels?: DeepPartial<AccessTabLabels>;
   /** Called when the tab fetches RBAC permissions for /users/ and /groups/. */
   onPermissionsLoaded?: (permissions: object) => void;
 }
 
-<AccessTab
+<AgentAccessTab
   labels={MENTOR_ACCESS_TAB_LABELS}
   onPermissionsLoaded={(perms) => dispatch(rbac.merge(perms))}
 />
@@ -3012,43 +3094,43 @@ interface AccessTabProps {
 > **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
+    AgentApiTab: `# AgentApiTab 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 { AgentApiTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  ApiTabProps,
+  AgentApiTabProps,
   ApiTabLabels,
   ApiKey,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface ApiTabProps {
+interface AgentApiTabProps {
   labels?: DeepPartial<ApiTabLabels>;
 }
 
-<ApiTab labels={MENTOR_API_TAB_LABELS} />
+<AgentApiTab 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
+    AgentDatasetsTab: `# AgentDatasetsTab 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 { AgentDatasetsTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  DatasetsTabProps,
+  AgentDatasetsTabProps,
   DatasetsTabLabels,
   Dataset,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface DatasetsTabProps {
+interface AgentDatasetsTabProps {
   labels?: DeepPartial<DatasetsTabLabels>;
   onSelect?: (dataset: Dataset) => void;
   selectedDatasetId?: string;
@@ -3065,7 +3147,7 @@ interface DatasetsTabProps {
   }>;
 }
 
-<DatasetsTab
+<AgentDatasetsTab
   labels={MENTOR_DATASETS_TAB_LABELS}
   AddResourceModal={AddResourceModal}
   PaginationComponent={IblPagination}
@@ -3075,25 +3157,25 @@ interface DatasetsTabProps {
 > **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
+    AgentDisclaimersTab: `# AgentDisclaimersTab 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 { AgentDisclaimersTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  DisclaimersTabProps,
+  AgentDisclaimersTabProps,
   DisclaimersTabLabels,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface DisclaimersTabProps {
+interface AgentDisclaimersTabProps {
   labels?: DeepPartial<DisclaimersTabLabels>;
   defaultDisclaimerContent?: string;
   renderContent?: (content: string) => React.ReactNode;
 }
 
-<DisclaimersTab
+<AgentDisclaimersTab
   labels={MENTOR_DISCLAIMERS_TAB_LABELS}
   defaultDisclaimerContent={DEFAULT_DISCLAIMER}
   renderContent={(content) => <Markdown>{content}</Markdown>}
@@ -3103,14 +3185,14 @@ interface DisclaimersTabProps {
 > **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
+    AgentEmbedTab: `# AgentEmbedTab 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 { AgentEmbedTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  EmbedTabProps,
+  AgentEmbedTabProps,
   EmbedTabLabels,
   EmbedUrlConfig,
   VisibilityOption,
@@ -3118,7 +3200,7 @@ import type {
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface EmbedTabProps {
+interface AgentEmbedTabProps {
   labels?: DeepPartial<EmbedTabLabels>;
   urls: EmbedUrlConfig;
   CopyCodeBlock: React.ComponentType<{ code: string }>;
@@ -3128,7 +3210,7 @@ interface EmbedTabProps {
   supportEmail?: string;
 }
 
-<EmbedTab
+<AgentEmbedTab
   labels={MENTOR_EMBED_TAB_LABELS}
   urls={embedUrls}
   CopyCodeBlock={CopyCodeBlock}
@@ -3140,19 +3222,19 @@ interface EmbedTabProps {
 > **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
+    AgentHistoryTab: `# AgentHistoryTab 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 { AgentHistoryTab } from '@iblai/iblai-js/web-containers/next';
 import type {
-  HistoryTabProps,
+  AgentHistoryTabProps,
   HistoryTabLabels,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface HistoryTabProps {
+interface AgentHistoryTabProps {
   renderMessageContent?: (content: string) => React.ReactNode;
   PaginationComponent?: React.ComponentType<{
     currentPage: number;
@@ -3166,7 +3248,7 @@ interface HistoryTabProps {
   labels?: DeepPartial<HistoryTabLabels>;
 }
 
-<HistoryTab
+<AgentHistoryTab
   labels={MENTOR_HISTORY_TAB_LABELS}
   renderMessageContent={(c) => <Markdown>{c}</Markdown>}
   PaginationComponent={IblPagination}
@@ -3178,29 +3260,29 @@ interface HistoryTabProps {
 > **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
+    AgentPromptsTab: `# AgentPromptsTab 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,
+  AgentPromptsTab,
   GreetingMethod,
 } from '@iblai/iblai-js/web-containers/next';
 import type {
-  PromptsTabProps,
+  AgentPromptsTabProps,
   PromptsTabLabels,
   PromptsSelectedPrompt,
   PromptsEditFormValues,
   DeepPartial,
 } from '@iblai/iblai-js/web-containers/next';
 
-interface PromptsTabProps {
+interface AgentPromptsTabProps {
   renderPromptContent?: (content: string) => React.ReactNode;
   labels?: DeepPartial<PromptsTabLabels>;
 }
 
-<PromptsTab
+<AgentPromptsTab
   labels={MENTOR_PROMPTS_TAB_LABELS}
   renderPromptContent={(c) => <Markdown>{parsePrompt(c)}</Markdown>}
 />
@@ -3211,7 +3293,7 @@ interface PromptsTabProps {
 **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\`.
+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 \`AgentSettingsTab\`.
 
 \`\`\`typescript
 import { CopyMentorModal } from '@iblai/iblai-js/web-containers/next';
@@ -3337,11 +3419,11 @@ export function getComponentInfo(componentName) {
         'CourseContentTabPage',
         'CourseContentLayout',
         'AgentSettingsProvider',
-        'SettingsTab',
-        'LLMTab',
-        'ToolsTab',
-        'MemoryTab',
-        'SafetyTab',
+        'AgentSettingsTab',
+        'AgentLLMTab',
+        'AgentToolsTab',
+        'AgentMemoryTab',
+        'AgentSafetyTab',
         'CopyButton',
     ];
     return `Component "${componentName}" not found.

package/dist/tools/component-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-info.js","sourceRoot":"","sources":["../../src/tools/component-info.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component-info.js","sourceRoot":"","sources":["../../src/tools/component-info.ts"],"names":[],"mappings":"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"}

package/dist/tools/hook-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-info.d.ts","sourceRoot":"","sources":["../../src/tools/hook-info.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAcxB,CAAC;AA07EF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuIpD"}
+{"version":3,"file":"hook-info.d.ts","sourceRoot":"","sources":["../../src/tools/hook-info.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAcxB,CAAC;AAu+EF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwIpD"}

package/dist/tools/hook-info.js

@@ -272,6 +272,50 @@ const {
 - \`handleSubscribeUserTrigger()\` - Initiates subscription renewal
 
 **File Location**: \`packages/web-utils/src/hooks/subscription/use-subscription-handler.ts\``,
+    useStripeUpgrade: `# useStripeUpgrade Hook
+
+Resolves the Stripe Pricing Page session for a tenant and exposes ready-to-redirect checkout URLs for the \`free\` and \`premium\` plans. Used by the \`CreditBalance\` dropdown ("Upgrade Plan" button) and \`UpgradePackageModal\` ("Upgrade for free" CTA) to start the upgrade flow.
+
+\`\`\`typescript
+import { useStripeUpgrade } from '@iblai/iblai-js/web-utils';
+
+interface UseStripeUpgradeArgs {
+  redirectUrl: string;        // success_url passed to Stripe
+  sourcePlatformKey: string;  // current tenant key
+  mainPlatformKey: string;    // main IBL platform key
+  currentUserEmail: string;   // prefills locked_prefilled_email on the checkout URL
+}
+
+type StripeUpgradePlan = 'free' | 'premium';
+
+const {
+  isLoading,
+  freeUrl,           // resolved checkout URL for the free plan (after handleUpgrade)
+  premiumUrl,        // resolved checkout URL for the premium plan (after handleUpgrade)
+  handleUpgrade,     // (redirectPlan?: 'free' | 'premium') => Promise<void>
+} = useStripeUpgrade({
+  redirectUrl,
+  sourcePlatformKey,
+  mainPlatformKey,
+  currentUserEmail,
+});
+
+// Trigger an immediate redirect into the premium checkout
+await handleUpgrade('premium');
+
+// Or resolve URLs without redirecting (useful when rendering plan-specific buttons)
+await handleUpgrade();
+\`\`\`
+
+**Behavior:**
+- Calls \`useLazyGetStripePricingPageSessionQuery\` (data-layer) with \`platform_key=mainPlatformKey\` and \`source_platform_key=sourcePlatformKey\`.
+- Parses the returned \`payment_link_url\` (a JSON string of \`{ free?, premium? }\`) and appends \`locked_prefilled_email\` + \`client_reference_id\` to each link.
+- If \`redirectPlan\` is provided and the matching link resolved, sets \`window.location.href\` to that URL.
+- \`isLoading\` is \`true\` while the lazy query is in-flight.
+
+**Related:** \`UpgradePackageModal\`, \`CreditBalance\`, \`useLazyGetStripePricingPageSessionQuery\`, \`useSubscriptionHandler\`.
+
+**File Location**: \`packages/web-utils/src/hooks/stripe/use-stripe-upgrade.ts\``,
     // ============================================================================
     // TENANT HOOKS
     // ============================================================================
@@ -2369,6 +2413,7 @@ export function getHookInfo(hookName) {
 - useProfileImageUpload - Profile image upload
 - useTenantMetadata - Tenant configuration
 - useSubscriptionHandler - Subscription management
+- useStripeUpgrade - Resolve Stripe Pricing Page session and redirect to free/premium checkout
 - useTimeTracker - Time tracking for analytics
 - useDayJs - Date/time utilities