Add AI avatar disclosure session option

README.md

@@ -100,6 +100,24 @@ async with client.connect(session_options=session_options) as session:
 
 Currently, only `"high"` or `"auto"` are supported `video_quality` values.
 
+### AI avatar disclosure watermark
+
+Anam's default is not to render an AI avatar disclosure watermark. Set
+`show_ai_avatar_disclosure=True` when you want Anam to disclose that the video
+contains an AI avatar via a watermark:
+
+```python
+session_options = SessionOptions(show_ai_avatar_disclosure=True)
+```
+
+Leave it unset, or set `show_ai_avatar_disclosure=False`, when the application
+provides its own disclosure or no watermark is required.
+
+This may be useful for transparency workflows, including where the
+[EU AI Act Article 50](https://digital-strategy.ec.europa.eu/en/faqs/transparency-obligations-under-article-50-ai-act)
+is relevant to informing people that they are interacting with an AI system or
+viewing AI-generated or manipulated content.
+
 ## Direct Egress (Daily)
 
 > [!WARNING]

src/anam/types.py

@@ -208,13 +208,16 @@ class SessionOptions:
         video_width: Requested video output width. Must be provided with video_height.
         video_height: Requested video output height. Must be provided with video_width.
         egress: Optional direct egress to a third-party transport (e.g. Daily). See :class:`EgressOptions`.
+        show_ai_avatar_disclosure: Show Anam's AI avatar disclosure watermark throughout
+            the session. Defaults to Anam's default behavior, which is off.
     """
 
     enable_session_replay: bool = True
     video_quality: Literal["high", "auto"] = "high"
     video_width: int | None = None
     video_height: int | None = None
     egress: EgressOptions | None = None
+    show_ai_avatar_disclosure: bool | None = None
 
     def __post_init__(self) -> None:
         self._session_replay = SessionReplayOptions(
@@ -243,6 +246,8 @@ def to_dict(self) -> dict[str, Any]:
             result["videoHeight"] = self.video_height
         if self.egress is not None:
             result["egress"] = self.egress.to_dict()
+        if self.show_ai_avatar_disclosure is not None:
+            result["showAIAvatarDisclosure"] = self.show_ai_avatar_disclosure
         return result
 
 

tests/test_client.py

@@ -12,6 +12,8 @@
     AnamEvent,
     ClientOptions,
     DirectorNotes,
+    EgressDailyOptions,
+    EgressOptions,
     MessageRole,
     MessageStreamEvent,
     PersonaConfig,
@@ -283,6 +285,33 @@ def test_to_dict_with_video_dimensions(self) -> None:
             "videoHeight": 768,
         }
 
+    @pytest.mark.parametrize("value", [True, False])
+    def test_to_dict_with_ai_avatar_disclosure(self, value: bool) -> None:
+        options = SessionOptions(show_ai_avatar_disclosure=value)
+
+        assert options.to_dict()["showAIAvatarDisclosure"] is value
+
+    def test_to_dict_omits_ai_avatar_disclosure_by_default(self) -> None:
+        assert "showAIAvatarDisclosure" not in SessionOptions().to_dict()
+
+    def test_ai_avatar_disclosure_preserves_positional_egress_argument(self) -> None:
+        egress = EgressOptions(
+            mode="daily",
+            daily=EgressDailyOptions(room_url="https://example.daily.co/room"),
+        )
+        options = SessionOptions(True, "high", None, None, egress, True)
+
+        assert options.egress is egress
+        assert options.show_ai_avatar_disclosure is True
+        result = options.to_dict()
+        assert result["egress"]["mode"] == "daily"
+        assert list(result) == [
+            "sessionReplay",
+            "videoQuality",
+            "egress",
+            "showAIAvatarDisclosure",
+        ]
+
     def test_invalid_video_quality_raises_value_error(self) -> None:
         with pytest.raises(ValueError, match='video_quality must be either "high" or "auto"'):
             SessionOptions(video_quality="medium")  # type: ignore[arg-type]