opensteer 0.8.3 → 0.8.4

package/dist/index.cjs

@@ -1787,12 +1787,6 @@ var opensteerRegistryProvenanceSchema = objectSchema(
     required: ["source"]
   }
 );
-var opensteerRequestPlanLifecycleSchema = enumSchema(
-  ["draft", "active", "deprecated", "retired"],
-  {
-    title: "OpensteerRequestPlanLifecycle"
-  }
-);
 var opensteerRequestPlanFreshnessSchema = objectSchema(
   {
     lastValidatedAt: integerSchema({ minimum: 0 }),
@@ -1815,23 +1809,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({
@@ -2274,7 +2257,6 @@ var opensteerWriteRequestPlanInputSchema = objectSchema(
       uniqueItems: true
     }),
     provenance: opensteerRegistryProvenanceSchema,
-    lifecycle: opensteerRequestPlanLifecycleSchema,
     freshness: opensteerRequestPlanFreshnessSchema,
     payload: opensteerRequestPlanPayloadSchema
   },
@@ -2515,7 +2497,7 @@ var opensteerInferRequestPlanInputSchema = objectSchema(
     recordId: stringSchema({ minLength: 1 }),
     key: stringSchema({ minLength: 1 }),
     version: stringSchema({ minLength: 1 }),
-    lifecycle: opensteerRequestPlanLifecycleSchema
+    transport: transportKindSchema
   },
   {
     title: "OpensteerInferRequestPlanInput",
@@ -7129,9 +7111,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];
   }
@@ -7254,8 +7234,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 {
@@ -7285,7 +7267,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);
@@ -7295,7 +7276,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);
@@ -7313,16 +7294,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) {
@@ -7358,9 +7335,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) {
@@ -7396,9 +7370,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) {
@@ -7434,9 +7405,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) {
@@ -7500,9 +7468,6 @@ var FilesystemReverseCaseRegistry = class extends FilesystemRegistryStore {
       return nextRecord;
     });
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReversePackageRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7538,9 +7503,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) {
@@ -7576,9 +7538,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);
@@ -8318,8 +8277,8 @@ async function createFilesystemOpensteerWorkspace(options) {
   const browserManifestPath = path6__default.default.join(browserPath, "manifest.json");
   const browserUserDataDir = path6__default.default.join(browserPath, "user-data");
   const livePath = path6__default.default.join(options.rootPath, "live");
-  const liveSessionPath = path6__default.default.join(livePath, "session.json");
-  const liveBrowserPath = path6__default.default.join(livePath, "browser.json");
+  const liveLocalPath = path6__default.default.join(livePath, "local.json");
+  const liveCloudPath = path6__default.default.join(livePath, "cloud.json");
   const artifactsPath = path6__default.default.join(options.rootPath, "artifacts");
   const tracesPath = path6__default.default.join(options.rootPath, "traces");
   const registryPath = path6__default.default.join(options.rootPath, "registry");
@@ -8394,8 +8353,8 @@ async function createFilesystemOpensteerWorkspace(options) {
     browserManifestPath,
     browserUserDataDir,
     livePath,
-    liveSessionPath,
-    liveBrowserPath,
+    liveLocalPath,
+    liveCloudPath,
     artifactsPath,
     tracesPath,
     registryPath,
@@ -8651,6 +8610,16 @@ function abortError2() {
   return error;
 }
 
+// ../runtime-core/src/runtimes/dom/errors.ts
+var ElementPathError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ElementPathError";
+    this.code = code;
+  }
+};
+
 // ../runtime-core/src/runtimes/dom/match-policy.ts
 var ATTRIBUTE_DENY_KEYS = /* @__PURE__ */ new Set([
   "style",
@@ -9214,16 +9183,6 @@ function readDescriptorToken(value, index) {
     nextIndex: cursor
   };
 }
-
-// ../runtime-core/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;
@@ -9988,24 +9947,31 @@ function collectChildrenInScope(index, node, scopeHostNodeRef) {
 function getShadowScopeNodeRef(index, node) {
   return findContainingShadowHostNode(index, node)?.nodeRef;
 }
+
+// ../runtime-core/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 crypto.createHash("sha256").update(value).digest("hex");
 }
-function buildPayload(input) {
+function buildDomDescriptorPayload(input) {
   return {
     kind: "dom-target",
     method: input.method,
@@ -10014,6 +9980,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)) {
@@ -10055,7 +10024,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;
@@ -10063,9 +10036,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);
@@ -10103,12 +10080,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;
@@ -10751,7 +10738,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 }
     });
@@ -12805,110 +12792,48 @@ function pickStealthProfilePreset(overrides) {
 }
 var OPENSTEER_LIVE_SESSION_LAYOUT = "opensteer-session";
 var OPENSTEER_LIVE_SESSION_VERSION = 1;
