@opengeni/sdk 7.1.0 → 7.1.1

package/dist/site.js

@@ -18,11 +18,11 @@ import {
   sanitizeOpenGeniSiteToolCallRequest,
   serveSiteHttp,
   siteSessionPath
-} from "./chunk-YHF66FWZ.js";
+} from "./chunk-MPN5UJWE.js";
 import "./chunk-FMLDFJ2Q.js";
-import "./chunk-Y7DRKEFZ.js";
-import "./chunk-LSO66LQA.js";
-import "./chunk-QTBAMHEF.js";
+import "./chunk-NP7DDXHK.js";
+import "./chunk-E5WAYGHT.js";
+import "./chunk-YUOPVPZW.js";
 import "./chunk-OO5LPTO7.js";
 export {
   OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL,

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { WorkspaceTranscriptionPolicy } from "./transcription.js";
-export type { SessionMessageSearchRequest, SessionMessageSearchMatch, SessionMessageSearchResponse, } from "./session-message-search.js";
+export type { SessionMessageSearchRequest, SessionMessageSearchMatch, SessionMessageSearchResponse, SessionMessagePreview, SessionMessagePreviewReference, } from "./session-message-search.js";
 export type BundledSkillId = "builtin:opengeni-help" | "builtin:opengeni-client" | "builtin:opengeni-visualize" | "builtin:document-parsing" | "builtin:opengeni-skills" | "builtin:opengeni-projects" | "builtin:opengeni-documents" | "builtin:opengeni-spreadsheets" | "builtin:opengeni-presentations" | "builtin:opengeni-sites" | "builtin:opengeni-video-generation";
 export type CodexRealtimeWebrtcVersion = "v3";
 export type CodexRealtimeVoice = "juniper" | "maple" | "spruce" | "ember" | "vale" | "breeze" | "arbor" | "sol" | "cove";
@@ -2456,7 +2456,7 @@ export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
  * can introduce permissions without breaking older SDK consumers.
  */
 export type Permission = KnownPermission | (string & {});
-export type FirstPartyMcpToolName = "knowledge_search" | "knowledge_prepare_save" | "knowledge_get" | "knowledge_browse" | "knowledge_save" | "knowledge_retain_file" | "knowledge_retain_message" | "knowledge_archive" | "instruction_policy_save" | "instruction_policy_get" | "set_session_title" | "goal_set" | "goal_update" | "goal_progress" | "wait_for_input" | "goal_complete" | "goal_pause" | "goal_resume" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "task_notes_list" | "task_note_save" | "task_note_archive" | "task_note_replace" | "work_claim_upsert" | "work_claim_release" | "knowledge_propose" | "knowledge_correct" | "task_note_promote_knowledge" | "task_note_promote_instruction_policy" | "task_note_promote_preference" | "instruction_policy_propose" | "preference_propose" | "remember" | "remember_confirm" | "company_profile_propose" | "company_profile_confirm" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "connected_machine_remove" | "connected_machine_enroll_token" | "project_list" | "project_get" | "project_create" | "project_update" | "project_reorder" | "project_delete" | "session_set_project" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_wait" | "command_read" | "command_wait" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "session_human_input_respond" | "set_other_session_title" | "interaction_discover" | "browser_open" | "browser_tabs" | "browser_observe" | "browser_act" | "browser_clipboard" | "browser_debug" | "browser_auth" | "interaction_request_human" | "browser_identity" | "browser_publish" | "browser_lifecycle" | "computer_open" | "computer_targets" | "computer_observe" | "computer_clipboard" | "computer_act" | "computer_lifecycle" | "variable_set_list" | "environment_list" | "variable_set_get_variable" | "variable_set_set_variable" | "environment_set_variable" | "capability_catalog_search" | "capability_authorization_request" | "github_connect_link" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "social_search_live" | "social_mentions_live" | "social_thread_fetch" | "social_posts_sync" | "social_post_reply" | "x_accounts_list" | "x_search_live" | "x_mentions_live" | "x_thread_fetch" | "x_posts_sync" | "x_post_reply" | "reddit_accounts_list" | "reddit_search_live" | "reddit_mentions_live" | "reddit_thread_fetch" | "reddit_posts_sync" | "reddit_post_reply" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_search" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message" | "fiken_companies_list" | "fiken_contacts_list" | "fiken_contact_create" | "fiken_products_list" | "fiken_invoices_list" | "fiken_invoice_get" | "fiken_invoice_draft_create" | "fiken_bank_accounts_list" | "fiken_purchases_list" | "fiken_sales_list" | "atlassian_sources_list" | "atlassian_search" | "atlassian_get" | "sandbox_file_publish" | "artifacts_list" | "artifacts_get_source" | "artifacts_prepare_upload" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback" | "artifacts_archive" | "artifacts_restore" | "editable_artifact_list" | "editable_artifact_create" | "editable_artifact_import" | "editable_artifact_get" | "editable_artifact_inspect" | "editable_artifact_apply" | "editable_artifact_export" | "editable_artifact_export_status";
+export type FirstPartyMcpToolName = "knowledge_search" | "knowledge_prepare_save" | "knowledge_get" | "knowledge_browse" | "knowledge_save" | "knowledge_retain_file" | "knowledge_retain_message" | "knowledge_archive" | "instruction_policy_save" | "instruction_policy_get" | "set_session_title" | "goal_set" | "goal_update" | "goal_progress" | "wait_for_input" | "goal_complete" | "goal_pause" | "goal_resume" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "task_notes_list" | "task_note_save" | "task_note_archive" | "task_note_replace" | "work_claim_upsert" | "work_claim_release" | "knowledge_propose" | "knowledge_correct" | "task_note_promote_knowledge" | "task_note_promote_instruction_policy" | "task_note_promote_preference" | "instruction_policy_propose" | "preference_propose" | "remember" | "remember_confirm" | "company_profile_propose" | "company_profile_confirm" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "connected_machine_remove" | "connected_machine_enroll_token" | "project_list" | "project_get" | "project_create" | "project_update" | "project_reorder" | "project_delete" | "session_set_project" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_wait" | "command_read" | "command_wait" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "session_human_input_respond" | "set_other_session_title" | "interaction_discover" | "browser_open" | "browser_tabs" | "browser_observe" | "browser_act" | "browser_read" | "browser_screenshot" | "browser_clipboard" | "browser_debug" | "browser_auth" | "interaction_request_human" | "browser_identity" | "browser_publish" | "browser_lifecycle" | "computer_open" | "computer_targets" | "computer_observe" | "computer_clipboard" | "computer_act" | "computer_lifecycle" | "variable_set_list" | "environment_list" | "variable_set_get_variable" | "variable_set_set_variable" | "environment_set_variable" | "capability_catalog_search" | "capability_authorization_request" | "github_connect_link" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "social_search_live" | "social_mentions_live" | "social_thread_fetch" | "social_posts_sync" | "social_post_reply" | "x_accounts_list" | "x_search_live" | "x_mentions_live" | "x_thread_fetch" | "x_posts_sync" | "x_post_reply" | "reddit_accounts_list" | "reddit_search_live" | "reddit_mentions_live" | "reddit_thread_fetch" | "reddit_posts_sync" | "reddit_post_reply" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_search" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message" | "fiken_companies_list" | "fiken_contacts_list" | "fiken_contact_create" | "fiken_products_list" | "fiken_invoices_list" | "fiken_invoice_get" | "fiken_invoice_draft_create" | "fiken_bank_accounts_list" | "fiken_purchases_list" | "fiken_sales_list" | "atlassian_sources_list" | "atlassian_search" | "atlassian_get" | "sandbox_file_publish" | "artifacts_list" | "artifacts_get_source" | "artifacts_prepare_upload" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback" | "artifacts_archive" | "artifacts_restore" | "editable_artifact_list" | "editable_artifact_create" | "editable_artifact_import" | "editable_artifact_get" | "editable_artifact_inspect" | "editable_artifact_apply" | "editable_artifact_export" | "editable_artifact_export_status";
 export type ProductAccessMode = "local" | "configured" | "managed";
 export type ModelCapabilitySupportV1 = "supported" | "unsupported" | "unknown";
 export type ModelCapabilityStateV1 = {
@@ -4638,7 +4638,7 @@ export declare const RETAINED_OUTPUT_MAX_PAGE_BYTES: number;
 export declare const COMPUTER_SCREENSHOT_MAX_BYTES: number;
 export declare const GENERATED_IMAGE_MAX_BYTES: number;
 export declare const GENERATED_VIDEO_MAX_BYTES: number;
-export type RetainedOutputKind = "tool_result" | "assistant_completion" | "internal_update" | "event_media" | "computer_screenshot" | "generated_image" | "generated_video" | "file";
+export type RetainedOutputKind = "tool_result" | "assistant_completion" | "internal_update" | "event_media" | "computer_screenshot" | "browser_screenshot" | "generated_image" | "generated_video" | "file";
 export type RetainedOutputUnavailableReason = "not_retained" | "pending" | "failed" | "expired" | "deleted" | "missing_storage" | "storage_write_failed" | "quota_exceeded" | "invalid_content" | "oversized" | "unsupported";
 export type RetainedArtifactReference = {
     available: true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "7.1.0",
+  "version": "7.1.1",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {
@@ -130,7 +130,7 @@
   },
   "dependencies": {
     "@opengeni/connect": "^0.3.0",
-    "@opengeni/contracts": "^5.1.0"
+    "@opengeni/contracts": "^5.1.1"
   },
   "engines": {
     "node": ">=18"

package/src/browser.ts

@@ -4,6 +4,8 @@ export type {
   SessionMessageSearchRequest,
   SessionMessageSearchMatch,
   SessionMessageSearchResponse,
+  SessionMessagePreview,
+  SessionMessagePreviewReference,
 } from "./session-message-search";
 export {
   OpenGeniToolCallError,

package/src/client.ts

@@ -2,6 +2,8 @@ import type { ArtifactCatalogListOptions, ArtifactCatalogListResponse } from "./
 import type {
   SessionMessageSearchRequest,
   SessionMessageSearchResponse,
+  SessionMessagePreview,
+  SessionMessagePreviewReference,
 } from "./session-message-search";
 import type {
   KnowledgeOriginalFileDownload,
@@ -68,6 +70,7 @@ import {
 import {
   OpenGeniInteractionClient,
   decodeComputerFrameMetadataHeader,
+  parseBrowserFrameMetadata,
   type AuthRun,
   type AuthRunListOptions,
   type AuthRunListResponse,
@@ -77,8 +80,11 @@ import {
   type AttachedBrowserDeviceListResponse,
   type BrowserActionReceipt,
   type BrowserActionRequest,
+  type BrowserScreenshotOptions,
   type BrowserClipboard,
   type BrowserDiagnosticBatch,
+  type BrowserDomReadRequest,
+  type BrowserDomReadResponse,
   type BrowserDiagnosticsOptions,
   type BrowserDownload,
   type BrowserDownloadListResponse,
@@ -89,6 +95,8 @@ import {
   type BrowserIdentityListResponse,
   type BrowserIdentityMutationResponse,
   type BrowserObservation,
+  type BrowserFrame,
+  type BrowserFrameMetadata,
   type BrowserOpenTargetRequest,
   type BrowserSession,
   type BrowserSessionAttachment,
@@ -97,6 +105,7 @@ import {
   type BrowserSessionLifecycleRequest,
   type BrowserSessionListResponse,
   type BrowserSessionMutationResponse,
+  type BrowserTargetState,
   type BrowserTargetListResponse,
   type BrowserRevisionListResponse,
   type ComputerActionReceipt,
@@ -1330,6 +1339,25 @@ export class OpenGeniClient {
     );
   }
 
+  /** 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: string,
+    sessionId: string,
+    reference: SessionMessagePreviewReference,
+    options: OpenGeniRequestOptions = {},
+  ): Promise<SessionMessagePreview> {
+    return this.requestJson<SessionMessagePreview>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/sessions/${encodeURIComponent(sessionId)}/events/${encodeURIComponent(reference.eventId)}/message-preview`,
+      undefined,
+      { sequence: String(reference.sequence) },
+      options,
+    );
+  }
+
   async listSessions(
     workspaceId: string,
     options: {
@@ -3926,6 +3954,73 @@ export class OpenGeniClient {
     );
   }
 
+  async captureBrowserTarget(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    options: OpenGeniRequestOptions = {},
+    captureOptions: BrowserScreenshotOptions = {},
+  ): Promise<BrowserFrame> {
+    const query = new URLSearchParams();
+    if (captureOptions.fullPage !== undefined) {
+      if (typeof captureOptions.fullPage !== "boolean") {
+        throw new TypeError("browser screenshot fullPage must be a boolean");
+      }
+      query.set("fullPage", String(captureOptions.fullPage));
+    }
+    if (captureOptions.format !== undefined) {
+      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 !== undefined) {
+      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: BrowserFrameMetadata;
+    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: string,
     browserSessionId: string,
@@ -3956,6 +4051,52 @@ export class OpenGeniClient {
     );
   }
 
+  async getBrowserTargetState(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    options: OpenGeniRequestOptions = {},
+  ): Promise<BrowserTargetState> {
+    const state = await this.requestJson<BrowserTargetState>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/browser-sessions/${encodeURIComponent(browserSessionId)}/targets/${encodeURIComponent(targetId)}/state`,
+      undefined,
+      {},
+      options,
+    );
+    if (state.browserSessionId !== browserSessionId || state.targetId !== targetId) {
+      throw new OpenGeniApiError(502, "browser target state belongs to another binding");
+    }
+    return state;
+  }
+
+  async readBrowserDom(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    request: BrowserDomReadRequest,
+    options: OpenGeniRequestOptions = {},
+  ): Promise<BrowserDomReadResponse> {
+    const result = await this.requestJson<BrowserDomReadResponse>(
+      "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: string,
     browserSessionId: string,
@@ -6247,9 +6388,12 @@ export class OpenGeniClient {
   ): Promise<RetainedScreenshotDownload> {
     const metadata = await this.getSessionRetainedArtifact(workspaceId, sessionId, artifactId);
     if (!metadata.available) return { metadata, bytes: null };
+    const supportedScreenshot =
+      (metadata.kind === "computer_screenshot" && metadata.contentType === "image/png") ||
+      (metadata.kind === "browser_screenshot" &&
+        ["image/png", "image/jpeg", "image/webp"].includes(metadata.contentType));
     if (
-      metadata.kind !== "computer_screenshot" ||
-      metadata.contentType !== "image/png" ||
+      !supportedScreenshot ||
       !metadata.dimensions ||
       metadata.originalBytes <= 0 ||
       metadata.originalBytes > COMPUTER_SCREENSHOT_MAX_BYTES

package/src/index.ts

@@ -8,6 +8,8 @@ export type {
   SessionMessageSearchRequest,
   SessionMessageSearchMatch,
   SessionMessageSearchResponse,
+  SessionMessagePreview,
+  SessionMessagePreviewReference,
 } from "./session-message-search";
 export { OpenGeniEmbeddingClient as OpenGeniClient } from "./embedding-client";
 export { pluginMcpUnavailableReason } from "@opengeni/contracts/plugin-discovery";

package/src/interaction.ts

@@ -1,4 +1,15 @@
 import type { OpenGeniRequestOptions } from "./client";
+import type {
+  BrowserDomReadRequest,
+  BrowserDomReadResponse,
+  BrowserTargetState,
+} from "@opengeni/contracts";
+export type {
+  BrowserDomReadRequest,
+  BrowserDomReadResponse,
+  BrowserDomSafeAttribute,
+  BrowserTargetState,
+} from "@opengeni/contracts";
 import { OpenGeniApiError } from "./errors";
 import type { RetainedArtifactReference } from "./types";
 
@@ -802,6 +813,17 @@ export type BrowserObservation = {
   frameId: string | null;
   semantic: InteractionSemanticSnapshot | InteractionSemanticDiff | null;
   screenshot: RetainedArtifactReference | null;
+  viewport?:
+    | {
+        width: number;
+        height: number;
+        visualWidth: number;
+        visualHeight: number;
+        deviceScaleFactor: number;
+        maxTouchPoints: number;
+      }
+    | null
+    | undefined;
   focusedRef: string | null;
   changedRegions: InteractionRect[];
   diagnostics: InteractionDiagnosticSummary;
@@ -863,6 +885,15 @@ export type BrowserPermissionSetting = "granted" | "denied" | "prompt";
 
 export type BrowserAction =
   | { type: "navigate"; url: string }
+  | { type: "history"; direction: "back" | "forward" }
+  | { type: "activate" }
+  | {
+      type: "viewport";
+      width: number;
+      height: number;
+      mobile: boolean;
+      deviceScaleFactor?: number | undefined;
+    }
   | {
       type: "click";
       locator: BrowserLocator;
@@ -1475,6 +1506,26 @@ export interface InteractionTransport {
     targetId: string,
     options?: OpenGeniRequestOptions,
   ): Promise<BrowserObservation>;
+  getBrowserTargetState(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    options?: OpenGeniRequestOptions,
+  ): Promise<BrowserTargetState>;
+  readBrowserDom(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    request: BrowserDomReadRequest,
+    options?: OpenGeniRequestOptions,
+  ): Promise<BrowserDomReadResponse>;
+  captureBrowserTarget(
+    workspaceId: string,
+    browserSessionId: string,
+    targetId: string,
+    options?: OpenGeniRequestOptions,
+    captureOptions?: BrowserScreenshotOptions,
+  ): Promise<BrowserFrame>;
   actInBrowser(
     workspaceId: string,
     browserSessionId: string,
@@ -2121,6 +2172,49 @@ export class BrowserSessionResource {
     return await this.transport.observeBrowserTarget(this.workspaceId, this.id, targetId, options);
   }
 
+  async targetState(
+    targetId: string,
+    options: OpenGeniRequestOptions = {},
+  ): Promise<BrowserTargetState> {
+    return await this.transport.getBrowserTargetState(this.workspaceId, this.id, targetId, options);
+  }
+
+  async readDom(
+    targetId: string,
+    request: BrowserDomReadRequest,
+    options: OpenGeniRequestOptions = {},
+  ): Promise<BrowserDomReadResponse> {
+    return await this.transport.readBrowserDom(
+      this.workspaceId,
+      this.id,
+      targetId,
+      request,
+      options,
+    );
+  }
+
+  async capture(
+    targetId: string,
+    options: OpenGeniRequestOptions = {},
+    captureOptions: BrowserScreenshotOptions = {},
+  ): Promise<BrowserFrame> {
+    return await this.transport.captureBrowserTarget(
+      this.workspaceId,
+      this.id,
+      targetId,
+      options,
+      captureOptions,
+    );
+  }
+
+  async screenshot(
+    targetId: string,
+    captureOptions: BrowserScreenshotOptions = {},
+    options: OpenGeniRequestOptions = {},
+  ): Promise<BrowserFrame> {
+    return await this.capture(targetId, options, captureOptions);
+  }
+
   async act(
     request: BrowserActionRequest,
     options: OpenGeniRequestOptions = {},
@@ -2505,6 +2599,14 @@ export type BrowserFrameMetadata = {
 
 export type BrowserFrame = BrowserFrameMetadata & { data: Uint8Array };
 
+export type BrowserScreenshotOptions = {
+  /** Capture the document content instead of the visible viewport. */
+  fullPage?: boolean;
+  format?: "jpeg" | "png";
+  /** JPEG quality, from 1 to 100. Ignored for PNG. */
+  quality?: number;
+};
+
 export type ComputerFrameMetadata = {
   frameId: string;
   computerSessionId: string;

package/src/knowledge.ts

@@ -14,6 +14,7 @@ export type {
   KnowledgeOriginalFileDownload,
   KnowledgeEntryKind,
   KnowledgeEntryScope,
+  KnowledgeIndexStatus,
   KnowledgeEntryContent,
   KnowledgeEntrySource,
   KnowledgeEntryEvidence,

package/src/session-message-search.ts

@@ -37,3 +37,11 @@ export type SessionMessageSearchResponse = {
   /** True only on exhaustion. Concurrent mutations require a fresh traversal. */
   countIsExact: boolean;
 };
+
+/** Exact selected event reference from a search match; no payload fields are read. */
+export type SessionMessagePreviewReference = { eventId: string; sequence: number };
+
+/** A complete visible message, or an explicit over-12,000-UTF-16-unit result. */
+export type SessionMessagePreview =
+  | { status: "available"; text: string }
+  | { status: "unavailable" };