fix(core,webapp): plumb maxDuration / lockToVersion / region through SessionTriggerConfig + sync playground transport clientData

Two fixes from Devin's review on PR #3173.

## SessionTriggerConfig is missing 3 fields the playground UI shows

The playground sidebar (`PlaygroundSidebar`) renders working controls for
`maxDuration`, `version`, and `region`. The action received the form fields,
but `SessionTriggerConfig` didn't accept them so they were `void`-suppressed
and silently dropped. Runs ignored the user's max-duration cap, the version
pin didn't apply, and region selection had no effect.

- `packages/core/src/v3/schemas/api.ts` — add three optional fields to
  `SessionTriggerConfig`: `maxDuration` (positive int, seconds),
  `lockToVersion` (string), `region` (string). All three forward to the
  matching field on `TaskRunOptions`.
- `apps/webapp/app/services/realtime/sessionRunManager.server.ts` — extend
  `triggerSessionRun`'s `body.options` to thread the three fields through
  to `TriggerTaskService` when present.
- `apps/webapp/app/routes/resources.orgs.$organizationSlug.projects.$projectParam.env.$envParam.playground.action.tsx`
  — fold the three form fields into `triggerConfig`; remove the `void`
  suppressions.

## Playground transport's clientData becomes stale after edits

The route constructs `TriggerChatTransport` directly via `useRef` (to avoid
the React-version mismatch the hook had). The hook normally calls
`setClientData` whenever `clientData` changes, but this manual construction
bypassed that — so `clientData` was captured at construction and never
updated. Per-turn `metadata` merges (`this.defaultMetadata` in
`packages/trigger-sdk/src/v3/chat.ts`) used the stale initial value for
the whole conversation. `startSession` was already reading from the live
ref so session creation was unaffected; this only fixed the per-turn path.

- `apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.playground.$agentParam/route.tsx`
  — add a `useEffect` that calls `transport.setClientData(...)` whenever
  `clientDataJson` changes.

Changeset (patch, @trigger.dev/core) for the schema additions; server-
changes file for the webapp-only behaviour fix.

Author: ericallam

.changeset/session-trigger-config-extra-fields.md

@@ -0,0 +1,5 @@
+---
+"@trigger.dev/core": patch
+---
+
+Extend `SessionTriggerConfig` with three optional fields previously missing from the schema: `maxDuration` (per-run wall-clock cap, seconds), `lockToVersion` (pin every run to a specific worker version), and `region` (geographic scheduling). Each forwards to the matching field on `TaskRunOptions` when the run is triggered. Existing sessions without these fields are unaffected.

.server-changes/playground-trigger-config-fields.md

@@ -0,0 +1,8 @@
+---
+area: webapp
+type: fix
+---
+
+Playground action now forwards `maxDuration`, `version` (as `lockToVersion`), and `region` from the sidebar form into the Session's `triggerConfig`. Previously the form fields rendered as working controls but were silently dropped (`void`-suppressed) because `SessionTriggerConfig` didn't accept them — runs ignored the user's max duration, version pin, and region selection. With the schema extended in core, the playground now plumbs them through to `ensureRunForSession`.
+
+Also fixes stale `clientData` in the playground transport: the JSON editor's value was captured at construction and never updated, so per-turn `metadata` merges used the original value across the whole conversation. Added a `useEffect` that calls `transport.setClientData(...)` whenever `clientDataJson` changes.

apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.playground.$agentParam/route.tsx

@@ -292,6 +292,15 @@ function PlaygroundChat() {
   }
   const transport = transportRef.current;
 
+  // Keep the transport's `defaultMetadata` in sync with the JSON editor.
+  // Without this the transport uses the value captured at construction for
+  // every per-turn metadata merge, even after the user edits the JSON.
+  // `startSession` reads from `clientDataJsonRef.current` directly so session
+  // creation is unaffected — this only fixes the per-turn metadata path.
+  useEffect(() => {
+    transport.setClientData(JSON.parse(clientDataJson || "{}") as Record<string, unknown>);
+  }, [clientDataJson, transport]);
+
   // Initial messages from persisted conversation (for resume)
   const initialMessages = activeConversation?.messages
     ? (activeConversation.messages as UIMessage[])

apps/webapp/app/routes/resources.orgs.$organizationSlug.projects.$projectParam.env.$envParam.playground.action.tsx

@@ -131,6 +131,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
         ...(machine ? { machine } : {}),
         tags,
         ...(maxAttempts ? { maxAttempts: parseInt(maxAttempts, 10) } : {}),
+        ...(maxDuration ? { maxDuration: parseInt(maxDuration, 10) } : {}),
+        ...(version ? { lockToVersion: version } : {}),
+        ...(region ? { region } : {}),
       };
 
       // Atomic: upsert the Session, then trigger the first run via
@@ -213,13 +216,6 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
         },
       });
 
-      // Avoid unused-var lint while preserving the request shape
-      // — these knobs are now folded into triggerConfig at the
-      // session create above.
-      void maxDuration;
-      void version;
-      void region;
-
       const publicAccessToken = await mintSessionToken(
         environment as unknown as AuthenticatedEnvironment,
         chatId

apps/webapp/app/services/realtime/sessionRunManager.server.ts

@@ -223,6 +223,9 @@ async function triggerSessionRun(params: {
       ...(config.queue ? { queue: { name: config.queue } } : {}),
       ...(config.tags ? { tags: config.tags } : {}),
       ...(config.maxAttempts !== undefined ? { maxAttempts: config.maxAttempts } : {}),
+      ...(config.maxDuration !== undefined ? { maxDuration: config.maxDuration } : {}),
+      ...(config.lockToVersion ? { lockToVersion: config.lockToVersion } : {}),
+      ...(config.region ? { region: config.region } : {}),
     },
   };
 

packages/core/src/v3/schemas/api.ts

@@ -1495,6 +1495,12 @@ export const SessionTriggerConfig = z.object({
   queue: z.string().max(128).optional(),
   tags: z.array(z.string().max(128)).max(5).optional(),
   maxAttempts: z.number().int().positive().max(10).optional(),
+  /** Per-run wall-clock cap (seconds). Forwarded to `TaskRunOptions.maxDuration`. */
+  maxDuration: z.number().int().positive().optional(),
+  /** Pin every run to a specific worker version. Forwarded to `TaskRunOptions.lockToVersion`. */
+  lockToVersion: z.string().optional(),
+  /** Region to schedule runs in. Forwarded to `TaskRunOptions.region`. */
+  region: z.string().optional(),
   /** Convenience field surfaced to chat.agent via the wire payload. */
   idleTimeoutInSeconds: z.number().int().positive().max(3600).optional(),
 });