Skip to content

Sync ADP docs with cloudv2: budget enforcement, spending API, BYOA#41

Merged
micheleRP merged 1 commit into
mainfrom
verify-cloudv2-updates-may29
May 29, 2026
Merged

Sync ADP docs with cloudv2: budget enforcement, spending API, BYOA#41
micheleRP merged 1 commit into
mainfrom
verify-cloudv2-updates-may29

Conversation

@micheleRP
Copy link
Copy Markdown
Contributor

@micheleRP micheleRP commented May 29, 2026

Verified the docs against cloudv2 origin/main (2026-05-29) and applied updates for features that have landed and are complete since the last verification pass (PRs #31#39 were not yet reflected in the GA Readiness plan). WIP features (Guardrails, transcript-capture toggle, SharePoint/S3 managed MCP) were deliberately left untouched.

Changes

  • budgets.adoc — Document BudgetService spend-limit enforcement: per-agent hard caps (→ HTTP 429), warning threshold, daily/weekly/monthly periods, tenant-default vs. per-agent override, and CRUD. Scoped to what shipped (M1+M2); notifications, shared pools, and model/provider/org-scoped limits flagged as not-yet-available.
    • Spending API corrections: removed nonexistent ListSpendingEvents and the ORGANIZATION breakdown dimension; group_bydimension; corrected proto package to redpanda.api.adp.v1alpha1; un-nested start_time/end_time; entries[] response shape; added GetSpendingTimeSeriesByDimension.
    • Fixed microcent conversion: 1 cent = 1,000,000 microcents (divide by 100,000,000), was incorrectly "divide by 10,000".
  • permissions-reference.adoc — Added Budget permissions section (Writer gets all five; Reader gets get/list).
  • dashboard/overview.adoc — Resolved the surface-verification TODO (per-user filter, Top users + heatmap, Agents drill-down all live); per-agent analysis uses the USER dimension.
  • claude-code.adoc — MCP server URL /mcp/v1/servers/<name>/mcp/v1/<name>.
  • byoa-register.adoc — Reframed self-managed registration as a metadata-only governance/telemetry record. Removed unsupported gateway-A2A-routing claims and the reachability test (the aigw A2A proxy serves managed agents only).

Verified against

budget.proto, spending_service.proto, agent.proto, aigw/internal/mcp/proxy.go, aigw/internal/a2a/proxy.go, pkg/permissions/permissions_constants.go, adp-ui (lib/budget.ts, governance routes, budget e2e fixtures).

Notes for reviewers

  • The spending-API cURL/Python examples are proto-accurate but the exact wire encoding (Connect JSON vs. gRPC, enum spelling) was not exercised against a live cluster — worth a runtime check before GA.
  • The budgets UI is feature-flag-gated, so this PR documents budgets at concept + API level (no click-by-click UI steps yet).

🤖 Generated with Claude Code

Preview pages

Deploy preview (entry point — budget enforcement is the headline change):

Other changed pages live on the same preview build: control/permissions-reference, control/dashboard/overview, connect/byoa-register, connect/claude-code.

@micheleRP micheleRP requested a review from a team as a code owner May 29, 2026 15:39
@netlify
Copy link
Copy Markdown

netlify Bot commented May 29, 2026

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

Name Link
🔨 Latest commit a7a5eb2
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-agentic-data-plane/deploys/6a19b6ae261f3f00086929f7
😎 Deploy Preview https://deploy-preview-41--redpanda-agentic-data-plane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

Verified against cloudv2 origin/main (2026-05-29):

- budgets.adoc: document BudgetService spend-limit enforcement
  (per-agent caps -> HTTP 429, warn threshold, daily/weekly/monthly
  periods, default vs per-agent override, CRUD); scope to M1+M2.
  Fix spending API: drop nonexistent ListSpendingEvents and the
  ORGANIZATION breakdown dimension, group_by -> dimension, correct
  the proto package, un-nest start_time/end_time, entries[] response,
  add GetSpendingTimeSeriesByDimension. Fix microcent conversion
  (1 cent = 1,000,000 microcents; divide by 100,000,000).
- permissions-reference.adoc: add Budget permissions section.
- dashboard/overview.adoc: resolve surface-verification TODO;
  per-agent analysis uses the USER dimension.
- claude-code.adoc: MCP URL /mcp/v1/servers/<name> -> /mcp/v1/<name>.
- byoa-register.adoc: reframe self-managed registration as a
  metadata-only governance/telemetry record; remove unsupported
  gateway-A2A-routing claims (A2A proxy serves managed agents only).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@micheleRP micheleRP force-pushed the verify-cloudv2-updates-may29 branch from baf60db to a7a5eb2 Compare May 29, 2026 15:54
@micheleRP micheleRP merged commit 73e0052 into main May 29, 2026
4 checks passed
@micheleRP micheleRP deleted the verify-cloudv2-updates-may29 branch May 29, 2026 16:04
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.

1 participant