stelz 0.2.0 → 0.2.1

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.
Files changed (32) hide show
  1. package/README.md +12 -6
  2. package/THIRD_PARTY_NOTICES.md +3 -1
  3. package/dist/cli.js +4295 -1291
  4. package/dist/plugin.js +92 -17
  5. package/dist/supervisor.js +137 -34
  6. package/dist/ui/assets/index-7xWId3LL.js +11 -0
  7. package/dist/ui/assets/index-By17r8AD.css +1 -0
  8. package/dist/ui/index.html +4 -3
  9. package/docs/README.md +24 -7
  10. package/docs/architecture.md +56 -5
  11. package/docs/bootstrap.md +195 -0
  12. package/docs/clients.md +5 -1
  13. package/docs/distribution.md +26 -17
  14. package/docs/onboarding-acceptance.md +79 -0
  15. package/docs/profile-transfer.md +89 -0
  16. package/docs/tests.md +76 -27
  17. package/docs/ui.md +31 -15
  18. package/examples/onboarding-fixture.html +22 -0
  19. package/package.json +62 -8
  20. package/skills/stelz-browser/SKILL.md +7 -3
  21. package/skills/stelz-browser/references/bootstrap.md +16 -0
  22. package/dist/ui/chunk-6y88c98t.css +0 -1
  23. package/dist/ui/chunk-jt6ajg4c.js +0 -11
  24. /package/dist/ui/{font-328d50b6ece9ca25.woff → assets/ibm-plex-mono-latin-400-normal-CvHOgSBP.woff} +0 -0
  25. /package/dist/ui/{font-08949f728dc52d52.woff2 → assets/ibm-plex-mono-latin-400-normal-DMJ8VG8y.woff2} +0 -0
  26. /package/dist/ui/{font-3b646991d30055a9.woff2 → assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2} +0 -0
  27. /package/dist/ui/{font-828907bfd14855c8.woff → assets/ibm-plex-sans-latin-400-normal-CYLoc0-x.woff} +0 -0
  28. /package/dist/ui/{font-0717336fb31fcdcd.woff2 → assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2} +0 -0
  29. /package/dist/ui/{font-8d2c7b2eca91869d.woff → assets/ibm-plex-sans-latin-500-normal-BgVn5rGT.woff} +0 -0
  30. /package/dist/ui/{font-7861a349af1e925a.woff → assets/ibm-plex-sans-latin-600-normal-Cu4Hd6ag.woff} +0 -0
  31. /package/dist/ui/{font-8960851d691c054e.woff2 → assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2} +0 -0
  32. /package/dist/ui/{theme-j8bgvgsv.js → theme-fqsa3r76.js} +0 -0
package/README.md CHANGED
@@ -6,6 +6,9 @@ stelz runs persistent Camoufox profiles through standard MCP, with one browser i
6
6
  There is no global browser or saved-profile count limit.
7
7
  It needs Bun, Node.js, and Camoufox. It needs no agent harness or LLM credentials.
8
8
 
9
+ To let a local coding agent complete installation, give it the [bootstrap instructions](docs/bootstrap.md).
10
+ The procedure creates or reuses a persistent profile and verifies control through the agent's tools.
11
+
9
12
  Install Stelz globally:
10
13
 
11
14
  ```sh
@@ -23,7 +26,7 @@ Use the UI's window icon to find a profile's window.
23
26
  See [Find a profile's windows](docs/ui.md#find-a-profiles-windows).
24
27
 
25
28
  Build a release archive with `bun install --ignore-scripts` and `bun run pack`.
26
- Install a tested archive with `npm install --global ./stelz-0.2.0.tgz`.
29
+ Install a tested archive with `npm install --global ./release-artifacts/stelz-0.2.1.tgz`.
27
30
 
28
31
  Each MCP connection selects one profile. One controller can act on that profile at a time.
29
32
  Client disconnect releases control. The browser and its pages remain open.
@@ -34,16 +37,19 @@ Legacy configuration, data paths, CLI options, and MCP names remain supported.
34
37
  See [Compatibility](docs/README.md#compatibility) before changing existing configuration.
35
38
 
36
39
  - [Use the local UI](docs/ui.md)
40
+ - [Import and export profiles](docs/profile-transfer.md)
37
41
  - [Use the service](docs/README.md)
38
42
  - [Connect a client](docs/clients.md)
39
43
  - [Instructions for agents](docs/agents.md)
40
44
  - [Architecture and design decisions](docs/architecture.md)
41
45
  - [Development and testing](docs/tests.md)
42
46
 
43
- ## Workspace
47
+ ## Development
44
48
 
45
- `apps/ui` contains the private React UI. `packages/stelz` contains the only publishable package.
46
- The package groups source under `cli`, `profiles`, `browser`, `runtime`, `mcp`, and `api`.
47
- Root `docs/` and `examples/` are canonical. Build stages their copies into the package.
48
- Run `bun run verify:release` for browser-free archive verification.
49
+ `src/` contains the service. `ui/` contains the bundled React UI.
50
+ The root manifest defines the published package and development commands.
51
+ Build uses `docs/`, `examples/`, and `skills/` directly. It does not copy documentation.
52
+ Run `bun run check` for build, TypeScript checks, and browser-free tests.
53
+ Run `bun run pack` to create `release-artifacts/stelz-0.2.1.tgz`.
54
+ Run `bun run verify:release` to check that saved archive without a browser or rebuild.
49
55
  See [Distribution](docs/distribution.md) and [Camofox patches](docs/camofox-patches.md).
@@ -1,13 +1,15 @@
1
1
  # Third-party notices
2
2
 
3
3
  The local HTTP API uses Hono under the MIT License.
4
+ Profile ZIP archives use yazl and yauzl under the MIT License.
5
+ Checkpoint validation uses stream-json under the BSD 3-Clause License.
4
6
 
5
7
  The bundled local UI includes React, React DOM, and Scheduler under the MIT License.
6
8
  It includes IBM Plex Sans and IBM Plex Mono under the SIL Open Font License 1.1.
7
9
  The release archive contains their license texts in `dist/ui/licenses/`.
8
10
  The UI layout follows Camoufox Profile Manager. Its source code is not bundled into the UI.
9
11
 
10
- The device/runtime fingerprint classification in `packages/stelz/src/browser/fingerprint.ts` adapts
12
+ The device/runtime fingerprint classification in `src/browser/fingerprint.ts` adapts
11
13
  ideas and field classifications from `core/fingerprint_store.py` in
12
14
  Camoufox Profile Manager (https://github.com/polyackiy/camoufox-profile-manager).
13
15
  That project is not a runtime dependency of Stelz.