@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 +18 -0
- package/dist/browser-lease.d.ts.map +1 -1
- package/dist/cli.js +669 -127
- package/dist/cli.js.map +1 -1
- package/dist/commands/runtime.d.ts.map +1 -1
- package/dist/contract.js +596 -118
- package/dist/contract.js.map +1 -1
- package/dist/help.d.ts.map +1 -1
- package/dist/index.js +669 -127
- package/dist/index.js.map +1 -1
- package/dist/runtime-contract.d.ts +22 -1
- package/dist/runtime-contract.d.ts.map +1 -1
- package/dist/runtime-state.d.ts +8 -0
- package/dist/runtime-state.d.ts.map +1 -1
- package/dist/runtime-transport.d.ts.map +1 -1
- package/dist/version.d.ts +1 -1
- package/guidance/AGENTS.md +25 -12
- package/package.json +1 -1
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;
|
|
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"}
|