opensteer 0.8.11 → 0.8.12

package/dist/index.js

@@ -1,5 +1,5 @@
-import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-33FDEOQY.js';
-export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-33FDEOQY.js';
+import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-AXTKKAPW.js';
+export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-AXTKKAPW.js';
 
 // src/sdk/opensteer.ts
 var Opensteer = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensteer",
-  "version": "0.8.11",
+  "version": "0.8.12",
   "description": "Opensteer browser automation, replay, and reverse-engineering toolkit.",
   "license": "MIT",
   "type": "module",
@@ -56,14 +56,14 @@
     "sharp": "^0.34.5",
     "skills": "^1.4.6",
     "ws": "^8.18.0",
-    "@opensteer/engine-playwright": "0.8.3",
-    "@opensteer/runtime-core": "0.1.3"
+    "@opensteer/engine-playwright": "0.8.4",
+    "@opensteer/runtime-core": "0.1.4"
   },
   "optionalDependencies": {
     "webcrack": "^2.15.1"
   },
   "peerDependencies": {
-    "@opensteer/engine-abp": "0.8.4"
+    "@opensteer/engine-abp": "0.8.5"
   },
   "peerDependenciesMeta": {
     "@opensteer/engine-abp": {
@@ -71,9 +71,9 @@
     }
   },
   "devDependencies": {
-    "@opensteer/browser-core": "0.7.3",
-    "@opensteer/engine-abp": "0.8.4",
-    "@opensteer/protocol": "0.7.3"
+    "@opensteer/browser-core": "0.7.4",
+    "@opensteer/engine-abp": "0.8.5",
+    "@opensteer/protocol": "0.7.4"
   },
   "scripts": {
     "build": "tsup && node ../../scripts/sync-package-skills.mjs",

package/skills/recorder/SKILL.md

@@ -1,52 +1,82 @@
 ---
 name: recorder
-description: "Use when the user wants to record a live browser workflow and turn it into a deterministic Opensteer replay script. Prefer this for manual browser capture, multi-tab flow recording, and agent-guided record-and-replay setup with the Opensteer CLI."
+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]"
 ---
 
 # Recorder
 
-Use the Opensteer recorder to open a headed local Playwright browser, capture DOM-level actions, and write a replayable TypeScript script.
+Use the Opensteer recorder when the user wants to perform a real browser flow manually and save it as a deterministic replay script.
 
-## When to use
+## Inputs
 
-- Record a real browser flow for later replay.
-- Turn a manual QA walkthrough into Opensteer SDK code.
-- Capture a multi-tab browsing session as a starting point for automation.
+- `url`: starting URL to open
+- `workspace`: target Opensteer workspace id
+- `provider`: `local` or `cloud`
+- optional `output`: explicit output path
 
-## Quick start
+## Quick Start
+
+Local recording:
 
 ```bash
 opensteer record --workspace <id> --url <url>
-opensteer record --workspace <id> --url <url> --output <path>
 ```
 
-1. Start recording with `opensteer record --workspace <id> --url <url>`.
-2. Perform the workflow in the headed browser.
-3. Stop recording with the injected `Stop recording` button in the browser.
-4. Wait for the CLI to write the script path and close the browser session.
-5. Inspect the generated file before replaying or editing it.
+Cloud recording:
+
+```bash
+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.
+
+## 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.
+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
 
-- Recording requires `provider=local`.
 - Recording requires `engine=playwright`.
-- Recording always uses a headed persistent browser for the target workspace.
-- Stopping is browser-driven. Do not rely on `Ctrl+C` or removed timeout flags.
+- 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.
 
-## Output
+## Output Contract
 
 - Default output path: `.opensteer/workspaces/<id>/recorded-flow.ts`
-- The generated script imports `Opensteer` from `opensteer`.
-- Replay uses public SDK methods such as `open`, `goto`, `click`, `input`, `scroll`, `newPage`, `closePage`, `activatePage`, and `evaluate`.
+- 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.
 
-## Agent workflow
+## Agent Guidance
 
-- Use the browser stop button as the primary stop path.
-- After recording, read the generated script and summarize what was captured before changing it.
-- If the user asks for replay verification, run the generated script instead of only inspecting the file.
-- If the flow depends on recorder limits such as iframes or file upload, read the reference file before promising support.
+- 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.
 
 ## References