Skip to content

fix: account_usage no longer links to checkout or upgrade pages - #48

Merged
tedi-z merged 1 commit into
mainfrom
fix/ACT-1566-account-usage-links
Oct 14, 2026
Merged

tedi-z merged 1 commit into
mainfrom
fix/ACT-1566-account-usage-links

Conversation

@tedi-z

@tedi-z tedi-z commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Why

The OpenAI plugin directory (ACT-1566) applies this rule from https://developers.openai.com/plugins/plugin-guidelines, under Commerce and monetization: plugins may "link to an informational page describing available plans", but may not "link directly to a checkout or other transactional page" or "promote upgrades".

The account_usage description sent the model to two pages:

  • app.zenrows.com/billing?topup=open, which opens the credit-pack checkout;
  • app.zenrows.com/plans, the in-app billing plans page.

Change

  • The AUTH004 text now says when the allowance renews (period_ends_at, already in the tool's response). For plans it points to https://www.zenrows.com/pricing, the informational page, which returns 200.
  • The text no longer says "this tool's response has the plan's prices". The response only has the current plan's own price, which I checked against the live tool, so the sentence overstated what the response contains.
  • A new test in tests/account.test.ts fails if the description links to app.zenrows.com/billing or /plans. It failed on main before the fix and passes after it.

Trade-off

Every client loses the direct top-up link, including stdio and Claude users, because the description is shared. The alternative is to keep the links for non-hosted clients. That adds a branch to the description for one sentence, so I didn't take it. Say if you want it.

Verification

  • npm test: 178 pass, 0 fail.
  • npm run typecheck, npm run lint, prettier --check: clean.

Separate from #47, which covers the tool-wording change.

Refs ACT-1566

🤖 Generated with Claude Code

https://claude.ai/code/session_01BUChpDttrHDtU8izeDT2op


Generated by Claude Code

OpenAI's plugin directory rejects tools that link to a page that starts a
purchase or an upgrade; an informational page about plans is allowed. The
account_usage description pointed at the credit-pack checkout
(app.zenrows.com/billing?topup=open) and the in-app plans page. It now
points at www.zenrows.com/pricing and at period_ends_at, the date the
allowance renews. A test pins it.

Refs ACT-1566

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BUChpDttrHDtU8izeDT2op
@linear

linear Bot commented Oct 13, 2026

Copy link
Copy Markdown

ACT-1566

@tedi-z tedi-z self-assigned this Oct 13, 2026
@tedi-z
tedi-z requested a review from AnderRV October 13, 2026 16:18
@tedi-z
tedi-z marked this pull request as ready for review October 13, 2026 16:18
@tedi-z
tedi-z merged commit a8e7465 into main Oct 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants