@opengeni/sdk 0.52.1 → 1.0.0

package/dist/index.js

@@ -1,6 +1,26 @@
 import {
-  OpenGeniClient
-} from "./chunk-FHI4DFIG.js";
+  EMPTY_FINAL_REPLY_NOTICE,
+  OpenGeniEmbeddingClient,
+  turnCompletedWithEmptyFinalReply
+} from "./chunk-MOTJYIYL.js";
+import {
+  DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY,
+  authorizeTranscriptionAdapter,
+  createTranscriptionSessionRequest,
+  resolveWorkspaceTranscriptionPolicy,
+  resolveWorkspaceVoiceInputEnabled
+} from "./chunk-VYCTL62C.js";
+import {
+  OPENGENI_TEST_REQUEST_NIL_ID,
+  OPENGENI_WEBHOOK_HEADERS,
+  OPENGENI_WEBHOOK_TEST_EVENT_TYPE,
+  OpenGeniSignatureError,
+  WORKSPACE_WEBHOOK_EVENT_TYPES,
+  signOpenGeniPayload,
+  verifyCredentialProviderRequest,
+  verifyOpenGeniSignature,
+  verifyWebhookEvent
+} from "./chunk-WU6GQG25.js";
 import {
   CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
   CodexRealtimeMicrophoneError,
@@ -14,168 +34,196 @@ import {
   parseCodexRealtimeV3Event,
   projectSessionRealtimeLifecycle,
   startCodexRealtimeWebrtc
-} from "./chunk-KIHGPM7H.js";
+} from "./chunk-2UXZUCEZ.js";
+import "./chunk-AH5D5Q5V.js";
+import "./chunk-HMGADJGZ.js";
 import {
-  DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY,
-  authorizeTranscriptionAdapter,
-  createTranscriptionSessionRequest,
-  resolveWorkspaceTranscriptionPolicy,
-  resolveWorkspaceVoiceInputEnabled
-} from "./chunk-VYCTL62C.js";
+  humanizeModelSlug,
+  isRawModelLabel,
+  modelDisplayName,
+  modelSlug,
+  modelVendor
+} from "./chunk-ZKPY6YAJ.js";
+import {
+  AUTOMATIC_SESSION_TITLE_FALLBACK,
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  sessionListEntry,
+  sessionTitleIsPending
+} from "./chunk-GZYZT22T.js";
+import {
+  SESSION_SCOPE_HEADER,
+  artifactViewerCapability,
+  createSessionProxyHandler,
+  formatSseEvent,
+  isReservedOpenGeniLink,
+  openGeniConsolePath,
+  openGeniLinkScheme,
+  parseOpenGeniLink,
+  parseRetainedFileReference,
+  parseSandboxLink,
+  proxySessionEventStream,
+  resumeSequenceFromRequest,
+  sessionEventsToSseResponse,
+  sessionEventsToSseStream
+} from "./chunk-RWKB6YZG.js";
+import "./chunk-UM4ZXXJR.js";
+import {
+  ToolRequestError,
+  verifyToolRequest
+} from "./chunk-U6CV2SXO.js";
+import {
+  createGatewayRealtimeTransportStarter,
+  createXaiSubscriptionRealtimeTransportStarter
+} from "./chunk-KWADQ227.js";
+import {
+  OPENGENI_SITE_BRIDGE_CANCEL,
+  OPENGENI_SITE_BRIDGE_CONNECT,
+  OPENGENI_SITE_BRIDGE_READY,
+  OPENGENI_SITE_BRIDGE_REQUEST,
+  OPENGENI_SITE_BRIDGE_RESPONSE,
+  OPENGENI_SITE_BRIDGE_VERSION,
+  OpenGeniSiteBridgeError,
+  createOpenGeniSiteClient,
+  createSiteToolBridge,
+  isOpenGeniSiteBridgeCancelMessage,
+  isOpenGeniSiteBridgeConnectMessage,
+  isOpenGeniSiteBridgeRequestMessage,
+  isSiteCatalogStaleError,
+  sanitizeOpenGeniSiteToolCallRequest
+} from "./chunk-DUVIYER4.js";
+import {
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient
+} from "./chunk-4SMEOV3P.js";
 import {
   generatedImageSandboxPathMatches,
+  parseDeprecationNotice,
   parseGeneratedImageReceipt,
   parseGeneratedVideoReceipt,
   parseMediaGenerationResult,
   parseRetainedGeneratedImageReference,
   parseRetainedGeneratedVideoReference,
-  parseSseStream,
-  streamSessionEvents,
-  streamWorkspaceControlEvents
-} from "./chunk-ILQZR5N6.js";
+  parseRetainedWorkspaceFileReference,
+  parseSandboxFileArtifactReceipt,
+  parseWorkspaceLiveEvent,
+  streamWorkspaceControlEvents,
+  streamWorkspaceInteractionRevisions,
+  streamWorkspaceLiveEvents
+} from "./chunk-FG3OO5LM.js";
 import {
-  OpenGeniApiContractMismatchError,
-  OpenGeniApiError,
-  OpenGeniSessionListCursorError,
-  OpenGeniStreamError,
-  isRetryableStreamError
-} from "./chunk-V5F253OG.js";
+  parseSseStream,
+  sessionEventStreamCoveredThrough,
+  streamSessionEvents
+} from "./chunk-APXVSSSY.js";
 import {
-  createGatewayRealtimeTransportStarter
-} from "./chunk-DXDL7EEW.js";
+  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
+  GENERATED_VIDEO_MAX_BYTES,
+  KNOWN_PERMISSIONS,
+  KNOWN_USAGE_EVENT_TYPES,
+  OPENGENI_API_CONTRACT_HEADER,
+  OPENGENI_API_CONTRACT_REVISION,
+  OPENGENI_CORRELATION_HEADER,
+  PERSONAL_RESOURCE_SHARED_OUTPUT_WARNING,
+  PERSONAL_RESOURCE_SHARED_OUTPUT_WARNING_VERSION,
+  RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,
+  RETAINED_OUTPUT_MAX_PAGE_BYTES,
+  SANDBOX_FILE_ARTIFACT_MAX_BYTES,
+  SESSION_EVENT_TYPES
+} from "./chunk-YIKA2QT4.js";
 import {
   AttachedBrowserDeviceCollection,
   AttachedBrowserDeviceResource,
+  AuthRunCollection,
+  AuthRunResource,
   BROWSER_CONTROL_MAX_FRAME_HEADER_BYTES,
   BROWSER_CONTROL_WEBSOCKET_BEARER_PREFIX,
   BROWSER_CONTROL_WEBSOCKET_PROTOCOL,
   BROWSER_FRAME_MAX_BYTES,
   BROWSER_FRAME_MAX_DIMENSION,
   BROWSER_FRAME_MAX_PIXELS,
+  BrowserAuthRunCollection,
+  BrowserClipboardResource,
+  BrowserDownloadCollection,
+  BrowserDownloadResource,
   BrowserIdentityCollection,
   BrowserIdentityResource,
   BrowserSessionCollection,
   BrowserSessionResource,
   BrowserTargetCollection,
   COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
+  ComputerClipboardResource,
   ComputerSessionCollection,
   ComputerSessionResource,
   ComputerTargetCollection,
   INTERACTION_PROTOCOL_VERSION,
+  InteractionInterventionCollection,
+  InteractionInterventionResource,
+  NetworkRouteCollection,
+  NetworkRouteResource,
   OpenGeniInteractionClient,
+  SiteAuthConnectionCollection,
+  SiteAuthConnectionResource,
   browserFrameSocketUrl,
   computerFrameSocketUrl,
   decodeBrowserFrameMessage,
   decodeComputerFrameMessage,
+  decodeComputerFrameMetadataHeader,
+  interactionControlFailureFromError,
   parseBrowserFrameMetadata,
   parseComputerFrameMetadata
-} from "./chunk-MZWTWOX6.js";
+} from "./chunk-NC57YMUO.js";
 import {
-  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
-  GENERATED_VIDEO_MAX_BYTES,
-  KNOWN_PERMISSIONS,
-  KNOWN_USAGE_EVENT_TYPES,
-  OPENGENI_API_CONTRACT_HEADER,
-  OPENGENI_API_CONTRACT_REVISION,
-  OPENGENI_CORRELATION_HEADER,
-  RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,
-  RETAINED_OUTPUT_MAX_PAGE_BYTES,
-  SESSION_EVENT_TYPES
-} from "./chunk-FRJFNDIR.js";
-
-// src/proxy.ts
-function formatSseEvent(event) {
-  return `id: ${event.sequence}
-event: ${event.type}
-data: ${JSON.stringify(event)}
+  OpenGeniAllowanceExhaustedError,
+  OpenGeniApiContractMismatchError,
+  OpenGeniApiError,
+  OpenGeniSecureContextRequiredError,
+  OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
+  OpenGeniStreamError,
+  formatErrorMessage,
+  isRetryableStreamError
+} from "./chunk-V6GIY62B.js";
 
-`;
-}
-function sessionEventsToSseStream(events, options = {}) {
-  const encoder = new TextEncoder();
-  const iterator = events[Symbol.asyncIterator]();
-  let heartbeat;
-  let cancelled = false;
-  const stopHeartbeat = () => {
-    if (heartbeat !== void 0) {
-      clearInterval(heartbeat);
-      heartbeat = void 0;
-    }
-  };
-  return new ReadableStream({
-    start: (controller) => {
-      if (options.heartbeatMs !== void 0) {
-        heartbeat = setInterval(() => {
-          try {
-            controller.enqueue(encoder.encode(": ping\n\n"));
-          } catch {
-            stopHeartbeat();
-          }
-        }, options.heartbeatMs);
-      }
-    },
-    pull: async (controller) => {
-      let result;
-      try {
-        result = await iterator.next();
-      } catch (error) {
-        stopHeartbeat();
-        throw error;
-      }
-      if (cancelled) {
-        return;
-      }
-      if (result.done) {
-        stopHeartbeat();
-        controller.close();
-        return;
-      }
-      controller.enqueue(encoder.encode(formatSseEvent(result.value)));
-    },
-    cancel: () => {
-      cancelled = true;
-      stopHeartbeat();
-      options.onCancel?.();
-      void Promise.resolve(iterator.return?.(void 0)).then(
-        () => void 0,
-        () => void 0
-      );
-    }
-  });
-}
-function sessionEventsToSseResponse(events, options = {}) {
-  return new Response(sessionEventsToSseStream(events, options), {
-    headers: {
-      "Content-Type": "text/event-stream; charset=utf-8",
-      "Cache-Control": "no-cache, no-transform",
-      Connection: "keep-alive"
-    }
-  });
+// ../contracts/src/mcp-endpoint.ts
+function mcpEndpointIdentity(value) {
+  if (!value) return null;
+  try {
+    const url = new URL(value);
+    if (!["https:", "http:"].includes(url.protocol) || url.username || url.password) return null;
+    url.hash = "";
+    return url.href;
+  } catch {
+    return null;
+  }
 }
-function resumeSequenceFromRequest(request) {
-  const url = new URL(request.url);
-  const raw = url.searchParams.get("after") ?? request.headers.get("Last-Event-ID");
-  const parsed = raw === null ? 0 : Number(raw);
-  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : 0;
+function pluginMcpUnavailableReason(server) {
+  if (server.transport === "stdio" || !server.endpoint) return "Requires a local runtime";
+  if (server.transport && !["http", "streamable-http", "streamable_http"].includes(server.transport))
+    return "Unsupported transport: " + server.transport;
+  if (server.requiresConfiguration || server.endpoint.includes("{"))
+    return "Requires custom connection configuration";
+  const endpoint = mcpEndpointIdentity(server.endpoint);
+  if (!endpoint?.startsWith("https://")) return "Requires a valid HTTPS endpoint";
+  return null;
 }
-function proxySessionEventStream(client, workspaceId, sessionId, options = {}) {
-  const { after, heartbeatMs, signal, ...streamOptions } = options;
-  const upstream = new AbortController();
-  if (signal?.aborted) {
-    upstream.abort();
-  } else {
-    signal?.addEventListener("abort", () => upstream.abort(), { once: true });
-  }
-  const resolvedAfter = after instanceof Request ? resumeSequenceFromRequest(after) : after ?? 0;
-  const events = client.streamEvents(workspaceId, sessionId, {
-    ...streamOptions,
-    after: resolvedAfter,
-    signal: upstream.signal
-  });
-  return sessionEventsToSseResponse(events, {
-    ...heartbeatMs !== void 0 ? { heartbeatMs } : {},
-    onCancel: () => upstream.abort()
-  });
+
+// src/tool-display-metadata.ts
+function parseToolDisplayMetadata(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const item = value;
+  if (Object.keys(item).some((key) => !["toolName", "title", "accountLabel"].includes(key)))
+    return void 0;
+  const text = (v, max) => typeof v === "string" && v.length > 0 && v.length <= max;
+  if (!text(item.toolName, 512) || /[\u0000-\u001f\u007f]/u.test(item.toolName)) return void 0;
+  if (item.title !== void 0 && !text(item.title, 512)) return void 0;
+  if (item.accountLabel !== void 0 && !text(item.accountLabel, 1024)) return void 0;
+  return {
+    toolName: item.toolName,
+    ...item.title !== void 0 ? { title: item.title } : {},
+    ...item.accountLabel !== void 0 ? { accountLabel: item.accountLabel } : {}
+  };
 }
 
 // src/mcp-output.ts
@@ -401,19 +449,46 @@ function normalizeCompanyProfileStableKey(value) {
   return value.normalize("NFKC").trim().toLowerCase().replace(/\s+/gu, "-").replace(/-+/g, "-");
 }
 
+// src/company-brain.ts
+function inspectorPath(workspaceId, suffix) {
+  return `/v1/workspaces/${workspaceId}/company-brain/${suffix}`;
+}
+function listCompanyBrainContextReceipts(client, workspaceId, options = {}) {
+  const params = new URLSearchParams();
+  if (options.attemptId) params.set("attemptId", options.attemptId);
+  if (options.cursor) params.set("cursor", options.cursor);
+  if (options.limit !== void 0) params.set("limit", String(options.limit));
+  const query = params.toString();
+  return client.requestJson(
+    "GET",
+    `${inspectorPath(workspaceId, "context-receipts")}${query ? `?${query}` : ""}`
+  );
+}
+function listCompanyBrainKnowledgeProposals(client, workspaceId, options = {}) {
+  const query = options.limit === void 0 ? "" : `?limit=${encodeURIComponent(String(options.limit))}`;
+  return client.requestJson("GET", `${inspectorPath(workspaceId, "knowledge-proposals")}${query}`);
+}
+
 // src/preference-registry.ts
 function normalizePreferenceRegistryStableKey(value) {
   return value.normalize("NFKC").trim().toLowerCase().replace(/\s+/gu, "-").replace(/-+/g, "-");
 }
 export {
+  AUTOMATIC_SESSION_TITLE_FALLBACK,
   AttachedBrowserDeviceCollection,
   AttachedBrowserDeviceResource,
+  AuthRunCollection,
+  AuthRunResource,
   BROWSER_CONTROL_MAX_FRAME_HEADER_BYTES,
   BROWSER_CONTROL_WEBSOCKET_BEARER_PREFIX,
   BROWSER_CONTROL_WEBSOCKET_PROTOCOL,
   BROWSER_FRAME_MAX_BYTES,
   BROWSER_FRAME_MAX_DIMENSION,
   BROWSER_FRAME_MAX_PIXELS,
+  BrowserAuthRunCollection,
+  BrowserClipboardResource,
+  BrowserDownloadCollection,
+  BrowserDownloadResource,
   BrowserIdentityCollection,
   BrowserIdentityResource,
   BrowserSessionCollection,
@@ -425,33 +500,65 @@ export {
   COMPANY_PROFILE_SCALAR_MAX_CHARS,
   COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
   CodexRealtimeMicrophoneError,
+  ComputerClipboardResource,
   ComputerSessionCollection,
   ComputerSessionResource,
   ComputerTargetCollection,
   DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
   DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY,
+  EMPTY_FINAL_REPLY_NOTICE,
   GENERATED_VIDEO_MAX_BYTES,
   INTERACTION_PROTOCOL_VERSION,
+  InteractionInterventionCollection,
+  InteractionInterventionResource,
   KNOWN_PERMISSIONS,
   KNOWN_USAGE_EVENT_TYPES,
+  NetworkRouteCollection,
+  NetworkRouteResource,
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION,
   OPENGENI_CORRELATION_HEADER,
+  OPENGENI_SITE_BRIDGE_CANCEL,
+  OPENGENI_SITE_BRIDGE_CONNECT,
+  OPENGENI_SITE_BRIDGE_READY,
+  OPENGENI_SITE_BRIDGE_REQUEST,
+  OPENGENI_SITE_BRIDGE_RESPONSE,
+  OPENGENI_SITE_BRIDGE_VERSION,
+  OPENGENI_TEST_REQUEST_NIL_ID,
+  OPENGENI_WEBHOOK_HEADERS,
+  OPENGENI_WEBHOOK_TEST_EVENT_TYPE,
+  OpenGeniAllowanceExhaustedError,
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
-  OpenGeniClient,
+  OpenGeniEmbeddingClient as OpenGeniClient,
   OpenGeniInteractionClient,
+  OpenGeniSecureContextRequiredError,
   OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
+  OpenGeniSignatureError,
+  OpenGeniSiteBridgeError,
   OpenGeniStreamError,
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient,
+  PERSONAL_RESOURCE_SHARED_OUTPUT_WARNING,
+  PERSONAL_RESOURCE_SHARED_OUTPUT_WARNING_VERSION,
   RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,
   RETAINED_OUTPUT_MAX_PAGE_BYTES,
+  SANDBOX_FILE_ARTIFACT_MAX_BYTES,
   SESSION_EVENT_TYPES,
+  SESSION_SCOPE_HEADER,
+  SiteAuthConnectionCollection,
+  SiteAuthConnectionResource,
   TTYD_SUBPROTOCOL,
+  ToolRequestError,
   TtydClientCommand,
   TtydServerCommand,
   WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS,
+  WORKSPACE_WEBHOOK_EVENT_TYPES,
   acquireCodexRealtimeMicrophone,
   applyUrlRotation,
+  artifactViewerCapability,
   authorizeTranscriptionAdapter,
   browserFrameSocketUrl,
   codexRealtimeMicrophoneHealthy,
@@ -460,42 +567,86 @@ export {
   createCodexRealtimeController,
   createCodexRealtimeV3Bridge,
   createGatewayRealtimeTransportStarter,
+  createOpenGeniSiteClient,
+  createSessionProxyHandler,
+  createSiteToolBridge,
   createTranscriptionSessionRequest,
+  createXaiSubscriptionRealtimeTransportStarter,
   decodeBrowserFrameMessage,
   decodeComputerFrameMessage,
+  decodeComputerFrameMetadataHeader,
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
   desktopSocketUrl,
   encodeCodexRealtimeV3DelegationContextAppend,
   encodeCodexRealtimeV3SessionContextAppend,
+  formatErrorMessage,
   formatSseEvent,
   generatedImageSandboxPathMatches,
+  humanizeModelSlug,
+  interactionControlFailureFromError,
+  isOpenGeniSiteBridgeCancelMessage,
+  isOpenGeniSiteBridgeConnectMessage,
+  isOpenGeniSiteBridgeRequestMessage,
+  isRawModelLabel,
+  isReservedOpenGeniLink,
   isRetryableStreamError,
+  isSiteCatalogStaleError,
+  listCompanyBrainContextReceipts,
+  listCompanyBrainKnowledgeProposals,
+  modelDisplayName,
+  modelSlug,
+  modelVendor,
   nextDesktopState,
   normalizeCompanyProfileStableKey,
   normalizeMcpOutput,
   normalizePreferenceRegistryStableKey,
   normalizeWorkspaceInstructionPolicyRoleKey,
+  openGeniConsolePath,
+  openGeniLinkScheme,
   parseBrowserFrameMetadata,
   parseCodexRealtimeV3Event,
   parseComputerFrameMetadata,
+  parseDeprecationNotice,
   parseGeneratedImageReceipt,
   parseGeneratedVideoReceipt,
   parseMediaGenerationResult,
+  parseOpenGeniLink,
+  parseRetainedFileReference,
   parseRetainedGeneratedImageReference,
   parseRetainedGeneratedVideoReference,
+  parseRetainedWorkspaceFileReference,
+  parseSandboxFileArtifactReceipt,
+  parseSandboxLink,
   parseSseStream,
+  parseToolDisplayMetadata,
+  parseWorkspaceLiveEvent,
+  pluginMcpUnavailableReason,
   projectSessionRealtimeLifecycle,
   proxySessionEventStream,
   resolveWorkspaceTranscriptionPolicy,
   resolveWorkspaceVoiceInputEnabled,
   resumeSequenceFromRequest,
+  sanitizeOpenGeniSiteToolCallRequest,
+  sessionEventStreamCoveredThrough,
   sessionEventsToSseResponse,
   sessionEventsToSseStream,
+  sessionListEntry,
+  sessionTitleIsPending,
+  signOpenGeniPayload,
   startCodexRealtimeWebrtc,
   streamSessionEvents,
   streamWorkspaceControlEvents,
+  streamWorkspaceInteractionRevisions,
+  streamWorkspaceLiveEvents,
   terminalSocketUrl,
   ttydAuthFrame,
   ttydInputFrame,
-  ttydResizeFrame
+  ttydResizeFrame,
+  turnCompletedWithEmptyFinalReply,
+  verifyCredentialProviderRequest,
+  verifyOpenGeniSignature,
+  verifyToolRequest,
+  verifyWebhookEvent
 };
 //# sourceMappingURL=index.js.map