Constructor @param surfaceId Unique Surface identifier @param context Android Context @param componentEventDispatcher

Non-copyable and non-movable

Constructor @param activity Android Activity

Constructs a SurfaceSize from raw screen-pixel values. @param widthPx Width in screen pixels. Pass 0 (or any non-positive value) to

RC001

ASA001: rapid SurfaceManager create / destroy.

TSA001: alternating add/remove listener while another thread streams.

Edge case: invalid enum value returns "unknown"

SS001

OR001: begin → chunk → end is processed in order; the resulting onCreateSurface callback observes the full envelope.

LR003: serialized create/destroy from a single thread (the documented contract). We do NOT call engine->createSurfaceManager from multiple threads — e

CT001

LB001: registering the same listener twice causes each callback to be invoked twice (the dispatcher uses emplace_back without dedup).

TD001

UA001: surfaceId / componentId empty path triggers no callback (logged only). We verify safety here, not behavior on real components.

FC001

E001: init returns a valid (non-null) engine pointer. With the Environment already running, this is a re-entry of init and must return the existing in

ST001

DC001: Full lifecycle destroy chain. Covers all 6 APIs in a single subprocess run: initAGenUIEngine (global env) → createSurfaceManager → beginTextSt

SM001

EL001: addListener immediately after createSurfaceManager (before init() ran on the worker thread). It must be cached and applied once init completes.

MS001

ED001: addSurfaceEventListener with nullptr is safely ignored.

SCI001: Complete payload as single chunk produces onComponentsAdd.

STI001: Complete Text sent at once - single add.