Add self-hosted Studio provider runner (#21)

Author: DjDeveloperr

docs/cli/commands.md

@@ -54,6 +54,24 @@ Studio expose defaults to software H.264, realtime stream delivery, and the
 active codec/profile, and keeps the outbound bridge alive until Ctrl-C.
 `--video-codec hardware` opts back into the hardware encoder when that is preferable.
 
+### `provider`
+
+Run a self-hosted SimDeck Studio provider on an always-on Mac:
+
+```sh
+simdeck provider connect --studio-url https://simdeck.djdev.me \
+                         --host-id <id> --host-token <token>
+simdeck provider run [--max-capacity 1] [--simulator-template "iPhone 17 Pro"]
+simdeck provider status
+```
+
+`provider connect` stores the Studio host credential in
+`~/.simdeck/studio-provider.json` with user-only permissions. `provider run`
+starts or reuses the local daemon, heartbeats to Studio, polls for allocation
+jobs, clones simulators from the configured template, installs downloaded
+artifacts, launches the configured bundle id, proxies Studio API requests to the
+local daemon, and deletes session clones on release.
+
 ### `daemon start`
 
 Start or reuse the project daemon without opening the browser:

package.json

@@ -15,6 +15,7 @@
     "README.md",
     "bin/",
     "scripts/experimental/",
+    "scripts/studio-host-provider.mjs",
     "scripts/studio-provider-bridge.mjs",
     "scripts/postinstall.mjs",
     "build/simdeck-bin",
@@ -73,7 +74,7 @@
     "test:e2e:webrtc": "node scripts/e2e-webrtc-reliability.mjs",
     "test:e2e:webrtc:headed": "SIMDECK_E2E_HEADFUL=1 node scripts/e2e-webrtc-reliability.mjs",
     "test:e2e:webrtc:stress": "node scripts/e2e-webrtc-stress.mjs",
-    "test:studio-provider": "node --test scripts/studio-provider-bridge.test.mjs",
+    "test:studio-provider": "node --test scripts/studio-provider-bridge.test.mjs scripts/studio-host-provider.test.mjs",
     "test:stress": "node scripts/stress/simdeck.mjs",
     "bench:encoder:build": "scripts/bench/build-encoder-benchmark.sh",
     "ci": "npm run lint && npm run build:all && npm run test && npm run package:vscode-extension",