@opengeni/sdk 0.52.1 → 0.57.0

package/src/index.ts

@@ -96,7 +96,10 @@ 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.
@@ -130,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,
@@ -317,6 +328,8 @@ export type {
   BillingEntitlementsResponse,
   BillingMode,
   BillingSummary,
+  ListManagedOrganizationMembershipsResponse,
+  ManagedOrganizationMembership,
   BillingUsageResponse,
   InsightsRange,
   InsightsBillingPath,
@@ -394,6 +407,14 @@ export type {
   CodexConnectionStatus,
   CodexConnectStart,
   CodexConnectPoll,
+  SuperGrokAccount,
+  SuperGrokAccountsResponse,
+  SuperGrokAccountScope,
+  SuperGrokAllocatorUpdate,
+  SuperGrokConnectionStatus,
+  SuperGrokConnectPoll,
+  SuperGrokConnectStart,
+  SuperGrokRotationSettings,
   CodexFleetConfidence,
   CodexFleetCacheState,
   CodexFleetDecisionEventPayload,
@@ -449,7 +470,10 @@ export type {
   CreateWorkspaceRequest,
   DiscoverMcpCapabilitiesResponse,
   InstallSkillRequest,
+  InstallLibrarySkillRequest,
   InstalledSkill,
+  InstalledSkillSummary,
+  ListInstalledSkillsResponse,
   Document,
   DocumentAuthorityKind,
   DocumentBase,
@@ -792,6 +816,10 @@ export type {
   VariableSet,
   VariableSetSecret,
   VariableSetVariableMetadata,
+  Channel,
+  CreateChannelRequest,
+  UpdateChannelRequest,
+  UpdateSessionChannelRequest,
   Rig,
   RigVersion,
   RigCheck,
@@ -811,30 +839,31 @@ export type {
   PreviewSkillImportRequest,
   ApiIntegrationAuthPreview,
   ApiIntegrationInstallationSummary,
-  ApiIntegrationPresetSummary,
+  IntegrationDefinitionSummary,
   ApiIntegrationPreview,
   ApiIntegrationOAuthStartRequest,
   ApiIntegrationProtocol,
-  ApiIntegrationSource,
+  IntegrationSource,
   ApiIntegrationToolPreview,
   ApiIntegrationUninstallPreview,
-  IntegrationFeatureBindingSummary,
-  IntegrationFeatureDefinitionSummary,
-  IntegrationFeatureKind,
-  IntegrationFeatureMutationResult,
-  IntegrationFeatureRemovalResult,
-  IntegrationFeatureStatus,
-  IntegrationInstanceFeaturesResponse,
+  IntegrationFacetBindingSummary,
+  IntegrationFacetDefinitionSummary,
+  IntegrationFacetKind,
+  IntegrationFacetMutationResult,
+  IntegrationFacetRemovalResult,
+  IntegrationFacetStatus,
+  IntegrationInstanceFacetsResponse,
   InstallApiIntegrationRequest,
   InstalledApiIntegration,
-  ListApiIntegrationPresetsResponse,
+  ListIntegrationDefinitionsResponse,
   ListApiIntegrationsResponse,
   PreviewApiIntegrationRequest,
-  MutateIntegrationFeatureRequest,
-  UpsertIntegrationFeatureRequest,
+  MutateIntegrationFacetRequest,
+  UpsertIntegrationFacetRequest,
   SkillImportFileSummary,
   SkillImportPreview,
   SkillImportSource,
+  SkillInstallationSource,
   SkillUninstallPreview,
   UninstallSkillRequest,
   UninstallSkillResult,

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 });
+  });
+}