From 20c0539a8d2a2b49c7fe5653941f8fce9dfc1f8b Mon Sep 17 00:00:00 2001 From: micheleRP Date: Wed, 6 May 2026 10:19:47 -0600 Subject: [PATCH 01/14] Add ADP-specific glossary terms for GA MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add 10 new term partials to support ADP docs at GA (2026-06-15): - tool, resource: bug fix for existing glossterm: usage in adp-docs that currently renders as flat text (distinct from tool-invocation and resource-group) - declarative-agent, byoa: agent runtime variants per agent.proto - oauth-provider, oauth-client, oauth-connection, token-vault: OAuth resource model per the v1alpha1 proto suite (RFC 005) - spending-event: per-LLM-request cost record per spending_event.proto - governance-dashboard: V0 dashboard per the Governance V0 PRD + RFC 006 ADP Docs Plan ยง3A R1. Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/terms/partials/byoa.adoc | 4 ++++ modules/terms/partials/declarative-agent.adoc | 4 ++++ modules/terms/partials/governance-dashboard.adoc | 4 ++++ modules/terms/partials/oauth-client.adoc | 4 ++++ modules/terms/partials/oauth-connection.adoc | 4 ++++ modules/terms/partials/oauth-provider.adoc | 4 ++++ modules/terms/partials/resource.adoc | 4 ++++ modules/terms/partials/spending-event.adoc | 4 ++++ modules/terms/partials/token-vault.adoc | 4 ++++ modules/terms/partials/tool.adoc | 4 ++++ 10 files changed, 40 insertions(+) create mode 100644 modules/terms/partials/byoa.adoc create mode 100644 modules/terms/partials/declarative-agent.adoc create mode 100644 modules/terms/partials/governance-dashboard.adoc create mode 100644 modules/terms/partials/oauth-client.adoc create mode 100644 modules/terms/partials/oauth-connection.adoc create mode 100644 modules/terms/partials/oauth-provider.adoc create mode 100644 modules/terms/partials/resource.adoc create mode 100644 modules/terms/partials/spending-event.adoc create mode 100644 modules/terms/partials/token-vault.adoc create mode 100644 modules/terms/partials/tool.adoc diff --git a/modules/terms/partials/byoa.adoc b/modules/terms/partials/byoa.adoc new file mode 100644 index 0000000000..217178d238 --- /dev/null +++ b/modules/terms/partials/byoa.adoc @@ -0,0 +1,4 @@ +=== BYOA (bring your own agent) +:term-name: BYOA (bring your own agent) +:hover-text: An agent built and run by you (in your own runtime, in any language) that registers with Redpanda for governance, observability, and gateway access. The runtime is yours; the policy and audit trail are Redpanda's. +:category: Agentic Data Plane diff --git a/modules/terms/partials/declarative-agent.adoc b/modules/terms/partials/declarative-agent.adoc new file mode 100644 index 0000000000..ba76925851 --- /dev/null +++ b/modules/terms/partials/declarative-agent.adoc @@ -0,0 +1,4 @@ +=== declarative agent +:term-name: declarative agent +:hover-text: An AI agent declared in YAML and run by Redpanda's managed runtime. The platform handles execution, model routing, and tool invocation; you describe the behavior, system prompt, and tool attachments. +:category: Agentic Data Plane diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc new file mode 100644 index 0000000000..98dcdf43b8 --- /dev/null +++ b/modules/terms/partials/governance-dashboard.adoc @@ -0,0 +1,4 @@ +=== Governance Dashboard +:term-name: Governance Dashboard +:hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. V0 (GA) composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-client.adoc b/modules/terms/partials/oauth-client.adoc new file mode 100644 index 0000000000..d4b964280a --- /dev/null +++ b/modules/terms/partials/oauth-client.adoc @@ -0,0 +1,4 @@ +=== OAuth Client +:term-name: OAuth Client +:hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth Authorization Server. Distinct from an OAuth Provider. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-connection.adoc b/modules/terms/partials/oauth-connection.adoc new file mode 100644 index 0000000000..15e8d63414 --- /dev/null +++ b/modules/terms/partials/oauth-connection.adoc @@ -0,0 +1,4 @@ +=== OAuth Connection +:term-name: OAuth Connection +:hover-text: A per-user OAuth connection to a third-party provider, created by completing the consent flow. Connections store the user's access and refresh tokens in the Token Vault and are used by agents on behalf of that user. +:category: Agentic Data Plane diff --git a/modules/terms/partials/oauth-provider.adoc b/modules/terms/partials/oauth-provider.adoc new file mode 100644 index 0000000000..9152585aea --- /dev/null +++ b/modules/terms/partials/oauth-provider.adoc @@ -0,0 +1,4 @@ +=== OAuth Provider +:term-name: OAuth Provider +:hover-text: An admin-registered upstream OAuth identity (such as Slack, Workday, or a custom IdP) that ADP users can connect to by completing the consent flow. Distinct from an OAuth Client. +:category: Agentic Data Plane diff --git a/modules/terms/partials/resource.adoc b/modules/terms/partials/resource.adoc new file mode 100644 index 0000000000..4ffa0ed6e3 --- /dev/null +++ b/modules/terms/partials/resource.adoc @@ -0,0 +1,4 @@ +=== resource +:term-name: resource +:hover-text: Read-only data exposed by an MCP server that an agent can fetch by URI. Resources surface things like file contents, database rows, or API responses without performing side effects. +:category: Agentic Data Plane diff --git a/modules/terms/partials/spending-event.adoc b/modules/terms/partials/spending-event.adoc new file mode 100644 index 0000000000..99f3513fe3 --- /dev/null +++ b/modules/terms/partials/spending-event.adoc @@ -0,0 +1,4 @@ +=== spending event +:term-name: spending event +:hover-text: A per-LLM-request cost record produced by the AI Gateway, carrying input, output, cached, and cache-write token counts plus tenant, provider, model, organization, and user identifiers. Cost is calculated downstream; the event itself carries raw token counts. +:category: Agentic Data Plane diff --git a/modules/terms/partials/token-vault.adoc b/modules/terms/partials/token-vault.adoc new file mode 100644 index 0000000000..2dae7fa822 --- /dev/null +++ b/modules/terms/partials/token-vault.adoc @@ -0,0 +1,4 @@ +=== Token Vault +:term-name: Token Vault +:hover-text: Encrypted store for per-user OAuth tokens used to access third-party providers. Supports admin-level connection revocation and data-encryption-key rotation. +:category: Agentic Data Plane diff --git a/modules/terms/partials/tool.adoc b/modules/terms/partials/tool.adoc new file mode 100644 index 0000000000..539efd330e --- /dev/null +++ b/modules/terms/partials/tool.adoc @@ -0,0 +1,4 @@ +=== tool +:term-name: tool +:hover-text: A capability exposed by an MCP server that an AI agent can discover at runtime and invoke through structured JSON-RPC calls. Tools encapsulate operations such as querying a database, calling an API, or sending a message. +:category: Agentic Data Plane From 3fc33c80ff5bf2a6751a46db08eea15a2f6d88b3 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:19:05 -0600 Subject: [PATCH 02/14] Apply suggestion from @micheleRP --- modules/terms/partials/declarative-agent.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/declarative-agent.adoc b/modules/terms/partials/declarative-agent.adoc index ba76925851..6352a8b68d 100644 --- a/modules/terms/partials/declarative-agent.adoc +++ b/modules/terms/partials/declarative-agent.adoc @@ -1,4 +1,4 @@ === declarative agent :term-name: declarative agent -:hover-text: An AI agent declared in YAML and run by Redpanda's managed runtime. The platform handles execution, model routing, and tool invocation; you describe the behavior, system prompt, and tool attachments. +:hover-text: An AI agent declared in YAML and run by Redpanda's managed runtime. The platform handles execution, model routing, and tool invocation. You describe the behavior, system prompt, and tool attachments. :category: Agentic Data Plane From 308934fa624efab95c32b73b44347003e08286b8 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:22:50 -0600 Subject: [PATCH 03/14] Apply suggestion from @micheleRP --- modules/terms/partials/governance-dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc index 98dcdf43b8..5b998e72c5 100644 --- a/modules/terms/partials/governance-dashboard.adoc +++ b/modules/terms/partials/governance-dashboard.adoc @@ -1,4 +1,4 @@ === Governance Dashboard :term-name: Governance Dashboard -:hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. V0 (GA) composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. +:hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. The dashboard composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. :category: Agentic Data Plane From 3649514e45e52e1929db68440098e07fa6b7c9b1 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:23:38 -0600 Subject: [PATCH 04/14] Apply suggestion from @micheleRP --- modules/terms/partials/oauth-client.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/oauth-client.adoc b/modules/terms/partials/oauth-client.adoc index d4b964280a..f1e9cd1ee4 100644 --- a/modules/terms/partials/oauth-client.adoc +++ b/modules/terms/partials/oauth-client.adoc @@ -1,4 +1,4 @@ === OAuth Client :term-name: OAuth Client -:hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth Authorization Server. Distinct from an OAuth Provider. +:hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth Authorization Server. Distinct from an OAuth provider. :category: Agentic Data Plane From 8fa7ebc940318656ff173be477ee577cd8c93709 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:24:12 -0600 Subject: [PATCH 05/14] Apply suggestion from @micheleRP --- modules/terms/partials/oauth-client.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/oauth-client.adoc b/modules/terms/partials/oauth-client.adoc index f1e9cd1ee4..1190e4c82b 100644 --- a/modules/terms/partials/oauth-client.adoc +++ b/modules/terms/partials/oauth-client.adoc @@ -1,4 +1,4 @@ === OAuth Client :term-name: OAuth Client -:hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth Authorization Server. Distinct from an OAuth provider. +:hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth authorization server. Distinct from an OAuth provider. :category: Agentic Data Plane From 689c709528a742b3f3aad50a5175a4c7ec86b1be Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:25:24 -0600 Subject: [PATCH 06/14] Apply suggestion from @micheleRP --- modules/terms/partials/spending-event.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/spending-event.adoc b/modules/terms/partials/spending-event.adoc index 99f3513fe3..e4c6194b2f 100644 --- a/modules/terms/partials/spending-event.adoc +++ b/modules/terms/partials/spending-event.adoc @@ -1,4 +1,4 @@ === spending event :term-name: spending event -:hover-text: A per-LLM-request cost record produced by the AI Gateway, carrying input, output, cached, and cache-write token counts plus tenant, provider, model, organization, and user identifiers. Cost is calculated downstream; the event itself carries raw token counts. +:hover-text: A per-LLM-request cost record produced by the AI Gateway, carrying input, output, cached, and cache-write token counts plus tenant, provider, model, organization, and user identifiers. Cost is calculated downstream. The event itself carries raw token counts. :category: Agentic Data Plane From e592a0a8a7fa9d72b536ed7a76347b743e3188dc Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:26:17 -0600 Subject: [PATCH 07/14] Apply suggestion from @micheleRP --- modules/terms/partials/governance-dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc index 5b998e72c5..5a82d30ed5 100644 --- a/modules/terms/partials/governance-dashboard.adoc +++ b/modules/terms/partials/governance-dashboard.adoc @@ -1,4 +1,4 @@ -=== Governance Dashboard +=== Governance dashboard :term-name: Governance Dashboard :hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. The dashboard composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. :category: Agentic Data Plane From 4a92e726602f01f7ef3dd387231c503d75fd9bfd Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:26:40 -0600 Subject: [PATCH 08/14] Apply suggestion from @micheleRP --- modules/terms/partials/governance-dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc index 5a82d30ed5..398f8d2b46 100644 --- a/modules/terms/partials/governance-dashboard.adoc +++ b/modules/terms/partials/governance-dashboard.adoc @@ -1,4 +1,4 @@ === Governance dashboard -:term-name: Governance Dashboard +:term-name: Governance dashboard :hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. The dashboard composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. :category: Agentic Data Plane From 59f5ab72916bd429188c1ad24518e70ee2d459db Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:27:17 -0600 Subject: [PATCH 09/14] Apply suggestion from @micheleRP --- modules/terms/partials/governance-dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc index 398f8d2b46..b573992c87 100644 --- a/modules/terms/partials/governance-dashboard.adoc +++ b/modules/terms/partials/governance-dashboard.adoc @@ -1,4 +1,4 @@ -=== Governance dashboard +=== governance dashboard :term-name: Governance dashboard :hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. The dashboard composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. :category: Agentic Data Plane From 1d328763c37a7da59c603c5af73a1314a912bfc0 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:27:41 -0600 Subject: [PATCH 10/14] Apply suggestion from @micheleRP --- modules/terms/partials/governance-dashboard.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/terms/partials/governance-dashboard.adoc b/modules/terms/partials/governance-dashboard.adoc index b573992c87..54d909e10b 100644 --- a/modules/terms/partials/governance-dashboard.adoc +++ b/modules/terms/partials/governance-dashboard.adoc @@ -1,4 +1,4 @@ === governance dashboard -:term-name: Governance dashboard +:term-name: governance dashboard :hover-text: Cross-tenant overview UI showing spending, agent activity, MCP server inventory, and authorization events. The dashboard composes data from `SpendingService`, `AgentRegistryService`, and `MCPServerService`. :category: Agentic Data Plane From 72cd84cb5efe5e385adcc19add5c7a263582ef8b Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:28:08 -0600 Subject: [PATCH 11/14] Apply suggestion from @micheleRP --- modules/terms/partials/oauth-client.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/terms/partials/oauth-client.adoc b/modules/terms/partials/oauth-client.adoc index 1190e4c82b..442e633d4d 100644 --- a/modules/terms/partials/oauth-client.adoc +++ b/modules/terms/partials/oauth-client.adoc @@ -1,4 +1,4 @@ -=== OAuth Client -:term-name: OAuth Client +=== OAuth client +:term-name: OAuth client :hover-text: An admin-registered external tool (such as Claude.ai, ChatGPT, or Cursor) authorized to request tokens from the in-dataplane OAuth authorization server. Distinct from an OAuth provider. :category: Agentic Data Plane From fd3732cf300443c6a2b2bb6bf68fcbac23f9a4b1 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:28:40 -0600 Subject: [PATCH 12/14] Apply suggestion from @micheleRP --- modules/terms/partials/oauth-connection.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/terms/partials/oauth-connection.adoc b/modules/terms/partials/oauth-connection.adoc index 15e8d63414..f427cf1292 100644 --- a/modules/terms/partials/oauth-connection.adoc +++ b/modules/terms/partials/oauth-connection.adoc @@ -1,4 +1,4 @@ -=== OAuth Connection -:term-name: OAuth Connection -:hover-text: A per-user OAuth connection to a third-party provider, created by completing the consent flow. Connections store the user's access and refresh tokens in the Token Vault and are used by agents on behalf of that user. +=== OAuth connection +:term-name: OAuth connection +:hover-text: A per-user OAuth connection to a third-party provider, created by completing the consent flow. Connections store the user's access and refresh tokens in the token vault and are used by agents on behalf of that user. :category: Agentic Data Plane From 86c1b7d939a24319d2bbf0054b75b7ce9f22bc7e Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:29:15 -0600 Subject: [PATCH 13/14] Apply suggestion from @micheleRP --- modules/terms/partials/oauth-provider.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/terms/partials/oauth-provider.adoc b/modules/terms/partials/oauth-provider.adoc index 9152585aea..5e451154ce 100644 --- a/modules/terms/partials/oauth-provider.adoc +++ b/modules/terms/partials/oauth-provider.adoc @@ -1,4 +1,4 @@ -=== OAuth Provider -:term-name: OAuth Provider -:hover-text: An admin-registered upstream OAuth identity (such as Slack, Workday, or a custom IdP) that ADP users can connect to by completing the consent flow. Distinct from an OAuth Client. +=== OAuth provider +:term-name: OAuth provider +:hover-text: An admin-registered upstream OAuth identity (such as Slack, Workday, or a custom IdP) that ADP users can connect to by completing the consent flow. Distinct from an OAuth client. :category: Agentic Data Plane From 403f94afd76cb476a7bb10cccd282fc3e2775f17 Mon Sep 17 00:00:00 2001 From: Michele Cyran Date: Wed, 6 May 2026 16:30:10 -0600 Subject: [PATCH 14/14] Apply suggestion from @micheleRP --- modules/terms/partials/token-vault.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/terms/partials/token-vault.adoc b/modules/terms/partials/token-vault.adoc index 2dae7fa822..ee936bb0d3 100644 --- a/modules/terms/partials/token-vault.adoc +++ b/modules/terms/partials/token-vault.adoc @@ -1,4 +1,4 @@ -=== Token Vault -:term-name: Token Vault +=== token vault +:term-name: token vault :hover-text: Encrypted store for per-user OAuth tokens used to access third-party providers. Supports admin-level connection revocation and data-encryption-key rotation. :category: Agentic Data Plane