@opengeni/sdk 0.37.0 → 0.40.0

package/dist/workspace-state.d.ts

@@ -31,6 +31,75 @@ export type WorkspaceStateMemoryKindCounts = {
     preference: number;
 };
 export type WorkspaceStateGapCode = "no_document_bases" | "no_visible_documents" | "failed_documents" | "processing_documents" | "missing_topic_coverage" | "no_memory_records" | "pending_memory_review" | "partial_inventory";
+export type WorkspaceStateGovernanceDriftStatus = "identical" | "changed" | "superseded" | "missing" | "unavailable" | "truncated";
+export type WorkspaceStateGetOptions = {
+    attemptId?: string;
+};
+export type WorkspaceStateAttemptGovernance = {
+    status: "not_requested";
+} | {
+    status: "unavailable";
+    reason: "attempt_not_found_or_not_authorized";
+    driftStatus: "unavailable";
+} | {
+    status: "available";
+    attemptId: string;
+    executionGeneration: number;
+    acceptedAt: string;
+    policySnapshot: {
+        status: "missing";
+    } | {
+        status: "available";
+        id: string;
+        createdAt: string;
+        entryHash: string;
+        policyRole: string | null;
+        roleSource: "session_binding" | "metadata_fallback" | "none" | "invalid_metadata_fallback";
+        entries: Array<{
+            kind: WorkspaceInstructionPolicyKind;
+            scope: WorkspaceInstructionPolicyScope;
+            roleKey: string | null;
+            revisionId: string;
+            revision: number;
+            contentHash: string;
+            activationVersion: number;
+            activatedAt: string;
+            provenance: {
+                source: WorkspaceInstructionPolicyProvenanceSource;
+                sourceIdHash: string | null;
+            };
+        }>;
+    };
+    preferenceSnapshot: {
+        status: "missing";
+    } | {
+        status: "available";
+        id: string;
+        createdAt: string;
+        descriptorHash: string;
+        descriptorCount: number;
+        truncated: boolean;
+    };
+    drift: {
+        overall: WorkspaceStateGovernanceDriftStatus;
+        policy: {
+            status: WorkspaceStateGovernanceDriftStatus;
+            snapshotHash: string | null;
+            currentHash: string | null;
+            snapshotTargetCount: number;
+            currentTargetCount: number;
+        };
+        preferences: {
+            status: WorkspaceStateGovernanceDriftStatus;
+            snapshotHash: string | null;
+            currentHash: string | null;
+            snapshotDescriptorCount: number;
+            currentDescriptorCount: number;
+            snapshotTruncated: boolean;
+            currentTruncated: boolean;
+        };
+    };
+};
 export type WorkspaceStateResponse = {
     workspaceId: string;
     generatedAt: string;
@@ -39,10 +108,7 @@ export type WorkspaceStateResponse = {
             source: "read_time_projection";
             capturedAt: string;
         };
-        policySnapshot: {
-            status: "not_captured";
-            reason: "workspace_instruction_policy_snapshot_not_implemented";
-        };
+        attemptGovernance: WorkspaceStateAttemptGovernance;
     };
     policy: {
         authority: "workspace_instruction_policy_heads";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.37.0",
+  "version": "0.40.0",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,6 +26,10 @@
       "types": "./dist/core.d.ts",
       "import": "./dist/core.js"
     },
