feat: add deployment field to agent dispatch

[xianshijing-lk]

Summary

• Add deployment field to RoomAgentDispatch for targeting specific agent deployments
• Add agentDeployment to TokenRequestOptions to pass deployment through token requests
• Update generated JSON serialization code

The deployment field allows targeting a specific agent deployment (e.g., "staging"). Leave empty to target the production deployment.

Related PRs:

• node-sdks: Add deployment to CreateDispatchOptions node-sdks#675
• python-sdks: docs: add deployment field documentation for agent dispatch python-sdks#722
• rust-sdks: docs: add deployment field documentation for agent dispatch rust-sdks#1176
• client-sdk-swift: feat: add deployment field to agent dispatch client-sdk-swift#1043
• client-sdk-js: Add deployment to TokenSourceFetch options client-sdk-js#1971

Usage

final options = TokenRequestOptions(
  roomName: 'my-room',
  agentName: 'my-agent',
  agentDeployment: 'staging',  // Optional: target specific deployment
);

Or directly via RoomAgentDispatch:

final dispatch = RoomAgentDispatch(
  agentName: 'my-agent',
  metadata: 'my-metadata',
  deployment: 'staging',
);

Test plan

Unit Tests

flutter test
flutter test test/token/token_source_test.dart -v

Manual Verification

1. Verify JSON serialization includes deployment:

final dispatch = RoomAgentDispatch(
  agentName: 'my-agent',
  deployment: 'staging',
);
final json = dispatch.toJson();
print(json);  // Should include 'deployment': 'staging'

2. Verify TokenRequestOptions converts to request correctly:

final options = TokenRequestOptions(
  roomName: 'test-room',
  agentName: 'my-agent',
  agentDeployment: 'staging',
);
final request = options.toRequest();
print(request.roomConfiguration?.agents?.first?.deployment);  // Should print 'staging'

3. Verify JSON round-trip:

final original = RoomAgentDispatch(
  agentName: 'my-agent',
  deployment: 'staging',
);
final json = original.toJson();
final restored = RoomAgentDispatch.fromJson(json);
assert(restored.deployment == 'staging');

End-to-End Verification

1. Use TokenSource to get credentials with agentDeployment set
2. Connect to room - agent with matching deployment should join
3. Verify only staging agent receives the dispatch

🤖 Generated with Claude Code