@ulpi/browse 1.0.0 → 1.0.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.
Files changed (4) hide show
  1. package/README.md +11 -0
  2. package/dist/browse.mjs +481 -210
  3. package/package.json +2 -1
  4. package/skill/SKILL.md +16 -0
package/README.md CHANGED
@@ -379,6 +379,16 @@ Sessions auto-close after the idle timeout (default 30 min). Without `--session`
379
379
 
380
380
  For full process isolation (separate Chromium instances), use `BROWSE_PORT` to run independent servers.
381
381
 
382
+ ### Profiles vs Sessions
383
+
384
+ | | `--session` | `--profile` |
385
+ |---|---|---|
386
+ | Chromium | Shared (one process) | Own (one per profile) |
387
+ | Memory | ~5MB per session | ~200MB per profile |
388
+ | State | Ephemeral (auto-persisted cookies) | Full persistence (cookies, cache, IndexedDB) |
389
+ | Multiplexing | Yes (parallel agents) | No (one agent per profile) |
390
+ | Use case | Parallel browsing, lightweight | Real login state, heavy |
391
+
382
392
  ## Security
383
393
 
384
394
  All security features are opt-in — existing workflows are unaffected until you explicitly enable a feature.
@@ -498,6 +508,7 @@ Use browse to test the login flow. Run browse --help to see available commands.
498
508
  | Flag | Description |
499
509
  |------|-------------|
500
510
  | `--session <id>` | Named session (isolates tabs, refs, cookies) |
511
+ | `--profile <name>` | Persistent browser profile (own Chromium, full state) |
501
512
  | `--json` | Wrap output as `{success, data, command}` |
502
513
  | `--content-boundaries` | Wrap page content in nonce-delimited markers |
503
514
  | `--allowed-domains <d,d>` | Block navigation/resources outside allowlist |