opensteer 0.8.0 → 0.8.2

package/dist/index.js

@@ -1,5 +1,5 @@
-import { resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager, OpensteerRuntime } from './chunk-2UMBR4XO.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, STABLE_PRIMARY_ATTR_KEYS, buildArrayFieldPathCandidates, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomRuntime, createFilesystemOpensteerWorkspace, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hasPersistedCloudSession, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, normalizeExtractedValue, normalizeOpensteerEngineName, normalizeOpensteerExecutionMode, normalizeWorkspaceId, readPersistedCloudSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveOpensteerEngineName, resolveOpensteerExecutionMode, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath } from './chunk-2UMBR4XO.js';
+import { resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager, OpensteerRuntime } from './chunk-X3G6QSCF.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, STABLE_PRIMARY_ATTR_KEYS, buildArrayFieldPathCandidates, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomRuntime, createFilesystemOpensteerWorkspace, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hasPersistedCloudSession, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, normalizeExtractedValue, normalizeOpensteerEngineName, normalizeOpensteerExecutionMode, normalizeWorkspaceId, readPersistedCloudSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveOpensteerEngineName, resolveOpensteerExecutionMode, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath } from './chunk-X3G6QSCF.js';
 
 // src/sdk/opensteer.ts
 var Opensteer = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensteer",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Opensteer browser automation, replay, and reverse-engineering toolkit.",
   "license": "MIT",
   "type": "module",
@@ -69,10 +69,10 @@
     }
   },
   "devDependencies": {
-    "@opensteer/engine-abp": "0.8.0",
     "@opensteer/browser-core": "0.7.0",
-    "@opensteer/protocol": "0.7.0",
-    "@opensteer/cloud-contracts": "0.7.0"
+    "@opensteer/cloud-contracts": "0.7.0",
+    "@opensteer/engine-abp": "0.8.0",
+    "@opensteer/protocol": "0.7.0"
   },
   "scripts": {
     "build": "tsup && node ../../scripts/sync-package-skills.mjs",

package/skills/README.md

@@ -1,6 +1,6 @@
 # Opensteer Skills
 
-First-party Opensteer skills published from this repository for agents that use the upstream [`skills`](https://skills.sh) ecosystem.
+First-party Opensteer skills published from this repository. Install them through the upstream [`skills`](https://skills.sh) CLI into Claude Code, Codex, and other compatible agents.
 
 ## Install
 
@@ -8,6 +8,18 @@ First-party Opensteer skills published from this repository for agents that use
 opensteer skills install
 ```
 
+Install into Claude Code explicitly:
+
+```bash
+opensteer skills install --agent claude-code
+```
+
+List the packaged skills without installing them:
+
+```bash
+opensteer skills install --list
+```
+
 ## Available Skills
 
 - `opensteer`: workspace-backed browser automation, structured DOM extraction, and browser-backed request replay with the Opensteer CLI and SDK

package/skills/opensteer/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: opensteer
-description: "Workspace-backed browser automation, structured DOM extraction, and browser-backed request replay with the Opensteer CLI and SDK. Use when a task needs a real Chromium session, persistent browser state in a repo workspace, descriptor-backed DOM actions or extraction, or captured request plans and recipes."
+description: "Handles Opensteer browser automation, structured DOM extraction, and browser-backed request replay with the Opensteer CLI and SDK. Use when the user mentions Opensteer, browser automation, real Chromium sessions, persistent workspace browser state, descriptor-backed DOM actions or extraction, request plans, recipes, or browser-backed API replay."
+argument-hint: "[goal]"
 ---
 
 # Opensteer
 
+If invoked directly, treat `$ARGUMENTS` as the concrete browser or replay goal. First decide whether the task is primarily DOM automation, request capture/replay, or workspace browser administration.
+
 Use this skill when a task needs a real browser workflow, persistent workspace browser state, structured DOM extraction, or browser-backed request replay.
 
 Choose the reference that matches the job:
@@ -13,6 +16,12 @@ Choose the reference that matches the job:
 - SDK automation and reusable code: [references/sdk-reference.md](references/sdk-reference.md)
 - Request capture, plans, and recipes: [references/request-workflow.md](references/request-workflow.md)
 
+## Startup Checks
+
+- Verify `opensteer` is available in the repo or on `PATH` before planning the workflow.
+- If Chromium binaries are missing, install them through Playwright before debugging page behavior.
+- Reuse an existing workspace id for the same site or feature when one already exists.
+
 ## Mental Model
 
 - `workspace` / `--workspace` is the durable unit of state. Persistent workspaces live under `.opensteer/workspaces/<id>`.
@@ -31,7 +40,6 @@ Choose the reference that matches the job:
 
 ## Shared Rules
 
-- Keep one stable workspace id per site or feature.
 - Use `snapshot("action")` or `snapshot action` before counter-based `element` targets.
 - Re-snapshot after navigation or DOM-changing actions before reusing element counters.
 - In the SDK, `selector + description` or `element + description` persists a DOM action descriptor. `description` alone reuses it later.

package/skills/opensteer/references/cli-reference.md

@@ -2,6 +2,14 @@
 
 Use the CLI when you need a fast JSON-first loop against a repo-local workspace browser.
 
+## Sections
+
+- [Quickstart](#quickstart)
+- [Browser Lifecycle And Profile Cloning](#browser-lifecycle-and-profile-cloning)
+- [Browser Modes](#browser-modes)
+- [Advanced Semantic Operations](#advanced-semantic-operations)
+- [Extraction Schema Examples](#extraction-schema-examples)
+
 ## Quickstart
 
 ```bash

package/skills/opensteer/references/request-workflow.md

@@ -2,6 +2,17 @@
 
 Use this workflow when the deliverable is a custom API, a replayable request plan, or a lower-overhead path than full browser automation.
 
+## Sections
+
+- [Standard Loop](#standard-loop)
+- [Transport Selection](#transport-selection)
+- [SDK Flow](#sdk-flow)
+- [CLI Equivalents](#cli-equivalents)
+- [Transport Probing](#transport-probing)
+- [Auth Token Acquisition](#auth-token-acquisition)
+- [Input Formats](#input-formats)
+- [Practical Guidance](#practical-guidance)
+
 ## Standard Loop
 
 1. Trigger the real browser action that causes the request inside a stable workspace.

package/skills/opensteer/references/sdk-reference.md

@@ -2,6 +2,15 @@
 
 Use the SDK when the workflow should become reusable TypeScript code in the repository.
 
+## Sections
+
+- [Construction](#construction)
+- [DOM Automation And Extraction](#dom-automation-and-extraction)
+- [Browser Admin](#browser-admin)
+- [Request Capture, Plans, And Recipes](#request-capture-plans-and-recipes)
+- [Common Methods](#common-methods)
+- [Rules](#rules)
+
 ## Construction
 
 ```ts