docs: sync ADP changes from cloudv2 (2026-06-27)

[micheleRP]

Summary

Syncs a user-facing CLI change merged to redpanda-data/cloudv2 main in the last 24 hours.

Deploy preview: https://deploy-preview-113--redpanda-agentic-data-plane.netlify.app/agentic-data-plane/connect/oauth-providers/ (404s until Netlify finishes the preview build)

Documented change: rpk ai oauth → rpk ai oauth-provider

cloudv2 renamed the rpai oauth command to oauth-provider, making oauth-provider the canonical name (it pairs with the sibling oauth-client command). The short oauth and op forms are kept as cobra aliases, so existing scripts and docs that use rpk ai oauth ... keep working — this is not a breaking change.

What I changed:

• modules/connect/pages/oauth-providers.adoc — updated the "Register from the CLI" example from rpk ai oauth create to the canonical rpk ai oauth-provider create, and refreshed the maintainer TODO note (which previously recorded oauth as canonical) to reflect the flip.

This is a routine factual command-name sync grounded in cloudv2 source, not a content/maturity change. The old oauth form still works, so reverting this commit is safe if the team prefers to keep showing the short alias.

Source commit: redpanda-data/cloudv2@a6be32b2f5 — "rpai: rename oauth command to oauth-provider" (PR #27506, @birdayz)

Not changed (auto-generated)

The rpk ai oauth reference pages under modules/reference/pages/rpk/rpk-ai/ are auto-generated from the CLI and regenerate through the rpk reference pipeline, so I left them (and the nav entries that point at them) untouched.

TODO for human review (not documented here)

• feat(aigw): complete spending CSV export endpoint (REST) — redpanda-data/cloudv2@88bfafd83e (PR #27385, @malinskibeniamin) adds GET /spending/v1/export.csv to the AI Gateway, returning the complete (untruncated) Cost & Usage dataset as CSV. Its only consumer is the adp-ui "Download full report" button (frontend, not documented here), and adp-docs has no REST API reference surface for the spending/cost API today. Flagging for the docs team to decide whether the export endpoint and its query parameters (start, end, filter, user_email, agent_name) warrant a documented page rather than guessing at one.

The remaining cloudv2 commits in the window are adp-ui frontend work (server-side list filtering/pagination, visual-baseline regens), JS-MCP WebCrypto/TextDecoder runtime fixes, and internal refactors/CI — none with a user-facing ADP docs impact.

Reviewers

Added @birdayz (author of the source commit) as an optional reviewer for a source-accuracy check. Their approval is not blocking — this is a courtesy review only.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XkZtYqmjGYA9XvcNxUaSGy

[netlify]

✅ Deploy Preview for redpanda-agentic-data-plane ready!

Name	Link
🔨 Latest commit	5e2f658
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a3fbc55eb4f900008992fe3
😎 Deploy Preview	https://deploy-preview-113--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[micheleRP]

[adp-docs PR critic]

Verdict: looks accurate. The command rename is correctly grounded in cloudv2 source, and I found no issues.

Source-accuracy checks (against redpanda-data/cloudv2):

• apps/rpai/internal/cmd/oauth/cmd.go — Use: "oauth-provider", Aliases: []string{"oauth", "op"}. Confirms oauth-provider is the canonical command and oauth/op are aliases, exactly as the diff and TODO note state.
• apps/rpai/internal/cmd/oauth/doc.go and apps/rpai/CLAUDE.md — oauth-provider keeps the aigwctl name as canonical "because it pairs with oauth-client," with oauth/op preserved as cobra aliases. Matches the PR's rationale.
• apps/rpai/internal/cmd/oauth/cmd_test.go (TestOAuth_Command_Aliases) and apps/rpai/testdata/commands-snapshot.md — assert/show oauth-provider, oauth, op, so the alias-retention ("not a breaking change") claim holds.
• apps/rpai/README.md — canonical example is rpai oauth-provider create --name … --display-name …, consistent with the updated doc example. The create subcommand and the example's flags are unchanged by this diff (only the noun changed), so nothing else needed re-verification.

Completeness: The file's only two rpk ai oauth references (the example and the maintainer TODO) are both updated; I found no remaining bare rpk ai oauth usages elsewhere in modules/ (outside the auto-generated reference pages, which the PR correctly leaves untouched). No stray inconsistency.

Correctness: The unchanged xref xref:reference:rpk/rpk-ai/rpk-ai.adoc[rpk ai] is fine; AsciiDoc is well-formed.

No standards, maturity, or policy concerns — this is a routine factual command-name sync, no maturity labels or content positioning touched.

---

Generated by Claude Code