@nothumanwork/sauron 0.2.1 → 0.2.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
|
@@ -72,7 +72,7 @@ The `sauron` launcher inside the package selects the matching binary for the cur
|
|
|
72
72
|
|
|
73
73
|
## Quick start
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
Start a runtime session before browser commands:
|
|
76
76
|
|
|
77
77
|
```bash
|
|
78
78
|
sauron runtime start
|
|
@@ -80,7 +80,7 @@ sauron runtime start
|
|
|
80
80
|
|
|
81
81
|
macOS defaults to GPU + WebGL on `runtime start` (opt out with `--no-webgl --no-gpu`).
|
|
82
82
|
|
|
83
|
-
Then run browser commands from the same project directory:
|
|
83
|
+
Then run browser commands from the same project directory. Later `sauron` invocations can reuse that session from separate subprocesses in the same shell or agent workflow:
|
|
84
84
|
|
|
85
85
|
```bash
|
|
86
86
|
sauron page goto https://example.com
|
|
@@ -97,13 +97,13 @@ sauron runtime stop
|
|
|
97
97
|
|
|
98
98
|
## Mandatory session lifecycle
|
|
99
99
|
|
|
100
|
-
-
|
|
100
|
+
- Most non-`runtime start` commands require an active runtime session. `runtime status` is the exception: it can also report `stopped` when no active session exists.
|
|
101
101
|
- Session resolution order is:
|
|
102
102
|
- explicit `--session-id`
|
|
103
103
|
- current process binding
|
|
104
104
|
- current project binding
|
|
105
105
|
- `SAURON_SESSION_ID` fallback
|
|
106
|
-
- If none resolve to an active session, commands fail with `SESSION_REQUIRED`.
|
|
106
|
+
- If none resolve to an active session, commands that need one fail with `SESSION_REQUIRED`.
|
|
107
107
|
- `start` auto-generates:
|
|
108
108
|
- `session_id` (`sess-...`)
|
|
109
109
|
- `instance` (`inst-...`)
|
|
@@ -179,6 +179,7 @@ unset SAURON_SESSION_ID
|
|
|
179
179
|
## Runtime state
|
|
180
180
|
|
|
181
181
|
Runtime session state is stored on the local filesystem under `~/.sauron/runtime/`.
|
|
182
|
+
After `runtime stop` or `runtime cleanup`, `sauron runtime status` reports `stopped`.
|
|
182
183
|
|
|
183
184
|
## Session logs
|
|
184
185
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|