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

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-js: Add deployment to TokenSourceFetch options client-sdk-js#1971

Usage

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

Or directly via RoomAgentDispatch:

let dispatch = RoomAgentDispatch(
    agentName: "my-agent",
    metadata: "my-metadata",
    deployment: "staging"
)

Test plan

Unit Tests

swift test
# Or via Xcode
xcodebuild test -scheme LiveKit -destination "platform=iOS Simulator,name=iPhone 15"

Manual Verification

1. Verify JSON serialization includes deployment:

let dispatch = RoomAgentDispatch(
    agentName: "my-agent",
    deployment: "staging"
)
let encoder = JSONEncoder()
let data = try encoder.encode(dispatch)
let json = String(data: data, encoding: .utf8)!
print(json)  // Should include "deployment": "staging"

2. Verify TokenRequestOptions converts to request correctly:

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

3. Verify token contains deployment (with TokenSource):

let response = try await tokenSource.fetch(TokenRequestOptions(
    roomName: "test-room",
    agentName: "my-agent",
    agentDeployment: "staging"
))
if let jwt = response.jwt(),
   let agents = jwt.roomConfiguration?.agents {
    print("Deployment: \(agents.first?.deployment ?? "nil")")
}

End-to-End Verification

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

🤖 Generated with Claude Code

[github-actions]

⚠️ This PR does not contain any files in the .changes directory.