Developer Preview / Hardware Not Yet Verified: X3 hardware and the deployed robot runtime have not been validated. Local tests do not establish device compatibility, physical behavior, or safe operation.
XiaolingClient
The ROS client exposes callbacks for status and text results. Callback execution requires the node to be spun. The following read-only example prints data locally; dialog data can contain personal information, so do not use it in shared logs without an appropriate policy.
namespace selects the client namespace; it must match the deployment’s names and remappings. send_text(text) publishes a nonempty string and returns immediately; it does not acknowledge delivery. text_subscriber_count() reports discovery, not delivery. start_session(timeout_sec=5.0) and stop_session(timeout_sec=5.0) wait for a service and return an asynchronous future. Spin the node, enforce a separate response timeout, and inspect the response. Session and text operations can affect the robot and require operator approval.
Read-only WebSocket client
warmcore_xiaoling.rosbridge.XiaolingRosbridgeClient supports connection, subscriptions to dialog status and text-result events, receiving, and closing. Its allowlist does not secure the server. Deployed transport and events remain unverified. See examples for a diagnostic workflow.