@tensorlakeai/tensorlake 0.5.153 → 0.5.154

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -181,7 +181,8 @@ declare enum SnapshotStatus {
181
181
  COMPLETED = "completed",
182
182
  FAILED = "failed",
183
183
  DELETING = "deleting",
184
- REPLICATING = "replicating"
184
+ REPLICATING = "replicating",
185
+ UNKNOWN = "unknown"
185
186
  }
186
187
  /**
187
188
  * Snapshot type for sandbox snapshot creation.
@@ -528,6 +529,8 @@ interface ListArchivedSandboxesResponse {
528
529
  interface CreateSnapshotResponse {
529
530
  snapshotId: string;
530
531
  status: SnapshotStatus;
532
+ /** Original response, populated when decoded by the SDK. */
533
+ raw?: Record<string, unknown>;
531
534
  }
532
535
  interface SnapshotInfo {
533
536
  snapshotId: string;
@@ -535,6 +538,8 @@ interface SnapshotInfo {
535
538
  sandboxId: string;
536
539
  baseImage: string;
537
540
  status: SnapshotStatus;
541
+ /** Original response, populated when decoded by the SDK. */
542
+ raw?: Record<string, unknown>;
538
543
  snapshotType?: SnapshotType;
539
544
  error?: string;
540
545
  snapshotUri?: string;
@@ -2052,6 +2057,10 @@ declare class RepositoryClient {
2052
2057
  * the legacy functions in `sandbox-image.ts` keep their own requests,
2053
2058
  * results, errors and interruption behavior.
2054
2059
  *
2060
+ * Response enum fields map unfamiliar wire values to `UNKNOWN`. `raw` is
2061
+ * diagnostic only and excluded from equality, hashing, and SDK serialization
2062
+ * (`JSON.stringify`). Events retain their original wire strings.
2063
+ *
2055
2064
  * **Build ids are the immutable record.** An image name and its `image_` id
2056
2065
  * name the *current* image; a rebuild replaces what they point at. A build id
2057
2066
  * and its result never change, so `wait` returns this build's own result even
@@ -2070,19 +2079,65 @@ declare class RepositoryClient {
2070
2079
  * {@link ImageBuildTimeoutError} and leaves the build running. Abandoning a
2071
2080
  * promise, losing the process or dropping a handle never cancels the build.
2072
2081
  */
2082
+ declare enum ImageBuildStatus {
2083
+ PENDING = "pending",
2084
+ RUNNING = "running",
2085
+ SUCCEEDED = "succeeded",
2086
+ FAILED = "failed",
2087
+ CANCELLED = "cancelled",
2088
+ UNKNOWN = "unknown"
2089
+ }
2090
+ declare enum ImageBuildPhase {
2091
+ AWAITING_CONTEXT = "awaiting_context",
2092
+ STARTING_BUILDER = "starting_builder",
2093
+ EXECUTING = "executing",
2094
+ SNAPSHOTTING = "snapshotting",
2095
+ PUBLISHING = "publishing",
2096
+ FINISHED = "finished",
2097
+ UNKNOWN = "unknown"
2098
+ }
2099
+ declare enum ImageBuildKind {
2100
+ DOCKERFILE = "dockerfile",
2101
+ IMPORT = "import",
2102
+ DIRECT = "direct",
2103
+ UNKNOWN = "unknown"
2104
+ }
2105
+ declare enum ImageBuildCancellationOutcome {
2106
+ CANCELLED = "cancelled",
2107
+ ALREADY_CANCELLED = "already_cancelled",
2108
+ ALREADY_COMPLETED = "already_completed",
2109
+ ALREADY_FAILED = "already_failed",
2110
+ NOT_ADMITTED = "not_admitted",
2111
+ UNCONFIRMED = "unconfirmed",
2112
+ UNKNOWN = "unknown"
2113
+ }
2114
+ declare enum ImageBuildErrorCode {
2115
+ USAGE = "usage",
2116
+ AUTH = "auth",
2117
+ NOT_FOUND = "not_found",
2118
+ IMAGE_BUILD_IN_PROGRESS = "image_build_in_progress",
2119
+ CLIENT_REQUEST_ID_MISMATCH = "client_request_id_mismatch",
2120
+ FAILED = "failed",
2121
+ CANCELLED = "cancelled",
2122
+ TIMEOUT = "timeout",
2123
+ INTERRUPTED = "interrupted",
2124
+ SERVICE = "service",
2125
+ INTERNAL = "internal",
2126
+ UNKNOWN = "unknown"
2127
+ }
2073
2128
  /** Structured payload the native binding attaches to image-build failures. */
2074
2129
  interface ImageBuildErrorDetails {
2075
- code: string;
2130
+ code: ImageBuildErrorCode;
2076
2131
  message: string;
2077
2132
  buildId?: string | null;
2078
2133
  clientRequestId?: string | null;
2079
2134
  imageName?: string | null;
2080
2135
  activeBuildId?: string | null;
2081
- activeKind?: string | null;
2082
- activeStatus?: string | null;
2136
+ activeKind?: ImageBuildKind | null;
2137
+ activeStatus?: ImageBuildStatus | null;
2083
2138
  error?: string | null;
2084
- info?: Record<string, unknown> | null;
2085
- outcome?: string | null;
2139
+ info?: ImageBuildInfo | null;
2140
+ outcome?: ImageBuildCancellationOutcome | null;
2086
2141
  confirmed?: boolean | null;
2087
2142
  result?: Record<string, unknown> | null;
2088
2143
  waitedSecs?: number | null;
@@ -2090,10 +2145,11 @@ interface ImageBuildErrorDetails {
2090
2145
  }
2091
2146
  /** An Image Service build operation failed. `code` is stable. */
2092
2147
  declare class ImageBuildError extends Error {
2093
- readonly code: string;
2148
+ readonly code: ImageBuildErrorCode;
2094
2149
  readonly buildId?: string;
2095
2150
  readonly clientRequestId?: string;
2096
2151
  readonly details: ImageBuildErrorDetails;
2152
+ readonly raw: Readonly<Record<string, unknown>>;
2097
2153
  constructor(details: ImageBuildErrorDetails);
2098
2154
  }
2099
2155
  /**
@@ -2111,8 +2167,8 @@ declare class ImageBuildNotFoundError extends ImageBuildError {
2111
2167
  declare class ImageBuildInProgressError extends ImageBuildError {
2112
2168
  readonly imageName?: string;
2113
2169
  readonly activeBuildId?: string;
2114
- readonly activeKind?: string;
2115
- readonly activeStatus?: string;
2170
+ readonly activeKind?: ImageBuildKind;
2171
+ readonly activeStatus?: ImageBuildStatus;
2116
2172
  constructor(details: ImageBuildErrorDetails);
2117
2173
  }
2118
2174
  /** The service reports the build failed; `error` is its message. */
@@ -2137,13 +2193,11 @@ declare class ImageBuildTimeoutError extends ImageBuildError {
2137
2193
  * not to publish. `not_admitted` is an observation, not a cancellation.
2138
2194
  */
2139
2195
  declare class ImageBuildInterruptedError extends ImageBuildError {
2140
- readonly outcome: string;
2196
+ readonly outcome: ImageBuildCancellationOutcome;
2141
2197
  readonly confirmed: boolean;
2142
2198
  readonly result?: Record<string, unknown>;
2143
2199
  constructor(details: ImageBuildErrorDetails);
2144
2200
  }
2145
- type ImageBuildStatus = "pending" | "running" | "succeeded" | "failed" | "cancelled" | string;
2146
- type ImageBuildPhase = "awaiting_context" | "starting_builder" | "executing" | "snapshotting" | "publishing" | "finished" | string;
2147
2201
  /**
2148
2202
  * The published image of a succeeded build, in the sandbox-template shape
2149
2203
  * the merged catalog answers (derived by the core from the Image Service's
@@ -2159,7 +2213,7 @@ type ImageBuildResult = SandboxTemplate;
2159
2213
  interface ImageBuildInfo {
2160
2214
  buildId: string;
2161
2215
  clientRequestId?: string | null;
2162
- kind: string;
2216
+ kind?: ImageBuildKind | null;
2163
2217
  name?: string | null;
2164
2218
  status: ImageBuildStatus;
2165
2219
  phase?: ImageBuildPhase | null;
@@ -2180,10 +2234,11 @@ interface ImageBuildInfo {
2180
2234
  * request id: not a cancellation and no promise about a delayed admission).
2181
2235
  */
2182
2236
  interface CancelImageBuildOutcome {
2183
- outcome: string;
2237
+ outcome: ImageBuildCancellationOutcome;
2184
2238
  build: ImageBuildInfo | null;
2185
2239
  /** Whether the build is known not to publish. */
2186
2240
  confirmed: boolean;
2241
+ raw: Record<string, unknown>;
2187
2242
  }
2188
2243
  interface ImageBuildEvent {
2189
2244
  type: string;
@@ -2752,4 +2807,4 @@ declare class RequestExecutionError extends Error {
2752
2807
  constructor(message: string, functionName?: string);
2753
2808
  }
2754
2809
 
2755
- export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancelledError, ImageBuildError, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildNotFoundError, type ImageBuildPhase, type ImageBuildResult, type ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };
2810
+ export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };
package/dist/index.d.ts CHANGED
@@ -181,7 +181,8 @@ declare enum SnapshotStatus {
181
181
  COMPLETED = "completed",
182
182
  FAILED = "failed",
183
183
  DELETING = "deleting",
184
- REPLICATING = "replicating"
184
+ REPLICATING = "replicating",
185
+ UNKNOWN = "unknown"
185
186
  }
186
187
  /**
187
188
  * Snapshot type for sandbox snapshot creation.
@@ -528,6 +529,8 @@ interface ListArchivedSandboxesResponse {
528
529
  interface CreateSnapshotResponse {
529
530
  snapshotId: string;
530
531
  status: SnapshotStatus;
532
+ /** Original response, populated when decoded by the SDK. */
533
+ raw?: Record<string, unknown>;
531
534
  }
532
535
  interface SnapshotInfo {
533
536
  snapshotId: string;
@@ -535,6 +538,8 @@ interface SnapshotInfo {
535
538
  sandboxId: string;
536
539
  baseImage: string;
537
540
  status: SnapshotStatus;
541
+ /** Original response, populated when decoded by the SDK. */
542
+ raw?: Record<string, unknown>;
538
543
  snapshotType?: SnapshotType;
539
544
  error?: string;
540
545
  snapshotUri?: string;
@@ -2052,6 +2057,10 @@ declare class RepositoryClient {
2052
2057
  * the legacy functions in `sandbox-image.ts` keep their own requests,
2053
2058
  * results, errors and interruption behavior.
2054
2059
  *
2060
+ * Response enum fields map unfamiliar wire values to `UNKNOWN`. `raw` is
2061
+ * diagnostic only and excluded from equality, hashing, and SDK serialization
2062
+ * (`JSON.stringify`). Events retain their original wire strings.
2063
+ *
2055
2064
  * **Build ids are the immutable record.** An image name and its `image_` id
2056
2065
  * name the *current* image; a rebuild replaces what they point at. A build id
2057
2066
  * and its result never change, so `wait` returns this build's own result even
@@ -2070,19 +2079,65 @@ declare class RepositoryClient {
2070
2079
  * {@link ImageBuildTimeoutError} and leaves the build running. Abandoning a
2071
2080
  * promise, losing the process or dropping a handle never cancels the build.
2072
2081
  */
2082
+ declare enum ImageBuildStatus {
2083
+ PENDING = "pending",
2084
+ RUNNING = "running",
2085
+ SUCCEEDED = "succeeded",
2086
+ FAILED = "failed",
2087
+ CANCELLED = "cancelled",
2088
+ UNKNOWN = "unknown"
2089
+ }
2090
+ declare enum ImageBuildPhase {
2091
+ AWAITING_CONTEXT = "awaiting_context",
2092
+ STARTING_BUILDER = "starting_builder",
2093
+ EXECUTING = "executing",
2094
+ SNAPSHOTTING = "snapshotting",
2095
+ PUBLISHING = "publishing",
2096
+ FINISHED = "finished",
2097
+ UNKNOWN = "unknown"
2098
+ }
2099
+ declare enum ImageBuildKind {
2100
+ DOCKERFILE = "dockerfile",
2101
+ IMPORT = "import",
2102
+ DIRECT = "direct",
2103
+ UNKNOWN = "unknown"
2104
+ }
2105
+ declare enum ImageBuildCancellationOutcome {
2106
+ CANCELLED = "cancelled",
2107
+ ALREADY_CANCELLED = "already_cancelled",
2108
+ ALREADY_COMPLETED = "already_completed",
2109
+ ALREADY_FAILED = "already_failed",
2110
+ NOT_ADMITTED = "not_admitted",
2111
+ UNCONFIRMED = "unconfirmed",
2112
+ UNKNOWN = "unknown"
2113
+ }
2114
+ declare enum ImageBuildErrorCode {
2115
+ USAGE = "usage",
2116
+ AUTH = "auth",
2117
+ NOT_FOUND = "not_found",
2118
+ IMAGE_BUILD_IN_PROGRESS = "image_build_in_progress",
2119
+ CLIENT_REQUEST_ID_MISMATCH = "client_request_id_mismatch",
2120
+ FAILED = "failed",
2121
+ CANCELLED = "cancelled",
2122
+ TIMEOUT = "timeout",
2123
+ INTERRUPTED = "interrupted",
2124
+ SERVICE = "service",
2125
+ INTERNAL = "internal",
2126
+ UNKNOWN = "unknown"
2127
+ }
2073
2128
  /** Structured payload the native binding attaches to image-build failures. */
2074
2129
  interface ImageBuildErrorDetails {
2075
- code: string;
2130
+ code: ImageBuildErrorCode;
2076
2131
  message: string;
2077
2132
  buildId?: string | null;
2078
2133
  clientRequestId?: string | null;
2079
2134
  imageName?: string | null;
2080
2135
  activeBuildId?: string | null;
2081
- activeKind?: string | null;
2082
- activeStatus?: string | null;
2136
+ activeKind?: ImageBuildKind | null;
2137
+ activeStatus?: ImageBuildStatus | null;
2083
2138
  error?: string | null;
2084
- info?: Record<string, unknown> | null;
2085
- outcome?: string | null;
2139
+ info?: ImageBuildInfo | null;
2140
+ outcome?: ImageBuildCancellationOutcome | null;
2086
2141
  confirmed?: boolean | null;
2087
2142
  result?: Record<string, unknown> | null;
2088
2143
  waitedSecs?: number | null;
@@ -2090,10 +2145,11 @@ interface ImageBuildErrorDetails {
2090
2145
  }
2091
2146
  /** An Image Service build operation failed. `code` is stable. */
2092
2147
  declare class ImageBuildError extends Error {
2093
- readonly code: string;
2148
+ readonly code: ImageBuildErrorCode;
2094
2149
  readonly buildId?: string;
2095
2150
  readonly clientRequestId?: string;
2096
2151
  readonly details: ImageBuildErrorDetails;
2152
+ readonly raw: Readonly<Record<string, unknown>>;
2097
2153
  constructor(details: ImageBuildErrorDetails);
2098
2154
  }
2099
2155
  /**
@@ -2111,8 +2167,8 @@ declare class ImageBuildNotFoundError extends ImageBuildError {
2111
2167
  declare class ImageBuildInProgressError extends ImageBuildError {
2112
2168
  readonly imageName?: string;
2113
2169
  readonly activeBuildId?: string;
2114
- readonly activeKind?: string;
2115
- readonly activeStatus?: string;
2170
+ readonly activeKind?: ImageBuildKind;
2171
+ readonly activeStatus?: ImageBuildStatus;
2116
2172
  constructor(details: ImageBuildErrorDetails);
2117
2173
  }
2118
2174
  /** The service reports the build failed; `error` is its message. */
@@ -2137,13 +2193,11 @@ declare class ImageBuildTimeoutError extends ImageBuildError {
2137
2193
  * not to publish. `not_admitted` is an observation, not a cancellation.
2138
2194
  */
2139
2195
  declare class ImageBuildInterruptedError extends ImageBuildError {
2140
- readonly outcome: string;
2196
+ readonly outcome: ImageBuildCancellationOutcome;
2141
2197
  readonly confirmed: boolean;
2142
2198
  readonly result?: Record<string, unknown>;
2143
2199
  constructor(details: ImageBuildErrorDetails);
2144
2200
  }
2145
- type ImageBuildStatus = "pending" | "running" | "succeeded" | "failed" | "cancelled" | string;
2146
- type ImageBuildPhase = "awaiting_context" | "starting_builder" | "executing" | "snapshotting" | "publishing" | "finished" | string;
2147
2201
  /**
2148
2202
  * The published image of a succeeded build, in the sandbox-template shape
2149
2203
  * the merged catalog answers (derived by the core from the Image Service's
@@ -2159,7 +2213,7 @@ type ImageBuildResult = SandboxTemplate;
2159
2213
  interface ImageBuildInfo {
2160
2214
  buildId: string;
2161
2215
  clientRequestId?: string | null;
2162
- kind: string;
2216
+ kind?: ImageBuildKind | null;
2163
2217
  name?: string | null;
2164
2218
  status: ImageBuildStatus;
2165
2219
  phase?: ImageBuildPhase | null;
@@ -2180,10 +2234,11 @@ interface ImageBuildInfo {
2180
2234
  * request id: not a cancellation and no promise about a delayed admission).
2181
2235
  */
2182
2236
  interface CancelImageBuildOutcome {
2183
- outcome: string;
2237
+ outcome: ImageBuildCancellationOutcome;
2184
2238
  build: ImageBuildInfo | null;
2185
2239
  /** Whether the build is known not to publish. */
2186
2240
  confirmed: boolean;
2241
+ raw: Record<string, unknown>;
2187
2242
  }
2188
2243
  interface ImageBuildEvent {
2189
2244
  type: string;
@@ -2752,4 +2807,4 @@ declare class RequestExecutionError extends Error {
2752
2807
  constructor(message: string, functionName?: string);
2753
2808
  }
2754
2809
 
2755
- export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancelledError, ImageBuildError, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildNotFoundError, type ImageBuildPhase, type ImageBuildResult, type ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };
2810
+ export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };