opensteer 0.9.2 → 0.9.4

package/dist/local-view/serve-entry.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { runLocalViewService } from '../chunk-FIMNKEG5.js';
-import '../chunk-BMPUL66S.js';
+import { runLocalViewService } from '../chunk-ZRF7WMS3.js';
+import '../chunk-T5P2QGZ3.js';
 
 // src/local-view/serve-entry.ts
 runLocalViewService().catch((error) => {

package/dist/opensteer-PJI7VUIT.js

@@ -0,0 +1,6 @@
+export { Opensteer } from './chunk-HQCMXRBE.js';
+import './chunk-GEUHKPC2.js';
+import './chunk-GSCQQKZZ.js';
+import './chunk-T5P2QGZ3.js';
+//# sourceMappingURL=opensteer-PJI7VUIT.js.map
+//# sourceMappingURL=opensteer-PJI7VUIT.js.map

package/dist/{opensteer-MIQ43CY4.js.map → opensteer-PJI7VUIT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"opensteer-MIQ43CY4.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"opensteer-PJI7VUIT.js"}

package/dist/{session-control-IFE3IPS3.js → session-control-M3JD7ZKA.js}

@@ -1,5 +1,5 @@
-import { OpensteerBrowserManager } from './chunk-2TIVULZY.js';
-import { readLocalViewSessionManifest, readPersistedLocalBrowserSessionRecord, deleteLocalViewSessionManifest } from './chunk-BMPUL66S.js';
+import { OpensteerBrowserManager } from './chunk-GSCQQKZZ.js';
+import { readLocalViewSessionManifest, readPersistedLocalBrowserSessionRecord, deleteLocalViewSessionManifest } from './chunk-T5P2QGZ3.js';
 
 // src/local-view/session-control.ts
 var LocalViewSessionCloseError = class extends Error {
@@ -35,5 +35,5 @@ async function closeLocalViewSessionBrowser(sessionId) {
 }
 
 export { LocalViewSessionCloseError, closeLocalViewSessionBrowser };
-//# sourceMappingURL=session-control-IFE3IPS3.js.map
-//# sourceMappingURL=session-control-IFE3IPS3.js.map
+//# sourceMappingURL=session-control-M3JD7ZKA.js.map
+//# sourceMappingURL=session-control-M3JD7ZKA.js.map

package/dist/{session-control-IFE3IPS3.js.map → session-control-M3JD7ZKA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/local-view/session-control.ts"],"names":[],"mappings":";;;;AAOO,IAAM,0BAAA,GAAN,cAAyC,KAAA,CAAM;AAAA,EACpD,WAAA,CACE,SACS,UAAA,EACT;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAFJ,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EACd;AACF;AAEA,eAAsB,6BAA6B,SAAA,EAAkC;AACnF,EAAA,MAAM,QAAA,GAAW,MAAM,4BAAA,CAA6B,SAAS,CAAA;AAC7D,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,0BAAA,CAA2B,oBAAA,EAAsB,GAAG,CAAA;AAAA,EAChE;AAEA,EAAA,IAAI,QAAA,CAAS,cAAc,OAAA,EAAS;AAClC,IAAA,MAAM,IAAI,0BAAA;AAAA,MACR,wEAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,sCAAA,CAAuC,QAAA,CAAS,QAAQ,CAAA;AAC7E,EAAA,IACE,CAAC,MAAA,IACD,MAAA,CAAO,GAAA,KAAQ,QAAA,CAAS,GAAA,IACxB,MAAA,CAAO,SAAA,KAAc,QAAA,CAAS,SAAA,IAC9B,MAAA,CAAO,MAAA,KAAW,SAAS,MAAA,EAC3B;AACA,IAAA,MAAM,8BAAA,CAA+B,SAAS,CAAA,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrE,IAAA,MAAM,IAAI,0BAAA,CAA2B,oBAAA,EAAsB,GAAG,CAAA;AAAA,EAChE;AAEA,EAAA,MAAM,OAAA,GAAU,IAAI,uBAAA,CAAwB;AAAA,IAC1C,UAAU,QAAA,CAAS,QAAA;AAAA,IACnB,GAAI,SAAS,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,QAAA,CAAS,SAAA,EAAU;AAAA,IAC5E,YAAY,MAAA,CAAO,MAAA;AAAA,IACnB,OAAA,EAAS;AAAA,GACV,CAAA;AACD,EAAA,MAAM,QAAQ,KAAA,EAAM;AACtB","file":"session-control-IFE3IPS3.js","sourcesContent":["import { readPersistedLocalBrowserSessionRecord } from \"../live-session.js\";\nimport { OpensteerBrowserManager } from \"../browser-manager.js\";\nimport {\n  deleteLocalViewSessionManifest,\n  readLocalViewSessionManifest,\n} from \"./session-manifest.js\";\n\nexport class LocalViewSessionCloseError extends Error {\n  constructor(\n    message: string,\n    readonly statusCode: 404 | 409,\n  ) {\n    super(message);\n    this.name = \"LocalViewSessionCloseError\";\n  }\n}\n\nexport async function closeLocalViewSessionBrowser(sessionId: string): Promise<void> {\n  const manifest = await readLocalViewSessionManifest(sessionId);\n  if (!manifest) {\n    throw new LocalViewSessionCloseError(\"Session not found.\", 404);\n  }\n\n  if (manifest.ownership !== \"owned\") {\n    throw new LocalViewSessionCloseError(\n      \"Only Opensteer-owned local browsers can be closed from the local view.\",\n      409,\n    );\n  }\n\n  const record = await readPersistedLocalBrowserSessionRecord(manifest.rootPath);\n  if (\n    !record ||\n    record.pid !== manifest.pid ||\n    record.startedAt !== manifest.startedAt ||\n    record.engine !== manifest.engine\n  ) {\n    await deleteLocalViewSessionManifest(sessionId).catch(() => undefined);\n    throw new LocalViewSessionCloseError(\"Session not found.\", 404);\n  }\n\n  const manager = new OpensteerBrowserManager({\n    rootPath: manifest.rootPath,\n    ...(manifest.workspace === undefined ? {} : { workspace: manifest.workspace }),\n    engineName: record.engine,\n    browser: \"persistent\",\n  });\n  await manager.close();\n}\n"]}
+{"version":3,"sources":["../src/local-view/session-control.ts"],"names":[],"mappings":";;;;AAOO,IAAM,0BAAA,GAAN,cAAyC,KAAA,CAAM;AAAA,EACpD,WAAA,CACE,SACS,UAAA,EACT;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAFJ,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,4BAAA;AAAA,EACd;AACF;AAEA,eAAsB,6BAA6B,SAAA,EAAkC;AACnF,EAAA,MAAM,QAAA,GAAW,MAAM,4BAAA,CAA6B,SAAS,CAAA;AAC7D,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,0BAAA,CAA2B,oBAAA,EAAsB,GAAG,CAAA;AAAA,EAChE;AAEA,EAAA,IAAI,QAAA,CAAS,cAAc,OAAA,EAAS;AAClC,IAAA,MAAM,IAAI,0BAAA;AAAA,MACR,wEAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,sCAAA,CAAuC,QAAA,CAAS,QAAQ,CAAA;AAC7E,EAAA,IACE,CAAC,MAAA,IACD,MAAA,CAAO,GAAA,KAAQ,QAAA,CAAS,GAAA,IACxB,MAAA,CAAO,SAAA,KAAc,QAAA,CAAS,SAAA,IAC9B,MAAA,CAAO,MAAA,KAAW,SAAS,MAAA,EAC3B;AACA,IAAA,MAAM,8BAAA,CAA+B,SAAS,CAAA,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrE,IAAA,MAAM,IAAI,0BAAA,CAA2B,oBAAA,EAAsB,GAAG,CAAA;AAAA,EAChE;AAEA,EAAA,MAAM,OAAA,GAAU,IAAI,uBAAA,CAAwB;AAAA,IAC1C,UAAU,QAAA,CAAS,QAAA;AAAA,IACnB,GAAI,SAAS,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,QAAA,CAAS,SAAA,EAAU;AAAA,IAC5E,YAAY,MAAA,CAAO,MAAA;AAAA,IACnB,OAAA,EAAS;AAAA,GACV,CAAA;AACD,EAAA,MAAM,QAAQ,KAAA,EAAM;AACtB","file":"session-control-M3JD7ZKA.js","sourcesContent":["import { readPersistedLocalBrowserSessionRecord } from \"../live-session.js\";\nimport { OpensteerBrowserManager } from \"../browser-manager.js\";\nimport {\n  deleteLocalViewSessionManifest,\n  readLocalViewSessionManifest,\n} from \"./session-manifest.js\";\n\nexport class LocalViewSessionCloseError extends Error {\n  constructor(\n    message: string,\n    readonly statusCode: 404 | 409,\n  ) {\n    super(message);\n    this.name = \"LocalViewSessionCloseError\";\n  }\n}\n\nexport async function closeLocalViewSessionBrowser(sessionId: string): Promise<void> {\n  const manifest = await readLocalViewSessionManifest(sessionId);\n  if (!manifest) {\n    throw new LocalViewSessionCloseError(\"Session not found.\", 404);\n  }\n\n  if (manifest.ownership !== \"owned\") {\n    throw new LocalViewSessionCloseError(\n      \"Only Opensteer-owned local browsers can be closed from the local view.\",\n      409,\n    );\n  }\n\n  const record = await readPersistedLocalBrowserSessionRecord(manifest.rootPath);\n  if (\n    !record ||\n    record.pid !== manifest.pid ||\n    record.startedAt !== manifest.startedAt ||\n    record.engine !== manifest.engine\n  ) {\n    await deleteLocalViewSessionManifest(sessionId).catch(() => undefined);\n    throw new LocalViewSessionCloseError(\"Session not found.\", 404);\n  }\n\n  const manager = new OpensteerBrowserManager({\n    rootPath: manifest.rootPath,\n    ...(manifest.workspace === undefined ? {} : { workspace: manifest.workspace }),\n    engineName: record.engine,\n    browser: \"persistent\",\n  });\n  await manager.close();\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensteer",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "Opensteer browser automation, replay, and reverse-engineering toolkit.",
   "license": "MIT",
   "type": "module",
@@ -56,8 +56,8 @@
     "sharp": "^0.34.5",
     "skills": "^1.4.6",
     "ws": "^8.18.0",
-    "@opensteer/engine-playwright": "0.8.8",
-    "@opensteer/runtime-core": "0.2.2"
+    "@opensteer/engine-playwright": "0.8.9",
+    "@opensteer/runtime-core": "0.2.3"
   },
   "optionalDependencies": {
     "webcrack": "^2.15.1"
@@ -72,11 +72,11 @@
   },
   "devDependencies": {
     "@opensteer/browser-core": "0.7.9",
-    "@opensteer/protocol": "0.8.2",
+    "@opensteer/protocol": "0.8.3",
     "@opensteer/engine-abp": "0.8.9"
   },
   "scripts": {
-    "build": "tsup && node ../../scripts/copy-opensteer-local-view-assets.mjs && node ../../scripts/sync-package-skills.mjs",
+    "build": "tsup && node ../../scripts/copy-opensteer-local-view-assets.mjs && node ../../scripts/sync-package-skills.mjs && node ../../scripts/sync-package-readme.mjs",
     "clean": "rimraf dist skills",
     "typecheck": "tsc --noEmit -p tsconfig.json"
   }

package/skills/opensteer/SKILL.md

@@ -40,14 +40,13 @@ If the user wants to manually drive a browser and record the flow, use the `reco
 ## Core Rules
 
 1. Always use a workspace for stateful commands: `--workspace <id>` or `OPENSTEER_WORKSPACE`.
-2. In this repo, prefer `pnpm run opensteer:local -- <command>` instead of bare `opensteer ...`.
-3. Re-snapshot after navigation or big UI changes before reusing element numbers.
-4. CLI to discover, SDK for the final implementation.
-5. Use `persist` for stable reusable targets and extraction payloads.
-6. Use `exec` for SDK code and API experiments. Use `evaluate` only for page-context JavaScript.
-7. If `fetch()` fails with auth errors, inspect `state()`, `cookies()`, and `storage()` before changing transport.
-8. Keep output simple. Prefer ordinary TypeScript with `Opensteer`, no extra abstraction.
-9. Close the browser when done. Do not leave headed browsers running. Use `opensteer browser delete --workspace <id>` or SDK cleanup when the session does not need to stay open.
+2. Re-snapshot after navigation or big UI changes before reusing element numbers.
+3. CLI to discover, SDK for the final implementation.
+4. Use `persist` for stable reusable targets and extraction payloads.
+5. Use `exec` for SDK code and API experiments. Use `evaluate` only for page-context JavaScript.
+6. If `fetch()` fails with auth errors, inspect `state()`, `cookies()`, and `storage()` before changing transport.
+7. Keep output simple. Prefer ordinary TypeScript with `Opensteer`, no extra abstraction.
+8. Close the browser when done. Do not leave headed browsers running. Use `opensteer browser delete --workspace <id>` or SDK cleanup when the session does not need to stay open.
 
 ## Choose A Path
 

package/skills/recorder/SKILL.md

@@ -1,19 +1,25 @@
 ---
-name: recorder
-description: Use when the user wants to record a live browser workflow and turn it into a replayable Opensteer script. Prefer this for manual browser capture, multi-tab recording, and record-then-rerun workflows with the Opensteer CLI.
-argument-hint: "[url]"
+name: "recorder"
+description: "Use when the user wants to record a live browser workflow and turn it into a replayable script or API. Prefer this for manual browser capture, multi-tab recording, and record-then-rerun workflows with the Opensteer CLI."
 ---
 
 # Recorder
 
-Use the Opensteer recorder when the user wants to perform a real browser flow manually and save it as a deterministic replay script.
+Record a real browser flow performed manually by the user and save it as a deterministic replay script. Do not use this when the user wants programmatic browser automation without manual recording — use the `opensteer` skill instead.
 
-## Inputs
+## Prerequisites
 
-- `url`: starting URL to open
-- `workspace`: target Opensteer workspace id
-- `provider`: `local` or `cloud`
-- optional `output`: explicit output path
+Verify the CLI is available:
+
+```bash
+command -v opensteer >/dev/null 2>&1 && echo "ok" || echo "opensteer not found"
+```
+
+For cloud recording, verify environment variables are set:
+
+```bash
+test -n "$OPENSTEER_BASE_URL" && test -n "$OPENSTEER_API_KEY" && test -n "$OPENSTEER_CLOUD_APP_BASE_URL" && echo "ok" || echo "missing cloud env vars"
+```
 
 ## Quick Start
 
@@ -29,56 +35,45 @@ Cloud recording:
 opensteer record --provider cloud --workspace <id> --url <url>
 ```
 
-Cloud recording requires:
-
-- `OPENSTEER_BASE_URL`
-- `OPENSTEER_API_KEY`
-- `OPENSTEER_CLOUD_APP_BASE_URL`
-
 ## Mode Selection
 
-- Use `provider=local` when the user wants to interact with a local Playwright browser window.
-- Use `provider=cloud` when the user wants to interact through the cloud browser session UI.
-- Keep local recording on the default headed persistent browser flow.
-- In cloud mode, do not force `headless=false`. Use the normal cloud launch behavior unless the user explicitly overrides it.
+- Use `provider=local` when the user wants to interact with a local Playwright browser window. Local requires a headed, persistent browser. Do not pass `--headless true`.
+- Use `provider=cloud` when the user wants to interact through the cloud browser session UI. Do not force `headless=false` in cloud mode. Cloud does not support `browser.mode="attach"`.
 
 ## Workflow
 
-1. Start the recorder with `opensteer record`.
-2. If the provider is `cloud`, give the user the browser session URL printed by the CLI.
+1. Run `opensteer record --workspace <id> --url <url>` (add `--provider cloud` for cloud).
+2. If cloud, give the user the browser session URL printed by the CLI.
 3. Tell the user to perform the workflow manually.
 4. Tell the user exactly how to stop:
-   - local: click the injected `Stop recording` button in the browser page
-   - cloud: click `Stop recording` in the browser session toolbar UI
-5. Wait for the recorder process to finish. Do not assume recording is complete just because the browser URL was printed.
-6. Only after the CLI exits, read the generated script from disk and inspect what was captured.
-7. If the user wants verification, rerun the generated script instead of only reviewing the file.
-
-## Guardrails
+   - Local: click the injected **Stop recording** button in the browser page.
+   - Cloud: click **Stop recording** in the browser session toolbar UI.
+5. Keep the `record` command alive while the user is recording. Do not interrupt it. Do not stop with `Ctrl+C` unless the user explicitly wants to abort.
+6. Wait for the CLI process to exit. Do not assume recording is complete just because the browser URL was printed.
+7. Verify the output file exists at `.opensteer/workspaces/<id>/recorded-flow.ts` (or the `--output` path if specified).
+8. Read and summarize the generated script before editing it.
+9. If the user wants verification, replay the script: `npx tsx <path-to-recorded-flow.ts>`.
 
-- Recording requires `engine=playwright`.
-- Local recording only supports a persistent browser.
-- Local recording requires a headed browser. Do not pass `--headless true` in local mode.
-- Cloud recording does not support `browser.mode="attach"`.
-- Do not stop recording with `Ctrl+C` unless the user explicitly wants to abort the run.
-- Do not use removed timeout flags such as `--record-timeout-ms`.
-- If a launch argument value starts with `--`, pass it as `--arg=...`, not `--arg ...`.
-- If the flow depends on recorder limits such as iframes, file upload, drag-and-drop, or canvas behavior, read the reference file before promising support.
+## Limitations
 
-## Output Contract
+The recorder captures clicks, text entry, key presses, scrolling, select changes, navigation, and multi-tab operations. It does not fully support:
 
-- Default output path: `.opensteer/workspaces/<id>/recorded-flow.ts`
-- The CLI writes the replay script locally after recording completes in both local and cloud modes.
-- Generated scripts use the public Opensteer SDK surface. Cloud recordings bootstrap `provider.mode = "cloud"` and local recordings bootstrap the workspace-backed local flow.
+- Cross-origin iframes (not recorded)
+- Shadow DOM selectors (best effort)
+- File uploads, drag-and-drop, and canvas interactions
+- Browser back/forward detection (may fall back to direct navigation replay)
 
-## Agent Guidance
+## Rules
 
-- Keep the `record` command alive while the user is recording.
-- If the user is actively driving the session, avoid mixing in extra agent actions unless they explicitly ask for help recording a combined flow.
-- After recording completes, summarize the captured flow before editing it.
-- If replay fails, debug the generated script and rerun it instead of re-recording immediately.
+- Recording requires `engine=playwright`.
+- Do not use removed timeout flags such as `--record-timeout-ms`.
+- If a launch argument value starts with `--`, pass it as `--arg=...`, not `--arg ...`.
+- Do not mix in extra agent actions while the user is recording unless they explicitly ask.
+- If replay fails, debug and fix the generated script rather than re-recording immediately.
 
-## References
+## Troubleshooting
 
-- [Recorder Reference](references/recorder-reference.md)
-- [Opensteer Skill](../opensteer/SKILL.md)
+- **Recorder fails to start**: verify the workspace ID is valid and the browser engine is playwright.
+- **CLI exits with an error**: read stderr for the error message before retrying.
+- **Generated script has errors**: inspect and fix the script rather than re-recording.
+- **Output file missing**: check if the user stopped recording correctly (button click, not Ctrl+C).