Feat/session options egress

[sebvanleuven]

Add direct egress to publish the avatar’s audio/video directly into a Daily.co room. Enable via SessionOptions.egress; default media path is unchanged unless set.

New Features:

• Extended SessionOptions with optional egress.
• Added EgressOptions with mode="daily" and a required daily block.
• Added EgressDailyOptions (room_url, optional token, user_name).
• Expanded README with a Daily setup example and token guidance.

---

Summary by cubic

Add direct egress to publish the avatar’s audio/video straight into a Daily room. Experimental (Cara-4 only) with an explicit alpha-breaking changes warning; defaults unchanged unless SessionOptions.egress is set.

• New Features
  • New types: EgressOptions (mode="daily") and EgressDailyOptions (room_url, optional token, user_name); integrated into SessionOptions (optional egress) with validation/serialization and exported via anam.__init__.
  • Docs: Added a dedicated Daily egress section with example, stronger warning about upcoming alpha changes, and clearer token rules (token must match the room_url; omit for public rooms).

^{Written for commit 933c46b. Summary will update on new commits.}

[cubic-dev-ai]

2 issues found across 3 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/anam/types.py">

<violation number="1" location="src/anam/types.py:132">
P2: `EgressDailyOptions.user_name` default does not match the documented API default (`"anam-avatar"`). Set the field default accordingly so omitted values serialize consistently with the SDK contract.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic</sub>