docs: daily update 2026-07-31

[deco-cms]

Daily docs update — 2026-07-31

Automated review of everything merged to main in the range v4.150.28...v4.150.29 (release v4.150.29, compare: v4.150.28...v4.150.29).

Note: This PR is based on the head of #5464 (docs/auto-update-2026-07-30), which was still open at the time this run started. Please merge #5464 first, then this one.

Commits reviewed (3)

Warranted a docs change (1):

• f0ac730 — fix(ai-providers): cap AI_PROVIDER_TOPUP_URL amount at $10,000 (fix(ai-providers): cap AI_PROVIDER_TOPUP_URL amount at $10,000 #5489). f0ac730 — Top-up requests were previously unbounded server-side and could surface an opaque 500 from Stripe above ~$999,999.99; now capped at $10,000 per request with a clean validation error. This is a user-facing behavior/limit change to the credit top-up flow described in ai-providers.mdx.

Skipped (2):

• 246a6f7 — [chore]: bump homebrew cask to 4.150.26 — bot commit (decocms-release[bot]), packaging metadata only, no user-facing doc impact.
• 3469cfe — [release]: bump changed workspace versions — release version bump commit, diff is only a package.json version string.

Files changed

• apps/docs/client/src/content/deco-studio/en/studio/ai-providers.mdx — added a sentence under "Deco AI Gateway" noting the $10,000 per-request top-up cap and that larger amounts require multiple top-ups.
• apps/docs/client/src/content/deco-studio/pt-br/studio/ai-providers.mdx — same addition, translated (auto-translated; please spot-check phrasing).

Consistency notes

• Checked quickstart.mdx (mentions gateway credits/top-up) — no change needed, it doesn't state a specific amount or limit.
• Checked overview.mdx and concepts.mdx — no references to top-up amounts or AI provider limits; no change needed.
• No other file references the top-up flow or amount limits.

pt-br translation was auto-generated; code blocks, URLs, and product terms (agent, connection, automation, MCP) were kept in English per convention.

---

Summary by cubic

Updates Studio docs to cover the sections editor variants, shared cloud sandboxes, seat management for invoiced orgs, Decopilot subagent concurrency validation, and the new $10,000 cap on AI Gateway top-ups. Includes pt‑BR translations.

• New Features
  • Agentic CMS: document variant reorder/preview/save-as-global; preserves preview scroll; Location matcher uses an interactive map (falls back if no Google Maps key).
  • Agents: clarify cloud sandbox is shared per branch; local deco link stays per user.
  • User Management: add seat billing for invoiced orgs with staged apply flow and totals.
  • Decopilot: document DECOPILOT_MAX_CONCURRENT_SUBAGENTS (default 4), queuing, and startup failure on malformed values.
  • AI Providers: note $10,000 per-request cap for gateway top-ups; use multiple top-ups for larger amounts.
  • pt‑BR pages updated to match.

^{Written for commit 9034d4e. Summary will update on new commits.}