From 73daee4ac714b37b13656ae0c275e954fd54df1e Mon Sep 17 00:00:00 2001 From: Dmitry Anoshin Date: Wed, 3 Jun 2026 00:05:48 +0000 Subject: [PATCH] Add AgentConfigFile role --- proto/opamp/v1/opamp.proto | 9 +++++++-- specification.md | 6 ++++++ 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/proto/opamp/v1/opamp.proto b/proto/opamp/v1/opamp.proto index efc5e3a..ddd6223 100644 --- a/proto/opamp/v1/opamp.proto +++ b/proto/opamp/v1/opamp.proto @@ -1045,13 +1045,18 @@ message AgentConfigMap { } message AgentConfigFile { - // Config file or section body. The content, format and encoding depends on the Agent - // type. The content_type field may optionally describe the MIME type of the body. + // Config file, section, or supplementary content body. The content, format and + // encoding depends on the Agent type. The content_type field may optionally + // describe the MIME type of the body. bytes body = 1; // Optional MIME Content-Type that describes what's in the body field, for // example "text/yaml". string content_type = 2; + + // Optional role of the content in the body field. The values and their semantics + // are Agent type-specific. + string role = 3; } ///////////////////////////////////////////////////////////////////////////////////// diff --git a/specification.md b/specification.md index 889f8de..63e7a40 100644 --- a/specification.md +++ b/specification.md @@ -2626,6 +2626,7 @@ following structure: message AgentConfigFile { bytes body = 1; string content_type = 2; + string role = 3; } ``` @@ -2639,6 +2640,11 @@ reported in the Effective Configuration in the Agent's status report may be used for example by the Server to visualize the reported configuration nicely in a UI. +role is an optional field that describes the role of the content. The values and +their semantics are Agent type-specific. For example, an Agent type may use this +field to distinguish top-level configuration from supplementary content such as +certificates or other artifacts referenced by configuration. + #### Security Considerations Remote Configuration is a potentially dangerous functionality that may be