opensteer 0.6.7 → 0.6.9

package/dist/index.cjs

@@ -463,8 +463,12 @@ __export(index_exports, {
   clearPersistentProfileSingletons: () => clearPersistentProfileSingletons,
   cloneElementPath: () => cloneElementPath,
   closeTab: () => closeTab,
+  cloudActionMethods: () => cloudActionMethods,
+  cloudErrorCodes: () => cloudErrorCodes,
   cloudNotLaunchedError: () => cloudNotLaunchedError,
   cloudSessionContractVersion: () => cloudSessionContractVersion,
+  cloudSessionSourceTypes: () => cloudSessionSourceTypes,
+  cloudSessionStatuses: () => cloudSessionStatuses,
   cloudUnsupportedMethodError: () => cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries: () => collectLocalSelectorCacheEntries,
   countArrayItemsWithPath: () => countArrayItemsWithPath,
@@ -489,6 +493,10 @@ __export(index_exports, {
   getPageHtml: () => getPageHtml,
   getPageTitle: () => getPageTitle,
   importCookies: () => importCookies,
+  isCloudActionMethod: () => isCloudActionMethod,
+  isCloudErrorCode: () => isCloudErrorCode,
+  isCloudSessionSourceType: () => isCloudSessionSourceType,
+  isCloudSessionStatus: () => isCloudSessionStatus,
   listLocalChromeProfiles: () => listLocalChromeProfiles,
   listTabs: () => listTabs,
   markInteractiveElements: () => markInteractiveElements,
@@ -4586,6 +4594,47 @@ async function markInteractiveElements(page, {
           "search",
           "searchbox"
         ]);
+        function isExplicitlyHidden(el, style) {
+          if (el.hasAttribute("hidden")) {
+            return true;
+          }
+          if (el.getAttribute("aria-hidden") === "true") {
+            return true;
+          }
+          if (style.display === "none") {
+            return true;
+          }
+          if (style.visibility === "hidden" || style.visibility === "collapse") {
+            return true;
+          }
+          const opacity = Number.parseFloat(style.opacity);
+          return Number.isFinite(opacity) && opacity <= 0;
+        }
+        function hasVisibleOutOfFlowChild(el) {
+          const children = el.children;
+          for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const childStyle = window.getComputedStyle(child);
+            if (childStyle.position !== "fixed" && childStyle.position !== "absolute") {
+              continue;
+            }
+            const childRect = child.getBoundingClientRect();
+            if (childRect.width > 0 && childRect.height > 0) {
+              return true;
+            }
+          }
+          return false;
+        }
+        function isHiddenByOwnRect(el, style) {
+          if (style.display === "contents") {
+            return false;
+          }
+          const rect = el.getBoundingClientRect();
+          if (rect.width > 0 && rect.height > 0) {
+            return false;
+          }
+          return !hasVisibleOutOfFlowChild(el);
+        }
         const roots = [document];
         while (roots.length) {
           const root = roots.pop();
@@ -4601,42 +4650,7 @@ async function markInteractiveElements(page, {
               continue;
             }
             const style = window.getComputedStyle(el);
-            let hidden = false;
-            if (el.hasAttribute("hidden")) {
-              hidden = true;
-            } else if (el.getAttribute("aria-hidden") === "true") {
-              hidden = true;
-            } else if (style.display === "none") {
-              hidden = true;
-            } else if (style.visibility === "hidden" || style.visibility === "collapse") {
-              hidden = true;
-            }
-            if (!hidden) {
-              const opacity = Number.parseFloat(style.opacity);
-              if (Number.isFinite(opacity) && opacity <= 0) {
-                hidden = true;
-              }
-            }
-            if (!hidden) {
-              const rect = el.getBoundingClientRect();
-              if (rect.width <= 0 || rect.height <= 0) {
-                hidden = true;
-                const children = el.children;
-                for (let i = 0; i < children.length; i++) {
-                  const childStyle = window.getComputedStyle(
-                    children[i]
-                  );
-                  if (childStyle.position !== "fixed" && childStyle.position !== "absolute") {
-                    continue;
-                  }
-                  const childRect = children[i].getBoundingClientRect();
-                  if (childRect.width > 0 && childRect.height > 0) {
-                    hidden = false;
-                    break;
-                  }
-                }
-              }
-            }
+            const hidden = isExplicitlyHidden(el, style) || isHiddenByOwnRect(el, style);
             if (hidden) {
               el.setAttribute(hiddenAttr, "1");
               el.removeAttribute(markAttribute2);
@@ -9016,7 +9030,99 @@ function stripPositionClauses2(path5) {
 }
 
 // src/cloud/contracts.ts
+var cloudActionMethods = [
+  "goto",
+  "snapshot",
+  "screenshot",
+  "state",
+  "click",
+  "dblclick",
+  "rightclick",
+  "hover",
+  "input",
+  "select",
+  "scroll",
+  "tabs",
+  "newTab",
+  "switchTab",
+  "closeTab",
+  "getCookies",
+  "setCookie",
+  "clearCookies",
+  "pressKey",
+  "type",
+  "getElementText",
+  "getElementValue",
+  "getElementAttributes",
+  "getElementBoundingBox",
+  "getHtml",
+  "getTitle",
+  "uploadFile",
+  "exportCookies",
+  "importCookies",
+  "waitForText",
+  "extract",
+  "extractFromPlan",
+  "clearCache"
+];
+var cloudErrorCodes = [
+  "CLOUD_AUTH_FAILED",
+  "CLOUD_SESSION_NOT_FOUND",
+  "CLOUD_SESSION_CLOSED",
+  "CLOUD_UNSUPPORTED_METHOD",
+  "CLOUD_INVALID_REQUEST",
+  "CLOUD_MODEL_NOT_ALLOWED",
+  "CLOUD_ACTION_FAILED",
+  "CLOUD_CAPACITY_EXHAUSTED",
+  "CLOUD_RUNTIME_UNAVAILABLE",
+  "CLOUD_RUNTIME_MISMATCH",
+  "CLOUD_SESSION_STALE",
+  "CLOUD_CONTROL_PLANE_ERROR",
+  "CLOUD_CONTRACT_MISMATCH",
+  "CLOUD_PROXY_UNAVAILABLE",
+  "CLOUD_PROXY_REQUIRED",
+  "CLOUD_BILLING_LIMIT_REACHED",
+  "CLOUD_RATE_LIMITED",
+  "CLOUD_BROWSER_PROFILE_NOT_FOUND",
+  "CLOUD_BROWSER_PROFILE_BUSY",
+  "CLOUD_BROWSER_PROFILE_DISABLED",
+  "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE",
+  "CLOUD_BROWSER_PROFILE_SYNC_FAILED",
+  "CLOUD_INTERNAL"
+];
+var cloudSessionStatuses = [
+  "provisioning",
+  "active",
+  "closing",
+  "closed",
+  "failed"
+];
 var cloudSessionContractVersion = "v3";
+var cloudSessionSourceTypes = [
+  "agent-thread",
+  "agent-run",
+  "project-agent-run",
+  "local-cloud",
+  "manual"
+];
+var cloudActionMethodSet = new Set(cloudActionMethods);
+var cloudErrorCodeSet = new Set(cloudErrorCodes);
+var cloudSessionSourceTypeSet = new Set(
+  cloudSessionSourceTypes
+);
+var cloudSessionStatusSet = new Set(cloudSessionStatuses);
+function isCloudActionMethod(value) {
+  return typeof value === "string" && cloudActionMethodSet.has(value);
+}
+function isCloudErrorCode(value) {
+  return typeof value === "string" && cloudErrorCodeSet.has(value);
+}
+function isCloudSessionSourceType(value) {
+  return typeof value === "string" && cloudSessionSourceTypeSet.has(value);
+}
+function isCloudSessionStatus(value) {
+  return typeof value === "string" && cloudSessionStatusSet.has(value);
+}
 
 // src/cloud/action-ws-client.ts
 var import_ws2 = __toESM(require("ws"), 1);
@@ -9047,6 +9153,13 @@ function cloudNotLaunchedError() {
   );
 }
 
+// src/cloud/ws-url.ts
+function withTokenQuery(wsUrl, token) {
+  const url = new URL(wsUrl);
+  url.searchParams.set("token", token);
+  return url.toString();
+}
+
 // src/cloud/action-ws-client.ts
 var ActionWsClient = class _ActionWsClient {
   ws;
@@ -9175,11 +9288,6 @@ function rawDataToUtf8(raw) {
   if (Array.isArray(raw)) return Buffer.concat(raw).toString("utf8");
   return raw.toString("utf8");
 }
-function withTokenQuery(wsUrl, token) {
-  const url = new URL(wsUrl);
-  url.searchParams.set("token", token);
-  return url.toString();
-}
 
 // src/cloud/local-cache-sync.ts
 var import_fs4 = __toESM(require("fs"), 1);
@@ -9319,7 +9427,7 @@ function dedupeNewest(entries) {
 var import_playwright2 = require("playwright");
 var CloudCdpClient = class {
   async connect(args) {
-    const endpoint = withTokenQuery2(args.wsUrl, args.token);
+    const endpoint = withTokenQuery(args.wsUrl, args.token);
     let browser;
     try {
       browser = await import_playwright2.chromium.connectOverCDP(endpoint);
@@ -9371,11 +9479,6 @@ function isInternalOrEmptyUrl(url) {
   if (url === "about:blank") return true;
   return url.startsWith("chrome://") || url.startsWith("devtools://") || url.startsWith("edge://");
 }
-function withTokenQuery2(wsUrl, token) {
-  const url = new URL(wsUrl);
-  url.searchParams.set("token", token);
-  return url.toString();
-}
 
 // src/utils/strip-trailing-slashes.ts
 function stripTrailingSlashes(value) {
@@ -9412,10 +9515,7 @@ async function parseCloudHttpError(response) {
   return new OpensteerCloudError(code, message, response.status, body?.details);
 }
 function toCloudErrorCode(code) {
-  if (code === "CLOUD_AUTH_FAILED" || code === "CLOUD_SESSION_NOT_FOUND" || code === "CLOUD_SESSION_CLOSED" || code === "CLOUD_UNSUPPORTED_METHOD" || code === "CLOUD_INVALID_REQUEST" || code === "CLOUD_MODEL_NOT_ALLOWED" || code === "CLOUD_ACTION_FAILED" || code === "CLOUD_INTERNAL" || code === "CLOUD_CAPACITY_EXHAUSTED" || code === "CLOUD_RUNTIME_UNAVAILABLE" || code === "CLOUD_RUNTIME_MISMATCH" || code === "CLOUD_SESSION_STALE" || code === "CLOUD_CONTRACT_MISMATCH" || code === "CLOUD_CONTROL_PLANE_ERROR" || code === "CLOUD_PROXY_UNAVAILABLE" || code === "CLOUD_PROXY_REQUIRED" || code === "CLOUD_BILLING_LIMIT_REACHED" || code === "CLOUD_RATE_LIMITED" || code === "CLOUD_BROWSER_PROFILE_NOT_FOUND" || code === "CLOUD_BROWSER_PROFILE_BUSY" || code === "CLOUD_BROWSER_PROFILE_DISABLED" || code === "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE" || code === "CLOUD_BROWSER_PROFILE_SYNC_FAILED") {
-    return code;
-  }
-  return "CLOUD_TRANSPORT_ERROR";
+  return isCloudErrorCode(code) ? code : "CLOUD_TRANSPORT_ERROR";
 }
 
 // src/cloud/session-client.ts
@@ -9522,7 +9622,12 @@ function parseCreateResponse(body, status) {
       status,
       "cloudSession"
     ),
-    state: requireString(cloudSessionRoot, "state", status, "cloudSession"),
+    state: requireSessionStatus(
+      cloudSessionRoot,
+      "state",
+      status,
+      "cloudSession"
+    ),
     createdAt: requireNumber(cloudSessionRoot, "createdAt", status, "cloudSession"),
     sourceType: requireSourceType(cloudSessionRoot, "sourceType", status, "cloudSession"),
     sourceRef: optionalString(cloudSessionRoot, "sourceRef", status, "cloudSession"),
@@ -9610,7 +9715,21 @@ function optionalNumber(source, field, status, parent) {
 }
 function requireSourceType(source, field, status, parent) {
   const value = source[field];
-  if (value === "agent-thread" || value === "agent-run" || value === "local-cloud" || value === "manual") {
+  if (isCloudSessionSourceType(value)) {
+    return value;
+  }
+  throw new OpensteerCloudError(
+    "CLOUD_CONTRACT_MISMATCH",
+    `Invalid cloud session create response: ${formatFieldPath(
+      field,
+      parent
+    )} must be one of ${formatAllowedValues(cloudSessionSourceTypes)}.`,
+    status
+  );
+}
+function requireSessionStatus(source, field, status, parent) {
+  const value = source[field];
+  if (isCloudSessionStatus(value)) {
     return value;
   }
   throw new OpensteerCloudError(
@@ -9618,13 +9737,26 @@ function requireSourceType(source, field, status, parent) {
     `Invalid cloud session create response: ${formatFieldPath(
       field,
       parent
-    )} must be one of "agent-thread", "agent-run", "local-cloud", or "manual".`,
+    )} must be one of ${formatAllowedValues(cloudSessionStatuses)}.`,
     status
   );
 }
 function formatFieldPath(field, parent) {
   return parent ? `"${parent}.${field}"` : `"${field}"`;
 }
+function formatAllowedValues(values) {
+  if (values.length === 0) {
+    return "";
+  }
+  if (values.length === 1) {
+    return `"${values[0]}"`;
+  }
+  if (values.length === 2) {
+    return `"${values[0]}" or "${values[1]}"`;
+  }
+  const quotedValues = values.map((value) => `"${value}"`);
+  return `${quotedValues.slice(0, -1).join(", ")}, or ${quotedValues[quotedValues.length - 1]}`;
+}
 function zeroImportResponse() {
   return {
     imported: 0,
@@ -15075,8 +15207,12 @@ function sleep7(ms) {
   clearPersistentProfileSingletons,
   cloneElementPath,
   closeTab,
+  cloudActionMethods,
+  cloudErrorCodes,
   cloudNotLaunchedError,
   cloudSessionContractVersion,
+  cloudSessionSourceTypes,
+  cloudSessionStatuses,
   cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
@@ -15101,6 +15237,10 @@ function sleep7(ms) {
   getPageHtml,
   getPageTitle,
   importCookies,
+  isCloudActionMethod,
+  isCloudErrorCode,
+  isCloudSessionSourceType,
+  isCloudSessionStatus,
   listLocalChromeProfiles,
   listTabs,
   markInteractiveElements,

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import * as playwright from 'playwright';
 import { Page, BrowserContext, ElementHandle, Cookie, Browser } from 'playwright';
 import { a as OpensteerConfig, L as LaunchOptions, b as OpensteerLocalProfileDescriptor, c as OpensteerRealBrowserOptions, G as GotoOptions, S as SnapshotOptions, d as StateResult, e as ScreenshotOptions, f as ClickOptions, A as ActionResult, H as HoverOptions, I as InputOptions, g as SelectOptions, h as ScrollOptions, T as TabInfo, C as CookieParam, B as BaseActionOptions, i as BoundingBox, F as FileUploadOptions, E as ExtractOptions, j as ExtractFromPlanOptions, k as ExtractionRunResult, l as OpensteerCursorState, m as OpensteerAgentConfig, n as OpensteerAgentInstance, o as ElementPath, p as SnapshotMode, q as AiResolveCallback, r as AiExtractCallback, O as OpensteerAuthScheme, s as OpensteerAgentProvider, t as OpensteerAgentAction, u as OpensteerAgentResult, v as OpensteerAgentUsage, w as OpensteerCursorStyle, x as OpensteerCursorConfig, y as OpensteerAgentExecuteOptions, z as OpensteerBrowserConfig } from './types-Cr10igF3.cjs';
 export { D as ActionWaitOptions, J as AiExtractArgs, K as AiExtractResult, M as AiResolveArgs, N as AiResolveCallbackResult, P as AiResolveResult, Q as AttributeMatchClause, R as ContextHop, U as DomPath, V as ExtractSchema, W as ExtractSchemaField, X as ExtractSchemaValue, Y as ExtractionFieldPlan, Z as ExtractionPlan, _ as MatchClause, $ as MatchOperator, a0 as OpensteerAgentMode, a1 as OpensteerAgentModelConfig, a2 as OpensteerCloudAnnouncePolicy, a3 as OpensteerCloudBrowserProfileOptions, a4 as OpensteerCloudConfig, a5 as OpensteerCloudOptions, a6 as OpensteerCursorColor, a7 as OpensteerCursorProfile, a8 as OpensteerLocalBrowserMode, a9 as OpensteerStorageConfig, aa as PathNode, ab as PathNodePosition, ac as PositionMatchClause } from './types-Cr10igF3.cjs';
-import { A as ActionFailure, e as ActionFailureCode, C as CloudErrorCode, f as CloudActionFailureDetails, g as CloudSessionCreateRequest, h as CloudSessionCreateResponse, i as CloudSelectorCacheImportRequest, j as CloudSelectorCacheImportResponse, k as CloudActionMethod, l as CloudSelectorCacheImportEntry } from './browser-profile-client-Biu6DyT6.cjs';
-export { m as ActionFailureBlocker, n as ActionFailureClassificationSource, o as ActionFailureDetails, p as BrowserProfileArchiveFormat, q as BrowserProfileClient, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor, a as BrowserProfileListRequest, b as BrowserProfileListResponse, r as BrowserProfileProxyPolicy, B as BrowserProfileStatus, s as CloudActionFailure, t as CloudActionRequest, u as CloudActionResponse, v as CloudActionSuccess, w as CloudBrowserProfileLaunchPreference, x as CloudFingerprintMode, y as CloudSessionContractVersion, z as CloudSessionLaunchConfig, D as CloudSessionSourceType, E as CloudSessionSummary, F as cloudSessionContractVersion } from './browser-profile-client-Biu6DyT6.cjs';
+import { A as ActionFailure, e as ActionFailureCode, C as CloudErrorCode, f as CloudActionFailureDetails, g as CloudSessionCreateRequest, h as CloudSessionCreateResponse, i as CloudSelectorCacheImportRequest, j as CloudSelectorCacheImportResponse, k as CloudActionMethod, l as CloudSelectorCacheImportEntry } from './browser-profile-client-CGXc0-P9.cjs';
+export { m as ActionFailureBlocker, n as ActionFailureClassificationSource, o as ActionFailureDetails, p as BrowserProfileArchiveFormat, q as BrowserProfileClient, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor, a as BrowserProfileListRequest, b as BrowserProfileListResponse, r as BrowserProfileProxyPolicy, B as BrowserProfileStatus, s as CloudActionFailure, t as CloudActionRequest, u as CloudActionResponse, v as CloudActionSuccess, w as CloudBrowserContextConfig, x as CloudBrowserExtensionConfig, y as CloudBrowserLaunchConfig, z as CloudBrowserProfileLaunchPreference, D as CloudFingerprintMode, E as CloudFingerprintPreference, F as CloudGeolocation, G as CloudProxyMode, H as CloudProxyPreference, I as CloudProxyProtocol, J as CloudSessionContractVersion, K as CloudSessionLaunchConfig, L as CloudSessionSourceType, M as CloudSessionStatus, N as CloudSessionSummary, O as CloudSessionVisibilityScope, P as CloudViewport, Q as cloudActionMethods, R as cloudErrorCodes, S as cloudSessionContractVersion, T as cloudSessionSourceTypes, U as cloudSessionStatuses, V as isCloudActionMethod, W as isCloudErrorCode, X as isCloudSessionSourceType, Y as isCloudSessionStatus } from './browser-profile-client-CGXc0-P9.cjs';
 
 interface RegistryEntry {
     file: string;

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as playwright from 'playwright';
 import { Page, BrowserContext, ElementHandle, Cookie, Browser } from 'playwright';
 import { a as OpensteerConfig, L as LaunchOptions, b as OpensteerLocalProfileDescriptor, c as OpensteerRealBrowserOptions, G as GotoOptions, S as SnapshotOptions, d as StateResult, e as ScreenshotOptions, f as ClickOptions, A as ActionResult, H as HoverOptions, I as InputOptions, g as SelectOptions, h as ScrollOptions, T as TabInfo, C as CookieParam, B as BaseActionOptions, i as BoundingBox, F as FileUploadOptions, E as ExtractOptions, j as ExtractFromPlanOptions, k as ExtractionRunResult, l as OpensteerCursorState, m as OpensteerAgentConfig, n as OpensteerAgentInstance, o as ElementPath, p as SnapshotMode, q as AiResolveCallback, r as AiExtractCallback, O as OpensteerAuthScheme, s as OpensteerAgentProvider, t as OpensteerAgentAction, u as OpensteerAgentResult, v as OpensteerAgentUsage, w as OpensteerCursorStyle, x as OpensteerCursorConfig, y as OpensteerAgentExecuteOptions, z as OpensteerBrowserConfig } from './types-Cr10igF3.js';
 export { D as ActionWaitOptions, J as AiExtractArgs, K as AiExtractResult, M as AiResolveArgs, N as AiResolveCallbackResult, P as AiResolveResult, Q as AttributeMatchClause, R as ContextHop, U as DomPath, V as ExtractSchema, W as ExtractSchemaField, X as ExtractSchemaValue, Y as ExtractionFieldPlan, Z as ExtractionPlan, _ as MatchClause, $ as MatchOperator, a0 as OpensteerAgentMode, a1 as OpensteerAgentModelConfig, a2 as OpensteerCloudAnnouncePolicy, a3 as OpensteerCloudBrowserProfileOptions, a4 as OpensteerCloudConfig, a5 as OpensteerCloudOptions, a6 as OpensteerCursorColor, a7 as OpensteerCursorProfile, a8 as OpensteerLocalBrowserMode, a9 as OpensteerStorageConfig, aa as PathNode, ab as PathNodePosition, ac as PositionMatchClause } from './types-Cr10igF3.js';
-import { A as ActionFailure, e as ActionFailureCode, C as CloudErrorCode, f as CloudActionFailureDetails, g as CloudSessionCreateRequest, h as CloudSessionCreateResponse, i as CloudSelectorCacheImportRequest, j as CloudSelectorCacheImportResponse, k as CloudActionMethod, l as CloudSelectorCacheImportEntry } from './browser-profile-client-AGTsLQxT.js';
-export { m as ActionFailureBlocker, n as ActionFailureClassificationSource, o as ActionFailureDetails, p as BrowserProfileArchiveFormat, q as BrowserProfileClient, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor, a as BrowserProfileListRequest, b as BrowserProfileListResponse, r as BrowserProfileProxyPolicy, B as BrowserProfileStatus, s as CloudActionFailure, t as CloudActionRequest, u as CloudActionResponse, v as CloudActionSuccess, w as CloudBrowserProfileLaunchPreference, x as CloudFingerprintMode, y as CloudSessionContractVersion, z as CloudSessionLaunchConfig, D as CloudSessionSourceType, E as CloudSessionSummary, F as cloudSessionContractVersion } from './browser-profile-client-AGTsLQxT.js';
+import { A as ActionFailure, e as ActionFailureCode, C as CloudErrorCode, f as CloudActionFailureDetails, g as CloudSessionCreateRequest, h as CloudSessionCreateResponse, i as CloudSelectorCacheImportRequest, j as CloudSelectorCacheImportResponse, k as CloudActionMethod, l as CloudSelectorCacheImportEntry } from './browser-profile-client-DHLzMf-K.js';
+export { m as ActionFailureBlocker, n as ActionFailureClassificationSource, o as ActionFailureDetails, p as BrowserProfileArchiveFormat, q as BrowserProfileClient, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor, a as BrowserProfileListRequest, b as BrowserProfileListResponse, r as BrowserProfileProxyPolicy, B as BrowserProfileStatus, s as CloudActionFailure, t as CloudActionRequest, u as CloudActionResponse, v as CloudActionSuccess, w as CloudBrowserContextConfig, x as CloudBrowserExtensionConfig, y as CloudBrowserLaunchConfig, z as CloudBrowserProfileLaunchPreference, D as CloudFingerprintMode, E as CloudFingerprintPreference, F as CloudGeolocation, G as CloudProxyMode, H as CloudProxyPreference, I as CloudProxyProtocol, J as CloudSessionContractVersion, K as CloudSessionLaunchConfig, L as CloudSessionSourceType, M as CloudSessionStatus, N as CloudSessionSummary, O as CloudSessionVisibilityScope, P as CloudViewport, Q as cloudActionMethods, R as cloudErrorCodes, S as cloudSessionContractVersion, T as cloudSessionSourceTypes, U as cloudSessionStatuses, V as isCloudActionMethod, W as isCloudErrorCode, X as isCloudSessionSourceType, Y as isCloudSessionStatus } from './browser-profile-client-DHLzMf-K.js';
 
 interface RegistryEntry {
     file: string;

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   BrowserProfileClient
-} from "./chunk-6B6LOYU3.js";
+} from "./chunk-A6LF44E3.js";
 import {
   ActionWsClient,
   BrowserPool,
@@ -40,7 +40,6 @@ import {
   clearPersistentProfileSingletons,
   cloneElementPath,
   closeTab,
-  cloudSessionContractVersion,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
   createCuaClient,
@@ -81,16 +80,25 @@ import {
   switchTab,
   typeText,
   waitForVisualStability
-} from "./chunk-ACRSRDRN.js";
+} from "./chunk-I66RNYIW.js";
 import {
   CloudCdpClient,
   CloudSessionClient,
   OpensteerCloudError,
+  cloudActionMethods,
+  cloudErrorCodes,
   cloudNotLaunchedError,
+  cloudSessionContractVersion,
+  cloudSessionSourceTypes,
+  cloudSessionStatuses,
   cloudUnsupportedMethodError,
+  isCloudActionMethod,
+  isCloudErrorCode,
+  isCloudSessionSourceType,
+  isCloudSessionStatus,
   normalizeNamespace,
   resolveNamespaceDir
-} from "./chunk-KPPOTU3D.js";
+} from "./chunk-GTT3A3RU.js";
 import {
   detectChromePaths,
   expandHome,
@@ -332,8 +340,12 @@ export {
   clearPersistentProfileSingletons,
   cloneElementPath,
   closeTab,
+  cloudActionMethods,
+  cloudErrorCodes,
   cloudNotLaunchedError,
   cloudSessionContractVersion,
+  cloudSessionSourceTypes,
+  cloudSessionStatuses,
   cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
@@ -358,6 +370,10 @@ export {
   getPageHtml,
   getPageTitle,
   importCookies,
+  isCloudActionMethod,
+  isCloudErrorCode,
+  isCloudSessionSourceType,
+  isCloudSessionStatus,
   listLocalChromeProfiles,
   listTabs,
   markInteractiveElements,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensteer",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "description": "Open-source browser automation SDK and CLI that lets AI agents build complex scrapers directly in your codebase.",
   "license": "MIT",
   "type": "module",

package/skills/opensteer/references/sdk-reference.md

@@ -12,6 +12,24 @@ const opensteer = new Opensteer({
 await opensteer.launch({ headless: false });
 await opensteer.close();
 
+// Use the user's local Chrome profile state:
+const opensteer = new Opensteer({
+  name: "my-scraper",
+  browser: {
+    mode: "real",
+    profileDirectory: "Default",
+    headless: false,
+  },
+});
+await opensteer.launch();
+
+// Or pass real-browser mode at launch time:
+await opensteer.launch({
+  mode: "real",
+  profileDirectory: "Default",
+  headless: false,
+});
+
 // Wrap an existing page instance:
 const opensteer = Opensteer.from(existingPage, { name: "my-scraper" });
 ```

package/dist/browser-profile-client-AGTsLQxT.d.ts

@@ -1,168 +0,0 @@
-import { O as OpensteerAuthScheme } from './types-Cr10igF3.js';
-
-type ActionFailureCode = 'TARGET_NOT_FOUND' | 'TARGET_UNAVAILABLE' | 'TARGET_STALE' | 'TARGET_AMBIGUOUS' | 'BLOCKED_BY_INTERCEPTOR' | 'NOT_VISIBLE' | 'NOT_ENABLED' | 'NOT_EDITABLE' | 'INVALID_TARGET' | 'INVALID_OPTIONS' | 'ACTION_TIMEOUT' | 'UNKNOWN';
-type ActionFailureClassificationSource = 'typed_error' | 'playwright_call_log' | 'dom_probe' | 'message_heuristic' | 'unknown';
-interface ActionFailureBlocker {
-    tag: string;
-    id: string | null;
-    classes: string[];
-    role: string | null;
-    text: string | null;
-}
-interface ActionFailureDetails {
-    blocker?: ActionFailureBlocker;
-    observation?: string;
-}
-interface ActionFailure {
-    code: ActionFailureCode;
-    message: string;
-    retryable: boolean;
-    classificationSource: ActionFailureClassificationSource;
-    details?: ActionFailureDetails;
-}
-
-type CloudActionMethod = 'goto' | 'snapshot' | 'state' | 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'tabs' | 'newTab' | 'switchTab' | 'closeTab' | 'getCookies' | 'setCookie' | 'clearCookies' | 'pressKey' | 'type' | 'getElementText' | 'getElementValue' | 'getElementAttributes' | 'getElementBoundingBox' | 'getHtml' | 'getTitle' | 'waitForText' | 'extract' | 'extractFromPlan' | 'clearCache' | 'uploadFile' | 'exportCookies' | 'importCookies' | 'screenshot';
-type CloudErrorCode = 'CLOUD_AUTH_FAILED' | 'CLOUD_SESSION_NOT_FOUND' | 'CLOUD_SESSION_CLOSED' | 'CLOUD_UNSUPPORTED_METHOD' | 'CLOUD_INVALID_REQUEST' | 'CLOUD_MODEL_NOT_ALLOWED' | 'CLOUD_ACTION_FAILED' | 'CLOUD_CAPACITY_EXHAUSTED' | 'CLOUD_RUNTIME_UNAVAILABLE' | 'CLOUD_RUNTIME_MISMATCH' | 'CLOUD_SESSION_STALE' | 'CLOUD_CONTROL_PLANE_ERROR' | 'CLOUD_CONTRACT_MISMATCH' | 'CLOUD_PROXY_UNAVAILABLE' | 'CLOUD_PROXY_REQUIRED' | 'CLOUD_BILLING_LIMIT_REACHED' | 'CLOUD_RATE_LIMITED' | 'CLOUD_BROWSER_PROFILE_NOT_FOUND' | 'CLOUD_BROWSER_PROFILE_BUSY' | 'CLOUD_BROWSER_PROFILE_DISABLED' | 'CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE' | 'CLOUD_BROWSER_PROFILE_SYNC_FAILED' | 'CLOUD_INTERNAL';
-declare const cloudSessionContractVersion: "v3";
-type CloudSessionContractVersion = typeof cloudSessionContractVersion;
-type CloudSessionSourceType = 'agent-thread' | 'agent-run' | 'local-cloud' | 'manual';
-interface CloudBrowserProfileLaunchPreference {
-    profileId: string;
-    reuseIfActive?: boolean;
-}
-interface CloudSessionLaunchConfig {
-    browserProfile?: CloudBrowserProfileLaunchPreference;
-}
-interface CloudSessionCreateRequest {
-    cloudSessionContractVersion: CloudSessionContractVersion;
-    sourceType: 'local-cloud';
-    clientSessionHint: string;
-    localRunId: string;
-    name?: string;
-    model?: string;
-    launchContext?: Record<string, unknown>;
-    launchConfig?: CloudSessionLaunchConfig;
-}
-interface CloudSessionSummary {
-    sessionId: string;
-    workspaceId: string;
-    state: string;
-    createdAt: number;
-    sourceType: CloudSessionSourceType;
-    sourceRef?: string;
-    label?: string;
-}
-interface CloudSessionCreateResponse {
-    sessionId: string;
-    actionWsUrl: string;
-    cdpWsUrl: string;
-    actionToken: string;
-    cdpToken: string;
-    expiresAt?: number;
-    cloudSessionUrl: string;
-    cloudSession: CloudSessionSummary;
-}
-interface CloudSelectorCacheImportEntry {
-    namespace: string;
-    siteOrigin: string;
-    method: string;
-    descriptionHash: string;
-    path: unknown;
-    schemaHash?: string;
-    createdAt: number;
-    updatedAt: number;
-}
-interface CloudSelectorCacheImportRequest {
-    entries: CloudSelectorCacheImportEntry[];
-}
-interface CloudSelectorCacheImportResponse {
-    imported: number;
-    inserted: number;
-    updated: number;
-    skipped: number;
-}
-interface CloudActionRequest {
-    id: number;
-    method: CloudActionMethod;
-    args: Record<string, unknown>;
-    sessionId: string;
-    token: string;
-}
-interface CloudActionSuccess {
-    id: number;
-    ok: true;
-    result: unknown;
-}
-interface CloudActionFailure {
-    id: number;
-    ok: false;
-    error: string;
-    code: CloudErrorCode;
-    details?: CloudActionFailureDetails;
-}
-type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
-interface CloudActionFailureDetails {
-    actionFailure?: ActionFailure;
-}
-type BrowserProfileStatus = 'active' | 'archived' | 'error';
-type BrowserProfileProxyPolicy = 'strict_sticky';
-type CloudFingerprintMode = 'off' | 'auto';
-type BrowserProfileArchiveFormat = 'tar.gz';
-interface BrowserProfileDescriptor {
-    profileId: string;
-    teamId: string;
-    ownerUserId: string;
-    name: string;
-    status: BrowserProfileStatus;
-    proxyPolicy: BrowserProfileProxyPolicy;
-    stickyProxyId?: string;
-    proxyCountryCode?: string;
-    proxyRegion?: string;
-    proxyCity?: string;
-    fingerprintMode: CloudFingerprintMode;
-    fingerprintHash?: string;
-    activeSessionId?: string;
-    lastSessionId?: string;
-    lastLaunchedAt?: number;
-    latestRevision?: number;
-    latestStorageId?: string;
-    latestSizeBytes?: number;
-    latestArchiveSha256?: string;
-    latestArchiveFormat?: BrowserProfileArchiveFormat;
-    createdAt: number;
-    updatedAt: number;
-    lastError?: string;
-}
-interface BrowserProfileListResponse {
-    profiles: BrowserProfileDescriptor[];
-    nextCursor?: string;
-}
-interface BrowserProfileCreateRequest {
-    name: string;
-    proxy?: {
-        proxyId?: string;
-        countryCode?: string;
-        region?: string;
-        city?: string;
-    };
-    fingerprint?: {
-        mode?: CloudFingerprintMode;
-    };
-}
-
-interface BrowserProfileListRequest {
-    cursor?: string;
-    limit?: number;
-    status?: BrowserProfileStatus;
-}
-declare class BrowserProfileClient {
-    private readonly baseUrl;
-    private readonly key;
-    private readonly authScheme;
-    constructor(baseUrl: string, key: string, authScheme?: OpensteerAuthScheme);
-    list(request?: BrowserProfileListRequest): Promise<BrowserProfileListResponse>;
-    get(profileId: string): Promise<BrowserProfileDescriptor>;
-    create(request: BrowserProfileCreateRequest): Promise<BrowserProfileDescriptor>;
-}
-
-export { type ActionFailure as A, type BrowserProfileStatus as B, type CloudErrorCode as C, type CloudSessionSourceType as D, type CloudSessionSummary as E, cloudSessionContractVersion as F, type BrowserProfileListRequest as a, type BrowserProfileListResponse as b, type BrowserProfileCreateRequest as c, type BrowserProfileDescriptor as d, type ActionFailureCode as e, type CloudActionFailureDetails as f, type CloudSessionCreateRequest as g, type CloudSessionCreateResponse as h, type CloudSelectorCacheImportRequest as i, type CloudSelectorCacheImportResponse as j, type CloudActionMethod as k, type CloudSelectorCacheImportEntry as l, type ActionFailureBlocker as m, type ActionFailureClassificationSource as n, type ActionFailureDetails as o, type BrowserProfileArchiveFormat as p, BrowserProfileClient as q, type BrowserProfileProxyPolicy as r, type CloudActionFailure as s, type CloudActionRequest as t, type CloudActionResponse as u, type CloudActionSuccess as v, type CloudBrowserProfileLaunchPreference as w, type CloudFingerprintMode as x, type CloudSessionContractVersion as y, type CloudSessionLaunchConfig as z };