opensteer 0.8.10 → 0.8.11

package/dist/{chunk-F3X6UOEN.js → chunk-33FDEOQY.js}

@@ -1560,6 +1560,9 @@ function isBrowserCoreError(value) {
 // ../browser-core/src/cdp-visual-stability.ts
 var DEFAULT_VISUAL_STABILITY_SETTLE_MS = 750;
 
+// ../browser-core/src/post-load-tracker.ts
+var DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS = 400;
+
 // ../protocol/src/identity.ts
 var refPrefixes = [
   "session",
@@ -6749,9 +6752,23 @@ var opensteerInspectStorageInputSchema = objectSchema(
     title: "OpensteerInspectStorageInput"
   }
 );
+var opensteerComputerMouseButtonSchema = enumSchema(["left", "middle", "right"], {
+  title: "OpensteerComputerMouseButton"
+});
+var opensteerComputerKeyModifierSchema = enumSchema(
+  ["Shift", "Control", "Alt", "Meta"],
+  {
+    title: "OpensteerComputerKeyModifier"
+  }
+);
 var opensteerDomClickInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
+    button: opensteerComputerMouseButtonSchema,
+    clickCount: integerSchema({ minimum: 1 }),
+    modifiers: arraySchema(opensteerComputerKeyModifierSchema, {
+      uniqueItems: true
+    }),
     persistAsDescription: stringSchema(),
     captureNetwork: stringSchema({ minLength: 1 })
   },
@@ -6851,18 +6868,6 @@ var opensteerSessionCloseOutputSchema = objectSchema(
     required: ["closed"]
   }
 );
-var opensteerComputerMouseButtonSchema = enumSchema(
-  ["left", "middle", "right"],
-  {
-    title: "OpensteerComputerMouseButton"
-  }
-);
-var opensteerComputerKeyModifierSchema = enumSchema(
-  ["Shift", "Control", "Alt", "Meta"],
-  {
-    title: "OpensteerComputerKeyModifier"
-  }
-);
 var opensteerComputerAnnotationSchema = enumSchema(opensteerComputerAnnotationNames, {
   title: "OpensteerComputerAnnotation"
 });
@@ -9053,6 +9058,7 @@ var NAVIGATION_VISUAL_STABILITY_PROFILE = {
   scope: "visible-frames",
   timeoutMs: 7e3
 };
