fix(webapp): prefer RUNTIME_API_ORIGIN over STREAM_ORIGIN for TRIGGER_STREAM_URL

Aligns precedence with the decoupling goal: when RUNTIME_API_ORIGIN is
set (e.g. for cluster-internal runner traffic), it should override the
external STREAM_ORIGIN too. Adds JSDoc on the two builtin resolvers
explaining the precedence chain.

Author: ThullyoCunha

apps/webapp/app/v3/environmentVariables/environmentVariablesRepository.server.ts

@@ -954,6 +954,14 @@ async function resolveOverridableTriggerVariables(
   return result;
 }
 
+/**
+ * Resolves built-in environment variables that are injected into dev (CLI) task
+ * runs. `TRIGGER_API_URL` and `TRIGGER_STREAM_URL` prefer `RUNTIME_API_ORIGIN`
+ * over `API_ORIGIN`/`STREAM_ORIGIN` so self-hosted deployments can keep
+ * runner-to-webapp traffic on a cluster-internal hop (bypassing tracing-enabled
+ * gateways that rewrite the W3C `traceparent` header on egress) without
+ * affecting the public origins exposed to external clients.
+ */
 async function resolveBuiltInDevVariables(runtimeEnvironment: RuntimeEnvironmentForEnvRepo) {
   let result: Array<EnvironmentVariable> = [
     {
@@ -966,7 +974,7 @@ async function resolveBuiltInDevVariables(runtimeEnvironment: RuntimeEnvironment
     },
     {
       key: "TRIGGER_STREAM_URL",
-      value: env.STREAM_ORIGIN ?? env.RUNTIME_API_ORIGIN ?? env.API_ORIGIN ?? env.APP_ORIGIN,
+      value: env.RUNTIME_API_ORIGIN ?? env.STREAM_ORIGIN ?? env.API_ORIGIN ?? env.APP_ORIGIN,
     },
   ];
 
@@ -1093,6 +1101,15 @@ async function resolveOverridableOtelDevVariables(
   return result;
 }
 
+/**
+ * Resolves built-in environment variables that are injected into managed
+ * (deployed) task runs. `TRIGGER_API_URL` and `TRIGGER_STREAM_URL` prefer
+ * `RUNTIME_API_ORIGIN` over `API_ORIGIN`/`STREAM_ORIGIN` so self-hosted
+ * deployments can keep runner-to-webapp traffic on a cluster-internal hop
+ * (bypassing tracing-enabled gateways that rewrite the W3C `traceparent`
+ * header on egress) without affecting the public origins exposed to external
+ * clients.
+ */
 async function resolveBuiltInProdVariables(
   runtimeEnvironment: RuntimeEnvironmentForEnvRepo,
   parentEnvironment?: RuntimeEnvironmentForEnvRepo
@@ -1108,7 +1125,7 @@ async function resolveBuiltInProdVariables(
     },
     {
       key: "TRIGGER_STREAM_URL",
-      value: env.STREAM_ORIGIN ?? env.RUNTIME_API_ORIGIN ?? env.API_ORIGIN ?? env.APP_ORIGIN,
+      value: env.RUNTIME_API_ORIGIN ?? env.STREAM_ORIGIN ?? env.API_ORIGIN ?? env.APP_ORIGIN,
     },
     {
       key: "TRIGGER_RUNTIME_WAIT_THRESHOLD_IN_MS",