@opengeni/sdk 7.1.0 → 7.1.1

package/dist/interaction.d.ts

@@ -1,4 +1,6 @@
 import type { OpenGeniRequestOptions } from "./client.js";
+import type { BrowserDomReadRequest, BrowserDomReadResponse, BrowserTargetState } from "@opengeni/contracts";
+export type { BrowserDomReadRequest, BrowserDomReadResponse, BrowserDomSafeAttribute, BrowserTargetState, } from "@opengeni/contracts";
 import type { RetainedArtifactReference } from "./types.js";
 /** Public Browser/Computer protocol version. Driver and provider details stay private. */
 export declare const INTERACTION_PROTOCOL_VERSION: 1;
@@ -691,6 +693,14 @@ 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;
@@ -747,6 +757,17 @@ 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;
@@ -1163,6 +1184,9 @@ export interface InteractionTransport {
     selectBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
     closeBrowserTarget(workspaceId: string, browserSessionId: string, targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetListResponse>;
     observeBrowserTarget(workspaceId: string, browserSessionId: string, 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, request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
     getBrowserActionReceipt(workspaceId: string, browserSessionId: string, operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
     listBrowserDiagnostics(workspaceId: string, browserSessionId: string, targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
@@ -1372,6 +1396,10 @@ export declare class BrowserSessionResource {
     constructor(transport: BrowserInteractionTransport, workspaceId: string, id: string);
     get(options?: OpenGeniRequestOptions): Promise<BrowserSession>;
     observe(targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserObservation>;
+    targetState(targetId: string, options?: OpenGeniRequestOptions): Promise<BrowserTargetState>;
+    readDom(targetId: string, request: BrowserDomReadRequest, options?: OpenGeniRequestOptions): Promise<BrowserDomReadResponse>;
+    capture(targetId: string, options?: OpenGeniRequestOptions, captureOptions?: BrowserScreenshotOptions): Promise<BrowserFrame>;
+    screenshot(targetId: string, captureOptions?: BrowserScreenshotOptions, options?: OpenGeniRequestOptions): Promise<BrowserFrame>;
     act(request: BrowserActionRequest, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
     receipt(operationId: string, options?: OpenGeniRequestOptions): Promise<BrowserActionReceipt>;
     diagnostics(targetId: string, options?: BrowserDiagnosticsOptions): Promise<BrowserDiagnosticBatch>;
@@ -1478,6 +1506,13 @@ 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/dist/interaction.js

@@ -39,7 +39,7 @@ import {
   interactionControlFailureFromError,
   parseBrowserFrameMetadata,
   parseComputerFrameMetadata
-} from "./chunk-QTBAMHEF.js";
+} from "./chunk-YUOPVPZW.js";
 import "./chunk-OO5LPTO7.js";
 export {
   AttachedBrowserDeviceCollection,

package/dist/knowledge.d.ts

@@ -1,4 +1,4 @@
-export type { AgentLearningMode, AgentLearningCategory, AgentLearningDefaults, AgentLearningOverrides, AgentLearningContext, AgentLearningOverridePatch, AgentLearningSettingsRecord, AgentLearningOverrideRecord, SaveAgentLearningSettingsRequest, KnowledgeFilePreparationResult, KnowledgeSavePreparationRequest, KnowledgeSavePreparationResponse, KnowledgeOriginalFileDownload, KnowledgeEntryKind, KnowledgeEntryScope, KnowledgeEntryContent, KnowledgeEntrySource, KnowledgeEntryEvidence, KnowledgeEntryRelationship, KnowledgeEntryRecord, KnowledgeEntrySummary, KnowledgeEntrySaveRequest, KnowledgeEntryReviewRequest, KnowledgeEntryBatchReviewRequest, KnowledgeEntryRestoreRequest, KnowledgeEntryWriteReceipt, KnowledgeEntryListRequest, KnowledgeEntryListResponse, KnowledgeReviewBatch, KnowledgeReviewBatchListRequest, KnowledgeReviewBatchListResponse, AgentInstructionReviewRequest, AgentInstructionReceipt, AgentInstructionReviewItem, AgentInstructionReviewListResponse, } from "@opengeni/contracts";
+export type { AgentLearningMode, AgentLearningCategory, AgentLearningDefaults, AgentLearningOverrides, AgentLearningContext, AgentLearningOverridePatch, AgentLearningSettingsRecord, AgentLearningOverrideRecord, SaveAgentLearningSettingsRequest, KnowledgeFilePreparationResult, KnowledgeSavePreparationRequest, KnowledgeSavePreparationResponse, KnowledgeOriginalFileDownload, KnowledgeEntryKind, KnowledgeEntryScope, KnowledgeIndexStatus, KnowledgeEntryContent, KnowledgeEntrySource, KnowledgeEntryEvidence, KnowledgeEntryRelationship, KnowledgeEntryRecord, KnowledgeEntrySummary, KnowledgeEntrySaveRequest, KnowledgeEntryReviewRequest, KnowledgeEntryBatchReviewRequest, KnowledgeEntryRestoreRequest, KnowledgeEntryWriteReceipt, KnowledgeEntryListRequest, KnowledgeEntryListResponse, KnowledgeReviewBatch, KnowledgeReviewBatchListRequest, KnowledgeReviewBatchListResponse, AgentInstructionReviewRequest, AgentInstructionReceipt, AgentInstructionReviewItem, AgentInstructionReviewListResponse, } from "@opengeni/contracts";
 import type { OpenGeniClient } from "./client.js";
 import type { KnowledgeSavePreparationRequest, KnowledgeSavePreparationResponse, KnowledgeFilePreparationResult } from "@opengeni/contracts";
 /** Agent-only source preparation is a focused transport surface, outside the browser client. */

package/dist/knowledge.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/knowledge.ts"],"sourcesContent":["export type {\n  AgentLearningMode,\n  AgentLearningCategory,\n  AgentLearningDefaults,\n  AgentLearningOverrides,\n  AgentLearningContext,\n  AgentLearningOverridePatch,\n  AgentLearningSettingsRecord,\n  AgentLearningOverrideRecord,\n  SaveAgentLearningSettingsRequest,\n  KnowledgeFilePreparationResult,\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeOriginalFileDownload,\n  KnowledgeEntryKind,\n  KnowledgeEntryScope,\n  KnowledgeEntryContent,\n  KnowledgeEntrySource,\n  KnowledgeEntryEvidence,\n  KnowledgeEntryRelationship,\n  KnowledgeEntryRecord,\n  KnowledgeEntrySummary,\n  KnowledgeEntrySaveRequest,\n  KnowledgeEntryReviewRequest,\n  KnowledgeEntryBatchReviewRequest,\n  KnowledgeEntryRestoreRequest,\n  KnowledgeEntryWriteReceipt,\n  KnowledgeEntryListRequest,\n  KnowledgeEntryListResponse,\n  KnowledgeReviewBatch,\n  KnowledgeReviewBatchListRequest,\n  KnowledgeReviewBatchListResponse,\n  AgentInstructionReviewRequest,\n  AgentInstructionReceipt,\n  AgentInstructionReviewItem,\n  AgentInstructionReviewListResponse,\n} from \"@opengeni/contracts\";\n\nimport type { OpenGeniClient } from \"./client\";\nimport type {\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeFilePreparationResult,\n} from \"@opengeni/contracts\";\n\n/** Agent-only source preparation is a focused transport surface, outside the browser client. */\nexport async function prepareKnowledgeFile(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  fileId: string,\n  purpose?: \"evidence\" | \"reference\",\n): Promise<KnowledgeFilePreparationResult> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/files/${encodeURIComponent(fileId)}/prepare`,\n    purpose ? { purpose } : undefined,\n  );\n}\n\n/** Read-only collection/duplicate discovery for a live selected agent or human Knowledge reviewer. */\nexport async function prepareKnowledgeSave(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  request: KnowledgeSavePreparationRequest,\n): Promise<KnowledgeSavePreparationResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/entries/prepare-save`,\n    request,\n  );\n}\n"],"mappings":";AA8CA,eAAsB,qBACpB,QACA,aACA,QACA,SACyC;AACzC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC,oBAAoB,mBAAmB,MAAM,CAAC;AAAA,IAC/F,UAAU,EAAE,QAAQ,IAAI;AAAA,EAC1B;AACF;AAGA,eAAsB,qBACpB,QACA,aACA,SAC2C;AAC3C,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACjD;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/knowledge.ts"],"sourcesContent":["export type {\n  AgentLearningMode,\n  AgentLearningCategory,\n  AgentLearningDefaults,\n  AgentLearningOverrides,\n  AgentLearningContext,\n  AgentLearningOverridePatch,\n  AgentLearningSettingsRecord,\n  AgentLearningOverrideRecord,\n  SaveAgentLearningSettingsRequest,\n  KnowledgeFilePreparationResult,\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeOriginalFileDownload,\n  KnowledgeEntryKind,\n  KnowledgeEntryScope,\n  KnowledgeIndexStatus,\n  KnowledgeEntryContent,\n  KnowledgeEntrySource,\n  KnowledgeEntryEvidence,\n  KnowledgeEntryRelationship,\n  KnowledgeEntryRecord,\n  KnowledgeEntrySummary,\n  KnowledgeEntrySaveRequest,\n  KnowledgeEntryReviewRequest,\n  KnowledgeEntryBatchReviewRequest,\n  KnowledgeEntryRestoreRequest,\n  KnowledgeEntryWriteReceipt,\n  KnowledgeEntryListRequest,\n  KnowledgeEntryListResponse,\n  KnowledgeReviewBatch,\n  KnowledgeReviewBatchListRequest,\n  KnowledgeReviewBatchListResponse,\n  AgentInstructionReviewRequest,\n  AgentInstructionReceipt,\n  AgentInstructionReviewItem,\n  AgentInstructionReviewListResponse,\n} from \"@opengeni/contracts\";\n\nimport type { OpenGeniClient } from \"./client\";\nimport type {\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeFilePreparationResult,\n} from \"@opengeni/contracts\";\n\n/** Agent-only source preparation is a focused transport surface, outside the browser client. */\nexport async function prepareKnowledgeFile(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  fileId: string,\n  purpose?: \"evidence\" | \"reference\",\n): Promise<KnowledgeFilePreparationResult> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/files/${encodeURIComponent(fileId)}/prepare`,\n    purpose ? { purpose } : undefined,\n  );\n}\n\n/** Read-only collection/duplicate discovery for a live selected agent or human Knowledge reviewer. */\nexport async function prepareKnowledgeSave(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  request: KnowledgeSavePreparationRequest,\n): Promise<KnowledgeSavePreparationResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/entries/prepare-save`,\n    request,\n  );\n}\n"],"mappings":";AA+CA,eAAsB,qBACpB,QACA,aACA,QACA,SACyC;AACzC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC,oBAAoB,mBAAmB,MAAM,CAAC;AAAA,IAC/F,UAAU,EAAE,QAAQ,IAAI;AAAA,EAC1B;AACF;AAGA,eAAsB,qBACpB,QACA,aACA,SAC2C;AAC3C,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACjD;AAAA,EACF;AACF;","names":[]}

package/dist/session-message-search.d.ts

@@ -39,3 +39,15 @@ 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";
+};