Add deployment field to agent dispatch in TokenSource (#318)

* Add deployment field to agent dispatch in TokenSource

Add support for targeting specific agent deployments when using TokenSource:
- Add AgentDeployment property to TokenSourceFetchOptions
- Add Deployment field to AgentDispatch class
- Include deployment in BuildRequest when any agent field is set

Leave deployment empty to target the production deployment.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add AgentDeployment also to the token config GUI

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: Max Heimbrock <43608204+MaxHeimbrock@users.noreply.github.com>

Author: 3 people

Editor/TokenSourceComponentConfigEditor.cs

@@ -59,5 +59,6 @@ private void DrawConnectionOptions()
         EditorGUILayout.PropertyField(serializedObject.FindProperty("_participantAttributes"), true);
         EditorGUILayout.PropertyField(serializedObject.FindProperty("_agentName"));
         EditorGUILayout.PropertyField(serializedObject.FindProperty("_agentMetadata"));
+        EditorGUILayout.PropertyField(serializedObject.FindProperty("_agentDeployment"));
     }
 }

Runtime/Scripts/TokenSource/TokenSource.cs

@@ -140,7 +140,7 @@ private static TokenSourceRequest BuildRequest(TokenSourceFetchOptions options)
                     request.ParticipantAttributes = null;
             }
 
-            if (!string.IsNullOrEmpty(options.AgentName) || !string.IsNullOrEmpty(options.AgentMetadata))
+            if (!string.IsNullOrEmpty(options.AgentName) || !string.IsNullOrEmpty(options.AgentMetadata) || !string.IsNullOrEmpty(options.AgentDeployment))
             {
                 request.RoomConfig = new RoomConfig
                 {
@@ -149,7 +149,8 @@ private static TokenSourceRequest BuildRequest(TokenSourceFetchOptions options)
                         new AgentDispatch
                         {
                             AgentName = NullIfEmpty(options.AgentName),
-                            Metadata = NullIfEmpty(options.AgentMetadata)
+                            Metadata = NullIfEmpty(options.AgentMetadata),
+                            Deployment = NullIfEmpty(options.AgentDeployment)
                         }
                     }
                 };

Runtime/Scripts/TokenSource/TokenSourceComponent.cs

@@ -107,6 +107,7 @@ private static TokenSourceFetchOptions Coalesce(TokenSourceComponentConfig confi
                 ParticipantAttributes = participantAttributes,
                 AgentName = Coalesce(options?.AgentName, config.AgentName),
                 AgentMetadata = Coalesce(options?.AgentMetadata, config.AgentMetadata),
+                AgentDeployment = Coalesce(options?.AgentDeployment, config.AgentDeployment),
             };
         }
 

Runtime/Scripts/TokenSource/TokenSourceComponentConfig.cs

@@ -42,6 +42,7 @@ public class TokenSourceComponentConfig : ScriptableObject
         [SerializeField] private List<StringPair> _participantAttributes;
         [SerializeField] private string _agentName;
         [SerializeField] private string _agentMetadata;
+        [SerializeField] private string _agentDeployment;
 
         public TokenSourceType TokenSourceType => _tokenSourceType;
 
@@ -64,6 +65,7 @@ public class TokenSourceComponentConfig : ScriptableObject
         public List<StringPair> ParticipantAttributes => _participantAttributes;
         public string AgentName => _agentName;
         public string AgentMetadata => _agentMetadata;
+        public string AgentDeployment => _agentDeployment;
 
         public bool IsValid => _tokenSourceType switch
         {

Runtime/Scripts/TokenSource/TokenSourceData.cs

@@ -15,6 +15,10 @@ public class TokenSourceFetchOptions
         public Dictionary<string, string> ParticipantAttributes { get; init; }
         public string AgentName { get; init; }
         public string AgentMetadata { get; init; }
+        /// <summary>
+        /// Optional deployment to target. Leave empty to target the production deployment.
+        /// </summary>
+        public string AgentDeployment { get; init; }
     }
 
     class TokenSourceRequest
@@ -51,6 +55,12 @@ class AgentDispatch
 
         [JsonProperty("metadata", NullValueHandling = NullValueHandling.Ignore)]
         public string Metadata;
+
+        /// <summary>
+        /// Optional deployment to target. Leave empty to target the production deployment.
+        /// </summary>
+        [JsonProperty("deployment", NullValueHandling = NullValueHandling.Ignore)]
+        public string Deployment;
     }
 
     /// <summary>