@opengeni/sdk 0.48.0 → 0.57.0

package/src/index.ts

@@ -8,6 +8,20 @@ export type {
   TranscribeAudioInput,
   WorkspaceControlEventPage,
 } from "./client";
+export type {
+  CreateEditableArtifactMaterializationRequest,
+  CreateEditableArtifactResourceRequest,
+  EditableArtifactListResource,
+  EditableArtifactMaterializationFormat,
+  EditableArtifactMaterializationJobResource,
+  EditableArtifactMaterializationResultResource,
+  EditableArtifactPinnedVersionResource,
+  EditableArtifactResource,
+  ListSessionEditableArtifactResourcesOptions,
+  PinEditableArtifactVersionRequest,
+  ReadEditableArtifactMaterializationOptions,
+  ReadEditableArtifactResourceOptions,
+} from "./editable-artifact-resources";
 export {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
@@ -27,6 +41,14 @@ export { parseSseStream } from "./sse";
 export type { SseMessage } from "./sse";
 export { normalizeMcpOutput } from "./mcp-output";
 export type { NormalizedMcpOutput } from "./mcp-output";
+export {
+  generatedImageSandboxPathMatches,
+  parseGeneratedImageReceipt,
+  parseGeneratedVideoReceipt,
+  parseMediaGenerationResult,
+  parseRetainedGeneratedImageReference,
+  parseRetainedGeneratedVideoReference,
+} from "./retained-artifacts";
 export {
   CodexRealtimeMicrophoneError,
   acquireCodexRealtimeMicrophone,
@@ -74,9 +96,14 @@ export type {
   CreateCodexRealtimeControllerOptions,
   RealtimeControllerTransportStarter,
 } from "./codex-realtime-controller";
-export { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport";
+export {
+  createGatewayRealtimeTransportStarter,
+  createXaiSubscriptionRealtimeTransportStarter,
+} from "./gateway-realtime-transport";
 export { projectSessionRealtimeLifecycle } from "./codex-realtime-lifecycle";
 export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle";
+// Provider-neutral Browser/Computer resource client + bounded frame protocol.
+export * from "./interaction";
 // Desktop (noVNC) transport contract — pure, zero-dep (the RFB import lives in
 // @opengeni/react). URL assembler + connection state machine + rotation fence.
 export { desktopSocketUrl, nextDesktopState, applyUrlRotation } from "./desktop";
@@ -106,6 +133,14 @@ export type {
 } from "./stream";
 export { streamWorkspaceControlEvents } from "./workspace-control-stream";
 export type { WorkspaceControlStreamTransport } from "./workspace-control-stream";
+export { streamWorkspaceInteractionRevisions } from "./interaction-revision-stream";
+export type { WorkspaceInteractionRevisionStreamTransport } from "./interaction-revision-stream";
+export { parseWorkspaceLiveEvent, streamWorkspaceLiveEvents } from "./workspace-live-stream";
+export type {
+  WorkspaceLiveEvent,
+  WorkspaceLiveStreamOptions,
+  WorkspaceLiveStreamTransport,
+} from "./workspace-live-stream";
 export type {
   CreateWorkspaceArtifactRequest,
   PublishWorkspaceArtifactVersionRequest,
@@ -123,6 +158,28 @@ export {
   normalizeWorkspaceInstructionPolicyRoleKey,
   WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS,
 } from "./workspace-instruction-policies";
+export {
+  COMPANY_PROFILE_ENTRY_MAX_CHARS,
+  COMPANY_PROFILE_ENTRY_MAX_COUNT,
+  COMPANY_PROFILE_SCALAR_MAX_CHARS,
+  normalizeCompanyProfileStableKey,
+} from "./company-profile";
+export type {
+  ActivateCompanyProfileRevisionRequest,
+  CompanyProfileActivationEvent,
+  CompanyProfileContent,
+  CompanyProfileDiffRequest,
+  CompanyProfileDiffResponse,
+  CompanyProfileEntry,
+  CompanyProfileHead,
+  CompanyProfileListOptions,
+  CompanyProfileListResponse,
+  CompanyProfileMutationResponse,
+  CompanyProfileRevision,
+  CompanyProfileRevisionIdentity,
+  RollbackCompanyProfileRequest,
+  UpdateCompanyProfileRequest,
+} from "./company-profile";
 export type {
   ActivateWorkspaceInstructionPolicyRequest,
   CreateWorkspaceInstructionPolicyDraftRequest,
@@ -168,6 +225,22 @@ export type {
   WorkspaceStateResponse,
   WorkspaceStateSourceKindCounts,
 } from "./workspace-state";
+export type {
+  MemorySlackImportance,
+  MemorySlackPublication,
+  MemorySlackPublicationActionRequest,
+  MemorySlackPublicationConfiguration,
+  MemorySlackPublicationConfigurationResponse,
+  MemorySlackPublicationDistribution,
+  MemorySlackPublicationHistoryResponse,
+  MemorySlackPublicationReceipt,
+  MemorySlackPublicationReceiptKind,
+  MemorySlackPublicationState,
+  MemorySlackRequestedMode,
+  SlackPublicationChannel,
+  SlackPublicationChannelListResponse,
+  UpdateMemorySlackPublicationConfigurationRequest,
+} from "./memory-slack-delivery";
 export { normalizePreferenceRegistryStableKey } from "./preference-registry";
 export type {
   ActivatePreferenceRegistryRevisionRequest,
@@ -232,6 +305,7 @@ export {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION,
   OPENGENI_CORRELATION_HEADER,
+  GENERATED_VIDEO_MAX_BYTES,
   RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,
   RETAINED_OUTPUT_MAX_PAGE_BYTES,
   SESSION_EVENT_TYPES,
@@ -243,6 +317,7 @@ export type {
   AccountGrant,
   AccountRole,
   AddWorkspaceMemberRequest,
+  ApproveSlackUserLinkAccessRequest,
   BeginSessionRealtimeRequest,
   AgentMessageCompletedPayload,
   AgentTextDeltaPayload,
@@ -253,10 +328,14 @@ export type {
   BillingEntitlementsResponse,
   BillingMode,
   BillingSummary,
+  ListManagedOrganizationMembershipsResponse,
+  ManagedOrganizationMembership,
   BillingUsageResponse,
   InsightsRange,
   InsightsBillingPath,
+  InsightsPricingSource,
   InsightsModelUsageRow,
+  InsightsModelCallRow,
   InsightsSeriesPoint,
   InsightsDepthBucket,
   InsightsModelFacet,
@@ -268,19 +347,26 @@ export type {
   WorkspaceInsightsSnapshot,
   WorkspaceInsightsResponse,
   CapabilityCatalogItem,
+  CapabilityAction,
   CapabilityCatalogResponse,
+  CapabilityComponentOwner,
   CapabilityInstallation,
   CapabilityInstallationStatus,
   CapabilityKind,
+  CapabilityLifecycle,
+  CapabilityLifecycleStatus,
   CapabilityPack,
+  CapabilityPackComponentReference,
   CapabilityPackConnector,
   CapabilityPackConnectorAuthModel,
+  CapabilityPackRigRequirement,
   CapabilityPackVariableSetSpec,
   CapabilityPackKnowledge,
   CapabilityPackScheduledTaskTemplate,
   CapabilityPackSkill,
   CapabilityPackSkillFile,
   CapabilityRuntime,
+  CapabilityReadiness,
   CapabilitySource,
   CapabilityUnavailableReason,
   ClientConfig,
@@ -321,6 +407,14 @@ export type {
   CodexConnectionStatus,
   CodexConnectStart,
   CodexConnectPoll,
+  SuperGrokAccount,
+  SuperGrokAccountsResponse,
+  SuperGrokAccountScope,
+  SuperGrokAllocatorUpdate,
+  SuperGrokConnectionStatus,
+  SuperGrokConnectPoll,
+  SuperGrokConnectStart,
+  SuperGrokRotationSettings,
   CodexFleetConfidence,
   CodexFleetCacheState,
   CodexFleetDecisionEventPayload,
@@ -354,6 +448,9 @@ export type {
   CreateCapabilityCatalogItemRequest,
   OpenGeniSlackBotInstallRequest,
   OpenGeniSlackBotInstallStart,
+  SlackInstallationBinding,
+  SlackInstallationBindingState,
+  ListSlackInstallationBindingsResponse,
   SlackReactionChannel,
   SlackReactionChannelListResponse,
   CreateConnectionRequest,
@@ -372,6 +469,11 @@ export type {
   CreateWorkspaceEnvironmentRequest,
   CreateWorkspaceRequest,
   DiscoverMcpCapabilitiesResponse,
+  InstallSkillRequest,
+  InstallLibrarySkillRequest,
+  InstalledSkill,
+  InstalledSkillSummary,
+  ListInstalledSkillsResponse,
   Document,
   DocumentAuthorityKind,
   DocumentBase,
@@ -400,6 +502,17 @@ export type {
   FileStatus,
   FileUploadData,
   FirstPartyMcpToolName,
+  AtlassianBrowseItem,
+  AtlassianBrowseResponse,
+  AtlassianConnectionLifecycle,
+  AtlassianConnectionMetadata,
+  AtlassianDisconnectRequest,
+  AtlassianLifecycleActionRequest,
+  AtlassianOAuthStartResponse,
+  AtlassianReadPolicy,
+  AtlassianSelectedSource,
+  AtlassianSourceKind,
+  AtlassianSyncCadence,
   GetPackResponse,
   GitHubAppInfo,
   GitHubAppSetupMode,
@@ -414,6 +527,9 @@ export type {
   GoogleDriveConnectionMetadata,
   GoogleDriveDisconnectRequest,
   GoogleDriveLifecycleActionRequest,
+  GoogleDriveKnowledgeSourceConfig,
+  GoogleDriveKnowledgeSourceDestination,
+  GoogleDriveKnowledgeSourceItem,
   GoogleDriveOAuthStartRequest,
   GoogleDriveOAuthStartResponse,
   GoogleDriveReadPolicy,
@@ -439,6 +555,7 @@ export type {
   ListApiKeysResponse,
   ListConnectionsResponse,
   ListPacksResponse,
+  ListSlackUserLinkAccessRequestsResponse,
   ListWorkspaceMembersResponse,
   McpServerConnectionRef,
   McpPersonalConnectionDelegation,
@@ -446,18 +563,47 @@ export type {
   OAuthStartRequest,
   OAuthStartResponse,
   PackInstallation,
+  PackInstallationPreview,
   PackInstallationStatus,
+  PackComponentResolution,
+  PackComponentResolutionStatus,
+  PackRigResolution,
+  PackUninstallPreview,
+  PreviewPackInstallationRequest,
+  InstallPackRequest,
+  UninstallPackRequest,
+  UninstallPackResult,
   Permission,
+  PrepareSlackUserLinkAccessRequest,
   ProductAccessMode,
   LatencyMode,
   ReasoningEffort,
+  GeneratedImageReceipt,
+  GeneratedVideoFacts,
+  GeneratedVideoReceipt,
+  MediaGenerationResult,
   RetainedArtifactContent,
   RetainedArtifactContentOptions,
+  RetainedArtifactDownload,
+  RetainedArtifactDownloadOptions,
   RetainedArtifactMetadata,
   RetainedArtifactReference,
   RetainedArtifactUnavailable,
   RetainedOutputKind,
   RetainedOutputUnavailableReason,
+  UpdateVideoGenerationPolicyRequest,
+  VideoArtifactPlaybackSource,
+  VideoGenerationAspectRatio,
+  VideoGenerationCapabilities,
+  VideoGenerationFundingOption,
+  VideoGenerationFundingSource,
+  VideoGenerationModelCapability,
+  VideoGenerationOperationSummary,
+  VideoGenerationPolicy,
+  VideoGenerationPublicStatus,
+  VideoGenerationResolution,
+  VideoGenerationSourceMode,
+  VideoGenerationTerminalFailureStatus,
   RecordingAvailablePayload,
   RecordingCodec,
   RecordingContentType,
@@ -469,6 +615,7 @@ export type {
   RepositoryResourceRef,
   ResourceRef,
   SaveGoogleDriveSourceRequest,
+  SaveGoogleDriveIntegrationSourceRequest,
   SandboxBackend,
   SandboxCapabilityName,
   SandboxOs,
@@ -480,11 +627,17 @@ export type {
   ScheduledTaskRun,
   ScheduledTaskRunMode,
   ScheduledTaskRunStatus,
+  ScheduledTaskAction,
+  KnowledgeSourceSyncLimits,
+  KnowledgeSourceSyncRunSummary,
+  ScopedKnowledgeScope,
   ScheduledTaskScheduleSpec,
   ScheduledTaskStatus,
   ScheduledTaskTriggerType,
   Session,
   SessionCapabilities,
+  AgentTopologyPageResponse,
+  AgentTopologySession,
   SessionListResponse,
   SessionLineageResponse,
   SessionEffectiveToolPolicy,
@@ -556,6 +709,12 @@ export type {
   SessionStatusChangedPayload,
   SessionStructuredCapabilities,
   SessionTurn,
+  DraftTimelineAnnotation,
+  SubmittedTimelineAnnotation,
+  TimelineAnnotation,
+  TimelineAnnotationSource,
+  TimelineAnnotationSourceEventType,
+  TimelineAnnotationSourceKind,
   ServiceTurnInitiator,
   ServiceTurnInitiatorContext,
   TurnInitiatorContext,
@@ -628,6 +787,9 @@ export type {
   PtyResizeRequest,
   PtyCloseRequest,
   ToolRef,
+  SlackUserLinkAccessMutationRequest,
+  SlackUserLinkAccessRequest,
+  SlackUserLinkAccessRequestStatus,
   UpdateKnowledgeMemoryRequest,
   UpdateScheduledTaskRequest,
   UpdateSessionGoalRequest,
@@ -654,6 +816,10 @@ export type {
   VariableSet,
   VariableSetSecret,
   VariableSetVariableMetadata,
+  Channel,
+  CreateChannelRequest,
+  UpdateChannelRequest,
+  UpdateSessionChannelRequest,
   Rig,
   RigVersion,
   RigCheck,
@@ -670,11 +836,59 @@ export type {
   WorkspaceEnvironment,
   WorkspaceEnvironmentVariableMetadata,
   WorkspaceMember,
+  PreviewSkillImportRequest,
+  ApiIntegrationAuthPreview,
+  ApiIntegrationInstallationSummary,
+  IntegrationDefinitionSummary,
+  ApiIntegrationPreview,
+  ApiIntegrationOAuthStartRequest,
+  ApiIntegrationProtocol,
+  IntegrationSource,
+  ApiIntegrationToolPreview,
+  ApiIntegrationUninstallPreview,
+  IntegrationFacetBindingSummary,
+  IntegrationFacetDefinitionSummary,
+  IntegrationFacetKind,
+  IntegrationFacetMutationResult,
+  IntegrationFacetRemovalResult,
+  IntegrationFacetStatus,
+  IntegrationInstanceFacetsResponse,
+  InstallApiIntegrationRequest,
+  InstalledApiIntegration,
+  ListIntegrationDefinitionsResponse,
+  ListApiIntegrationsResponse,
+  PreviewApiIntegrationRequest,
+  MutateIntegrationFacetRequest,
+  UpsertIntegrationFacetRequest,
+  SkillImportFileSummary,
+  SkillImportPreview,
+  SkillImportSource,
+  SkillInstallationSource,
+  SkillUninstallPreview,
+  UninstallSkillRequest,
+  UninstallSkillResult,
+  UninstallApiIntegrationRequest,
+  UninstallApiIntegrationResult,
+  PluginManifest,
+  PluginManifestComponent,
+  PluginComponentBinding,
+  PreviewPluginRequest,
+  PluginComponentPreview,
+  PluginUpdateDiff,
+  PluginPreview,
+  InstallPluginRequest,
+  InstalledPlugin,
+  PluginInstallationSummary,
+  ListInstalledPluginsResponse,
+  PluginUninstallPreview,
+  UninstallPluginRequest,
+  UninstallPluginResult,
   WorkspaceMemorySearchMode,
   WorkspaceMemorySearchRequest,
   WorkspaceMemorySearchResult,
   WorkspaceMemorySearchResponse,
   WorkspaceSettings,
+  WorkspaceVideoGenerationSettings,
   WorkspaceVoiceInputSettings,
   WorkspaceRegisteredPack,
   // Bring-your-own-compute: Machines dashboard + per-machine metrics (M10).

package/src/interaction-revision-stream.ts

@@ -0,0 +1,117 @@
+import { isAbortError, isRetryableStreamError, OpenGeniStreamError } from "./errors";
+import type { WorkspaceInteractionRevisionEvent } from "./interaction";
+import { parseSseStream } from "./sse";
+import {
+  jitteredDelay,
+  runBeforeLive,
+  type StreamSessionEventsOptions,
+  withStreamInactivityTimeout,
+} from "./stream";
+
+export type WorkspaceInteractionRevisionStreamTransport = {
+  openStream: (
+    after: number,
+    signal: AbortSignal | undefined,
+  ) => Promise<ReadableStream<Uint8Array>>;
+};
+
+/**
+ * Reconnecting latest-revision stream. Revisions may skip because intermediate
+ * invalidations carry no independent evidence; every delivered value means
+ * "refetch any interaction resources older than this cursor".
+ */
+export async function* streamWorkspaceInteractionRevisions(
+  transport: WorkspaceInteractionRevisionStreamTransport,
+  options: StreamSessionEventsOptions = {},
+): AsyncGenerator<WorkspaceInteractionRevisionEvent, void, void> {
+  const signal = options.signal;
+  const reconnect = options.reconnect ?? true;
+  const baseDelayMs = options.reconnectDelayMs ?? 500;
+  const maxDelayMs = options.maxReconnectDelayMs ?? 10_000;
+  const jitterRatio = options.reconnectJitterRatio ?? 0.2;
+  const beforeLiveTimeoutMs = options.beforeLiveTimeoutMs ?? 15_000;
+  const heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? 45_000;
+  const maxAttempts = options.maxReconnectAttempts ?? Number.POSITIVE_INFINITY;
+  let cursor = options.after ?? 0;
+  let failures = 0;
+  let delayMs = baseDelayMs;
+  let everConnected = false;
+
+  for (;;) {
+    if (signal?.aborted) return;
+    options.onStateChange?.(everConnected || failures > 0 ? "reconnecting" : "connecting");
+    const cursorAtOpen = cursor;
+    try {
+      const body = await transport.openStream(cursor, signal);
+      everConnected = true;
+      failures = 0;
+      delayMs = baseDelayMs;
+      await runBeforeLive(options.beforeLive, beforeLiveTimeoutMs, signal);
+      options.onStateChange?.("live");
+      for await (const message of parseSseStream(
+        withStreamInactivityTimeout(body, heartbeatTimeoutMs, signal),
+      )) {
+        if (signal?.aborted) return;
+        const event = parseWorkspaceInteractionRevision(message.data);
+        if (!event || event.sequence <= cursor) continue;
+        cursor = event.sequence;
+        yield event;
+      }
+      if (!reconnect) return;
+      if (cursor === cursorAtOpen) await sleep(jitteredDelay(baseDelayMs, jitterRatio), signal);
+      continue;
+    } catch (error) {
+      if (signal?.aborted || isAbortError(error)) return;
+      if (!reconnect || !isRetryableStreamError(error)) throw error;
+      failures += 1;
+      if (failures > maxAttempts) {
+        throw new OpenGeniStreamError(
+          `workspace interaction stream gave up after ${maxAttempts} reconnect attempts: ${
+            error instanceof Error ? error.message : String(error)
+          }`,
+        );
+      }
+    }
+    await sleep(jitteredDelay(delayMs, jitterRatio), signal);
+    delayMs = Math.min(Math.max(delayMs * 2, baseDelayMs), maxDelayMs);
+  }
+}
+
+function parseWorkspaceInteractionRevision(data: string): WorkspaceInteractionRevisionEvent | null {
+  let value: unknown;
+  try {
+    value = JSON.parse(data);
+  } catch {
+    return null;
+  }
+  if (
+    !isRecord(value) ||
+    value.type !== "workspace.interaction.changed" ||
+    typeof value.workspaceId !== "string" ||
+    typeof value.sequence !== "number" ||
+    !Number.isSafeInteger(value.sequence) ||
+    value.sequence < 0 ||
+    value.revision !== value.sequence ||
+    typeof value.occurredAt !== "string"
+  ) {
+    return null;
+  }
+  return value as WorkspaceInteractionRevisionEvent;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+async function sleep(delayMs: number, signal: AbortSignal | undefined): Promise<void> {
+  if (signal?.aborted || delayMs <= 0) return;
+  await new Promise<void>((resolve) => {
+    const timer = setTimeout(done, delayMs);
+    function done() {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve();
+    }
+    signal?.addEventListener("abort", done, { once: true });
+  });
+}