Skip to content

Open-source agentic AI Search Execution Platform. Track AI visibility, find opportunities, and let agents turn signals into prioritized actions and drafted fixes across ChatGPT, Claude, Gemini, Google AI Overviews, Google AI Mode, Perplexity, Grok, and Microsoft Copilot.

feat(settings): show AI usage on the plans as tiers of Starter's, Growth at 5x (#1298)

Cihan3867cb8ba955
diff --git a/server/src/config/plans.js b/server/src/config/plans.js
index bee236b63..6f2358028 100644
--- a/server/src/config/plans.js
+++ b/server/src/config/plans.js
@@ -52,9 +52,11 @@ export const PLANS = {
maxDomainsPerBrand: 3,
maxVolumeAnalyses: 4,
maxBriefGenerations: 10,
- // A $1 trial of Improve, not 1% of the $49 price: enough for a few
- // generations a month, so Starter can see what it does (Growth+ was
- // PROMPT-003's call). Shared with the Content Editor's AI later.
+ // AI usage, in tiers the billing cards show as multiples of Starter's:
+ // $1 here (1x), Growth $5 (5x), Enterprise $10 or 1% of its contract.
+ // Spent on Improve and, later, the Content Editor's AI. Starter's is a
+ // trial: enough for a few generations a month (Growth+ was PROMPT-003's
+ // call).
improveMonthlyBudgetUsd: 1,
// 0.1% of the $49 price, spent rating suggestions' relevance (VIS-011).
relevanceMonthlyBudgetUsd: 0.049,
@@ -99,8 +101,8 @@ export const PLANS = {
maxDomainsPerBrand: 10,
maxVolumeAnalyses: 10,
maxBriefGenerations: 50,
- // 1% of the $249 price, spent on Improve model calls (PROMPT-003).
- improveMonthlyBudgetUsd: 2.49,
+ // AI usage: 5x Starter's $1 (the billing card's "5x AI usage").
+ improveMonthlyBudgetUsd: 5,
// 0.1% of the $249 price, spent rating suggestions' relevance (VIS-011).
relevanceMonthlyBudgetUsd: 0.249,
maxOpportunitiesPerMonth: 50,
@@ -142,9 +144,10 @@ export const PLANS = {
maxVolumeAnalyses: -1,
// Per-customer: override via organizations.plan_overrides in the DB.
maxBriefGenerations: -1,
- // 1% of the $499 floor. plan_overrides.contractMonthlyUsd raises it to 1%
- // of the contract; an explicit plan_overrides.improveMonthlyBudgetUsd wins.
- improveMonthlyBudgetUsd: 4.99,
+ // AI usage: $10 at the least, above Growth's $5.
+ // plan_overrides.contractMonthlyUsd raises it to 1% of the contract; an
+ // explicit plan_overrides.improveMonthlyBudgetUsd wins.
+ improveMonthlyBudgetUsd: 10,
// 0.1% of the $499 floor, raised to 0.1% of contractMonthlyUsd; an
// explicit plan_overrides.relevanceMonthlyBudgetUsd wins.
relevanceMonthlyBudgetUsd: 0.499,
diff --git a/server/src/lib/improve-cost.js b/server/src/lib/improve-cost.js
index 4c3a991d7..1980778dc 100644
--- a/server/src/lib/improve-cost.js
+++ b/server/src/lib/improve-cost.js
@@ -18,7 +18,7 @@ export const MODEL_PRICES = {
export const FALLBACK_PRICE = { input: 5, output: 25 };
-/** Share of the plan price the Improve feature may spend on model calls. */
+/** Share of an Enterprise contract's monthly value its AI usage budget may spend (plan-guard.js). */
export const IMPROVE_BUDGET_SHARE = 0.01;
/**
diff --git a/server/src/lib/plan-guard.js b/server/src/lib/plan-guard.js
index 8b4b9c9c9..d94025a91 100644
--- a/server/src/lib/plan-guard.js
+++ b/server/src/lib/plan-guard.js
@@ -36,9 +36,9 @@ export class PlanLimitError extends Error {
* organizations.plan_overrides (jsonb) — mirrors web getOrgPlan().
*
* `contractMonthlyUsd` is the contract's monthly value, entered when the deal
- * is signed. It sets the Improve budget to the same 1% share of the contract
- * the other plans get of their price (never below the plan default), unless
- * `improveMonthlyBudgetUsd` is set explicitly, which wins. The relevance
+ * is signed. It sets the Improve budget to 1% of the contract (never below
+ * the plan default), unless `improveMonthlyBudgetUsd` is set explicitly,
+ * which wins. The relevance
* budget (VIS-011) follows the same rule at 0.1%, rounded down so it never
* passes the share.
*/
@@ -319,9 +319,10 @@ async function improveSpendThisPeriod(orgId) {
}
/**
- * Improve-tab budget (PROMPT-003): a monthly USD budget per organization,
- * 1% of the plan price (plan.limits.improveMonthlyBudgetUsd), charged with
- * each generation's real token cost so the share holds for any model. Users
+ * Improve-tab budget (PROMPT-003): a monthly USD budget per organization
+ * (plan.limits.improveMonthlyBudgetUsd: Starter $1, Growth $5, Enterprise
+ * $10 or 1% of its contract), charged with each generation's real token
+ * cost so the budget holds for any model. Users
* see an estimate of generations left, not dollars. -1 is unlimited.
*/
export async function getImproveQuotaStatus(orgId, modelId) {
diff --git a/server/src/lib/prompt-improve.test.js b/server/src/lib/prompt-improve.test.js
index b0b306182..2a7d2103f 100644
--- a/server/src/lib/prompt-improve.test.js
+++ b/server/src/lib/prompt-improve.test.js
@@ -311,14 +311,14 @@ describe('improveRangeKey', () => {
});
describe('Improve plan limits', () => {
- it('is on every plan: a $1 trial on Starter, 1% of the plan price above it', async () => {
+ it('is on every plan, in AI usage tiers: Starter $1, Growth $5 (5x), Enterprise $10', async () => {
const { PLANS } = await import('../config/plans.js');
expect(PLANS.starter.limits.improveMonthlyBudgetUsd).toBe(1);
for (const id of ['starter', 'growth', 'enterprise', 'self_hosted']) {
expect(PLANS[id].limits.features).toContain('prompt_improve');
}
- expect(PLANS.growth.limits.improveMonthlyBudgetUsd).toBe(2.49);
- expect(PLANS.enterprise.limits.improveMonthlyBudgetUsd).toBe(4.99);
+ expect(PLANS.growth.limits.improveMonthlyBudgetUsd).toBe(5);
+ expect(PLANS.enterprise.limits.improveMonthlyBudgetUsd).toBe(10);
expect(PLANS.self_hosted.limits.improveMonthlyBudgetUsd).toBe(-1);
});
});
diff --git a/web/messages/en.json b/web/messages/en.json
index 70b0b8b46..801899285 100644
--- a/web/messages/en.json
+++ b/web/messages/en.json
@@ -4901,7 +4901,9 @@
"unlimitedSeats": "Unlimited seats",
"prompts": "{count, number} prompts tracked",
"briefs": "{count, number} content briefs a month",
- "audits": "{count, number} site audits a month"
+ "audits": "{count, number} site audits a month",
+ "aiUsage": "{count}x AI usage",
+ "aiUsageHint": "A monthly allowance for Ansvisor's AI features: Improve suggestions and the Content Editor's AI. Agent Chat runs on your own AI key."
},
"contactUs": "Contact Us",
"integrations": "Integrations",
diff --git a/web/src/components/settings/plan-switcher.test.tsx b/web/src/components/settings/plan-switcher.test.tsx
index ef3d94159..21d618ef9 100644
--- a/web/src/components/settings/plan-switcher.test.tsx
+++ b/web/src/components/settings/plan-switcher.test.tsx
@@ -67,6 +67,7 @@ describe('the plan cards', () => {
'ChatGPT & Microsoft Copilot tracking',
'10 content briefs a month',
'100 site audits a month',
+ '1x AI usage',
'MCP & API access',
],
Growth: [
@@ -76,11 +77,17 @@ describe('the plan cards', () => {
'ChatGPT, Perplexity, Gemini, Microsoft Copilot, Google AI Mode and Google AI Overviews tracking',
'50 content briefs a month',
'500 site audits a month',
+ '5x AI usage',
'Multi-region tracking',
'White-label reports & Looker Studio',
],
});
expect(container.textContent).not.toContain('8 answer engines');
+ // AI usage says what it covers on hover.
+ const ai = [...container.querySelectorAll('li span')].find(
+ (el) => el.textContent === '5x AI usage',
+ );
+ expect(ai?.getAttribute('title')).toContain('Improve suggestions and the Content Editor');
expect(container.textContent).toContain(
'For small teams getting started with AI visibility monitoring and optimization.',
);
diff --git a/web/src/components/settings/plan-switcher.tsx b/web/src/components/settings/plan-switcher.tsx
index 9dacd39f0..ef998e207 100644
--- a/web/src/components/settings/plan-switcher.tsx
+++ b/web/src/components/settings/plan-switcher.tsx
@@ -138,11 +138,16 @@ export function PlanSwitcher({ subscription, onUpdate }: PlanSwitcherProps) {
/**
* A plan card's list, as the pricing page puts it: brands, seats, prompts,
* the answer engines it tracks, content briefs and site audits a month,
- * then what the plan adds.
+ * AI usage as a multiple of Starter's, then what the plan adds.
*/
- function planFeatures(planId: PlanId): string[] {
+ function planFeatures(planId: PlanId): { text: string; hint?: string }[] {
const { limits } = PLANS[planId];
- return [
+ const starterAi = PLANS.starter.limits.improveMonthlyBudgetUsd;
+ const aiUsage =
+ starterAi > 0 && limits.improveMonthlyBudgetUsd > 0
+ ? Math.round(limits.improveMonthlyBudgetUsd / starterAi)
+ : null;
+ const items = [
limits.maxBrands === -1
? tCards('unlimitedBrands')
: tCards('brands', { count: limits.maxBrands }),
@@ -153,7 +158,13 @@ export function PlanSwitcher({ subscription, onUpdate }: PlanSwitcherProps) {
tCards(`${planId}.engines`),
tCards('briefs', { count: limits.maxBriefGenerations }),
tCards('audits', { count: limits.maxSiteAudits }),
- ...(tCards.raw(`${planId}.extras`) as string[]),
+ ].map((text) => ({ text }));
+ return [
+ ...items,
+ ...(aiUsage
+ ? [{ text: tCards('aiUsage', { count: aiUsage }), hint: tCards('aiUsageHint') }]
+ : []),
+ ...(tCards.raw(`${planId}.extras`) as string[]).map((text) => ({ text })),
];
}
@@ -193,9 +204,18 @@ export function PlanSwitcher({ subscription, onUpdate }: PlanSwitcherProps) {
<ul className="mb-4 space-y-1.5 text-sm">
{planFeatures(planId).map((feature) => (
- <li key={feature} className="flex items-start gap-2">
+ <li key={feature.text} className="flex items-start gap-2">
<Check className="mt-0.5 h-3.5 w-3.5 shrink-0 text-emerald-600 dark:text-emerald-400" />
- <span>{feature}</span>
+ <span
+ title={feature.hint}
+ className={
+ feature.hint
+ ? 'cursor-help underline decoration-dotted underline-offset-4'
+ : undefined
+ }
+ >
+ {feature.text}
+ </span>
</li>
))}
</ul>
diff --git a/web/src/config/plans.ts b/web/src/config/plans.ts
index 79cac11e4..26f0786fd 100644
--- a/web/src/config/plans.ts
+++ b/web/src/config/plans.ts
@@ -44,10 +44,12 @@ export interface PlanLimits {
*/
maxBriefGenerations: number;
/**
- * Monthly USD budget for Improve-tab model calls (Positions panel,
- * PROMPT-003): 1% of the plan price ($1 on Starter, a trial), enforced on
- * the server from each call's real token cost so it holds whichever
- * model is configured. -1 = unlimited (self-host).
+ * Monthly USD budget for AI usage: Improve-tab model calls (Positions
+ * panel, PROMPT-003) and, later, the Content Editor's AI. Starter $1,
+ * Growth $5, Enterprise $10 (or 1% of its contract); the billing cards
+ * show them as multiples of Starter's. Enforced on the server from each
+ * call's real token cost so it holds whichever model is configured.
+ * -1 = unlimited (self-host).
*/
improveMonthlyBudgetUsd: number;
/**
@@ -161,9 +163,11 @@ export const PLANS: Record<PlanId, Plan> = {
maxDomainsPerBrand: 3,
maxVolumeAnalyses: 4,
maxBriefGenerations: 10,
- // A $1 trial of Improve, not 1% of the $49 price: enough for a few
- // generations a month, so Starter can see what it does (Growth+ was
- // PROMPT-003's call). Shared with the Content Editor's AI later.
+ // AI usage, in tiers the billing cards show as multiples of Starter's:
+ // $1 here (1x), Growth $5 (5x), Enterprise $10 or 1% of its contract.
+ // Spent on Improve and, later, the Content Editor's AI. Starter's is a
+ // trial: enough for a few generations a month (Growth+ was PROMPT-003's
+ // call).
improveMonthlyBudgetUsd: 1,
// 0.1% of the $49 price, spent rating suggestions' relevance (VIS-011).
relevanceMonthlyBudgetUsd: 0.049,
@@ -211,8 +215,8 @@ export const PLANS: Record<PlanId, Plan> = {
maxDomainsPerBrand: 10,
maxVolumeAnalyses: 10,
maxBriefGenerations: 50,
- // 1% of the $249 price, spent on Improve model calls (PROMPT-003).
- improveMonthlyBudgetUsd: 2.49,
+ // AI usage: 5x Starter's $1 (the billing card's "5x AI usage").
+ improveMonthlyBudgetUsd: 5,
// 0.1% of the $249 price, spent rating suggestions' relevance (VIS-011).
relevanceMonthlyBudgetUsd: 0.249,
maxOpportunitiesPerMonth: 50,
@@ -256,9 +260,10 @@ export const PLANS: Record<PlanId, Plan> = {
maxVolumeAnalyses: -1,
// Per-customer: override via organizations.plan_overrides in the DB.
maxBriefGenerations: -1,
- // 1% of the $499 floor. plan_overrides.contractMonthlyUsd raises it to 1%
- // of the contract; an explicit plan_overrides.improveMonthlyBudgetUsd wins.
- improveMonthlyBudgetUsd: 4.99,
+ // AI usage: $10 at the least, above Growth's $5.
+ // plan_overrides.contractMonthlyUsd raises it to 1% of the contract; an
+ // explicit plan_overrides.improveMonthlyBudgetUsd wins.
+ improveMonthlyBudgetUsd: 10,
// 0.1% of the $499 floor, raised to 0.1% of contractMonthlyUsd; an
// explicit plan_overrides.relevanceMonthlyBudgetUsd wins.
relevanceMonthlyBudgetUsd: 0.499,