@opengeni/sdk 0.11.0 → 0.15.0

package/src/errors.ts

@@ -11,6 +11,19 @@ export class OpenGeniApiError extends Error {
   }
 }
 
+/** The browser bundle and API disagree about their state-changing wire contract. */
+export class OpenGeniApiContractMismatchError extends Error {
+  readonly expected: string;
+  readonly actual: string;
+
+  constructor(expected: string, actual: string) {
+    super(`OpenGeni API contract mismatch: client expects ${expected}, API serves ${actual}`);
+    this.name = "OpenGeniApiContractMismatchError";
+    this.expected = expected;
+    this.actual = actual;
+  }
+}
+
 /** Error for an unrecoverable event-stream condition (not a transient drop). */
 export class OpenGeniStreamError extends Error {
   constructor(message: string) {
@@ -34,7 +47,13 @@ export function isAbortError(error: unknown): boolean {
  */
 export function isRetryableStreamError(error: unknown): boolean {
   if (error instanceof OpenGeniApiError) {
-    return error.status === 408 || error.status === 409 || error.status === 425 || error.status === 429 || error.status >= 500;
+    return (
+      error.status === 408 ||
+      error.status === 409 ||
+      error.status === 425 ||
+      error.status === 429 ||
+      error.status >= 500
+    );
   }
   return error instanceof TypeError;
 }

package/src/index.ts

@@ -1,6 +1,16 @@
 export { OpenGeniClient } from "./client";
-export type { FetchLike, OpenGeniClientOptions, SendMessageInput, SteerMessageResult } from "./client";
-export { OpenGeniApiError, OpenGeniStreamError, isRetryableStreamError } from "./errors";
+export type {
+  FetchLike,
+  OpenGeniClientOptions,
+  SendMessageInput,
+  SteerMessageResult,
+} from "./client";
+export {
+  OpenGeniApiContractMismatchError,
+  OpenGeniApiError,
+  OpenGeniStreamError,
+  isRetryableStreamError,
+} from "./errors";
 export {
   formatSseEvent,
   proxySessionEventStream,
@@ -38,7 +48,15 @@ export type {
   StreamConnectionState,
   StreamSessionEventsOptions,
 } from "./stream";
-export { KNOWN_PERMISSIONS, KNOWN_USAGE_EVENT_TYPES, SESSION_EVENT_TYPES } from "./types";
+export { streamWorkspaceControlEvents } from "./workspace-control-stream";
+export type { WorkspaceControlStreamTransport } from "./workspace-control-stream";
+export {
+  KNOWN_PERMISSIONS,
+  KNOWN_USAGE_EVENT_TYPES,
+  OPENGENI_API_CONTRACT_HEADER,
+  OPENGENI_API_CONTRACT_REVISION,
+  SESSION_EVENT_TYPES,
+} from "./types";
 export type {
   AccessContext,
   AccessGrant,
@@ -63,7 +81,7 @@ export type {
   CapabilityPack,
   CapabilityPackConnector,
   CapabilityPackConnectorAuthModel,
-  CapabilityPackEnvironmentSpec,
+  CapabilityPackVariableSetSpec,
   CapabilityPackKnowledge,
   CapabilityPackScheduledTaskTemplate,
   CapabilityPackSkill,
@@ -106,6 +124,7 @@ export type {
   CreateKnowledgeMemoryRequest,
   CreateScheduledTaskRequest,
   CreateSessionRequest,
+  CreateVariableSetRequest,
   CreateWorkspaceEnvironmentRequest,
   CreateWorkspaceRequest,
   DiscoverMcpCapabilitiesResponse,
@@ -141,6 +160,7 @@ export type {
   KnowledgeMemoryStatus,
   KnowledgeSourceKind,
   KnowledgeSourceRef,
+  GitCredentialProvider,
   ListApiKeysResponse,
   ListConnectionsResponse,
   ListPacksResponse,
@@ -179,6 +199,27 @@ export type {
   ScheduledTaskTriggerType,
   Session,
   SessionCapabilities,
+  SessionListResponse,
+  SessionLineageResponse,
+  SessionQueueMutationResponse,
+  SessionQueueSnapshot,
+  SessionControlResponse,
+  ComposerDraft,
+  DeleteSessionQueueItemRequest,
+  EditSessionQueueItemRequest,
+  EffectiveControlBlocker,
+  EffectiveControlResumeOption,
+  EffectiveSessionControl,
+  MoveSessionQueueItemRequest,
+  SaveComposerDraftRequest,
+  SessionCommandReceipt,
+  SteerSessionQueueItemRequest,
+  WorkspaceInferenceControlResponse,
+  SessionSystemUpdate,
+  SessionSystemUpdateKind,
+  SessionSystemUpdateState,
+  SessionSummary,
+  LineageNode,
   SessionMcpCredentialUpdateInput,
   SessionMcpServerInput,
   SessionMcpServerMetadata,
@@ -253,6 +294,17 @@ export type {
   GitLogResponse,
   GitShowRequest,
   GitShowResponse,
+  SetWorkspaceEnvironmentVariableRequest,
+  WorkspaceCaptureFile,
+  WorkspaceCaptureRepo,
+  WorkspaceCaptureDegradedReason,
+  WorkspaceCaptureStats,
+  WorkspaceCaptureManifest,
+  WorkspaceRevisionCapturedPayload,
+  WorkspaceRevisionDegradedPayload,
+  WorkspaceCaptureSignedUrl,
+  GetWorkspaceCaptureResponse,
+  GetWorkspaceCaptureFileResponse,
   TerminalExecRequest,
   TerminalExecResponse,
   PtyOpenRequest,
@@ -264,21 +316,43 @@ export type {
   UpdateKnowledgeMemoryRequest,
   UpdateScheduledTaskRequest,
   UpdateSessionGoalRequest,
+  UpdateSessionPinRequest,
   UpdateSessionRequest,
-  UpdateSessionTurnRequest,
+  UpdateVariableSetRequest,
   UpdateWorkspaceEnvironmentRequest,
   UpdateWorkspaceMemberRequest,
   UpdateWorkspaceRequest,
+  UpdateWorkspaceSettingsRequest,
   UploadFileInput,
   UsageEvent,
   UsageEventType,
   UserApprovalDecisionEventInput,
-  UserInterruptEventInput,
   UserMessageEventInput,
   Workspace,
+  WorkspaceControlEvent,
+  VariableSet,
+  VariableSetVariableMetadata,
+  Rig,
+  RigVersion,
+  RigCheck,
+  RigChange,
+  RigChangeKind,
+  RigChangeStatus,
+  RigCheckResult,
+  RigChangeVerification,
+  CreateRigRequest,
+  UpdateRigRequest,
+  RigSetupAppendPayload,
+  RigDefinitionEditPayload,
+  ProposeRigChangeRequest,
   WorkspaceEnvironment,
   WorkspaceEnvironmentVariableMetadata,
   WorkspaceMember,
+  WorkspaceMemorySearchMode,
+  WorkspaceMemorySearchRequest,
+  WorkspaceMemorySearchResult,
+  WorkspaceMemorySearchResponse,
+  WorkspaceSettings,
   WorkspaceRegisteredPack,
   // Bring-your-own-compute: Machines dashboard + per-machine metrics (M10).
   MetricSample,

package/src/proxy.ts

@@ -158,7 +158,7 @@ export function proxySessionEventStream(
   } else {
     signal?.addEventListener("abort", () => upstream.abort(), { once: true });
   }
-  const resolvedAfter = after instanceof Request ? resumeSequenceFromRequest(after) : after ?? 0;
+  const resolvedAfter = after instanceof Request ? resumeSequenceFromRequest(after) : (after ?? 0);
   const events = client.streamEvents(workspaceId, sessionId, {
     ...streamOptions,
     after: resolvedAfter,

package/src/sse.ts

@@ -12,7 +12,9 @@ export type SseMessage = {
   data: string;
 };
 
-export async function* parseSseStream(stream: ReadableStream<Uint8Array>): AsyncGenerator<SseMessage, void, void> {
+export async function* parseSseStream(
+  stream: ReadableStream<Uint8Array>,
+): AsyncGenerator<SseMessage, void, void> {
   const reader = stream.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
@@ -21,13 +23,14 @@ export async function* parseSseStream(stream: ReadableStream<Uint8Array>): Async
   let dataLines: string[] | null = null;
 
   const dispatch = (): SseMessage | null => {
-    const message = dataLines === null
-      ? null
-      : {
-        ...(id !== undefined ? { id } : {}),
-        ...(event !== undefined ? { event } : {}),
-        data: dataLines.join("\n"),
-      };
+    const message =
+      dataLines === null
+        ? null
+        : {
+            ...(id !== undefined ? { id } : {}),
+            ...(event !== undefined ? { event } : {}),
+            data: dataLines.join("\n"),
+          };
     id = undefined;
     event = undefined;
     dataLines = null;

package/src/stream.ts

@@ -8,7 +8,10 @@ import type { SessionEvent } from "./types";
  */
 export type SessionEventStreamTransport = {
   /** Open the SSE stream, replaying durable events after `after` first. */
-  openStream: (after: number, signal: AbortSignal | undefined) => Promise<ReadableStream<Uint8Array>>;
+  openStream: (
+    after: number,
+    signal: AbortSignal | undefined,
+  ) => Promise<ReadableStream<Uint8Array>>;
   /** Replay durable events by sequence (`GET .../events?after=&limit=`). */
   listEvents: (after: number, limit: number) => Promise<SessionEvent[]>;
 };
@@ -31,6 +34,8 @@ export type StreamSessionEventsOptions = {
    * reconnects = N+1 total open-stream calls). Defaults to unlimited.
    */
   maxReconnectAttempts?: number;
+  /** Await authoritative client reconciliation before exposing `live`. */
+  beforeLive?: (() => void | Promise<void>) | undefined;
   onStateChange?: (state: StreamConnectionState) => void;
 };
 
@@ -63,7 +68,8 @@ export async function* streamSessionEvents(
   let delayMs = baseDelayMs;
   let everConnected = false;
 
-  while (!signal?.aborted) {
+  while (true) {
+    if (signal?.aborted) break;
     options.onStateChange?.(everConnected || failedAttempts > 0 ? "reconnecting" : "connecting");
     const cursorAtOpen = cursor;
     try {
@@ -71,6 +77,7 @@ export async function* streamSessionEvents(
       everConnected = true;
       failedAttempts = 0;
       delayMs = baseDelayMs;
+      await options.beforeLive?.();
       options.onStateChange?.("live");
       for await (const message of parseSseStream(body)) {
         // Re-check after every yield resumption: an abort from the consumer