@opengeni/sdk 0.13.0 → 0.15.0

package/README.md

@@ -70,19 +70,41 @@ the explicit alternative: deliver now by interrupting the running turn.
 
 ```ts
 // Queue (default): stacks behind the running turn.
-await client.sendMessage(workspaceId, sessionId, "Also check the nginx config");
+await client.sendMessage(workspaceId, sessionId, {
+  text: "Also check the nginx config",
+  clientEventId: crypto.randomUUID(),
+});
 
 // Steer: send + promote to the queue front + interrupt the running turn.
-await client.steerMessage(workspaceId, sessionId, "Stop — prod is paging, look at that first");
+await client.steerMessage(workspaceId, sessionId, {
+  text: "Stop — prod is paging, look at that first",
+  clientEventId: crypto.randomUUID(),
+});
 
-// Manage the queue while it waits.
-const turns = await client.listTurns(workspaceId, sessionId);
-await client.updateQueuedTurn(workspaceId, sessionId, turnId, { prompt: "rewritten" });
-await client.reorderQueuedTurns(workspaceId, sessionId, [turnB, turnA]);
-await client.deleteQueuedTurn(workspaceId, sessionId, turnId);
+// Manage the server-authoritative queue while it waits.
+const queue = await client.getQueue(workspaceId, sessionId);
+const waiting = queue.items.at(-1)!;
+await client.moveQueueItem(workspaceId, sessionId, waiting.id, {
+  expectedQueueVersion: queue.version,
+  beforeTurnId: queue.items[0]?.id ?? null,
+  clientEventId: crypto.randomUUID(),
+});
+await client.editQueueItem(workspaceId, sessionId, waiting.id, {
+  expectedTurnVersion: waiting.version,
+  expectedDraftRevision: 0,
+  replaceDraft: false,
+  clientEventId: crypto.randomUUID(),
+});
 
-// Control events.
-await client.interrupt(workspaceId, sessionId, { reason: "stop and report" });
+// Pause/Resume is recursive workstream control; it creates no queue row.
+await client.pauseSession(workspaceId, sessionId, {
+  reason: "hold this workstream",
+  expectedControlEtag: queue.effectiveControl.controlEtag,
+});
+const paused = await client.getQueue(workspaceId, sessionId);
+await client.resumeSession(workspaceId, sessionId, {
+  expectedControlEtag: paused.effectiveControl.controlEtag,
+});
 await client.sendApprovalDecision(workspaceId, sessionId, { approvalId, decision: "approve" });
 ```
 
@@ -149,9 +171,9 @@ Every public endpoint group has typed methods:
 | Group | Methods |
 | --- | --- |
 | Access + workspaces | `getAccessContext`, `listWorkspaces`, `createWorkspace`, `getWorkspace`, `updateWorkspace` |
-| Sessions + events | `createSession`, `listSessions`, `getSession`, `updateSession`, `listEvents`, `sendEvent`, `sendMessage`, `steerMessage`, `interrupt`, `sendApprovalDecision`, `streamEvents`, `openEventStream` |
+| Sessions + events | `createSession`, `listSessions`, `getSession`, `updateSession`, `listEvents`, `sendEvent`, `sendMessage`, `steerMessage`, `pauseSession`, `resumeSession`, `sendApprovalDecision`, `streamEvents`, `openEventStream` |
 | Machines (bring-your-own-compute) | `listMachines`, `machineMetricsSeries`, `swapActiveSandbox`, `mintEnrollToken`, `lookupDeviceEnrollment`, `approveDeviceEnrollment`, `denyDeviceEnrollment` |
-| Turn queue | `listTurns`, `updateQueuedTurn`, `reorderQueuedTurns`, `deleteQueuedTurn` |
+| Turn queue | `getQueue`, `moveQueueItem`, `editQueueItem`, `steerQueueItem`, `deleteQueueItem` |
 | Goal | `getGoal`, `updateGoal`, `pauseGoal`, `resumeGoal` |
 | Scheduled tasks | `createScheduledTask`, `listScheduledTasks`, `getScheduledTask`, `updateScheduledTask`, `pauseScheduledTask`, `resumeScheduledTask`, `triggerScheduledTask`, `deleteScheduledTask`, `listScheduledTaskRuns` |
 | Variable sets | `listVariable sets`, `createVariable set`, `getVariable set`, `updateVariable set`, `deleteVariable set`, `setVariable setVariable`, `deleteVariable setVariable` (values are write-only) |

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type SessionStatus = "queued" | "running" | "idle" | "requires_action" | "recovering" | "waiting_capacity" | "paused" | "failed" | "cancelled";
+type SessionStatus = "queued" | "running" | "idle" | "requires_action" | "recovering" | "waiting_capacity" | "failed" | "cancelled";
 type SandboxBackend = "docker" | "modal" | "local" | "none" | "daytona" | "runloop" | "e2b" | "blaxel" | "cloudflare" | "vercel" | "selfhosted";
 type SandboxOs = "linux" | "macos" | "windows";
 type SandboxCapabilityName = "FileSystem" | "Terminal" | "Git" | "DesktopStream" | "Recording";
@@ -287,12 +287,7 @@ type Session = {
     queueVersion: number;
     queueHeadPosition: number;
     queueTailPosition: number;
-    controlState: "active" | "paused";
-    controlGeneration: number;
-    controlReason: string | null;
-    controlChangedBy: string | null;
-    controlChangedAt: string | null;
-    workspaceRunExceptionGeneration: number | null;
+    effectiveControl: EffectiveSessionControl;
     lastSequence: number;
     /** Multi-account Codex (P1): the account this session is pinned to (null ⇒ follow workspace active). */
     codexPinnedCredentialId?: string | null;
@@ -337,7 +332,7 @@ type SessionLineageResponse = {
     children: LineageNode[];
     truncated: boolean;
 };
-type SessionTurnStatus = "queued" | "running" | "requires_action" | "recovering" | "waiting_capacity" | "completed" | "failed" | "cancelled" | "superseded";
+type SessionTurnStatus = "queued" | "running" | "requires_action" | "recovering" | "waiting_capacity" | "completed" | "failed" | "cancelled" | "superseded" | "withdrawn_for_edit";
 type SessionTurnSource = "user" | "scheduled_task" | "api" | "goal" | "system" | "compaction";
 type SessionTurn = {
     id: string;
@@ -367,7 +362,7 @@ type SessionTurn = {
     createdAt: string;
     updatedAt: string;
 };
-declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.status.changed", "session.requiresAction", "session.context.compaction.requested", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "turn.queued", "turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.superseded", "turn.recovery.requested", "turn.capacity_waiting", "agent.message.delta", "agent.message.completed", "agent.reasoning.delta", "agent.toolCall.created", "agent.toolCall.output", "agent.model.usage", "tool.auth_needed", "agent.updated", "rig.setup.started", "rig.setup.completed", "rig.setup.skipped", "rig.setup.failed", "sandbox.operation.started", "sandbox.operation.completed", "sandbox.operation.failed", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.continuation", "system.update.pending", "system.update.delivered", "session.control.paused", "session.control.resumed", "session.control.steer_requested", "workspace.inference.paused", "workspace.inference.resumed", "session.queue.prompt.cancelled", "session.queue.history", "turn.event.rejected_late", "memory.saved", "memory.corrected", "stream.url.rotated", "stream.opened", "stream.closed", "stream.revoked", "recording.started", "recording.available", "recording.failed", "fs.changed", "git.changed", "terminal.pty.started", "terminal.pty.output.delta", "terminal.pty.exited", "session.title_set", "codex.account.switched", "codex.credential.selected", "codex.capacity.waiting", "codex.capacity.resumed", "codex.capacity.superseded", "sandbox.box.created", "sandbox.box.lost", "sandbox.box.terminated", "sandbox.box.snapshot", "sandbox.env.drift", "session.route.reconciled", "workspace.revision.captured", "workspace.revision.degraded", "machine.op.failed", "machine.op.recovered", "machine.link.lost", "machine.link.restored", "machine.runner.restarted"];
+declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.status.changed", "session.requiresAction", "session.context.compaction.requested", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "turn.queued", "turn.started", "turn.completed", "turn.failed", "turn.cancelled", "turn.superseded", "turn.recovery.requested", "turn.capacity_waiting", "agent.message.delta", "agent.message.completed", "agent.reasoning.delta", "agent.toolCall.created", "agent.toolCall.output", "agent.model.usage", "tool.auth_needed", "agent.updated", "rig.setup.started", "rig.setup.completed", "rig.setup.skipped", "rig.setup.failed", "sandbox.operation.started", "sandbox.operation.completed", "sandbox.operation.failed", "sandbox.command.output.delta", "artifact.created", "goal.set", "goal.updated", "goal.completed", "goal.paused", "goal.resumed", "goal.cleared", "goal.continuation", "system.update.pending", "system.update.delivered", "session.control.paused", "session.control.resumed", "session.control.steer_requested", "workspace.inference.paused", "workspace.inference.resumed", "session.queue.changed", "session.queue.prompt.cancelled", "session.queue.history", "turn.event.rejected_late", "memory.saved", "memory.corrected", "stream.url.rotated", "stream.opened", "stream.closed", "stream.revoked", "recording.started", "recording.available", "recording.failed", "fs.changed", "git.changed", "terminal.pty.started", "terminal.pty.output.delta", "terminal.pty.exited", "session.title_set", "codex.account.switched", "codex.credential.selected", "codex.capacity.waiting", "codex.capacity.resumed", "codex.capacity.superseded", "sandbox.box.created", "sandbox.box.lost", "sandbox.box.terminated", "sandbox.box.snapshot", "sandbox.env.drift", "session.route.reconciled", "workspace.revision.captured", "workspace.revision.degraded", "machine.op.failed", "machine.op.recovered", "machine.link.lost", "machine.link.restored", "machine.runner.restarted"];
 type KnownSessionEventType = (typeof SESSION_EVENT_TYPES)[number];
 /**
  * Event types the SDK knows about today, kept open so a newer OpenGeni server
@@ -1068,6 +1063,8 @@ type ClientAuthConfig = {
     mode: "managedSession";
     session: "cookie";
 };
+declare const OPENGENI_API_CONTRACT_REVISION: "2026-07-session-control-v1";
+declare const OPENGENI_API_CONTRACT_HEADER: "x-opengeni-api-contract";
 /**
  * Public, unauthenticated-by-default client bootstrap config returned by
  * `GET /v1/config/client`: which models + reasoning efforts are exposed, the
@@ -1077,6 +1074,8 @@ type ClientAuthConfig = {
  */
 type ClientConfig = {
     deploymentRevision: string;
+    apiContractRevision: typeof OPENGENI_API_CONTRACT_REVISION;
+    serverVersion?: string | undefined;
     defaultModel: string;
     allowedModels: string[];
     models: ClientModel[];
@@ -1133,11 +1132,13 @@ type Workspace = {
     externalId: string | null;
     agentInstructions: string | null;
     settings: Record<string, unknown>;
-    inferenceState?: "active" | "paused";
-    inferenceGeneration?: number;
-    inferenceReason?: string | null;
-    inferenceChangedBy?: string | null;
-    inferenceChangedAt?: string | null;
+    inferenceControl: {
+        state: "active" | "paused";
+        revision: number;
+        reason: string | null;
+        changedBy: string | null;
+        changedAt: string | null;
+    };
     defaultRigId?: string | null;
     createdAt: string;
     updatedAt: string;
@@ -1246,18 +1247,71 @@ type CompactSessionContextResult = {
     status: "pending" | "completed" | "noop";
     message: string;
 };
+type EffectiveControlBlocker = {
+    kind: "session" | "workspace";
+    sessionId?: string | undefined;
+    displayName: string;
+    actor: string | null;
+    reason: string | null;
+    changedAt: string | null;
+    revision: number;
+};
+type EffectiveControlResumeOption = {
+    scope: "selected" | "session" | "workspace";
+    targetId?: string | undefined;
+    selectedStateAfter: "active" | "paused";
+    remainingPrimaryBlocker?: EffectiveControlBlocker | undefined;
+    impactCopy: string;
+};
+type EffectiveSessionControl = {
+    state: "active" | "paused";
+    controlVersion: number;
+    controlEtag: string;
+    directState: "active" | "paused";
+    primaryBlocker: EffectiveControlBlocker | null;
+    additionalBlockerCount: number;
+    blockers: EffectiveControlBlocker[];
+    resumeOptions: EffectiveControlResumeOption[];
+    override: {
+        rootSessionId: string;
+        revision: number;
+    } | null;
+    settlement: {
+        state: "stopping";
+        attemptCount: number;
+    } | null;
+};
+type SessionCommandReceipt = {
+    id: string;
+    action: string;
+    operationKey: string;
+    targetSessionId: string | null;
+    targetTurnId: string | null;
+    appliedControlRevision: number | null;
+    appliedQueueVersion: number | null;
+    appliedTurnVersion: number | null;
+    appliedDraftRevision: number | null;
+    createdAt: string;
+};
+type ComposerDraft = {
+    revision: number;
+    text: string;
+    resources: ResourceRef[];
+    tools: ToolRef[];
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    sourceTurnId: string | null;
+    sourceTurnVersion: number | null;
+    updatedAt: string | null;
+};
 type SessionQueueSnapshot = {
     version: number;
-    controlState: "active" | "paused";
-    controlGeneration: number;
-    workspaceInferenceState: "active" | "paused";
-    workspaceInferenceGeneration: number;
-    workspaceRunExceptionGeneration: number | null;
+    effectiveControl: EffectiveSessionControl;
     items: SessionTurn[];
 };
 type SystemUpdateClassification = "success" | "failure" | "action_required" | "info";
-type SessionSystemUpdateKind = "child_session_update" | "scheduled_wake" | "lifecycle_event" | "runtime_notice";
-type SessionSystemUpdateState = "pending" | "deferred" | "delivered" | "cancelled" | "failed";
+type SessionSystemUpdateKind = "scheduled_occurrence" | "goal_continuation" | "agent_message" | "agent_steer_instruction" | "child_terminal_result";
+type SessionSystemUpdateState = "pending" | "deferred" | "delivered" | "cancelled" | "superseded" | "failed";
 type SessionSystemUpdate = {
     id: string;
     sessionId: string;
@@ -1274,29 +1328,61 @@ type SessionSystemUpdate = {
     createdAt: string;
 };
 type SessionControlResponse = {
-    operationId: string;
-    event: SessionEvent;
-    controlState: "active" | "paused";
-    controlGeneration: number;
-    expectedActiveTurnId: string | null;
-    expectedExecutionGeneration: number | null;
-    expectedAttemptId: string | null;
-    deliveryEventId: string | null;
-    shouldSignalControl: boolean;
-    shouldWake: boolean;
+    receipt: SessionCommandReceipt;
+    effectiveControl: EffectiveSessionControl;
+    interruptionCount: number;
+    wakeCount: number;
 };
 type WorkspaceInferenceControlResponse = {
-    operationId: string;
+    receipt: SessionCommandReceipt;
     state: "active" | "paused";
-    generation: number;
-    affectedSessionIds: string[];
-    controlSessionIds: string[];
-    exceptionSessionIds: string[];
+    revision: number;
+    interruptionCount: number;
+    wakeCount: number;
+};
+type WorkspaceControlEvent = {
+    id: string;
+    workspaceId: string;
+    /** Same monotonic value as revision; named sequence for SSE resume cursors. */
+    sequence: number;
+    revision: number;
+    type: "workspace.control.changed";
+    scope: "workspace" | "session";
+    rootSessionId: string | null;
+    action: "pause" | "resume";
+    automatic: boolean;
+    reason: string | null;
+    actor: string;
+    occurredAt: string;
 };
 type SessionQueueMutationResponse = {
+    receipt: SessionCommandReceipt;
     snapshot: SessionQueueSnapshot;
-    events: SessionEvent[];
-    shouldWake: boolean;
+    draft?: ComposerDraft;
+};
+type MoveSessionQueueItemRequest = {
+    clientEventId: string;
+    expectedQueueVersion: number;
+    beforeTurnId: string | null;
+};
+type EditSessionQueueItemRequest = {
+    clientEventId: string;
+    expectedTurnVersion: number;
+    expectedDraftRevision: number;
+    replaceDraft: boolean;
+};
+type SteerSessionQueueItemRequest = {
+    clientEventId: string;
+    expectedTurnVersion: number;
+    controlEtag?: string;
+};
+type DeleteSessionQueueItemRequest = {
+    clientEventId: string;
+    expectedTurnVersion: number;
+    reason?: string;
+};
+type SaveComposerDraftRequest = Omit<ComposerDraft, "revision" | "sourceTurnId" | "sourceTurnVersion" | "updatedAt"> & {
+    expectedRevision: number;
 };
 /** Input shape for agent config on create/update (server applies defaults). */
 type ScheduledTaskAgentConfigInput = {
@@ -2239,6 +2325,8 @@ type StreamSessionEventsOptions = {
      * reconnects = N+1 total open-stream calls). Defaults to unlimited.
      */
     maxReconnectAttempts?: number;
+    /** Await authoritative client reconciliation before exposing `live`. */
+    beforeLive?: (() => void | Promise<void>) | undefined;
     onStateChange?: (state: StreamConnectionState) => void;
 };
 /**
@@ -2258,6 +2346,17 @@ type StreamSessionEventsOptions = {
  */
 declare function streamSessionEvents(transport: SessionEventStreamTransport, options?: StreamSessionEventsOptions): AsyncGenerator<SessionEvent, void, void>;
 
+type WorkspaceControlStreamTransport = {
+    /** The server replays every durable event after the cursor before going live. */
+    openStream: (after: number, signal: AbortSignal | undefined) => Promise<ReadableStream<Uint8Array>>;
+};
+/**
+ * Reconnecting workspace invalidation stream. Control revisions are monotonic
+ * but can begin above one after the one-way migration, so unlike conversation
+ * events this stream intentionally permits sparse sequence values.
+ */
+declare function streamWorkspaceControlEvents(transport: WorkspaceControlStreamTransport, options?: StreamSessionEventsOptions): AsyncGenerator<WorkspaceControlEvent, void, void>;
+
 type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 type OpenGeniClientOptions = {
     /** Base URL of the OpenGeni API, e.g. `https://api.example.com`. */
@@ -2276,8 +2375,8 @@ type SendMessageInput = {
     model?: string;
     reasoningEffort?: ReasoningEffort;
     clientEventId?: string;
-    expectedControlGeneration?: number;
-    expectedWorkspaceInferenceGeneration?: number;
+    controlEtag?: string;
+    expectedDraftRevision?: number;
     mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[];
 };
 type SteerMessageResult = {
@@ -2396,7 +2495,8 @@ declare class OpenGeniClient {
     pauseSession(workspaceId: string, sessionId: string, options?: {
         reason?: string;
         clientEventId?: string;
-    }): Promise<SessionEvent>;
+        expectedControlEtag?: string;
+    }): Promise<SessionControlResponse>;
     sendApprovalDecision(workspaceId: string, sessionId: string, decision: {
         approvalId: string;
         decision: "approve" | "reject";
@@ -2417,33 +2517,39 @@ declare class OpenGeniClient {
         signal?: AbortSignal;
     }): Promise<ReadableStream<Uint8Array>>;
     getQueue(workspaceId: string, sessionId: string): Promise<SessionQueueSnapshot>;
-    cancelQueueItem(workspaceId: string, sessionId: string, turnId: string, request: {
-        expectedQueueVersion: number;
-        expectedItemVersion: number;
-        reason?: string;
-    }): Promise<SessionQueueMutationResponse>;
+    moveQueueItem(workspaceId: string, sessionId: string, turnId: string, request: MoveSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+    editQueueItem(workspaceId: string, sessionId: string, turnId: string, request: EditSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+    steerQueueItem(workspaceId: string, sessionId: string, turnId: string, request: SteerSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+    deleteQueueItem(workspaceId: string, sessionId: string, turnId: string, request: DeleteSessionQueueItemRequest): Promise<SessionQueueMutationResponse>;
+    getComposerDraft(workspaceId: string, sessionId: string): Promise<ComposerDraft>;
+    saveComposerDraft(workspaceId: string, sessionId: string, request: SaveComposerDraftRequest): Promise<ComposerDraft>;
     controlSession(workspaceId: string, sessionId: string, request: {
-        mode: "pause" | "resume";
+        action: "pause" | "resume";
         reason?: string;
-        clientEventId?: string;
-        expectedControlState?: "active" | "paused";
-        expectedControlGeneration?: number;
-        expectedWorkspaceInferenceGeneration?: number;
+        clientEventId: string;
+        expectedControlEtag?: string;
     }): Promise<SessionControlResponse>;
     resumeSession(workspaceId: string, sessionId: string, options?: {
         reason?: string;
         clientEventId?: string;
+        expectedControlEtag?: string;
     }): Promise<SessionControlResponse>;
     setWorkspaceInferenceState(workspaceId: string, request: {
-        state: "active" | "paused";
-        reason: string;
+        action: "pause" | "resume";
+        reason?: string;
         clientEventId: string;
-        expectedState: "active" | "paused";
-        expectedGeneration: number;
-        exceptSessionIds?: string[];
+        expectedRevision?: number;
     }): Promise<WorkspaceInferenceControlResponse>;
-    /** Cancel a queued turn before it is claimed. Returns the cancelled turn. */
-    deleteQueuedTurn(workspaceId: string, sessionId: string, turnId: string): Promise<SessionTurn>;
+    listWorkspaceControlEvents(workspaceId: string, options?: {
+        after?: number;
+        limit?: number;
+    }): Promise<WorkspaceControlEvent[]>;
+    streamWorkspaceControlEvents(workspaceId: string, options?: StreamSessionEventsOptions): AsyncGenerator<WorkspaceControlEvent, void, void>;
+    workspaceControlStreamTransport(workspaceId: string): WorkspaceControlStreamTransport;
+    openWorkspaceControlEventStream(workspaceId: string, options?: {
+        after?: number;
+        signal?: AbortSignal;
+    }): Promise<ReadableStream<Uint8Array>>;
     /**
      * Steer: atomically put this prompt at the head and supersede the current
      * inference. The client performs one request and renders server order.
@@ -2786,6 +2892,12 @@ declare class OpenGeniApiError extends Error {
     readonly body: string;
     constructor(status: number, body: string);
 }
+/** The browser bundle and API disagree about their state-changing wire contract. */
+declare class OpenGeniApiContractMismatchError extends Error {
+    readonly expected: string;
+    readonly actual: string;
+    constructor(expected: string, actual: string);
+}
 /** Error for an unrecoverable event-stream condition (not a transient drop). */
 declare class OpenGeniStreamError extends Error {
     constructor(message: string);
@@ -2995,4 +3107,4 @@ declare function ttydInputFrame(data: string): string;
 /** Build a client→server RESIZE frame: "1" + JSON.stringify({ columns, rows }). */
 declare function ttydResizeFrame(columns: number, rows: number): string;
 
-export { type AccessContext, type AccessGrant, type AccountGrant, type AccountRole, type AcknowledgeStreamRequest, type AcknowledgeStreamResponse, type AddDocumentRequest, type AddWorkspaceMemberRequest, type AgentMessageCompletedPayload, type AgentTextDeltaPayload, type AgentToolCallCreatedPayload, type AgentToolCallOutputPayload, type ApiKey, type AttachViewerRequest, type AttachViewerResponse, type BillingBalance, type BillingEntitlementsResponse, type BillingMode, type BillingSummary, type BillingUsageResponse, type CapabilityCatalogItem, type CapabilityCatalogResponse, type CapabilityInstallation, type CapabilityInstallationStatus, type CapabilityKind, type CapabilityPack, type CapabilityPackConnector, type CapabilityPackConnectorAuthModel, type CapabilityPackKnowledge, type CapabilityPackScheduledTaskTemplate, type CapabilityPackSkill, type CapabilityPackSkillFile, type CapabilityPackVariableSetSpec, type CapabilityRuntime, type CapabilitySource, type CapabilityUnavailableReason, type ClientAuthConfig, type ClientConfig, type ClientModel, type ClientSessionEventInput, type CodexAccount, type CodexAccountSwitchedPayload, type CodexAccountsResponse, type CodexConnectPoll, type CodexConnectStart, type CodexConnectionStatus, type CodexRotationSettings, type CodexUsage, type CodexUsageMap, type CodexUsagePayload, type CodexUsageWindow, type CompactSessionContextResult, type CompleteFileUploadResponse, type ComputerUseCapability, type ConnectionKind, type ConnectionMetadata, type ConnectionResponse, type ConnectionStatus, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateCapabilityCatalogItemRequest, type CreateCheckoutRequest, type CreateCheckoutResponse, type CreateConnectionRequest, type CreateDocumentBaseRequest, type CreateFileUploadRequest, type CreateFileUploadResponse, type CreateGitHubAppManifestRequest, type CreateGitHubAppManifestResponse, type CreateKnowledgeMemoryRequest, type CreateRigRequest, type CreateScheduledTaskRequest, type CreateSessionRequest, type CreateVariableSetRequest, type CreateWorkspaceEnvironmentRequest, type CreateWorkspaceRequest, type DesktopConnectionState, type DesktopRfbFactory, type DesktopRfbLike, type DesktopStreamCapability, type DesktopStreamEvent, type DeviceEnrollmentApproveRequest, type DeviceEnrollmentApproveResponse, type DeviceEnrollmentDenyRequest, type DeviceEnrollmentDenyResponse, type DeviceEnrollmentLookupMachine, type DeviceEnrollmentLookupRequest, type DeviceEnrollmentLookupResponse, type DiscoverMcpCapabilitiesResponse, type Document, type DocumentBase, type DocumentSearchMode, type DocumentSearchRequest, type DocumentSearchResponse, type DocumentSearchResult, type DocumentStatus, type EnableCapabilityRequest, type EnablePackRequest, type EnrollTokenExchangeRequest, type EnrollTokenExchangeResponse, type EnrollmentCredentials, type EnrollmentOs, type EntitlementValue, type Entitlements, type EntitlementsMode, type FetchLike, type FileAsset, type FileDownloadUrlResponse, type FileResourceRef, type FileStatus, type FileSystemCapability, type FileUploadData, type FsChangeKind, type FsChangedPayload, type FsDeleteRequest, type FsDeleteResponse, type FsEncoding, type FsListRequest, type FsListResponse, type FsMkdirRequest, type FsMkdirResponse, type FsMoveRequest, type FsMoveResponse, type FsNodeType, type FsReadRequest, type FsReadResponse, type FsTreeNode, type FsWriteRequest, type FsWriteResponse, type GetPackResponse, type GetWorkspaceCaptureFileResponse, type GetWorkspaceCaptureResponse, type GitCapability, type GitChangedPayload, type GitCommit, type GitCredentialProvider, type GitDiffHunk, type GitDiffLine, type GitDiffLineType, type GitDiffRequest, type GitDiffResponse, type GitFileDiff, type GitFileStatus, type GitFileStatusCode, type GitHubAppInfo, type GitHubRepositoriesResponse, type GitHubRepository, type GitLogRequest, type GitLogResponse, type GitShowRequest, type GitShowResponse, type GitStatusRequest, type GitStatusResponse, type GoalSpec, type IntegrationClientMetadata, KNOWN_PERMISSIONS, KNOWN_USAGE_EVENT_TYPES, type KnowledgeMemory, type KnowledgeMemoryKind, type KnowledgeMemorySearchRequest, type KnowledgeMemoryStatus, type KnowledgeSourceKind, type KnowledgeSourceRef, type KnownPermission, type KnownSessionEventType, type KnownUsageEventType, type LineageNode, type ListApiKeysResponse, type ListConnectionsResponse, type ListPacksResponse, type ListWorkspaceMembersResponse, type MachineKind, type MachineMetricsSeriesResponse, type MachineState, type MachineView, type MachinesResponse, type McpServerConnectionRef, type MetricSample, type MintEnrollTokenRequest, type MintEnrollTokenResponse, type OAuthStartRequest, type OAuthStartResponse, OpenGeniApiError, OpenGeniClient, type OpenGeniClientOptions, OpenGeniStreamError, type PackInstallation, type PackInstallationStatus, type Permission, type ProductAccessMode, type ProposeRigChangeRequest, type ProxySessionEventStreamOptions, type PtyCloseRequest, type PtyOpenRequest, type PtyOpenResponse, type PtyResizeRequest, type PtyWriteRequest, type ReasoningEffort, type RecordingAvailablePayload, type RecordingCapability, type RecordingCodec, type RecordingContentType, type RecordingFailedPayload, type RecordingFailedReason, type RecordingMode, type RecordingStartedPayload, type RegisterCapabilityPackRequest, type RepositoryResourceRef, type ResourceRef, type Rig, type RigChange, type RigChangeKind, type RigChangeStatus, type RigChangeVerification, type RigCheck, type RigCheckResult, type RigDefinitionEditPayload, type RigSetupAppendPayload, type RigVersion, SESSION_EVENT_TYPES, type SandboxBackend, type SandboxCapabilityName, type SandboxCommandOutputDeltaPayload, type SandboxOs, type ScheduledTask, type ScheduledTaskAgentConfig, type ScheduledTaskAgentConfigInput, type ScheduledTaskDayOfWeek, type ScheduledTaskOverlapPolicy, type ScheduledTaskRun, type ScheduledTaskRunMode, type ScheduledTaskRunStatus, type ScheduledTaskScheduleSpec, type ScheduledTaskStatus, type ScheduledTaskTriggerType, type SendMessageInput, type Session, type SessionCapabilities, type SessionControlResponse, type SessionEvent, type SessionEventStreamTransport, type SessionEventType, type SessionGoal, type SessionGoalCreatedBy, type SessionGoalStatus, type SessionLineageResponse, type SessionListResponse, type SessionMcpCredentialUpdateInput, type SessionMcpServerInput, type SessionMcpServerMetadata, type SessionQueueMutationResponse, type SessionQueueSnapshot, type SessionStatus, type SessionStatusChangedPayload, type SessionStructuredCapabilities, type SessionSummary, type SessionSystemUpdate, type SessionSystemUpdateKind, type SessionSystemUpdateState, type SessionTurn, type SessionTurnSource, type SessionTurnStatus, type SetWorkspaceEnvironmentVariableRequest, type SseMessage, type SseReStreamOptions, type SteerMessageResult, type StreamClosedPayload, type StreamConnectionState, type StreamOpenedPayload, type StreamRevokedPayload, type StreamSessionEventsOptions, type StreamUrlRotatedPayload, type SwapActiveSandboxRequest, type SwapActiveSandboxResponse, TTYD_SUBPROTOCOL, type TerminalCapability, type TerminalExecRequest, type TerminalExecResponse, type TerminalPtyExitedPayload, type TerminalPtyOutputDeltaPayload, type TerminalPtyStartedPayload, type ToolAuthNeededPayload, type ToolRef, TtydClientCommand, TtydServerCommand, type UpdateConnectionRequest, type UpdateKnowledgeMemoryRequest, type UpdateRigRequest, type UpdateScheduledTaskRequest, type UpdateSessionGoalRequest, type UpdateSessionPinRequest, type UpdateSessionRequest, type UpdateVariableSetRequest, type UpdateWorkspaceEnvironmentRequest, type UpdateWorkspaceMemberRequest, type UpdateWorkspaceRequest, type UpdateWorkspaceSettingsRequest, type UploadFileInput, type UsageEvent, type UsageEventType, type UserApprovalDecisionEventInput, type UserMessageEventInput, type VariableSet, type VariableSetVariableMetadata, type ViewerHeartbeatRequest, type ViewerHeartbeatResponse, type ViewerHolder, type Workspace, type WorkspaceCaptureDegradedReason, type WorkspaceCaptureFile, type WorkspaceCaptureManifest, type WorkspaceCaptureRepo, type WorkspaceCaptureSignedUrl, type WorkspaceCaptureStats, type WorkspaceEnvironment, type WorkspaceEnvironmentVariableMetadata, type WorkspaceInferenceControlResponse, type WorkspaceMember, type WorkspaceMemorySearchMode, type WorkspaceMemorySearchRequest, type WorkspaceMemorySearchResponse, type WorkspaceMemorySearchResult, type WorkspaceRegisteredPack, type WorkspaceRevisionCapturedPayload, type WorkspaceRevisionDegradedPayload, type WorkspaceSettings, applyUrlRotation, desktopSocketUrl, formatSseEvent, isRetryableStreamError, nextDesktopState, parseSseStream, proxySessionEventStream, resumeSequenceFromRequest, sessionEventsToSseResponse, sessionEventsToSseStream, streamSessionEvents, terminalSocketUrl, ttydAuthFrame, ttydInputFrame, ttydResizeFrame };
+export { type AccessContext, type AccessGrant, type AccountGrant, type AccountRole, type AcknowledgeStreamRequest, type AcknowledgeStreamResponse, type AddDocumentRequest, type AddWorkspaceMemberRequest, type AgentMessageCompletedPayload, type AgentTextDeltaPayload, type AgentToolCallCreatedPayload, type AgentToolCallOutputPayload, type ApiKey, type AttachViewerRequest, type AttachViewerResponse, type BillingBalance, type BillingEntitlementsResponse, type BillingMode, type BillingSummary, type BillingUsageResponse, type CapabilityCatalogItem, type CapabilityCatalogResponse, type CapabilityInstallation, type CapabilityInstallationStatus, type CapabilityKind, type CapabilityPack, type CapabilityPackConnector, type CapabilityPackConnectorAuthModel, type CapabilityPackKnowledge, type CapabilityPackScheduledTaskTemplate, type CapabilityPackSkill, type CapabilityPackSkillFile, type CapabilityPackVariableSetSpec, type CapabilityRuntime, type CapabilitySource, type CapabilityUnavailableReason, type ClientAuthConfig, type ClientConfig, type ClientModel, type ClientSessionEventInput, type CodexAccount, type CodexAccountSwitchedPayload, type CodexAccountsResponse, type CodexConnectPoll, type CodexConnectStart, type CodexConnectionStatus, type CodexRotationSettings, type CodexUsage, type CodexUsageMap, type CodexUsagePayload, type CodexUsageWindow, type CompactSessionContextResult, type CompleteFileUploadResponse, type ComposerDraft, type ComputerUseCapability, type ConnectionKind, type ConnectionMetadata, type ConnectionResponse, type ConnectionStatus, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateCapabilityCatalogItemRequest, type CreateCheckoutRequest, type CreateCheckoutResponse, type CreateConnectionRequest, type CreateDocumentBaseRequest, type CreateFileUploadRequest, type CreateFileUploadResponse, type CreateGitHubAppManifestRequest, type CreateGitHubAppManifestResponse, type CreateKnowledgeMemoryRequest, type CreateRigRequest, type CreateScheduledTaskRequest, type CreateSessionRequest, type CreateVariableSetRequest, type CreateWorkspaceEnvironmentRequest, type CreateWorkspaceRequest, type DeleteSessionQueueItemRequest, type DesktopConnectionState, type DesktopRfbFactory, type DesktopRfbLike, type DesktopStreamCapability, type DesktopStreamEvent, type DeviceEnrollmentApproveRequest, type DeviceEnrollmentApproveResponse, type DeviceEnrollmentDenyRequest, type DeviceEnrollmentDenyResponse, type DeviceEnrollmentLookupMachine, type DeviceEnrollmentLookupRequest, type DeviceEnrollmentLookupResponse, type DiscoverMcpCapabilitiesResponse, type Document, type DocumentBase, type DocumentSearchMode, type DocumentSearchRequest, type DocumentSearchResponse, type DocumentSearchResult, type DocumentStatus, type EditSessionQueueItemRequest, type EffectiveControlBlocker, type EffectiveControlResumeOption, type EffectiveSessionControl, type EnableCapabilityRequest, type EnablePackRequest, type EnrollTokenExchangeRequest, type EnrollTokenExchangeResponse, type EnrollmentCredentials, type EnrollmentOs, type EntitlementValue, type Entitlements, type EntitlementsMode, type FetchLike, type FileAsset, type FileDownloadUrlResponse, type FileResourceRef, type FileStatus, type FileSystemCapability, type FileUploadData, type FsChangeKind, type FsChangedPayload, type FsDeleteRequest, type FsDeleteResponse, type FsEncoding, type FsListRequest, type FsListResponse, type FsMkdirRequest, type FsMkdirResponse, type FsMoveRequest, type FsMoveResponse, type FsNodeType, type FsReadRequest, type FsReadResponse, type FsTreeNode, type FsWriteRequest, type FsWriteResponse, type GetPackResponse, type GetWorkspaceCaptureFileResponse, type GetWorkspaceCaptureResponse, type GitCapability, type GitChangedPayload, type GitCommit, type GitCredentialProvider, type GitDiffHunk, type GitDiffLine, type GitDiffLineType, type GitDiffRequest, type GitDiffResponse, type GitFileDiff, type GitFileStatus, type GitFileStatusCode, type GitHubAppInfo, type GitHubRepositoriesResponse, type GitHubRepository, type GitLogRequest, type GitLogResponse, type GitShowRequest, type GitShowResponse, type GitStatusRequest, type GitStatusResponse, type GoalSpec, type IntegrationClientMetadata, KNOWN_PERMISSIONS, KNOWN_USAGE_EVENT_TYPES, type KnowledgeMemory, type KnowledgeMemoryKind, type KnowledgeMemorySearchRequest, type KnowledgeMemoryStatus, type KnowledgeSourceKind, type KnowledgeSourceRef, type KnownPermission, type KnownSessionEventType, type KnownUsageEventType, type LineageNode, type ListApiKeysResponse, type ListConnectionsResponse, type ListPacksResponse, type ListWorkspaceMembersResponse, type MachineKind, type MachineMetricsSeriesResponse, type MachineState, type MachineView, type MachinesResponse, type McpServerConnectionRef, type MetricSample, type MintEnrollTokenRequest, type MintEnrollTokenResponse, type MoveSessionQueueItemRequest, type OAuthStartRequest, type OAuthStartResponse, OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION, OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniClient, type OpenGeniClientOptions, OpenGeniStreamError, type PackInstallation, type PackInstallationStatus, type Permission, type ProductAccessMode, type ProposeRigChangeRequest, type ProxySessionEventStreamOptions, type PtyCloseRequest, type PtyOpenRequest, type PtyOpenResponse, type PtyResizeRequest, type PtyWriteRequest, type ReasoningEffort, type RecordingAvailablePayload, type RecordingCapability, type RecordingCodec, type RecordingContentType, type RecordingFailedPayload, type RecordingFailedReason, type RecordingMode, type RecordingStartedPayload, type RegisterCapabilityPackRequest, type RepositoryResourceRef, type ResourceRef, type Rig, type RigChange, type RigChangeKind, type RigChangeStatus, type RigChangeVerification, type RigCheck, type RigCheckResult, type RigDefinitionEditPayload, type RigSetupAppendPayload, type RigVersion, SESSION_EVENT_TYPES, type SandboxBackend, type SandboxCapabilityName, type SandboxCommandOutputDeltaPayload, type SandboxOs, type SaveComposerDraftRequest, type ScheduledTask, type ScheduledTaskAgentConfig, type ScheduledTaskAgentConfigInput, type ScheduledTaskDayOfWeek, type ScheduledTaskOverlapPolicy, type ScheduledTaskRun, type ScheduledTaskRunMode, type ScheduledTaskRunStatus, type ScheduledTaskScheduleSpec, type ScheduledTaskStatus, type ScheduledTaskTriggerType, type SendMessageInput, type Session, type SessionCapabilities, type SessionCommandReceipt, type SessionControlResponse, type SessionEvent, type SessionEventStreamTransport, type SessionEventType, type SessionGoal, type SessionGoalCreatedBy, type SessionGoalStatus, type SessionLineageResponse, type SessionListResponse, type SessionMcpCredentialUpdateInput, type SessionMcpServerInput, type SessionMcpServerMetadata, type SessionQueueMutationResponse, type SessionQueueSnapshot, type SessionStatus, type SessionStatusChangedPayload, type SessionStructuredCapabilities, type SessionSummary, type SessionSystemUpdate, type SessionSystemUpdateKind, type SessionSystemUpdateState, type SessionTurn, type SessionTurnSource, type SessionTurnStatus, type SetWorkspaceEnvironmentVariableRequest, type SseMessage, type SseReStreamOptions, type SteerMessageResult, type SteerSessionQueueItemRequest, type StreamClosedPayload, type StreamConnectionState, type StreamOpenedPayload, type StreamRevokedPayload, type StreamSessionEventsOptions, type StreamUrlRotatedPayload, type SwapActiveSandboxRequest, type SwapActiveSandboxResponse, TTYD_SUBPROTOCOL, type TerminalCapability, type TerminalExecRequest, type TerminalExecResponse, type TerminalPtyExitedPayload, type TerminalPtyOutputDeltaPayload, type TerminalPtyStartedPayload, type ToolAuthNeededPayload, type ToolRef, TtydClientCommand, TtydServerCommand, type UpdateConnectionRequest, type UpdateKnowledgeMemoryRequest, type UpdateRigRequest, type UpdateScheduledTaskRequest, type UpdateSessionGoalRequest, type UpdateSessionPinRequest, type UpdateSessionRequest, type UpdateVariableSetRequest, type UpdateWorkspaceEnvironmentRequest, type UpdateWorkspaceMemberRequest, type UpdateWorkspaceRequest, type UpdateWorkspaceSettingsRequest, type UploadFileInput, type UsageEvent, type UsageEventType, type UserApprovalDecisionEventInput, type UserMessageEventInput, type VariableSet, type VariableSetVariableMetadata, type ViewerHeartbeatRequest, type ViewerHeartbeatResponse, type ViewerHolder, type Workspace, type WorkspaceCaptureDegradedReason, type WorkspaceCaptureFile, type WorkspaceCaptureManifest, type WorkspaceCaptureRepo, type WorkspaceCaptureSignedUrl, type WorkspaceCaptureStats, type WorkspaceControlEvent, type WorkspaceControlStreamTransport, type WorkspaceEnvironment, type WorkspaceEnvironmentVariableMetadata, type WorkspaceInferenceControlResponse, type WorkspaceMember, type WorkspaceMemorySearchMode, type WorkspaceMemorySearchRequest, type WorkspaceMemorySearchResponse, type WorkspaceMemorySearchResult, type WorkspaceRegisteredPack, type WorkspaceRevisionCapturedPayload, type WorkspaceRevisionDegradedPayload, type WorkspaceSettings, applyUrlRotation, desktopSocketUrl, formatSseEvent, isRetryableStreamError, nextDesktopState, parseSseStream, proxySessionEventStream, resumeSequenceFromRequest, sessionEventsToSseResponse, sessionEventsToSseStream, streamSessionEvents, streamWorkspaceControlEvents, terminalSocketUrl, ttydAuthFrame, ttydInputFrame, ttydResizeFrame };