modal 0.10.2-dev.9 → 0.11.0

package/dist/index.d.cts

@@ -476,6 +476,16 @@ declare enum CloudBucketMount_MetadataTTLType {
     METADATA_TTL_TYPE_INDEFINITE = 2,
     UNRECOGNIZED = -1
 }
+declare enum EndpointGetInfoResponse_EndpointStatus {
+    ENDPOINT_STATUS_UNSPECIFIED = 0,
+    ENDPOINT_STATUS_PROVISIONING = 1,
+    ENDPOINT_STATUS_LIVE = 2,
+    ENDPOINT_STATUS_FAILED = 3,
+    ENDPOINT_STATUS_CANCELLING = 4,
+    ENDPOINT_STATUS_CANCELLED = 5,
+    ENDPOINT_STATUS_STOPPED = 6,
+    UNRECOGNIZED = -1
+}
 declare enum FileEntry_FileType {
     UNSPECIFIED = 0,
     FILE = 1,
@@ -1645,6 +1655,35 @@ interface EndpointGetByNameResponse {
     environmentName: string;
 }
 declare const EndpointGetByNameResponse: MessageFns$1<EndpointGetByNameResponse>;
+interface EndpointGetInfoRequest {
+    endpointId: string;
+}
+declare const EndpointGetInfoRequest: MessageFns$1<EndpointGetInfoRequest>;
+interface EndpointGetInfoResponse {
+    info: EndpointGetInfoResponse_EndpointInfoSummary | undefined;
+    metadata?: EndpointGetInfoResponse_EndpointHandleMetadata | undefined;
+}
+declare const EndpointGetInfoResponse: MessageFns$1<EndpointGetInfoResponse>;
+interface EndpointGetInfoResponse_EndpointInfoSummary {
+    name: string;
+    repoId: string;
+    revision: string;
+    serviceUrl: string;
+    requiresProxyAuth: boolean;
+    servingMode: EndpointServingMode;
+    status: EndpointGetInfoResponse_EndpointStatus;
+    lifecycle: EndpointLifecycle | undefined;
+    /** set only when the model is served from a modal volume */
+    volumeId: string;
+    modelPath: string;
+}
+declare const EndpointGetInfoResponse_EndpointInfoSummary: MessageFns$1<EndpointGetInfoResponse_EndpointInfoSummary>;
+interface EndpointGetInfoResponse_EndpointHandleMetadata {
+    appId: string;
+    serverId: string;
+    environmentName: string;
+}
+declare const EndpointGetInfoResponse_EndpointHandleMetadata: MessageFns$1<EndpointGetInfoResponse_EndpointHandleMetadata>;
 interface EndpointGetLifecycleRequest {
     endpointId: string;
 }
@@ -1734,7 +1773,7 @@ interface EnvironmentBillingSummaryResponse {
      * at the workspace level
      */
     meteredCost: string;
-    /** keyed by deployed, ephemeral, volume, notebook */
+    /** keyed by app type (deployed, ephemeral, notebook, endpoint, ...), volume, tokens, network egress */
     meteredCostBreakdown: {
         [key: string]: string;
     };
@@ -2048,13 +2087,6 @@ interface FunctionMessage {
     untrusted: boolean;
     /** To be replaced by autoscaler_settings.buffer_containers */
     ExperimentalBufferContainers: number;
-    /**
-     * _experimental_proxy_ip -> ProxyInfo
-     * TODO: deprecate.
-     *
-     * @deprecated
-     */
-    ExperimentalProxyIp?: string | undefined;
     /** For internal debugging use only. */
     runtimePerfRecord: boolean;
     schedule: Schedule | undefined;
@@ -2301,13 +2333,6 @@ interface FunctionData {
     webUrlInfo: WebUrlInfo | undefined;
     webhookConfig: WebhookConfig | undefined;
     customDomainInfo: CustomDomainInfo[];
-    /**
-     * _experimental_proxy_ip -> ProxyInfo
-     * TODO: deprecate.
-     *
-     * @deprecated
-     */
-    ExperimentalProxyIp?: string | undefined;
     /** Mapping of method names to method definitions, only non-empty for class service functions */
     methodDefinitions: {
         [key: string]: MethodDefinition;
@@ -2753,13 +2778,13 @@ interface FunctionSchema {
     returnType: GenericPayloadType | undefined;
 }
 declare const FunctionSchema: MessageFns$1<FunctionSchema>;
-interface FunctionStats$1 {
+interface FunctionStats {
     backlog: number;
     numTotalTasks: number;
     numRunningInputs: number;
     inputHeadroom: number;
 }
-declare const FunctionStats$1: MessageFns$1<FunctionStats$1>;
+declare const FunctionStats: MessageFns$1<FunctionStats>;
 interface FunctionUpdateSchedulingParamsRequest {
     functionId: string;
     warmPoolSizeOverride: number;
@@ -5646,6 +5671,14 @@ declare const ModalClientDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly endpointGetInfo: {
+            readonly name: "EndpointGetInfo";
+            readonly requestType: MessageFns$1<EndpointGetInfoRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns$1<EndpointGetInfoResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         readonly endpointGetLifecycle: {
             readonly name: "EndpointGetLifecycle";
             readonly requestType: MessageFns$1<EndpointGetLifecycleRequest>;
@@ -5934,7 +5967,7 @@ declare const ModalClientDefinition: {
             readonly name: "FunctionGetCurrentStats";
             readonly requestType: MessageFns$1<FunctionGetCurrentStatsRequest>;
             readonly requestStream: false;
-            readonly responseType: MessageFns$1<FunctionStats$1>;
+            readonly responseType: MessageFns$1<FunctionStats>;
             readonly responseStream: false;
             readonly options: {};
         };
@@ -7246,7 +7279,7 @@ declare class Secret {
     #private;
     readonly name?: string;
     /** @ignore */
-    constructor(secretId: string, name?: string, hydrator?: SecretHydrator);
+    constructor(secretId: string, name?: string, hydrator?: SecretHydrator, keys?: readonly string[]);
     /** The ID of the server-side Secret, or an empty string if not yet hydrated. */
     get secretId(): string;
     /**
@@ -7257,6 +7290,14 @@ declare class Secret {
      * @hidden
      */
     get _hydrator(): SecretHydrator | undefined;
+    /**
+     * Names of the env vars this server-side Secret defines, or `undefined` if
+     * unknown (e.g. for lazy fromObject Secrets or Secrets constructed by id).
+     *
+     * @internal
+     * @hidden
+     */
+    get _keys(): ReadonlySet<string> | undefined;
     /**
      * Lazily create the ephemeral server-side Secret backing a fromObject Secret
      * and populate {@link Secret#secretId secretId}. A no-op once secretId is set
@@ -7753,7 +7794,7 @@ declare class FunctionService {
     fromName(appName: string, name: string, params?: FunctionFromNameParams): Promise<Function_>;
 }
 /** Simple data structure storing stats for a running {@link Function_ Function}. */
-interface FunctionStats {
+interface FunctionCurrentStats {
     backlog: number;
     numTotalRunners: number;
 }
@@ -7835,7 +7876,7 @@ declare class Function_ {
     instance(): Promise<Function_>;
     remote(args?: any[], kwargs?: Record<string, any>): Promise<any>;
     spawn(args?: any[], kwargs?: Record<string, any>): Promise<FunctionCall>;
-    getCurrentStats(): Promise<FunctionStats>;
+    getCurrentStats(): Promise<FunctionCurrentStats>;
     updateAutoscaler(params: FunctionUpdateAutoscalerParams): Promise<FunctionAutoscalerSettings>;
     /**
      * URL for addressing the Web Function via HTTP.
@@ -8239,6 +8280,12 @@ interface TaskContainerCreateRequest {
     networkAccess?: NetworkAccess | undefined;
     /** Optional PTY info for sidecar. */
     ptyInfo?: PTYInfo | undefined;
+    /**
+     * Memory, in MiB, the sidecar consumes from the sandbox's sidecar memory
+     * reserve (experimental option vm_sidecar_memory_reserve_mib); unset
+     * consumes whatever is left of it. Ignored without a reserve.
+     */
+    memoryReserveConsumeMib?: number | undefined;
 }
 declare const TaskContainerCreateRequest: MessageFns<TaskContainerCreateRequest>;
 interface TaskContainerCreateResponse {
@@ -8993,6 +9040,11 @@ type SidecarCreateParams = {
     workdir?: string;
     /** Mount points for Modal {@link Volume}s. */
     volumes?: Record<string, Volume>;
+    /**
+     * Mount points for Modal {@link CloudBucketMount}s. Not supported for GPU
+     * Sandboxes.
+     */
+    cloudBucketMounts?: Record<string, CloudBucketMount>;
     /**
      * List of CIDRs the sidecar is allowed to access. Independent of the main
      * container; if not set, all CIDRs are allowed. An empty list blocks all
@@ -9006,6 +9058,13 @@ type SidecarCreateParams = {
     outboundDomainAllowlist?: string[];
     /** Enable a PTY for the sidecar. */
     pty?: boolean;
+    /**
+     * Memory, in MiB, the sidecar consumes from the Sandbox's sidecar memory
+     * reserve (the `vm_sidecar_memory_reserve_mib` experimental option); unset
+     * consumes whatever is left of it. Ignored by Sandboxes without a reserve.
+     * Experimental.
+     */
+    experimentalMemoryReserveConsumeMiB?: number;
 };
 /** Options for {@link SidecarService#get SidecarService.get()}. */
 type SidecarGetParams = {
@@ -9658,6 +9717,15 @@ declare class Sandbox {
     exec(command: string[], params: SandboxExecParams & {
         mode: "binary";
     }): Promise<ContainerProcess<Uint8Array>>;
+    /**
+     * Blocks until the Sandbox has a task. If the wait fails, the Sandbox is
+     * terminated so a queued one cannot start later with no caller. A timeout
+     * surfaces as a ResourceExhaustedError.
+     *
+     * @internal
+     * @hidden
+     */
+    _waitForScheduling(timeoutMs: number): Promise<void>;
     /**
      * Create a token for making HTTP connections to the Sandbox.
      */
@@ -10042,6 +10110,10 @@ declare class QueueEmptyError extends Error {
 declare class QueueFullError extends Error {
     constructor(message: string);
 }
+/** A server-side resource has been exhausted, such as capacity, a quota, or a rate limit. */
+declare class ResourceExhaustedError extends Error {
+    constructor(message: string);
+}
 /** Errors from invalid Sandbox FileSystem operations. */
 declare class SandboxFilesystemError extends Error {
     constructor(message: string);
@@ -10089,4 +10161,4 @@ declare class ClientClosedError extends Error {
 
 declare function checkForRenamedParams(params: any, renames: Record<string, string>): void;
 
-export { AlreadyExistsError, App, type AppFromNameParams, AppService, ClientClosedError, CloudBucketMount, CloudBucketMountService, Cls, type ClsFromNameParams, ClsInstance, ClsService, type ClsWithBatchingParams, type ClsWithConcurrencyParams, type ClsWithOptionsParams, ConflictError, ContainerProcess, ExecutionError, ExperimentalOutboundPolicy, type FileInfo, type FileType, type FileWatchEvent, type FileWatchEventType, type FunctionAutoscalerSettings, FunctionCall, type FunctionCallCancelParams, type FunctionCallGetParams, type FunctionCallLogFetchParams, type FunctionCallLogStreamParams, type FunctionCallLogTailParams, FunctionCallLogsManager, FunctionCallService, type FunctionFromNameParams, type FunctionLogFetchParams, type FunctionLogStreamParams, type FunctionLogTailParams, FunctionLogsManager, FunctionService, type FunctionStats, FunctionTimeoutError, type FunctionUpdateAutoscalerParams, type FunctionWithBatchingParams, type FunctionWithConcurrencyParams, type FunctionWithOptionsParams, Function_, Image, type ImageDeleteParams, type ImageDockerfileCommandsParams, type ImageFromNameParams, type ImagePublishParams, ImageService, InternalFailure, InvalidError, type LogEntry, type FunctionLogFetchParams as LogFetchParams, type LogLevel, type LogSource, type Logger, ModalClient, type ModalClientParams, type ModalReadStream, type ModalWriteStream, NotFoundError, Probe, type ProbeParams, type Profile, Proxy, type ProxyFromNameParams, ProxyService, Queue, type QueueClearParams, type QueueDeleteParams, QueueEmptyError, type QueueEphemeralParams, type QueueFromNameParams, QueueFullError, type QueueGetParams, type QueueIterateParams, type QueueLenParams, type QueuePutParams, QueueService, RemoteError, Retries, Sandbox, type SandboxCreateConnectCredentials, type SandboxCreateConnectTokenParams, type SandboxCreateParams, type SandboxExecParams, type SandboxExperimentalFromNameParams, type SandboxExperimentalFromSnapshotParams, type SandboxExperimentalGetExitSnapshotParams, type SandboxExperimentalListParams, SandboxFilesystem, SandboxFilesystemDirectoryNotEmptyError, SandboxFilesystemError, SandboxFilesystemFileTooLargeError, SandboxFilesystemIsADirectoryError, SandboxFilesystemNotADirectoryError, SandboxFilesystemNotFoundError, SandboxFilesystemPathAlreadyExistsError, SandboxFilesystemPermissionError, type SandboxFromNameParams, type SandboxListParams, type SandboxLogFetchParams, type SandboxLogTailParams, SandboxLogsManager, type SandboxMountImageParams, type SandboxReloadVolumesParams, type SandboxRuntime, SandboxService, SandboxSnapshot, type SandboxSnapshotDirectoryParams, type SandboxSnapshotFilesystemParams, SandboxSnapshotService, type SandboxTerminateParams, SandboxTimeoutError, type SandboxUpdateNetworkPolicyParams, Secret, type SecretDeleteParams, type SecretFromNameParams, type SecretFromObjectParams, SecretService, SidecarContainer, type SidecarCreateParams, type SidecarExecParams, type SidecarGetParams, type SidecarListParams, type SidecarMountImageParams, SidecarService, type SidecarSnapshotDirectoryParams, type SidecarSnapshotFilesystemParams, type SidecarTerminateParams, type SidecarUnmountImageParams, SnapshotCreationError, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };
+export { AlreadyExistsError, App, type AppFromNameParams, AppService, ClientClosedError, CloudBucketMount, CloudBucketMountService, Cls, type ClsFromNameParams, ClsInstance, ClsService, type ClsWithBatchingParams, type ClsWithConcurrencyParams, type ClsWithOptionsParams, ConflictError, ContainerProcess, ExecutionError, ExperimentalOutboundPolicy, type FileInfo, type FileType, type FileWatchEvent, type FileWatchEventType, type FunctionAutoscalerSettings, FunctionCall, type FunctionCallCancelParams, type FunctionCallGetParams, type FunctionCallLogFetchParams, type FunctionCallLogStreamParams, type FunctionCallLogTailParams, FunctionCallLogsManager, FunctionCallService, type FunctionCurrentStats, type FunctionFromNameParams, type FunctionLogFetchParams, type FunctionLogStreamParams, type FunctionLogTailParams, FunctionLogsManager, FunctionService, FunctionTimeoutError, type FunctionUpdateAutoscalerParams, type FunctionWithBatchingParams, type FunctionWithConcurrencyParams, type FunctionWithOptionsParams, Function_, Image, type ImageDeleteParams, type ImageDockerfileCommandsParams, type ImageFromNameParams, type ImagePublishParams, ImageService, InternalFailure, InvalidError, type LogEntry, type FunctionLogFetchParams as LogFetchParams, type LogLevel, type LogSource, type Logger, ModalClient, type ModalClientParams, type ModalReadStream, type ModalWriteStream, NotFoundError, Probe, type ProbeParams, type Profile, Proxy, type ProxyFromNameParams, ProxyService, Queue, type QueueClearParams, type QueueDeleteParams, QueueEmptyError, type QueueEphemeralParams, type QueueFromNameParams, QueueFullError, type QueueGetParams, type QueueIterateParams, type QueueLenParams, type QueuePutParams, QueueService, RemoteError, ResourceExhaustedError, Retries, Sandbox, type SandboxCreateConnectCredentials, type SandboxCreateConnectTokenParams, type SandboxCreateParams, type SandboxExecParams, type SandboxExperimentalFromNameParams, type SandboxExperimentalFromSnapshotParams, type SandboxExperimentalGetExitSnapshotParams, type SandboxExperimentalListParams, SandboxFilesystem, SandboxFilesystemDirectoryNotEmptyError, SandboxFilesystemError, SandboxFilesystemFileTooLargeError, SandboxFilesystemIsADirectoryError, SandboxFilesystemNotADirectoryError, SandboxFilesystemNotFoundError, SandboxFilesystemPathAlreadyExistsError, SandboxFilesystemPermissionError, type SandboxFromNameParams, type SandboxListParams, type SandboxLogFetchParams, type SandboxLogTailParams, SandboxLogsManager, type SandboxMountImageParams, type SandboxReloadVolumesParams, type SandboxRuntime, SandboxService, SandboxSnapshot, type SandboxSnapshotDirectoryParams, type SandboxSnapshotFilesystemParams, SandboxSnapshotService, type SandboxTerminateParams, SandboxTimeoutError, type SandboxUpdateNetworkPolicyParams, Secret, type SecretDeleteParams, type SecretFromNameParams, type SecretFromObjectParams, SecretService, SidecarContainer, type SidecarCreateParams, type SidecarExecParams, type SidecarGetParams, type SidecarListParams, type SidecarMountImageParams, SidecarService, type SidecarSnapshotDirectoryParams, type SidecarSnapshotFilesystemParams, type SidecarTerminateParams, type SidecarUnmountImageParams, SnapshotCreationError, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };

package/dist/index.d.ts

@@ -476,6 +476,16 @@ declare enum CloudBucketMount_MetadataTTLType {
     METADATA_TTL_TYPE_INDEFINITE = 2,
     UNRECOGNIZED = -1
 }
+declare enum EndpointGetInfoResponse_EndpointStatus {
+    ENDPOINT_STATUS_UNSPECIFIED = 0,
+    ENDPOINT_STATUS_PROVISIONING = 1,
+    ENDPOINT_STATUS_LIVE = 2,
+    ENDPOINT_STATUS_FAILED = 3,
+    ENDPOINT_STATUS_CANCELLING = 4,
+    ENDPOINT_STATUS_CANCELLED = 5,
+    ENDPOINT_STATUS_STOPPED = 6,
+    UNRECOGNIZED = -1
+}
 declare enum FileEntry_FileType {
     UNSPECIFIED = 0,
     FILE = 1,
@@ -1645,6 +1655,35 @@ interface EndpointGetByNameResponse {
     environmentName: string;
 }
 declare const EndpointGetByNameResponse: MessageFns$1<EndpointGetByNameResponse>;
+interface EndpointGetInfoRequest {
+    endpointId: string;
+}
+declare const EndpointGetInfoRequest: MessageFns$1<EndpointGetInfoRequest>;
+interface EndpointGetInfoResponse {
+    info: EndpointGetInfoResponse_EndpointInfoSummary | undefined;
+    metadata?: EndpointGetInfoResponse_EndpointHandleMetadata | undefined;
+}
+declare const EndpointGetInfoResponse: MessageFns$1<EndpointGetInfoResponse>;
+interface EndpointGetInfoResponse_EndpointInfoSummary {
+    name: string;
+    repoId: string;
+    revision: string;
+    serviceUrl: string;
+    requiresProxyAuth: boolean;
+    servingMode: EndpointServingMode;
+    status: EndpointGetInfoResponse_EndpointStatus;
+    lifecycle: EndpointLifecycle | undefined;
+    /** set only when the model is served from a modal volume */
+    volumeId: string;
+    modelPath: string;
+}
+declare const EndpointGetInfoResponse_EndpointInfoSummary: MessageFns$1<EndpointGetInfoResponse_EndpointInfoSummary>;
+interface EndpointGetInfoResponse_EndpointHandleMetadata {
+    appId: string;
+    serverId: string;
+    environmentName: string;
+}
+declare const EndpointGetInfoResponse_EndpointHandleMetadata: MessageFns$1<EndpointGetInfoResponse_EndpointHandleMetadata>;
 interface EndpointGetLifecycleRequest {
     endpointId: string;
 }
@@ -1734,7 +1773,7 @@ interface EnvironmentBillingSummaryResponse {
      * at the workspace level
      */
     meteredCost: string;
-    /** keyed by deployed, ephemeral, volume, notebook */
+    /** keyed by app type (deployed, ephemeral, notebook, endpoint, ...), volume, tokens, network egress */
     meteredCostBreakdown: {
         [key: string]: string;
     };
@@ -2048,13 +2087,6 @@ interface FunctionMessage {
     untrusted: boolean;
     /** To be replaced by autoscaler_settings.buffer_containers */
     ExperimentalBufferContainers: number;
-    /**
-     * _experimental_proxy_ip -> ProxyInfo
-     * TODO: deprecate.
-     *
-     * @deprecated
-     */
-    ExperimentalProxyIp?: string | undefined;
     /** For internal debugging use only. */
     runtimePerfRecord: boolean;
     schedule: Schedule | undefined;
@@ -2301,13 +2333,6 @@ interface FunctionData {
     webUrlInfo: WebUrlInfo | undefined;
     webhookConfig: WebhookConfig | undefined;
     customDomainInfo: CustomDomainInfo[];
-    /**
-     * _experimental_proxy_ip -> ProxyInfo
-     * TODO: deprecate.
-     *
-     * @deprecated
-     */
-    ExperimentalProxyIp?: string | undefined;
     /** Mapping of method names to method definitions, only non-empty for class service functions */
     methodDefinitions: {
         [key: string]: MethodDefinition;
@@ -2753,13 +2778,13 @@ interface FunctionSchema {
     returnType: GenericPayloadType | undefined;
 }
 declare const FunctionSchema: MessageFns$1<FunctionSchema>;
-interface FunctionStats$1 {
+interface FunctionStats {
     backlog: number;
     numTotalTasks: number;
     numRunningInputs: number;
     inputHeadroom: number;
 }
-declare const FunctionStats$1: MessageFns$1<FunctionStats$1>;
+declare const FunctionStats: MessageFns$1<FunctionStats>;
 interface FunctionUpdateSchedulingParamsRequest {
     functionId: string;
     warmPoolSizeOverride: number;
@@ -5646,6 +5671,14 @@ declare const ModalClientDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly endpointGetInfo: {
+            readonly name: "EndpointGetInfo";
+            readonly requestType: MessageFns$1<EndpointGetInfoRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns$1<EndpointGetInfoResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         readonly endpointGetLifecycle: {
             readonly name: "EndpointGetLifecycle";
             readonly requestType: MessageFns$1<EndpointGetLifecycleRequest>;
@@ -5934,7 +5967,7 @@ declare const ModalClientDefinition: {
             readonly name: "FunctionGetCurrentStats";
             readonly requestType: MessageFns$1<FunctionGetCurrentStatsRequest>;
             readonly requestStream: false;
-            readonly responseType: MessageFns$1<FunctionStats$1>;
+            readonly responseType: MessageFns$1<FunctionStats>;
             readonly responseStream: false;
             readonly options: {};
         };
@@ -7246,7 +7279,7 @@ declare class Secret {
     #private;
     readonly name?: string;
     /** @ignore */
-    constructor(secretId: string, name?: string, hydrator?: SecretHydrator);
+    constructor(secretId: string, name?: string, hydrator?: SecretHydrator, keys?: readonly string[]);
     /** The ID of the server-side Secret, or an empty string if not yet hydrated. */
     get secretId(): string;
     /**
@@ -7257,6 +7290,14 @@ declare class Secret {
      * @hidden
      */
     get _hydrator(): SecretHydrator | undefined;
+    /**
+     * Names of the env vars this server-side Secret defines, or `undefined` if
+     * unknown (e.g. for lazy fromObject Secrets or Secrets constructed by id).
+     *
+     * @internal
+     * @hidden
+     */
+    get _keys(): ReadonlySet<string> | undefined;
     /**
      * Lazily create the ephemeral server-side Secret backing a fromObject Secret
      * and populate {@link Secret#secretId secretId}. A no-op once secretId is set
@@ -7753,7 +7794,7 @@ declare class FunctionService {
     fromName(appName: string, name: string, params?: FunctionFromNameParams): Promise<Function_>;
 }
 /** Simple data structure storing stats for a running {@link Function_ Function}. */
-interface FunctionStats {
+interface FunctionCurrentStats {
     backlog: number;
     numTotalRunners: number;
 }
@@ -7835,7 +7876,7 @@ declare class Function_ {
     instance(): Promise<Function_>;
     remote(args?: any[], kwargs?: Record<string, any>): Promise<any>;
     spawn(args?: any[], kwargs?: Record<string, any>): Promise<FunctionCall>;
-    getCurrentStats(): Promise<FunctionStats>;
+    getCurrentStats(): Promise<FunctionCurrentStats>;
     updateAutoscaler(params: FunctionUpdateAutoscalerParams): Promise<FunctionAutoscalerSettings>;
     /**
      * URL for addressing the Web Function via HTTP.
@@ -8239,6 +8280,12 @@ interface TaskContainerCreateRequest {
     networkAccess?: NetworkAccess | undefined;
     /** Optional PTY info for sidecar. */
     ptyInfo?: PTYInfo | undefined;
+    /**
+     * Memory, in MiB, the sidecar consumes from the sandbox's sidecar memory
+     * reserve (experimental option vm_sidecar_memory_reserve_mib); unset
+     * consumes whatever is left of it. Ignored without a reserve.
+     */
+    memoryReserveConsumeMib?: number | undefined;
 }
 declare const TaskContainerCreateRequest: MessageFns<TaskContainerCreateRequest>;
 interface TaskContainerCreateResponse {
@@ -8993,6 +9040,11 @@ type SidecarCreateParams = {
     workdir?: string;
     /** Mount points for Modal {@link Volume}s. */
     volumes?: Record<string, Volume>;
+    /**
+     * Mount points for Modal {@link CloudBucketMount}s. Not supported for GPU
+     * Sandboxes.
+     */
+    cloudBucketMounts?: Record<string, CloudBucketMount>;
     /**
      * List of CIDRs the sidecar is allowed to access. Independent of the main
      * container; if not set, all CIDRs are allowed. An empty list blocks all
@@ -9006,6 +9058,13 @@ type SidecarCreateParams = {
     outboundDomainAllowlist?: string[];
     /** Enable a PTY for the sidecar. */
     pty?: boolean;
+    /**
+     * Memory, in MiB, the sidecar consumes from the Sandbox's sidecar memory
+     * reserve (the `vm_sidecar_memory_reserve_mib` experimental option); unset
+     * consumes whatever is left of it. Ignored by Sandboxes without a reserve.
+     * Experimental.
+     */
+    experimentalMemoryReserveConsumeMiB?: number;
 };
 /** Options for {@link SidecarService#get SidecarService.get()}. */
 type SidecarGetParams = {
@@ -9658,6 +9717,15 @@ declare class Sandbox {
     exec(command: string[], params: SandboxExecParams & {
         mode: "binary";
     }): Promise<ContainerProcess<Uint8Array>>;
+    /**
+     * Blocks until the Sandbox has a task. If the wait fails, the Sandbox is
+     * terminated so a queued one cannot start later with no caller. A timeout
+     * surfaces as a ResourceExhaustedError.
+     *
+     * @internal
+     * @hidden
+     */
+    _waitForScheduling(timeoutMs: number): Promise<void>;
     /**
      * Create a token for making HTTP connections to the Sandbox.
      */
@@ -10042,6 +10110,10 @@ declare class QueueEmptyError extends Error {
 declare class QueueFullError extends Error {
     constructor(message: string);
 }
+/** A server-side resource has been exhausted, such as capacity, a quota, or a rate limit. */
+declare class ResourceExhaustedError extends Error {
+    constructor(message: string);
+}
 /** Errors from invalid Sandbox FileSystem operations. */
 declare class SandboxFilesystemError extends Error {
     constructor(message: string);
@@ -10089,4 +10161,4 @@ declare class ClientClosedError extends Error {
 
 declare function checkForRenamedParams(params: any, renames: Record<string, string>): void;
 
-export { AlreadyExistsError, App, type AppFromNameParams, AppService, ClientClosedError, CloudBucketMount, CloudBucketMountService, Cls, type ClsFromNameParams, ClsInstance, ClsService, type ClsWithBatchingParams, type ClsWithConcurrencyParams, type ClsWithOptionsParams, ConflictError, ContainerProcess, ExecutionError, ExperimentalOutboundPolicy, type FileInfo, type FileType, type FileWatchEvent, type FileWatchEventType, type FunctionAutoscalerSettings, FunctionCall, type FunctionCallCancelParams, type FunctionCallGetParams, type FunctionCallLogFetchParams, type FunctionCallLogStreamParams, type FunctionCallLogTailParams, FunctionCallLogsManager, FunctionCallService, type FunctionFromNameParams, type FunctionLogFetchParams, type FunctionLogStreamParams, type FunctionLogTailParams, FunctionLogsManager, FunctionService, type FunctionStats, FunctionTimeoutError, type FunctionUpdateAutoscalerParams, type FunctionWithBatchingParams, type FunctionWithConcurrencyParams, type FunctionWithOptionsParams, Function_, Image, type ImageDeleteParams, type ImageDockerfileCommandsParams, type ImageFromNameParams, type ImagePublishParams, ImageService, InternalFailure, InvalidError, type LogEntry, type FunctionLogFetchParams as LogFetchParams, type LogLevel, type LogSource, type Logger, ModalClient, type ModalClientParams, type ModalReadStream, type ModalWriteStream, NotFoundError, Probe, type ProbeParams, type Profile, Proxy, type ProxyFromNameParams, ProxyService, Queue, type QueueClearParams, type QueueDeleteParams, QueueEmptyError, type QueueEphemeralParams, type QueueFromNameParams, QueueFullError, type QueueGetParams, type QueueIterateParams, type QueueLenParams, type QueuePutParams, QueueService, RemoteError, Retries, Sandbox, type SandboxCreateConnectCredentials, type SandboxCreateConnectTokenParams, type SandboxCreateParams, type SandboxExecParams, type SandboxExperimentalFromNameParams, type SandboxExperimentalFromSnapshotParams, type SandboxExperimentalGetExitSnapshotParams, type SandboxExperimentalListParams, SandboxFilesystem, SandboxFilesystemDirectoryNotEmptyError, SandboxFilesystemError, SandboxFilesystemFileTooLargeError, SandboxFilesystemIsADirectoryError, SandboxFilesystemNotADirectoryError, SandboxFilesystemNotFoundError, SandboxFilesystemPathAlreadyExistsError, SandboxFilesystemPermissionError, type SandboxFromNameParams, type SandboxListParams, type SandboxLogFetchParams, type SandboxLogTailParams, SandboxLogsManager, type SandboxMountImageParams, type SandboxReloadVolumesParams, type SandboxRuntime, SandboxService, SandboxSnapshot, type SandboxSnapshotDirectoryParams, type SandboxSnapshotFilesystemParams, SandboxSnapshotService, type SandboxTerminateParams, SandboxTimeoutError, type SandboxUpdateNetworkPolicyParams, Secret, type SecretDeleteParams, type SecretFromNameParams, type SecretFromObjectParams, SecretService, SidecarContainer, type SidecarCreateParams, type SidecarExecParams, type SidecarGetParams, type SidecarListParams, type SidecarMountImageParams, SidecarService, type SidecarSnapshotDirectoryParams, type SidecarSnapshotFilesystemParams, type SidecarTerminateParams, type SidecarUnmountImageParams, SnapshotCreationError, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };
+export { AlreadyExistsError, App, type AppFromNameParams, AppService, ClientClosedError, CloudBucketMount, CloudBucketMountService, Cls, type ClsFromNameParams, ClsInstance, ClsService, type ClsWithBatchingParams, type ClsWithConcurrencyParams, type ClsWithOptionsParams, ConflictError, ContainerProcess, ExecutionError, ExperimentalOutboundPolicy, type FileInfo, type FileType, type FileWatchEvent, type FileWatchEventType, type FunctionAutoscalerSettings, FunctionCall, type FunctionCallCancelParams, type FunctionCallGetParams, type FunctionCallLogFetchParams, type FunctionCallLogStreamParams, type FunctionCallLogTailParams, FunctionCallLogsManager, FunctionCallService, type FunctionCurrentStats, type FunctionFromNameParams, type FunctionLogFetchParams, type FunctionLogStreamParams, type FunctionLogTailParams, FunctionLogsManager, FunctionService, FunctionTimeoutError, type FunctionUpdateAutoscalerParams, type FunctionWithBatchingParams, type FunctionWithConcurrencyParams, type FunctionWithOptionsParams, Function_, Image, type ImageDeleteParams, type ImageDockerfileCommandsParams, type ImageFromNameParams, type ImagePublishParams, ImageService, InternalFailure, InvalidError, type LogEntry, type FunctionLogFetchParams as LogFetchParams, type LogLevel, type LogSource, type Logger, ModalClient, type ModalClientParams, type ModalReadStream, type ModalWriteStream, NotFoundError, Probe, type ProbeParams, type Profile, Proxy, type ProxyFromNameParams, ProxyService, Queue, type QueueClearParams, type QueueDeleteParams, QueueEmptyError, type QueueEphemeralParams, type QueueFromNameParams, QueueFullError, type QueueGetParams, type QueueIterateParams, type QueueLenParams, type QueuePutParams, QueueService, RemoteError, ResourceExhaustedError, Retries, Sandbox, type SandboxCreateConnectCredentials, type SandboxCreateConnectTokenParams, type SandboxCreateParams, type SandboxExecParams, type SandboxExperimentalFromNameParams, type SandboxExperimentalFromSnapshotParams, type SandboxExperimentalGetExitSnapshotParams, type SandboxExperimentalListParams, SandboxFilesystem, SandboxFilesystemDirectoryNotEmptyError, SandboxFilesystemError, SandboxFilesystemFileTooLargeError, SandboxFilesystemIsADirectoryError, SandboxFilesystemNotADirectoryError, SandboxFilesystemNotFoundError, SandboxFilesystemPathAlreadyExistsError, SandboxFilesystemPermissionError, type SandboxFromNameParams, type SandboxListParams, type SandboxLogFetchParams, type SandboxLogTailParams, SandboxLogsManager, type SandboxMountImageParams, type SandboxReloadVolumesParams, type SandboxRuntime, SandboxService, SandboxSnapshot, type SandboxSnapshotDirectoryParams, type SandboxSnapshotFilesystemParams, SandboxSnapshotService, type SandboxTerminateParams, SandboxTimeoutError, type SandboxUpdateNetworkPolicyParams, Secret, type SecretDeleteParams, type SecretFromNameParams, type SecretFromObjectParams, SecretService, SidecarContainer, type SidecarCreateParams, type SidecarExecParams, type SidecarGetParams, type SidecarListParams, type SidecarMountImageParams, SidecarService, type SidecarSnapshotDirectoryParams, type SidecarSnapshotFilesystemParams, type SidecarTerminateParams, type SidecarUnmountImageParams, SnapshotCreationError, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };