CmdTargetUpsert

Upserts a logical target used by the auto-graph system.

Arguments

Field	Type	Description
targetId	u64	Logical target ID
kind	TargetKind	"window", "widget-realm-viewport", "realm-plane", "texture"
windowId	Option	Required for window, widget-realm-viewport, realm-plane
size	Option	Valid only for texture targets
formatPolicy	Option	Optional color/depth format policy
alphaPolicy	Option	Optional alpha policy
msaaSamples	Option	Optional MSAA samples

Response

Returns CmdResultTargetUpsert:

Field	Type	Description
success	bool	Whether the target was upserted
message	String	Status or error message

Validation Rules

• windowId is required for kind = "window", "widget-realm-viewport", and "realm-plane".
• windowId must reference an existing window.
• windowId is not accepted for kind = "texture".
• widget-realm-viewport is intended for UiNodeProps::WidgetRealmViewport sampling. It participates in auto-graph routing/input, but is not composed as a visible connector overlay on the host UI realm.
• size is accepted only for kind = "texture".

When validation fails:

• command response returns success = false
• host also receives SystemEvent::Error (scope = "command").