opensteer 0.8.10 → 0.8.11

package/dist/index.cjs

@@ -1040,6 +1040,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",
@@ -6229,9 +6232,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 })
   },
@@ -6331,18 +6348,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"
 });
@@ -9083,6 +9088,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") {
@@ -9118,6 +9124,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,
@@ -10831,16 +10844,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 {
@@ -23735,6 +23739,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 {
@@ -33073,6 +33080,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"
@@ -33263,9 +33294,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 }
   };
 }
@@ -34334,18 +34367,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({
@@ -34370,15 +34391,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 },
@@ -34392,9 +34406,6 @@ function createOpensteerSemanticRuntime(input = {}) {
     engineName: engine
   });
 }
-function listLocalOnlyRuntimeOptions(runtimeOptions) {
-  return LOCAL_ONLY_RUNTIME_OPTION_KEYS.filter((key) => runtimeOptions[key] !== void 0);
-}
 
 // src/sdk/opensteer.ts
 var Opensteer = class {
@@ -34485,7 +34496,13 @@ var Opensteer = class {
     return this.runtime.addInitScript(normalized);
   }
   async click(input) {
-    const normalized = normalizeTargetOptions(input);
+    const { button, clickCount, modifiers, ...target } = input;
+    const normalized = {
+      ...normalizeTargetOptions(target),
+      ...button === void 0 ? {} : { button },
+      ...clickCount === void 0 ? {} : { clickCount },
+      ...modifiers === void 0 ? {} : { modifiers }
+    };
     return this.runtime.click(normalized);
   }
   async hover(input) {