@opengeni/sdk 3.3.2 → 3.7.0-canary.0

package/src/types.ts

@@ -72,6 +72,80 @@ export type GatewayRealtimeConnectResponse = {
   replay: false;
 };
 
+export type ToolGatewayIdentity = {
+  serverId: string;
+  toolName: string;
+};
+
+export type ToolGatewayCatalogEntry = {
+  identity: ToolGatewayIdentity;
+  modelName: string;
+  codemodePath: string[];
+  title?: string | undefined;
+  description?: string | undefined;
+  inputSchema: Record<string, unknown>;
+  outputSchema?: Record<string, unknown> | undefined;
+  annotations?: Record<string, unknown> | undefined;
+  icons?: Array<Record<string, unknown>> | undefined;
+  source: "opengeni" | "files" | "docs" | "mcp" | "codex_apps" | "interaction";
+  approval: "none" | "human" | "policy";
+};
+
+export type ToolGatewayCatalog = {
+  version: 1;
+  accountId: string;
+  workspaceId: string;
+  generation: number;
+  digest: string;
+  createdAt: string;
+  entries: ToolGatewayCatalogEntry[];
+};
+
+export type ToolGatewayResult = {
+  content: Array<{ type: string; [key: string]: unknown }>;
+  structuredContent?: Record<string, unknown> | undefined;
+  isError?: boolean | undefined;
+  _meta?: Record<string, unknown> | undefined;
+  [key: string]: unknown;
+};
+
+export type ToolGatewayCallRequest = {
+  operationId?: string | undefined;
+  catalogDigest: string;
+  identity: ToolGatewayIdentity;
+  arguments: Record<string, unknown>;
+  siteArtifactId?: string | undefined;
+  siteVersionId?: string | undefined;
+  approvalToken?: string | undefined;
+};
+
+export type ToolGatewayApprovalRequest = {
+  operationId: string;
+  catalogDigest: string;
+  identity: ToolGatewayIdentity;
+  arguments: Record<string, unknown>;
+};
+
+export type ToolGatewayApprovalResponse = {
+  operationId: string;
+  catalogDigest: string;
+  identity: ToolGatewayIdentity;
+  approvalToken: string;
+  expiresAt: string;
+};
+
+export type ToolGatewayCallResponse = {
+  operationId: string;
+  catalogDigest: string;
+  result: ToolGatewayResult;
+};
+
+export type ToolGatewayDeclarationsResponse = {
+  catalogDigest: string;
+  moduleSpecifier: string;
+  source: string;
+};
+
 export type ActivateCodexRealtimeConnectionRequest = {
   operationId: string;
   browserInstanceId: string;
@@ -610,6 +684,7 @@ export type McpConnectionAuthoritySelection = {
 
 export type McpServerConnectionRef = {
   connectionId?: string | undefined;
+  authoritySource?: "host" | undefined;
   provider?: string | undefined;
   providerDomain: string;
   kind?: ConnectionKind | undefined;
@@ -671,6 +746,7 @@ export type CreateConnectionRequest = {
   grantedScopes?: string[] | undefined;
   expiresAt?: string | null | undefined;
   metadata?: Record<string, unknown> | undefined;
+  operationId?: string | undefined;
 };
 
 export type PersonalGitHubConnectionMetadata = {
@@ -1072,6 +1148,8 @@ export type UpdateConnectionRequest = {
   grantedScopes?: string[] | undefined;
   expiresAt?: string | null | undefined;
   metadata?: Record<string, unknown> | undefined;
+  expectedVersion?: number | undefined;
+  operationId?: string | undefined;
 };
 
 export type ConnectionResponse = {
@@ -1749,6 +1827,8 @@ export const SESSION_EVENT_TYPES = [
   "sandbox.operation.failed",
   "session.command.backgrounded",
   "session.command.finished",
+  "session.wait.started",
+  "session.wait.finished",
   "sandbox.command.output.delta",
   "artifact.created",
   "goal.set",
@@ -1850,6 +1930,8 @@ export type SessionEvent = {
   sessionId: string;
   /** Per-session sequence number: positive, contiguous, strictly increasing. */
   sequence: number;
+  /** Server-owned durable high-water mark for a synthetic compact event. */
+  coveredThrough?: number | undefined;
   type: SessionEventType;
   payload: unknown;
   occurredAt: string;
@@ -1983,6 +2065,7 @@ export type ToolAuthNeededPayload = {
   providerDomain: string;
   provider?: string | undefined;
   connectionId?: string | null | undefined;
+  authoritySource?: "host" | undefined;
   reason:
     | "missing_connection"
     | "expired"
@@ -1991,6 +2074,15 @@ export type ToolAuthNeededPayload = {
     | "personal_authority_unavailable"
     | "unsupported_auth"
     | "resource_scope_unavailable";
+  hostReason?:
+    | "missing_connection"
+    | "expired"
+    | "insufficient_scope"
+    | "refresh_failed"
+    | "personal_authority_unavailable"
+    | "unsupported_auth"
+    | "resource_scope_unavailable"
+    | undefined;
   scopes?: string[] | undefined;
   resource?: string | undefined;
   selectedResources?: Array<{ id: string; kind: "repository" }> | undefined;
@@ -2060,7 +2152,14 @@ export type CodexFleetDecisionEventPayload = {
   actual: {
     outcome: "selected" | "waiting" | "none";
     candidateKey: string | null;
-    reason: "lease_reused" | "pin" | "rotation" | "active" | "all_capped" | "none";
+    reason:
+      | "lease_reused"
+      | "pin"
+      | "rotation"
+      | "active"
+      | "all_capped"
+      | "allocator_disabled"
+      | "none";
   };
   comparison: CodexFleetShadowComparison;
   replay: {
@@ -2211,11 +2310,16 @@ export type FsTreeNode = {
   truncated: boolean;
 };
 export type FsEncoding = "utf8" | "base64";
+export type FileSystemRouteIdentity = {
+  epoch: number;
+  root: string;
+};
 export type FsListRequest = {
   path?: string;
   depth?: number;
   maxEntries?: number;
   includeHidden?: boolean;
+  route?: FileSystemRouteIdentity;
 };
 export type FsListResponse = {
   root: FsTreeNode;
@@ -2228,6 +2332,7 @@ export type FsReadRequest = {
   path: string;
   encoding?: FsEncoding;
   maxBytes?: number;
+  route?: FileSystemRouteIdentity;
 };
 export type FsReadResponse = {
   path: string;
@@ -2252,26 +2357,36 @@ export type FsWriteRequest = {
   content: string;
   overwrite?: boolean;
   createParents?: boolean;
+  route?: FileSystemRouteIdentity;
 };
 export type FsWriteResponse = {
   path: string;
   sizeBytes: number;
   revision: number;
 };
-export type FsDeleteRequest = { path: string; recursive?: boolean };
+export type FsDeleteRequest = {
+  path: string;
+  recursive?: boolean;
+  route?: FileSystemRouteIdentity;
+};
 export type FsDeleteResponse = { revision: number };
 export type FsMoveRequest = {
   path: string;
   newPath: string;
   overwrite?: boolean;
   createParents?: boolean;
+  route?: FileSystemRouteIdentity;
 };
 export type FsMoveResponse = {
   path: string;
   newPath: string;
   revision: number;
 };
-export type FsMkdirRequest = { path: string; recursive?: boolean };
+export type FsMkdirRequest = {
+  path: string;
+  recursive?: boolean;
+  route?: FileSystemRouteIdentity;
+};
 export type FsMkdirResponse = { path: string; revision: number };
 
 // A2 Git request/response (the Pierre-diff feed).
@@ -2722,6 +2837,8 @@ export type CreateSessionRequest = {
   resources?: ResourceRef[] | undefined;
   /** Inline skills fixed onto this session; omitted children inherit them. */
   skills?: SessionSkill[] | undefined;
+  /** Installed session-selected Skill identities to freeze onto this session at creation. */
+  installedSkillIds?: string[] | undefined;
   tools?: ToolRef[] | undefined;
   metadata?: Record<string, unknown> | undefined;
   model?: string | undefined;
@@ -2836,7 +2953,7 @@ export type FirstPartyMcpToolName =
   | "goal_set"
   | "goal_update"
   | "goal_progress"
-  | "goal_wait"
+  | "wait_for_input"
   | "goal_complete"
   | "goal_pause"
   | "memory_search"
@@ -2876,6 +2993,7 @@ export type FirstPartyMcpToolName =
   | "session_get"
   | "session_events"
   | "session_wait"
+  | "command_wait"
   | "session_create"
   | "session_send_message"
   | "session_pause"
@@ -2968,6 +3086,8 @@ export type FirstPartyMcpToolName =
   | "artifacts_create"
   | "artifacts_publish"
   | "artifacts_rollback"
+  | "artifacts_archive"
+  | "artifacts_restore"
   | "editable_artifact_list"
   | "editable_artifact_create"
   | "editable_artifact_import"
@@ -3023,16 +3143,20 @@ export type ModelCapabilitiesV1 = {
 export type ModelCredentialSourceV1 =
   | { kind: "deployment"; mechanism: "api_key" | "azure_ad_bearer" }
   | { kind: "connected_subscription"; provider: "codex" | "xai" }
-  | { kind: "workspace_connection"; mechanism: "api_key" };
+  | { kind: "workspace_connection"; mechanism: "api_key" }
+  | { kind: "organization_connection"; mechanism: "api_key" };
 
 export type ModelBillingAttributionV1 = {
-  upstreamPayer: "deployment" | "workspace" | "connected_subscription";
+  upstreamPayer: "deployment" | "workspace" | "organization" | "connected_subscription";
   metering: "opengeni_credits" | "external";
 };
 
+export type ModelCostClassV1 = "free" | "credits" | "subscription" | "workspace" | "organization";
+
 export type ModelPricingV1 = {
   inputMicrosPerMillionTokens: number;
   cachedInputMicrosPerMillionTokens?: number | undefined;
+  cacheWriteMicrosPerMillionTokens?: number | undefined;
   outputMicrosPerMillionTokens: number;
   marginBps?: number | undefined;
 };
@@ -3062,7 +3186,7 @@ export type ClientModel = {
   provider: string;
   providerLabel: string;
   api: "responses" | "chat";
-  source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | undefined;
+  source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | "openrouter" | undefined;
   contextWindowTokens?: number | undefined;
   schemaVersion?: 1 | undefined;
   aliases?: string[] | undefined;
@@ -3082,6 +3206,7 @@ export type ClientModel = {
     | undefined;
   credentialSource?: ModelCredentialSourceV1 | undefined;
   billing?: ModelBillingAttributionV1 | undefined;
+  cost?: ModelCostClassV1 | undefined;
   capabilities?: ModelCapabilitiesV1 | undefined;
   pricing?: ModelPricingScheduleV1 | undefined;
   definitionVersion?: string | undefined;
@@ -3126,6 +3251,68 @@ export type WorkspaceModelCatalogResponse = {
   models: WorkspaceModelCatalogModel[];
 };
 
+export type WorkspaceGatewayCustomModel = {
+  id: string;
+  upstreamModelId: string;
+  label: string | null;
+  version: number;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type WorkspaceGatewayCustomModelsResponse = {
+  models: WorkspaceGatewayCustomModel[];
+};
+
+export type CreateWorkspaceGatewayCustomModelRequest = {
+  operationId: string;
+  upstreamModelId: string;
+  label?: string | undefined;
+};
+
+export type DeleteWorkspaceGatewayCustomModelRequest = {
+  expectedVersion: number;
+  operationId: string;
+};
+
+export type WorkspaceOpenRouterCustomModel = WorkspaceGatewayCustomModel;
+
+export type WorkspaceOpenRouterCustomModelsResponse = {
+  models: WorkspaceOpenRouterCustomModel[];
+};
+
+export type CreateWorkspaceOpenRouterCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+
+export type DeleteWorkspaceOpenRouterCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
+
+export type OrganizationModelProviderKind = "vercel_gateway" | "openrouter";
+
+export type OrganizationModelProviderConnection = {
+  providerKind: OrganizationModelProviderKind;
+  status: "active" | "revoked";
+  version: number;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type UpsertOrganizationModelProviderConnectionRequest = {
+  operationId: string;
+  expectedVersion?: number | undefined;
+  apiKey: string;
+};
+
+export type RevokeOrganizationModelProviderConnectionRequest = {
+  operationId: string;
+  expectedVersion: number;
+};
+
+export type OrganizationProviderCustomModel = WorkspaceGatewayCustomModel;
+export type OrganizationProviderCustomModelsResponse = {
+  models: OrganizationProviderCustomModel[];
+};
+export type CreateOrganizationProviderCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+export type DeleteOrganizationProviderCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
+
 /**
  * The workspace's hard model/provider allowlist. `null` means unrestricted for
  * that dimension; an empty array is an explicit total block.
@@ -3160,6 +3347,12 @@ export type CodexConnectionStatus = {
     label?: string | null;
     chatgptAccountId?: string | null;
   } | null;
+  /** Live model-catalog probe result for the active account only. */
+  activeAccountValid?: boolean;
+  /** Cached readiness of any account in the effective worker pool. */
+  poolReady?: boolean;
+  /** Cached unpinned worker routability; rotation-off remains active-pointer-only. */
+  workerRoutable?: boolean;
   /** How many Codex accounts the workspace has connected. */
   accountCount?: number;
   source?: WorkspaceCodexSubscriptionSource;
@@ -3938,6 +4131,16 @@ export type CreateOrganizationResponse = {
   organization: OrganizationSummary;
   workspaceId: string;
 };
+export type CreateAdditionalOrganizationRequest = {
+  name: string;
+  workspaceName: string;
+  operationId: string;
+};
+export type CreateAdditionalOrganizationResponse = {
+  organization: OrganizationSummary;
+  workspaceId: string;
+  personalWorkspaceId: string;
+};
 export type UpdateOrganizationNameRequest = {
   name: string;
   expectedUpdatedAt: string;
@@ -4482,7 +4685,7 @@ export type SessionGoalContinuation = {
   observedRevision: number;
   nextAttemptAt: string | null;
   lastError: string | null;
-  /** Agent-stated reason for a `held_for_input` hold; null otherwise. */
+  /** Agent-stated reason for a `wait_for_input` hold; null otherwise. */
   holdReason?: string | null | undefined;
 };
 
@@ -4682,6 +4885,8 @@ export type SessionSystemUpdateKind =
   | "goal_continuation"
   | "agent_message"
   | "agent_steer_instruction"
+  | "session_wait_timeout"
+  | "background_command_result"
   | "child_terminal_result"
   | "media_generation_result"
   | "child_requires_action"
@@ -4697,6 +4902,30 @@ export type SessionSystemUpdateState =
   | "superseded"
   | "failed";
 
+export type SessionSystemUpdatePayload =
+  | {
+      type: "session_wait_timeout";
+      waitTurnId: string;
+      deadlineAt: string;
+      reason: string;
+      [key: string]: unknown;
+    }
+  | {
+      type: "background_command_result";
+      commandId: string;
+      state: "exited" | "lost";
+      exitCode: number | null;
+      reason: string;
+      outputLocator: {
+        eventType: "sandbox.command.output.delta";
+        commandId: string;
+      };
+      [key: string]: unknown;
+    }
+  | ({
+      type: Exclude<SessionSystemUpdateKind, "session_wait_timeout" | "background_command_result">;
+    } & Record<string, unknown>);
+
 export type SessionSystemUpdate = {
   id: string;
   sessionId: string;
@@ -4705,7 +4934,7 @@ export type SessionSystemUpdate = {
   sourceId: string;
   dedupeKey: string;
   summary: string;
-  payload: Record<string, unknown>;
+  payload: SessionSystemUpdatePayload;
   lineage: Record<string, unknown>;
   state: SessionSystemUpdateState;
   deliveredTurnId: string | null;
@@ -5959,10 +6188,12 @@ export type CapabilityPackSkillFile = {
 export type CapabilityPackSkill = {
   name: string;
   description?: string | undefined;
+  /** Omitted means workspace-wide; session_selected requires explicit session attachment. */
+  activationMode?: "workspace_managed" | "session_selected" | undefined;
   files: CapabilityPackSkillFile[];
 };
 
-export type SessionSkill = CapabilityPackSkill;
+export type SessionSkill = Omit<CapabilityPackSkill, "activationMode">;
 
 export type CapabilityPackVariableSetSpec = {
   description: string;
@@ -6056,6 +6287,7 @@ export type RegisterCapabilityPackRequest = {
     | {
         name: string;
         description?: string | undefined;
+        activationMode?: "workspace_managed" | "session_selected" | undefined;
         files: CapabilityPackSkillFile[];
       }[]
     | undefined;
@@ -6507,6 +6739,7 @@ export type CapabilityCatalogItem = {
   /** The connection backing this enabled installation, or null when none is involved. */
   connectionRef: {
     connectionId?: string | undefined;
+    authoritySource?: "host" | undefined;
     providerDomain: string;
     kind: string;
     subjectScope?: "subject" | "workspace" | undefined;
@@ -7129,6 +7362,37 @@ export type GitHubRepositoriesResponse = {
   repositories: GitHubRepository[];
 };
 
+export type VerifyPublicGitHubRepositoryRefRequest = {
+  url: string;
+  ref: string;
+};
+
+export type VerifyPublicGitHubRepositoryRefResponse = {
+  owner: string;
+  name: string;
+  fullName: string;
+  canonicalUrl: string;
+  cloneUrl: string;
+  defaultBranch: string;
+  ref: string;
+  commitSha: string;
+};
+
+export type GitHubRepositoryBranch = {
+  name: string;
+  isDefault: boolean;
+};
+
+export type ListGitHubRepositoryBranchesOptions = {
+  cursor?: number | undefined;
+  limit?: number | undefined;
+};
+
+export type GitHubRepositoryBranchesResponse = {
+  branches: GitHubRepositoryBranch[];
+  nextCursor: number | null;
+};
+
 export type CreateGitHubAppManifestRequest = {
   appName?: string | undefined;
   organization?: string | undefined;
@@ -7234,6 +7498,8 @@ export type InsightsModelUsageRow = {
   creditUsd: number;
   estimatedProviderUsd: number;
   estimatedProviderCostKnownCalls: number;
+  equivalentCreditUsd: number;
+  equivalentCreditCostKnownCalls: number;
 };
 
 export type InsightsSeriesPoint = {
@@ -7241,6 +7507,8 @@ export type InsightsSeriesPoint = {
   modelCostUsd: number;
   estimatedProviderUsd: number;
   estimatedProviderCostKnownCalls: number;
+  equivalentCreditUsd: number;
+  equivalentCreditCostKnownCalls: number;
   warmSeconds: number;
   inputTokens: number;
   outputTokens: number;
@@ -7272,6 +7540,8 @@ export type InsightsSpendDriver = {
   creditUsd: number;
   estimatedProviderUsd: number;
   estimatedProviderCostKnownCalls: number;
+  equivalentCreditUsd: number;
+  equivalentCreditCostKnownCalls: number;
   tokens: number;
   cacheHitPct: number;
   pctOfCreditUsd: number;
@@ -7317,6 +7587,8 @@ export type InsightsScheduleRow = {
   creditUsd: number | null;
   estimatedProviderUsd: number | null;
   estimatedProviderCostKnownCalls: number | null;
+  equivalentCreditUsd: number | null;
+  equivalentCreditCostKnownCalls: number | null;
   tokens: number | null;
   cacheHitPct: number | null;
   billing: InsightsBillingPath | null;
@@ -7341,6 +7613,7 @@ export type InsightsModelCallRow = {
   totalTokens: number | null;
   creditUsd: number;
   estimatedProviderUsd: number | null;
+  equivalentCreditUsd: number | null;
   pricingSource: InsightsPricingSource | null;
 };
 
@@ -7401,6 +7674,10 @@ export type WorkspaceInsightsSnapshot = {
   priorEstimatedProviderUsd: number;
   estimatedProviderCostKnownCalls: number;
   priorEstimatedProviderCostKnownCalls: number;
+  equivalentCreditUsd: number;
+  priorEquivalentCreditUsd: number;
+  equivalentCreditCostKnownCalls: number;
+  priorEquivalentCreditCostKnownCalls: number;
   modelCalls: number;
   priorInputTokens: number;
   priorTotalTokens: number;

package/src/workspace-artifacts.ts

@@ -1,3 +1,15 @@
+import type { ToolGatewayIdentity } from "./types";
+
+export type WorkspaceArtifactSourceFile = {
+  path: string;
+  content: string;
+};
+
+export type WorkspaceArtifactSourceBundle = {
+  entrypoint: string;
+  files: WorkspaceArtifactSourceFile[];
+};
+
 export type WorkspaceArtifactVersion = {
   id: string;
   accountId: string;
@@ -7,6 +19,9 @@ export type WorkspaceArtifactVersion = {
   contentType: "text/html";
   contentSha256: string;
   sizeBytes: number;
+  sourceSha256: string | null;
+  sourceSizeBytes: number | null;
+  requestedTools: ToolGatewayIdentity[];
   sourceSessionId: string | null;
   sourceTurnId: string | null;
   sourceAttemptId: string | null;
@@ -34,7 +49,7 @@ export type WorkspaceArtifactEvent = {
   accountId: string;
   workspaceId: string;
   artifactId: string;
-  type: "published" | "rolled_back";
+  type: "published" | "rolled_back" | "archived" | "restored";
   fromVersionId: string | null;
   toVersionId: string;
   sourceSessionId: string | null;
@@ -46,7 +61,11 @@ export type WorkspaceArtifactEvent = {
   createdAt: string;
 };
 
-export type WorkspaceArtifactListOptions = { limit?: number; cursor?: string };
+export type WorkspaceArtifactListOptions = {
+  limit?: number;
+  cursor?: string;
+  status?: WorkspaceArtifact["status"];
+};
 export type WorkspaceArtifactListResponse = {
   artifacts: WorkspaceArtifact[];
   nextCursor: string | null;
@@ -65,6 +84,8 @@ export type WorkspaceArtifactContentResponse = {
   contentType: "text/html";
   contentSha256: string;
   html: string;
+  source: WorkspaceArtifactSourceBundle;
+  requestedTools: ToolGatewayIdentity[];
 };
 export type WorkspaceArtifactMutationResponse = {
   artifact: WorkspaceArtifact;
@@ -77,12 +98,16 @@ export type CreateWorkspaceArtifactRequest = {
   title: string;
   description?: string | null;
   html: string;
+  source?: WorkspaceArtifactSourceBundle;
+  requestedTools?: ToolGatewayIdentity[];
   idempotencyKey: string;
 };
 export type PublishWorkspaceArtifactVersionRequest = {
   title?: string;
   description?: string | null;
   html: string;
+  source?: WorkspaceArtifactSourceBundle;
+  requestedTools?: ToolGatewayIdentity[];
   expectedCurrentVersionId: string;
   idempotencyKey: string;
 };
@@ -92,3 +117,9 @@ export type RollbackWorkspaceArtifactRequest = {
   reason: string;
   idempotencyKey: string;
 };
+export type SetWorkspaceArtifactStatusRequest = {
+  status: "active" | "archived";
+  expectedCurrentVersionId: string;
+  reason: string;
+  idempotencyKey: string;
+};

package/dist/chunk-C4DJPZRU.js.map

@@ -1 +0,0 @@
-{"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        ? (decoded?.message ?? \"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 ??\n      decoded?.outcomeUnknown ??\n      (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  outcomeUnknown: 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 outcomeUnknown =\n      typeof nested.outcomeUnknown === \"boolean\" ? nested.outcomeUnknown : undefined;\n    const details = boundedApiDetails(nested.details);\n    if (\n      !code &&\n      !message &&\n      !requestId &&\n      retryable === undefined &&\n      outcomeUnknown === undefined &&\n      !details\n    )\n      return null;\n    return {\n      code,\n      message,\n      requestId,\n      retryable,\n      outcomeUnknown,\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 legacy 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":";AACO,IAAM,mBAAN,cAA+B,MAAM;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,QACA,MACA,UAOI,CAAC,GACL;AACA,UAAM,UAAU,mBAAmB,IAAI;AACvC,UAAM,gBAAgB,SAAS,aAAa,qBAAqB,QAAQ,aAAa;AACtF,UAAM,iBAAiB,UAAU,OAAO,UAAU;AAClD,UAAM,eAAe,QAAQ,aAAa;AAC1C,UAAM,UAAU,SAAS,YAAY,eAAe,oBAAoB,QAAQ;AAChF,UAAM,iBACJ,QAAQ,mBACP,kBAAkB,eACd,SAAS,WAAW,sDACrB,gBAAgB,MAAM,KAAK,OAAO;AACxC,UAAM,gBAAgB,GAAG,cAAc,eAAe,aAAa,MAAM,cAAc;AACvF,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OACH,QAAQ,QACR,SAAS,SACR,kBAAkB,eAAe,yBAAyB;AAC7D,SAAK,YAAY,QAAQ,aAAa,SAAS,aAAa,mBAAmB,MAAM;AACrF,SAAK,gBAAgB;AACrB,SAAK,iBACH,QAAQ,kBACR,SAAS,mBACR,kBAAkB,CAAC,CAAC,QAAQ,YAAY,CAAC;AAC5C,SAAK,OAAO,CAAC,gBAAgB,UAAU,OAAO;AAC9C,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;AAEA,SAAS,mBAAmB,MAOnB;AACP,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI;AACF,UAAM,UAAmB,KAAK,MAAM,IAAI;AACxC,QAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,EAAG,QAAO;AAC9E,UAAM,SAAS;AACf,UAAM,SACJ,OAAO,SAAS,OAAO,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,OAAO,KAAK,IAC1E,OAAO,QACR;AACN,UAAM,OAAO,gBAAgB,OAAO,IAAI;AACxC,UAAM,UAAU,gBAAgB,OAAO,OAAO;AAC9C,UAAM,YAAY,qBAAqB,OAAO,SAAS;AACvD,UAAM,YAAY,OAAO,OAAO,cAAc,YAAY,OAAO,YAAY;AAC7E,UAAM,iBACJ,OAAO,OAAO,mBAAmB,YAAY,OAAO,iBAAiB;AACvE,UAAM,UAAU,kBAAkB,OAAO,OAAO;AAChD,QACE,CAAC,QACD,CAAC,WACD,CAAC,aACD,cAAc,UACd,mBAAmB,UACnB,CAAC;AAED,aAAO;AACT,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,kBAAkB,OAAqD;AAC9E,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG;AACjE,QAAM,UAAU,OAAO,QAAQ,KAAgC,EAAE,MAAM,GAAG,EAAE;AAC5E,QAAM,UAAmC,CAAC;AAC1C,aAAW,CAAC,KAAK,KAAK,KAAK,SAAS;AAClC,QAAI,CAAC,yBAAyB,KAAK,GAAG,EAAG;AACzC,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,UAAU,gBAAgB,KAAK;AACrC,UAAI,YAAY,OAAW,SAAQ,GAAG,IAAI;AAAA,IAC5C,WAAW,OAAO,UAAU,YAAY,OAAO,UAAU,aAAa,UAAU,MAAM;AACpF,cAAQ,GAAG,IAAI;AAAA,IACjB;AAAA,EACF;AACA,SAAO,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,UAAU;AACrD;AAEA,SAAS,gBAAgB,OAAoC;AAC3D,MAAI,OAAO,UAAU,SAAU;AAC/B,QAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,KAAK;AAC5C,SAAO,MAAM,cAAc,MAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,MAAM,MAAM,GAAG,GAAG,CAAC;AACvF;AAEA,SAAS,mBAAmB,QAAyB;AACnD,SAAO,WAAW,OAAO,WAAW,OAAO,WAAW,OAAO,WAAW,OAAO,UAAU;AAC3F;AAEA,SAAS,qBAAqB,OAAoC;AAChE,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,OAAO,CAAC,aAAa,KAAK,KAAK,GAAG;AAChF;AAAA,EACF;AACA,SAAO;AACT;AAGO,IAAM,iCAAN,cAA6C,iBAAiB;AAAC;AAG/D,IAAM,mCAAN,cAA+C,MAAM;AAAA,EACjD;AAAA,EACA;AAAA,EAET,YAAY,UAAkB,QAAgB;AAC5C,UAAM,kDAAkD,QAAQ,gBAAgB,MAAM,EAAE;AACxF,SAAK,OAAO;AACZ,SAAK,WAAW;AAChB,SAAK,SAAS;AAAA,EAChB;AACF;AAGO,IAAM,sBAAN,cAAkC,MAAM;AAAA,EAC7C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,aAAa,OAAyB;AACpD,SACG,iBAAiB,gBAAgB,MAAM,SAAS,gBAChD,iBAAiB,SAAS,MAAM,SAAS;AAE9C;AAQO,SAAS,uBAAuB,OAAyB;AAC9D,MAAI,iBAAiB,iBAAkB,QAAO,MAAM;AACpD,SAAO,iBAAiB;AAC1B;","names":[]}