router: add enable_art toggle for ART

router/core/graph_server.go

@@ -1510,6 +1510,7 @@ func (s *graphServer) buildGraphMux(
 		RouterPublicKey:                        s.publicKey,
 		EnableRequestTracing:                   s.engineExecutionConfiguration.EnableRequestTracing,
 		DevelopmentMode:                        s.developmentMode,
+		EnableArt:                              s.enableArt,
 		TracerProvider:                         s.tracerProvider,
 		FlushTelemetryAfterResponse:            s.awsLambda,
 		TraceExportVariables:                   s.traceConfig.ExportGraphQLVariables.Enabled,

router/core/graphql_prehandler.go

@@ -57,6 +57,7 @@ type PreHandlerOptions struct {
 	FileUploadEnabled                      bool
 	TraceExportVariables                   bool
 	DevelopmentMode                        bool
+	EnableArt                              bool
 	EnableRequestTracing                   bool
 	AlwaysIncludeQueryPlan                 bool
 	AlwaysSkipLoader                       bool
@@ -88,6 +89,7 @@ type PreHandler struct {
 	operationBlocker                       *OperationBlocker
 	headerPropagation                      *HeaderPropagation
 	developmentMode                        bool
+	enableArt                              bool
 	alwaysIncludeQueryPlan                 bool
 	alwaysSkipLoader                       bool
 	queryPlansEnabled                      bool // queryPlansEnabled is a flag to enable query plans output in the extensions
@@ -148,6 +150,7 @@ func NewPreHandler(opts *PreHandlerOptions) *PreHandler {
 		operationBlocker:            opts.OperationBlocker,
 		routerPublicKey:             opts.RouterPublicKey,
 		developmentMode:             opts.DevelopmentMode,
+		enableArt:                   opts.EnableArt,
 		enableRequestTracing:        opts.EnableRequestTracing,
 		flushTelemetryAfterResponse: opts.FlushTelemetryAfterResponse,
 		tracerProvider:              opts.TracerProvider,
@@ -1258,6 +1261,10 @@ func (h *PreHandler) internalParseRequestOptions(r *http.Request, clientInfo *Cl
 		if h.developmentMode {
 			return h.parseRequestExecutionOptions(r), h.parseRequestTraceOptions(r), nil
 		}
+		// enable_art allows ART without dev_mode or a controlplane token
+		if h.enableArt {
+			return h.parseRequestExecutionOptions(r), h.parseRequestTraceOptions(r), nil
+		}
 		// If the client has a valid request token, and we have a public key from the controlplane
 		if clientInfo.WGRequestToken != "" && h.routerPublicKey != nil {
 			_, err := jwt.Parse(clientInfo.WGRequestToken, func(token *jwt.Token) (interface{}, error) {

router/core/router.go

@@ -2092,6 +2092,14 @@ func WithDevelopmentMode(enabled bool) Option {
 	}
 }
 
+// WithEnableArt enables Advanced Request Tracing (ART) and query plan headers
+// without requiring dev_mode or a Cosmo Cloud JWT token.
+func WithEnableArt(enabled bool) Option {
+	return func(r *Router) {
+		r.enableArt = enabled
+	}
+}
+
 func WithClusterName(name string) Option {
 	return func(r *Router) {
 		r.clusterName = name

router/core/router_config.go

@@ -112,6 +112,7 @@ type Config struct {
 	connectRPCServer                *connectrpc.Server
 	processStartTime                time.Time
 	developmentMode                 bool
+	enableArt                       bool
 	healthcheck                     health.Checker
 	accessLogsConfig                *AccessLogsConfig
 	// If connecting to localhost inside Docker fails, fallback to the docker internal address for the host
@@ -251,6 +252,7 @@ func (c *Config) Usage() map[string]any {
 	usage["access_controller"] = c.accessController != nil
 	usage["retry_options"] = c.retryOptions.Enabled
 	usage["development_mode"] = c.developmentMode
+	usage["enable_art"] = c.enableArt
 	usage["access_logs"] = c.accessLogsConfig != nil
 	usage["localhost_fallback_inside_docker"] = c.localhostFallbackInsideDocker
 	usage["tls_server"] = c.tlsServerConfig != nil

router/core/supervisor_instance.go

@@ -252,6 +252,7 @@ func optionsFromResources(logger *zap.Logger, config *config.Config, reloadPersi
 			},
 		}),
 		WithDevelopmentMode(config.DevelopmentMode),
+		WithEnableArt(config.EnableArt),
 		WithTracing(TraceConfigFromTelemetry(&config.Telemetry)),
 		WithMetrics(MetricConfigFromTelemetry(&config.Telemetry)),
 		WithTelemetryAttributes(config.Telemetry.Attributes),

router/pkg/config/config.go

@@ -1143,6 +1143,7 @@ type Config struct {
 	LocalhostFallbackInsideDocker bool                        `yaml:"localhost_fallback_inside_docker" envDefault:"true" env:"LOCALHOST_FALLBACK_INSIDE_DOCKER"`
 	CDN                           CDNConfiguration            `yaml:"cdn,omitempty"`
 	DevelopmentMode               bool                        `yaml:"dev_mode" envDefault:"false" env:"DEV_MODE"`
+	EnableArt                     bool                        `yaml:"enable_art" envDefault:"false" env:"ENABLE_ART"`
 	Events                        EventsConfiguration         `yaml:"events,omitempty"`
 	CacheWarmup                   CacheWarmupConfiguration    `yaml:"cache_warmup,omitempty"`
 

router/pkg/config/config.schema.json

@@ -383,6 +383,11 @@
       "default": false,
       "description": "Enable the development mode. The development mode is used to enable the development features like ART (Advanced Request Tracing) and pretty logs."
     },
+    "enable_art": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable Advanced Request Tracing (ART) and query plan headers without requiring dev_mode or a Cosmo Cloud JWT token."
+    },
     "tls": {
       "type": "object",
       "additionalProperties": false,

router/pkg/config/testdata/config_defaults.json

@@ -323,6 +323,7 @@
     "CacheSize": 100000000
   },
   "DevelopmentMode": false,
+  "EnableArt": false,
   "Events": {
     "Providers": {
       "Nats": null,

router/pkg/config/testdata/config_full.json

@@ -641,6 +641,7 @@
     "CacheSize": 100000000
   },
   "DevelopmentMode": false,
+  "EnableArt": false,
   "Events": {
     "Providers": {
       "Nats": [