Error codes

veriCue error responses use integer codes grouped by area:

1000-1006 - Protocol errors

Code	Name	Meaning
1000	unknown_error	Unspecified server-side failure
1001	parse_error	JSON malformed
1002	invalid_request	Required field missing/wrong type
1003	method_not_found	Unknown command name
1004	invalid_params	Required parameter missing/wrong type
1005	internal_error	Unhandled exception in handler
1006	protocol_mismatch	Client/server protocol version incompatible

1007-1008 - Authentication

Code	Name	Meaning
1007	authentication_required	Sent a command before handshake completed
1008	authentication_failed	Token in handshake didn't match server

1009-1012 - Licensing

Code	Name	Meaning
1009	license_session_limit_reached	Connection exceeds the licensed concurrent-session count
1010	license_expired	License past its expiry date
1011	license_invalid	License signature invalid or missing
1012	trial_expired	Trial mode finished, paid license required

2001-2003 - Object errors

Code	Name	Meaning
2001	object_not_found	Path didn't resolve to any QObject
2002	invalid_object_path	Path syntactically invalid
2003	property_not_found	QObject has no such property

2004-2007 - Widget errors

Code	Name	Meaning
2004	widget_not_visible	Cannot interact with a hidden widget
2005	widget_not_enabled	Widget is disabled
2006	not_a_widget	Operation requires a QWidget but got a different QObject
2007	screenshot_failed	Screen grab failed (offscreen platform?)

2008-2011 - Automation errors

Code	Name	Meaning
2008	property_read_only	Property has no setter
2009	invalid_property_value	Value can't be converted to the property type
2010	method_invocation_failed	invoke_method failed at runtime
2011	method_not_invokable	Method isn't Q_INVOKABLE or a public slot

2012-2018 - Extended

Code	Name	Meaning
2012	recording_not_active	stop_recording called without a prior start_recording
2013	signal_not_found	Signal name doesn't exist on the object
2014	signal_timeout	wait_for_signal timed out
2016	invalid_baseline	Baseline image for screenshot_compare missing/unreadable
2017	model_not_found	Path didn't resolve to a model
2018	invalid_model_index	Row/column out of bounds

2019-2020 - Subscription errors

Code	Name	Meaning
2019	property_not_notifiable	Property has no NOTIFY signal - can't subscribe
2020	subscription_not_found	unsubscribe called with unknown ID