Enhance WebSocket session configuration by introducing an optional config.resolved event, which provides a public snapshot of the session's configuration. Update the API reference documentation to clarify the conditions under which this event is emitted and the details it includes. Modify session management to respect the new setting for emitting configuration details, ensuring sensitive information remains secure. Update tests to validate the new behavior and ensure compliance with the updated configuration schema.

engine/app/config.py

@@ -493,6 +493,10 @@ class Settings(BaseSettings):
     inactivity_timeout_sec: int = Field(default=60, description="Close connection after no message from client (seconds)")
     heartbeat_interval_sec: int = Field(default=50, description="Send heartBeat event to client every N seconds")
     ws_protocol_version: str = Field(default="v1", description="Public WS protocol version")
+    ws_emit_config_resolved: bool = Field(
+        default=False,
+        description="Emit config.resolved after session.started (debug/internal use; disabled for public SaaS by default)",
+    )
 
     # Backend bridge configuration (for call/transcript persistence)
     backend_mode: str = Field(