+var NAVIGATION_POST_LOAD_CAPTURE_WINDOW_MS = 1e3;
 var defaultDomActionSettleObserver = {
   async settle(input) {
     if (input.trigger !== "dom-action") {
@@ -9088,6 +9094,13 @@ var defaultNavigationSettleObserver = {
       return false;
     }
     try {
+      await input.engine.waitForPostLoadQuiet({
+        pageRef: input.pageRef,
+        timeoutMs: effectiveTimeout,
+        quietMs: DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS,
+        captureWindowMs: Math.min(NAVIGATION_POST_LOAD_CAPTURE_WINDOW_MS, effectiveTimeout),
+        signal: input.signal
+      });
       await input.engine.waitForVisualStability({
         pageRef: input.pageRef,
         timeoutMs: effectiveTimeout,
@@ -10799,16 +10812,7 @@ var MemoryDomDescriptorStore = class {
 // ../runtime-core/src/action-boundary.ts
 var actionBoundaryDiagnosticsBySignal = /* @__PURE__ */ new WeakMap();
 async function captureActionBoundarySnapshot(engine, pageRef) {
-  const frames = await engine.listFrames({ pageRef });
-  const mainFrame = frames.find((frame) => frame.isMainFrame);
-  if (!mainFrame) {
-    throw new Error(`page ${pageRef} does not expose a main frame`);
-  }
-  return {
-    pageRef,
-    documentRef: mainFrame.documentRef,
-    url: mainFrame.url
-  };
+  return engine.getActionBoundarySnapshot({ pageRef });
 }
 function createActionBoundaryDiagnostics(input) {
   return {
@@ -23607,6 +23611,9 @@ var OpensteerSessionRuntime = class {
         const result = await this.requireDom().click({
           pageRef,
           target,
+          ...input.button === void 0 ? {} : { button: input.button },
+          ...input.clickCount === void 0 ? {} : { clickCount: input.clickCount },
+          ...input.modifiers === void 0 ? {} : { modifiers: input.modifiers },
           timeout
         });
         return {
@@ -32326,7 +32333,11 @@ function screenshotMediaType(format2) {
 var SINGLE_ATTRIBUTE_PRIORITY = Array.from(
   /* @__PURE__ */ new Set(["data-testid", "data-test", "data-qa", "data-cy", "id", ...STABLE_PRIMARY_ATTR_KEYS])
 );
-var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
+function createFlowRecorderInstallScript(options = {}) {
+  const normalizedOptions = {
+    showStopButton: options.showStopButton ?? true
+  };
+  return String.raw`(() => {
   const TOP_LEVEL_ONLY = (() => {
     try {
       return window.top === window.self;
@@ -32351,6 +32362,7 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
   const volatileLazyLoadingAttrs = new Set(${JSON.stringify([...VOLATILE_LAZY_LOADING_ATTRS])});
   const volatileClassTokens = new Set(${JSON.stringify([...VOLATILE_CLASS_TOKENS])});
   const volatileLazyClassTokens = new Set(${JSON.stringify([...VOLATILE_LAZY_CLASS_TOKENS])});
+  const options = ${JSON.stringify(normalizedOptions)};
 
   const previous = globalScope[recorderKey];
   if (previous && typeof previous.dispose === "function") {
@@ -32361,6 +32373,7 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
   const cleanup = [];
   const inputFlushTimers = new Map();
   const pendingInputs = new Map();
+  let historyStateCache = undefined;
   let stopRequested = false;
   let pendingWheel = undefined;
 
@@ -32681,44 +32694,76 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
     inputFlushTimers.set(selector, timerId);
   }
 
-  function updateHistoryState(mode, nextUrl) {
-    let state;
-    try {
-      const raw = sessionStorage.getItem(historyStateKey);
-      state = raw ? JSON.parse(raw) : undefined;
-    } catch {
-      state = undefined;
+  function createDefaultHistoryState(currentUrl) {
+    return {
+      entries: [currentUrl],
+      index: 0,
+    };
+  }
+
+  function normalizeHistoryState(state) {
+    if (
+      !state ||
+      !Array.isArray(state.entries) ||
+      !state.entries.every((entry) => typeof entry === "string") ||
+      !Number.isInteger(state.index)
+    ) {
+      return undefined;
     }
-    if (!state || !Array.isArray(state.entries) || typeof state.index !== "number") {
-      state = { entries: [location.href], index: 0 };
+    const entries = state.entries.slice();
+    if (entries.length === 0) {
+      return createDefaultHistoryState(location.href);
     }
+    return {
+      entries,
+      index: Math.min(entries.length - 1, Math.max(0, state.index)),
+    };
+  }
+
+  function writeHistoryState(state) {
+    const normalized = normalizeHistoryState(state) ?? createDefaultHistoryState(location.href);
+    historyStateCache = normalized;
+    try {
+      sessionStorage.setItem(historyStateKey, JSON.stringify(normalized));
+    } catch {}
+    return normalized;
+  }
+
+  function applyHistoryState(state, mode, nextUrl) {
+    const current = normalizeHistoryState(state) ?? createDefaultHistoryState(location.href);
+    const nextState = {
+      entries: current.entries.slice(),
+      index: current.index,
+    };
     if (mode === "replace") {
-      state.entries[state.index] = nextUrl;
+      nextState.entries[nextState.index] = nextUrl;
     } else if (mode === "push") {
-      state.entries = state.entries.slice(0, state.index + 1);
-      state.entries.push(nextUrl);
-      state.index = state.entries.length - 1;
+      nextState.entries = nextState.entries.slice(0, nextState.index + 1);
+      nextState.entries.push(nextUrl);
+      nextState.index = nextState.entries.length - 1;
     } else if (mode === "back") {
-      state.index = Math.max(0, state.index - 1);
+      nextState.index = Math.max(0, nextState.index - 1);
     } else if (mode === "forward") {
-      state.index = Math.min(state.entries.length - 1, state.index + 1);
+      nextState.index = Math.min(nextState.entries.length - 1, nextState.index + 1);
     }
-    try {
-      sessionStorage.setItem(historyStateKey, JSON.stringify(state));
-    } catch {}
-    return state;
+    return nextState;
+  }
+
+  function updateHistoryState(mode, nextUrl) {
+    return writeHistoryState(applyHistoryState(readHistoryState(), mode, nextUrl));
   }
 
   function readHistoryState() {
+    const cached = normalizeHistoryState(historyStateCache);
+    if (cached) {
+      historyStateCache = cached;
+      return cached;
+    }
     try {
       const raw = sessionStorage.getItem(historyStateKey);
-      const parsed = raw ? JSON.parse(raw) : undefined;
-      if (
-        parsed &&
-        Array.isArray(parsed.entries) &&
-        parsed.entries.every((entry) => typeof entry === "string") &&
-        typeof parsed.index === "number"
-      ) {
+      const parsed = normalizeHistoryState(raw ? JSON.parse(raw) : undefined);
+      if (parsed) {
+        historyStateCache = parsed;
         return parsed;
       }
     } catch {}
@@ -32730,28 +32775,30 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
     if (!state) {
       return undefined;
     }
+    if (state.entries[state.index] === currentUrl) {
+      return undefined;
+    }
     if (state.entries[state.index - 1] === currentUrl) {
-      updateHistoryState("back", currentUrl);
+      writeHistoryState({
+        entries: state.entries,
+        index: state.index - 1,
+      });
       return "go-back";
     }
     if (state.entries[state.index + 1] === currentUrl) {
-      updateHistoryState("forward", currentUrl);
+      writeHistoryState({
+        entries: state.entries,
+        index: state.index + 1,
+      });
       return "go-forward";
     }
     const existingIndex = state.entries.lastIndexOf(currentUrl);
-    if (existingIndex !== -1) {
-      if (existingIndex < state.index) {
-        while (readHistoryState()?.index > existingIndex) {
-          updateHistoryState("back", currentUrl);
-        }
-        return "go-back";
-      }
-      if (existingIndex > state.index) {
-        while (readHistoryState()?.index < existingIndex) {
-          updateHistoryState("forward", currentUrl);
-        }
-        return "go-forward";
-      }
+    if (existingIndex !== -1 && existingIndex !== state.index) {
+      writeHistoryState({
+        entries: state.entries,
+        index: existingIndex,
+      });
+      return existingIndex < state.index ? "go-back" : "go-forward";
     }
     return undefined;
   }
@@ -32878,10 +32925,6 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
       "  outline: 2px solid #2563eb;",
       "  outline-offset: 2px;",
       "}",
-      "button:disabled {",
-      "  cursor: wait;",
-      "  opacity: 0.8;",
-      "}",
     ].join("\n");
     const button = document.createElement("button");
     button.type = "button";
@@ -33114,7 +33157,8 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
       });
       return;
     }
-    if (readHistoryState()?.entries[readHistoryState().index] !== currentUrl) {
+    const state = readHistoryState();
+    if (state?.entries[state.index] !== currentUrl) {
       updateHistoryState("push", currentUrl);
       enqueue({
         kind: "navigate",
@@ -33168,10 +33212,13 @@ var FLOW_RECORDER_INSTALL_SOURCE = String.raw`(() => {
     },
   };
 
-  ensureStopButtonMounted();
+  if (options.showStopButton) {
+    ensureStopButtonMounted();
+  }
   onInstall();
 })();`;
-var FLOW_RECORDER_INSTALL_SCRIPT = FLOW_RECORDER_INSTALL_SOURCE;
+}
+var FLOW_RECORDER_INSTALL_SCRIPT = createFlowRecorderInstallScript();
 var FLOW_RECORDER_DRAIN_SCRIPT = String.raw`(() => {
   const recorder = globalThis.__opensteerFlowRecorder;
   if (!recorder || typeof recorder.drain !== "function") {
@@ -33191,6 +33238,7 @@ var FlowRecorderCollector = class {
   runtime;
   pollIntervalMs;
   onAction;
+  installScript;
   pages = /* @__PURE__ */ new Map();
   actions = [];
   nextPageOrdinal = 0;
@@ -33203,10 +33251,11 @@ var FlowRecorderCollector = class {
     this.runtime = runtime;
     this.pollIntervalMs = options.pollIntervalMs ?? 250;
     this.onAction = options.onAction;
+    this.installScript = options.installScript ?? FLOW_RECORDER_INSTALL_SCRIPT;
   }
   async install() {
     await this.runtime.addInitScript({
-      script: FLOW_RECORDER_INSTALL_SCRIPT
+      script: this.installScript
     });
     const { pages } = await this.runtime.listPages();
     for (const page of pages) {
@@ -33215,7 +33264,7 @@ var FlowRecorderCollector = class {
     await Promise.all(
       pages.map(
         (page) => this.runtime.evaluate({
-          script: FLOW_RECORDER_INSTALL_SCRIPT,
+          script: this.installScript,
           pageRef: page.pageRef
         }).catch(() => void 0)
       )
@@ -33247,6 +33296,18 @@ var FlowRecorderCollector = class {
   getActions() {
     return this.actions.slice();
   }
+  getPages() {
+    return [...this.pages.values()].map((page) => ({
+      pageId: page.pageId,
+      pageRef: page.pageRef,
+      ...page.openerPageRef === void 0 ? {} : { openerPageRef: page.openerPageRef },
+      ...page.openerPageId === void 0 ? {} : { openerPageId: page.openerPageId },
+      currentUrl: page.currentUrl
+    })).sort((left, right) => comparePageIds(left.pageId, right.pageId));
+  }
+  getFocusedPageId() {
+    return this.focusedPageId;
+  }
   async waitForStop() {
     if (this.stopDetected) {
       return;
@@ -33343,10 +33404,17 @@ var FlowRecorderCollector = class {
     }
     for (const listedPage of input.listedPages) {
       if (!input.previousPageRefs.has(listedPage.pageRef)) {
-        const created = this.ensureKnownPage(listedPage.pageRef, listedPage.url, listedPage.openerPageRef);
+        const created = this.ensureKnownPage(
+          listedPage.pageRef,
+          listedPage.url,
+          listedPage.openerPageRef
+        );
         actions.push({
           kind: "new-tab",
-          timestamp: Math.max(0, (firstEventTimestampByPage.get(listedPage.pageRef) ?? input.pollTimestamp) - 1),
+          timestamp: Math.max(
+            0,
+            (firstEventTimestampByPage.get(listedPage.pageRef) ?? input.pollTimestamp) - 1
+          ),
           pageId: created.pageId,
           pageUrl: listedPage.url,
           detail: {
@@ -33400,7 +33468,11 @@ var FlowRecorderCollector = class {
           (event) => this.normalizeRawEvent(event, knownPage, evaluatedPage.currentUrl)
         )
       );
-      this.updateKnownPage(evaluatedPage.pageRef, evaluatedPage.currentUrl, evaluatedPage.openerPageRef);
+      this.updateKnownPage(
+        evaluatedPage.pageRef,
+        evaluatedPage.currentUrl,
+        evaluatedPage.openerPageRef
+      );
     }
     const focusedPage = input.evaluatedPages.find((page) => page.focused);
     if (focusedPage !== void 0 && focusedPage.pageId !== this.focusedPageId) {
@@ -33651,6 +33723,14 @@ function actionSortPriority(kind) {
       return 6;
   }
 }
+function comparePageIds(left, right) {
+  const leftMatch = /^page(\d+)$/u.exec(left);
+  const rightMatch = /^page(\d+)$/u.exec(right);
+  if (leftMatch && rightMatch) {
+    return Number(leftMatch[1]) - Number(rightMatch[1]);
+  }
+  return left.localeCompare(right);
+}
 function delay(ms) {
   return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
@@ -33700,17 +33780,16 @@ var WINDOW_SCROLL_SCRIPT = String.raw`(deltaX, deltaY) => {
   window.scrollBy(Number(deltaX), Number(deltaY));
 }`;
 function generateReplayScript(options) {
-  const pageIds = collectPageIds(options.actions);
-  const initialPageId = pageIds[0] ?? "page0";
+  const replayTarget = resolveReplayTarget(options);
+  const initialPages = orderInitialPages(resolveInitialPages(options));
+  const activeInitialPageId = resolveActiveInitialPageId(options, initialPages);
+  const initialPageId = initialPages[0]?.pageId ?? "page0";
   const lines = [
     `import { Opensteer } from "opensteer";`,
     ``,
-    `const opensteer = new Opensteer({`,
-    `  workspace: ${JSON.stringify(options.workspace)},`,
-    `  browser: "persistent",`,
-    `});`,
+    ...renderOpensteerBootstrap(replayTarget),
     ``,
-    `const ${initialPageId} = (await opensteer.open(${JSON.stringify(options.startUrl)})).pageRef;`,
+    `const ${initialPageId} = (await opensteer.open(${JSON.stringify(initialPages[0]?.initialUrl ?? "")})).pageRef;`,
     `let activePageRef: string | undefined = ${initialPageId};`,
     ``,
     `async function ensureActive(pageRef: string): Promise<void> {`,
@@ -33751,6 +33830,17 @@ function generateReplayScript(options) {
     `try {`
   ];
   const declaredPages = /* @__PURE__ */ new Set([initialPageId]);
+  for (const page of initialPages.slice(1)) {
+    const openerPageId = page.openerPageId !== void 0 && declaredPages.has(page.openerPageId) ? page.openerPageId : void 0;
+    lines.push(
+      `  const ${page.pageId} = (await opensteer.newPage(${renderNewPageInput(openerPageId, page.initialUrl)})).pageRef;`
+    );
+    lines.push(`  activePageRef = ${page.pageId};`);
+    declaredPages.add(page.pageId);
+  }
+  if (activeInitialPageId !== void 0 && activeInitialPageId !== initialPageId) {
+    lines.push(`  await ensureActive(${activeInitialPageId});`);
+  }
   for (let index = 0; index < options.actions.length; index += 1) {
     const action = options.actions[index];
     const pageVar = action.pageId;
@@ -33783,16 +33873,11 @@ function generateReplayScript(options) {
       case "dblclick":
         lines.push(`  await ensureActive(${pageVar});`);
         lines.push(
-          `  await opensteer.click({ selector: ${JSON.stringify(requireSelector(action))} });`
-        );
-        lines.push(
-          `  await opensteer.click({ selector: ${JSON.stringify(requireSelector(action))} });`
+          `  await opensteer.click({ selector: ${JSON.stringify(requireSelector(action))}, clickCount: 2 });`
         );
         break;
       case "keypress":
-        lines.push(
-          `  await dispatchKey(${pageVar}, ${JSON.stringify(action.detail.key)});`
-        );
+        lines.push(`  await dispatchKey(${pageVar}, ${JSON.stringify(action.detail.key)});`);
         break;
       case "scroll": {
         const { direction, amount, isWindowScroll } = normalizeScrollAction(action);
@@ -33820,7 +33905,7 @@ function generateReplayScript(options) {
       case "new-tab": {
         const openerPageVar = action.detail.openerPageId;
         const shouldUseWaitForPage = shouldUsePopupWait(options.actions, index, openerPageVar);
-        const creationLine = shouldUseWaitForPage && openerPageVar !== void 0 ? `  const ${pageVar} = (await opensteer.waitForPage({ openerPageRef: ${openerPageVar}, timeoutMs: 30_000 })).pageRef;` : `  const ${pageVar} = (await opensteer.newPage({${renderNewPageArguments(action.detail.openerPageId, action.detail.initialUrl)}})).pageRef;`;
+        const creationLine = shouldUseWaitForPage && openerPageVar !== void 0 ? `  const ${pageVar} = (await opensteer.waitForPage({ openerPageRef: ${openerPageVar}, timeoutMs: 30_000 })).pageRef;` : `  const ${pageVar} = (await opensteer.newPage(${renderNewPageInput(action.detail.openerPageId, action.detail.initialUrl)})).pageRef;`;
         lines.push(creationLine);
         lines.push(`  activePageRef = ${pageVar};`);
         declaredPages.add(pageVar);
@@ -33853,29 +33938,114 @@ function generateReplayScript(options) {
   return `${lines.join("\n")}
 `;
 }
-function collectPageIds(actions) {
-  const orderedIds = /* @__PURE__ */ new Set(["page0"]);
-  for (const action of actions) {
-    orderedIds.add(action.pageId);
-    if (action.kind === "new-tab" && action.detail.openerPageId !== void 0) {
-      orderedIds.add(action.detail.openerPageId);
-    }
-    if (action.kind === "switch-tab" && action.detail.fromPageId !== void 0) {
-      orderedIds.add(action.detail.fromPageId);
-    }
-    if (action.kind === "switch-tab") {
-      orderedIds.add(action.detail.toPageId);
+function resolveReplayTarget(options) {
+  if (options.replayTarget !== void 0) {
+    return options.replayTarget;
+  }
+  if (options.workspace !== void 0) {
+    return {
+      kind: "local",
+      workspace: options.workspace
+    };
+  }
+  throw new Error("Replay codegen requires either replayTarget or workspace.");
+}
+function resolveInitialPages(options) {
+  if (options.initialPages !== void 0 && options.initialPages.length > 0) {
+    const unique = /* @__PURE__ */ new Set();
+    return options.initialPages.map((page) => {
+      if (unique.has(page.pageId)) {
+        throw new Error(`Duplicate initial page id "${page.pageId}" in recording bootstrap.`);
+      }
+      unique.add(page.pageId);
+      return page;
+    });
+  }
+  const startUrl = options.startUrl;
+  if (startUrl === void 0) {
+    throw new Error("Replay codegen requires startUrl when initialPages is not provided.");
+  }
+  return [
+    {
+      pageId: "page0",
+      initialUrl: startUrl
     }
+  ];
+}
+function resolveActiveInitialPageId(options, initialPages) {
+  if (options.activePageId !== void 0) {
+    return options.activePageId;
   }
-  return [...orderedIds].sort(comparePageIds);
+  return initialPages[0]?.pageId;
 }
-function comparePageIds(left, right) {
-  const leftMatch = /^page(\d+)$/u.exec(left);
-  const rightMatch = /^page(\d+)$/u.exec(right);
-  if (leftMatch && rightMatch) {
-    return Number(leftMatch[1]) - Number(rightMatch[1]);
+function renderOpensteerBootstrap(replayTarget) {
+  if (replayTarget.kind === "local") {
+    return [
+      `const opensteer = new Opensteer({`,
+      `  workspace: ${JSON.stringify(replayTarget.workspace)},`,
+      `  browser: "persistent",`,
+      `});`
+    ];
   }
-  return left.localeCompare(right);
+  return [
+    renderRequireEnvHelper(replayTarget),
+    ``,
+    `const opensteer = new Opensteer({`,
+    `  provider: {`,
+    `    mode: "cloud",`,
+    `    baseUrl: requireEnv(${JSON.stringify(replayTarget.baseUrlEnvVar ?? "OPENSTEER_BASE_URL")}),`,
+    `    apiKey: requireEnv(${JSON.stringify(replayTarget.apiKeyEnvVar ?? "OPENSTEER_API_KEY")}),`,
+    ...renderCloudBrowserProfile(replayTarget),
+    `  },`,
+    `});`
+  ];
+}
+function renderRequireEnvHelper(replayTarget) {
+  const baseUrlEnvVar = replayTarget.baseUrlEnvVar ?? "OPENSTEER_BASE_URL";
+  const apiKeyEnvVar = replayTarget.apiKeyEnvVar ?? "OPENSTEER_API_KEY";
+  return [
+    `function requireEnv(name: string): string {`,
+    `  const value = process.env[name];`,
+    `  if (typeof value === "string" && value.trim().length > 0) {`,
+    `    return value;`,
+    `  }`,
+    `  throw new Error(\`Missing environment variable \${name}. Set ${baseUrlEnvVar} and ${apiKeyEnvVar} before replaying this recording.\`);`,
+    `}`
+  ].join("\n");
+}
+function renderCloudBrowserProfile(replayTarget) {
+  if (replayTarget.browserProfileId === void 0) {
+    return [];
+  }
+  return [
+    `    browserProfile: {`,
+    `      profileId: ${JSON.stringify(replayTarget.browserProfileId)},`,
+    ...replayTarget.reuseBrowserProfileIfActive ? [`      reuseIfActive: true,`] : [],
+    `    },`
+  ];
+}
+function orderInitialPages(initialPages) {
+  const ordered = [];
+  const declared = /* @__PURE__ */ new Set();
+  const remaining = [...initialPages];
+  while (remaining.length > 0) {
+    let advanced = false;
+    for (let index = 0; index < remaining.length; index += 1) {
+      const page = remaining[index];
+      if (page.openerPageId !== void 0 && !declared.has(page.openerPageId)) {
+        continue;
+      }
+      ordered.push(page);
+      declared.add(page.pageId);
+      remaining.splice(index, 1);
+      advanced = true;
+      break;
+    }
+    if (!advanced) {
+      ordered.push(...remaining.splice(0, remaining.length));
+    }
+  }
+  return ordered;
 }
 function requireSelector(action) {
   if (action.selector === void 0) {
@@ -33909,18 +34079,18 @@ function shouldUsePopupWait(actions, newTabIndex, openerPageId) {
   }
   return previousAction.kind === "click" || previousAction.kind === "dblclick" || previousAction.kind === "keypress";
 }
-function renderNewPageArguments(openerPageId, initialUrl) {
+function renderNewPageInput(openerPageId, initialUrl) {
   const argumentsList = [];
   if (openerPageId !== void 0) {
-    argumentsList.push(` openerPageRef: ${openerPageId}`);
+    argumentsList.push(`openerPageRef: ${openerPageId}`);
   }
   if (initialUrl.length > 0 && initialUrl !== "about:blank") {
-    argumentsList.push(` url: ${JSON.stringify(initialUrl)}`);
+    argumentsList.push(`url: ${JSON.stringify(initialUrl)}`);
   }
   if (argumentsList.length === 0) {
-    return ``;
+    return `{}`;
   }
-  return ` ${argumentsList.join(",")}`.trimStart();
+  return `{ ${argumentsList.join(", ")} }`;
 }
 
 // src/sdk/runtime.ts
@@ -34546,6 +34716,30 @@ var OpensteerCloudClient = class {
     });
     return await response.json();
   }
+  async getSessionRecording(sessionId) {
+    const response = await this.request(`/v1/sessions/${encodeURIComponent(sessionId)}/recording`, {
+      method: "GET"
+    });
+    return await response.json();
+  }
+  async startSessionRecording(sessionId) {
+    const response = await this.request(
+      `/v1/sessions/${encodeURIComponent(sessionId)}/recording/start`,
+      {
+        method: "POST"
+      }
+    );
+    return await response.json();
+  }
+  async stopSessionRecording(sessionId) {
+    const response = await this.request(
+      `/v1/sessions/${encodeURIComponent(sessionId)}/recording/stop`,
+      {
+        method: "POST"
+      }
+    );
+    return await response.json();
+  }
   async closeSession(sessionId) {
     const response = await this.request(`/v1/sessions/${encodeURIComponent(sessionId)}`, {
       method: "DELETE"
@@ -34736,9 +34930,11 @@ function resolveCloudConfig(input = {}) {
   if (!baseUrl || baseUrl.trim().length === 0) {
     throw new Error("provider=cloud requires OPENSTEER_BASE_URL or provider.baseUrl.");
   }
+  const appBaseUrl = cloudProvider?.appBaseUrl ?? input.environment?.OPENSTEER_CLOUD_APP_BASE_URL;
   return {
     apiKey: apiKey.trim(),
     baseUrl: baseUrl.trim().replace(/\/+$/, ""),
+    ...appBaseUrl === void 0 || appBaseUrl.trim().length === 0 ? {} : { appBaseUrl: appBaseUrl.trim().replace(/\/+$/, "") },
     ...cloudProvider?.browserProfile === void 0 ? {} : { browserProfile: cloudProvider.browserProfile }
   };
 }
@@ -35807,18 +36003,6 @@ function isLoopbackBaseUrl(baseUrl) {
 }
 
 // src/sdk/runtime-resolution.ts
-var LOCAL_ONLY_RUNTIME_OPTION_KEYS = [
-  "launch",
-  "context",
-  "engine",
-  "engineFactory",
-  "policy",
-  "descriptorStore",
-  "extractionDescriptorStore",
-  "registryOverrides",
-  "observationSessionId",
-  "observationSink"
-];
 function resolveOpensteerRuntimeConfig(input = {}) {
   const environment = input.environment ?? process.env;
   const provider = resolveOpensteerProvider({
@@ -35843,15 +36027,8 @@ function createOpensteerSemanticRuntime(input = {}) {
     ...input.provider === void 0 ? {} : { provider: input.provider },
     ...input.environment === void 0 ? {} : { environment: input.environment }
   });
-  const localOnlyRuntimeOptions = listLocalOnlyRuntimeOptions(runtimeOptions);
-  const providerMode = config.provider.mode === "cloud" && config.provider.source !== "explicit" && localOnlyRuntimeOptions.length > 0 ? "local" : config.provider.mode;
-  if (config.provider.mode === "cloud" && config.provider.source === "explicit" && localOnlyRuntimeOptions.length > 0) {
-    throw new Error(
-      `provider=cloud does not support local runtime options: ${localOnlyRuntimeOptions.join(", ")}.`
-    );
-  }
-  assertProviderSupportsEngine(providerMode, engine);
-  if (providerMode === "cloud") {
+  assertProviderSupportsEngine(config.provider.mode, engine);
+  if (config.provider.mode === "cloud") {
     return new CloudSessionProxy(new OpensteerCloudClient(config.cloud), {
       ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
       ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
@@ -35865,9 +36042,6 @@ function createOpensteerSemanticRuntime(input = {}) {
     engineName: engine
   });
 }
-function listLocalOnlyRuntimeOptions(runtimeOptions) {
-  return LOCAL_ONLY_RUNTIME_OPTION_KEYS.filter((key) => runtimeOptions[key] !== void 0);
-}
 var ENV_FILENAMES = [".env", ".env.local"];
 var OPENSTEER_ENV_PREFIX = "OPENSTEER_";
 var opensteerEnvironmentCache = /* @__PURE__ */ new Map();
@@ -35972,5 +36146,5 @@ function isOpensteerEnvironmentKey(key) {
 }
 
 export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, FlowRecorderCollector, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime2 as OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, generateReplayScript, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isProcessRunning, isValidCssAttributeKey, listLocalChromeProfiles, loadEnvironment, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, pathExists, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerEnvironment, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };
-//# sourceMappingURL=chunk-F3X6UOEN.js.map
-//# sourceMappingURL=chunk-F3X6UOEN.js.map
+//# sourceMappingURL=chunk-33FDEOQY.js.map
+//# sourceMappingURL=chunk-33FDEOQY.js.map