tensorlake 0.5.126 → 0.5.128

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
@@ -158,7 +158,9 @@ declare enum SandboxStatus {
158
158
  SUSPENDING = "suspending",
159
159
  SUSPENDED = "suspended",
160
160
  TERMINATED = "terminated",
161
- TIMEOUT = "timeout"
161
+ TIMEOUT = "timeout",
162
+ /** Terminal status used by blocking create/claim responses. */
163
+ FAILED = "failed"
162
164
  }
163
165
  declare enum SnapshotStatus {
164
166
  IN_PROGRESS = "in_progress",
@@ -1433,12 +1435,89 @@ declare class CloudClient {
1433
1435
  private secretCollectionPath;
1434
1436
  }
1435
1437
 
1438
+ /** Shared command runner for the separately installed local mount daemon. */
1439
+ declare class MountCli {
1440
+ private readonly command;
1441
+ private readonly envOverrides;
1442
+ private binary;
1443
+ constructor(command: "fs" | "git", envOverrides: Record<string, string>);
1444
+ private findCli;
1445
+ protected run(args: string[], timeoutMs?: number): Promise<string>;
1446
+ }
1447
+
1448
+ interface RepositoryMountOptions {
1449
+ /** Stateless read-only view; cannot be combined with publish or workspace. */
1450
+ readOnly?: boolean;
1451
+ /** Publish each explicit snapshot onto the mounted branch. */
1452
+ publish?: boolean;
1453
+ /** Resume a private workspace; cannot be combined with publish or readOnly. */
1454
+ workspace?: string;
1455
+ }
1456
+ interface RepositoryUnmountOptions {
1457
+ /** Delete the private server workspace after detaching. Defaults to false. */
1458
+ deleteWorkspace?: boolean;
1459
+ /** Drop unpublished local state. Defaults to false. */
1460
+ discard?: boolean;
1461
+ }
1462
+ /** Stable fields from `tl git status --json`, with the full payload in raw. */
1463
+ interface RepositoryMountStatus {
1464
+ path: string;
1465
+ repository: string | null;
1466
+ reference: string | null;
1467
+ workspaceId: string | null;
1468
+ state: string | null;
1469
+ localChanges: boolean | null;
1470
+ raw: Record<string, unknown>;
1471
+ }
1472
+ /** @internal CLI implementation; obtain mounts through RepositoryClient. */
1473
+ declare class GitCli extends MountCli {
1474
+ constructor(envOverrides: Record<string, string>);
1475
+ mount(target: string, localPath: string, options?: RepositoryMountOptions): Promise<RepositoryMount>;
1476
+ unmount(localPath: string, options?: RepositoryUnmountOptions): Promise<void>;
1477
+ status(localPath?: string): Promise<RepositoryMountStatus>;
1478
+ snapshot(path: string, message?: string): Promise<void>;
1479
+ sync(path: string, target?: string): Promise<void>;
1480
+ rebase(path: string, target: string, failOnConflict: boolean): Promise<void>;
1481
+ promote(path: string, branch: string, merge: boolean): Promise<void>;
1482
+ prefetch(path: string): Promise<void>;
1483
+ }
1484
+ /** A repository mounted on the machine running Node.js via the `tl` CLI daemon. */
1485
+ declare class RepositoryMount {
1486
+ private readonly cli;
1487
+ /** Initial source (`repo[:ref][//subtree]`); sync/rebase can change the base. */
1488
+ readonly target: string;
1489
+ readonly path: string;
1490
+ readonly readOnly: boolean;
1491
+ /** @internal Obtain instances via RepositoryClient.mount(). */
1492
+ constructor(cli: GitCli,
1493
+ /** Initial source (`repo[:ref][//subtree]`); sync/rebase can change the base. */
1494
+ target: string, path: string, readOnly: boolean);
1495
+ /** Inspect workspace state, pending changes, and daemon diagnostics. */
1496
+ status(): Promise<RepositoryMountStatus>;
1497
+ /** Materialize autosaved edits as a commit; publish mounts also update their branch. */
1498
+ snapshot(message?: string): Promise<void>;
1499
+ /** Refresh the current source, or switch an unsnapshotted workspace to a new base. */
1500
+ sync(target?: string): Promise<void>;
1501
+ /** Replay snapshots and pending edits onto another base. Conflicts become diff3 markers by default. */
1502
+ rebase(target: string, options?: {
1503
+ failOnConflict?: boolean;
1504
+ }): Promise<void>;
1505
+ /** Publish the workspace to a branch; merge allows landing when the branch moved. */
1506
+ promote(branch: string, options?: {
1507
+ merge?: boolean;
1508
+ }): Promise<void>;
1509
+ /** Download and verify the mounted working set for network-free reads. */
1510
+ prefetch(): Promise<void>;
1511
+ /** Detach, retaining the private workspace and unpublished state unless explicitly requested. */
1512
+ unmount(options?: RepositoryUnmountOptions): Promise<void>;
1513
+ }
1514
+
1436
1515
  interface RepositoryClientOptions {
1437
1516
  apiUrl?: string;
1438
1517
  apiKey?: string;
1439
- /** @deprecated Scope is selected by ingress for SDK API keys. */
1518
+ /** @deprecated Scope is selected by ingress for SDK API keys; used only by local `tl` mounts. */
1440
1519
  organizationId?: string;
1441
- /** @deprecated Scope is selected by ingress for SDK API keys. */
1520
+ /** @deprecated Scope is selected by ingress for SDK API keys; used only by local `tl` mounts. */
1442
1521
  projectId?: string;
1443
1522
  requestTimeout?: number;
1444
1523
  timeoutMs?: number;
@@ -1597,10 +1676,21 @@ interface Operation {
1597
1676
  declare class RepositoryClient {
1598
1677
  private readonly native;
1599
1678
  private readonly requestTimeoutMs;
1679
+ private readonly cli;
1600
1680
  constructor(options?: RepositoryClientOptions);
1601
1681
  static forCloud(options?: RepositoryClientOptions): RepositoryClient;
1602
1682
  static fromEnv(): Promise<RepositoryClient>;
1603
1683
  close(): void;
1684
+ /**
1685
+ * Mount `repo[:branch|tag|full-commit][//subtree]` to a local directory.
1686
+ * Requires the separately installed `tl` CLI with mount support. Mounts
1687
+ * live on the machine running Node.js and must be explicitly unmounted.
1688
+ */
1689
+ mount(target: string, localPath: string, options?: RepositoryMountOptions): Promise<RepositoryMount>;
1690
+ /** Detach a local repository mount, optionally deleting its private workspace. */
1691
+ unmount(localPath: string, options?: RepositoryUnmountOptions): Promise<void>;
1692
+ /** Inspect a local mount; defaults to the mount containing the current directory. */
1693
+ mountStatus(localPath?: string): Promise<RepositoryMountStatus>;
1604
1694
  url(repo: string): Promise<string>;
1605
1695
  create(repo: string, options?: {
1606
1696
  defaultBranch?: string;
@@ -1754,7 +1844,7 @@ declare class ReadOnlyMountNotSupportedError extends MountError {
1754
1844
  constructor();
1755
1845
  }
1756
1846
  declare class CliNotFoundError extends MountError {
1757
- constructor(detail: string);
1847
+ constructor(detail: string, command?: "fs" | "git mount");
1758
1848
  }
1759
1849
 
1760
1850
  /**
@@ -1800,12 +1890,8 @@ interface FilesystemClientOptions {
1800
1890
  * mounts by invoking `tl fs mount/unmount/snapshot/status`. Everything else
1801
1891
  * goes through the Rust core and does not need the CLI.
1802
1892
  */
1803
- declare class FsCli {
1804
- private binary;
1805
- private readonly envOverrides;
1893
+ declare class FsCli extends MountCli {
1806
1894
  constructor(envOverrides: Record<string, string>);
1807
- private findCli;
1808
- private run;
1809
1895
  mount(filesystem: string, localPath: string, readonly: boolean): Promise<void>;
1810
1896
  unmount(localPath: string, discard: boolean): Promise<void>;
1811
1897
  snapshot(localPath: string, message?: string): Promise<void>;
@@ -1999,7 +2085,12 @@ declare class PoolInUseError extends SandboxError {
1999
2085
  /** Raised when the remote API returns an error. */
2000
2086
  declare class RemoteAPIError extends SandboxError {
2001
2087
  readonly statusCode: number;
2088
+ /** Original response body, retained for compatibility and diagnostics. */
2002
2089
  readonly responseMessage: string;
2090
+ readonly sandboxId?: string;
2091
+ /** Server reason, including unknown future reasons. */
2092
+ readonly reason?: string;
2093
+ readonly errorDetails?: unknown;
2003
2094
  constructor(statusCode: number, message: string);
2004
2095
  }
2005
2096
  /** Raised when request output is fetched before the request has completed. */
@@ -2017,4 +2108,4 @@ declare class RequestExecutionError extends Error {
2017
2108
  constructor(message: string, functionName?: string);
2018
2109
  }
2019
2110
 
2020
- export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, 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, 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, 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, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, listFileSystems, sandboxUrlFromIngressEndpoint };
2111
+ export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, 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, 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, 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, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, listFileSystems, sandboxUrlFromIngressEndpoint };
package/dist/index.d.ts CHANGED
@@ -158,7 +158,9 @@ declare enum SandboxStatus {
158
158
  SUSPENDING = "suspending",
159
159
  SUSPENDED = "suspended",
160
160
  TERMINATED = "terminated",
161
- TIMEOUT = "timeout"
161
+ TIMEOUT = "timeout",
162
+ /** Terminal status used by blocking create/claim responses. */
163
+ FAILED = "failed"
162
164
  }
163
165
  declare enum SnapshotStatus {
164
166
  IN_PROGRESS = "in_progress",
@@ -1433,12 +1435,89 @@ declare class CloudClient {
1433
1435
  private secretCollectionPath;
1434
1436
  }
1435
1437
 
1438
+ /** Shared command runner for the separately installed local mount daemon. */
1439
+ declare class MountCli {
1440
+ private readonly command;
1441
+ private readonly envOverrides;
1442
+ private binary;
1443
+ constructor(command: "fs" | "git", envOverrides: Record<string, string>);
1444
+ private findCli;
1445
+ protected run(args: string[], timeoutMs?: number): Promise<string>;
1446
+ }
1447
+
1448
+ interface RepositoryMountOptions {
1449
+ /** Stateless read-only view; cannot be combined with publish or workspace. */
1450
+ readOnly?: boolean;
1451
+ /** Publish each explicit snapshot onto the mounted branch. */
1452
+ publish?: boolean;
1453
+ /** Resume a private workspace; cannot be combined with publish or readOnly. */
1454
+ workspace?: string;
1455
+ }
1456
+ interface RepositoryUnmountOptions {
1457
+ /** Delete the private server workspace after detaching. Defaults to false. */
1458
+ deleteWorkspace?: boolean;
1459
+ /** Drop unpublished local state. Defaults to false. */
1460
+ discard?: boolean;
1461
+ }
1462
+ /** Stable fields from `tl git status --json`, with the full payload in raw. */
1463
+ interface RepositoryMountStatus {
1464
+ path: string;
1465
+ repository: string | null;
1466
+ reference: string | null;
1467
+ workspaceId: string | null;
1468
+ state: string | null;
1469
+ localChanges: boolean | null;
1470
+ raw: Record<string, unknown>;
1471
+ }
1472
+ /** @internal CLI implementation; obtain mounts through RepositoryClient. */
1473
+ declare class GitCli extends MountCli {
1474
+ constructor(envOverrides: Record<string, string>);
1475
+ mount(target: string, localPath: string, options?: RepositoryMountOptions): Promise<RepositoryMount>;
1476
+ unmount(localPath: string, options?: RepositoryUnmountOptions): Promise<void>;
1477
+ status(localPath?: string): Promise<RepositoryMountStatus>;
1478
+ snapshot(path: string, message?: string): Promise<void>;
1479
+ sync(path: string, target?: string): Promise<void>;
1480
+ rebase(path: string, target: string, failOnConflict: boolean): Promise<void>;
1481
+ promote(path: string, branch: string, merge: boolean): Promise<void>;
1482
+ prefetch(path: string): Promise<void>;
1483
+ }
1484
+ /** A repository mounted on the machine running Node.js via the `tl` CLI daemon. */
1485
+ declare class RepositoryMount {
1486
+ private readonly cli;
1487
+ /** Initial source (`repo[:ref][//subtree]`); sync/rebase can change the base. */
1488
+ readonly target: string;
1489
+ readonly path: string;
1490
+ readonly readOnly: boolean;
1491
+ /** @internal Obtain instances via RepositoryClient.mount(). */
1492
+ constructor(cli: GitCli,
1493
+ /** Initial source (`repo[:ref][//subtree]`); sync/rebase can change the base. */
1494
+ target: string, path: string, readOnly: boolean);
1495
+ /** Inspect workspace state, pending changes, and daemon diagnostics. */
1496
+ status(): Promise<RepositoryMountStatus>;
1497
+ /** Materialize autosaved edits as a commit; publish mounts also update their branch. */
1498
+ snapshot(message?: string): Promise<void>;
1499
+ /** Refresh the current source, or switch an unsnapshotted workspace to a new base. */
1500
+ sync(target?: string): Promise<void>;
1501
+ /** Replay snapshots and pending edits onto another base. Conflicts become diff3 markers by default. */
1502
+ rebase(target: string, options?: {
1503
+ failOnConflict?: boolean;
1504
+ }): Promise<void>;
1505
+ /** Publish the workspace to a branch; merge allows landing when the branch moved. */
1506
+ promote(branch: string, options?: {
1507
+ merge?: boolean;
1508
+ }): Promise<void>;
1509
+ /** Download and verify the mounted working set for network-free reads. */
1510
+ prefetch(): Promise<void>;
1511
+ /** Detach, retaining the private workspace and unpublished state unless explicitly requested. */
1512
+ unmount(options?: RepositoryUnmountOptions): Promise<void>;
1513
+ }
1514
+
1436
1515
  interface RepositoryClientOptions {
1437
1516
  apiUrl?: string;
1438
1517
  apiKey?: string;
1439
- /** @deprecated Scope is selected by ingress for SDK API keys. */
1518
+ /** @deprecated Scope is selected by ingress for SDK API keys; used only by local `tl` mounts. */
1440
1519
  organizationId?: string;
1441
- /** @deprecated Scope is selected by ingress for SDK API keys. */
1520
+ /** @deprecated Scope is selected by ingress for SDK API keys; used only by local `tl` mounts. */
1442
1521
  projectId?: string;
1443
1522
  requestTimeout?: number;
1444
1523
  timeoutMs?: number;
@@ -1597,10 +1676,21 @@ interface Operation {
1597
1676
  declare class RepositoryClient {
1598
1677
  private readonly native;
1599
1678
  private readonly requestTimeoutMs;
1679
+ private readonly cli;
1600
1680
  constructor(options?: RepositoryClientOptions);
1601
1681
  static forCloud(options?: RepositoryClientOptions): RepositoryClient;
1602
1682
  static fromEnv(): Promise<RepositoryClient>;
1603
1683
  close(): void;
1684
+ /**
1685
+ * Mount `repo[:branch|tag|full-commit][//subtree]` to a local directory.
1686
+ * Requires the separately installed `tl` CLI with mount support. Mounts
1687
+ * live on the machine running Node.js and must be explicitly unmounted.
1688
+ */
1689
+ mount(target: string, localPath: string, options?: RepositoryMountOptions): Promise<RepositoryMount>;
1690
+ /** Detach a local repository mount, optionally deleting its private workspace. */
1691
+ unmount(localPath: string, options?: RepositoryUnmountOptions): Promise<void>;
1692
+ /** Inspect a local mount; defaults to the mount containing the current directory. */
1693
+ mountStatus(localPath?: string): Promise<RepositoryMountStatus>;
1604
1694
  url(repo: string): Promise<string>;
1605
1695
  create(repo: string, options?: {
1606
1696
  defaultBranch?: string;
@@ -1754,7 +1844,7 @@ declare class ReadOnlyMountNotSupportedError extends MountError {
1754
1844
  constructor();
1755
1845
  }
1756
1846
  declare class CliNotFoundError extends MountError {
1757
- constructor(detail: string);
1847
+ constructor(detail: string, command?: "fs" | "git mount");
1758
1848
  }
1759
1849
 
1760
1850
  /**
@@ -1800,12 +1890,8 @@ interface FilesystemClientOptions {
1800
1890
  * mounts by invoking `tl fs mount/unmount/snapshot/status`. Everything else
1801
1891
  * goes through the Rust core and does not need the CLI.
1802
1892
  */
1803
- declare class FsCli {
1804
- private binary;
1805
- private readonly envOverrides;
1893
+ declare class FsCli extends MountCli {
1806
1894
  constructor(envOverrides: Record<string, string>);
1807
- private findCli;
1808
- private run;
1809
1895
  mount(filesystem: string, localPath: string, readonly: boolean): Promise<void>;
1810
1896
  unmount(localPath: string, discard: boolean): Promise<void>;
1811
1897
  snapshot(localPath: string, message?: string): Promise<void>;
@@ -1999,7 +2085,12 @@ declare class PoolInUseError extends SandboxError {
1999
2085
  /** Raised when the remote API returns an error. */
2000
2086
  declare class RemoteAPIError extends SandboxError {
2001
2087
  readonly statusCode: number;
2088
+ /** Original response body, retained for compatibility and diagnostics. */
2002
2089
  readonly responseMessage: string;
2090
+ readonly sandboxId?: string;
2091
+ /** Server reason, including unknown future reasons. */
2092
+ readonly reason?: string;
2093
+ readonly errorDetails?: unknown;
2003
2094
  constructor(statusCode: number, message: string);
2004
2095
  }
2005
2096
  /** Raised when request output is fetched before the request has completed. */
@@ -2017,4 +2108,4 @@ declare class RequestExecutionError extends Error {
2017
2108
  constructor(message: string, functionName?: string);
2018
2109
  }
2019
2110
 
2020
- export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, 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, 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, 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, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, listFileSystems, sandboxUrlFromIngressEndpoint };
2111
+ export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, 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, 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, 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, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, StartImageBuildRequest, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, UpsertSecretResponse, createFileSystem, deleteFileSystem, listFileSystems, sandboxUrlFromIngressEndpoint };