opensteer 0.4.6 → 0.4.8

package/CHANGELOG.md

@@ -17,9 +17,12 @@
 - Breaking: removed legacy `ai` config from `OpensteerConfig`; use top-level `model` instead.
 - Breaking: `OPENSTEER_AI_MODEL` is no longer supported; use `OPENSTEER_MODEL`.
 - Breaking: `OPENSTEER_RUNTIME` is no longer supported; use `OPENSTEER_MODE`.
-- Breaking: mode selection now uses `mode: 'local' | 'remote'` and remote credentials use `remote.apiKey`.
+- Breaking: constructor runtime selection now uses `cloud` (`cloud: true` or `cloud` options object); legacy `mode`/`remote` config is removed.
+- Breaking: `OPENSTEER_MODE` now uses `local` or `cloud`; `remote` is no longer a supported value.
 - Opensteer now enables built-in LLM resolve/extract by default with model `gpt-5.1`.
-- Remote mode now falls back to `OPENSTEER_API_KEY` when `remote.apiKey` is omitted.
+- Cloud mode now falls back to `OPENSTEER_API_KEY` when `cloud.apiKey` is omitted.
+- Added automatic `.env` loading from `storage.rootDir` (default `process.cwd()`) so constructor config can consume env vars without requiring `import 'dotenv/config'`.
+- `.env` autoload follows common precedence (`.env.<NODE_ENV>.local`, `.env.local`, `.env.<NODE_ENV>`, `.env`) with `.env.local` skipped in `test`, does not overwrite existing env values, and can be disabled via `OPENSTEER_DISABLE_DOTENV_AUTOLOAD`.
 - Mutating actions now include smart best-effort post-action wait with per-action
   profiles and optional per-call overrides via `wait`.
 - Added structured interaction diagnostics via `OpensteerActionError` for
@@ -31,7 +34,7 @@
 - Added DOM actionability probe + Playwright call-log classification to report
   reasons like `BLOCKED_BY_INTERCEPTOR`, `NOT_VISIBLE`, `NOT_EDITABLE`, and
   timeout/stale-target cases more accurately.
-- Remote action failures now accept optional structured failure details and map
+- Cloud action failures now accept optional structured failure details and map
   them to `OpensteerActionError` when available.
 
 ## 0.1.0

package/README.md

@@ -162,16 +162,21 @@ const opensteer = new Opensteer({
 Opensteer defaults to local mode.
 
 - `OPENSTEER_MODE=local` runs local Playwright.
-- `OPENSTEER_MODE=remote` runs remote mode (requires `OPENSTEER_API_KEY`).
-- `mode: "remote"` in constructor config always forces remote mode.
+- `OPENSTEER_MODE=cloud` enables cloud mode (requires `OPENSTEER_API_KEY`).
+- `cloud: true` in constructor config always enables cloud mode.
+- Opensteer auto-loads `.env` files from your `storage.rootDir` (default:
+  `process.cwd()`) using this order: `.env.<NODE_ENV>.local`, `.env.local`
+  (skipped when `NODE_ENV=test`), `.env.<NODE_ENV>`, `.env`.
+- Existing `process.env` values are never overwritten by `.env` values.
+- Set `OPENSTEER_DISABLE_DOTENV_AUTOLOAD=true` to disable auto-loading.
 
-Remote mode is fail-fast: it does not automatically fall back to local mode.
+Cloud mode is fail-fast: it does not automatically fall back to local mode.
 
 ## Docs
 
 - `docs/getting-started.md`
 - `docs/api-reference.md`
-- `docs/remote-integration.md`
+- `docs/cloud-integration.md`
 - `docs/html-cleaning.md`
 - `docs/selectors.md`
 - `docs/live-web-tests.md`

package/bin/opensteer.mjs

@@ -778,9 +778,11 @@ Environment:
   OPENSTEER_SESSION         Runtime session id (equivalent to --session)
   OPENSTEER_CLIENT_ID       Stable client identity for default session binding
   OPENSTEER_NAME            Default selector namespace for 'open' when --name is omitted
-  OPENSTEER_MODE            Runtime mode: "local" (default) or "remote"
-  OPENSTEER_API_KEY         Required when remote mode is selected
-  OPENSTEER_BASE_URL        Override remote control-plane base URL
+  OPENSTEER_MODE            Runtime routing: "local" (default) or "cloud"
+  OPENSTEER_API_KEY         Required when cloud mode is selected
+  OPENSTEER_BASE_URL        Override cloud control-plane base URL
+  OPENSTEER_APP_URL         Cloud app base URL for emitting browser session links (default: https://opensteer.com)
+  OPENSTEER_REMOTE_ANNOUNCE Cloud session announcement policy: always (default), off, tty
 `)
 }