fix: add README files to platform packages and fix relative refs in main README

README.md

@@ -179,7 +179,7 @@ On the remote Windows machine, mapped drives appear in File Explorer as network
 
 Interact with Windows applications programmatically via the Windows UI Automation API using native patterns (InvokePattern, SelectionItemPattern, TogglePattern, etc.). When enabled, a PowerShell agent is injected into the remote session that captures the accessibility tree and performs actions. Communication between the CLI and the agent uses a Dynamic Virtual Channel (DVC) for fast bidirectional IPC.
 
-For detailed documentation, see [docs/AUTOMATION.md](docs/AUTOMATION.md).
+For detailed documentation, see [AUTOMATION.md](https://github.com/thisnick/agent-rdp/blob/main/docs/AUTOMATION.md).
 
 ```bash
 # Connect with automation enabled
@@ -412,7 +412,7 @@ await rdp.connect({...});
 const streamUrl = rdp.getStreamUrl(); // "ws://localhost:9224"
 ```
 
-For the complete WebSocket protocol specification (message types, clipboard flow, input handling), see [docs/WEBSOCKET.md](docs/WEBSOCKET.md).
+For the complete WebSocket protocol specification (message types, clipboard flow, input handling), see [WEBSOCKET.md](https://github.com/thisnick/agent-rdp/blob/main/docs/WEBSOCKET.md).
 
 ## Architecture
 

packages/darwin-arm64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/darwin-arm64
+
+Native binary package for macOS ARM64 (Apple Silicon).
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/darwin-arm64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "scripts": {
     "postinstall": "chmod +x bin/agent-rdp 2>/dev/null || true"

packages/darwin-x64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/darwin-x64
+
+Native binary package for macOS x64 (Intel).
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/darwin-x64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "scripts": {
     "postinstall": "chmod +x bin/agent-rdp 2>/dev/null || true"

packages/linux-arm64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/linux-arm64
+
+Native binary package for Linux ARM64.
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/linux-arm64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "scripts": {
     "postinstall": "chmod +x bin/agent-rdp 2>/dev/null || true"

packages/linux-x64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/linux-x64
+
+Native binary package for Linux x64.
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/linux-x64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "scripts": {
     "postinstall": "chmod +x bin/agent-rdp 2>/dev/null || true"

packages/win32-arm64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/win32-arm64
+
+Native binary package for Windows ARM64.
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/win32-arm64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "preferUnplugged": true
 }

packages/win32-x64/README.md

@@ -0,0 +1,17 @@
+# @agent-rdp/win32-x64
+
+Native binary package for Windows x64.
+
+This is a platform-specific package that contains the native binary for agent-rdp. You should not install this package directly - instead, install the main package:
+
+```bash
+npm install agent-rdp
+```
+
+The main package will automatically install the correct platform-specific binary for your system.
+
+For documentation, see the [agent-rdp README](https://github.com/thisnick/agent-rdp#readme).
+
+## License
+
+MIT OR Apache-2.0

packages/win32-x64/package.json

@@ -16,7 +16,8 @@
   ],
   "files": [
     "bin",
-    "models"
+    "models",
+    "README.md"
   ],
   "preferUnplugged": true
 }