@opengeni/sdk 7.1.0 → 7.1.1

package/dist/{chunk-YHF66FWZ.js → chunk-MPN5UJWE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-FMLDFJ2Q.js";
 import {
   OpenGeniClient
-} from "./chunk-Y7DRKEFZ.js";
+} from "./chunk-NP7DDXHK.js";
 import {
   OpenGeniApiError
 } from "./chunk-OO5LPTO7.js";
@@ -636,4 +636,4 @@ export {
   isOpenGeniSiteBridgeCancelMessage,
   sanitizeOpenGeniSiteToolCallRequest
 };
-//# sourceMappingURL=chunk-YHF66FWZ.js.map
+//# sourceMappingURL=chunk-MPN5UJWE.js.map

package/dist/{chunk-Y7DRKEFZ.js → chunk-NP7DDXHK.js}

@@ -5,11 +5,12 @@ import {
   OPENGENI_API_CONTRACT_REVISION,
   OPENGENI_CORRELATION_HEADER,
   RETAINED_OUTPUT_MAX_PAGE_BYTES
-} from "./chunk-LSO66LQA.js";
+} from "./chunk-E5WAYGHT.js";
 import {
   OpenGeniInteractionClient,
-  decodeComputerFrameMetadataHeader
-} from "./chunk-QTBAMHEF.js";
+  decodeComputerFrameMetadataHeader,
+  parseBrowserFrameMetadata
+} from "./chunk-YUOPVPZW.js";
 import {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
@@ -1197,6 +1198,19 @@ var OpenGeniClient = class {
       options
     );
   }
