@opengeni/sdk 0.42.1 → 0.44.0

package/dist/{chunk-XBBPYTI5.js → chunk-SLJ33Y7V.js}

@@ -1,6 +1,6 @@
 import {
   OpenGeniApiError
-} from "./chunk-OINSI33U.js";
+} from "./chunk-UD2DNDSS.js";
 
 // src/codex-realtime-v3-wire.ts
 var CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT = 128;
@@ -2015,4 +2015,4 @@ export {
   hasStoredSessionRealtimeOwnerProof,
   createCodexRealtimeController
 };
-//# sourceMappingURL=chunk-XBBPYTI5.js.map
+//# sourceMappingURL=chunk-SLJ33Y7V.js.map

package/dist/{chunk-OINSI33U.js → chunk-UD2DNDSS.js}

@@ -7,6 +7,7 @@ var OpenGeniApiError = class extends Error {
   /** True only when an uncontrolled transport failed after a mutation may have been accepted. */
   outcomeUnknown;
   body;
+  details;
   constructor(status, body, options = {}) {
     const decoded = decodeApiErrorBody(body);
     const correlationId = decoded?.requestId ?? boundedCorrelationId(options.correlationId);
@@ -22,6 +23,7 @@ var OpenGeniApiError = class extends Error {
     this.correlationId = correlationId;
     this.outcomeUnknown = options.outcomeUnknown ?? (gatewayFailure && !!options.mutation && !decoded);
     this.body = !fromResponse || decoded ? body : "";
+    this.details = decoded?.details;
   }
 };
 function decodeApiErrorBody(body) {
@@ -35,17 +37,34 @@ function decodeApiErrorBody(body) {
     const message = boundedApiField(nested.message);
     const requestId = boundedCorrelationId(nested.requestId);
     const retryable = typeof nested.retryable === "boolean" ? nested.retryable : void 0;
-    if (!code && !message && !requestId && retryable === void 0) return null;
+    const details = boundedApiDetails(nested.details);
+    if (!code && !message && !requestId && retryable === void 0 && !details) return null;
     return {
       code,
       message,
       requestId,
-      retryable
+      retryable,
+      details
     };
   } catch {
     return null;
   }
 }
+function boundedApiDetails(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return;
+  const entries = Object.entries(value).slice(0, 16);
+  const details = {};
+  for (const [key, entry] of entries) {
+    if (!/^[a-zA-Z][\w.-]{0,63}$/.test(key)) continue;
+    if (typeof entry === "string") {
+      const bounded = boundedApiField(entry);
+      if (bounded !== void 0) details[key] = bounded;
+    } else if (typeof entry === "number" || typeof entry === "boolean" || entry === null) {
+      details[key] = entry;
+    }
+  }
+  return Object.keys(details).length > 0 ? details : void 0;
+}
 function boundedApiField(value) {
   if (typeof value !== "string") return;
   const bytes = new TextEncoder().encode(value);
@@ -94,4 +113,4 @@ export {
   isAbortError,
   isRetryableStreamError
 };
-//# sourceMappingURL=chunk-OINSI33U.js.map
+//# sourceMappingURL=chunk-UD2DNDSS.js.map

package/dist/chunk-UD2DNDSS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["/** Error for a non-2xx OpenGeni API response. */\nexport class OpenGeniApiError extends Error {\n  readonly status: number;\n  readonly code: string | undefined;\n  readonly retryable: boolean;\n  readonly correlationId: string | undefined;\n  /** True only when an uncontrolled transport failed after a mutation may have been accepted. */\n  readonly outcomeUnknown: boolean;\n  readonly body: string;\n  readonly details: Record<string, unknown> | undefined;\n\n  constructor(\n    status: number,\n    body: string,\n    options: {\n      code?: string | undefined;\n      retryable?: boolean | undefined;\n      correlationId?: string | undefined;\n      outcomeUnknown?: boolean | undefined;\n      displayMessage?: string | undefined;\n      mutation?: boolean | undefined;\n    } = {},\n  ) {\n    const decoded = decodeApiErrorBody(body);\n    const correlationId = decoded?.requestId ?? boundedCorrelationId(options.correlationId);\n    const gatewayFailure = status >= 502 && status <= 504;\n    const fromResponse = options.mutation !== undefined;\n    const message = decoded?.message ?? (fromResponse ? \"Request failed.\" : body || \"(empty body)\");\n    const displayMessage =\n      options.displayMessage ??\n      (gatewayFailure && fromResponse\n        ? \"OpenGeni is temporarily unavailable — retry.\"\n        : `OpenGeni API ${status}: ${message}`);\n    super(correlationId ? `${displayMessage} Reference: ${correlationId}.` : displayMessage);\n    this.name = \"OpenGeniApiError\";\n    this.status = status;\n    this.code =\n      options.code ??\n      decoded?.code ??\n      (gatewayFailure && fromResponse ? \"upstream_unavailable\" : undefined);\n    this.retryable = options.retryable ?? decoded?.retryable ?? retryableApiStatus(status);\n    this.correlationId = correlationId;\n    this.outcomeUnknown =\n      options.outcomeUnknown ?? (gatewayFailure && !!options.mutation && !decoded);\n    this.body = !fromResponse || decoded ? body : \"\";\n    this.details = decoded?.details;\n  }\n}\n\nfunction decodeApiErrorBody(body: string): {\n  code: string | undefined;\n  message: string | undefined;\n  requestId: string | undefined;\n  retryable: boolean | undefined;\n  details: Record<string, unknown> | undefined;\n} | null {\n  if (!body) return null;\n  try {\n    const decoded: unknown = JSON.parse(body);\n    if (!decoded || typeof decoded !== \"object\" || Array.isArray(decoded)) return null;\n    const record = decoded as Record<string, unknown>;\n    const nested =\n      record.error && typeof record.error === \"object\" && !Array.isArray(record.error)\n        ? (record.error as Record<string, unknown>)\n        : record;\n    const code = boundedApiField(nested.code);\n    const message = boundedApiField(nested.message);\n    const requestId = boundedCorrelationId(nested.requestId);\n    const retryable = typeof nested.retryable === \"boolean\" ? nested.retryable : undefined;\n    const details = boundedApiDetails(nested.details);\n    if (!code && !message && !requestId && retryable === undefined && !details) return null;\n    return {\n      code,\n      message,\n      requestId,\n      retryable,\n      details,\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction boundedApiDetails(value: unknown): Record<string, unknown> | undefined {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return;\n  const entries = Object.entries(value as Record<string, unknown>).slice(0, 16);\n  const details: Record<string, unknown> = {};\n  for (const [key, entry] of entries) {\n    if (!/^[a-zA-Z][\\w.-]{0,63}$/.test(key)) continue;\n    if (typeof entry === \"string\") {\n      const bounded = boundedApiField(entry);\n      if (bounded !== undefined) details[key] = bounded;\n    } else if (typeof entry === \"number\" || typeof entry === \"boolean\" || entry === null) {\n      details[key] = entry;\n    }\n  }\n  return Object.keys(details).length > 0 ? details : undefined;\n}\n\nfunction boundedApiField(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return;\n  const bytes = new TextEncoder().encode(value);\n  return bytes.byteLength <= 512 ? value : new TextDecoder().decode(bytes.slice(0, 512));\n}\n\nfunction retryableApiStatus(status: number): boolean {\n  return status === 408 || status === 409 || status === 425 || status === 429 || status >= 500;\n}\n\nfunction boundedCorrelationId(value: unknown): string | undefined {\n  if (typeof value !== \"string\" || value.length > 128 || !/^[\\w.:-]+$/.test(value)) {\n    return;\n  }\n  return value;\n}\n\n/** A short-lived session-list snapshot cursor can no longer be continued. */\nexport class OpenGeniSessionListCursorError extends OpenGeniApiError {}\n\n/** The browser bundle and API disagree about their state-changing wire contract. */\nexport class OpenGeniApiContractMismatchError extends Error {\n  readonly expected: string;\n  readonly actual: string;\n\n  constructor(expected: string, actual: string) {\n    super(`OpenGeni API contract mismatch: client expects ${expected}, API serves ${actual}`);\n    this.name = \"OpenGeniApiContractMismatchError\";\n    this.expected = expected;\n    this.actual = actual;\n  }\n}\n\n/** Error for an unrecoverable event-stream condition (not a transient drop). */\nexport class OpenGeniStreamError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OpenGeniStreamError\";\n  }\n}\n\nexport function isAbortError(error: unknown): boolean {\n  return (\n    (error instanceof DOMException && error.name === \"AbortError\") ||\n    (error instanceof Error && error.name === \"AbortError\")\n  );\n}\n\n/**\n * Transient conditions worth a reconnect: network-level failures (`fetch`\n * rejects with `TypeError`) and HTTP statuses that signal a temporary server\n * or contention condition. Auth/validation failures (401/403/404/...) are\n * permanent and surface to the caller instead.\n */\nexport function isRetryableStreamError(error: unknown): boolean {\n  if (error instanceof OpenGeniApiError) return error.retryable;\n  return error instanceof TypeError;\n}\n"],"mappings":"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","names":[]}

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type SessionEventStreamTransport, type StreamSessionEventsOptions } fro
 import { type WorkspaceControlStreamTransport } from "./workspace-control-stream";
 import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, CapabilityInstallation, AddDocumentRequest, CreateKnowledgeDropRequest, MoveDocumentRequest, ClientConfig, WorkspaceModelCatalogResponse, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, CompactSessionContextResult, ConnectionMetadata, CreateApiKeyRequest, CreateApiKeyResponse, CreateCapabilityCatalogItemRequest, CreateCheckoutRequest, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackReactionChannelListResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateKnowledgeMemoryRequest, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, CreateRigRequest, CreateWorkspaceRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, DocumentSearchRequest, DocumentSearchResponse, EnableCapabilityRequest, EnablePackRequest, FileAsset, FileDownloadUrlResponse, GetPackResponse, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveDisconnectRequest, GoogleDriveLifecycleActionRequest, KnowledgeMemory, KnowledgeMemorySearchRequest, ListPacksResponse, MachinesResponse, MetricSample, SwapActiveSandboxRequest, SwapActiveSandboxResponse, PackInstallation, LatencyMode, ReasoningEffort, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, RegisterCapabilityPackRequest, ResourceRef, ScheduledTask, ScheduledTaskRun, Session, SessionListResponse, UpdateSessionPinRequest, SessionEvent, SessionEventCompactResult, SessionEventCompactResultOptions, SessionEventListOptions, SessionEventPage, SessionGoal, SessionHumanInputRequest, SessionLineageResponse, SessionRealtimeMutationResponse, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, RenewSessionRealtimeRequest, SessionMcpCredentialUpdateInput, UpdateSessionMcpApprovalPolicyRequest, UpdateSessionMcpApprovalPolicyResponse, SessionQueueSnapshot, SessionQueueMutationResponse, ComposerDraft, DeleteSessionQueueItemRequest, EditSessionQueueItemRequest, MoveSessionQueueItemRequest, NewSessionDraft, SaveComposerDraftRequest, SaveNewSessionDraftRequest, SteerSessionQueueItemRequest, SessionControlResponse, WorkspaceInferenceControlResponse, WorkspaceControlEvent, SessionTurn, SubmitHumanInputResponseRequest, SessionCapabilities, AttachViewerRequest, AttachViewerResponse, AcknowledgeStreamRequest, AcknowledgeStreamResponse, ViewerHeartbeatRequest, ViewerHeartbeatResponse, FsListRequest, FsListResponse, FsReadRequest, FsReadResponse, FsWriteRequest, FsWriteResponse, FsDeleteRequest, FsDeleteResponse, FsMoveRequest, FsMoveResponse, FsMkdirRequest, FsMkdirResponse, GitStatusRequest, GitStatusResponse, GitDiffRequest, GitDiffResponse, GitLogRequest, GitLogResponse, GitShowRequest, GitShowResponse, GetWorkspaceCaptureResponse, GetWorkspaceCaptureFileResponse, TerminalExecRequest, TerminalExecResponse, PtyOpenRequest, PtyOpenResponse, PtyWriteRequest, PtyResizeRequest, PtyCloseRequest, ToolRef, TranscribeAudioResponse, UpdateConnectionRequest, UpdateKnowledgeMemoryRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, UpdateSessionRequest, UpdateSessionToolPolicyRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetVariableMetadata, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemorySearchRequest, WorkspaceMemorySearchResponse, WorkspaceRegisteredPack, Workspace, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest } from "./types";
 import type { ActivateWorkspaceInstructionPolicyRequest, CreateWorkspaceInstructionPolicyDraftRequest, CreateWorkspaceInstructionPolicyOnboardingProposalRequest, ImportLegacyWorkspaceInstructionPolicyDraftRequest, RollbackWorkspaceInstructionPolicyRequest, WorkspaceInstructionPolicyActivationResponse, WorkspaceInstructionPolicyDiffRequest, WorkspaceInstructionPolicyDiffResponse, WorkspaceInstructionPolicyListOptions, WorkspaceInstructionPolicyListResponse, WorkspaceInstructionPolicyOnboardingProposal, WorkspaceInstructionPolicyOnboardingProposalListOptions, WorkspaceInstructionPolicyOnboardingProposalListResponse, WorkspaceInstructionPolicyRevision } from "./workspace-instruction-policies";
