opensteer 0.8.4 → 0.8.6

package/dist/cli/bin.cjs

@@ -49,6 +49,9 @@ var prettier__namespace = /*#__PURE__*/_interopNamespace(prettier);
 var vm__default = /*#__PURE__*/_interopDefault(vm);
 var WebSocket2__default = /*#__PURE__*/_interopDefault(WebSocket2);
 
+// package.json
+var package_default = {
+  version: "0.8.6"};
 util.promisify(child_process.execFile);
 Math.floor(Date.now() - process.uptime() * 1e3);
 ({ ...process.env});
@@ -8949,101 +8952,20 @@ function createReverseReportRegistry(rootPath) {
 }
 var TAG_DELIMITER = "";
 var NODE_SQLITE_SPECIFIER = `node:${"sqlite"}`;
+var SAVED_NETWORK_SQLITE_SUPPORT_ERROR = "Saved-network operations require Node's built-in SQLite support. Use a Node runtime with node:sqlite enabled.";
 var SqliteSavedNetworkStore = class {
   databasePath;
   database;
+  directoryInitialization;
+  databaseInitialization;
   constructor(rootPath) {
     this.databasePath = path6__default.default.join(rootPath, "registry", "saved-network.sqlite");
   }
   async initialize() {
-    await ensureDirectory(path6__default.default.dirname(this.databasePath));
-    const { DatabaseSync } = await import(NODE_SQLITE_SPECIFIER);
-    const database = new DatabaseSync(this.databasePath);
-    database.exec("PRAGMA journal_mode = WAL");
-    database.exec("PRAGMA foreign_keys = ON");
-    database.exec(`
-      CREATE TABLE IF NOT EXISTS saved_network_records (
-        record_id TEXT PRIMARY KEY,
-        request_id TEXT NOT NULL,
-        session_ref TEXT NOT NULL,
-        page_ref TEXT,
-        page_ref_key TEXT NOT NULL,
-        frame_ref TEXT,
-        document_ref TEXT,
-        action_id TEXT,
-        method TEXT NOT NULL,
-        method_lc TEXT NOT NULL,
-        url TEXT NOT NULL,
-        url_lc TEXT NOT NULL,
-        hostname TEXT NOT NULL,
-        hostname_lc TEXT NOT NULL,
-        path TEXT NOT NULL,
-        path_lc TEXT NOT NULL,
-        status INTEGER,
-        status_text TEXT,
-        resource_type TEXT NOT NULL,
-        navigation_request INTEGER NOT NULL,
-        request_headers_json TEXT NOT NULL,
-        response_headers_json TEXT NOT NULL,
-        request_body_json TEXT,
-        response_body_json TEXT,
-        initiator_json TEXT,
-        timing_json TEXT,
-        transfer_json TEXT,
-        source_json TEXT,
-        capture_state TEXT NOT NULL,
-        request_body_state TEXT NOT NULL,
-        response_body_state TEXT NOT NULL,
-        request_body_skip_reason TEXT,
-        response_body_skip_reason TEXT,
-        request_body_error TEXT,
-        response_body_error TEXT,
-        redirect_from_request_id TEXT,
-        redirect_to_request_id TEXT,
-        saved_at INTEGER NOT NULL
-      );
-
-      CREATE UNIQUE INDEX IF NOT EXISTS saved_network_records_scope_request
-        ON saved_network_records (session_ref, page_ref_key, request_id);
-
-      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
-        ON saved_network_records (saved_at DESC);
-
-      CREATE TABLE IF NOT EXISTS saved_network_tags (
-        record_id TEXT NOT NULL REFERENCES saved_network_records(record_id) ON DELETE CASCADE,
-        tag TEXT NOT NULL,
-        PRIMARY KEY (record_id, tag)
-      );
-
-      CREATE INDEX IF NOT EXISTS saved_network_tags_tag
-        ON saved_network_tags (tag);
-    `);
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "capture_state",
-      "TEXT NOT NULL DEFAULT 'complete'"
-    );
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "request_body_state",
-      "TEXT NOT NULL DEFAULT 'skipped'"
-    );
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "response_body_state",
-      "TEXT NOT NULL DEFAULT 'skipped'"
-    );
-    this.ensureColumn(database, "saved_network_records", "request_body_skip_reason", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "response_body_skip_reason", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "request_body_error", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "response_body_error", "TEXT");
-    this.database = database;
+    await this.ensureDatabaseDirectory();
   }
   async save(records, tag) {
-    const database = this.requireDatabase();
+    const database = await this.requireDatabase();
     const readExisting = database.prepare(`
         SELECT record_id
         FROM saved_network_records
@@ -9235,7 +9157,7 @@ var SqliteSavedNetworkStore = class {
     });
   }
   async query(input = {}) {
-    const database = this.requireDatabase();
+    const database = await this.requireDatabase();
     const limit = Math.max(1, Math.min(input.limit ?? 50, 200));
     const { whereSql, parameters } = buildSavedNetworkWhere(input);
     const rows = database.prepare(
@@ -9266,7 +9188,7 @@ var SqliteSavedNetworkStore = class {
     return record;
   }
   async clear(input = {}) {
-    const database = this.requireDatabase();
+    const database = await this.requireDatabase();
     const countAll = database.prepare(`
       SELECT COUNT(*) AS cleared
       FROM saved_network_records
@@ -9303,11 +9225,127 @@ var SqliteSavedNetworkStore = class {
       return cleared;
     });
   }