-var LEGACY_CLOUD_SESSION_LAYOUT = "opensteer-cloud-session";
-var LEGACY_CLOUD_SESSION_VERSION = 1;
-function resolveLiveSessionRecordPath(rootPath) {
-  return path6__default.default.join(rootPath, "live", "session.json");
+function resolveLiveSessionRecordPath(rootPath, provider) {
+  return path6__default.default.join(rootPath, "live", provider === "local" ? "local.json" : "cloud.json");
 }
-function resolveLegacyLiveBrowserRecordPath(rootPath) {
-  return path6__default.default.join(rootPath, "live", "browser.json");
+function resolveLocalSessionRecordPath(rootPath) {
+  return resolveLiveSessionRecordPath(rootPath, "local");
 }
-function resolveLegacyCloudSessionRecordPath(rootPath) {
-  return path6__default.default.join(rootPath, "live", "cloud-session.json");
+function resolveCloudSessionRecordPath(rootPath) {
+  return resolveLiveSessionRecordPath(rootPath, "cloud");
 }
-async function readPersistedSessionRecord(rootPath) {
-  const sessionPath = resolveLiveSessionRecordPath(rootPath);
-  if (await pathExists(sessionPath)) {
-    const parsed = await readJsonFile(sessionPath);
-    if (isPersistedLocalBrowserSessionRecord(parsed)) {
-      return parsed;
-    }
-    if (isPersistedCloudSessionRecord(parsed)) {
-      return parsed;
-    }
+async function readPersistedSessionRecord(rootPath, provider) {
+  const sessionPath = resolveLiveSessionRecordPath(rootPath, provider);
+  if (!await pathExists(sessionPath)) {
+    return void 0;
   }
-  const legacyCloudPath = resolveLegacyCloudSessionRecordPath(rootPath);
-  if (await pathExists(legacyCloudPath)) {
-    const parsed = await readJsonFile(legacyCloudPath);
-    if (isLegacyCloudSessionRecord(parsed)) {
-      return {
-        layout: OPENSTEER_LIVE_SESSION_LAYOUT,
-        version: OPENSTEER_LIVE_SESSION_VERSION,
-        provider: "cloud",
-        mode: "cloud",
-        ...parsed.workspace === void 0 ? {} : { workspace: parsed.workspace },
-        sessionId: parsed.sessionId,
-        baseUrl: parsed.baseUrl,
-        startedAt: parsed.startedAt,
-        updatedAt: parsed.updatedAt
-      };
-    }
+  const parsed = await readJsonFile(sessionPath);
+  if (provider === "local" && isPersistedLocalBrowserSessionRecord(parsed)) {
+    return parsed;
   }
-  const legacyBrowserPath = resolveLegacyLiveBrowserRecordPath(rootPath);
-  if (await pathExists(legacyBrowserPath)) {
-    const parsed = await readJsonFile(legacyBrowserPath);
-    if (isLegacyLocalBrowserSessionRecord(parsed)) {
-      return {
-        layout: OPENSTEER_LIVE_SESSION_LAYOUT,
-        version: OPENSTEER_LIVE_SESSION_VERSION,
-        provider: "local",
-        mode: "browser",
-        engine: parsed.engine ?? "playwright",
-        ...parsed.endpoint === void 0 ? {} : { endpoint: parsed.endpoint },
-        ...parsed.baseUrl === void 0 ? {} : { baseUrl: parsed.baseUrl },
-        ...parsed.remoteDebuggingUrl === void 0 ? {} : { remoteDebuggingUrl: parsed.remoteDebuggingUrl },
-        ...parsed.sessionDir === void 0 ? {} : { sessionDir: parsed.sessionDir },
-        pid: parsed.pid,
-        startedAt: parsed.startedAt,
-        updatedAt: parsed.startedAt,
-        ...parsed.executablePath === void 0 ? {} : { executablePath: parsed.executablePath },
-        userDataDir: parsed.userDataDir
-      };
-    }
+  if (provider === "cloud" && isPersistedCloudSessionRecord(parsed)) {
+    return parsed;
   }
   return void 0;
 }
 async function readPersistedCloudSessionRecord(rootPath) {
-  const record = await readPersistedSessionRecord(rootPath);
+  const record = await readPersistedSessionRecord(rootPath, "cloud");
   return record?.provider === "cloud" ? record : void 0;
 }
 async function readPersistedLocalBrowserSessionRecord(rootPath) {
-  const record = await readPersistedSessionRecord(rootPath);
+  const record = await readPersistedSessionRecord(rootPath, "local");
   return record?.provider === "local" ? record : void 0;
 }
-async function hasPersistedCloudSession(rootPath) {
-  return await readPersistedCloudSessionRecord(rootPath) !== void 0;
-}
 async function writePersistedSessionRecord(rootPath, record) {
-  await writeJsonFileAtomic(resolveLiveSessionRecordPath(rootPath), record);
-  await clearLegacySessionRecordPaths(rootPath);
+  await writeJsonFileAtomic(resolveLiveSessionRecordPath(rootPath, record.provider), record);
 }
-async function clearPersistedSessionRecord(rootPath) {
-  await Promise.all([
-    removeIfPresent(resolveLiveSessionRecordPath(rootPath)),
-    clearLegacySessionRecordPaths(rootPath)
-  ]);
+async function clearPersistedSessionRecord(rootPath, provider) {
+  await promises.rm(resolveLiveSessionRecordPath(rootPath, provider), { force: true });
 }
 function isPersistedCloudSessionRecord(value) {
-  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "cloud" && value.mode === "cloud" && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.baseUrl === "string" && value.baseUrl.length > 0 && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt);
+  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "cloud" && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.baseUrl === "string" && value.baseUrl.length > 0 && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt);
 }
 function isPersistedLocalBrowserSessionRecord(value) {
-  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "local" && value.mode === "browser" && (value.engine === "playwright" || value.engine === "abp") && typeof value.pid === "number" && Number.isFinite(value.pid) && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) && typeof value.userDataDir === "string" && value.userDataDir.length > 0;
-}
-function isLegacyCloudSessionRecord(value) {
-  return value.layout === LEGACY_CLOUD_SESSION_LAYOUT && value.version === LEGACY_CLOUD_SESSION_VERSION && value.mode === "cloud" && typeof value.sessionId === "string" && value.sessionId.length > 0 && typeof value.baseUrl === "string" && value.baseUrl.length > 0 && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt);
-}
-function isLegacyLocalBrowserSessionRecord(value) {
-  return value.mode === "persistent" && typeof value.pid === "number" && Number.isFinite(value.pid) && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.userDataDir === "string" && value.userDataDir.length > 0;
-}
-async function clearLegacySessionRecordPaths(rootPath) {
-  await Promise.all([
-    removeIfPresent(resolveLegacyLiveBrowserRecordPath(rootPath)),
-    removeIfPresent(resolveLegacyCloudSessionRecordPath(rootPath))
-  ]);
-}
-async function removeIfPresent(filePath) {
-  await promises.rm(filePath, { force: true }).catch(() => void 0);
+  return value.layout === OPENSTEER_LIVE_SESSION_LAYOUT && value.version === OPENSTEER_LIVE_SESSION_VERSION && value.provider === "local" && (value.engine === "playwright" || value.engine === "abp") && typeof value.pid === "number" && Number.isFinite(value.pid) && typeof value.startedAt === "number" && Number.isFinite(value.startedAt) && typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) && typeof value.userDataDir === "string" && value.userDataDir.length > 0;
 }
 
 // ../runtime-core/src/internal/engine-selection.ts
@@ -13114,7 +13039,7 @@ var OpensteerBrowserManager = class {
       await this.closePersistentBrowser(workspace);
       await promises.rm(resolveAbpSessionDir(workspace), { recursive: true, force: true });
       await promises.rm(workspace.browserPath, { recursive: true, force: true });
-      await clearPersistedSessionRecord(workspace.rootPath);
+      await clearPersistedSessionRecord(workspace.rootPath, "local");
       await ensureDirectory(workspace.browserUserDataDir);
     });
   }
@@ -13125,7 +13050,7 @@ var OpensteerBrowserManager = class {
       await this.closePersistentBrowser(workspace);
       await promises.rm(resolveAbpSessionDir(workspace), { recursive: true, force: true });
       await promises.rm(workspace.browserPath, { recursive: true, force: true });
-      await clearPersistedSessionRecord(workspace.rootPath);
+      await clearPersistedSessionRecord(workspace.rootPath, "local");
     });
   }
   async close() {
@@ -13208,7 +13133,7 @@ var OpensteerBrowserManager = class {
         return await this.createAdoptedAbpEngine(liveRecord);
       } catch (error) {
         await terminateProcess(launched.process.pid ?? 0).catch(() => void 0);
-        await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+        await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
         throw error;
       }
     });
@@ -13300,7 +13225,7 @@ var OpensteerBrowserManager = class {
         });
       } catch (error) {
         await terminateProcess(launched.pid).catch(() => void 0);
-        await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+        await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
         throw error;
       }
     });
@@ -13406,7 +13331,7 @@ var OpensteerBrowserManager = class {
       return void 0;
     }
     if (!isProcessRunning(live.pid)) {
-      await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+      await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
       return void 0;
     }
     if (live.engine === "playwright") {
@@ -13446,7 +13371,7 @@ var OpensteerBrowserManager = class {
   async closePersistentBrowser(workspace) {
     const live = await this.readStoredLiveBrowser(workspace);
     if (!live) {
-      await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+      await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
       return;
     }
     if (live.engine === "playwright") {
@@ -13454,15 +13379,15 @@ var OpensteerBrowserManager = class {
         await requestBrowserClose(live.endpoint).catch(() => void 0);
       }
       if (await waitForProcessExit(live.pid, BROWSER_CLOSE_TIMEOUT_MS)) {
-        await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+        await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
         return;
       }
       await terminateProcess(live.pid).catch(() => void 0);
-      await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+      await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
       return;
     }
     await terminateProcess(live.pid).catch(() => void 0);
-    await clearPersistedSessionRecord(workspace.rootPath).catch(() => void 0);
+    await clearPersistedSessionRecord(workspace.rootPath, "local").catch(() => void 0);
   }
   async writeLivePersistentBrowser(workspace, live) {
     await writePersistedSessionRecord(
@@ -13485,7 +13410,6 @@ function toPersistedLocalBrowserSessionRecord(workspace, live) {
     layout: "opensteer-session",
     version: 1,
     provider: "local",
-    mode: "browser",
     ...workspace === void 0 ? {} : { workspace },
     engine: live.engine,
     ...live.endpoint === void 0 ? {} : { endpoint: live.endpoint },
@@ -15073,7 +14997,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,
@@ -15093,7 +15017,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,
@@ -19422,7 +19345,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,
@@ -19919,11 +19842,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) {
@@ -20026,7 +19949,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);
   }
@@ -20038,7 +19961,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) {
@@ -20077,7 +20000,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 = {
@@ -20087,7 +20010,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) {
@@ -20131,6 +20054,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";
@@ -20635,7 +20559,82 @@ var VOID_TAGS2 = /* @__PURE__ */ new Set([
 ]);
 
 // ../runtime-core/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__namespace.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);
@@ -20654,13 +20653,24 @@ 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),
+    counterRecords: dense.counterRecords
   };
 }
 async function getMainDocumentSnapshot(engine, pageRef) {
@@ -20889,6 +20899,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, {
@@ -20906,7 +20919,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 {
@@ -22274,6 +22288,8 @@ var OpensteerSessionRuntime = class {
   injectedEngine;
   engineFactory;
   policy;
+  injectedDescriptorStore;
+  registryOverrides;
   cleanupRootOnClose;
   sessionInfoBase;
   root;
@@ -22291,13 +22307,15 @@ var OpensteerSessionRuntime = class {
   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__default.default.resolve(process.cwd(), ".opensteer", "temporary", crypto.randomUUID());
     this.injectedEngine = options.engine;
     this.engineFactory = options.engineFactory;
     this.policy = options.policy ?? defaultPolicy();
+    this.injectedDescriptorStore = options.descriptorStore;
+    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) {
@@ -22333,7 +22351,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}"`
       );
@@ -24749,8 +24767,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,
@@ -25378,8 +25395,7 @@ var OpensteerSessionRuntime = class {
           recordId: input.recordId,
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -25420,8 +25436,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -25467,8 +25482,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -26339,18 +26353,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 = counter ? { kind: "live", locator: counter.locator, anchor: counter.anchor } : { 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(
@@ -27593,7 +27601,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 }
     });
@@ -28262,21 +28270,40 @@ var OpensteerSessionRuntime = class {
       };
     }
     const counter = this.latestSnapshot?.counterRecords.get(target.element);
-    if (!counter) {
-      throw new Error(`no counter ${String(target.element)} is available in the latest snapshot`);
+    if (counter) {
+      return {
+        kind: "live",
+        locator: counter.locator,
+        anchor: counter.anchor
+      };
     }
     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 = {}) {
@@ -28302,6 +28329,7 @@ var OpensteerSessionRuntime = class {
       engine,
       root,
       namespace: this.workspace,
+      ...this.injectedDescriptorStore === void 0 ? {} : { descriptorStore: this.injectedDescriptorStore },
       policy: this.policy
     });
     this.computer = createComputerUseRuntime({
@@ -28888,7 +28916,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
@@ -31043,7 +31070,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;
 }
@@ -31104,19 +31131,22 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
       ...options.browser === void 0 ? {} : { browser: options.browser },
       ...options.context === void 0 ? {} : { context: options.context }
     });
-    super(buildSharedRuntimeOptions({
-      name: publicWorkspace ?? "default",
-      rootPath,
-      ...publicWorkspace === void 0 ? {} : { workspaceName: publicWorkspace },
-      ...options.browser === void 0 ? {} : { browser: options.browser },
-      ...options.launch === void 0 ? {} : { launch: options.launch },
-      ...options.context === void 0 ? {} : { context: options.context },
-      engineName,
-      ...options.engine === void 0 ? {} : { engine: options.engine },
-      ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
-      ...options.policy === void 0 ? {} : { policy: options.policy },
-      cleanupRootOnClose
-    }));
+    super(
+      buildSharedRuntimeOptions({
+        name: publicWorkspace ?? "default",
+        rootPath,
+        ...publicWorkspace === void 0 ? {} : { workspaceName: publicWorkspace },
+        ...options.browser === void 0 ? {} : { browser: options.browser },
+        ...options.launch === void 0 ? {} : { launch: options.launch },
+        ...options.context === void 0 ? {} : { context: options.context },
+        engineName,
+        ...options.engine === void 0 ? {} : { engine: options.engine },
+        ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
+        ...options.policy === void 0 ? {} : { policy: options.policy },
+        ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
+        cleanupRootOnClose
+      })
+    );
   }
 };
 var OpensteerSessionRuntime2 = class extends OpensteerSessionRuntime {
@@ -31129,18 +31159,21 @@ var OpensteerSessionRuntime2 = class extends OpensteerSessionRuntime {
       ...options.browser === void 0 ? {} : { browser: options.browser },
       ...options.context === void 0 ? {} : { context: options.context }
     });