+    "./realtime": {
+      "types": "./dist/realtime.d.ts",
+      "import": "./dist/realtime.js"
+    },
     "./codex-realtime-controller": {
       "types": "./dist/codex-realtime-controller.d.ts",
       "import": "./dist/codex-realtime-controller.js"

package/src/client.ts

@@ -90,6 +90,8 @@ import type {
   GetPackResponse,
   GitHubAppInfo,
   GitHubRepositoriesResponse,
+  GoogleDriveDisconnectRequest,
+  GoogleDriveLifecycleActionRequest,
   KnowledgeMemory,
   KnowledgeMemorySearchRequest,
   ListApiKeysResponse,
@@ -229,7 +231,7 @@ import type {
   WorkspaceInstructionPolicyListResponse,
   WorkspaceInstructionPolicyRevision,
 } from "./workspace-instruction-policies";
-import type { WorkspaceStateResponse } from "./workspace-state";
+import type { WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state";
 import type {
   ActivatePreferenceRegistryRevisionRequest,
   ChangePreferenceRegistryScopeRequest,
@@ -1892,10 +1894,16 @@ export class OpenGeniClient {
   }
 
   /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
-  async getWorkspaceState(workspaceId: string): Promise<WorkspaceStateResponse> {
+  async getWorkspaceState(
+    workspaceId: string,
+    options: WorkspaceStateGetOptions = {},
+  ): Promise<WorkspaceStateResponse> {
+    const params = new URLSearchParams();
+    if (options.attemptId) params.set("attemptId", options.attemptId);
+    const query = params.size > 0 ? `?${params.toString()}` : "";
     return await this.requestJson<WorkspaceStateResponse>(
       "GET",
-      `/v1/workspaces/${workspaceId}/workspace-state`,
+      `/v1/workspaces/${workspaceId}/workspace-state${query}`,
     );
   }
 
@@ -3048,6 +3056,32 @@ export class OpenGeniClient {
     return response.connection;
   }
 
+  async disconnectGoogleDriveConnection(
+    workspaceId: string,
+    connectionId: string,
+    request: GoogleDriveDisconnectRequest,
+  ): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/connections/${connectionId}`,
+      request,
+    );
+    return response.connection;
+  }
+
+  async transitionGoogleDriveLifecycle(
+    workspaceId: string,
+    connectionId: string,
+    request: GoogleDriveLifecycleActionRequest,
+  ): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/connections/google-drive/${connectionId}/lifecycle`,
+      request,
+    );
+    return response.connection;
+  }
+
   /** Start an OAuth connection flow; redirect the user to the returned `authorizationUrl`. */
   async startConnectionOAuth(
     workspaceId: string,

package/src/codex-realtime-controller.ts

@@ -147,6 +147,44 @@ export type CodexRealtimeControllerClient = {
 
 export type CodexRealtimeOwnerStorage = Pick<Storage, "getItem" | "setItem" | "removeItem">;
 
+/** Canonical browser-owner storage namespace for a public realtime model. */
+export function sessionRealtimeOwnerStorageNamespace(model: SessionRealtimeModel): string {
+  return model === "gpt-live-1-boulder-alpha" ? "codex-realtime-owner" : "gateway-realtime-owner";
+}
+
+/** Canonical browser-owner storage key shared by the SDK controller and React facade. */
+export function sessionRealtimeOwnerStorageKey(
+  workspaceId: string,
+  sessionId: string,
+  model: SessionRealtimeModel,
+): string {
+  return ownerStorageKey(workspaceId, sessionId, sessionRealtimeOwnerStorageNamespace(model));
+}
+
+/**
+ * Preserve the existing pre-controller owner-presence projection used by the
+ * lazy React control. The controller remains the sole authority that validates
+ * or removes malformed records once it is constructed.
+ */
+export function hasStoredSessionRealtimeOwnerProof(input: {
+  workspaceId: string;
+  sessionId: string;
+  model: SessionRealtimeModel;
+  storage?: CodexRealtimeOwnerStorage | undefined;
+}): boolean {
+  const storage = input.storage ?? defaultStorage();
+  if (!storage) return false;
+  try {
+    return (
+      storage.getItem(
+        sessionRealtimeOwnerStorageKey(input.workspaceId, input.sessionId, input.model),
+      ) !== null
+    );
+  } catch {
+    return false;
+  }
+}
+
 export type CreateCodexRealtimeControllerOptions = {
   client: CodexRealtimeControllerClient;
   workspaceId: string;

package/src/index.ts

@@ -136,6 +136,7 @@ export type {
   WorkspaceInstructionPolicyKind,
   WorkspaceInstructionPolicyListOptions,
   WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyOperationReuseResponse,
   WorkspaceInstructionPolicyProvenanceSource,
   WorkspaceInstructionPolicyRevision,
   WorkspaceInstructionPolicyRevisionIdentity,
@@ -144,7 +145,10 @@ export type {
 } from "./workspace-instruction-policies";
 export type {
   WorkspaceStateDocumentStatusCounts,
+  WorkspaceStateAttemptGovernance,
   WorkspaceStateGapCode,
+  WorkspaceStateGetOptions,
+  WorkspaceStateGovernanceDriftStatus,
   WorkspaceStateMemoryKindCounts,
   WorkspaceStateMemoryStatusCounts,
   WorkspaceStateResponse,
@@ -208,6 +212,7 @@ export type {
   WorkspaceTranscriptionTarget,
 } from "./transcription";
 export {
+  DEFAULT_FILE_RESOURCE_MOUNT_ROOT,
   KNOWN_PERMISSIONS,
   KNOWN_USAGE_EVENT_TYPES,
   OPENGENI_API_CONTRACT_HEADER,
@@ -348,6 +353,7 @@ export type {
   CreateWorkspaceRequest,
   DiscoverMcpCapabilitiesResponse,
   Document,
+  DocumentAuthorityKind,
   DocumentBase,
   DocumentCuration,
   DocumentCurationStatus,
@@ -383,7 +389,11 @@ export type {
   GitHubRepositoriesResponse,
   GoogleDriveBrowseItem,
   GoogleDriveBrowseResponse,
+  GoogleDriveConnectionLifecycle,
+  GoogleDriveConnectionLifecycleState,
   GoogleDriveConnectionMetadata,
+  GoogleDriveDisconnectRequest,
+  GoogleDriveLifecycleActionRequest,
   GoogleDriveOAuthStartRequest,
   GoogleDriveOAuthStartResponse,
   GoogleDriveReadPolicy,

package/src/realtime.ts

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

package/src/types.ts

@@ -461,10 +461,13 @@ export type RepositoryResourceRef = {
   githubRepositoryId?: number | undefined;
 };
 
+/** Value mirror of `@opengeni/contracts`; parity-tested without adding an SDK runtime dependency. */
+export const DEFAULT_FILE_RESOURCE_MOUNT_ROOT = ".opengeni/files" as const;
+
 export type FileResourceRef = {
   kind: "file";
   fileId: string;
-  /** Optional workspace-relative override; defaults to `files/<file-id>`. */
+  /** Optional workspace-relative override; defaults to `.opengeni/files/<file-id>`. */
   mountPath?: string | undefined;
 };
 
@@ -641,6 +644,22 @@ export type OpenGeniSlackBotInstallStart = {
 export type GoogleDriveTargetScope = "user" | "workspace" | "organization";
 export type GoogleDriveSyncCadence = "manual" | "hourly" | "daily";
 export type GoogleDriveReadPolicy = "allow" | "ask" | "block";
+export type GoogleDriveConnectionLifecycleState =
+  | "active"
+  | "paused"
+  | "token_revoked"
+  | "app_removed"
+  | "disconnected"
+  | "reconnect_required"
+  | "reconsent_required";
+
+export type GoogleDriveConnectionLifecycle =
+  | {
+      state: Exclude<GoogleDriveConnectionLifecycleState, "app_removed">;
+      recoverable: true;
+      observedAt: string;
+    }
+  | { state: "app_removed"; recoverable: false; observedAt: string };
 
 export type GoogleDriveSelectedSource = {
   id: string;
@@ -661,6 +680,7 @@ export type GoogleDriveConnectionMetadata = {
   googleDisplayName: string | null;
   verifiedAt: string;
   accessMode: "metadata_readonly" | "readonly";
+  lifecycle?: GoogleDriveConnectionLifecycle | undefined;
   selectedSources?: GoogleDriveSelectedSource[] | undefined;
   /** @deprecated Read selectedSources; retained while existing connections migrate. */
   selectedSource?: GoogleDriveSelectedSource | null | undefined;
@@ -676,6 +696,16 @@ export type GoogleDriveOAuthStartResponse = {
   expiresAt: string;
 };
 
+export type GoogleDriveLifecycleActionRequest = {
+  action: "pause" | "resume";
+  expectedVersion: number;
+};
+
+export type GoogleDriveDisconnectRequest = {
+  expectedVersion: number;
+  idempotencyKey: string;
+};
+
 export type GoogleDriveBrowseItem = {
   id: string;
   name: string;
@@ -1000,8 +1030,6 @@ export type HumanInputQuestion = {
   allowOther: boolean;
   validation?:
     | {
-        minLength?: number | null | undefined;
-        maxLength?: number | null | undefined;
         minSelections?: number | null | undefined;
         maxSelections?: number | null | undefined;
       }
@@ -2104,6 +2132,7 @@ export type ModelCapabilitiesV1 = {
     codeExecution: ModelCapabilityStateV1;
   };
   inputModalities: Array<"text" | "image" | "audio">;
+  inputFileMediaTypes?: string[] | undefined;
   outputModalities: Array<"text" | "image" | "audio">;
   transports: {
     sse: ModelCapabilityStateV1;
@@ -3365,6 +3394,8 @@ export type KnowledgeSourceKind =
   | "other";
 export type DocumentSearchMode = "hybrid" | "vector" | "keyword";
 
+export type DocumentAuthorityKind = "organization" | "workspace" | "personal";
+
 export type DocumentVisibility = "workspace" | "private";
 
 export type DocumentCurationStatus = "none" | "pending" | "suggested" | "auto_filed" | "failed";
@@ -3406,6 +3437,9 @@ export type Document = {
   sourceUpdatedAt: string | null;
   sourceVersion: string | null;
   aclTags: string[];
+  authorityKind: DocumentAuthorityKind;
+  authorityWorkspaceId: string | null;
+  authoritySubjectId: string | null;
   visibility: DocumentVisibility;
   createdBy: string | null;
   agentAccess: boolean;
@@ -3440,6 +3474,9 @@ export type DocumentSearchResult = {
   sourceUpdatedAt: string | null;
   sourceVersion: string | null;
   aclTags: string[];
+  authorityKind: DocumentAuthorityKind;
+  authorityWorkspaceId: string | null;
+  authoritySubjectId: string | null;
 };
 
 export type CreateDocumentBaseRequest = {
@@ -3459,6 +3496,7 @@ export type AddDocumentRequest = {
   sourceUpdatedAt?: string | undefined;
   sourceVersion?: string | undefined;
   aclTags?: string[] | undefined;
+  authorityKind?: DocumentAuthorityKind | undefined;
   visibility?: DocumentVisibility | undefined;
   agentAccess?: boolean | undefined;
 };
@@ -3468,6 +3506,7 @@ export type CreateKnowledgeDropRequest = {
   fileId?: string | undefined;
   filename?: string | undefined;
   title?: string | undefined;
+  authorityKind?: DocumentAuthorityKind | undefined;
   visibility?: DocumentVisibility | undefined;
   agentAccess?: boolean | undefined;
 };

package/src/workspace-instruction-policies.ts

@@ -29,6 +29,7 @@ export type WorkspaceInstructionPolicyRevisionIdentity = {
 
 export type WorkspaceInstructionPolicyRevision = WorkspaceInstructionPolicyRevisionIdentity &
   WorkspaceInstructionPolicyTarget & {
+    operationId: string;
     accountId: string;
     workspaceId: string;
     content: string;
@@ -52,6 +53,7 @@ export type WorkspaceInstructionPolicyHead = WorkspaceInstructionPolicyTarget &
 
 export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPolicyTarget & {
   id: string;
+  operationId: string;
   accountId: string;
   workspaceId: string;
   type: WorkspaceInstructionPolicyActivationType;
@@ -64,6 +66,7 @@ export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPoli
 };
 
 export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionPolicyTarget & {
+  operationId?: string;
   content: string;
   provenanceSource?: WorkspaceInstructionPolicyDraftProvenanceSource;
   provenanceSourceId?: string | null;
@@ -71,6 +74,7 @@ export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionP
 };
 
 export type ImportLegacyWorkspaceInstructionPolicyDraftRequest = {
+  operationId?: string;
   supersedesRevisionId?: string | null;
 };
 
@@ -102,13 +106,17 @@ export type WorkspaceInstructionPolicyDiffResponse = {
 };
 
 export type ActivateWorkspaceInstructionPolicyRequest = {
+  operationId?: string;
   expectedCurrentRevisionId: string | null;
+  expectedActivationVersion?: number;
   reason: string;
 };
 
 export type RollbackWorkspaceInstructionPolicyRequest = {
+  operationId?: string;
   targetRevisionId: string;
   expectedCurrentRevisionId: string;
+  expectedActivationVersion?: number;
   reason: string;
 };
 
@@ -122,3 +130,8 @@ export type WorkspaceInstructionPolicyConflictResponse = {
   message: string;
   currentHead: WorkspaceInstructionPolicyHead | null;
 };
+
+export type WorkspaceInstructionPolicyOperationReuseResponse = {
+  code: "WORKSPACE_INSTRUCTION_POLICY_OPERATION_REUSED";
+  message: string;
+};