@evenrealities/evenhub-simulator 0.6.2 → 0.7.2

package/README.md

@@ -37,6 +37,7 @@ Options:
       --no-aid                    Use default audio device (overrides config)
   -V, --version                   Print version
       --print-config-path         Print the default config file path and exit
+      --automation-port <PORT>    Start automation HTTP server on this port (e.g. 9898)
       --completions <SHELL>       Print shell completion script [possible values: bash, elvish, fish, powershell, zsh]
   -h, --help                      Print help
 
@@ -58,6 +59,7 @@ evenhub-simulator --completions zsh > ~/.zsh/completions/_evenhub-simulator
 | `-b`, `--bounce <bounce>`    | Sets bounce animation type: `default` or `spring`.                                     |
 | `--list-audio-input-devices` | Lists available audio input devices and exits.                                         |
 | `--aid <aid>` / `--no-aid`   | Select a specific audio input device, or force the system default device.              |
+| `--automation-port <port>`   | Start an HTTP automation server on the given port. See [Automation](#automation).      |
 | `--completions <shell>`      | Prints a shell completion script for `bash`, `elvish`, `fish`, `powershell`, or `zsh`. |
 
 
@@ -129,8 +131,71 @@ Note: The image is not affected by the 'glow' flags, as that is a visual
 post-processing effect only.
 
 
+## Automation
+
+Starting with v0.7.0, the simulator can expose an HTTP API for programmatic
+control, which is intended to make it easier for scripts (and AI agents) to
+drive the simulator — send input, capture screenshots, and read console
+output.
+
+Launch with `--automation-port` to enable it:
+
+```bash
+evenhub-simulator https://my-app.example.com --automation-port 9898
+```
+
+Base URL: `http://127.0.0.1:<PORT>`
+
+| Method   | Endpoint                   | Description                                                          |
+|----------|----------------------------|----------------------------------------------------------------------|
+| `GET`    | `/api/ping`                | Health check, returns `pong`.                                        |
+| `GET`    | `/api/screenshot/glasses`  | Current glasses framebuffer as an RGBA PNG (576×288).                |
+| `GET`    | `/api/screenshot/webview`  | Screenshot of the main webview (via html2canvas) as PNG.             |
+| `GET`    | `/api/console`             | Captured webview `console.*` output, uncaught errors, failed fetches. Supports `?since_id=<N>` for incremental polling. |
+| `DELETE` | `/api/console`             | Clears the console buffer.                                           |
+| `POST`   | `/api/input`               | Send a glasses touchpad action. JSON body: `{ "action": "up" \| "down" \| "click" \| "double_click" }`. |
+
+Notes:
+
+- Input is only effective when the app has an active event container (list or
+  text). If nothing is listening, the action is silently ignored.
+- Console entries are tagged with a monotonically increasing `id`; use
+  `since_id` when polling to avoid re-reading old entries.
+- Non-console sources are prefixed in the message: `[uncaught] …`,
+  `[unhandledrejection] …`, `[fetch] …`.
+
+
 # Changelog
 
+## v0.7.2 (2026-04-15)
+
+- Improved emoji rendering support (including previously missing emoji characters).
+- Improved bounce/spring animation stability.
+- Better compatibility with newer local build toolchains.
+
+## v0.7.1 (2026-04-09)
+
+A few fixes to behave more like firmware:
+
+- make it no scrollbar even if containers exceed maximum full screen
+- cap width/height for single container
+- add text container bytes limit to 999
+
+## v0.7.0
+
+- New `--automation-port <PORT>` flag that starts an HTTP server exposing
+  endpoints for screenshots, console logs, and glasses input — useful for
+  scripted testing and AI-driven automation. See the
+  [Automation](#automation) section.
+- Default `border_color` is now `0` (invisible) instead of `15` (white), to
+  match the glasses.
+- Unknown-glyph handling now matches the firmware: `LV_USE_FONT_PLACEHOLDER`
+  is enabled, and the underlying lvgl crate is built with the `g2` feature
+  that customizes how missing glyphs are rendered to align with the glasses.
+- Internal rendering pipeline optimization: the glasses canvas is now streamed
+  as raw PNG bytes over a Tauri channel instead of base64-encoded events
+  (not important to users though).
+
 ## v0.6.2 (2026-03-25)
 
 - adjust container limits (trying to be in sync with firmware behavior)

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@evenrealities/evenhub-simulator",
-  "version": "0.6.2",
+  "version": "0.7.2",
   "description": "EvenHub glasses app simulator",
   "bin": {
     "evenhub-simulator": "bin/index.js"
   },
   "optionalDependencies": {
-    "@evenrealities/sim-darwin-arm64": "0.6.2",
-    "@evenrealities/sim-darwin-x64": "0.6.2",
-    "@evenrealities/sim-linux-x64": "0.6.2",
-    "@evenrealities/sim-win32-x64": "0.6.2"
+    "@evenrealities/sim-darwin-arm64": "0.7.2",
+    "@evenrealities/sim-darwin-x64": "0.7.2",
+    "@evenrealities/sim-linux-x64": "0.7.2",
+    "@evenrealities/sim-win32-x64": "0.7.2"
   },
   "license": "MIT"
 }