+  /** Read one selected search result's complete visible text when <=12,000
+   * UTF-16 units. Stale, duplicate or non-message references fail with 404.
+   * The response never includes audit payload fields such as modelContext.
+   */
+  async getSessionMessagePreview(workspaceId, sessionId, reference, options = {}) {
+    return this.requestJson(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}/events/${encodeURIComponent(reference.eventId)}/message-preview`,
+      void 0,
+      { sequence: String(reference.sequence) },
+      options
+    );
+  }
   async listSessions(workspaceId, options = {}) {
     if (options.search?.trim() || options.originSiteId) {
       const page = await this.listSessionPage(workspaceId, options);
@@ -2905,6 +2919,54 @@ var OpenGeniClient = class {
       options
     );
   }
+  async captureBrowserTarget(workspaceId, browserSessionId, targetId, options = {}, captureOptions = {}) {
+    const query = new URLSearchParams();
+    if (captureOptions.fullPage !== void 0) {
+      if (typeof captureOptions.fullPage !== "boolean") {
+        throw new TypeError("browser screenshot fullPage must be a boolean");
+      }
+      query.set("fullPage", String(captureOptions.fullPage));
+    }
+    if (captureOptions.format !== void 0) {
+      if (captureOptions.format !== "jpeg" && captureOptions.format !== "png") {
+        throw new TypeError("browser screenshot format must be jpeg or png");
+      }
+      query.set("format", captureOptions.format);
+    }
+    if (captureOptions.quality !== void 0) {
+      if (!Number.isSafeInteger(captureOptions.quality) || captureOptions.quality < 1 || captureOptions.quality > 100) {
+        throw new RangeError("browser screenshot quality must be an integer from 1 to 100");
+      }
+      query.set("quality", String(captureOptions.quality));
+    }
+    const suffix = query.size > 0 ? `?${query}` : "";
+    const response = await this.requestResponse(
+      "GET",
+      `/v1/workspaces/${workspaceId}/browser-sessions/${encodeURIComponent(browserSessionId)}/targets/${encodeURIComponent(targetId)}/screenshot${suffix}`,
+      {},
+      options
+    );
+    const mediaType = response.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase();
+    const header = response.headers.get("x-opengeni-browser-frame");
+    if (mediaType !== "image/jpeg" && mediaType !== "image/png" || !header || header.length > 64 * 1024) {
+      await cancelResponseBody(response, "browser frame metadata is invalid");
+      throw new OpenGeniApiError(502, "browser frame metadata is invalid");
+    }
+    let metadata;
+    try {
+      metadata = parseBrowserFrameMetadata(
+        JSON.parse(atob(header.replace(/-/gu, "+").replace(/_/gu, "/")))
+      );
+    } catch {
+      await cancelResponseBody(response, "browser frame metadata is invalid");
+      throw new OpenGeniApiError(502, "browser frame metadata is invalid");
+    }
+    const data = await readBoundedResponseBytes(response, 24 * 1024 * 1024, null);
+    if (metadata.browserSessionId !== browserSessionId || metadata.targetId !== targetId || metadata.mediaType !== mediaType) {
+      throw new OpenGeniApiError(502, "browser frame evidence does not match its request");
+    }
+    return { ...metadata, data };
+  }
   async closeBrowserTarget(workspaceId, browserSessionId, targetId, options = {}) {
     return await this.requestJson(
       "DELETE",
@@ -2923,6 +2985,32 @@ var OpenGeniClient = class {
       options
     );
   }
+  async getBrowserTargetState(workspaceId, browserSessionId, targetId, options = {}) {
+    const state = await this.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/browser-sessions/${encodeURIComponent(browserSessionId)}/targets/${encodeURIComponent(targetId)}/state`,
+      void 0,
+      {},
+      options
+    );
+    if (state.browserSessionId !== browserSessionId || state.targetId !== targetId) {
+      throw new OpenGeniApiError(502, "browser target state belongs to another binding");
+    }
+    return state;
+  }
+  async readBrowserDom(workspaceId, browserSessionId, targetId, request, options = {}) {
+    const result = await this.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/browser-sessions/${encodeURIComponent(browserSessionId)}/targets/${encodeURIComponent(targetId)}/dom-read`,
+      request,
+      {},
+      options
+    );
+    if (result.browserSessionId !== browserSessionId || result.targetId !== targetId || result.kind !== request.kind || result.targetGeneration !== request.expectedTargetGeneration || result.documentGeneration !== request.expectedDocumentGeneration || result.frameId !== request.expectedFrameId) {
+      throw new OpenGeniApiError(502, "browser DOM read belongs to another binding");
+    }
+    return result;
+  }
   async actInBrowser(workspaceId, browserSessionId, request, options = {}) {
     return await this.requestJson(
       "POST",
@@ -4463,7 +4551,8 @@ var OpenGeniClient = class {
   async downloadRetainedScreenshot(workspaceId, sessionId, artifactId, options = {}) {
     const metadata = await this.getSessionRetainedArtifact(workspaceId, sessionId, artifactId);
     if (!metadata.available) return { metadata, bytes: null };
-    if (metadata.kind !== "computer_screenshot" || metadata.contentType !== "image/png" || !metadata.dimensions || metadata.originalBytes <= 0 || metadata.originalBytes > COMPUTER_SCREENSHOT_MAX_BYTES) {
+    const supportedScreenshot = metadata.kind === "computer_screenshot" && metadata.contentType === "image/png" || metadata.kind === "browser_screenshot" && ["image/png", "image/jpeg", "image/webp"].includes(metadata.contentType);
+    if (!supportedScreenshot || !metadata.dimensions || metadata.originalBytes <= 0 || metadata.originalBytes > COMPUTER_SCREENSHOT_MAX_BYTES) {
       throw new OpenGeniApiError(502, "retained screenshot metadata is invalid");
     }
     const bytes = await this.downloadRetainedArtifactBytes(metadata, options);
@@ -6317,4 +6406,4 @@ export {
   parseMediaGenerationResult,
   OpenGeniClient
 };
-//# sourceMappingURL=chunk-Y7DRKEFZ.js.map
+//# sourceMappingURL=chunk-NP7DDXHK.js.map