Add README

README.md

@@ -0,0 +1,51 @@
+# rom-control
+
+Robust client for the Jibo ROM WebSocket API. Provides a discord.js-style OOP interface with promises, rich event objects, and automatic session management.
+
+```js
+const { Client, AttentionMode } = require('rom-control');
+
+const jibo = new Client({ host: '192.168.1.217' });
+
+jibo.once('ready', async () => {
+  await jibo.behavior.setAttention(AttentionMode.Engaged);
+  await jibo.behavior.say('<anim cat="excited" nonBlocking="true"/> Hello!');
+});
+
+jibo.on('trackCreate', async (track) => {
+  await track.lookAt();
+});
+
+jibo.on('hotword', async (event) => {
+  const result = await jibo.audio.awaitSpeech();
+  console.log('Heard:', result.speech);
+});
+
+jibo.connect();
+```
+
+## Install
+
+```
+npm install rom-control
+```
+
+## Features
+
+- Promise-based API — every action resolves when physically complete
+- Manager classes: `client.behavior`, `client.audio`, `client.camera`, `client.display`, `client.assets`
+- Rich event objects: `Track`, `Photo`, `SpeechResult`, `HotwordEvent`, `GestureEvent`, and more
+- Live entity tracking map (`client.tracks`)
+- Auto-reconnect, auto-heartbeat, and auto-subscribe
+- Local ASR speech recognition (no cloud required)
+- Wakeword detection via on-robot ASR service
+- ESM and CJS exports
+
+## Documentation
+
+See [API.md](./API.md) for full reference.
+
+## Requirements
+
+- Node.js ≥ 16
+- A Jibo robot running ROM firmware on your local network