@opensteer/runtime-core 0.1.0 → 0.1.1

package/dist/index.js

@@ -1,5 +1,5 @@
 import path6 from 'path';
-import { randomUUID, createHash } from 'crypto';
+import { createHash, randomUUID } from 'crypto';
 import { rm, mkdir, access, readFile, mkdtemp, writeFile, rename, open, readdir } from 'fs/promises';
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
@@ -13,7 +13,7 @@ import vm from 'vm';
 
 // package.json
 var package_default = {
-  version: "0.1.0"};
+  version: "0.1.1"};
 
 // src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -1296,12 +1296,6 @@ var opensteerRegistryProvenanceSchema = objectSchema(
     required: ["source"]
   }
 );
-var opensteerRequestPlanLifecycleSchema = enumSchema(
-  ["draft", "active", "deprecated", "retired"],
-  {
-    title: "OpensteerRequestPlanLifecycle"
-  }
-);
 var opensteerRequestPlanFreshnessSchema = objectSchema(
   {
     lastValidatedAt: integerSchema({ minimum: 0 }),
@@ -1324,23 +1318,12 @@ var opensteerRequestPlanRecordSchema = objectSchema(
       uniqueItems: true
     }),
     provenance: opensteerRegistryProvenanceSchema,
-    lifecycle: opensteerRequestPlanLifecycleSchema,
     freshness: opensteerRequestPlanFreshnessSchema,
     payload: opensteerRequestPlanPayloadSchema
   },
   {
     title: "OpensteerRequestPlanRecord",
-    required: [
-      "id",
-      "key",
-      "version",
-      "createdAt",
-      "updatedAt",
-      "contentHash",
-      "tags",
-      "lifecycle",
-      "payload"
-    ]
+    required: ["id", "key", "version", "createdAt", "updatedAt", "contentHash", "tags", "payload"]
   }
 );
 var jsonValueSchema = defineSchema({
@@ -1783,7 +1766,6 @@ var opensteerWriteRequestPlanInputSchema = objectSchema(
       uniqueItems: true
     }),
     provenance: opensteerRegistryProvenanceSchema,
-    lifecycle: opensteerRequestPlanLifecycleSchema,
     freshness: opensteerRequestPlanFreshnessSchema,
     payload: opensteerRequestPlanPayloadSchema
   },
@@ -2024,7 +2006,7 @@ var opensteerInferRequestPlanInputSchema = objectSchema(
     recordId: stringSchema({ minLength: 1 }),
     key: stringSchema({ minLength: 1 }),
     version: stringSchema({ minLength: 1 }),
-    lifecycle: opensteerRequestPlanLifecycleSchema
+    transport: transportKindSchema
   },
   {
     title: "OpensteerInferRequestPlanInput",
@@ -7089,8 +7071,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) {
@@ -7341,9 +7389,7 @@ var FilesystemRegistryStore = class {
     if (input.version !== void 0) {
       return this.resolveIndexedRecord(key, normalizeNonEmptyString("version", input.version));
     }
-    const matches = (await this.readAllRecords()).filter(
-      (record) => this.isActive(record) && record.key === key
-    );
+    const matches = (await this.readAllRecords()).filter((record) => record.key === key);
     matches.sort(compareByCreatedAtAndId);
     return matches[0];
   }
@@ -7466,8 +7512,10 @@ var FilesystemDescriptorRegistry = class extends FilesystemRegistryStore {
     };
     return this.writeRecord(record);
   }
-  isActive(_record) {
-    return true;
+  async list(input = {}) {
+    const key = input.key === void 0 ? void 0 : normalizeNonEmptyString("key", input.key);
+    const records = await this.readAllRecords();
+    return key === void 0 ? records : records.filter((record) => record.key === key);
   }
 };
 var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
@@ -7497,7 +7545,6 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
       tags: normalizeTags(input.tags),
       ...provenance === void 0 ? {} : { provenance },
       payload,
