@opengeni/sdk 0.36.1 → 0.40.0

package/dist/types.d.ts

@@ -1,4 +1,165 @@
 import type { WorkspaceTranscriptionPolicy } from "./transcription";
+export type CodexRealtimeWebrtcVersion = "v3";
+export type CodexRealtimeVoice = "juniper" | "maple" | "spruce" | "ember" | "vale" | "breeze" | "arbor" | "sol" | "cove";
+export type CodexRealtimeWebrtcRequest = {
+    realtimeId: string;
+    operationId: string;
+    browserInstanceId: string;
+    ownerKey: string;
+    expectedVersion: number;
+    expectedConnectionEpoch: number;
+    rotate: boolean;
+    browserActivation?: "required" | undefined;
+    sdp: string;
+    version: CodexRealtimeWebrtcVersion;
+    instructions?: string | undefined;
+    voice?: CodexRealtimeVoice | undefined;
+};
+export type CodexRealtimeWebrtcResponse = {
+    sdp: string;
+    version: CodexRealtimeWebrtcVersion;
+    model: "gpt-live-1-boulder-alpha";
+    connectionId: string;
+    connectionEpoch: number;
+    startupFenceSequence: number;
+    modeVersion: number;
+    replay: boolean;
+};
+export type GatewayRealtimeConnectRequest = {
+    realtimeId: string;
+    operationId: string;
+    browserInstanceId: string;
+    ownerKey: string;
+    expectedVersion: number;
+    expectedConnectionEpoch: number;
+    rotate: boolean;
+};
+export type GatewayRealtimeInitialItem = {
+    role: "user" | "developer" | "assistant";
+    text: string;
+};
+export type GatewayRealtimeConnectResponse = {
+    token: string;
+    url: string;
+    upstreamModelId: string;
+    expiresAt: number | null;
+    connectionId: string;
+    connectionEpoch: number;
+    startupFenceSequence: number;
+    modeVersion: number;
+    initialItems: GatewayRealtimeInitialItem[];
+    instructions: string;
+    replay: false;
+};
+export type ActivateCodexRealtimeConnectionRequest = {
+    operationId: string;
+    browserInstanceId: string;
+    ownerKey: string;
+    connectionEpoch: number;
+    expectedVersion: number;
+    expectedConnectionEpoch: number;
+};
+export type SessionRealtimeLedgerDirection = "provider_in" | "provider_out";
+export type SessionRealtimeLedgerKind = "user_transcript" | "assistant_transcript" | "delegation_call" | "delegation_progress" | "delegation_result" | "interruption" | "session_update" | "error";
+export type SessionRealtimeLedgerEntry = {
+    id: string;
+    realtimeId: string;
+    operationId: string;
+    connectionEpoch: number;
+    sequence: number;
+    direction: SessionRealtimeLedgerDirection;
+    kind: SessionRealtimeLedgerKind;
+    role: "user" | "assistant" | null;
+    providerEventId: string | null;
+    delegationItemId: string | null;
+    sourceUpdateId: string | null;
+    historyItemId: string | null;
+    turnId: string | null;
+    text: string | null;
+    payload: Record<string, unknown>;
+    clientAckedAt: string | null;
+    providerAckedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type SessionRealtimeInboundEntry = {
+    operationId: string;
+    kind: Exclude<SessionRealtimeLedgerKind, "delegation_progress" | "delegation_result" | "session_update">;
+    role?: "user" | "assistant" | null | undefined;
+    providerEventId?: string | null | undefined;
+    delegationItemId?: string | null | undefined;
+    text?: string | null | undefined;
+    payload?: Record<string, unknown> | undefined;
+};
+export type SyncSessionRealtimeLedgerRequest = {
+    browserInstanceId: string;
+    ownerKey: string;
+    expectedVersion: number;
+    connectionId: string;
+    connectionEpoch: number;
+    entries?: SessionRealtimeInboundEntry[] | undefined;
+    clientAckThroughSequence?: number | null | undefined;
+    providerAckSequences?: number[] | undefined;
+    providerStarted?: {
+        providerSessionId: string;
+        providerEventId?: string | null | undefined;
+    } | undefined;
+};
+export type SyncSessionRealtimeLedgerResponse = {
+    accepted: Array<{
+        entry: SessionRealtimeLedgerEntry;
+        replay: boolean;
+    }>;
+    outbound: SessionRealtimeLedgerEntry[];
+};
+export type SessionRealtimeModel = "gpt-live-1-boulder-alpha" | "opengeni-gateway/openai/gpt-realtime-2.1" | "opengeni-gateway/openai/gpt-realtime-mini" | "opengeni-gateway/xai/grok-voice-think-fast-2.0" | "workspace-gateway/openai/gpt-realtime-2.1" | "workspace-gateway/openai/gpt-realtime-mini" | "workspace-gateway/xai/grok-voice-think-fast-2.0";
+export type WorkspaceRealtimeModelCatalogItem = {
+    id: SessionRealtimeModel;
+    label: string;
+    provider: "OpenGeni" | "Connected Codex" | "Your Gateway";
+    description: string;
+    available: boolean;
+    unavailableReason: string | null;
+    recommended: boolean;
+};
+export type WorkspaceRealtimeModelCatalogResponse = {
+    models: WorkspaceRealtimeModelCatalogItem[];
+};
+export type SessionRealtimeState = "active" | "ended";
+export type SessionRealtimeEndReason = "user_stop" | "browser_unload" | "lease_expired";
+export type SessionRealtimeMode = {
+    id: string;
+    sessionId: string;
+    operationId: string;
+    browserInstanceId: string;
+    model: SessionRealtimeModel;
+    state: SessionRealtimeState;
+    version: number;
+    connectionEpoch: number;
+    leaseExpiresAt: string;
+    lastHeartbeatAt: string;
+    startedAt: string;
+    endedAt: string | null;
+    endReason: SessionRealtimeEndReason | null;
+};
+export type BeginSessionRealtimeRequest = {
+    operationId: string;
+    browserInstanceId: string;
+    ownerKey: string;
+    model: SessionRealtimeModel;
+};
+export type RenewSessionRealtimeRequest = {
+    browserInstanceId: string;
+    ownerKey: string;
+    expectedVersion: number;
+};
+export type EndSessionRealtimeRequest = RenewSessionRealtimeRequest & {
+    reason: Extract<SessionRealtimeEndReason, "user_stop" | "browser_unload">;
+};
+export type SessionRealtimeMutationResponse = {
+    mode: SessionRealtimeMode;
+    replay: boolean;
+};
 export type SessionStatus = "queued" | "running" | "idle" | "requires_action" | "recovering" | "waiting_capacity" | "failed" | "cancelled";
 export type SandboxBackend = "docker" | "modal" | "local" | "none" | "daytona" | "runloop" | "e2b" | "blaxel" | "cloudflare" | "vercel" | "selfhosted";
 export type SandboxOs = "linux" | "macos" | "windows";
@@ -130,7 +291,7 @@ export type ViewerHeartbeatRequest = {
 export type ViewerHeartbeatResponse = {
     alive: boolean;
 };
-export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 export type LatencyMode = "standard" | "priority" | "fast";
 export type GitCredentialProvider = "github" | "gitlab" | "azure_devops";
 export type GitCredentialBindingId = string;
@@ -157,10 +318,12 @@ export type RepositoryResourceRef = {
     githubInstallationId?: number | undefined;
     githubRepositoryId?: number | undefined;
 };
+/** Value mirror of `@opengeni/contracts`; parity-tested without adding an SDK runtime dependency. */
+export declare const DEFAULT_FILE_RESOURCE_MOUNT_ROOT: ".opengeni/files";
 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;
 };
 export type ResourceRef = RepositoryResourceRef | FileResourceRef;
@@ -309,6 +472,16 @@ 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;
     name: string;
@@ -327,6 +500,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;
@@ -339,6 +513,14 @@ export type GoogleDriveOAuthStartResponse = {
     authorizationUrl: string;
     expiresAt: string;
 };
+export type GoogleDriveLifecycleActionRequest = {
+    action: "pause" | "resume";
+    expectedVersion: number;
+};
+export type GoogleDriveDisconnectRequest = {
+    expectedVersion: number;
+    idempotencyKey: string;
+};
 export type GoogleDriveBrowseItem = {
     id: string;
     name: string;
@@ -453,6 +635,8 @@ export type Session = {
     title: string | null;
     titleSource: "user" | "agent" | null;
     instructions: string | null;
+    /** Immutable normalized prompt-policy role; distinct from membership roles. */
+    policyRole: string | null;
     resources: ResourceRef[];
     skills: SessionSkill[];
     tools: ToolRef[];
@@ -600,8 +784,6 @@ export type HumanInputQuestion = {
     required: boolean;
     allowOther: boolean;
     validation?: {
-        minLength?: number | null | undefined;
-        maxLength?: number | null | undefined;
         minSelections?: number | null | undefined;
         maxSelections?: number | null | undefined;
     } | null | undefined;
@@ -641,7 +823,7 @@ export type SessionHumanInputRequest = {
     createdAt: string;
     updatedAt: string;
 };
-export declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.event.envelope_omitted", "session.status.changed", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compaction.started", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "user.humanInputResponse", "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.request", "agent.model.usage", "tool.auth_needed", "credential.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", "system.update.superseded", "system.update.cancelled", "system.update.settled", "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", "session.mcp.approval_policy.updated", "session.tool_policy.updated", "codex.account.switched", "codex.credential.selected", "codex.fleet.decision", "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"];
+export declare const SESSION_EVENT_TYPES: readonly ["session.created", "session.event.envelope_omitted", "session.status.changed", "session.realtime.started", "session.realtime.ended", "session.requiresAction", "session.humanInput.requested", "session.context.compaction.requested", "session.context.compaction.started", "session.context.compacted", "session.context.compaction.skipped", "session.context.cleared", "user.message", "user.pause", "user.approvalDecision", "user.humanInputResponse", "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.request", "agent.model.usage", "tool.auth_needed", "credential.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", "system.update.superseded", "system.update.cancelled", "system.update.settled", "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", "session.mcp.approval_policy.updated", "session.tool_policy.updated", "codex.account.switched", "codex.credential.selected", "codex.fleet.decision", "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"];
 export type KnownSessionEventType = (typeof SESSION_EVENT_TYPES)[number];
 /**
  * Event types the SDK knows about today, kept open so a newer OpenGeni server
@@ -1321,10 +1503,14 @@ export type ScheduledTask = {
 };
 export type CreateSessionRequest = {
     requestedSessionId?: string | undefined;
-    initialMessage: string;
+    initialMessage?: string | undefined;
+    /** Create an idle session shell so realtime voice can be the first interaction. */
+    startMode?: "realtime" | undefined;
     /** System instructions scoped to the initial turn; never visible timeline text. */
     turnInstructions?: string | undefined;
     instructions?: string | undefined;
+    /** Immutable normalized prompt-policy role; distinct from membership roles. */
+    policyRole?: string | undefined;
     resources?: ResourceRef[] | undefined;
     /** Inline skills fixed onto this session; omitted children inherit them. */
     skills?: SessionSkill[] | undefined;
@@ -1380,6 +1566,7 @@ export type ModelCapabilitiesV1 = {
         codeExecution: ModelCapabilityStateV1;
     };
     inputModalities: Array<"text" | "image" | "audio">;
+    inputFileMediaTypes?: string[] | undefined;
     outputModalities: Array<"text" | "image" | "audio">;
     transports: {
         sse: ModelCapabilityStateV1;
@@ -1810,8 +1997,28 @@ export type WorkspaceSettings = {
     maxNestedAgentDepth?: number | null | undefined;
     /** Default for new Codex sessions; absent ⇒ remote_v2. */
     codexCompactionDefault?: "remote_v2" | "portable" | undefined;
+    slackReactionSummon?: WorkspaceSlackReactionSummonSettings | undefined;
     [key: string]: unknown;
 };
+export type WorkspaceSlackReactionSummonSettings = {
+    enabled: boolean;
+    emoji: string;
+    channelPolicy: {
+        mode: "bot_member";
+    } | {
+        mode: "allowlist";
+        channelIds: string[];
+    };
+};
+export type SlackReactionChannel = {
+    id: string;
+    name: string | null;
+    isPrivate: boolean;
+};
+export type SlackReactionChannelListResponse = {
+    channels: SlackReactionChannel[];
+    nextCursor: string | null;
+};
 export type WorkspaceVoiceInputSettings = {
     enabled: boolean;
 };
@@ -1821,6 +2028,7 @@ export type UpdateWorkspaceSettingsRequest = {
     transcription?: WorkspaceTranscriptionPolicy | undefined;
     maxNestedAgentDepth?: number | null | undefined;
     codexCompactionDefault?: "remote_v2" | "portable" | undefined;
+    slackReactionSummon?: WorkspaceSlackReactionSummonSettings | undefined;
     [key: string]: unknown;
 };
 export type SetWorkspaceDefaultRigRequest = {
@@ -2054,6 +2262,8 @@ export type SessionControlResponse = {
     effectiveControl: EffectiveSessionControl;
     interruptionCount: number;
     wakeCount: number;
+    cancelledSessionCount: number;
+    cancelledTurnCount: number;
 };
 export type WorkspaceInferenceControlResponse = {
     receipt: SessionCommandReceipt;
@@ -2414,6 +2624,7 @@ export type UploadFileInput = {
 export type DocumentStatus = "queued" | "indexing" | "ready" | "failed";
 export type KnowledgeSourceKind = "manual_upload" | "meeting_transcript" | "repository" | "email" | "chat" | "document" | "web" | "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";
 export type DocumentCuration = {
@@ -2451,6 +2662,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;
@@ -2484,6 +2698,9 @@ export type DocumentSearchResult = {
     sourceUpdatedAt: string | null;
     sourceVersion: string | null;
     aclTags: string[];
+    authorityKind: DocumentAuthorityKind;
+    authorityWorkspaceId: string | null;
+    authoritySubjectId: string | null;
 };
 export type CreateDocumentBaseRequest = {
     name: string;
@@ -2501,6 +2718,7 @@ export type AddDocumentRequest = {
     sourceUpdatedAt?: string | undefined;
     sourceVersion?: string | undefined;
     aclTags?: string[] | undefined;
+    authorityKind?: DocumentAuthorityKind | undefined;
     visibility?: DocumentVisibility | undefined;
     agentAccess?: boolean | undefined;
 };
@@ -2509,6 +2727,7 @@ export type CreateKnowledgeDropRequest = {
     fileId?: string | undefined;
     filename?: string | undefined;
     title?: string | undefined;
+    authorityKind?: DocumentAuthorityKind | undefined;
     visibility?: DocumentVisibility | undefined;
     agentAccess?: boolean | undefined;
 };

package/dist/workspace-instruction-policies.d.ts

@@ -15,6 +15,7 @@ export type WorkspaceInstructionPolicyRevisionIdentity = {
     contentHash: string;
 };
 export type WorkspaceInstructionPolicyRevision = WorkspaceInstructionPolicyRevisionIdentity & WorkspaceInstructionPolicyTarget & {
+    operationId: string;
     accountId: string;
     workspaceId: string;
     content: string;
@@ -36,6 +37,7 @@ export type WorkspaceInstructionPolicyHead = WorkspaceInstructionPolicyTarget &
 };
 export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPolicyTarget & {
     id: string;
+    operationId: string;
     accountId: string;
     workspaceId: string;
     type: WorkspaceInstructionPolicyActivationType;
@@ -47,12 +49,14 @@ export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPoli
     createdAt: string;
 };
 export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionPolicyTarget & {
+    operationId?: string;
     content: string;
     provenanceSource?: WorkspaceInstructionPolicyDraftProvenanceSource;
     provenanceSourceId?: string | null;
     supersedesRevisionId?: string | null;
 };
 export type ImportLegacyWorkspaceInstructionPolicyDraftRequest = {
+    operationId?: string;
     supersedesRevisionId?: string | null;
 };
 export type WorkspaceInstructionPolicyListOptions = {
@@ -79,12 +83,16 @@ export type WorkspaceInstructionPolicyDiffResponse = {
     diff: string;
 };
 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;
 };
 export type WorkspaceInstructionPolicyActivationResponse = {
@@ -96,3 +104,7 @@ export type WorkspaceInstructionPolicyConflictResponse = {
     message: string;
     currentHead: WorkspaceInstructionPolicyHead | null;
 };
+export type WorkspaceInstructionPolicyOperationReuseResponse = {
+    code: "WORKSPACE_INSTRUCTION_POLICY_OPERATION_REUSED";
+    message: string;
+};

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.36.1",
+  "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": {
@@ -25,6 +25,18 @@
     "./core": {
       "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"
+    },
+    "./gateway-realtime-transport": {
+      "types": "./dist/gateway-realtime-transport.d.ts",
+      "import": "./dist/gateway-realtime-transport.js"
     }
   },
   "publishConfig": {
@@ -36,6 +48,7 @@
     "build": "bun ../../scripts/build-typescript-package.ts",
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
+  "dependencies": {},
   "engines": {
     "node": ">=18"
   }