@opengeni/sdk 0.11.0 → 0.15.0

package/src/client.ts

@@ -1,5 +1,13 @@
-import { OpenGeniApiError } from "./errors";
-import { streamSessionEvents, type SessionEventStreamTransport, type StreamSessionEventsOptions } from "./stream";
+import { OpenGeniApiContractMismatchError, OpenGeniApiError } from "./errors";
+import {
+  streamSessionEvents,
+  type SessionEventStreamTransport,
+  type StreamSessionEventsOptions,
+} from "./stream";
+import {
+  streamWorkspaceControlEvents,
+  type WorkspaceControlStreamTransport,
+} from "./workspace-control-stream";
 import type {
   AccessContext,
   AddWorkspaceMemberRequest,
@@ -23,11 +31,13 @@ import type {
   ClientSessionEventInput,
   CompactSessionContextResult,
   CompleteFileUploadResponse,
+  ConnectionMetadata,
   CreateApiKeyRequest,
   CreateApiKeyResponse,
   CreateCapabilityCatalogItemRequest,
   CreateCheckoutRequest,
   CreateCheckoutResponse,
+  CreateConnectionRequest,
   CreateDocumentBaseRequest,
   CreateFileUploadRequest,
   CreateFileUploadResponse,
@@ -36,7 +46,8 @@ import type {
   CreateKnowledgeMemoryRequest,
   CreateScheduledTaskRequest,
   CreateSessionRequest,
-  CreateWorkspaceEnvironmentRequest,
+  CreateVariableSetRequest,
+  CreateRigRequest,
   CreateWorkspaceRequest,
   // Enrollment UX (design 11): the click-Grant approve-page lookup/deny + headless
   // enroll-token mint.
@@ -62,7 +73,6 @@ import type {
   ListPacksResponse,
   // Bring-your-own-compute: the Machines dashboard + per-machine metrics (M10).
   MachinesResponse,
-  MachineView,
   MetricSample,
   MachineMetricsSeriesResponse,
   // Bring-your-own-compute: the user-authenticated active-sandbox swap (M7).
@@ -76,8 +86,23 @@ import type {
   ScheduledTask,
   ScheduledTaskRun,
   Session,
+  SessionListResponse,
+  UpdateSessionPinRequest,
   SessionEvent,
   SessionGoal,
+  SessionLineageResponse,
+  SessionMcpCredentialUpdateInput,
+  SessionQueueSnapshot,
+  SessionQueueMutationResponse,
+  ComposerDraft,
+  DeleteSessionQueueItemRequest,
+  EditSessionQueueItemRequest,
+  MoveSessionQueueItemRequest,
+  SaveComposerDraftRequest,
+  SteerSessionQueueItemRequest,
+  SessionControlResponse,
+  WorkspaceInferenceControlResponse,
+  WorkspaceControlEvent,
   SessionTurn,
   // Stream surfacing (Phase 5): capability negotiation + viewer lifecycle + config.
   SessionCapabilities,
@@ -108,6 +133,9 @@ import type {
   GitLogResponse,
   GitShowRequest,
   GitShowResponse,
+  // Workbench v2 turn-end capture reads (M2, dossier §10.3).
+  GetWorkspaceCaptureResponse,
+  GetWorkspaceCaptureFileResponse,
   TerminalExecRequest,
   TerminalExecResponse,
   PtyOpenRequest,
@@ -116,21 +144,35 @@ import type {
   PtyResizeRequest,
   PtyCloseRequest,
   ToolRef,
+  UpdateConnectionRequest,
   UpdateKnowledgeMemoryRequest,
   UpdateScheduledTaskRequest,
   UpdateSessionGoalRequest,
   UpdateSessionRequest,
-  UpdateSessionTurnRequest,
-  UpdateWorkspaceEnvironmentRequest,
+  UpdateVariableSetRequest,
+  UpdateRigRequest,
   UpdateWorkspaceMemberRequest,
   UpdateWorkspaceRequest,
+  UpdateWorkspaceSettingsRequest,
+  SetWorkspaceDefaultRigRequest,
   UploadFileInput,
-  WorkspaceEnvironment,
-  WorkspaceEnvironmentVariableMetadata,
+  VariableSet,
+  VariableSetVariableMetadata,
+  Rig,
+  RigVersion,
+  RigChange,
+  ProposeRigChangeRequest,
   WorkspaceMember,
+  WorkspaceMemorySearchRequest,
+  WorkspaceMemorySearchResponse,
   WorkspaceRegisteredPack,
   Workspace,
+  ListConnectionsResponse,
+  ConnectionResponse,
+  OAuthStartRequest,
+  OAuthStartResponse,
 } from "./types";
+import { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types";
 
 export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 
@@ -152,19 +194,16 @@ export type SendMessageInput = {
   model?: string;
   reasoningEffort?: ReasoningEffort;
   clientEventId?: string;
+  controlEtag?: string;
+  expectedDraftRevision?: number;
+  mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[];
 };
 
 export type SteerMessageResult = {
   /** The accepted `user.message` event. */
   accepted: SessionEvent;
-  /**
-   * The turn created for the message, when it could be located — usually
-   * still queued, but already claimed (running/requires_action or even
-   * finished) when the worker picked it up mid-call.
-   */
-  turn: SessionTurn | null;
-  /** True when the running turn was interrupted to make way for the message. */
-  interrupted: boolean;
+  /** The exact turn created for this message in the same server transaction. */
+  turn: SessionTurn;
 };
 
 /**
@@ -180,34 +219,128 @@ export class OpenGeniClient {
   constructor(options: OpenGeniClientOptions) {
     this.baseUrl = options.baseUrl.replace(/\/+$/, "");
     this.options = options;
-    // Bind lazily so environments that polyfill fetch after module load work.
+    // Bind lazily so variable sets that polyfill fetch after module load work.
     this.fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
   }
 
   // --- Session lifecycle ---------------------------------------------------
 
   async createSession(workspaceId: string, request: CreateSessionRequest): Promise<Session> {
-    return await this.requestJson<Session>("POST", `/v1/workspaces/${workspaceId}/sessions`, request);
+    return await this.requestJson<Session>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions`,
+      request,
+    );
   }
 
   async getSession(workspaceId: string, sessionId: string): Promise<Session> {
-    return await this.requestJson<Session>("GET", `/v1/workspaces/${workspaceId}/sessions/${sessionId}`);
+    return await this.requestJson<Session>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}`,
+    );
   }
 
-  async updateSession(workspaceId: string, sessionId: string, request: UpdateSessionRequest): Promise<Session> {
-    return await this.requestJson<Session>("PATCH", `/v1/workspaces/${workspaceId}/sessions/${sessionId}`, request);
+  async updateSession(
+    workspaceId: string,
+    sessionId: string,
+    request: UpdateSessionRequest,
+  ): Promise<Session> {
+    return await this.requestJson<Session>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}`,
+      request,
+    );
   }
 
-  async listSessions(workspaceId: string, options: { limit?: number } = {}): Promise<Session[]> {
-    return await this.requestJson<Session[]>("GET", `/v1/workspaces/${workspaceId}/sessions`, undefined, {
-      ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
-    });
+  async listSessions(
+    workspaceId: string,
+    options: {
+      limit?: number;
+      parentSessionId?: string | null;
+      search?: string;
+    } = {},
+  ): Promise<Session[]> {
+    return await this.requestJson<Session[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions`,
+      undefined,
+      {
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+        ...(options.search?.trim() ? { search: options.search.trim() } : {}),
+        ...(Object.prototype.hasOwnProperty.call(options, "parentSessionId") &&
+        options.parentSessionId !== undefined
+          ? {
+              parentSessionId:
+                options.parentSessionId === null ? "null" : String(options.parentSessionId),
+            }
+          : {}),
+      },
+    );
   }
 
-  async listTurns(workspaceId: string, sessionId: string, options: { limit?: number } = {}): Promise<SessionTurn[]> {
-    return await this.requestJson<SessionTurn[]>("GET", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns`, undefined, {
-      ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
-    });
+  /** Pin-aware ordinary-session page with a stable keyset cursor. */
+  async listSessionPage(
+    workspaceId: string,
+    options: {
+      limit?: number;
+      parentSessionId?: string | null;
+      cursor?: string;
+      search?: string;
+    } = {},
+  ): Promise<SessionListResponse> {
+    return await this.requestJson<SessionListResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions`,
+      undefined,
+      {
+        view: "page",
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+        ...(options.cursor !== undefined ? { cursor: options.cursor } : {}),
+        ...(options.search?.trim() ? { search: options.search.trim() } : {}),
+        ...(Object.prototype.hasOwnProperty.call(options, "parentSessionId") &&
+        options.parentSessionId !== undefined
+          ? {
+              parentSessionId:
+                options.parentSessionId === null ? "null" : String(options.parentSessionId),
+            }
+          : {}),
+      },
+    );
+  }
+
+  /** Set this authenticated member's personal workspace pin for a session. */
+  async updateSessionPin(
+    workspaceId: string,
+    sessionId: string,
+    request: UpdateSessionPinRequest,
+  ): Promise<Session> {
+    return await this.requestJson<Session>(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/pin`,
+      request,
+    );
+  }
+
+  async getSessionLineage(workspaceId: string, sessionId: string): Promise<SessionLineageResponse> {
+    return await this.requestJson<SessionLineageResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/lineage`,
+    );
+  }
+
+  async listTurns(
+    workspaceId: string,
+    sessionId: string,
+    options: { limit?: number } = {},
+  ): Promise<SessionTurn[]> {
+    return await this.requestJson<SessionTurn[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns`,
+      undefined,
+      {
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+      },
+    );
   }
 
   // --- Bring-your-own-compute: Machines dashboard + metrics (M10) ------------
@@ -218,10 +351,18 @@ export class OpenGeniClient {
    * sharedSessionCount. Pass `sessionId` for an in-session view, which adds the
    * session's synthetic Modal group box + the active-sandbox pointer.
    */
-  async listMachines(workspaceId: string, options: { sessionId?: string } = {}): Promise<MachinesResponse> {
-    return await this.requestJson<MachinesResponse>("GET", `/v1/workspaces/${workspaceId}/machines`, undefined, {
-      ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
-    });
+  async listMachines(
+    workspaceId: string,
+    options: { sessionId?: string } = {},
+  ): Promise<MachinesResponse> {
+    return await this.requestJson<MachinesResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/machines`,
+      undefined,
+      {
+        ...(options.sessionId !== undefined ? { sessionId: options.sessionId } : {}),
+      },
+    );
   }
 
   /**
@@ -254,7 +395,11 @@ export class OpenGeniClient {
    * the request.
    */
   async lookupDeviceEnrollment(userCode: string): Promise<DeviceEnrollmentLookupResponse> {
-    return await this.requestJson<DeviceEnrollmentLookupResponse>("POST", "/v1/enrollments/device/lookup", { userCode });
+    return await this.requestJson<DeviceEnrollmentLookupResponse>(
+      "POST",
+      "/v1/enrollments/device/lookup",
+      { userCode },
+    );
   }
 
   /**
@@ -324,14 +469,25 @@ export class OpenGeniClient {
 
   // --- Scheduled tasks -------------------------------------------------------
 
-  async listScheduledTasks(workspaceId: string, options: { limit?: number } = {}): Promise<ScheduledTask[]> {
-    return await this.requestJson<ScheduledTask[]>("GET", `/v1/workspaces/${workspaceId}/scheduled-tasks`, undefined, {
-      ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
-    });
+  async listScheduledTasks(
+    workspaceId: string,
+    options: { limit?: number } = {},
+  ): Promise<ScheduledTask[]> {
+    return await this.requestJson<ScheduledTask[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks`,
+      undefined,
+      {
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+      },
+    );
   }
 
   async getScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>("GET", `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`);
+    return await this.requestJson<ScheduledTask>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`,
+    );
   }
 
   // --- Events: replay, send, stream ----------------------------------------
@@ -347,20 +503,37 @@ export class OpenGeniClient {
     sessionId: string,
     options: { after?: number; before?: number; limit?: number; compact?: boolean } = {},
   ): Promise<SessionEvent[]> {
-    return await this.requestJson<SessionEvent[]>("GET", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/events`, undefined, {
-      ...(options.after !== undefined ? { after: String(options.after) } : {}),
-      ...(options.before !== undefined ? { before: String(options.before) } : {}),
-      ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
-      ...(options.compact ? { compact: "1" } : {}),
-    });
+    return await this.requestJson<SessionEvent[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/events`,
+      undefined,
+      {
+        ...(options.after !== undefined ? { after: String(options.after) } : {}),
+        ...(options.before !== undefined ? { before: String(options.before) } : {}),
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+        ...(options.compact ? { compact: "1" } : {}),
+      },
+    );
   }
 
   /** POST a user/control event to the session. Returns the accepted event. */
-  async sendEvent(workspaceId: string, sessionId: string, event: ClientSessionEventInput): Promise<SessionEvent> {
-    return await this.requestJson<SessionEvent>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/events`, event);
+  async sendEvent(
+    workspaceId: string,
+    sessionId: string,
+    event: ClientSessionEventInput,
+  ): Promise<SessionEvent> {
+    return await this.requestJson<SessionEvent>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/events`,
+      event,
+    );
   }
 
-  async sendMessage(workspaceId: string, sessionId: string, message: string | SendMessageInput): Promise<SessionEvent> {
+  async sendMessage(
+    workspaceId: string,
+    sessionId: string,
+    message: string | SendMessageInput,
+  ): Promise<SessionEvent> {
     const input = typeof message === "string" ? { text: message } : message;
     const { clientEventId, ...payload } = input;
     return await this.sendEvent(workspaceId, sessionId, {
@@ -370,22 +543,28 @@ export class OpenGeniClient {
     });
   }
 
-  async interrupt(
+  async pauseSession(
     workspaceId: string,
     sessionId: string,
-    options: { reason?: string; clientEventId?: string } = {},
-  ): Promise<SessionEvent> {
-    return await this.sendEvent(workspaceId, sessionId, {
-      type: "user.interrupt",
-      ...(options.clientEventId !== undefined ? { clientEventId: options.clientEventId } : {}),
-      payload: options.reason !== undefined ? { reason: options.reason } : {},
+    options: { reason?: string; clientEventId?: string; expectedControlEtag?: string } = {},
+  ): Promise<SessionControlResponse> {
+    return await this.controlSession(workspaceId, sessionId, {
+      action: "pause",
+      clientEventId: options.clientEventId ?? crypto.randomUUID(),
+      ...(options.reason ? { reason: options.reason } : {}),
+      ...(options.expectedControlEtag ? { expectedControlEtag: options.expectedControlEtag } : {}),
     });
   }
 
   async sendApprovalDecision(
     workspaceId: string,
     sessionId: string,
-    decision: { approvalId: string; decision: "approve" | "reject"; message?: string; clientEventId?: string },
+    decision: {
+      approvalId: string;
+      decision: "approve" | "reject";
+      message?: string;
+      clientEventId?: string;
+    },
   ): Promise<SessionEvent> {
     const { clientEventId, ...payload } = decision;
     return await this.sendEvent(workspaceId, sessionId, {
@@ -411,8 +590,13 @@ export class OpenGeniClient {
   /** The transport `streamEvents` runs on; useful for custom streaming layers. */
   eventStreamTransport(workspaceId: string, sessionId: string): SessionEventStreamTransport {
     return {
-      openStream: async (after, signal) => await this.openEventStream(workspaceId, sessionId, { after, ...(signal ? { signal } : {}) }),
-      listEvents: async (after, limit) => await this.listEvents(workspaceId, sessionId, { after, limit }),
+      openStream: async (after, signal) =>
+        await this.openEventStream(workspaceId, sessionId, {
+          after,
+          ...(signal ? { signal } : {}),
+        }),
+      listEvents: async (after, limit) =>
+        await this.listEvents(workspaceId, sessionId, { after, limit }),
     };
   }
 
@@ -430,6 +614,7 @@ export class OpenGeniClient {
       headers: { ...this.headers(), Accept: "text/event-stream" },
       ...(options.signal ? { signal: options.signal } : {}),
     });
+    assertApiContractResponse(response);
     if (!response.ok) {
       throw new OpenGeniApiError(response.status, await safeText(response));
     }
@@ -441,122 +626,233 @@ export class OpenGeniClient {
 
   // --- Turn queue ------------------------------------------------------------
 
-  /** Edit a still-queued turn (prompt, model, resources, tools, ...). */
-  async updateQueuedTurn(
+  async getQueue(workspaceId: string, sessionId: string): Promise<SessionQueueSnapshot> {
+    return await this.requestJson<SessionQueueSnapshot>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/queue`,
+    );
+  }
+
+  async moveQueueItem(
     workspaceId: string,
     sessionId: string,
     turnId: string,
-    update: UpdateSessionTurnRequest,
-  ): Promise<SessionTurn> {
-    return await this.requestJson<SessionTurn>(
-      "PATCH",
-      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns/${turnId}`,
-      update,
+    request: MoveSessionQueueItemRequest,
+  ): Promise<SessionQueueMutationResponse> {
+    return await this.requestJson<SessionQueueMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/queue/${turnId}/move`,
+      request,
     );
   }
 
-  /**
-   * Reorder the queued turns. `turnIds` must all reference queued turns; the
-   * server assigns positions in the given order and returns the queue.
-   */
-  async reorderQueuedTurns(workspaceId: string, sessionId: string, turnIds: string[]): Promise<SessionTurn[]> {
-    return await this.requestJson<SessionTurn[]>(
+  async editQueueItem(
+    workspaceId: string,
+    sessionId: string,
+    turnId: string,
+    request: EditSessionQueueItemRequest,
+  ): Promise<SessionQueueMutationResponse> {
+    return await this.requestJson<SessionQueueMutationResponse>(
       "POST",
-      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns/reorder`,
-      { turnIds },
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/queue/${turnId}/edit`,
+      request,
     );
   }
 
-  /** Cancel a queued turn before it is claimed. Returns the cancelled turn. */
-  async deleteQueuedTurn(workspaceId: string, sessionId: string, turnId: string): Promise<SessionTurn> {
-    return await this.requestJson<SessionTurn>(
-      "DELETE",
-      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/turns/${turnId}`,
+  async steerQueueItem(
+    workspaceId: string,
+    sessionId: string,
+    turnId: string,
+    request: SteerSessionQueueItemRequest,
+  ): Promise<SessionQueueMutationResponse> {
+    return await this.requestJson<SessionQueueMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/queue/${turnId}/steer`,
+      request,
+    );
+  }
+
+  async deleteQueueItem(
+    workspaceId: string,
+    sessionId: string,
+    turnId: string,
+    request: DeleteSessionQueueItemRequest,
+  ): Promise<SessionQueueMutationResponse> {
+    return await this.requestJson<SessionQueueMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/queue/${turnId}/delete`,
+      request,
+    );
+  }
+
+  async getComposerDraft(workspaceId: string, sessionId: string): Promise<ComposerDraft> {
+    return await this.requestJson<ComposerDraft>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/composer-draft`,
+    );
+  }
+
+  async saveComposerDraft(
+    workspaceId: string,
+    sessionId: string,
+    request: SaveComposerDraftRequest,
+  ): Promise<ComposerDraft> {
+    return await this.requestJson<ComposerDraft>(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/composer-draft`,
+      request,
+    );
+  }
+
+  async controlSession(
+    workspaceId: string,
+    sessionId: string,
+    request: {
+      action: "pause" | "resume";
+      reason?: string;
+      clientEventId: string;
+      expectedControlEtag?: string;
+    },
+  ): Promise<SessionControlResponse> {
+    return await this.requestJson<SessionControlResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/control`,
+      request,
+    );
+  }
+
+  async resumeSession(
+    workspaceId: string,
+    sessionId: string,
+    options: { reason?: string; clientEventId?: string; expectedControlEtag?: string } = {},
+  ): Promise<SessionControlResponse> {
+    return await this.controlSession(workspaceId, sessionId, {
+      action: "resume",
+      clientEventId: options.clientEventId ?? crypto.randomUUID(),
+      ...(options.reason ? { reason: options.reason } : {}),
+      ...(options.expectedControlEtag ? { expectedControlEtag: options.expectedControlEtag } : {}),
+    });
+  }
+
+  async setWorkspaceInferenceState(
+    workspaceId: string,
+    request: {
+      action: "pause" | "resume";
+      reason?: string;
+      clientEventId: string;
+      expectedRevision?: number;
+    },
+  ): Promise<WorkspaceInferenceControlResponse> {
+    return await this.requestJson<WorkspaceInferenceControlResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/inference-control`,
+      request,
     );
   }
 
+  async listWorkspaceControlEvents(
+    workspaceId: string,
+    options: { after?: number; limit?: number } = {},
+  ): Promise<WorkspaceControlEvent[]> {
+    return await this.requestJson<WorkspaceControlEvent[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/control-events`,
+      undefined,
+      {
+        ...(options.after !== undefined ? { after: String(options.after) } : {}),
+        ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),
+      },
+    );
+  }
+
+  streamWorkspaceControlEvents(
+    workspaceId: string,
+    options: StreamSessionEventsOptions = {},
+  ): AsyncGenerator<WorkspaceControlEvent, void, void> {
+    return streamWorkspaceControlEvents(this.workspaceControlStreamTransport(workspaceId), options);
+  }
+
+  workspaceControlStreamTransport(workspaceId: string): WorkspaceControlStreamTransport {
+    return {
+      openStream: async (after, signal) =>
+        await this.openWorkspaceControlEventStream(workspaceId, {
+          after,
+          ...(signal ? { signal } : {}),
+        }),
+    };
+  }
+
+  async openWorkspaceControlEventStream(
+    workspaceId: string,
+    options: { after?: number; signal?: AbortSignal } = {},
+  ): Promise<ReadableStream<Uint8Array>> {
+    const response = await this.fetchImpl(
+      this.url(`/v1/workspaces/${workspaceId}/control-events/stream`, {
+        after: String(options.after ?? 0),
+      }),
+      {
+        method: "GET",
+        headers: { ...this.headers(), Accept: "text/event-stream" },
+        ...(options.signal ? { signal: options.signal } : {}),
+      },
+    );
+    assertApiContractResponse(response);
+    if (!response.ok) throw new OpenGeniApiError(response.status, await safeText(response));
+    if (!response.body) {
+      throw new OpenGeniApiError(response.status, "SSE response did not include a readable body");
+    }
+    return response.body;
+  }
+
   /**
-   * Steer: deliver a message *now* instead of behind the queue. Sends the
-   * message, promotes its queued turn to the front, and interrupts the
-   * running turn so the session picks the steer turn up next. On a session
-   * that is not running this degrades gracefully to a plain queued message.
-   *
-   * The steer turn is located by `triggerEventId` across ALL turns (retried
-   * briefly in case the server is still materializing it) — not just the
-   * queued ones, because the worker can claim the steer turn before it is
-   * ever observed queued, and a claimed steer turn means the message is
-   * already being delivered: interrupting then would cancel the very message
-   * being steered. If the turn cannot be found while other turns are queued,
-   * the interrupt is also skipped — stopping the running turn would otherwise
-   * promote someone else's queued work over this message — and the call
-   * degrades to a plain queued send (`interrupted: false`).
+   * Steer: atomically put this prompt at the head and supersede the current
+   * inference. The client performs one request and renders server order.
    */
   async steerMessage(
     workspaceId: string,
     sessionId: string,
     message: string | SendMessageInput,
   ): Promise<SteerMessageResult> {
-    const accepted = await this.sendMessage(workspaceId, sessionId, message);
-    let steerTurn: SessionTurn | null = null;
-    let queued: SessionTurn[] = [];
-    for (let attempt = 0; attempt < 4; attempt += 1) {
-      if (attempt > 0) {
-        await delay(150 * attempt);
-      }
-      const turns = await this.listTurns(workspaceId, sessionId);
-      queued = turns
-        .filter((turn) => turn.status === "queued")
-        .sort((a, b) => a.position - b.position || a.createdAt.localeCompare(b.createdAt));
-      // Match against every turn, whatever its status: a steer turn that is
-      // already running/requires_action (or even finished) was claimed before
-      // this listing — that is delivery, not grounds for an interrupt.
-      steerTurn = turns.find((turn) => turn.triggerEventId === accepted.id) ?? null;
-      if (steerTurn) {
-        break;
-      }
-    }
-    const steerTurnQueued = steerTurn?.status === "queued";
-    if (steerTurn && steerTurnQueued && queued.length > 1) {
-      const front = steerTurn;
-      await this.reorderQueuedTurns(workspaceId, sessionId, [
-        front.id,
-        ...queued.filter((turn) => turn.id !== front.id).map((turn) => turn.id),
-      ]);
-    }
-    // Interrupting is only safe when the next claim is provably this message:
-    // either the steer turn sits queued (now at the front), or no turn
-    // materialized yet AND nothing else is queued. A steer turn observed in
-    // any non-queued state was already claimed — skip the interrupt.
-    const canDeliverNext = steerTurnQueued || (steerTurn === null && queued.length === 0);
-    const session = await this.getSession(workspaceId, sessionId);
-    // If the previously running turn already finished and the session claimed
-    // the steer turn itself, interrupting now would cancel the very message
-    // being steered. `activeTurnId` is the claim check; the residual window
-    // between this read and the interrupt landing is accepted (an interrupt
-    // can never be atomic with a status read over HTTP).
-    const steerTurnAlreadyActive = steerTurn !== null && session.activeTurnId === steerTurn.id;
-    const interrupted = canDeliverNext
-      && !steerTurnAlreadyActive
-      && (session.status === "running" || session.status === "requires_action");
-    if (interrupted) {
-      await this.interrupt(workspaceId, sessionId, { reason: "steer" });
-    }
-    return { accepted, turn: steerTurn, interrupted };
+    const input = typeof message === "string" ? { text: message } : message;
+    return await this.requestJson<SteerMessageResult>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/steer`,
+      input,
+    );
   }
 
   // --- Goals -------------------------------------------------------------------
 
   /** The session's goal. 404s when the session never had one. */
   async getGoal(workspaceId: string, sessionId: string): Promise<SessionGoal> {
-    return await this.requestJson<SessionGoal>("GET", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/goal`);
+    return await this.requestJson<SessionGoal>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/goal`,
+    );
+  }
+
+  async updateGoal(
+    workspaceId: string,
+    sessionId: string,
+    request: UpdateSessionGoalRequest,
+  ): Promise<SessionGoal> {
+    return await this.requestJson<SessionGoal>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/goal`,
+      request,
+    );
   }
 
-  async updateGoal(workspaceId: string, sessionId: string, request: UpdateSessionGoalRequest): Promise<SessionGoal> {
-    return await this.requestJson<SessionGoal>("PATCH", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/goal`, request);
+  async deleteGoal(workspaceId: string, sessionId: string): Promise<void> {
+    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/goal`);
   }
 
   /** Pause the goal loop: the session stops self-continuing until resumed. */
-  async pauseGoal(workspaceId: string, sessionId: string, options: { rationale?: string } = {}): Promise<SessionGoal> {
+  async pauseGoal(
+    workspaceId: string,
+    sessionId: string,
+    options: { rationale?: string } = {},
+  ): Promise<SessionGoal> {
     return await this.updateGoal(workspaceId, sessionId, {
       status: "paused",
       ...(options.rationale !== undefined ? { rationale: options.rationale } : {}),
@@ -578,17 +874,23 @@ export class OpenGeniClient {
    * context — the destructive intent is explicit on the wire.
    */
   async clearSessionContext(workspaceId: string, sessionId: string): Promise<void> {
-    await this.requestVoid("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/context/clear`, { confirm: true });
+    await this.requestVoid(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/context/clear`,
+      { confirm: true },
+    );
   }
 
-  /**
-   * Trigger conversation compaction now. On the client-managed (Azure) path this
-   * queues a forced compaction the worker honors before the next turn
-   * (`status:"queued"`); on a server-managed provider or when compaction is off
-   * it is a no-op (`status:"noop"`) with an explanatory message.
-   */
-  async compactSessionContext(workspaceId: string, sessionId: string): Promise<CompactSessionContextResult> {
-    return await this.requestJson<CompactSessionContextResult>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/context/compact`, {});
+  /** Request one durable portable compaction at the next safe model boundary. */
+  async compactSessionContext(
+    workspaceId: string,
+    sessionId: string,
+  ): Promise<CompactSessionContextResult> {
+    return await this.requestJson<CompactSessionContextResult>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/context/compact`,
+      {},
+    );
   }
 
   // --- Channel-A structured services (P4.4) ------------------------------------
@@ -597,79 +899,232 @@ export class OpenGeniClient {
   // notifications + the PTY output stream arrive on the existing event SSE.
 
   /** FileSystem: list a directory tree (feeds the Pierre file tree). */
-  async fsList(workspaceId: string, sessionId: string, request: FsListRequest = {}): Promise<FsListResponse> {
-    return await this.requestJson<FsListResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/list`, request);
+  async fsList(
+    workspaceId: string,
+    sessionId: string,
+    request: FsListRequest = {},
+  ): Promise<FsListResponse> {
+    return await this.requestJson<FsListResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/list`,
+      request,
+    );
   }
 
   /** FileSystem: read a file (text or base64; binary-safe, size-capped). */
-  async fsRead(workspaceId: string, sessionId: string, request: FsReadRequest): Promise<FsReadResponse> {
-    return await this.requestJson<FsReadResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/read`, request);
+  async fsRead(
+    workspaceId: string,
+    sessionId: string,
+    request: FsReadRequest,
+  ): Promise<FsReadResponse> {
+    return await this.requestJson<FsReadResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/read`,
+      request,
+    );
   }
 
   /** FileSystem: write a file (last-writer-wins; emits fs.changed). */
-  async fsWrite(workspaceId: string, sessionId: string, request: FsWriteRequest): Promise<FsWriteResponse> {
-    return await this.requestJson<FsWriteResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/write`, request);
+  async fsWrite(
+    workspaceId: string,
+    sessionId: string,
+    request: FsWriteRequest,
+  ): Promise<FsWriteResponse> {
+    return await this.requestJson<FsWriteResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/write`,
+      request,
+    );
   }
 
   /** FileSystem: delete a path (emits fs.changed). */
-  async fsDelete(workspaceId: string, sessionId: string, request: FsDeleteRequest): Promise<FsDeleteResponse> {
-    return await this.requestJson<FsDeleteResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/delete`, request);
+  async fsDelete(
+    workspaceId: string,
+    sessionId: string,
+    request: FsDeleteRequest,
+  ): Promise<FsDeleteResponse> {
+    return await this.requestJson<FsDeleteResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/delete`,
+      request,
+    );
   }
 
   /** FileSystem: move/rename a path (emits fs.changed; 409 if destination exists and overwrite is false). */
-  async fsMove(workspaceId: string, sessionId: string, request: FsMoveRequest): Promise<FsMoveResponse> {
-    return await this.requestJson<FsMoveResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/move`, request);
+  async fsMove(
+    workspaceId: string,
+    sessionId: string,
+    request: FsMoveRequest,
+  ): Promise<FsMoveResponse> {
+    return await this.requestJson<FsMoveResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/move`,
+      request,
+    );
   }
 
   /** FileSystem: create a directory (emits fs.changed; recursive defaults to true). */
-  async fsMkdir(workspaceId: string, sessionId: string, request: FsMkdirRequest): Promise<FsMkdirResponse> {
-    return await this.requestJson<FsMkdirResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/mkdir`, request);
+  async fsMkdir(
+    workspaceId: string,
+    sessionId: string,
+    request: FsMkdirRequest,
+  ): Promise<FsMkdirResponse> {
+    return await this.requestJson<FsMkdirResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/fs/mkdir`,
+      request,
+    );
   }
 
   /** Git: working-tree/index status (the Pierre file-status feed). */
-  async gitStatus(workspaceId: string, sessionId: string, request: GitStatusRequest = {}): Promise<GitStatusResponse> {
-    return await this.requestJson<GitStatusResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/status`, request);
+  async gitStatus(
+    workspaceId: string,
+    sessionId: string,
+    request: GitStatusRequest = {},
+  ): Promise<GitStatusResponse> {
+    return await this.requestJson<GitStatusResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/status`,
+      request,
+    );
   }
 
   /** Git: structured diff hunks (the Pierre diff feed). */
-  async gitDiff(workspaceId: string, sessionId: string, request: GitDiffRequest = {}): Promise<GitDiffResponse> {
-    return await this.requestJson<GitDiffResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/diff`, request);
+  async gitDiff(
+    workspaceId: string,
+    sessionId: string,
+    request: GitDiffRequest = {},
+  ): Promise<GitDiffResponse> {
+    return await this.requestJson<GitDiffResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/diff`,
+      request,
+    );
   }
 
   /** Git: commit log. */
-  async gitLog(workspaceId: string, sessionId: string, request: GitLogRequest = {}): Promise<GitLogResponse> {
-    return await this.requestJson<GitLogResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/log`, request);
+  async gitLog(
+    workspaceId: string,
+    sessionId: string,
+    request: GitLogRequest = {},
+  ): Promise<GitLogResponse> {
+    return await this.requestJson<GitLogResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/log`,
+      request,
+    );
   }
 
   /** Git: show a commit (diff vs first parent) or fetch a raw blob at a ref. */
-  async gitShow(workspaceId: string, sessionId: string, request: GitShowRequest): Promise<GitShowResponse> {
-    return await this.requestJson<GitShowResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/show`, request);
+  async gitShow(
+    workspaceId: string,
+    sessionId: string,
+    request: GitShowRequest,
+  ): Promise<GitShowResponse> {
+    return await this.requestJson<GitShowResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/git/show`,
+      request,
+    );
+  }
+
+  /** Workspace capture: the latest turn-end snapshot of the session's workspace
+   *  (tree + per-repo diff + file after-image refs), served from durable storage
+   *  WITHOUT warming a machine — the workbench cold-paint source. Returns
+   *  `{available:false}` when no capture exists yet (fall back to the live path). */
+  async getWorkspaceCapture(
+    workspaceId: string,
+    sessionId: string,
+  ): Promise<GetWorkspaceCaptureResponse> {
+    return await this.requestJson<GetWorkspaceCaptureResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/workspace/capture`,
+    );
+  }
+
+  /** Workspace capture: a single file's after-image from the capture (revision
+   *  pins a specific one; omitted → latest). Content is inline for small files,
+   *  else a short-TTL signed URL; a tooLarge file returns metadata only. */
+  async getWorkspaceCaptureFile(
+    workspaceId: string,
+    sessionId: string,
+    path: string,
+    revision?: number,
+  ): Promise<GetWorkspaceCaptureFileResponse> {
+    const query: Record<string, string> = { path };
+    if (revision !== undefined) query.revision = String(revision);
+    return await this.requestJson<GetWorkspaceCaptureFileResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/workspace/capture/file`,
+      undefined,
+      query,
+    );
   }
 
   /** Terminal: run a bounded command, returning buffered stdout/stderr inline. */
-  async terminalExec(workspaceId: string, sessionId: string, request: TerminalExecRequest): Promise<TerminalExecResponse> {
-    return await this.requestJson<TerminalExecResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/exec`, request);
+  async terminalExec(
+    workspaceId: string,
+    sessionId: string,
+    request: TerminalExecRequest,
+  ): Promise<TerminalExecResponse> {
+    return await this.requestJson<TerminalExecResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/exec`,
+      request,
+    );
   }
 
   /** Terminal: open an interactive PTY. Output streams on the event SSE as
    *  terminal.pty.output.delta; drive it with terminalPtyWrite. */
-  async terminalPtyOpen(workspaceId: string, sessionId: string, request: PtyOpenRequest = {}): Promise<PtyOpenResponse> {
-    return await this.requestJson<PtyOpenResponse>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty`, request);
+  async terminalPtyOpen(
+    workspaceId: string,
+    sessionId: string,
+    request: PtyOpenRequest = {},
+  ): Promise<PtyOpenResponse> {
+    return await this.requestJson<PtyOpenResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty`,
+      request,
+    );
   }
 
   /** Terminal: send stdin to an open PTY (output rides A1). */
-  async terminalPtyWrite(workspaceId: string, sessionId: string, request: PtyWriteRequest): Promise<void> {
-    await this.requestVoid("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/write`, request);
+  async terminalPtyWrite(
+    workspaceId: string,
+    sessionId: string,
+    request: PtyWriteRequest,
+  ): Promise<void> {
+    await this.requestVoid(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/write`,
+      request,
+    );
   }
 
   /** Terminal: resize an open PTY. */
-  async terminalPtyResize(workspaceId: string, sessionId: string, request: PtyResizeRequest): Promise<void> {
-    await this.requestVoid("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/resize`, request);
+  async terminalPtyResize(
+    workspaceId: string,
+    sessionId: string,
+    request: PtyResizeRequest,
+  ): Promise<void> {
+    await this.requestVoid(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/resize`,
+      request,
+    );
   }
 
   /** Terminal: close an open PTY (idempotent). */
-  async terminalPtyClose(workspaceId: string, sessionId: string, request: PtyCloseRequest): Promise<void> {
-    await this.requestVoid("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/close`, request);
+  async terminalPtyClose(
+    workspaceId: string,
+    sessionId: string,
+    request: PtyCloseRequest,
+  ): Promise<void> {
+    await this.requestVoid(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/terminal/pty/close`,
+      request,
+    );
   }
 
   // --- Stream surfacing: capability negotiation + viewer lifecycle (Phase 5) ---
@@ -684,19 +1139,29 @@ export class OpenGeniClient {
    *  liveness the client polls on while `cold`/`warming`. The desktop URL/token
    *  are minted in-process only when the box is warm AND the principal has
    *  acknowledged the un-redacted plane. */
-  async getStreamCapabilities(workspaceId: string, sessionId: string): Promise<SessionCapabilities> {
+  async getStreamCapabilities(
+    workspaceId: string,
+    sessionId: string,
+  ): Promise<SessionCapabilities> {
     return await this.requestJson<SessionCapabilities>(
-      "GET", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/stream-capabilities`);
+      "GET",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/stream-capabilities`,
+    );
   }
 
   /** Record the calling principal's acknowledgment of the un-redacted desktop
    *  pixel plane (and, when the box is shared, the shared-exposure disclosure).
    *  The desktop viewer-attach path returns 409 until this is recorded. */
   async acknowledgeStream(
-    workspaceId: string, sessionId: string, request: AcknowledgeStreamRequest = {},
+    workspaceId: string,
+    sessionId: string,
+    request: AcknowledgeStreamRequest = {},
   ): Promise<AcknowledgeStreamResponse> {
     return await this.requestJson<AcknowledgeStreamResponse>(
-      "POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/stream-capabilities/acknowledge`, request);
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/stream-capabilities/acknowledge`,
+      request,
+    );
   }
 
   /** Attach a viewer holder (refcounted liveness — keeps the box warm while
@@ -708,25 +1173,39 @@ export class OpenGeniClient {
    *  (`desktop` omitted/false) warms the box + mints the pty-ws terminal cell with
    *  NO consent gate. An omitted `viewerId` mints a fresh one. */
   async attachViewer(
-    workspaceId: string, sessionId: string, request: AttachViewerRequest = {},
+    workspaceId: string,
+    sessionId: string,
+    request: AttachViewerRequest = {},
   ): Promise<AttachViewerResponse> {
     return await this.requestJson<AttachViewerResponse>(
-      "POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers`, request);
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers`,
+      request,
+    );
   }
 
   /** Heartbeat a viewer holder (Channel-A app-level liveness). A closed laptop
    *  stops sending these → the reaper drops the holder within ~90s. Echoes
    *  `leaseEpoch` so a superseded epoch is rejected (`alive:false` → re-attach). */
   async heartbeatViewer(
-    workspaceId: string, sessionId: string, viewerId: string, request: ViewerHeartbeatRequest,
+    workspaceId: string,
+    sessionId: string,
+    viewerId: string,
+    request: ViewerHeartbeatRequest,
   ): Promise<ViewerHeartbeatResponse> {
     return await this.requestJson<ViewerHeartbeatResponse>(
-      "POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers/${viewerId}/heartbeat`, request);
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers/${viewerId}/heartbeat`,
+      request,
+    );
   }
 
   /** Detach a viewer (delete this holder; idempotent delete-my-row). */
   async detachViewer(workspaceId: string, sessionId: string, viewerId: string): Promise<void> {
-    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers/${viewerId}`);
+    await this.requestVoid(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/viewers/${viewerId}`,
+    );
   }
 
   // --- Access + workspaces -----------------------------------------------------
@@ -739,7 +1218,14 @@ export class OpenGeniClient {
    * knowledge of the host setup; safe to call before any auth is established.
    */
   async getClientConfig(): Promise<ClientConfig> {
-    return await this.requestJson<ClientConfig>("GET", "/v1/config/client");
+    const config = await this.requestJson<ClientConfig>("GET", "/v1/config/client");
+    if (config.apiContractRevision !== OPENGENI_API_CONTRACT_REVISION) {
+      throw new OpenGeniApiContractMismatchError(
+        OPENGENI_API_CONTRACT_REVISION,
+        String(config.apiContractRevision || "(missing)"),
+      );
+    }
+    return config;
   }
 
   /** The caller's access context: subject, account + workspace grants, defaults. */
@@ -755,159 +1241,396 @@ export class OpenGeniClient {
     return await this.requestJson<Workspace>("POST", "/v1/workspaces", request);
   }
 
-  async getWorkspace(workspaceId: string): Promise<Workspace> {
-    return await this.requestJson<Workspace>("GET", `/v1/workspaces/${workspaceId}`);
+  async getWorkspace(workspaceId: string): Promise<Workspace> {
+    return await this.requestJson<Workspace>("GET", `/v1/workspaces/${workspaceId}`);
+  }
+
+  async updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace> {
+    return await this.requestJson<Workspace>("PATCH", `/v1/workspaces/${workspaceId}`, request);
+  }
+
+  /**
+   * Delete a workspace and everything in it. Refused (409) for the account's
+   * only workspace and while it still has a running session. Irreversible.
+   */
+  async deleteWorkspace(workspaceId: string): Promise<void> {
+    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}`);
+  }
+
+  // --- Members ("People with access") -------------------------------------------
+
+  /** The workspace's members (user + api_key subjects). */
+  async listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMember[]> {
+    const response = await this.requestJson<ListWorkspaceMembersResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/members`,
+    );
+    return response.members;
+  }
+
+  /**
+   * Add an already-registered user by email. 404s when no user with that email
+   * exists (email invites for unknown users are deferred).
+   */
+  async addWorkspaceMember(
+    workspaceId: string,
+    request: AddWorkspaceMemberRequest,
+  ): Promise<WorkspaceMember> {
+    return await this.requestJson<WorkspaceMember>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/members`,
+      request,
+    );
+  }
+
+  async updateWorkspaceMember(
+    workspaceId: string,
+    subjectId: string,
+    request: UpdateWorkspaceMemberRequest,
+  ): Promise<WorkspaceMember> {
+    return await this.requestJson<WorkspaceMember>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/members/${encodeURIComponent(subjectId)}`,
+      request,
+    );
+  }
+
+  /**
+   * Remove a member. Refused (409) for your own membership and for the last
+   * member who can still manage the workspace.
+   */
+  async removeWorkspaceMember(workspaceId: string, subjectId: string): Promise<void> {
+    await this.requestVoid(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/members/${encodeURIComponent(subjectId)}`,
+    );
+  }
+
+  // --- Scheduled tasks (write + runs) -------------------------------------------
+
+  async createScheduledTask(
+    workspaceId: string,
+    request: CreateScheduledTaskRequest,
+  ): Promise<ScheduledTask> {
+    return await this.requestJson<ScheduledTask>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks`,
+      request,
+    );
+  }
+
+  async updateScheduledTask(
+    workspaceId: string,
+    taskId: string,
+    request: UpdateScheduledTaskRequest,
+  ): Promise<ScheduledTask> {
+    return await this.requestJson<ScheduledTask>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`,
+      request,
+    );
+  }
+
+  async pauseScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask> {
+    return await this.requestJson<ScheduledTask>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/pause`,
+    );
+  }
+
+  async resumeScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask> {
+    return await this.requestJson<ScheduledTask>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/resume`,
+    );
+  }
+
+  /**
+   * Fire the task immediately (manual trigger), independent of its schedule.
+   * Pass a stable `triggerId` to make a retried trigger idempotent — the same
+   * token charges once and starts one run. Omit it and each call is distinct.
+   */
+  async triggerScheduledTask(
+    workspaceId: string,
+    taskId: string,
+    options: { triggerId?: string } = {},
+  ): Promise<ScheduledTask> {
+    return await this.requestJson<ScheduledTask>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/trigger`,
+      options.triggerId ? { triggerId: options.triggerId } : undefined,
+    );
+  }
+
+  async deleteScheduledTask(workspaceId: string, taskId: string): Promise<void> {
+    await this.requestJson<unknown>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`,
+    );
+  }
+
+  async listScheduledTaskRuns(
+    workspaceId: string,
+    taskId: string,
+    options: { limit?: number } = {},
+  ): Promise<ScheduledTaskRun[]> {
+    return await this.requestJson<ScheduledTaskRun[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/runs`,
+      undefined,
+      { ...(options.limit !== undefined ? { limit: String(options.limit) } : {}) },
+    );
+  }
+
+  // --- VariableSets --------------------------------------------------------------
+  // Variable values are write-only: reads return name/version metadata only.
+
+  async listVariableSets(workspaceId: string): Promise<VariableSet[]> {
+    return await this.requestJson<VariableSet[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/variable-sets`,
+    );
+  }
+
+  async createVariableSet(
+    workspaceId: string,
+    request: CreateVariableSetRequest,
+  ): Promise<VariableSet> {
+    return await this.requestJson<VariableSet>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/variable-sets`,
+      request,
+    );
+  }
+
+  async getVariableSet(workspaceId: string, variableSetId: string): Promise<VariableSet> {
+    return await this.requestJson<VariableSet>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/variable-sets/${variableSetId}`,
+    );
+  }
+
+  async updateVariableSet(
+    workspaceId: string,
+    variableSetId: string,
+    request: UpdateVariableSetRequest,
+  ): Promise<VariableSet> {
+    return await this.requestJson<VariableSet>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/variable-sets/${variableSetId}`,
+      request,
+    );
+  }
+
+  async deleteVariableSet(workspaceId: string, variableSetId: string): Promise<void> {
+    await this.requestJson<unknown>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/variable-sets/${variableSetId}`,
+    );
+  }
+
+  /** Create or rotate a variable. The value never comes back on any read. */
+  async setVariableSetVariable(
+    workspaceId: string,
+    variableSetId: string,
+    name: string,
+    value: string,
+  ): Promise<VariableSetVariableMetadata> {
+    return await this.requestJson<VariableSetVariableMetadata>(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/variable-sets/${variableSetId}/variables/${encodeURIComponent(name)}`,
+      { value },
+    );
+  }
+
+  async deleteVariableSetVariable(
+    workspaceId: string,
+    variableSetId: string,
+    name: string,
+  ): Promise<void> {
+    await this.requestJson<unknown>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/variable-sets/${variableSetId}/variables/${encodeURIComponent(name)}`,
+    );
   }
 
