opensteer 0.8.13 → 0.8.14

package/dist/index.js

@@ -1,11 +1,35 @@
-import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-BW2BH7HA.js';
-export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, 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, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-BW2BH7HA.js';
+import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-BRUJHMWO.js';
+export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, 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, hashDomDescriptorName, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-BRUJHMWO.js';
 
 // src/sdk/opensteer.ts
+var SessionCookieJar = class {
+  domain;
+  cookies;
+  constructor(output) {
+    if (output.domain !== void 0) {
+      this.domain = output.domain;
+    }
+    this.cookies = output.cookies;
+  }
+  has(name) {
+    return this.cookies.some((cookie) => cookie.name === name);
+  }
+  get(name) {
+    return this.cookies.find((cookie) => cookie.name === name)?.value;
+  }
+  getAll() {
+    return this.cookies;
+  }
+  serialize() {
+    return this.cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join("; ");
+  }
+};
 var Opensteer = class {
   runtime;
   browserManager;
   browser;
+  dom;
+  network;
   constructor(options = {}) {
     const environment = resolveOpensteerEnvironment(options.rootDir);
     const { provider, engineName, ...runtimeOptions } = options;
@@ -15,41 +39,53 @@ var Opensteer = class {
     });
     if (runtimeConfig.provider.mode === "cloud") {
       this.browserManager = void 0;
+      this.runtime = createOpensteerSemanticRuntime({
+        ...provider === void 0 ? {} : { provider },
+        ...engineName === void 0 ? {} : { engine: engineName },
+        environment,
+        runtimeOptions
+      });
+      this.browser = createUnsupportedBrowserController();
+    } else {
+      this.browserManager = new OpensteerBrowserManager({
+        ...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({
         ...provider === void 0 ? {} : { provider },
         ...engineName === void 0 ? {} : { engine: engineName },
         environment,
         runtimeOptions: {
-          ...runtimeOptions
+          ...runtimeOptions,
+          rootPath: this.browserManager.rootPath,
+          cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect
         }
       });
-      this.browser = createUnsupportedBrowserController();
-      return;
+      this.browser = {
+        status: () => this.browserManager.status(),
+        clone: (input) => this.browserManager.clonePersistentBrowser(input),
+        reset: () => this.browserManager.reset(),
+        delete: () => this.browserManager.delete()
+      };
     }
-    this.browserManager = new OpensteerBrowserManager({
-      ...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({
-      ...provider === void 0 ? {} : { provider },
-      ...engineName === void 0 ? {} : { engine: engineName },
-      environment,
-      runtimeOptions: {
-        ...runtimeOptions,
-        rootPath: this.browserManager.rootPath,
-        cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect
-      }
-    });
-    this.browser = {
-      status: () => this.browserManager.status(),
-      clone: (input) => this.browserManager.clonePersistentBrowser(input),
-      reset: () => this.browserManager.reset(),
-      delete: () => this.browserManager.delete()
+    this.dom = {
+      click: (input) => this.click(input),
+      hover: (input) => this.hover(input),
+      input: (input) => this.input(input),
+      scroll: (input) => this.scroll(input)
+    };
+    this.network = {
+      query: (input = {}) => this.queryNetwork(input),
+      detail: (recordId) => this.runtime.getNetworkDetail({ recordId }),
+      replay: (recordId, overrides = {}) => this.runtime.replayNetwork({
+        recordId,
+        ...overrides
+      })
     };
   }
   async open(input = {}) {
@@ -70,58 +106,56 @@ var Opensteer = class {
   async closePage(input = {}) {
     return this.runtime.closePage(input);
   }
-  async goto(input) {
-    return this.runtime.goto(typeof input === "string" ? { url: input } : input);
+  async goto(url, options = {}) {
+    return this.runtime.goto({
+      url,
+      ...options
+    });
   }
   async evaluate(input) {
     const normalized = typeof input === "string" ? {
       script: input
     } : input;
-    const result = await this.runtime.evaluate(normalized);
-    return result.value;
+    return (await this.runtime.evaluate(normalized)).value;
   }
   async evaluateJson(input) {
     return this.evaluate(input);
   }
   async addInitScript(input) {
-    const normalized = typeof input === "string" ? {
-      script: input
-    } : input;
-    return this.runtime.addInitScript(normalized);
+    return this.runtime.addInitScript(
+      typeof input === "string" ? {
+        script: input
+      } : input
+    );
   }
   async click(input) {
     const { button, clickCount, modifiers, ...target } = input;
-    const normalized = {
+    return this.runtime.click({
       ...normalizeTargetOptions(target),
       ...button === void 0 ? {} : { button },
       ...clickCount === void 0 ? {} : { clickCount },
       ...modifiers === void 0 ? {} : { modifiers }
-    };
-    return this.runtime.click(normalized);
+    });
   }
   async hover(input) {
-    const normalized = normalizeTargetOptions(input);
-    return this.runtime.hover(normalized);
+    return this.runtime.hover(normalizeTargetOptions(input));
   }
   async input(input) {
-    const normalized = normalizeTargetOptions(input);
     return this.runtime.input({
-      ...normalized,
+      ...normalizeTargetOptions(input),
       text: input.text,
       ...input.pressEnter === void 0 ? {} : { pressEnter: input.pressEnter }
     });
   }
   async scroll(input) {
-    const normalized = normalizeTargetOptions(input);
     return this.runtime.scroll({
-      ...normalized,
+      ...normalizeTargetOptions(input),
       direction: input.direction,
       amount: input.amount
     });
   }
   async extract(input) {
-    const result = await this.runtime.extract(input);
-    return result.data;
+    return (await this.runtime.extract(input)).data;
   }
   async queryNetwork(input = {}) {
     return this.runtime.queryNetwork(input);
@@ -131,17 +165,14 @@ var Opensteer = class {
     const timeoutAt = Date.now() + (timeoutMs ?? 3e4);
     const pollInterval = pollIntervalMs ?? 100;
     const baseline = new Set(
-      (await this.runtime.queryNetwork({
-        ...query,
-        limit: 200
-      })).records.map((record) => record.recordId)
+      (await this.runtime.queryNetwork({ ...query, limit: 200 })).records.map(
+        (record) => record.recordId
+      )
     );
     while (true) {
-      const { records } = await this.runtime.queryNetwork({
-        ...query,
-        limit: 200
-      });
-      const next = records.find((record) => !baseline.has(record.recordId));
+      const next = (await this.runtime.queryNetwork({ ...query, limit: 200 })).records.find(
+        (record) => !baseline.has(record.recordId)
+      );
       if (next !== void 0) {
         return next;
       }
@@ -159,8 +190,7 @@ var Opensteer = class {
     const timeoutAt = Date.now() + (input.timeoutMs ?? 3e4);
     const pollIntervalMs = input.pollIntervalMs ?? 100;
     while (true) {
-      const { pages } = await this.runtime.listPages();
-      const match = pages.find((page) => {
+      const match = (await this.runtime.listPages()).pages.find((page) => {
         if (baseline.has(page.pageRef)) {
           return false;
         }
@@ -181,131 +211,38 @@ var Opensteer = class {
       await delay(pollIntervalMs);
     }
   }
-  async snapshot(input = {}) {
-    return this.runtime.snapshot(typeof input === "string" ? { mode: input } : input);
-  }
-  async tagNetwork(input) {
-    return this.runtime.tagNetwork(input);
-  }
-  async minimizeNetwork(input) {
-    return this.runtime.minimizeNetwork(input);
-  }
-  async diffNetwork(input) {
-    return this.runtime.diffNetwork(input);
-  }
-  async probeNetwork(input) {
-    return this.runtime.probeNetwork(input);
-  }
-  async reverseDiscover(input = {}) {
-    return this.runtime.discoverReverse(input);
-  }
-  async reverseQuery(input) {
-    return this.runtime.queryReverse(input);
-  }
-  async createReversePackage(input) {
-    return this.runtime.createReversePackage(input);
-  }
-  async runReversePackage(input) {
-    return this.runtime.runReversePackage(input);
-  }
-  async reverseExport(input) {
-    return this.runtime.exportReverse(input);
-  }
-  async reverseReport(input) {
-    return this.runtime.getReverseReport(input);
-  }
-  async getReversePackage(input) {
-    return this.runtime.getReversePackage(input);
+  async snapshot(mode = "action") {
+    return (await this.runtime.snapshot({ mode })).html;
   }
-  async listReversePackages(input = {}) {
-    return this.runtime.listReversePackages(input);
-  }
-  async patchReversePackage(input) {
-    return this.runtime.patchReversePackage(input);
-  }
-  async interactionCapture(input) {
-    return this.runtime.captureInteraction(input);
-  }
-  async getInteraction(input) {
-    return this.runtime.getInteraction(input);
-  }
-  async interactionDiff(input) {
-    return this.runtime.diffInteraction(input);
-  }
-  async interactionReplay(input) {
-    return this.runtime.replayInteraction(input);
-  }
-  async clearNetwork(input = {}) {
-    return this.runtime.clearNetwork(input);
-  }
-  async captureScripts(input = {}) {
-    return this.runtime.captureScripts(input);
-  }
-  async readArtifact(input) {
-    return this.runtime.readArtifact(input);
-  }
-  async beautifyScript(input) {
-    return this.runtime.beautifyScript(input);
-  }
-  async deobfuscateScript(input) {
-    return this.runtime.deobfuscateScript(input);
-  }
-  async sandboxScript(input) {
-    return this.runtime.sandboxScript(input);
-  }
-  async solveCaptcha(input) {
-    return this.runtime.solveCaptcha(input);
-  }
-  async getCookies(input = {}) {
-    return this.runtime.getCookies(input);
-  }
-  async getStorageSnapshot(input = {}) {
-    return this.runtime.getStorageSnapshot(input);
-  }
-  async writeRequestPlan(input) {
-    return this.runtime.writeRequestPlan(input);
-  }
-  async inferRequestPlan(input) {
-    return this.runtime.inferRequestPlan(input);
-  }
-  async getRequestPlan(input) {
-    return this.runtime.getRequestPlan(input);
-  }
-  async listRequestPlans(input = {}) {
-    return this.runtime.listRequestPlans(input);
-  }
-  async writeAuthRecipe(input) {
-    return this.runtime.writeAuthRecipe(input);
-  }
-  async writeRecipe(input) {
-    return this.runtime.writeRecipe(input);
-  }
-  async getAuthRecipe(input) {
-    return this.runtime.getAuthRecipe(input);
-  }
-  async getRecipe(input) {
-    return this.runtime.getRecipe(input);
-  }
-  async listAuthRecipes(input = {}) {
-    return this.runtime.listAuthRecipes(input);
-  }
-  async listRecipes(input = {}) {
-    return this.runtime.listRecipes(input);
+  async cookies(domain) {
+    return new SessionCookieJar(
+      await this.runtime.getCookies(domain === void 0 ? {} : { domain })
+    );
   }
-  async runAuthRecipe(input) {
-    return this.runtime.runAuthRecipe(input);
+  async storage(domain, type = "local") {
+    const snapshot = await this.runtime.getStorageSnapshot(domain === void 0 ? {} : { domain });
+    const domainSnapshot = pickStorageDomainSnapshot(snapshot, domain);
+    if (domainSnapshot === void 0) {
+      return {};
+    }
+    const entries = type === "local" ? domainSnapshot.localStorage : domainSnapshot.sessionStorage;
+    return Object.fromEntries(entries.map((entry) => [entry.key, entry.value]));
   }
-  async runRecipe(input) {
-    return this.runtime.runRecipe(input);
+  async state(domain) {
+    return this.runtime.getBrowserState(domain === void 0 ? {} : { domain });
   }
-  async request(key, input = {}) {
-    return this.runtime.request({
-      key,
-      ...input
+  async fetch(url, options = {}) {
+    const result = await this.runtime.fetch({
+      url,
+      ...options
     });
+    if (result.response === void 0) {
+      throw new Error(result.note ?? `session.fetch did not produce a response for ${url}`);
+    }
+    return toResponse(result.response);
   }
-  async rawRequest(input) {
-    return this.runtime.rawRequest(input);
+  async computerExecute(input) {
+    return this.runtime.computerExecute(input);
   }
   async route(input) {
     return this.requireOwnedInstrumentationRuntime("route").route(input);
@@ -313,9 +250,6 @@ var Opensteer = class {
   async interceptScript(input) {
     return this.requireOwnedInstrumentationRuntime("interceptScript").interceptScript(input);
   }
-  async computerExecute(input) {
-    return this.runtime.computerExecute(input);
-  }
   async close() {
     if (this.browserManager === void 0 || this.browserManager.mode === "temporary") {
       return this.runtime.close();
@@ -328,15 +262,12 @@ var Opensteer = class {
     await this.runtime.disconnect();
   }
   requireOwnedInstrumentationRuntime(method) {
-    if (isInstrumentableRuntime(this.runtime)) {
+    if (typeof this.runtime.route === "function" && typeof this.runtime.interceptScript === "function") {
       return this.runtime;
     }
     throw new Error(`${method}() is not available for this session runtime.`);
   }
 };
-function isInstrumentableRuntime(runtime) {
-  return typeof runtime.route === "function" && typeof runtime.interceptScript === "function";
-}
 function createUnsupportedBrowserController() {
   const fail = async () => {
     throw new Error("browser.* helpers are only available in local mode.");
@@ -352,7 +283,7 @@ function normalizeTargetOptions(input) {
   const hasElement = input.element !== void 0;
   const hasSelector = input.selector !== void 0;
   if (hasElement && hasSelector) {
-    throw new Error("Specify exactly one of element, selector, or description.");
+    throw new Error("Specify exactly one of element, selector, or persist.");
   }
   if (hasElement) {
     return {
@@ -360,7 +291,7 @@ function normalizeTargetOptions(input) {
         kind: "element",
         element: input.element
       },
-      ...input.description === void 0 ? {} : { persistAsDescription: input.description },
+      ...input.persist === void 0 ? {} : { persist: input.persist },
       ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
     };
   }
@@ -370,21 +301,43 @@ function normalizeTargetOptions(input) {
         kind: "selector",
         selector: input.selector
       },
-      ...input.description === void 0 ? {} : { persistAsDescription: input.description },
+      ...input.persist === void 0 ? {} : { persist: input.persist },
       ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
     };
   }
-  if (input.description === void 0) {
-    throw new Error("Specify exactly one of element, selector, or description.");
+  if (input.persist === void 0) {
+    throw new Error("Specify exactly one of element, selector, or persist.");
   }
   return {
     target: {
-      kind: "description",
-      description: input.description
+      kind: "persist",
+      name: input.persist
     },
     ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
   };
 }
+function pickStorageDomainSnapshot(snapshot, domain) {
+  if (snapshot.domains.length === 0) {
+    return void 0;
+  }
+  if (domain === void 0) {
+    return snapshot.domains[0];
+  }
+  return snapshot.domains.find((entry) => entry.domain === domain);
+}
+function toResponse(response) {
+  return new Response(decodeBody(response), {
+    status: response.status,
+    statusText: response.statusText,
+    headers: Object.fromEntries(response.headers.map((header) => [header.name, header.value]))
+  });
+}
+function decodeBody(response) {
+  if (response.body === void 0) {
+    return void 0;
+  }
+  return Uint8Array.from(Buffer.from(response.body.data, "base64"));
+}
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }