Core Concepts
Selector Cache
Local selector cache model, namespace partitioning, and cloud cache import behavior.
Selectors are stored under:
.opensteer/selectors/<namespace>
Each namespace contains:
index.json: selector registry metadata<descriptor-id>.json: persisted descriptor records
Each descriptor stores:
- action/extraction method
description- persisted DOM path (stable attributes + fallback hints)
- metadata (
createdAt,updatedAt, optionalsourceUrl)
During replay, Opensteer resolves in this order:
- Persisted path by
description - Live DOM
elementcounter - Explicit CSS
selector - Built-in LLM resolution
When resolution succeeds through steps 2-4 and description is present, the
resolved path is persisted for future runs.
Control API Contract
POST /v1/sessionsGET /v1/sessions/:sessionIdDELETE /v1/sessions/:sessionIdPOST /v1/sessions/:sessionId/accessPOST /selector-cache/import
POST /v1/sessions returns a semantic session descriptor: { sessionId, status, baseUrl }.
Attach-only browser grants are issued later with POST /v1/sessions/:sessionId/access.
Covered Features
api:POST /selector-cache/importsdk:extractsdk:extractFromPlan