-      lifecycle: input.lifecycle ?? "active",
       ...freshness === void 0 ? {} : { freshness }
     };
     return this.writeRecord(record);
@@ -7507,7 +7554,7 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  async updateMetadata(input) {
+  async updateFreshness(input) {
     const id = normalizeNonEmptyString("id", input.id);
     return withFilesystemLock(this.writeLockPath(), async () => {
       const existing = await this.getById(id);
@@ -7525,16 +7572,12 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
       const nextRecord = {
         ...existing,
         updatedAt: nextUpdatedAt,
-        lifecycle: input.lifecycle ?? existing.lifecycle,
         ...nextFreshness === void 0 ? {} : { freshness: nextFreshness }
       };
       await writeJsonFileAtomic(this.recordPath(id), nextRecord);
       return nextRecord;
     });
   }
-  isActive(record) {
-    return record.lifecycle === "active";
-  }
 };
 var FilesystemAuthRecipeRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7570,9 +7613,6 @@ var FilesystemAuthRecipeRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemRecipeRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7608,9 +7648,6 @@ var FilesystemRecipeRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemInteractionTraceRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7646,9 +7683,6 @@ var FilesystemInteractionTraceRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReverseCaseRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7712,9 +7746,6 @@ var FilesystemReverseCaseRegistry = class extends FilesystemRegistryStore {
       return nextRecord;
     });
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReversePackageRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7750,9 +7781,6 @@ var FilesystemReversePackageRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReverseReportRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7788,9 +7816,6 @@ var FilesystemReverseReportRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 function createDescriptorRegistry(rootPath) {
   return new FilesystemDescriptorRegistry(rootPath);
@@ -7818,101 +7843,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.join(rootPath, "registry", "saved-network.sqlite");
   }
   async initialize() {
-    await ensureDirectory(path6.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
@@ -8104,7 +8048,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(
@@ -8135,7 +8079,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
@@ -8172,11 +8116,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);
     }
-    return this.database;
+    const database = new DatabaseSync(this.databasePath);
+    try {
+      this.configureDatabase(database);
+      this.database = database;
+      return database;
+    } catch (error) {
+      closeSqliteDatabase(database);
+      throw error;
+    }
+  }
+  async ensureDatabaseDirectory() {
+    this.directoryInitialization ??= ensureDirectory(path6.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();
@@ -8321,6 +8381,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 {
@@ -8530,8 +8604,8 @@ async function createFilesystemOpensteerWorkspace(options) {
   const browserManifestPath = path6.join(browserPath, "manifest.json");
   const browserUserDataDir = path6.join(browserPath, "user-data");
   const livePath = path6.join(options.rootPath, "live");
-  const liveSessionPath = path6.join(livePath, "session.json");
-  const liveBrowserPath = path6.join(livePath, "browser.json");
+  const liveLocalPath = path6.join(livePath, "local.json");
+  const liveCloudPath = path6.join(livePath, "cloud.json");
   const artifactsPath = path6.join(options.rootPath, "artifacts");
   const tracesPath = path6.join(options.rootPath, "traces");
   const registryPath = path6.join(options.rootPath, "registry");
@@ -8606,8 +8680,8 @@ async function createFilesystemOpensteerWorkspace(options) {
     browserManifestPath,
     browserUserDataDir,
     livePath,
-    liveSessionPath,
-    liveBrowserPath,
+    liveLocalPath,
+    liveCloudPath,
     artifactsPath,
     tracesPath,
     registryPath,
@@ -8631,6 +8705,16 @@ async function createFilesystemOpensteerWorkspace(options) {
   };
 }
 
+// src/runtimes/dom/errors.ts
+var ElementPathError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ElementPathError";
+    this.code = code;
+  }
+};
+
 // src/runtimes/dom/match-policy.ts
 var ATTRIBUTE_DENY_KEYS = /* @__PURE__ */ new Set([
   "style",
@@ -9191,16 +9275,6 @@ function readDescriptorToken(value, index) {
     nextIndex: cursor
   };
 }
-
-// src/runtimes/dom/errors.ts
-var ElementPathError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "ElementPathError";
-    this.code = code;
-  }
-};
 var selectorAdapter = {
   isTag(node) {
     return node.kind === "element" && node.source.nodeType === 1;
@@ -9955,24 +10029,31 @@ function collectChildrenInScope(index, node, scopeHostNodeRef) {
 function getShadowScopeNodeRef(index, node) {
   return findContainingShadowHostNode(index, node)?.nodeRef;
 }
+
+// src/runtimes/dom/descriptors.ts
 function createDomDescriptorStore(options) {
-  const namespace = normalizeNamespace(options.namespace);
+  const namespace = normalizeDomDescriptorNamespace(options.namespace);
   if (options.root) {
     return new FilesystemDomDescriptorStore(options.root.registry.descriptors, namespace);
   }
   return new MemoryDomDescriptorStore(namespace);
 }
-function descriptionKey(namespace, method, description) {
-  return `dom:${namespace}:${method}:${sha256Hex2(description.trim())}`;
+function hashDomDescriptorDescription(description) {
+  return sha256Hex2(description.trim());
 }
-function normalizeNamespace(namespace) {
+function buildDomDescriptorKey(options) {
+  return `dom:${normalizeDomDescriptorNamespace(options.namespace)}:${options.method}:${hashDomDescriptorDescription(
+    options.description
+  )}`;
+}
+function normalizeDomDescriptorNamespace(namespace) {
   const normalized = String(namespace || "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
 function sha256Hex2(value) {
   return createHash("sha256").update(value).digest("hex");
 }
-function buildPayload(input) {
+function buildDomDescriptorPayload(input) {
   return {
     kind: "dom-target",
     method: input.method,
@@ -9981,6 +10062,9 @@ function buildPayload(input) {
     ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
   };
 }
+function buildDomDescriptorVersion(payload) {
+  return sha256Hex2(canonicalJsonString(payload));
+}
 function parseDomDescriptorRecord(record) {
   const payload = record.payload;
   if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
@@ -10022,7 +10106,11 @@ var FilesystemDomDescriptorStore = class {
   }
   async read(input) {
     const record = await this.registry.resolve({
-      key: descriptionKey(this.namespace, input.method, input.description)
+      key: buildDomDescriptorKey({
+        namespace: this.namespace,
+        method: input.method,
+        description: input.description
+      })
     });
     if (!record) {
       return void 0;
@@ -10030,9 +10118,13 @@ var FilesystemDomDescriptorStore = class {
     return parseDomDescriptorRecord(record);
   }
   async write(input) {
-    const payload = buildPayload(input);
-    const key = descriptionKey(this.namespace, input.method, input.description);
-    const version = sha256Hex2(canonicalJsonString(payload));
+    const payload = buildDomDescriptorPayload(input);
+    const key = buildDomDescriptorKey({
+      namespace: this.namespace,
+      method: input.method,
+      description: input.description
+    });
+    const version = buildDomDescriptorVersion(payload);
     const existing = await this.registry.resolve({ key, version });
     if (existing) {
       const parsed2 = parseDomDescriptorRecord(existing);
@@ -10070,12 +10162,22 @@ var MemoryDomDescriptorStore = class {
   latestByKey = /* @__PURE__ */ new Map();
   recordsByKey = /* @__PURE__ */ new Map();
   async read(input) {
-    return this.latestByKey.get(descriptionKey(this.namespace, input.method, input.description));
+    return this.latestByKey.get(
+      buildDomDescriptorKey({
+        namespace: this.namespace,
+        method: input.method,
+        description: input.description
+      })
+    );
   }
   async write(input) {
-    const payload = buildPayload(input);
-    const key = descriptionKey(this.namespace, input.method, input.description);
-    const version = sha256Hex2(canonicalJsonString(payload));
+    const payload = buildDomDescriptorPayload(input);
+    const key = buildDomDescriptorKey({
+      namespace: this.namespace,
+      method: input.method,
+      description: input.description
+    });
+    const version = buildDomDescriptorVersion(payload);
     const existing = this.recordsByKey.get(key)?.get(version);
     if (existing) {
       return existing;
@@ -10718,7 +10820,7 @@ var DefaultDomRuntime = class {
   bridge;
   constructor(options) {
     this.engine = options.engine;
-    this.descriptors = createDomDescriptorStore({
+    this.descriptors = options.descriptorStore ?? createDomDescriptorStore({
       ...options.root === void 0 ? {} : { root: options.root },
       ...options.namespace === void 0 ? {} : { namespace: options.namespace }
     });
@@ -12606,7 +12708,7 @@ function inferRequestPlanFromNetworkRecord(record, input, options = {}) {
   const body = inferRequestPlanBody(record.record.requestBody, requestContentType);
   const payload = normalizeRequestPlanPayload({
     transport: {
-      kind: "context-http"
+      kind: input.transport ?? "context-http"
     },
     endpoint: {
       method: record.record.method,
@@ -12626,7 +12728,6 @@ function inferRequestPlanFromNetworkRecord(record, input, options = {}) {
   return {
     key: input.key,
     version: input.version,
-    lifecycle: input.lifecycle ?? "draft",
     provenance: {
       source: record.source === "saved" ? "saved-network-record" : "live-network-record",
       sourceId: record.recordId,
@@ -16898,7 +16999,6 @@ async function compileOpensteerExtractionFieldTargets(options) {
   await collectFieldTargetsFromSchemaObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    latestSnapshotCounters: options.latestSnapshotCounters,
     value: options.schema,
     path: "",
     fields,
@@ -16916,22 +17016,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 }
       };
@@ -16940,8 +17029,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);
@@ -16955,7 +17042,7 @@ async function replayOpensteerExtractionPayload(options) {
   return extractPersistedObjectNode(options.pageRef, options.dom, options.payload);
 }
 function createOpensteerExtractionDescriptorStore(options) {
-  const namespace = normalizeNamespace2(options.namespace);
+  const namespace = normalizeNamespace(options.namespace);
   if (options.root) {
     return new FilesystemOpensteerExtractionDescriptorStore(
       options.root.registry.descriptors,
@@ -16973,7 +17060,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,
@@ -16988,7 +17074,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
       await compileFieldTarget({
         dom: options.dom,
         pageRef: options.pageRef,
-        latestSnapshotCounters: options.latestSnapshotCounters,
         field: normalizedField,
         path: options.path
       })
@@ -17017,7 +17102,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,
@@ -17040,7 +17124,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,
@@ -17067,10 +17150,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 }
   };
@@ -17088,24 +17171,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) {
@@ -17116,29 +17181,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 path9 = resolved.replayPath ?? await options.dom.buildPath({
-      locator: resolved.locator
-    });
     fields.push({
       key: field.key,
-      path: sanitizeElementPath(path9),
+      path: sanitizeElementPath(field.path),
       ...field.attribute === void 0 ? {} : { attribute: field.attribute }
     });
   }
@@ -17452,11 +17497,11 @@ function normalizeSchemaField(value) {
     ...attribute === void 0 ? {} : { attribute }
   };
 }
-function normalizeNamespace2(namespace) {
+function normalizeNamespace(namespace) {
   const normalized = String(namespace ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
-function descriptionKey2(namespace, description) {
+function descriptionKey(namespace, description) {
   return `extract:${namespace}:${sha256Hex3(description.trim())}`;
 }
 function parseExtractionDescriptorRecord(record) {
@@ -17559,7 +17604,7 @@ var FilesystemOpensteerExtractionDescriptorStore = class {
   }
   async read(input) {
     const record = await this.registry.resolve({
-      key: descriptionKey2(this.namespace, input.description)
+      key: descriptionKey(this.namespace, input.description)
     });
     return record === void 0 ? void 0 : parseExtractionDescriptorRecord(record);
   }
@@ -17571,7 +17616,7 @@ var FilesystemOpensteerExtractionDescriptorStore = class {
       ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
-    const key = descriptionKey2(this.namespace, input.description);
+    const key = descriptionKey(this.namespace, input.description);
     const version = sha256Hex3(canonicalJsonString(payload));
     const existing = await this.registry.resolve({ key, version });
     if (existing) {
@@ -17610,7 +17655,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
   latestByKey = /* @__PURE__ */ new Map();
   recordsByKey = /* @__PURE__ */ new Map();
   async read(input) {
-    return this.latestByKey.get(descriptionKey2(this.namespace, input.description));
+    return this.latestByKey.get(descriptionKey(this.namespace, input.description));
   }
   async write(input) {
     const payload = {
@@ -17620,7 +17665,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
       ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
-    const key = descriptionKey2(this.namespace, input.description);
+    const key = descriptionKey(this.namespace, input.description);
     const version = sha256Hex3(canonicalJsonString(payload));
     const existing = this.recordsByKey.get(key)?.get(version);
     if (existing) {
@@ -17664,6 +17709,7 @@ var OPENSTEER_INTERACTIVE_ATTR = "data-opensteer-interactive";
 var OPENSTEER_HIDDEN_ATTR = "data-opensteer-hidden";
 var OPENSTEER_SCROLLABLE_ATTR = "data-opensteer-scrollable";
 var OPENSTEER_NODE_ID_ATTR = "data-os-node-id";
+var OPENSTEER_SPARSE_COUNTER_ATTR = "data-os-c";
 var OPENSTEER_BOUNDARY_ATTR = "data-os-boundary";
 var OPENSTEER_UNAVAILABLE_ATTR = "data-os-unavailable";
 var OPENSTEER_IFRAME_BOUNDARY_TAG = "os-iframe-root";
@@ -18168,7 +18214,82 @@ var VOID_TAGS2 = /* @__PURE__ */ new Set([
 ]);
 
 // src/sdk/snapshot/compiler.ts
+async function assignSparseCountersToLiveDom(engine, pageRef) {
+  try {
+    await engine.evaluatePage({
+      pageRef,
+      script: `(() => {
+        let counter = 1;
+        const walk = (root) => {
+          for (const child of root.children) {
+            child.setAttribute('data-os-c', String(counter++));
+            walk(child);
+            if (child.shadowRoot) walk(child.shadowRoot);
+          }
+        };
+        walk(document);
+      })()`
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function syncDenseCountersToLiveDom(engine, pageRef, sparseToDirectMapping) {
+  const mappingObj = Object.fromEntries(sparseToDirectMapping);
+  await engine.evaluatePage({
+    pageRef,
+    script: `((mapping) => {
+      const walk = (root) => {
+        for (const child of root.children) {
+          child.removeAttribute('c');
+          const sparse = child.getAttribute('data-os-c');
+          if (sparse !== null) {
+            const dense = mapping[sparse];
+            if (dense !== undefined) {
+              child.setAttribute('c', String(dense));
+            }
+            child.removeAttribute('data-os-c');
+          }
+          walk(child);
+          if (child.shadowRoot) walk(child.shadowRoot);
+        }
+      };
+      walk(document);
+    })`,
+    args: [mappingObj]
+  });
+}
+function renumberCountersDensely(cleanedHtml, counterRecords) {
+  const $ = cheerio.load(cleanedHtml, { xmlMode: false });
+  const newRecords = /* @__PURE__ */ new Map();
+  const sparseToDirectMapping = /* @__PURE__ */ new Map();
+  let nextDense = 1;
+  $("[c]").each(function renumberElement() {
+    const el = $(this);
+    const oldC = Number.parseInt(String(el.attr("c") || ""), 10);
+    if (!Number.isFinite(oldC)) {
+      return;
+    }
+    const record = counterRecords.get(oldC);
+    if (!record) {
+      return;
+    }
+    const denseC = nextDense++;
+    el.attr("c", String(denseC));
+    newRecords.set(denseC, { ...record, element: denseC });
+    if (record.sparseCounter !== void 0) {
+      sparseToDirectMapping.set(record.sparseCounter, denseC);
+    }
+  });
+  return {
+    html: $.html(),
+    counterRecords: newRecords,
+    sparseToDirectMapping
+  };
+}
 async function compileOpensteerSnapshot(options) {
+  const liveCountersEnabled = await assignSparseCountersToLiveDom(options.engine, options.pageRef);
   const pageInfo = await options.engine.getPageInfo({ pageRef: options.pageRef });
   const mainSnapshot = await getMainDocumentSnapshot(options.engine, options.pageRef);
   const snapshotsByDocumentRef = await collectDocumentSnapshots(options.engine, mainSnapshot);
@@ -18187,13 +18308,23 @@ async function compileOpensteerSnapshot(options) {
   const compiledHtml = assignCounters(rawHtml, renderedNodes);
   const cleanedHtml = options.mode === "extraction" ? cleanForExtraction(compiledHtml.html) : cleanForAction(compiledHtml.html);
   const filtered = retainVisibleCounterRecords(cleanedHtml, compiledHtml.counterRecords);
+  const dense = renumberCountersDensely(cleanedHtml, filtered);
+  if (liveCountersEnabled && dense.sparseToDirectMapping.size > 0) {
+    try {
+      await syncDenseCountersToLiveDom(
+        options.engine,
+        options.pageRef,
+        dense.sparseToDirectMapping
+      );
+    } catch {
+    }
+  }
   return {
     url: pageInfo.url,
     title: pageInfo.title,
     mode: options.mode,
-    html: cleanedHtml,
-    counters: [...filtered.values()].map(toPublicCounterRecord),
-    counterRecords: filtered
+    html: dense.html,
+    counters: [...dense.counterRecords.values()].map(toPublicCounterRecord)
   };
 }
 async function getMainDocumentSnapshot(engine, pageRef) {
@@ -18422,6 +18553,9 @@ function assignCounters(rawHtml, renderedNodes) {
     if (!rendered) {
       return;
     }
+    const rawSparseCounter = el.attr(OPENSTEER_SPARSE_COUNTER_ATTR);
+    el.removeAttr(OPENSTEER_SPARSE_COUNTER_ATTR);
+    const sparseCounter = rawSparseCounter ? Number.parseInt(rawSparseCounter, 10) : void 0;
     const counter = nextCounter++;
     el.attr("c", String(counter));
     counterRecords.set(counter, {
@@ -18439,7 +18573,8 @@ function assignCounters(rawHtml, renderedNodes) {
       shadowDepth: rendered.shadowDepth,
       interactive: rendered.interactive,
       locator: rendered.locator,
-      anchor: rendered.anchor
+      anchor: rendered.anchor,
+      ...sparseCounter !== void 0 && Number.isFinite(sparseCounter) ? { sparseCounter } : {}
     });
   });
   return {
@@ -19807,6 +19942,9 @@ var OpensteerSessionRuntime = class {
   injectedEngine;
   engineFactory;
   policy;
+  injectedDescriptorStore;
+  injectedExtractionDescriptorStore;
+  registryOverrides;
   cleanupRootOnClose;
   sessionInfoBase;
   root;
@@ -19818,19 +19956,21 @@ var OpensteerSessionRuntime = class {
   sessionRef;
   pageRef;
   runId;
-  latestSnapshot;
   backgroundNetworkPersistence = /* @__PURE__ */ new Set();
   cookieJars = /* @__PURE__ */ new Map();
   recipeCache = /* @__PURE__ */ new Map();
   ownsEngine = false;
   constructor(options) {
-    this.workspace = normalizeNamespace3(options.name);
+    this.workspace = normalizeNamespace2(options.name);
     this.workspaceName = options.workspaceName?.trim() === void 0 || options.workspaceName?.trim().length === 0 ? void 0 : options.workspaceName.trim();
     this.root = options.workspace;
     this.rootPath = options.workspace?.rootPath ?? options.rootPath ?? path6.resolve(process.cwd(), ".opensteer", "temporary", randomUUID());
     this.injectedEngine = options.engine;
     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 ?? {};
     if (this.injectedEngine === void 0 && this.engineFactory === void 0) {
@@ -19841,7 +19981,7 @@ var OpensteerSessionRuntime = class {
     const base = this.sessionInfoBase;
     return {
       provider: base.provider ?? {
-        kind: "local",
+        mode: "local",
         ownership: "owned",
         engine: "playwright"
       },
@@ -19866,7 +20006,7 @@ var OpensteerSessionRuntime = class {
   }
   async open(input = {}, options = {}) {
     assertValidSemanticOperationInput("session.open", input);
-    if (input.workspace !== void 0 && normalizeNamespace3(input.workspace) !== this.workspace) {
+    if (input.workspace !== void 0 && normalizeNamespace2(input.workspace) !== this.workspace) {
       throw new Error(
         `session.open requested workspace "${input.workspace}" but runtime is bound to "${this.workspace}"`
       );
@@ -19908,7 +20048,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) {
@@ -20031,7 +20170,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           this.pageRef = created.data.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -20074,7 +20212,6 @@ var OpensteerSessionRuntime = class {
             () => this.requireEngine().activatePage({ pageRef: input.pageRef })
           );
           this.pageRef = input.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -20138,7 +20275,6 @@ var OpensteerSessionRuntime = class {
             );
           }
           this.pageRef = activePageRef;
-          this.latestSnapshot = void 0;
           return {
             closedPageRef: targetPageRef,
             ...activePageRef === void 0 ? {} : { activePageRef },
@@ -20197,7 +20333,6 @@ var OpensteerSessionRuntime = class {
               timeout
             );
             timeout.throwIfAborted();
-            this.latestSnapshot = void 0;
             await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
             return {
               navigation: navigation2,
@@ -20367,7 +20502,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           timeout.throwIfAborted();
-          this.latestSnapshot = compiled;
           const artifacts2 = await this.captureSnapshotArtifacts(
             pageRef,
             {
@@ -20517,8 +20651,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(
@@ -22282,8 +22415,7 @@ var OpensteerSessionRuntime = class {
     const inferred = inferRequestPlanFromNetworkRecord(record, {
       recordId: candidate.recordId,
       key: input.key,
-      version: input.version,
-      lifecycle: "draft"
+      version: input.version
     });
     const defaultHeaders = inferred.payload.endpoint.defaultHeaders === void 0 ? void 0 : stripManagedRequestHeaders(
       inferred.payload.endpoint.defaultHeaders,
@@ -22911,8 +23043,7 @@ var OpensteerSessionRuntime = class {
           recordId: input.recordId,
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -22953,8 +23084,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -23000,8 +23130,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -23641,7 +23770,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 {
@@ -23871,19 +23999,12 @@ var OpensteerSessionRuntime = class {
       };
     }
     if (target.kind === "element") {
-      const counter = this.latestSnapshot?.counterRecords.get(target.element);
-      if (!counter) {
-        throw new Error(`no counter ${String(target.element)} is available in the latest snapshot`);
-      }
+      const elementTarget = { kind: "selector", selector: `[c="${String(target.element)}"]` };
       const resolved2 = await timeout.runStep(
         () => this.requireDom().resolveTarget({
           pageRef,
           method,
-          target: {
-            kind: "live",
-            locator: counter.locator,
-            anchor: counter.anchor
-          }
+          target: elementTarget
         })
       );
       const stablePath2 = resolved2.replayPath ?? await timeout.runStep(
@@ -25126,7 +25247,7 @@ var OpensteerSessionRuntime = class {
   }
   async touchRequestPlanFreshness(plan) {
     const freshness = touchFreshness(plan.freshness);
-    await this.requireRoot().registry.requestPlans.updateMetadata({
+    await this.requireRoot().registry.requestPlans.updateFreshness({
       id: plan.id,
       ...freshness === void 0 ? {} : { freshness }
     });
@@ -25794,22 +25915,33 @@ var OpensteerSessionRuntime = class {
         selector: target.selector
       };
     }
-    const counter = this.latestSnapshot?.counterRecords.get(target.element);
-    if (!counter) {
-      throw new Error(`no counter ${String(target.element)} is available in the latest snapshot`);
-    }
     return {
-      kind: "live",
-      locator: counter.locator,
-      anchor: counter.anchor
+      kind: "selector",
+      selector: `[c="${String(target.element)}"]`
     };
   }
   async ensureRoot() {
-    this.root ??= await createFilesystemOpensteerWorkspace({
-      rootPath: this.rootPath,
-      ...this.workspaceName === void 0 ? {} : { workspace: this.workspaceName },
-      scope: this.workspaceName === void 0 ? "temporary" : "workspace"
-    });
+    if (!this.root) {
+      const workspace = await createFilesystemOpensteerWorkspace({
+        rootPath: this.rootPath,
+        ...this.workspaceName === void 0 ? {} : { workspace: this.workspaceName },
+        scope: this.workspaceName === void 0 ? "temporary" : "workspace"
+      });
+      if (this.registryOverrides) {
+        const overrides = this.registryOverrides;
+        this.root = {
+          ...workspace,
+          registry: {
+            ...workspace.registry,
+            ...overrides.requestPlans === void 0 ? {} : { requestPlans: overrides.requestPlans },
+            ...overrides.authRecipes === void 0 ? {} : { authRecipes: overrides.authRecipes },
+            ...overrides.recipes === void 0 ? {} : { recipes: overrides.recipes }
+          }
+        };
+      } else {
+        this.root = workspace;
+      }
+    }
     return this.root;
   }
   async ensureEngine(overrides = {}) {
@@ -25835,6 +25967,7 @@ var OpensteerSessionRuntime = class {
       engine,
       root,
       namespace: this.workspace,
+      ...this.injectedDescriptorStore === void 0 ? {} : { descriptorStore: this.injectedDescriptorStore },
       policy: this.policy
     });
     this.computer = createComputerUseRuntime({
@@ -25842,7 +25975,7 @@ var OpensteerSessionRuntime = class {
       dom: this.dom,
       policy: this.policy
     });
-    this.extractionDescriptors = createOpensteerExtractionDescriptorStore({
+    this.extractionDescriptors = this.injectedExtractionDescriptorStore ?? createOpensteerExtractionDescriptorStore({
       root,
       namespace: this.workspace
     });
@@ -26063,7 +26196,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;
@@ -26421,7 +26553,6 @@ function buildMinimizedRequestPlan(input) {
       sourceId: input.record.recordId,
       ...input.record.source === "saved" && input.record.savedAt !== void 0 ? { capturedAt: input.record.savedAt } : {}
     },
-    lifecycle: "draft",
     payload: normalizeRequestPlanPayload({
       transport: {
         kind: input.transport
@@ -28576,7 +28707,7 @@ function directionToDelta(direction, amount) {
       return { x: amount, y: 0 };
   }
 }
-function normalizeNamespace3(value) {
+function normalizeNamespace2(value) {
   const normalized = String(value ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
@@ -28622,6 +28753,6 @@ function screenshotMediaType(format2) {
   }
 }
 
-export { OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, OpensteerSessionRuntime, createFilesystemOpensteerWorkspace, dispatchSemanticOperation, normalizeWorkspaceId, resolveFilesystemWorkspacePath };
+export { OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, OpensteerSessionRuntime, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map