-  async updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace> {
-    return await this.requestJson<Workspace>("PATCH", `/v1/workspaces/${workspaceId}`, request);
-  }
+  // --- Rigs ------------------------------------------------------------------
+  // Workspace-scoped, versioned sandbox machine definitions. rigs:use gates read
+  // + proposeRigChange; rigs:manage gates create / update / delete / activate.
 
-  /**
-   * Delete a workspace and everything in it. Refused (409) for the account's
-   * only workspace and while it still has a running session. Irreversible.
-   */
-  async deleteWorkspace(workspaceId: string): Promise<void> {
-    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}`);
+  async listRigs(workspaceId: string): Promise<Rig[]> {
+    return await this.requestJson<Rig[]>("GET", `/v1/workspaces/${workspaceId}/rigs`);
   }
 
-  // --- Members ("People with access") -------------------------------------------
-
-  /** The workspace's members (user + api_key subjects). */
-  async listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMember[]> {
-    const response = await this.requestJson<ListWorkspaceMembersResponse>("GET", `/v1/workspaces/${workspaceId}/members`);
-    return response.members;
+  async createRig(workspaceId: string, request: CreateRigRequest): Promise<Rig> {
+    return await this.requestJson<Rig>("POST", `/v1/workspaces/${workspaceId}/rigs`, request);
   }
 
-  /**
-   * Add an already-registered user by email. 404s when no user with that email
-   * exists (email invites for unknown users are deferred).
-   */
-  async addWorkspaceMember(workspaceId: string, request: AddWorkspaceMemberRequest): Promise<WorkspaceMember> {
-    return await this.requestJson<WorkspaceMember>("POST", `/v1/workspaces/${workspaceId}/members`, request);
+  async getRig(workspaceId: string, rigId: string): Promise<Rig> {
+    return await this.requestJson<Rig>("GET", `/v1/workspaces/${workspaceId}/rigs/${rigId}`);
   }
 
-  async updateWorkspaceMember(workspaceId: string, subjectId: string, request: UpdateWorkspaceMemberRequest): Promise<WorkspaceMember> {
-    return await this.requestJson<WorkspaceMember>(
+  async updateRig(workspaceId: string, rigId: string, request: UpdateRigRequest): Promise<Rig> {
+    return await this.requestJson<Rig>(
       "PATCH",
-      `/v1/workspaces/${workspaceId}/members/${encodeURIComponent(subjectId)}`,
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}`,
       request,
     );
   }
 