-  requireDatabase() {
-    if (!this.database) {
-      throw new Error("saved network store is not initialized");
+  async requireDatabase() {
+    if (this.database) {
+      return this.database;
+    }
+    this.databaseInitialization ??= this.openDatabase();
+    try {
+      return await this.databaseInitialization;
+    } catch (error) {
+      this.databaseInitialization = void 0;
+      throw error;
+    }
+  }
+  async openDatabase() {
+    await this.ensureDatabaseDirectory();
+    let DatabaseSync;
+    try {
+      ({ DatabaseSync } = await import(NODE_SQLITE_SPECIFIER));
+    } catch (error) {
+      throw normalizeSqliteImportError(error);
+    }
+    const database = new DatabaseSync(this.databasePath);
+    try {
+      this.configureDatabase(database);
+      this.database = database;
+      return database;
+    } catch (error) {
+      closeSqliteDatabase(database);
+      throw error;
     }
-    return this.database;
+  }
+  async ensureDatabaseDirectory() {
+    this.directoryInitialization ??= ensureDirectory(path6__default.default.dirname(this.databasePath)).catch(
+      (error) => {
+        this.directoryInitialization = void 0;
+        throw error;
+      }
+    );
+    await this.directoryInitialization;
+  }
+  configureDatabase(database) {
+    database.exec("PRAGMA journal_mode = WAL");
+    database.exec("PRAGMA foreign_keys = ON");
+    database.exec(`
+      CREATE TABLE IF NOT EXISTS saved_network_records (
+        record_id TEXT PRIMARY KEY,
+        request_id TEXT NOT NULL,
+        session_ref TEXT NOT NULL,
+        page_ref TEXT,
+        page_ref_key TEXT NOT NULL,
+        frame_ref TEXT,
+        document_ref TEXT,
+        action_id TEXT,
+        method TEXT NOT NULL,
+        method_lc TEXT NOT NULL,
+        url TEXT NOT NULL,
+        url_lc TEXT NOT NULL,
+        hostname TEXT NOT NULL,
+        hostname_lc TEXT NOT NULL,
+        path TEXT NOT NULL,
+        path_lc TEXT NOT NULL,
+        status INTEGER,
+        status_text TEXT,
+        resource_type TEXT NOT NULL,
+        navigation_request INTEGER NOT NULL,
+        request_headers_json TEXT NOT NULL,
+        response_headers_json TEXT NOT NULL,
+        request_body_json TEXT,
+        response_body_json TEXT,
+        initiator_json TEXT,
+        timing_json TEXT,
+        transfer_json TEXT,
+        source_json TEXT,
+        capture_state TEXT NOT NULL,
+        request_body_state TEXT NOT NULL,
+        response_body_state TEXT NOT NULL,
+        request_body_skip_reason TEXT,
+        response_body_skip_reason TEXT,
+        request_body_error TEXT,
+        response_body_error TEXT,
+        redirect_from_request_id TEXT,
+        redirect_to_request_id TEXT,
+        saved_at INTEGER NOT NULL
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS saved_network_records_scope_request
+        ON saved_network_records (session_ref, page_ref_key, request_id);
+
+      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
+        ON saved_network_records (saved_at DESC);
+
+      CREATE TABLE IF NOT EXISTS saved_network_tags (
+        record_id TEXT NOT NULL REFERENCES saved_network_records(record_id) ON DELETE CASCADE,
+        tag TEXT NOT NULL,
+        PRIMARY KEY (record_id, tag)
+      );
+
+      CREATE INDEX IF NOT EXISTS saved_network_tags_tag
+        ON saved_network_tags (tag);
+    `);
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "capture_state",
+      "TEXT NOT NULL DEFAULT 'complete'"
+    );
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "request_body_state",
+      "TEXT NOT NULL DEFAULT 'skipped'"
+    );
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "response_body_state",
+      "TEXT NOT NULL DEFAULT 'skipped'"
+    );
+    this.ensureColumn(database, "saved_network_records", "request_body_skip_reason", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "response_body_skip_reason", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "request_body_error", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "response_body_error", "TEXT");
   }
   ensureColumn(database, table, column, definition) {
     const rows = database.prepare(`PRAGMA table_info(${table})`).all();
@@ -9452,6 +9490,20 @@ function inflateSavedNetworkRow(row, includeBodies) {
 function stringifyOptional(value) {
   return value === void 0 ? null : JSON.stringify(value);
 }
+function normalizeSqliteImportError(error) {
+  if (error instanceof Error && error.code === "ERR_UNKNOWN_BUILTIN_MODULE" && error.message.includes(NODE_SQLITE_SPECIFIER)) {
+    return new Error(SAVED_NETWORK_SQLITE_SUPPORT_ERROR, {
+      cause: error
+    });
+  }
+  return error instanceof Error ? error : new Error(String(error));
+}
+function closeSqliteDatabase(database) {
+  try {
+    database.close();
+  } catch {
+  }
+}
 function withSqliteTransaction(database, task) {
   database.exec("BEGIN IMMEDIATE");
   try {
@@ -11093,7 +11145,7 @@ function resolveSelectedSkills(options) {
 }
 
 // src/provider/config.ts
-var OPENSTEER_PROVIDER_KINDS = ["local", "cloud"];
+var OPENSTEER_PROVIDER_MODES = ["local", "cloud"];
 function assertProviderSupportsEngine(provider, engine) {
   if (engine !== "abp") {
     return;
@@ -11104,30 +11156,30 @@ function assertProviderSupportsEngine(provider, engine) {
     );
   }
 }
-function normalizeOpensteerProviderKind(value, source = "OPENSTEER_PROVIDER") {
+function normalizeOpensteerProviderMode(value, source = "OPENSTEER_PROVIDER") {
   const normalized = value.trim().toLowerCase();
-  if (normalized === OPENSTEER_PROVIDER_KINDS[0] || normalized === OPENSTEER_PROVIDER_KINDS[1]) {
+  if (normalized === OPENSTEER_PROVIDER_MODES[0] || normalized === OPENSTEER_PROVIDER_MODES[1]) {
     return normalized;
   }
   throw new Error(
-    `${source} must be one of ${OPENSTEER_PROVIDER_KINDS.join(", ")}; received "${value}".`
+    `${source} must be one of ${OPENSTEER_PROVIDER_MODES.join(", ")}; received "${value}".`
   );
 }
 function resolveOpensteerProvider(input = {}) {
   if (input.provider) {
     return {
-      kind: input.provider.kind,
+      mode: input.provider.mode,
       source: "explicit"
     };
   }
   if (input.environmentProvider !== void 0 && input.environmentProvider.trim().length > 0) {
     return {
-      kind: normalizeOpensteerProviderKind(input.environmentProvider),
+      mode: normalizeOpensteerProviderMode(input.environmentProvider),
       source: "env"
     };
   }
   return {
-    kind: "local",
+    mode: "local",
     source: "default"
   };
 }
@@ -11781,6 +11833,13 @@ var OpensteerCloudClient = class {
     });
     return await response.json();
   }
+  async importDescriptors(entries) {
+    const response = await this.request("/registry/descriptors/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
   async importRequestPlans(entries) {
     const response = await this.request("/registry/request-plans/import", {
       method: "POST",
@@ -11876,10 +11935,10 @@ function resolveCloudConfig(input = {}) {
     ...input.provider === void 0 ? {} : { provider: input.provider },
     ...input.environmentProvider === void 0 ? {} : { environmentProvider: input.environmentProvider }
   });
-  if (provider.kind !== "cloud") {
+  if (provider.mode !== "cloud") {
     return void 0;
   }
-  const cloudProvider = input.provider?.kind === "cloud" ? input.provider : void 0;
+  const cloudProvider = input.provider?.mode === "cloud" ? input.provider : void 0;
   const apiKey = cloudProvider?.apiKey ?? process.env.OPENSTEER_API_KEY;
   if (!apiKey || apiKey.trim().length === 0) {
     throw new Error("provider=cloud requires OPENSTEER_API_KEY or provider.apiKey.");
@@ -11896,11 +11955,11 @@ function resolveCloudConfig(input = {}) {
 }
 
 // ../runtime-core/package.json
-var package_default = {
-  version: "0.1.0"};
+var package_default2 = {
+  version: "0.1.1"};
 
 // ../runtime-core/src/version.ts
-var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
+var OPENSTEER_RUNTIME_CORE_VERSION = package_default2.version;
 
 // ../runtime-core/src/internal/errors.ts
 function normalizeThrownOpensteerError(error, fallbackMessage) {
@@ -11971,8 +12030,74 @@ var defaultSnapshotSettleObserver = {
   }
 };
 Object.freeze(defaultSnapshotSettleObserver);
+var DOM_ACTION_VISUAL_STABILITY_PROFILES = {
+  "dom.click": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.input": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.scroll": { settleMs: 600, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.hover": { settleMs: 200, scope: "main-frame", timeoutMs: 2500 }
+};
+var DEFAULT_DOM_ACTION_VISUAL_STABILITY_PROFILE = {
+  settleMs: 750,
+  scope: "visible-frames",
+  timeoutMs: 7e3
+};
+var NAVIGATION_VISUAL_STABILITY_PROFILE = {
+  settleMs: 750,
+  scope: "visible-frames",
+  timeoutMs: 7e3
+};
+var defaultDomActionSettleObserver = {
+  async settle(input) {
+    if (input.trigger !== "dom-action") {
+      return false;
+    }
+    const profile = DOM_ACTION_VISUAL_STABILITY_PROFILES[input.operation] ?? DEFAULT_DOM_ACTION_VISUAL_STABILITY_PROFILE;
+    const effectiveTimeout = input.remainingMs === void 0 ? profile.timeoutMs : Math.min(profile.timeoutMs, input.remainingMs);
+    if (effectiveTimeout <= 0) {
+      return false;
+    }
+    try {
+      await input.engine.waitForVisualStability({
+        pageRef: input.pageRef,
+        timeoutMs: effectiveTimeout,
+        settleMs: profile.settleMs,
+        scope: profile.scope
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+Object.freeze(defaultDomActionSettleObserver);
+var defaultNavigationSettleObserver = {
+  async settle(input) {
+    if (input.trigger !== "navigation") {
+      return false;
+    }
+    const profile = NAVIGATION_VISUAL_STABILITY_PROFILE;
+    const effectiveTimeout = input.remainingMs === void 0 ? profile.timeoutMs : Math.min(profile.timeoutMs, input.remainingMs);
+    if (effectiveTimeout <= 0) {
+      return false;
+    }
+    try {
+      await input.engine.waitForVisualStability({
+        pageRef: input.pageRef,
+        timeoutMs: effectiveTimeout,
+        settleMs: profile.settleMs,
+        scope: profile.scope
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+Object.freeze(defaultNavigationSettleObserver);
 var DEFAULT_SETTLE_OBSERVERS = Object.freeze([
-  defaultSnapshotSettleObserver
+  defaultSnapshotSettleObserver,
+  defaultDomActionSettleObserver,
+  defaultNavigationSettleObserver
 ]);
 var defaultTimeoutPolicy = {
   resolveTimeoutMs(input) {
@@ -20192,7 +20317,6 @@ async function compileOpensteerExtractionFieldTargets(options) {
   await collectFieldTargetsFromSchemaObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    latestSnapshotCounters: options.latestSnapshotCounters,
     value: options.schema,
     path: "",
     fields,
@@ -20210,22 +20334,11 @@ async function extractOpensteerExtractionFieldTargets(options) {
           source: "current_url"
         };
       }
-      if ("path" in field) {
-        return {
-          key: field.key,
-          target: {
-            kind: "path",
-            path: field.path
-          },
-          ...field.attribute === void 0 ? {} : { attribute: field.attribute }
-        };
-      }
       return {
         key: field.key,
         target: {
-          kind: "live",
-          locator: field.locator,
-          anchor: field.anchor
+          kind: "path",
+          path: field.path
         },
         ...field.attribute === void 0 ? {} : { attribute: field.attribute }
       };
@@ -20234,8 +20347,6 @@ async function extractOpensteerExtractionFieldTargets(options) {
 }
 async function compilePersistedOpensteerExtractionPayloadFromFieldTargets(options) {
   const fields = await resolvePersistableFieldTargets({
-    pageRef: options.pageRef,
-    dom: options.dom,
     fieldTargets: options.fieldTargets
   });
   const payload = buildPersistedOpensteerExtractionPayload(fields);
@@ -20267,7 +20378,6 @@ async function collectFieldTargetsFromSchemaObject(options) {
     await collectFieldTargetsFromSchemaValue({
       dom: options.dom,
       pageRef: options.pageRef,
-      latestSnapshotCounters: options.latestSnapshotCounters,
       value: childValue,
       path: joinDataPath(options.path, normalizedKey),
       fields: options.fields,
@@ -20282,7 +20392,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
       await compileFieldTarget({
         dom: options.dom,
         pageRef: options.pageRef,
-        latestSnapshotCounters: options.latestSnapshotCounters,
         field: normalizedField,
         path: options.path
       })
@@ -20311,7 +20420,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
       await collectFieldTargetsFromSchemaObject({
         dom: options.dom,
         pageRef: options.pageRef,
-        latestSnapshotCounters: options.latestSnapshotCounters,
         value: itemValue,
         path: appendDataPathIndex(options.path, index),
         fields: options.fields,
@@ -20334,7 +20442,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
   await collectFieldTargetsFromSchemaObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    latestSnapshotCounters: options.latestSnapshotCounters,
     value: options.value,
     path: options.path,
     fields: options.fields,
@@ -20361,10 +20468,10 @@ async function compileFieldTarget(options) {
   }
   return {
     key: options.path,
-    ...await resolveLiveFieldTarget({
-      latestSnapshotCounters: options.latestSnapshotCounters,
-      field: options.field,
-      path: options.path
+    path: await resolveSelectorFieldPath({
+      dom: options.dom,
+      pageRef: options.pageRef,
+      selector: `[c="${String(options.field.element)}"]`
     }),
     ...options.field.attribute === void 0 ? {} : { attribute: options.field.attribute }
   };
@@ -20382,24 +20489,6 @@ async function resolveSelectorFieldPath(options) {
     locator: resolved.locator
   });
 }
-async function resolveLiveFieldTarget(options) {
-  const counters = options.latestSnapshotCounters;
-  if (counters === void 0) {
-    throw new Error(
-      `Extraction schema field "${labelForPath(options.path)}" uses element ${String(options.field.element)} but no snapshot is available.`
-    );
-  }
-  const counter = counters.get(options.field.element);
-  if (!counter) {
-    throw new Error(
-      `Extraction schema field "${labelForPath(options.path)}" references missing counter ${String(options.field.element)}.`
-    );
-  }
-  return {
-    locator: counter.locator,
-    anchor: counter.anchor
-  };
-}
 async function resolvePersistableFieldTargets(options) {
   const fields = [];
   for (const field of options.fieldTargets) {
@@ -20410,29 +20499,9 @@ async function resolvePersistableFieldTargets(options) {
       });
       continue;
     }
-    if ("path" in field) {
-      fields.push({
-        key: field.key,
-        path: sanitizeElementPath(field.path),
-        ...field.attribute === void 0 ? {} : { attribute: field.attribute }
-      });
-      continue;
-    }
-    const resolved = await options.dom.resolveTarget({
-      pageRef: options.pageRef,
-      method: "extract",
-      target: {
-        kind: "live",
-        locator: field.locator,
-        anchor: field.anchor
-      }
-    });
-    const path16 = resolved.replayPath ?? await options.dom.buildPath({
-      locator: resolved.locator
-    });
     fields.push({
       key: field.key,
-      path: sanitizeElementPath(path16),
+      path: sanitizeElementPath(field.path),
       ...field.attribute === void 0 ? {} : { attribute: field.attribute }
     });
   }
@@ -21573,8 +21642,7 @@ async function compileOpensteerSnapshot(options) {
     title: pageInfo.title,
     mode: options.mode,
     html: dense.html,
-    counters: [...dense.counterRecords.values()].map(toPublicCounterRecord),
-    counterRecords: dense.counterRecords
+    counters: [...dense.counterRecords.values()].map(toPublicCounterRecord)
   };
 }
 async function getMainDocumentSnapshot(engine, pageRef) {
@@ -23193,6 +23261,7 @@ var OpensteerSessionRuntime = class {
   engineFactory;
   policy;
   injectedDescriptorStore;
+  injectedExtractionDescriptorStore;
   registryOverrides;
   cleanupRootOnClose;
   sessionInfoBase;
@@ -23205,7 +23274,6 @@ var OpensteerSessionRuntime = class {
   sessionRef;
   pageRef;
   runId;
-  latestSnapshot;
   backgroundNetworkPersistence = /* @__PURE__ */ new Set();
   cookieJars = /* @__PURE__ */ new Map();
   recipeCache = /* @__PURE__ */ new Map();
@@ -23219,6 +23287,7 @@ var OpensteerSessionRuntime = class {
     this.engineFactory = options.engineFactory;
     this.policy = options.policy ?? defaultPolicy();
     this.injectedDescriptorStore = options.descriptorStore;
+    this.injectedExtractionDescriptorStore = options.extractionDescriptorStore;
     this.registryOverrides = options.registryOverrides;
     this.cleanupRootOnClose = options.cleanupRootOnClose ?? options.workspace === void 0;
     this.sessionInfoBase = options.sessionInfo ?? {};
@@ -23230,7 +23299,7 @@ var OpensteerSessionRuntime = class {
     const base = this.sessionInfoBase;
     return {
       provider: base.provider ?? {
-        kind: "local",
+        mode: "local",
         ownership: "owned",
         engine: "playwright"
       },
@@ -23297,7 +23366,6 @@ var OpensteerSessionRuntime = class {
           timeout.throwIfAborted();
           this.sessionRef = sessionRef;
           this.pageRef = createdPage.data.pageRef;
-          this.latestSnapshot = void 0;
           await timeout.runStep(() => this.ensureSemantics());
           let frameRef2 = createdPage.frameRef;
           if (input.url !== void 0) {
@@ -23420,7 +23488,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           this.pageRef = created.data.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -23463,7 +23530,6 @@ var OpensteerSessionRuntime = class {
             () => this.requireEngine().activatePage({ pageRef: input.pageRef })
           );
           this.pageRef = input.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -23527,7 +23593,6 @@ var OpensteerSessionRuntime = class {
             );
           }
           this.pageRef = activePageRef;
-          this.latestSnapshot = void 0;
           return {
             closedPageRef: targetPageRef,
             ...activePageRef === void 0 ? {} : { activePageRef },
@@ -23586,7 +23651,6 @@ var OpensteerSessionRuntime = class {
               timeout
             );
             timeout.throwIfAborted();
-            this.latestSnapshot = void 0;
             await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
             return {
               navigation: navigation2,
@@ -23756,7 +23820,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           timeout.throwIfAborted();
-          this.latestSnapshot = compiled;
           const artifacts2 = await this.captureSnapshotArtifacts(
             pageRef,
             {
@@ -23906,8 +23969,7 @@ var OpensteerSessionRuntime = class {
               () => compileOpensteerExtractionFieldTargets({
                 pageRef,
                 schema: input.schema,
-                dom: this.requireDom(),
-                ...this.latestSnapshot?.counterRecords === void 0 ? {} : { latestSnapshotCounters: this.latestSnapshot.counterRecords }
+                dom: this.requireDom()
               })
             );
             data = toCanonicalJsonValue(
@@ -27026,7 +27088,6 @@ var OpensteerSessionRuntime = class {
             });
             timeout.throwIfAborted();
             this.pageRef = output2.pageRef;
-            this.latestSnapshot = void 0;
             await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
             const artifacts2 = await this.persistComputerArtifacts(output2, timeout);
             return {
@@ -27256,8 +27317,7 @@ var OpensteerSessionRuntime = class {
       };
     }
     if (target.kind === "element") {
-      const counter = this.latestSnapshot?.counterRecords.get(target.element);
-      const elementTarget = counter ? { kind: "live", locator: counter.locator, anchor: counter.anchor } : { kind: "selector", selector: `[c="${String(target.element)}"]` };
+      const elementTarget = { kind: "selector", selector: `[c="${String(target.element)}"]` };
       const resolved2 = await timeout.runStep(
         () => this.requireDom().resolveTarget({
           pageRef,
@@ -29173,14 +29233,6 @@ var OpensteerSessionRuntime = class {
         selector: target.selector
       };
     }
-    const counter = this.latestSnapshot?.counterRecords.get(target.element);
-    if (counter) {
-      return {
-        kind: "live",
-        locator: counter.locator,
-        anchor: counter.anchor
-      };
-    }
     return {
       kind: "selector",
       selector: `[c="${String(target.element)}"]`
@@ -29241,7 +29293,7 @@ var OpensteerSessionRuntime = class {
       dom: this.dom,
       policy: this.policy
     });
-    this.extractionDescriptors = createOpensteerExtractionDescriptorStore({
+    this.extractionDescriptors = this.injectedExtractionDescriptorStore ?? createOpensteerExtractionDescriptorStore({
       root,
       namespace: this.workspace
     });
@@ -29462,7 +29514,6 @@ var OpensteerSessionRuntime = class {
     this.backgroundNetworkPersistence.clear();
     this.sessionRef = void 0;
     this.pageRef = void 0;
-    this.latestSnapshot = void 0;
     this.runId = void 0;
     this.dom = void 0;
     this.computer = void 0;
@@ -32448,12 +32499,9 @@ async function syncLocalRegistryToCloud(client, workspace, store) {
     store.registry.recipes.list(),
     store.registry.authRecipes.list()
   ]);
-  const selectorEntries = descriptors.flatMap((record) => {
-    const entry = toSelectorCacheImportEntry(workspace, record);
-    return entry === void 0 ? [] : [entry];
-  });
+  const descriptorEntries = descriptors.map((record) => toDescriptorImportEntry(workspace, record));
   await Promise.all([
-    importInBatches(selectorEntries, (entries) => client.importSelectorCache(entries)),
+    importInBatches(descriptorEntries, (entries) => client.importDescriptors(entries)),
     importInBatches(
       requestPlans.map((record) => toRequestPlanImportEntry(workspace, record)),
       (entries) => client.importRequestPlans(entries)
@@ -32468,19 +32516,18 @@ async function syncLocalRegistryToCloud(client, workspace, store) {
     )
   ]);
 }
-function toSelectorCacheImportEntry(workspace, record) {
-  const descriptor = parseDomDescriptorRecord(record);
-  if (descriptor === void 0) {
-    return void 0;
-  }
+function toDescriptorImportEntry(workspace, record) {
   return {
     workspace,
-    method: descriptor.payload.method,
-    descriptionHash: hashDomDescriptorDescription(descriptor.payload.description),
-    description: descriptor.payload.description,
-    path: descriptor.payload.path,
-    createdAt: descriptor.createdAt,
-    updatedAt: descriptor.updatedAt
+    recordId: record.id,
+    key: record.key,
+    version: record.version,
+    contentHash: record.contentHash,
+    tags: [...record.tags],
+    ...record.provenance === void 0 ? {} : { provenance: record.provenance },
+    payload: record.payload,
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt
   };
 }
 function toRegistryImportEntry(workspace, record) {
@@ -32596,7 +32643,7 @@ var CloudSessionProxy = class {
     }
     return {
       provider: {
-        kind: "cloud",
+        mode: "cloud",
         ownership: "managed",
         engine: "playwright",
         baseUrl: this.cloud.getConfig().baseUrl
@@ -32929,7 +32976,7 @@ var CloudSessionProxy = class {
     try {
       const workspaceStore = await this.ensureWorkspaceStore();
       await syncLocalRegistryToCloud(this.cloud, this.workspace, workspaceStore);
-    } catch {
+    } catch (error) {
     }
   }
   bindClient(record) {
@@ -33028,6 +33075,7 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
         ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
         ...options.policy === void 0 ? {} : { policy: options.policy },
         ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
+        ...options.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: options.extractionDescriptorStore },
         cleanupRootOnClose
       })
     );
@@ -33051,10 +33099,11 @@ function buildSharedRuntimeOptions(input) {
     ...input.engine === void 0 ? { engineFactory } : {},
     ...input.policy === void 0 ? {} : { policy: input.policy },
     ...input.descriptorStore === void 0 ? {} : { descriptorStore: input.descriptorStore },
+    ...input.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: input.extractionDescriptorStore },
     cleanupRootOnClose: input.cleanupRootOnClose,
     sessionInfo: {
       provider: {
-        kind: "local",
+        mode: "local",
         ownership,
         engine: input.engineName
       },
@@ -33080,7 +33129,7 @@ function resolveOpensteerRuntimeConfig(input = {}) {
     ...input.provider === void 0 ? {} : { provider: input.provider },
     ...input.environmentProvider === void 0 ? {} : { environmentProvider: input.environmentProvider }
   });
-  if (provider.kind === "cloud") {
+  if (provider.mode === "cloud") {
     return {
       provider,
       cloud: resolveCloudConfig({
@@ -33098,8 +33147,8 @@ function createOpensteerSemanticRuntime(input = {}) {
     ...input.provider === void 0 ? {} : { provider: input.provider },
     ...process.env.OPENSTEER_PROVIDER === void 0 ? {} : { environmentProvider: process.env.OPENSTEER_PROVIDER }
   });
-  assertProviderSupportsEngine(config.provider.kind, engine);
-  if (config.provider.kind === "cloud") {
+  assertProviderSupportsEngine(config.provider.mode, engine);
+  if (config.provider.mode === "cloud") {
     return new CloudSessionProxy(new OpensteerCloudClient(config.cloud), {
       ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
       ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
@@ -33115,7 +33164,7 @@ function createOpensteerSemanticRuntime(input = {}) {
 async function collectOpensteerStatus(input) {
   const output = {
     provider: {
-      current: input.provider.kind,
+      current: input.provider.mode,
       source: mapProviderSource(input.provider.source),
       ...input.cloudConfig === void 0 ? {} : { cloudBaseUrl: input.cloudConfig.baseUrl }
     },
@@ -33134,10 +33183,10 @@ async function collectOpensteerStatus(input) {
     ...output,
     rootPath,
     lanes: {
-      local: describeLocalLane(localRecord, input.provider.kind === "local"),
+      local: describeLocalLane(localRecord, input.provider.mode === "local"),
       cloud: await describeCloudLane({
         record: cloudRecord,
-        current: input.provider.kind === "cloud",
+        current: input.provider.mode === "cloud",
         cloudConfig: input.cloudConfig
       })
     }
@@ -33323,12 +33372,18 @@ var OPERATION_ALIASES = /* @__PURE__ */ new Map([
   ["close", "session.close"]
 ]);
 async function main() {
-  await loadCliEnvironment(process2__default.default.cwd());
-  const parsed = parseCommandLine(process2__default.default.argv.slice(2));
-  if (parsed.help || parsed.command.length === 0) {
+  const argv = process2__default.default.argv.slice(2);
+  const bootstrapAction = resolveCliBootstrapAction(argv);
+  if (bootstrapAction === "version") {
+    printVersion();
+    return;
+  }
+  if (bootstrapAction === "help") {
     printHelp();
     return;
   }
+  await loadCliEnvironment(process2__default.default.cwd());
+  const parsed = parseCommandLine(argv);
   if (parsed.command[0] === "browser") {
     await handleBrowserCommand(parsed);
     return;
@@ -33359,15 +33414,16 @@ async function main() {
   if (parsed.options.workspace === void 0) {
     throw new Error('Stateful commands require "--workspace <id>".');
   }
+  const engineName = resolveCliEngineName(parsed);
   const provider = resolveCliProvider(parsed);
-  assertProviderSupportsEngine(provider.kind, parsed.options.engineName);
-  assertCloudCliOptionsMatchProvider(parsed, provider.kind);
-  const runtimeProvider = buildCliRuntimeProvider(parsed, provider.kind);
+  assertProviderSupportsEngine(provider.mode, engineName);
+  assertCloudCliOptionsMatchProvider(parsed, provider.mode);
+  const runtimeProvider = buildCliRuntimeProvider(parsed, provider.mode);
   if (operation === "session.close") {
-    if (provider.kind === "cloud") {
+    if (provider.mode === "cloud") {
       const runtime2 = createOpensteerSemanticRuntime({
         ...runtimeProvider === void 0 ? {} : { provider: runtimeProvider },
-        engine: parsed.options.engineName,
+        engine: engineName,
         runtimeOptions: {
           workspace: parsed.options.workspace,
           rootDir: process2__default.default.cwd(),
@@ -33384,7 +33440,7 @@ async function main() {
     const manager = new OpensteerBrowserManager({
       rootDir: process2__default.default.cwd(),
       workspace: parsed.options.workspace,
-      engineName: parsed.options.engineName,
+      engineName,
       browser: "persistent",
       ...parsed.options.launch === void 0 ? {} : { launch: parsed.options.launch },
       ...parsed.options.context === void 0 ? {} : { context: parsed.options.context }
@@ -33396,7 +33452,7 @@ async function main() {
   }
   const runtime = createOpensteerSemanticRuntime({
     ...runtimeProvider === void 0 ? {} : { provider: runtimeProvider },
-    engine: parsed.options.engineName,
+    engine: engineName,
     runtimeOptions: {
       workspace: parsed.options.workspace,
       rootDir: process2__default.default.cwd(),
@@ -33450,10 +33506,11 @@ async function handleBrowserCommand(parsed) {
   if (parsed.options.workspace === void 0) {
     throw new Error('Browser workspace commands require "--workspace <id>".');
   }
+  const engineName = resolveCliEngineName(parsed);
   const manager = new OpensteerBrowserManager({
     rootDir: process2__default.default.cwd(),
     workspace: parsed.options.workspace,
-    ...parsed.options.engineName === void 0 ? {} : { engineName: parsed.options.engineName },
+    engineName,
     browser: "persistent",
     ...parsed.options.launch === void 0 ? {} : { launch: parsed.options.launch },
     ...parsed.options.context === void 0 ? {} : { context: parsed.options.context }
@@ -33585,14 +33642,8 @@ function parseCommandLine(argv) {
   const commandTokens = leadingTokens.slice(0, commandLength);
   const rest = leadingTokens.slice(commandLength);
   const rawOptions = /* @__PURE__ */ new Map();
-  let help = false;
   while (index < argv.length) {
     const token = argv[index];
-    if (token === "--help" || token === "-h") {
-      help = true;
-      index += 1;
-      continue;
-    }
     if (!token.startsWith("--")) {
       rest.push(token);
       index += 1;
@@ -33609,11 +33660,7 @@ function parseCommandLine(argv) {
     index += 2;
   }
   const browserKind = readSingle(rawOptions, "browser");
-  const requestedEngine = readSingle(rawOptions, "engine");
-  const engineName = resolveOpensteerEngineName({
-    ...requestedEngine === void 0 ? {} : { requested: requestedEngine },
-    ...process2__default.default.env.OPENSTEER_ENGINE === void 0 ? {} : { environment: process2__default.default.env.OPENSTEER_ENGINE }
-  });
+  const requestedEngineName = readSingle(rawOptions, "engine");
   const attachEndpoint = readSingle(rawOptions, "attach-endpoint");
   const attachHeaders = parseKeyValueList(rawOptions.get("attach-header"));
   const freshTab = readOptionalBoolean(rawOptions, "fresh-tab");
@@ -33652,7 +33699,7 @@ function parseCommandLine(argv) {
   const inputJson = readJsonObject(rawOptions, "input-json");
   const schemaJson = readJsonObject(rawOptions, "schema-json");
   const providerValue = readSingle(rawOptions, "provider");
-  const provider = providerValue === void 0 ? void 0 : normalizeOpensteerProviderKind(providerValue, "--provider");
+  const provider = providerValue === void 0 ? void 0 : normalizeOpensteerProviderMode(providerValue, "--provider");
   const cloudBaseUrl = readSingle(rawOptions, "cloud-base-url");
   const cloudApiKey = readSingle(rawOptions, "cloud-api-key");
   const cloudProfileId = readSingle(rawOptions, "cloud-profile-id");
@@ -33670,7 +33717,7 @@ function parseCommandLine(argv) {
   const list = readOptionalBoolean(rawOptions, "list");
   const options = {
     ...workspace === void 0 ? {} : { workspace },
-    engineName,
+    ...requestedEngineName === void 0 ? {} : { requestedEngineName },
     ...provider === void 0 ? {} : { provider },
     ...cloudBaseUrl === void 0 ? {} : { cloudBaseUrl },
     ...cloudApiKey === void 0 ? {} : { cloudApiKey },
@@ -33704,10 +33751,23 @@ function parseCommandLine(argv) {
   return {
     command: commandTokens,
     rest,
-    options,
-    help
+    options
   };
 }
+function resolveCliBootstrapAction(argv) {
+  if (argv.length === 0) {
+    return "help";
+  }
+  for (const token of argv) {
+    if (token === "--version") {
+      return "version";
+    }
+    if (token === "--help" || token === "-h") {
+      return "help";
+    }
+  }
+  return void 0;
+}
 function buildCliBrowserProfile(parsed) {
   if (parsed.options.cloudProfileReuseIfActive === true && parsed.options.cloudProfileId === void 0) {
     throw new Error('"--cloud-profile-reuse-if-active" requires "--cloud-profile-id <id>".');
@@ -33719,13 +33779,19 @@ function buildCliBrowserProfile(parsed) {
 }
 function buildCliExplicitProvider(parsed) {
   if (parsed.options.provider === "local") {
-    return { kind: "local" };
+    return { mode: "local" };
   }
   if (parsed.options.provider === "cloud") {
-    return { kind: "cloud" };
+    return { mode: "cloud" };
   }
   return void 0;
 }
+function resolveCliEngineName(parsed) {
+  return resolveOpensteerEngineName({
+    ...parsed.options.requestedEngineName === void 0 ? {} : { requested: parsed.options.requestedEngineName },
+    ...process2__default.default.env.OPENSTEER_ENGINE === void 0 ? {} : { environment: process2__default.default.env.OPENSTEER_ENGINE }
+  });
+}
 function resolveCliProvider(parsed) {
   const explicitProvider = buildCliExplicitProvider(parsed);
   return resolveOpensteerProvider({
@@ -33733,25 +33799,25 @@ function resolveCliProvider(parsed) {
     ...process2__default.default.env.OPENSTEER_PROVIDER === void 0 ? {} : { environmentProvider: process2__default.default.env.OPENSTEER_PROVIDER }
   });
 }
-function buildCliRuntimeProvider(parsed, providerKind) {
+function buildCliRuntimeProvider(parsed, providerMode) {
   const explicitProvider = buildCliExplicitProvider(parsed);
-  if (providerKind === "local") {
-    return explicitProvider?.kind === "local" ? explicitProvider : void 0;
+  if (providerMode === "local") {
+    return explicitProvider?.mode === "local" ? explicitProvider : void 0;
   }
   const browserProfile = buildCliBrowserProfile(parsed);
   const hasCloudOverrides = parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || browserProfile !== void 0;
-  if (!hasCloudOverrides && explicitProvider?.kind !== "cloud") {
+  if (!hasCloudOverrides && explicitProvider?.mode !== "cloud") {
     return void 0;
   }
   return {
-    kind: "cloud",
+    mode: "cloud",
     ...parsed.options.cloudBaseUrl === void 0 ? {} : { baseUrl: parsed.options.cloudBaseUrl },
     ...parsed.options.cloudApiKey === void 0 ? {} : { apiKey: parsed.options.cloudApiKey },
     ...browserProfile === void 0 ? {} : { browserProfile }
   };
 }
-function assertCloudCliOptionsMatchProvider(parsed, providerKind) {
-  if (providerKind !== "cloud" && (parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || parsed.options.cloudProfileId !== void 0 || parsed.options.cloudProfileReuseIfActive === true)) {
+function assertCloudCliOptionsMatchProvider(parsed, providerMode) {
+  if (providerMode !== "cloud" && (parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || parsed.options.cloudProfileId !== void 0 || parsed.options.cloudProfileReuseIfActive === true)) {
     throw new Error(
       'Cloud-specific options require provider=cloud. Set "--provider cloud" or OPENSTEER_PROVIDER=cloud.'
     );
@@ -33759,8 +33825,8 @@ function assertCloudCliOptionsMatchProvider(parsed, providerKind) {
 }
 async function handleStatusCommand(parsed) {
   const provider = resolveCliProvider(parsed);
-  assertCloudCliOptionsMatchProvider(parsed, provider.kind);
-  const runtimeProvider = buildCliRuntimeProvider(parsed, provider.kind);
+  assertCloudCliOptionsMatchProvider(parsed, provider.mode);
+  const runtimeProvider = buildCliRuntimeProvider(parsed, provider.mode);
   const runtimeConfig = resolveOpensteerRuntimeConfig({
     ...runtimeProvider === void 0 ? {} : { provider: runtimeProvider },
     ...process2__default.default.env.OPENSTEER_PROVIDER === void 0 ? {} : { environmentProvider: process2__default.default.env.OPENSTEER_PROVIDER }
@@ -33881,6 +33947,8 @@ Usage:
   opensteer run <semantic-operation> --workspace <id> --input-json <json>
 
 Common options:
+  --help
+  --version
   --workspace <id>
   --provider local|cloud
   --cloud-base-url <url>
@@ -33902,6 +33970,10 @@ Common options:
   --agent <name>      repeatable
 `);
 }
+function printVersion() {
+  process2__default.default.stdout.write(`${package_default.version}
+`);
+}
 main().catch((error) => {
   const payload = error instanceof Error ? {
     error: {