@opengeni/sdk 0.36.1 → 0.40.0

package/src/index.ts

@@ -27,6 +27,56 @@ export { parseSseStream } from "./sse";
 export type { SseMessage } from "./sse";
 export { normalizeMcpOutput } from "./mcp-output";
 export type { NormalizedMcpOutput } from "./mcp-output";
+export {
+  CodexRealtimeMicrophoneError,
+  acquireCodexRealtimeMicrophone,
+  codexRealtimeMicrophoneHealthy,
+  startCodexRealtimeWebrtc,
+} from "./codex-realtime";
+export type {
+  AcquireCodexRealtimeMicrophoneOptions,
+  CodexRealtimeAudibleOutputState,
+  CodexRealtimeConnectionHealth,
+  CodexRealtimeMicrophoneErrorCode,
+  CodexRealtimeNegotiator,
+  CodexRealtimeWebrtcSession,
+  StartCodexRealtimeWebrtcOptions,
+} from "./codex-realtime";
+export {
+  CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
+  contextAppendChunks,
+  createCodexRealtimeV3Bridge,
+  encodeCodexRealtimeV3DelegationContextAppend,
+  encodeCodexRealtimeV3SessionContextAppend,
+  parseCodexRealtimeV3Event,
+} from "./codex-realtime-v3";
+export type {
+  CodexRealtimeV3Bridge,
+  CodexRealtimeV3BridgeOptions,
+  CodexRealtimeV3BridgeSnapshot,
+  CodexRealtimeV3ContextAppendChannel,
+  CodexRealtimeV3DelegationContextAppend,
+  CodexRealtimeV3Event,
+  CodexRealtimeV3ParseFailure,
+  CodexRealtimeV3ParseResult,
+  CodexRealtimeV3SessionContextAppend,
+} from "./codex-realtime-v3";
+export { createCodexRealtimeController } from "./codex-realtime-controller";
+export type {
+  CodexRealtimeController,
+  CodexRealtimeControllerClient,
+  CodexRealtimeDiagnostic,
+  CodexRealtimeDiagnosticKind,
+  CodexRealtimeControllerSnapshot,
+  CodexRealtimeControllerStatus,
+  CodexRealtimeMicrophoneState,
+  CodexRealtimeOwnerStorage,
+  CreateCodexRealtimeControllerOptions,
+  RealtimeControllerTransportStarter,
+} from "./codex-realtime-controller";
+export { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport";
+export { projectSessionRealtimeLifecycle } from "./codex-realtime-lifecycle";
+export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle";
 // 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";
@@ -86,6 +136,7 @@ export type {
   WorkspaceInstructionPolicyKind,
   WorkspaceInstructionPolicyListOptions,
   WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyOperationReuseResponse,
   WorkspaceInstructionPolicyProvenanceSource,
   WorkspaceInstructionPolicyRevision,
   WorkspaceInstructionPolicyRevisionIdentity,
@@ -94,7 +145,10 @@ export type {
 } from "./workspace-instruction-policies";
 export type {
   WorkspaceStateDocumentStatusCounts,
+  WorkspaceStateAttemptGovernance,
   WorkspaceStateGapCode,
+  WorkspaceStateGetOptions,
+  WorkspaceStateGovernanceDriftStatus,
   WorkspaceStateMemoryKindCounts,
   WorkspaceStateMemoryStatusCounts,
   WorkspaceStateResponse,
@@ -158,6 +212,7 @@ export type {
   WorkspaceTranscriptionTarget,
 } from "./transcription";
 export {
+  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
   KNOWN_PERMISSIONS,
   KNOWN_USAGE_EVENT_TYPES,
   OPENGENI_API_CONTRACT_HEADER,
@@ -169,10 +224,12 @@ export {
 } from "./types";
 export type {
   AccessContext,
+  ActivateCodexRealtimeConnectionRequest,
   AccessGrant,
   AccountGrant,
   AccountRole,
   AddWorkspaceMemberRequest,
+  BeginSessionRealtimeRequest,
   AgentMessageCompletedPayload,
   AgentTextDeltaPayload,
   AgentToolCallCreatedPayload,
@@ -215,6 +272,14 @@ export type {
   ClientConfig,
   ClientVoiceInputConfig,
   ClientModel,
+  CodexRealtimeVoice,
+  CodexRealtimeWebrtcRequest,
+  CodexRealtimeWebrtcResponse,
+  CodexRealtimeWebrtcVersion,
+  GatewayRealtimeConnectRequest,
+  GatewayRealtimeConnectResponse,
+  GatewayRealtimeInitialItem,
+  EndSessionRealtimeRequest,
   ModelAvailabilityV1,
   ModelBillingAttributionV1,
   ModelCapabilitiesV1,
@@ -224,8 +289,16 @@ export type {
   ModelCredentialSourceV1,
   ModelPricingScheduleV1,
   ModelPricingV1,
+  RenewSessionRealtimeRequest,
+  SessionRealtimeEndReason,
+  SessionRealtimeMode,
+  SessionRealtimeModel,
+  SessionRealtimeMutationResponse,
+  SessionRealtimeState,
   WorkspaceModelCatalogModel,
   WorkspaceModelCatalogResponse,
+  WorkspaceRealtimeModelCatalogItem,
+  WorkspaceRealtimeModelCatalogResponse,
   CodexAccount,
   CodexAccountOverview,
   CodexAccountsResponse,
@@ -261,6 +334,8 @@ export type {
   CreateCapabilityCatalogItemRequest,
   OpenGeniSlackBotInstallRequest,
   OpenGeniSlackBotInstallStart,
+  SlackReactionChannel,
+  SlackReactionChannelListResponse,
   CreateConnectionRequest,
   CreateCheckoutRequest,
   CreateCheckoutResponse,
@@ -278,6 +353,7 @@ export type {
   CreateWorkspaceRequest,
   DiscoverMcpCapabilitiesResponse,
   Document,
+  DocumentAuthorityKind,
   DocumentBase,
   DocumentCuration,
   DocumentCurationStatus,
@@ -313,7 +389,11 @@ export type {
   GitHubRepositoriesResponse,
   GoogleDriveBrowseItem,
   GoogleDriveBrowseResponse,
+  GoogleDriveConnectionLifecycle,
+  GoogleDriveConnectionLifecycleState,
   GoogleDriveConnectionMetadata,
+  GoogleDriveDisconnectRequest,
+  GoogleDriveLifecycleActionRequest,
   GoogleDriveOAuthStartRequest,
   GoogleDriveOAuthStartResponse,
   GoogleDriveReadPolicy,
@@ -535,6 +615,7 @@ export type {
   UpdateWorkspaceMemberRequest,
   UpdateWorkspaceRequest,
   UpdateWorkspaceSettingsRequest,
+  WorkspaceSlackReactionSummonSettings,
   TranscribeAudioResponse,
   UploadFileInput,
   UsageEvent,

package/src/realtime.ts

@@ -0,0 +1,172 @@
+/**
+ * Public, provider-neutral realtime browser SDK.
+ *
+ * Import this subpath lazily in browser applications. The base `@opengeni/sdk`
+ * entry remains free of eager realtime transport initialization.
+ */
+import {
+  createCodexRealtimeController,
+  hasStoredSessionRealtimeOwnerProof,
+  sessionRealtimeOwnerStorageKey,
+  sessionRealtimeOwnerStorageNamespace,
+  type CodexRealtimeController,
+  type CodexRealtimeControllerClient,
+  type CodexRealtimeControllerSnapshot,
+  type CodexRealtimeControllerStatus,
+  type CodexRealtimeDiagnostic,
+  type CodexRealtimeDiagnosticKind,
+  type CodexRealtimeMicrophoneState,
+  type CodexRealtimeOwnerStorage,
+  type CreateCodexRealtimeControllerOptions,
+  type RealtimeControllerTransportStarter,
+} from "./codex-realtime-controller";
+import { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport";
+import type { SessionRealtimeModel, WorkspaceRealtimeModelCatalogResponse } from "./types";
+
+/** Exact backend-facing methods required by the batteries-included realtime SDK. */
+export type SessionRealtimeClientLike = CodexRealtimeControllerClient & {
+  getWorkspaceRealtimeModelCatalog(
+    workspaceId: string,
+  ): Promise<WorkspaceRealtimeModelCatalogResponse>;
+};
+
+export type SessionRealtimeTransportKind = "codex" | "gateway";
+
+/** Provider-neutral names for the existing, battle-tested controller projection. */
+export type SessionRealtimeController = CodexRealtimeController;
+export type SessionRealtimeControllerSnapshot = CodexRealtimeControllerSnapshot;
+export type SessionRealtimeControllerStatus = CodexRealtimeControllerStatus;
+export type SessionRealtimeDiagnostic = CodexRealtimeDiagnostic;
+export type SessionRealtimeDiagnosticKind = CodexRealtimeDiagnosticKind;
+export type SessionRealtimeMicrophoneState = CodexRealtimeMicrophoneState;
+export type SessionRealtimeOwnerStorage = CodexRealtimeOwnerStorage;
+
+export type CreateSessionRealtimeControllerOptions = Omit<
+  CreateCodexRealtimeControllerOptions,
+  "client" | "model" | "ownerStorageNamespace" | "startTransport"
+> & {
+  client: CodexRealtimeControllerClient;
+  model: SessionRealtimeModel;
+};
+
+/** Select the existing transport without exposing provider mechanics to hosts. */
+export function sessionRealtimeTransportKind(
+  model: SessionRealtimeModel,
+): SessionRealtimeTransportKind {
+  return model === "gpt-live-1-boulder-alpha" ? "codex" : "gateway";
+}
+
+/**
+ * Compose the exact current controller with its existing Codex Live or AI
+ * Gateway transport. Wire, ledger, delegation, recovery, and lifecycle
+ * semantics remain owned by the existing implementations below this facade.
+ */
+export function createSessionRealtimeController(
+  options: CreateSessionRealtimeControllerOptions,
+): SessionRealtimeController {
+  const transport = sessionRealtimeTransportKind(options.model);
+  return createCodexRealtimeController({
+    ...options,
+    ownerStorageNamespace: sessionRealtimeOwnerStorageNamespace(options.model),
+    ...(transport === "gateway" ? { startTransport: createGatewayRealtimeTransportStarter() } : {}),
+  });
+}
+
+export {
+  createCodexRealtimeController,
+  createGatewayRealtimeTransportStarter,
+  hasStoredSessionRealtimeOwnerProof,
+  sessionRealtimeOwnerStorageKey,
+  sessionRealtimeOwnerStorageNamespace,
+};
+export type {
+  CodexRealtimeController,
+  CodexRealtimeControllerClient,
+  CodexRealtimeControllerSnapshot,
+  CodexRealtimeControllerStatus,
+  CodexRealtimeDiagnostic,
+  CodexRealtimeDiagnosticKind,
+  CodexRealtimeMicrophoneState,
+  CodexRealtimeOwnerStorage,
+  CreateCodexRealtimeControllerOptions,
+  RealtimeControllerTransportStarter,
+};
+
+export {
+  CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,
+  projectSessionRealtimeLifecycle,
+} from "./codex-realtime-controller";
+export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle";
+
+export {
+  CodexRealtimeMicrophoneError,
+  acquireCodexRealtimeMicrophone,
+  codexRealtimeMicrophoneHealthy,
+  startCodexRealtimeWebrtc,
+} from "./codex-realtime";
+export type {
+  AcquireCodexRealtimeMicrophoneOptions,
+  CodexRealtimeAudibleOutputState,
+  CodexRealtimeConnectionHealth,
+  CodexRealtimeMicrophoneErrorCode,
+  CodexRealtimeNegotiator,
+  CodexRealtimeWebrtcSession,
+  StartCodexRealtimeWebrtcOptions,
+} from "./codex-realtime";
+
+export {
+  CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
+  CODEX_REALTIME_V3_MAX_EVENT_BYTES,
+  CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,
+  CODEX_REALTIME_V3_MAX_TEXT_BYTES,
+  CODEX_REALTIME_V3_PENDING_MAX_BYTES,
+  CODEX_REALTIME_V3_PENDING_MAX_ENTRIES,
+  CODEX_REALTIME_V3_SYNC_MAX_ENTRIES,
+  contextAppendChunks,
+  createCodexRealtimeV3Bridge,
+  encodeCodexRealtimeV3DelegationContextAppend,
+  encodeCodexRealtimeV3SessionContextAppend,
+  parseCodexRealtimeV3Event,
+} from "./codex-realtime-v3";
+export type {
+  CodexRealtimeV3Bridge,
+  CodexRealtimeV3BridgeFatal,
+  CodexRealtimeV3BridgeOptions,
+  CodexRealtimeV3BridgeSnapshot,
+  CodexRealtimeV3ContextAppendChannel,
+  CodexRealtimeV3DelegationContextAppend,
+  CodexRealtimeV3Event,
+  CodexRealtimeV3ParseFailure,
+  CodexRealtimeV3ParseResult,
+  CodexRealtimeV3SessionContextAppend,
+} from "./codex-realtime-v3";
+
+export {
+  CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT,
+  CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS,
+} from "./codex-realtime-v3-wire";
+export type { CodexRealtimeInitialItem } from "./codex-realtime-v3-wire";
+
+export type {
+  ActivateCodexRealtimeConnectionRequest,
+  BeginSessionRealtimeRequest,
+  CodexRealtimeVoice,
+  CodexRealtimeWebrtcRequest,
+  CodexRealtimeWebrtcResponse,
+  CodexRealtimeWebrtcVersion,
+  EndSessionRealtimeRequest,
+  GatewayRealtimeConnectRequest,
+  GatewayRealtimeConnectResponse,
+  GatewayRealtimeInitialItem,
+  RenewSessionRealtimeRequest,
+  SessionRealtimeEndReason,
+  SessionRealtimeLedgerEntry,
+  SessionRealtimeMode,
+  SessionRealtimeModel,
+  SessionRealtimeMutationResponse,
+  SessionRealtimeState,
+  SyncSessionRealtimeLedgerRequest,
+  SyncSessionRealtimeLedgerResponse,
+  WorkspaceRealtimeModelCatalogItem,
+  WorkspaceRealtimeModelCatalogResponse,
+} from "./types";