-  /**
-   * Remove a member. Refused (409) for your own membership and for the last
-   * member who can still manage the workspace.
-   */
-  async removeWorkspaceMember(workspaceId: string, subjectId: string): Promise<void> {
-    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}/members/${encodeURIComponent(subjectId)}`);
+  async deleteRig(workspaceId: string, rigId: string): Promise<void> {
+    await this.requestJson<unknown>("DELETE", `/v1/workspaces/${workspaceId}/rigs/${rigId}`);
   }
 
-  // --- Scheduled tasks (write + runs) -------------------------------------------
+  async listRigVersions(workspaceId: string, rigId: string): Promise<RigVersion[]> {
+    return await this.requestJson<RigVersion[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/versions`,
+    );
+  }
 
-  async createScheduledTask(workspaceId: string, request: CreateScheduledTaskRequest): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>("POST", `/v1/workspaces/${workspaceId}/scheduled-tasks`, request);
+  /** Roll the active version to an existing one (rollback / promote-activate). */
+  async activateRigVersion(
+    workspaceId: string,
+    rigId: string,
+    versionId: string,
+  ): Promise<RigVersion> {
+    return await this.requestJson<RigVersion>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/versions/${versionId}/activate`,
+    );
   }
 
-  async updateScheduledTask(workspaceId: string, taskId: string, request: UpdateScheduledTaskRequest): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>("PATCH", `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`, request);
+  async listRigChanges(workspaceId: string, rigId: string): Promise<RigChange[]> {
+    return await this.requestJson<RigChange[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/changes`,
+    );
   }
 
