Feature/api turntaking

[sani903]

📑 Description

This PR adds WebSocket support for turnwise interaction in Sotopia. The implementation enables real-time interaction between:

• Non-NPC and NPC
• Two NPCs

Unit tests have been added to ensure correctness, and the WebSocket implementation supports smooth turnwise communication.

• WebSocket implementation for turnwise interaction
• Support for Non-NPC to NPC interaction
• Support for NPC to NPC interaction
• Unit tests for WebSocket functionality

✅ Checks

• My pull request adheres to the code style of this project
• My code requires changes to the documentation
• I have updated the documentation as required
• All the tests have passed
• Branch name follows type/descript (e.g. feature/add-llm-agents)
• Ready for code review

ℹ Additional Information

No breaking changes. The WebSocket implementation integrates seamlessly with existing logic. Let me know if any modifications or additional tests are needed.

[codecov]

Codecov Report

Attention: Patch coverage is 92.02658% with 24 lines in your changes missing coverage. Please review.

Project coverage is 77.37%. Comparing base (47aab1a) to head (8fd869a).
Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
tests/api/test_turntaking.py	85.24%	18 Missing ⚠️
tests/api/test_turntaking_atomic.py	97.77%	3 Missing ⚠️
sotopia/api/fastapi_server.py	90.47%	2 Missing ⚠️
sotopia/api/websocket_utils.py	95.65%	1 Missing ⚠️

@@             Coverage Diff             @@
##             main     #290       +/-   ##
===========================================
+ Coverage   32.29%   77.37%   +45.08%     
===========================================
  Files          50       65       +15     
  Lines        2793     3912     +1119     
===========================================
+ Hits          902     3027     +2125     
+ Misses       1891      885     -1006     

Files with missing lines	Coverage Δ
tests/api/test_fastapi.py	89.44% <ø> (ø)
sotopia/api/websocket_utils.py	87.91% <95.65%> (+87.91%)	⬆️
sotopia/api/fastapi_server.py	73.16% <90.47%> (+73.16%)	⬆️
tests/api/test_turntaking_atomic.py	97.77% <97.77%> (ø)
tests/api/test_turntaking.py	85.24% <85.24%> (ø)

... and 34 files with indirect coverage changes

[XuhuiZhou]

okay so the websocket enables turn-taking. qq, how does the connection with redis agent work here?

is the redisagent still on the tac side? (maybe share the tac repo with me as well?)

[sani903]

okay so the websocket enables turn-taking. qq, how does the connection with redis agent work here?

is the redisagent still on the tac side? (maybe share the tac repo with me as well?)

We have the NPCs stored on Sotopia side (created/deleted using FastAPI calls from TAC). The main agent interacts with these NPCs, with the message broker still on TAC side.
I will share the TAC fork with you.