@iwsdk/cli 1.1.0-rc.0 → 1.1.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -59,6 +59,24 @@ service workers survive browser recovery; normal OS temporary-file cleanup may
59
59
  eventually remove them. A browser whose cleanup cannot be confirmed blocks
60
60
  replacement and reports that condition.
61
61
 
62
+ The runtime's command WebSocket (`/__iwer_mcp`) accepts connections only from a
63
+ loopback address with a local `Host` header, and a browser only from the dev
64
+ server's own origin. Every command must also carry the dev-server session's
65
+ command credential: a random secret the dev server writes to
66
+ `.iwsdk/runtime/command-credential.json` (never served over HTTP) and deletes
67
+ when it stops. On macOS and Linux the file has mode 0600; on Windows it takes
68
+ the permissions of the project folder. The CLI and `iwsdk mcp stdio` read it for
69
+ the session they resolved and send it with each command; the server drops it
70
+ before relaying a command to a page. Commands without it fail with
71
+ `runtime_unauthorized` and `outcome: "not_executed"`, so scripts running in a
72
+ page (an app dependency, for example) and, on macOS and Linux, other local users
73
+ cannot drive the runtime, editor or managed browser. Any process running as your
74
+ own OS user can read the file, so the credential is no boundary against those.
75
+ Browser bridges never hold the credential: the managed browser identifies itself
76
+ with its injected session identity, and a headset with its pairing token. Use
77
+ the CLI and dev server from the same IWSDK release; an older CLI sends no
78
+ credential.
79
+
62
80
  Use `iwsdk runtime status` for the live lifecycle, `runtime targets` for connected
63
81
  pages and their supported methods, and `runtime wait --input-json
64
82
  '{"afterRevision":7,"timeoutMs":25000}'` to wait without causing recovery.
@@ -1 +1 @@
1
- {"version":3,"file":"browser-lease.d.ts","sourceRoot":"","sources":["../src/browser-lease.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,+EAA+E;AAC/E,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC,CAiGD"}
1
+ {"version":3,"file":"browser-lease.d.ts","sourceRoot":"","sources":["../src/browser-lease.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,+EAA+E;AAC/E,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACtB,CAAC,CAyGD"}