-  async pauseScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>("POST", `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/pause`);
+  /** Propose a change against the rig's active version (rigs:use). */
+  async proposeRigChange(
+    workspaceId: string,
+    rigId: string,
+    request: ProposeRigChangeRequest,
+  ): Promise<RigChange> {
+    return await this.requestJson<RigChange>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/changes`,
+      request,
+    );
   }
 
-  async resumeScheduledTask(workspaceId: string, taskId: string): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>("POST", `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/resume`);
+  async getRigChange(workspaceId: string, rigId: string, changeId: string): Promise<RigChange> {
+    return await this.requestJson<RigChange>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/changes/${changeId}`,
+    );
   }
 
   /**
-   * Fire the task immediately (manual trigger), independent of its schedule.
-   * Pass a stable `triggerId` to make a retried trigger idempotent — the same
-   * token charges once and starts one run. Omit it and each call is distinct.
+   * Re-run verification for a change (rigs:use). Verification is asynchronous:
+   * this returns the change immediately with status `verifying`; poll
+   * `getRigChange`/`listRigChanges` for the terminal outcome + logs.
    */
-  async triggerScheduledTask(workspaceId: string, taskId: string, options: { triggerId?: string } = {}): Promise<ScheduledTask> {
-    return await this.requestJson<ScheduledTask>(
+  async verifyRigChange(workspaceId: string, rigId: string, changeId: string): Promise<RigChange> {
+    return await this.requestJson<RigChange>(
       "POST",
-      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/trigger`,
-      options.triggerId ? { triggerId: options.triggerId } : undefined,
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/changes/${changeId}/verify`,
     );
   }
 
-  async deleteScheduledTask(workspaceId: string, taskId: string): Promise<void> {
-    await this.requestJson<unknown>("DELETE", `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}`);
-  }
-
-  async listScheduledTaskRuns(
+  /**
+   * Promote a verified `definition_edit` change into a new active rig version
+   * (rigs:manage). Only valid once the change's verification passed; returns the
+   * newly minted version.
+   */
+  async promoteRigChange(
     workspaceId: string,
-    taskId: string,
-    options: { limit?: number } = {},
-  ): Promise<ScheduledTaskRun[]> {
-    return await this.requestJson<ScheduledTaskRun[]>(
-      "GET",
-      `/v1/workspaces/${workspaceId}/scheduled-tasks/${taskId}/runs`,
-      undefined,
-      { ...(options.limit !== undefined ? { limit: String(options.limit) } : {}) },
+    rigId: string,
+    changeId: string,
+  ): Promise<RigVersion> {
+    return await this.requestJson<RigVersion>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/changes/${changeId}/promote`,
     );
   }
 
-  // --- Environments --------------------------------------------------------------
-  // Variable values are write-only: reads return name/version metadata only.
+  /**
+   * Re-run the active version's checks in a clean throwaway sandbox (rigs:use).
+   * Asynchronous — returns the version id being verified; the outcome lands on
+   * the version's audit trail.
+   */
+  async verifyRig(workspaceId: string, rigId: string): Promise<{ ok: boolean; versionId: string }> {
+    return await this.requestJson<{ ok: boolean; versionId: string }>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/rigs/${rigId}/verify`,
+    );
+  }
 
-  async listEnvironments(workspaceId: string): Promise<WorkspaceEnvironment[]> {
-    return await this.requestJson<WorkspaceEnvironment[]>("GET", `/v1/workspaces/${workspaceId}/environments`);
+  /** @deprecated use listVariableSets */
+  async listEnvironments(workspaceId: string): Promise<VariableSet[]> {
+    return await this.listVariableSets(workspaceId);
   }
 
-  async createEnvironment(workspaceId: string, request: CreateWorkspaceEnvironmentRequest): Promise<WorkspaceEnvironment> {
-    return await this.requestJson<WorkspaceEnvironment>("POST", `/v1/workspaces/${workspaceId}/environments`, request);
+  /** @deprecated use createVariableSet */
+  async createEnvironment(
+    workspaceId: string,
+    request: CreateVariableSetRequest,
+  ): Promise<VariableSet> {
+    return await this.createVariableSet(workspaceId, request);
   }
 
-  async getEnvironment(workspaceId: string, environmentId: string): Promise<WorkspaceEnvironment> {
-    return await this.requestJson<WorkspaceEnvironment>("GET", `/v1/workspaces/${workspaceId}/environments/${environmentId}`);
+  /** @deprecated use getVariableSet */
+  async getEnvironment(workspaceId: string, environmentId: string): Promise<VariableSet> {
+    return await this.getVariableSet(workspaceId, environmentId);
   }
 
+  /** @deprecated use updateVariableSet */
   async updateEnvironment(
     workspaceId: string,
     environmentId: string,
-    request: UpdateWorkspaceEnvironmentRequest,
-  ): Promise<WorkspaceEnvironment> {
-    return await this.requestJson<WorkspaceEnvironment>(
-      "PATCH",
-      `/v1/workspaces/${workspaceId}/environments/${environmentId}`,
-      request,
-    );
+    request: UpdateVariableSetRequest,
+  ): Promise<VariableSet> {
+    return await this.updateVariableSet(workspaceId, environmentId, request);
   }
 
+  /** @deprecated use deleteVariableSet */
   async deleteEnvironment(workspaceId: string, environmentId: string): Promise<void> {
-    await this.requestJson<unknown>("DELETE", `/v1/workspaces/${workspaceId}/environments/${environmentId}`);
+    await this.deleteVariableSet(workspaceId, environmentId);
   }
 
-  /** Create or rotate a variable. The value never comes back on any read. */
+  /** @deprecated use setVariableSetVariable */
   async setEnvironmentVariable(
     workspaceId: string,
     environmentId: string,
     name: string,
     value: string,
-  ): Promise<WorkspaceEnvironmentVariableMetadata> {
-    return await this.requestJson<WorkspaceEnvironmentVariableMetadata>(
-      "PUT",
-      `/v1/workspaces/${workspaceId}/environments/${environmentId}/variables/${encodeURIComponent(name)}`,
-      { value },
-    );
+  ): Promise<VariableSetVariableMetadata> {
+    return await this.setVariableSetVariable(workspaceId, environmentId, name, value);
   }
 
-  async deleteEnvironmentVariable(workspaceId: string, environmentId: string, name: string): Promise<void> {
-    await this.requestJson<unknown>(
-      "DELETE",
-      `/v1/workspaces/${workspaceId}/environments/${environmentId}/variables/${encodeURIComponent(name)}`,
-    );
+  /** @deprecated use deleteVariableSetVariable */
+  async deleteEnvironmentVariable(
+    workspaceId: string,
+    environmentId: string,
+    name: string,
+  ): Promise<void> {
+    await this.deleteVariableSetVariable(workspaceId, environmentId, name);
   }
 
   // --- Files -----------------------------------------------------------------------
 
   /** Step 1 of the upload flow: returns the pre-signed PUT target. */
-  async beginFileUpload(workspaceId: string, request: CreateFileUploadRequest): Promise<CreateFileUploadResponse> {
-    return await this.requestJson<CreateFileUploadResponse>("POST", `/v1/workspaces/${workspaceId}/files/uploads`, request);
+  async beginFileUpload(
+    workspaceId: string,
+    request: CreateFileUploadRequest,
+  ): Promise<CreateFileUploadResponse> {
+    return await this.requestJson<CreateFileUploadResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/files/uploads`,
+      request,
+    );
   }
 
   /** Step 3 of the upload flow: server verifies the object and marks it ready. */
@@ -927,12 +1650,14 @@ export class OpenGeniClient {
   async uploadFile(workspaceId: string, input: UploadFileInput): Promise<FileAsset> {
     // Copy Uint8Array views into a Blob so byte offsets/shared buffers can't
     // leak surrounding bytes into the PUT body.
-    const body: Blob | ArrayBuffer | string = input.data instanceof Uint8Array
-      ? new Blob([input.data.slice()])
-      : input.data;
-    const sizeBytes = typeof body === "string"
-      ? new TextEncoder().encode(body).byteLength
-      : body instanceof Blob ? body.size : body.byteLength;
+    const body: Blob | ArrayBuffer | string =
+      input.data instanceof Uint8Array ? new Blob([input.data.slice()]) : input.data;
+    const sizeBytes =
+      typeof body === "string"
+        ? new TextEncoder().encode(body).byteLength
+        : body instanceof Blob
+          ? body.size
+          : body.byteLength;
     const upload = await this.beginFileUpload(workspaceId, {
       filename: input.filename,
       contentType: input.contentType,
@@ -957,39 +1682,76 @@ export class OpenGeniClient {
   }
 
   async getFile(workspaceId: string, fileId: string): Promise<FileAsset> {
-    return await this.requestJson<FileAsset>("GET", `/v1/workspaces/${workspaceId}/files/${fileId}`);
+    return await this.requestJson<FileAsset>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/files/${fileId}`,
+    );
   }
 
   /** Mint a short-lived signed download URL for a ready file. */
-  async createFileDownloadUrl(workspaceId: string, fileId: string): Promise<FileDownloadUrlResponse> {
-    return await this.requestJson<FileDownloadUrlResponse>("POST", `/v1/workspaces/${workspaceId}/files/${fileId}/download-url`);
+  async createFileDownloadUrl(
+    workspaceId: string,
+    fileId: string,
+  ): Promise<FileDownloadUrlResponse> {
+    return await this.requestJson<FileDownloadUrlResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/files/${fileId}/download-url`,
+    );
   }
 
   // --- Documents ----------------------------------------------------------------------
 
-  async createDocumentBase(workspaceId: string, request: CreateDocumentBaseRequest): Promise<DocumentBase> {
-    return await this.requestJson<DocumentBase>("POST", `/v1/workspaces/${workspaceId}/document-bases`, request);
+  async createDocumentBase(
+    workspaceId: string,
+    request: CreateDocumentBaseRequest,
+  ): Promise<DocumentBase> {
+    return await this.requestJson<DocumentBase>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/document-bases`,
+      request,
+    );
   }
 
   async listDocumentBases(workspaceId: string): Promise<DocumentBase[]> {
-    return await this.requestJson<DocumentBase[]>("GET", `/v1/workspaces/${workspaceId}/document-bases`);
+    return await this.requestJson<DocumentBase[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/document-bases`,
+    );
   }
 
   async getDocumentBase(workspaceId: string, baseId: string): Promise<DocumentBase> {
-    return await this.requestJson<DocumentBase>("GET", `/v1/workspaces/${workspaceId}/document-bases/${baseId}`);
+    return await this.requestJson<DocumentBase>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/document-bases/${baseId}`,
+    );
   }
 
   /** Index an uploaded file into the base. The file must be `ready`. */
-  async addDocument(workspaceId: string, baseId: string, request: AddDocumentRequest): Promise<Document> {
-    return await this.requestJson<Document>("POST", `/v1/workspaces/${workspaceId}/document-bases/${baseId}/documents`, request);
+  async addDocument(
+    workspaceId: string,
+    baseId: string,
+    request: AddDocumentRequest,
+  ): Promise<Document> {
+    return await this.requestJson<Document>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/document-bases/${baseId}/documents`,
+      request,
+    );
   }
 
   async listDocuments(workspaceId: string, baseId: string): Promise<Document[]> {
-    return await this.requestJson<Document[]>("GET", `/v1/workspaces/${workspaceId}/document-bases/${baseId}/documents`);
+    return await this.requestJson<Document[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/document-bases/${baseId}/documents`,
+    );
   }
 
   /** Retry indexing for a failed document. */
-  async reindexDocument(workspaceId: string, baseId: string, documentId: string): Promise<Document> {
+  async reindexDocument(
+    workspaceId: string,
+    baseId: string,
+    documentId: string,
+  ): Promise<Document> {
     return await this.requestJson<Document>(
       "POST",
       `/v1/workspaces/${workspaceId}/document-bases/${baseId}/documents/${documentId}/reindex`,
@@ -1023,10 +1785,17 @@ export class OpenGeniClient {
     workspaceId: string,
     request: DocumentSearchRequest,
   ): Promise<DocumentSearchResponse> {
-    return await this.requestJson<DocumentSearchResponse>("POST", `/v1/workspaces/${workspaceId}/knowledge/search`, request);
+    return await this.requestJson<DocumentSearchResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/knowledge/search`,
+      request,
+    );
   }
 
-  async listKnowledgeMemories(workspaceId: string, request: KnowledgeMemorySearchRequest = {}): Promise<KnowledgeMemory[]> {
+  async listKnowledgeMemories(
+    workspaceId: string,
+    request: KnowledgeMemorySearchRequest = {},
+  ): Promise<KnowledgeMemory[]> {
     const params = new URLSearchParams();
     if (request.query) params.set("query", request.query);
     if (request.status) params.set("status", request.status);
@@ -1034,19 +1803,75 @@ export class OpenGeniClient {
     if (request.scope) params.set("scope", request.scope);
     if (request.limit) params.set("limit", String(request.limit));
     const query = params.toString();
-    return await this.requestJson<KnowledgeMemory[]>("GET", `/v1/workspaces/${workspaceId}/knowledge/memories${query ? `?${query}` : ""}`);
+    return await this.requestJson<KnowledgeMemory[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/knowledge/memories${query ? `?${query}` : ""}`,
+    );
   }
 
   async getKnowledgeMemory(workspaceId: string, memoryId: string): Promise<KnowledgeMemory> {
-    return await this.requestJson<KnowledgeMemory>("GET", `/v1/workspaces/${workspaceId}/knowledge/memories/${memoryId}`);
+    return await this.requestJson<KnowledgeMemory>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/knowledge/memories/${memoryId}`,
+    );
   }
 
-  async createKnowledgeMemory(workspaceId: string, request: CreateKnowledgeMemoryRequest): Promise<KnowledgeMemory> {
-    return await this.requestJson<KnowledgeMemory>("POST", `/v1/workspaces/${workspaceId}/knowledge/memories`, request);
+  async createKnowledgeMemory(
+    workspaceId: string,
+    request: CreateKnowledgeMemoryRequest,
+  ): Promise<KnowledgeMemory> {
+    return await this.requestJson<KnowledgeMemory>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/knowledge/memories`,
+      request,
+    );
+  }
+
+  async updateKnowledgeMemory(
+    workspaceId: string,
+    memoryId: string,
+    request: UpdateKnowledgeMemoryRequest,
+  ): Promise<KnowledgeMemory> {
+    return await this.requestJson<KnowledgeMemory>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/knowledge/memories/${memoryId}`,
+      request,
+    );
+  }
+
+  /** Hybrid (semantic + keyword) search over the workspace's agent-visible memory. */
+  async searchWorkspaceMemories(
+    workspaceId: string,
+    request: WorkspaceMemorySearchRequest,
+  ): Promise<WorkspaceMemorySearchResponse> {
+    return await this.requestJson<WorkspaceMemorySearchResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/knowledge/memories/search`,
+      request,
+    );
   }
 
-  async updateKnowledgeMemory(workspaceId: string, memoryId: string, request: UpdateKnowledgeMemoryRequest): Promise<KnowledgeMemory> {
-    return await this.requestJson<KnowledgeMemory>("PATCH", `/v1/workspaces/${workspaceId}/knowledge/memories/${memoryId}`, request);
+  /** Deep-merge a settings patch into the workspace (preserves unknown keys). */
+  async updateWorkspaceSettings(
+    workspaceId: string,
+    request: UpdateWorkspaceSettingsRequest,
+  ): Promise<Workspace> {
+    return await this.requestJson<Workspace>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/settings`,
+      request,
+    );
+  }
+
+  async setWorkspaceDefaultRig(
+    workspaceId: string,
+    request: SetWorkspaceDefaultRigRequest,
+  ): Promise<Workspace> {
+    return await this.requestJson<Workspace>(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/default-rig`,
+      request,
+    );
   }
 
   // --- Capability packs ------------------------------------------------------------------
@@ -1057,15 +1882,29 @@ export class OpenGeniClient {
   }
 
   /** Register (or replace) a workspace-scoped pack from a manifest. */
-  async registerPack(workspaceId: string, manifest: RegisterCapabilityPackRequest): Promise<WorkspaceRegisteredPack> {
-    return await this.requestJson<WorkspaceRegisteredPack>("POST", `/v1/workspaces/${workspaceId}/packs`, manifest);
+  async registerPack(
+    workspaceId: string,
+    manifest: RegisterCapabilityPackRequest,
+  ): Promise<WorkspaceRegisteredPack> {
+    return await this.requestJson<WorkspaceRegisteredPack>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/packs`,
+      manifest,
+    );
   }
 
   async getPack(workspaceId: string, packId: string): Promise<GetPackResponse> {
-    return await this.requestJson<GetPackResponse>("GET", `/v1/workspaces/${workspaceId}/packs/${encodeURIComponent(packId)}`);
+    return await this.requestJson<GetPackResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/packs/${encodeURIComponent(packId)}`,
+    );
   }
 
-  async enablePack(workspaceId: string, packId: string, request: EnablePackRequest = {}): Promise<PackInstallation> {
+  async enablePack(
+    workspaceId: string,
+    packId: string,
+    request: EnablePackRequest = {},
+  ): Promise<PackInstallation> {
     return await this.requestJson<PackInstallation>(
       "POST",
       `/v1/workspaces/${workspaceId}/packs/${encodeURIComponent(packId)}/enable`,
@@ -1075,22 +1914,38 @@ export class OpenGeniClient {
 
   /** Unregister a workspace-scoped pack (built-in packs cannot be deleted). */
   async deletePack(workspaceId: string, packId: string): Promise<void> {
-    await this.requestVoid("DELETE", `/v1/workspaces/${workspaceId}/packs/${encodeURIComponent(packId)}`);
+    await this.requestVoid(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/packs/${encodeURIComponent(packId)}`,
+    );
   }
 
   async listPackInstallations(workspaceId: string): Promise<PackInstallation[]> {
-    return await this.requestJson<PackInstallation[]>("GET", `/v1/workspaces/${workspaceId}/packs/installations`);
+    return await this.requestJson<PackInstallation[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/packs/installations`,
+    );
   }
 
   // --- Capabilities -------------------------------------------------------------------------
 
   async listCapabilities(workspaceId: string): Promise<CapabilityCatalogResponse> {
-    return await this.requestJson<CapabilityCatalogResponse>("GET", `/v1/workspaces/${workspaceId}/capabilities`);
+    return await this.requestJson<CapabilityCatalogResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/capabilities`,
+    );
   }
 
   /** Add a manual capability catalog item (e.g. a remote MCP server). */
-  async createCapability(workspaceId: string, request: CreateCapabilityCatalogItemRequest): Promise<CapabilityCatalogItem> {
-    return await this.requestJson<CapabilityCatalogItem>("POST", `/v1/workspaces/${workspaceId}/capabilities`, request);
+  async createCapability(
+    workspaceId: string,
+    request: CreateCapabilityCatalogItemRequest,
+  ): Promise<CapabilityCatalogItem> {
+    return await this.requestJson<CapabilityCatalogItem>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/capabilities`,
+      request,
+    );
   }
 
   async enableCapability(
@@ -1105,7 +1960,10 @@ export class OpenGeniClient {
     );
   }
 
-  async disableCapability(workspaceId: string, capabilityId: string): Promise<CapabilityInstallation> {
+  async disableCapability(
+    workspaceId: string,
+    capabilityId: string,
+  ): Promise<CapabilityInstallation> {
     return await this.requestJson<CapabilityInstallation>(
       "POST",
       `/v1/workspaces/${workspaceId}/capabilities/${encodeURIComponent(capabilityId)}/disable`,
@@ -1128,6 +1986,66 @@ export class OpenGeniClient {
     );
   }
 
+  // --- Connections -------------------------------------------------------------------------------
+
+  async listConnections(workspaceId: string): Promise<ConnectionMetadata[]> {
+    const response = await this.requestJson<ListConnectionsResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/connections`,
+    );
+    return response.connections;
+  }
+
+  async createConnection(
+    workspaceId: string,
+    request: CreateConnectionRequest,
+  ): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/connections`,
+      request,
+    );
+    return response.connection;
+  }
+
+  async updateConnection(
+    workspaceId: string,
+    connectionId: string,
+    request: UpdateConnectionRequest,
+  ): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/connections/${connectionId}`,
+      request,
+    );
+    return response.connection;
+  }
+
+  async deleteConnection(workspaceId: string, connectionId: string): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/connections/${connectionId}`,
+    );
+    return response.connection;
+  }
+
+  /** Start an OAuth connection flow; redirect the user to the returned `authorizationUrl`. */
+  async startConnectionOAuth(
+    workspaceId: string,
+    request: OAuthStartRequest,
+  ): Promise<OAuthStartResponse> {
+    return await this.requestJson<OAuthStartResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/connections/oauth/start`,
+      request,
+    );
+  }
+
+  /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
+  catalogAssetUrl(logoAssetPath: string | null): string | null {
+    return logoAssetPath ? `${this.baseUrl}/v1/${logoAssetPath}` : null;
+  }
+
   // --- GitHub ----------------------------------------------------------------------------------
 
   /** GitHub App configuration status + a signed install URL when configured. */
@@ -1145,12 +2063,18 @@ export class OpenGeniClient {
   }
 
   async listGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse> {
-    return await this.requestJson<GitHubRepositoriesResponse>("GET", `/v1/workspaces/${workspaceId}/github/repositories`);
+    return await this.requestJson<GitHubRepositoriesResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/github/repositories`,
+    );
   }
 
   /** Re-sync the installation's repository list from GitHub. */
   async syncGitHubRepositories(workspaceId: string): Promise<GitHubRepositoriesResponse> {
-    return await this.requestJson<GitHubRepositoriesResponse>("POST", `/v1/workspaces/${workspaceId}/github/repositories/sync`);
+    return await this.requestJson<GitHubRepositoriesResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/github/repositories/sync`,
+    );
   }
 
   /** Build a GitHub App manifest + the GitHub URL to submit it to. */
@@ -1168,18 +2092,31 @@ export class OpenGeniClient {
   // --- API keys ----------------------------------------------------------------------------------
 
   async listApiKeys(workspaceId: string): Promise<ApiKey[]> {
-    const response = await this.requestJson<ListApiKeysResponse>("GET", `/v1/workspaces/${workspaceId}/api-keys`);
+    const response = await this.requestJson<ListApiKeysResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/api-keys`,
+    );
     return response.apiKeys;
   }
 
   /** The returned `token` is shown once; only its prefix is stored. */
-  async createApiKey(workspaceId: string, request: CreateApiKeyRequest): Promise<CreateApiKeyResponse> {
-    return await this.requestJson<CreateApiKeyResponse>("POST", `/v1/workspaces/${workspaceId}/api-keys`, request);
+  async createApiKey(
+    workspaceId: string,
+    request: CreateApiKeyRequest,
+  ): Promise<CreateApiKeyResponse> {
+    return await this.requestJson<CreateApiKeyResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/api-keys`,
+      request,
+    );
   }
 
   /** Revoke an API key. Returns the revoked key. */
   async deleteApiKey(workspaceId: string, apiKeyId: string): Promise<ApiKey> {
-    return await this.requestJson<ApiKey>("DELETE", `/v1/workspaces/${workspaceId}/api-keys/${apiKeyId}`);
+    return await this.requestJson<ApiKey>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/api-keys/${apiKeyId}`,
+    );
   }
 
   // --- Billing (account-scoped) --------------------------------------------------------------------
@@ -1190,17 +2127,26 @@ export class OpenGeniClient {
     });
   }
 
-  async getBillingUsage(options: { accountId?: string; workspaceId?: string } = {}): Promise<BillingUsageResponse> {
+  async getBillingUsage(
+    options: { accountId?: string; workspaceId?: string } = {},
+  ): Promise<BillingUsageResponse> {
     return await this.requestJson<BillingUsageResponse>("GET", "/v1/billing/usage", undefined, {
       ...(options.accountId !== undefined ? { accountId: options.accountId } : {}),
       ...(options.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
     });
   }
 
-  async getBillingEntitlements(options: { accountId?: string } = {}): Promise<BillingEntitlementsResponse> {
-    return await this.requestJson<BillingEntitlementsResponse>("GET", "/v1/billing/entitlements", undefined, {
-      ...(options.accountId !== undefined ? { accountId: options.accountId } : {}),
-    });
+  async getBillingEntitlements(
+    options: { accountId?: string } = {},
+  ): Promise<BillingEntitlementsResponse> {
+    return await this.requestJson<BillingEntitlementsResponse>(
+      "GET",
+      "/v1/billing/entitlements",
+      undefined,
+      {
+        ...(options.accountId !== undefined ? { accountId: options.accountId } : {}),
+      },
+    );
   }
 
   /** Start a Stripe checkout for prepaid credits. */
@@ -1211,10 +2157,12 @@ export class OpenGeniClient {
   // --- Internals -------------------------------------------------------------
 
   private headers(): Record<string, string> {
-    const extra = typeof this.options.headers === "function" ? this.options.headers() : this.options.headers;
+    const extra =
+      typeof this.options.headers === "function" ? this.options.headers() : this.options.headers;
     return {
       ...(this.options.apiKey ? { Authorization: `Bearer ${this.options.apiKey}` } : {}),
       ...extra,
+      [OPENGENI_API_CONTRACT_HEADER]: OPENGENI_API_CONTRACT_REVISION,
     };
   }
 
@@ -1227,17 +2175,27 @@ export class OpenGeniClient {
 
   /** Connection state + the codex models the workspace may select (empty until connected). */
   async codexStatus(workspaceId: string): Promise<CodexConnectionStatus> {
-    return await this.requestJson<CodexConnectionStatus>("GET", `/v1/workspaces/${workspaceId}/codex/status`);
+    return await this.requestJson<CodexConnectionStatus>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/codex/status`,
+    );
   }
 
   /** Begin device-code login: show `userCode` at `verificationUri`, then poll with `state`. */
   async codexConnectStart(workspaceId: string): Promise<CodexConnectStart> {
-    return await this.requestJson<CodexConnectStart>("POST", `/v1/workspaces/${workspaceId}/codex/connect/start`);
+    return await this.requestJson<CodexConnectStart>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/codex/connect/start`,
+    );
   }
 
   /** Poll device-code authorization with the `state` from {@link codexConnectStart}. */
   async codexConnectPoll(workspaceId: string, state: string): Promise<CodexConnectPoll> {
-    return await this.requestJson<CodexConnectPoll>("POST", `/v1/workspaces/${workspaceId}/codex/connect/poll`, { state });
+    return await this.requestJson<CodexConnectPoll>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/codex/connect/poll`,
+      { state },
+    );
   }
 
   /** Remaining usage / limits for the connected (ACTIVE) subscription. Back-compat. */
@@ -1247,53 +2205,105 @@ export class OpenGeniClient {
 
   /** Live per-account usage read (refreshes THIS account's bearer; writes the cache). */
   async codexAccountUsage(workspaceId: string, accountId: string): Promise<CodexUsage> {
-    return await this.requestJson<CodexUsage>("GET", `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}/usage`);
+    return await this.requestJson<CodexUsage>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}/usage`,
+    );
   }
 
   /** Batched live refresh across every connected account, keyed by credential id. */
   async refreshCodexUsage(workspaceId: string): Promise<{ usage: CodexUsageMap }> {
-    return await this.requestJson<{ usage: CodexUsageMap }>("POST", `/v1/workspaces/${workspaceId}/codex/usage/refresh`);
+    return await this.requestJson<{ usage: CodexUsageMap }>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/codex/usage/refresh`,
+    );
   }
 
   /** Disconnect ALL accounts (legacy workspace-wide). Prefer `disconnectCodexAccount`. */
   async codexDisconnect(workspaceId: string): Promise<{ disconnected: boolean }> {
-    return await this.requestJson<{ disconnected: boolean }>("DELETE", `/v1/workspaces/${workspaceId}/codex`);
+    return await this.requestJson<{ disconnected: boolean }>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/codex`,
+    );
   }
 
   /** List every connected Codex account + the workspace active pointer + settings. */
   async listCodexAccounts(workspaceId: string): Promise<CodexAccountsResponse> {
-    return await this.requestJson<CodexAccountsResponse>("GET", `/v1/workspaces/${workspaceId}/codex/accounts`);
+    return await this.requestJson<CodexAccountsResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/codex/accounts`,
+    );
   }
 
   /** Switch the workspace ACTIVE Codex account (the one unpinned sessions use). */
-  async activateCodexAccount(workspaceId: string, accountId: string): Promise<{ activated: boolean; accountId: string }> {
-    return await this.requestJson<{ activated: boolean; accountId: string }>("POST", `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}/activate`);
+  async activateCodexAccount(
+    workspaceId: string,
+    accountId: string,
+  ): Promise<{ activated: boolean; accountId: string }> {
+    return await this.requestJson<{ activated: boolean; accountId: string }>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}/activate`,
+    );
   }
 
   /** P3: enable/disable Codex auto-rotation and/or pick the strategy. Returns the effective settings. */
   async setCodexRotationSettings(
     workspaceId: string,
-    patch: { rotationEnabled?: boolean; rotationStrategy?: CodexRotationSettings["rotationStrategy"] },
+    patch: {
+      rotationEnabled?: boolean;
+      rotationStrategy?: CodexRotationSettings["rotationStrategy"];
+    },
   ): Promise<CodexRotationSettings> {
-    return await this.requestJson<CodexRotationSettings>("PATCH", `/v1/workspaces/${workspaceId}/codex/settings`, patch);
+    return await this.requestJson<CodexRotationSettings>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/codex/settings`,
+      patch,
+    );
   }
 
   /** Disconnect ONE Codex account by id (re-picks active when the removed one was active). */
-  async disconnectCodexAccount(workspaceId: string, accountId: string): Promise<{ disconnected: boolean; newActiveId: string | null }> {
-    return await this.requestJson<{ disconnected: boolean; newActiveId: string | null }>("DELETE", `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}`);
+  async disconnectCodexAccount(
+    workspaceId: string,
+    accountId: string,
+  ): Promise<{ disconnected: boolean; newActiveId: string | null }> {
+    return await this.requestJson<{ disconnected: boolean; newActiveId: string | null }>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}`,
+    );
   }
 
   /** Rename a Codex account (label only in P1). */
-  async renameCodexAccount(workspaceId: string, accountId: string, label: string | null): Promise<CodexAccount> {
-    return await this.requestJson<CodexAccount>("PATCH", `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}`, { label });
+  async renameCodexAccount(
+    workspaceId: string,
+    accountId: string,
+    label: string | null,
+  ): Promise<CodexAccount> {
+    return await this.requestJson<CodexAccount>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/codex/accounts/${accountId}`,
+      { label },
+    );
   }
 
   /** Pin (or unpin via "auto") a session's Codex account. Applies on the next turn. */
-  async pinSessionCodexAccount(workspaceId: string, sessionId: string, target: string): Promise<{ pinned: string }> {
-    return await this.requestJson<{ pinned: string }>("POST", `/v1/workspaces/${workspaceId}/sessions/${sessionId}/codex-account`, { target });
+  async pinSessionCodexAccount(
+    workspaceId: string,
+    sessionId: string,
+    target: string,
+  ): Promise<{ pinned: string }> {
+    return await this.requestJson<{ pinned: string }>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/sessions/${sessionId}/codex-account`,
+      { target },
+    );
   }
 
-  private async requestJson<T>(method: string, path: string, body?: unknown, query: Record<string, string> = {}): Promise<T> {
+  private async requestJson<T>(
+    method: string,
+    path: string,
+    body?: unknown,
+    query: Record<string, string> = {},
+  ): Promise<T> {
     const response = await this.fetchImpl(this.url(path, query), {
       method,
       headers: {
@@ -1303,6 +2313,7 @@ export class OpenGeniClient {
       },
       ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
     });
+    assertApiContractResponse(response);
     if (!response.ok) {
       throw new OpenGeniApiError(response.status, await safeText(response));
     }
@@ -1320,12 +2331,20 @@ export class OpenGeniClient {
       },
       ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
     });
+    assertApiContractResponse(response);
     if (!response.ok) {
       throw new OpenGeniApiError(response.status, await safeText(response));
     }
   }
 }
 
+function assertApiContractResponse(response: Response): void {
+  const actual = response.headers.get(OPENGENI_API_CONTRACT_HEADER);
+  if (actual && actual !== OPENGENI_API_CONTRACT_REVISION) {
+    throw new OpenGeniApiContractMismatchError(OPENGENI_API_CONTRACT_REVISION, actual);
+  }
+}
+
 async function safeText(response: Response): Promise<string> {
   try {
     return await response.text();
@@ -1333,7 +2352,3 @@ async function safeText(response: Response): Promise<string> {
     return "";
   }
 }
-
-function delay(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}