-import type { WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state";
+import type { WorkspaceStateExportResponse, WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state";
 import type { ActivatePreferenceRegistryRevisionRequest, ChangePreferenceRegistryScopeRequest, CorrectPreferenceRegistryRequest, CreatePreferenceRegistryProposalRequest, DeactivatePreferenceRegistryRequest, PreferenceRegistryDetailResponse, PreferenceRegistryFullContent, PreferenceRegistryListOptions, PreferenceRegistryListResponse, PreferenceRegistryMutationResponse, PreferenceRegistryRecord, PreferenceRegistrySnapshot, RejectPreferenceRegistryProposalRequest, SupersedePreferenceRegistryRequest } from "./preference-registry";
 export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 export type WorkspaceControlEventPage = {
@@ -391,6 +391,8 @@ export declare class OpenGeniClient {
     getWorkspace(workspaceId: string): Promise<Workspace>;
     /** Read-time, secret-safe inventory of policy heads and visible workspace knowledge. */
     getWorkspaceState(workspaceId: string, options?: WorkspaceStateGetOptions): Promise<WorkspaceStateResponse>;
+    /** Download the canonical, explicitly sanitized Workspace State export. */
+    exportWorkspaceState(workspaceId: string, options?: WorkspaceStateGetOptions): Promise<WorkspaceStateExportResponse>;
     updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace>;
     /** Inspect immutable instruction-policy history, active heads, and activation audit evidence. */
     listWorkspaceInstructionPolicies(workspaceId: string, options?: WorkspaceInstructionPolicyListOptions): Promise<WorkspaceInstructionPolicyListResponse>;

package/dist/codex-realtime-controller.js

@@ -5,8 +5,8 @@ import {
   projectSessionRealtimeLifecycle,
   sessionRealtimeOwnerStorageKey,
   sessionRealtimeOwnerStorageNamespace
-} from "./chunk-XBBPYTI5.js";
-import "./chunk-OINSI33U.js";
+} from "./chunk-SLJ33Y7V.js";
+import "./chunk-UD2DNDSS.js";
 export {
   CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,
   createCodexRealtimeController,

package/dist/core.js

@@ -3,14 +3,14 @@ import {
   OPENGENI_API_CONTRACT_REVISION,
   OpenGeniClient,
   resolveWorkspaceVoiceInputEnabled
-} from "./chunk-M7TPZ3ED.js";
+} from "./chunk-74LY67W7.js";
 import {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
   OpenGeniSessionListCursorError,
   OpenGeniStreamError,
   isRetryableStreamError
-} from "./chunk-OINSI33U.js";
+} from "./chunk-UD2DNDSS.js";
 export {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION,

package/dist/errors.d.ts

@@ -7,6 +7,7 @@ export declare class OpenGeniApiError extends Error {
     /** True only when an uncontrolled transport failed after a mutation may have been accepted. */
     readonly outcomeUnknown: boolean;
     readonly body: string;
+    readonly details: Record<string, unknown> | undefined;
     constructor(status: number, body: string, options?: {
         code?: string | undefined;
         retryable?: boolean | undefined;

package/dist/index.d.ts

@@ -26,7 +26,7 @@ export type { WorkspaceControlStreamTransport } from "./workspace-control-stream
 export type { CreateWorkspaceArtifactRequest, PublishWorkspaceArtifactVersionRequest, RollbackWorkspaceArtifactRequest, WorkspaceArtifact, WorkspaceArtifactContentResponse, WorkspaceArtifactDetailResponse, WorkspaceArtifactEvent, WorkspaceArtifactListOptions, WorkspaceArtifactListResponse, WorkspaceArtifactMutationResponse, WorkspaceArtifactVersion, } from "./workspace-artifacts";
 export { normalizeWorkspaceInstructionPolicyRoleKey, WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS, } from "./workspace-instruction-policies";
 export type { ActivateWorkspaceInstructionPolicyRequest, CreateWorkspaceInstructionPolicyDraftRequest, CreateWorkspaceInstructionPolicyOnboardingProposalRequest, ImportLegacyWorkspaceInstructionPolicyDraftRequest, RollbackWorkspaceInstructionPolicyRequest, WorkspaceInstructionPolicyActivationEvent, WorkspaceInstructionPolicyActivationResponse, WorkspaceInstructionPolicyActivationType, WorkspaceInstructionPolicyConflictResponse, WorkspaceInstructionPolicyDiffRequest, WorkspaceInstructionPolicyDiffResponse, WorkspaceInstructionPolicyDraftProvenanceSource, WorkspaceInstructionPolicyHead, WorkspaceInstructionPolicyKind, WorkspaceInstructionPolicyListOptions, WorkspaceInstructionPolicyListResponse, WorkspaceInstructionPolicyOnboardingProposal, WorkspaceInstructionPolicyOnboardingProposalConflictResponse, WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse, WorkspaceInstructionPolicyOnboardingProposalListOptions, WorkspaceInstructionPolicyOnboardingProposalListResponse, WorkspaceInstructionPolicyOnboardingProposalSource, WorkspaceInstructionPolicyOnboardingProposalStaleResponse, WorkspaceInstructionPolicyOperationReuseResponse, WorkspaceInstructionPolicyProvenanceSource, WorkspaceInstructionPolicyRevision, WorkspaceInstructionPolicyRevisionIdentity, WorkspaceInstructionPolicyScope, WorkspaceInstructionPolicyTarget, } from "./workspace-instruction-policies";
-export type { WorkspaceStateDocumentStatusCounts, WorkspaceStateAttemptGovernance, WorkspaceStateGapCode, WorkspaceStateGetOptions, WorkspaceStateGovernanceDriftStatus, WorkspaceStateMemoryKindCounts, WorkspaceStateMemoryStatusCounts, WorkspaceStateResponse, WorkspaceStateSourceKindCounts, } from "./workspace-state";
+export type { WorkspaceStateDocumentStatusCounts, WorkspaceStateDocumentAuthorityKindCounts, WorkspaceStateAttemptGovernance, WorkspaceStateExportOmission, WorkspaceStateExportResponse, WorkspaceStateGapCode, WorkspaceStateGetOptions, WorkspaceStateGovernanceDriftStatus, WorkspaceStateMemoryKindCounts, WorkspaceStateMemoryStatusCounts, WorkspaceStateResponse, WorkspaceStateSourceKindCounts, } from "./workspace-state";
 export { normalizePreferenceRegistryStableKey } from "./preference-registry";
 export type { ActivatePreferenceRegistryRevisionRequest, ChangePreferenceRegistryScopeRequest, CorrectPreferenceRegistryRequest, CreatePreferenceRegistryProposalRequest, DeactivatePreferenceRegistryRequest, PreferenceRegistryConflictStrategy, PreferenceRegistryDescriptor, PreferenceRegistryDescriptorProvenance, PreferenceRegistryDetailResponse, PreferenceRegistryEvent, PreferenceRegistryFullContent, PreferenceRegistryListOptions, PreferenceRegistryListResponse, PreferenceRegistryMutationResponse, PreferenceRegistryPrecedence, PreferenceRegistryProvenanceSource, PreferenceRegistryRecord, PreferenceRegistryRevisionSummary, PreferenceRegistryScope, PreferenceRegistryScopeTarget, PreferenceRegistrySnapshot, PreferenceRegistryStatus, PreferenceRegistryTrust, RejectPreferenceRegistryProposalRequest, SupersedePreferenceRegistryRequest, } from "./preference-registry";
 export { DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY, authorizeTranscriptionAdapter, createTranscriptionSessionRequest, resolveWorkspaceVoiceInputEnabled, resolveWorkspaceTranscriptionPolicy, } from "./transcription";

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   resolveWorkspaceVoiceInputEnabled,
   streamSessionEvents,
   streamWorkspaceControlEvents
-} from "./chunk-M7TPZ3ED.js";
+} from "./chunk-74LY67W7.js";
 import {
   CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
   CodexRealtimeMicrophoneError,
@@ -31,14 +31,14 @@ import {
   parseCodexRealtimeV3Event,
   projectSessionRealtimeLifecycle,
   startCodexRealtimeWebrtc
-} from "./chunk-XBBPYTI5.js";
+} from "./chunk-SLJ33Y7V.js";
 import {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
   OpenGeniSessionListCursorError,
   OpenGeniStreamError,
   isRetryableStreamError
-} from "./chunk-OINSI33U.js";
+} from "./chunk-UD2DNDSS.js";
 import {
   createGatewayRealtimeTransportStarter
 } from "./chunk-DXDL7EEW.js";

package/dist/realtime.js

@@ -23,8 +23,8 @@ import {
   sessionRealtimeOwnerStorageKey,
   sessionRealtimeOwnerStorageNamespace,
   startCodexRealtimeWebrtc
-} from "./chunk-XBBPYTI5.js";
-import "./chunk-OINSI33U.js";
+} from "./chunk-SLJ33Y7V.js";
+import "./chunk-UD2DNDSS.js";
 import {
   createGatewayRealtimeTransportStarter
 } from "./chunk-DXDL7EEW.js";

package/dist/types.d.ts

@@ -668,6 +668,8 @@ export type Session = {
     sandboxGroupId: string;
     activeSandboxId: string | null;
     activeEpoch: number;
+    /** Explicit connected-machine project root; null uses the agent launch root. */
+    workingDir: string | null;
     variableSetId: string | null;
     /** @deprecated use variableSetId */
     environmentId: string | null;
@@ -1634,6 +1636,8 @@ export type ModelPricingScheduleV1 = {
 export type ClientModel = {
     id: string;
     label: string;
+    /** Optional curated compact label for dense UI (e.g. mobile composer). */
+    shortLabel?: string | undefined;
     /** Provider id (e.g. `openai`, `azure`, or a registry provider id). */
     provider: string;
     providerLabel: string;

package/dist/workspace-state.d.ts

@@ -15,6 +15,11 @@ export type WorkspaceStateSourceKindCounts = {
     web: number;
     other: number;
 };
+export type WorkspaceStateDocumentAuthorityKindCounts = {
+    organization: number;
+    workspace: number;
+    personal: number;
+};
 export type WorkspaceStateMemoryStatusCounts = {
     proposed: number;
     approved: number;
@@ -142,6 +147,17 @@ export type WorkspaceStateResponse = {
             status: "not_implemented";
         };
     };
+    preferences: {
+        authority: "preference_registry_preferences";
+        activeDescriptorCount: number;
+        activeDescriptorHash: string;
+        scopeCounts: {
+            organization: number;
+            workspace: number;
+            user: number;
+        };
+        truncated: boolean;
+    };
     knowledge: {
         availability: "unavailable";
         reason: "missing_permission";
@@ -161,6 +177,7 @@ export type WorkspaceStateResponse = {
         inspectedVisibleDocumentCount: number;
         documentStatusCounts: WorkspaceStateDocumentStatusCounts;
         sourceKindCounts: WorkspaceStateSourceKindCounts;
+        authorityKindCounts: WorkspaceStateDocumentAuthorityKindCounts;
         topics: Array<{
             name: string;
             documentCount: number;
@@ -186,3 +203,12 @@ export type WorkspaceStateResponse = {
         }>;
     };
 };
+export type WorkspaceStateExportOmission = "hidden_platform_prompts" | "policy_bodies" | "preference_content" | "document_content_and_private_metadata" | "memory_content_and_provenance" | "secret_values_and_credentials" | "session_messages_and_tool_outputs";
+export type WorkspaceStateExportResponse = {
+    kind: "opengeni.workspace_state.sanitized_export";
+    schemaVersion: 1;
+    generatedAt: string;
+    stateSha256: string;
+    omissions: WorkspaceStateExportOmission[];
+    state: WorkspaceStateResponse;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.42.1",
+  "version": "0.44.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": {

package/src/client.ts

@@ -235,7 +235,11 @@ import type {
   WorkspaceInstructionPolicyOnboardingProposalListResponse,
   WorkspaceInstructionPolicyRevision,
 } from "./workspace-instruction-policies";
-import type { WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state";
+import type {
+  WorkspaceStateExportResponse,
+  WorkspaceStateGetOptions,
+  WorkspaceStateResponse,
+} from "./workspace-state";
 import type {
   ActivatePreferenceRegistryRevisionRequest,
   ChangePreferenceRegistryScopeRequest,
@@ -1911,6 +1915,20 @@ export class OpenGeniClient {
     );
   }
 
+  /** Download the canonical, explicitly sanitized Workspace State export. */
+  async exportWorkspaceState(
+    workspaceId: string,
+    options: WorkspaceStateGetOptions = {},
+  ): Promise<WorkspaceStateExportResponse> {
+    const params = new URLSearchParams();
+    if (options.attemptId) params.set("attemptId", options.attemptId);
+    const query = params.size > 0 ? `?${params.toString()}` : "";
+    return await this.requestJson<WorkspaceStateExportResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/workspace-state/export${query}`,
+    );
+  }
+
   async updateWorkspace(workspaceId: string, request: UpdateWorkspaceRequest): Promise<Workspace> {
     return await this.requestJson<Workspace>("PATCH", `/v1/workspaces/${workspaceId}`, request);
   }

package/src/errors.ts

@@ -7,6 +7,7 @@ export class OpenGeniApiError extends Error {
   /** True only when an uncontrolled transport failed after a mutation may have been accepted. */
   readonly outcomeUnknown: boolean;
   readonly body: string;
+  readonly details: Record<string, unknown> | undefined;
 
   constructor(
     status: number,
@@ -42,6 +43,7 @@ export class OpenGeniApiError extends Error {
     this.outcomeUnknown =
       options.outcomeUnknown ?? (gatewayFailure && !!options.mutation && !decoded);
     this.body = !fromResponse || decoded ? body : "";
+    this.details = decoded?.details;
   }
 }
 
@@ -50,6 +52,7 @@ function decodeApiErrorBody(body: string): {
   message: string | undefined;
   requestId: string | undefined;
   retryable: boolean | undefined;
+  details: Record<string, unknown> | undefined;
 } | null {
   if (!body) return null;
   try {
@@ -64,18 +67,36 @@ function decodeApiErrorBody(body: string): {
     const message = boundedApiField(nested.message);
     const requestId = boundedCorrelationId(nested.requestId);
     const retryable = typeof nested.retryable === "boolean" ? nested.retryable : undefined;
-    if (!code && !message && !requestId && retryable === undefined) return null;
+    const details = boundedApiDetails(nested.details);
+    if (!code && !message && !requestId && retryable === undefined && !details) return null;
     return {
       code,
       message,
       requestId,
       retryable,
+      details,
     };
   } catch {
     return null;
   }
 }
 
+function boundedApiDetails(value: unknown): Record<string, unknown> | undefined {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return;
+  const entries = Object.entries(value as Record<string, unknown>).slice(0, 16);
+  const details: Record<string, unknown> = {};
+  for (const [key, entry] of entries) {
+    if (!/^[a-zA-Z][\w.-]{0,63}$/.test(key)) continue;
+    if (typeof entry === "string") {
+      const bounded = boundedApiField(entry);
+      if (bounded !== undefined) details[key] = bounded;
+    } else if (typeof entry === "number" || typeof entry === "boolean" || entry === null) {
+      details[key] = entry;
+    }
+  }
+  return Object.keys(details).length > 0 ? details : undefined;
+}
+
 function boundedApiField(value: unknown): string | undefined {
   if (typeof value !== "string") return;
   const bytes = new TextEncoder().encode(value);

package/src/index.ts

@@ -156,7 +156,10 @@ export type {
 } from "./workspace-instruction-policies";
 export type {
   WorkspaceStateDocumentStatusCounts,
+  WorkspaceStateDocumentAuthorityKindCounts,
   WorkspaceStateAttemptGovernance,
+  WorkspaceStateExportOmission,
+  WorkspaceStateExportResponse,
   WorkspaceStateGapCode,
   WorkspaceStateGetOptions,
   WorkspaceStateGovernanceDriftStatus,

package/src/types.ts

@@ -881,6 +881,8 @@ export type Session = {
   sandboxGroupId: string;
   activeSandboxId: string | null;
   activeEpoch: number;
+  /** Explicit connected-machine project root; null uses the agent launch root. */
+  workingDir: string | null;
   variableSetId: string | null;
   /** @deprecated use variableSetId */
   environmentId: string | null;
@@ -2203,6 +2205,8 @@ export type ModelPricingScheduleV1 = {
 export type ClientModel = {
   id: string;
   label: string;
+  /** Optional curated compact label for dense UI (e.g. mobile composer). */
+  shortLabel?: string | undefined;
   /** Provider id (e.g. `openai`, `azure`, or a registry provider id). */
   provider: string;
   providerLabel: string;

package/src/workspace-state.ts

@@ -22,6 +22,12 @@ export type WorkspaceStateSourceKindCounts = {
   other: number;
 };
 
+export type WorkspaceStateDocumentAuthorityKindCounts = {
+  organization: number;
+  workspace: number;
+  personal: number;
+};
+
 export type WorkspaceStateMemoryStatusCounts = {
   proposed: number;
   approved: number;
@@ -167,6 +173,13 @@ export type WorkspaceStateResponse = {
     };
     runtimeComposition: { status: "not_implemented" };
   };
+  preferences: {
+    authority: "preference_registry_preferences";
+    activeDescriptorCount: number;
+    activeDescriptorHash: string;
+    scopeCounts: { organization: number; workspace: number; user: number };
+    truncated: boolean;
+  };
   knowledge:
     | {
         availability: "unavailable";
@@ -188,6 +201,7 @@ export type WorkspaceStateResponse = {
         inspectedVisibleDocumentCount: number;
         documentStatusCounts: WorkspaceStateDocumentStatusCounts;
         sourceKindCounts: WorkspaceStateSourceKindCounts;
+        authorityKindCounts: WorkspaceStateDocumentAuthorityKindCounts;
         topics: Array<{ name: string; documentCount: number }>;
         topicsTruncated: boolean;
         latestDocumentUpdatedAt: string | null;
@@ -210,3 +224,21 @@ export type WorkspaceStateResponse = {
         }>;
       };
 };
+
+export type WorkspaceStateExportOmission =
+  | "hidden_platform_prompts"
+  | "policy_bodies"
+  | "preference_content"
+  | "document_content_and_private_metadata"
+  | "memory_content_and_provenance"
+  | "secret_values_and_credentials"
+  | "session_messages_and_tool_outputs";
+
+export type WorkspaceStateExportResponse = {
+  kind: "opengeni.workspace_state.sanitized_export";
+  schemaVersion: 1;
+  generatedAt: string;
+  stateSha256: string;
+  omissions: WorkspaceStateExportOmission[];
+  state: WorkspaceStateResponse;
+};