-    super(buildSharedRuntimeOptions({
-      name: options.name,
-      rootPath,
-      ...options.browser === void 0 ? {} : { browser: options.browser },
-      ...options.launch === void 0 ? {} : { launch: options.launch },
-      ...options.context === void 0 ? {} : { context: options.context },
-      engineName,
-      ...options.engine === void 0 ? {} : { engine: options.engine },
-      ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
-      ...options.policy === void 0 ? {} : { policy: options.policy },
-      cleanupRootOnClose
-    }));
+    super(
+      buildSharedRuntimeOptions({
+        name: options.name,
+        rootPath,
+        ...options.browser === void 0 ? {} : { browser: options.browser },
+        ...options.launch === void 0 ? {} : { launch: options.launch },
+        ...options.context === void 0 ? {} : { context: options.context },
+        engineName,
+        ...options.engine === void 0 ? {} : { engine: options.engine },
+        ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
+        ...options.policy === void 0 ? {} : { policy: options.policy },
+        ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
+        cleanupRootOnClose
+      })
+    );
   }
 };
 function buildSharedRuntimeOptions(input) {
@@ -31160,6 +31193,7 @@ function buildSharedRuntimeOptions(input) {
     ...input.engine === void 0 ? {} : { engine: input.engine },
     ...input.engine === void 0 ? { engineFactory } : {},
     ...input.policy === void 0 ? {} : { policy: input.policy },
+    ...input.descriptorStore === void 0 ? {} : { descriptorStore: input.descriptorStore },
     cleanupRootOnClose: input.cleanupRootOnClose,
     sessionInfo: {
       provider: {
@@ -31183,45 +31217,44 @@ function resolveOwnership(browser) {
   return typeof browser === "object" && browser.mode === "attach" ? "attached" : "owned";
 }
 
-// src/mode/config.ts
-var OPENSTEER_EXECUTION_MODES = ["local", "cloud"];
-function assertExecutionModeSupportsEngine(mode, engine) {
+// src/provider/config.ts
+var OPENSTEER_PROVIDER_KINDS = ["local", "cloud"];
+function assertProviderSupportsEngine(provider, engine) {
   if (engine !== "abp") {
     return;
   }
-  if (mode === "cloud") {
+  if (provider === "cloud") {
     throw new Error(
-      "ABP is not supported in cloud mode. Cloud mode currently requires Playwright."
+      "ABP is not supported for provider=cloud. Cloud provider currently requires Playwright."
     );
   }
 }
-function normalizeOpensteerExecutionMode(value, source = "OPENSTEER_MODE") {
+function normalizeOpensteerProviderKind(value, source = "OPENSTEER_PROVIDER") {
   const normalized = value.trim().toLowerCase();
-  if (normalized === OPENSTEER_EXECUTION_MODES[0] || normalized === OPENSTEER_EXECUTION_MODES[1]) {
+  if (normalized === OPENSTEER_PROVIDER_KINDS[0] || normalized === OPENSTEER_PROVIDER_KINDS[1]) {
     return normalized;
   }
   throw new Error(
-    `${source} must be one of ${OPENSTEER_EXECUTION_MODES.join(", ")}; received "${value}".`
+    `${source} must be one of ${OPENSTEER_PROVIDER_KINDS.join(", ")}; received "${value}".`
   );
 }
-function resolveOpensteerExecutionMode(input = {}) {
-  const explicitFlags = [input.local, input.cloud].filter(Boolean).length;
-  if (explicitFlags > 1) {
-    throw new Error("Choose exactly one execution mode: local or cloud.");
-  }
-  if (input.explicit) {
-    return input.explicit;
-  }
-  if (input.local) {
-    return "local";
-  }
-  if (input.cloud) {
-    return "cloud";
+function resolveOpensteerProvider(input = {}) {
+  if (input.provider) {
+    return {
+      kind: input.provider.kind,
+      source: "explicit"
+    };
   }
-  if (input.environment !== void 0 && input.environment.trim().length > 0) {
-    return normalizeOpensteerExecutionMode(input.environment);
+  if (input.environmentProvider !== void 0 && input.environmentProvider.trim().length > 0) {
+    return {
+      kind: normalizeOpensteerProviderKind(input.environmentProvider),
+      source: "env"
+    };
   }
-  return "local";
+  return {
+    kind: "local",
+    source: "default"
+  };
 }
 var execFile2 = util.promisify(child_process.execFile);
 var DEFAULT_CAPTURE_TIMEOUT_MS = 3e4;
@@ -31803,15 +31836,12 @@ var OpensteerCloudClient = class {
     return await response.json();
   }
   async issueAccess(sessionId, capabilities) {
-    const response = await this.request(
-      `/v1/sessions/${encodeURIComponent(sessionId)}/access`,
-      {
-        method: "POST",
-        body: {
-          capabilities
-        }
+    const response = await this.request(`/v1/sessions/${encodeURIComponent(sessionId)}/access`, {
+      method: "POST",
+      body: {
+        capabilities
       }
-    );
+    });
     return await response.json();
   }
   async closeSession(sessionId) {
@@ -31869,6 +31899,34 @@ var OpensteerCloudClient = class {
   async syncBrowserProfileCookies(input) {
     return syncBrowserProfileCookies(this, input);
   }
+  async importSelectorCache(entries) {
+    const response = await this.request("/selector-cache/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
+  async importRequestPlans(entries) {
+    const response = await this.request("/registry/request-plans/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
+  async importRecipes(entries) {
+    const response = await this.request("/registry/recipes/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
+  async importAuthRecipes(entries) {
+    const response = await this.request("/registry/auth-recipes/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
   buildAuthorizationHeader() {
     return `Bearer ${this.config.apiKey}`;
   }
@@ -31939,22 +31997,26 @@ function wrapCloudFetchError(error, input) {
 
 // src/cloud/config.ts
 function resolveCloudConfig(input = {}) {
-  const mode = resolveOpensteerExecutionMode({
-    ...input.mode === void 0 ? {} : { explicit: input.mode },
-    ...input.enabled === void 0 ? {} : { cloud: input.enabled },
-    ...process.env.OPENSTEER_MODE === void 0 ? {} : { environment: process.env.OPENSTEER_MODE }
+  const provider = resolveOpensteerProvider({
+    ...input.provider === void 0 ? {} : { provider: input.provider },
+    ...input.environmentProvider === void 0 ? {} : { environmentProvider: input.environmentProvider }
   });
-  if (mode !== "cloud") {
+  if (provider.kind !== "cloud") {
     return void 0;
   }
-  const apiKey = input.apiKey ?? process.env.OPENSTEER_API_KEY;
+  const cloudProvider = input.provider?.kind === "cloud" ? input.provider : void 0;
+  const apiKey = cloudProvider?.apiKey ?? process.env.OPENSTEER_API_KEY;
   if (!apiKey || apiKey.trim().length === 0) {
-    throw new Error("Cloud mode requires OPENSTEER_API_KEY or cloud.apiKey.");
+    throw new Error("provider=cloud requires OPENSTEER_API_KEY or provider.apiKey.");
+  }
+  const baseUrl = cloudProvider?.baseUrl ?? process.env.OPENSTEER_BASE_URL;
+  if (!baseUrl || baseUrl.trim().length === 0) {
+    throw new Error("provider=cloud requires OPENSTEER_BASE_URL or provider.baseUrl.");
   }
   return {
     apiKey: apiKey.trim(),
-    baseUrl: (input.baseUrl ?? process.env.OPENSTEER_BASE_URL ?? "https://api.opensteer.dev").trim().replace(/\/+$/, ""),
-    ...input.browserProfile === void 0 ? {} : { browserProfile: input.browserProfile }
+    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
+    ...cloudProvider?.browserProfile === void 0 ? {} : { browserProfile: cloudProvider.browserProfile }
   };
 }
 var OpensteerSemanticRestError = class extends Error {
@@ -32177,9 +32239,7 @@ var OpensteerCloudAutomationClient = class {
       if (registration.kind === "route") {
         await this.route(registration.input);
       } else {
-        await this.interceptScript(
-          registration.input
-        );
+        await this.interceptScript(registration.input);
       }
     }
   }
@@ -32378,6 +32438,116 @@ function asRecord(value) {
   return value;
 }
 
+// src/cloud/registry-sync.ts
+var REGISTRY_SYNC_MAX_PAYLOAD_BYTES = 15e5;
+var REGISTRY_SYNC_MAX_ENTRIES_PER_BATCH = 100;
+async function syncLocalRegistryToCloud(client, workspace, store) {
+  const [descriptors, requestPlans, recipes, authRecipes] = await Promise.all([
+    store.registry.descriptors.list(),
+    store.registry.requestPlans.list(),
+    store.registry.recipes.list(),
+    store.registry.authRecipes.list()
+  ]);
+  const selectorEntries = descriptors.flatMap((record) => {
+    const entry = toSelectorCacheImportEntry(workspace, record);
+    return entry === void 0 ? [] : [entry];
+  });
+  await Promise.all([
+    importInBatches(selectorEntries, (entries) => client.importSelectorCache(entries)),
+    importInBatches(
+      requestPlans.map((record) => toRequestPlanImportEntry(workspace, record)),
+      (entries) => client.importRequestPlans(entries)
+    ),
+    importInBatches(
+      recipes.map((record) => toRegistryImportEntry(workspace, record)),
+      (entries) => client.importRecipes(entries)
+    ),
+    importInBatches(
+      authRecipes.map((record) => toRegistryImportEntry(workspace, record)),
+      (entries) => client.importAuthRecipes(entries)
+    )
+  ]);
+}
+function toSelectorCacheImportEntry(workspace, record) {
+  const descriptor = parseDomDescriptorRecord(record);
+  if (descriptor === void 0) {
+    return void 0;
+  }
+  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
+  };
+}
+function toRegistryImportEntry(workspace, record) {
+  return {
+    workspace,
+    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 toRequestPlanImportEntry(workspace, record) {
+  return {
+    workspace,
+    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,
+    ...record.freshness === void 0 ? {} : { freshness: record.freshness },
+    createdAt: record.createdAt,
+    updatedAt: record.updatedAt
+  };
+}
+async function importInBatches(entries, importBatch) {
+  if (entries.length === 0) {
+    return;
+  }
+  for (const batch of chunkEntries(entries)) {
+    await importBatch(batch);
+  }
+}
+function chunkEntries(entries) {
+  const batches = [];
+  let currentBatch = [];
+  for (const entry of entries) {
+    if (payloadByteLength([entry]) > REGISTRY_SYNC_MAX_PAYLOAD_BYTES) {
+      continue;
+    }
+    if (currentBatch.length === 0) {
+      currentBatch = [entry];
+      continue;
+    }
+    const nextBatch = [...currentBatch, entry];
+    if (nextBatch.length > REGISTRY_SYNC_MAX_ENTRIES_PER_BATCH || payloadByteLength(nextBatch) > REGISTRY_SYNC_MAX_PAYLOAD_BYTES) {
+      batches.push(currentBatch);
+      currentBatch = [entry];
+      continue;
+    }
+    currentBatch = nextBatch;
+  }
+  if (currentBatch.length > 0) {
+    batches.push(currentBatch);
+  }
+  return batches;
+}
+function payloadByteLength(entries) {
+  return Buffer.byteLength(JSON.stringify({ entries }), "utf8");
+}
+
 // src/cloud/session-proxy.ts
 var TEMPORARY_CLOUD_WORKSPACE_PREFIX = "opensteer-cloud-workspace-";
 var CloudSessionProxy = class {
@@ -32682,7 +32852,6 @@ var CloudSessionProxy = class {
       layout: "opensteer-session",
       version: 1,
       provider: "cloud",
-      mode: "cloud",
       ...this.workspace === void 0 ? {} : { workspace: this.workspace },
       sessionId: this.sessionId,
       baseUrl: this.sessionBaseUrl,
@@ -32729,9 +32898,11 @@ var CloudSessionProxy = class {
     assertSupportedCloudBrowserMode(input.browser);
     const persisted = await this.loadPersistedSession();
     if (persisted !== void 0 && await this.isReusableCloudSession(persisted.sessionId)) {
+      await this.syncRegistryToCloud();
       this.bindClient(persisted);
       return;
     }
+    await this.syncRegistryToCloud();
     const session = await this.cloud.createSession({
       ...this.workspace === void 0 ? {} : { name: this.workspace },
       ...input.launch === void 0 ? {} : { browser: input.launch },
@@ -32742,7 +32913,6 @@ var CloudSessionProxy = class {
       layout: "opensteer-session",
       version: 1,
       provider: "cloud",
-      mode: "cloud",
       ...this.workspace === void 0 ? {} : { workspace: this.workspace },
       sessionId: session.sessionId,
       baseUrl: session.baseUrl,
@@ -32752,6 +32922,16 @@ var CloudSessionProxy = class {
     await this.writePersistedSession(record);
     this.bindClient(record);
   }
+  async syncRegistryToCloud() {
+    if (this.workspace === void 0) {
+      return;
+    }
+    try {
+      const workspaceStore = await this.ensureWorkspaceStore();
+      await syncLocalRegistryToCloud(this.cloud, this.workspace, workspaceStore);
+    } catch {
+    }
+  }
   bindClient(record) {
     this.sessionId = record.sessionId;
     this.sessionBaseUrl = record.baseUrl;
@@ -32781,7 +32961,7 @@ var CloudSessionProxy = class {
     await writePersistedSessionRecord(workspace.rootPath, record);
   }
   async clearPersistedSession() {
-    await clearPersistedSessionRecord(this.rootPath).catch(() => void 0);
+    await clearPersistedSessionRecord(this.rootPath, "cloud").catch(() => void 0);
   }
   async isReusableCloudSession(sessionId) {
     try {
@@ -32824,49 +33004,30 @@ function isMissingCloudSessionError(error) {
 
 // src/sdk/runtime-resolution.ts
 function resolveOpensteerRuntimeConfig(input = {}) {
-  if (input.provider?.kind === "cloud") {
-    return {
-      mode: "cloud",
-      cloud: resolveCloudConfig({
-        enabled: true,
-        ...input.provider,
-        mode: "cloud"
-      })
-    };
-  }
-  if (input.provider?.kind === "local") {
-    return {
-      mode: "local"
-    };
-  }
-  const mode = resolveOpensteerExecutionMode({
-    ...input.mode === void 0 ? {} : { explicit: input.mode },
-    cloud: input.cloud !== void 0 && input.cloud !== false,
-    ...input.environmentMode === void 0 ? {} : { environment: input.environmentMode }
+  const provider = resolveOpensteerProvider({
+    ...input.provider === void 0 ? {} : { provider: input.provider },
+    ...input.environmentProvider === void 0 ? {} : { environmentProvider: input.environmentProvider }
   });
-  if (mode === "cloud") {
+  if (provider.kind === "cloud") {
     return {
-      mode,
+      provider,
       cloud: resolveCloudConfig({
-        enabled: true,
-        ...typeof input.cloud === "object" ? input.cloud : {},
-        mode
+        ...input.provider === void 0 ? {} : { provider: input.provider },
+        ...input.environmentProvider === void 0 ? {} : { environmentProvider: input.environmentProvider }
       })
     };
   }
-  return { mode };
+  return { provider };
 }
 function createOpensteerSemanticRuntime(input = {}) {
   const runtimeOptions = input.runtimeOptions ?? {};
   const engine = input.engine ?? runtimeOptions.engineName ?? DEFAULT_OPENSTEER_ENGINE;
   const config = resolveOpensteerRuntimeConfig({
-    ...input.cloud === void 0 ? {} : { cloud: input.cloud },
     ...input.provider === void 0 ? {} : { provider: input.provider },
-    ...input.mode === void 0 ? {} : { mode: input.mode },
-    ...process.env.OPENSTEER_MODE === void 0 ? {} : { environmentMode: process.env.OPENSTEER_MODE }
+    ...process.env.OPENSTEER_PROVIDER === void 0 ? {} : { environmentProvider: process.env.OPENSTEER_PROVIDER }
   });
-  assertExecutionModeSupportsEngine(config.mode, engine);
-  if (config.mode === "cloud") {
+  assertProviderSupportsEngine(config.provider.kind, engine);
+  if (config.provider.kind === "cloud") {
     return new CloudSessionProxy(new OpensteerCloudClient(config.cloud), {
       ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
       ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
@@ -32886,41 +33047,37 @@ var Opensteer = class {
   browserManager;
   browser;
   constructor(options = {}) {
+    const { provider, engineName, ...runtimeOptions } = options;
     const runtimeConfig = resolveOpensteerRuntimeConfig({
-      ...options.cloud === void 0 ? {} : { cloud: options.cloud },
-      ...options.provider === void 0 ? {} : { provider: options.provider },
-      ...process.env.OPENSTEER_MODE === void 0 ? {} : { environmentMode: process.env.OPENSTEER_MODE }
+      ...provider === void 0 ? {} : { provider },
+      ...process.env.OPENSTEER_PROVIDER === void 0 ? {} : { environmentProvider: process.env.OPENSTEER_PROVIDER }
     });
-    if (runtimeConfig.mode === "cloud") {
+    if (runtimeConfig.provider.kind === "cloud") {
       this.browserManager = void 0;
       this.runtime = createOpensteerSemanticRuntime({
-        mode: runtimeConfig.mode,
-        ...options.cloud === void 0 ? {} : { cloud: options.cloud },
-        ...options.provider === void 0 ? {} : { provider: options.provider },
-        ...options.engineName === void 0 ? {} : { engine: options.engineName },
+        ...provider === void 0 ? {} : { provider },
+        ...engineName === void 0 ? {} : { engine: engineName },
         runtimeOptions: {
-          ...options
+          ...runtimeOptions
         }
       });
       this.browser = createUnsupportedBrowserController();
       return;
     }
     this.browserManager = new OpensteerBrowserManager({
-      ...options.rootDir === void 0 ? {} : { rootDir: options.rootDir },
-      ...options.rootPath === void 0 ? {} : { rootPath: options.rootPath },
-      ...options.workspace === void 0 ? {} : { workspace: options.workspace },
-      ...options.engineName === void 0 ? {} : { engineName: options.engineName },
-      ...options.browser === void 0 ? {} : { browser: options.browser },
-      ...options.launch === void 0 ? {} : { launch: options.launch },
-      ...options.context === void 0 ? {} : { context: options.context }
+      ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
+      ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
+      ...runtimeOptions.workspace === void 0 ? {} : { workspace: runtimeOptions.workspace },
+      ...engineName === void 0 ? {} : { engineName },
+      ...runtimeOptions.browser === void 0 ? {} : { browser: runtimeOptions.browser },
+      ...runtimeOptions.launch === void 0 ? {} : { launch: runtimeOptions.launch },
+      ...runtimeOptions.context === void 0 ? {} : { context: runtimeOptions.context }
     });
     this.runtime = createOpensteerSemanticRuntime({
-      mode: runtimeConfig.mode,
-      ...options.cloud === void 0 ? {} : { cloud: options.cloud },
-      ...options.provider === void 0 ? {} : { provider: options.provider },
-      ...options.engineName === void 0 ? {} : { engine: options.engineName },
+      ...provider === void 0 ? {} : { provider },
+      ...engineName === void 0 ? {} : { engine: engineName },
       runtimeOptions: {
-        ...options,
+        ...runtimeOptions,
         rootPath: this.browserManager.rootPath,
         cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect
       }
@@ -32969,10 +33126,6 @@ var Opensteer = class {
     } : input;
     return this.runtime.addInitScript(normalized);
   }
-  async snapshot(input = {}) {
-    const mode = typeof input === "string" ? input : input.mode;
-    return this.runtime.snapshot(mode === void 0 ? {} : { mode });
-  }
   async click(input) {
     const normalized = normalizeTargetOptions(input);
     return this.runtime.click(normalized);
@@ -33052,6 +33205,9 @@ var Opensteer = class {
       await delay2(pollIntervalMs);
     }
   }
+  async snapshot(input = {}) {
+    return this.runtime.snapshot(typeof input === "string" ? { mode: input } : input);
+  }
   async saveNetwork(input) {
     return this.runtime.saveNetwork(input);
   }
@@ -33273,6 +33429,7 @@ exports.OpensteerCloudClient = OpensteerCloudClient;
 exports.OpensteerRuntime = OpensteerRuntime;
 exports.OpensteerSessionRuntime = OpensteerSessionRuntime2;
 exports.STABLE_PRIMARY_ATTR_KEYS = STABLE_PRIMARY_ATTR_KEYS;
+exports.assertProviderSupportsEngine = assertProviderSupportsEngine;
 exports.buildArrayFieldPathCandidates = buildArrayFieldPathCandidates;
 exports.buildPathCandidates = buildPathCandidates;
 exports.buildPathSelectorHint = buildPathSelectorHint;
@@ -33292,26 +33449,26 @@ exports.defaultTimeoutPolicy = defaultTimeoutPolicy;
 exports.delayWithSignal = delayWithSignal;
 exports.discoverLocalCdpBrowsers = discoverLocalCdpBrowsers;
 exports.dispatchSemanticOperation = dispatchSemanticOperation;
-exports.hasPersistedCloudSession = hasPersistedCloudSession;
 exports.inspectCdpEndpoint = inspectCdpEndpoint;
 exports.isCurrentUrlField = isCurrentUrlField;
 exports.isValidCssAttributeKey = isValidCssAttributeKey;
 exports.listLocalChromeProfiles = listLocalChromeProfiles;
 exports.normalizeExtractedValue = normalizeExtractedValue;
 exports.normalizeOpensteerEngineName = normalizeOpensteerEngineName;
-exports.normalizeOpensteerExecutionMode = normalizeOpensteerExecutionMode;
+exports.normalizeOpensteerProviderKind = normalizeOpensteerProviderKind;
 exports.normalizeWorkspaceId = normalizeWorkspaceId;
 exports.readPersistedCloudSessionRecord = readPersistedCloudSessionRecord;
 exports.readPersistedLocalBrowserSessionRecord = readPersistedLocalBrowserSessionRecord;
 exports.readPersistedSessionRecord = readPersistedSessionRecord;
 exports.resolveCloudConfig = resolveCloudConfig;
-exports.resolveCloudSessionRecordPath = resolveLiveSessionRecordPath;
+exports.resolveCloudSessionRecordPath = resolveCloudSessionRecordPath;
 exports.resolveDomActionBridge = resolveDomActionBridge;
 exports.resolveExtractedValueInContext = resolveExtractedValueInContext;
 exports.resolveFilesystemWorkspacePath = resolveFilesystemWorkspacePath;
 exports.resolveLiveSessionRecordPath = resolveLiveSessionRecordPath;
+exports.resolveLocalSessionRecordPath = resolveLocalSessionRecordPath;
 exports.resolveOpensteerEngineName = resolveOpensteerEngineName;
-exports.resolveOpensteerExecutionMode = resolveOpensteerExecutionMode;
+exports.resolveOpensteerProvider = resolveOpensteerProvider;
 exports.resolveOpensteerRuntimeConfig = resolveOpensteerRuntimeConfig;
 exports.runWithPolicyTimeout = runWithPolicyTimeout;
 exports.sanitizeElementPath = sanitizeElementPath;