modal 0.11.1-dev.6 → 0.11.1-dev.8

package/dist/index.d.cts

@@ -211,12 +211,17 @@ declare enum EnvironmentRole {
 }
 /**
  * Creation-time environment classification. Captures whether an environment
- * is public. is_managed and machine_generated may be folded in as future
- * values.
+ * is public or administered by Modal. is_managed and machine_generated may be
+ * folded in as future values.
  */
 declare enum EnvironmentType {
     ENVIRONMENT_TYPE_UNSPECIFIED = 0,
     ENVIRONMENT_TYPE_PUBLIC = 1,
+    /**
+     * ENVIRONMENT_TYPE_MODAL_ADMINISTERED - Restricted environment whose roles are administered by Modal admins rather
+     * than the workspace's own managers.
+     */
+    ENVIRONMENT_TYPE_MODAL_ADMINISTERED = 2,
     UNRECOGNIZED = -1
 }
 declare enum ExecOutputOption {
@@ -1207,6 +1212,41 @@ interface ClusterListResponse {
     clusters: ClusterStats[];
 }
 declare const ClusterListResponse: MessageFns$1<ClusterListResponse>;
+interface ClusterReservation {
+    /** reservation name, as configured by Modal */
+    name: string;
+    /** e.g. "B300" */
+    gpuType: string;
+    region: string;
+    /** workers Modal has committed to keep reserved */
+    minReservedWorkers: number;
+    /** healthy reserved workers currently present (active + idle) */
+    reservedWorkers: number;
+    /** reserved workers running this workspace's containers */
+    activeWorkers: number;
+    /** reserved workers available for new clusters */
+    idleWorkers: number;
+    /** max(0, min_reserved_workers - reserved_workers) */
+    unfulfilledWorkers: number;
+    /** containers on reserved workers, ordered by cluster then rank */
+    tasks: ClusterReservation_Task[];
+}
+declare const ClusterReservation: MessageFns$1<ClusterReservation>;
+/** A container running on a worker reserved for this reservation. */
+interface ClusterReservation_Task {
+    taskId: string;
+    clusterRank: number;
+    appId: string;
+    functionId: string;
+}
+declare const ClusterReservation_Task: MessageFns$1<ClusterReservation_Task>;
+interface ClusterReservationListRequest {
+}
+declare const ClusterReservationListRequest: MessageFns$1<ClusterReservationListRequest>;
+interface ClusterReservationListResponse {
+    reservations: ClusterReservation[];
+}
+declare const ClusterReservationListResponse: MessageFns$1<ClusterReservationListResponse>;
 interface ClusterStats {
     appId: string;
     taskIds: string[];
@@ -1632,12 +1672,16 @@ interface EndpointCreateRequest {
     unauthenticated: boolean;
     servingMode: EndpointServingMode;
     sharedEndpointNoticeAcknowledged: boolean;
+    /** Requires Modal admin access. Dedicated endpoints only; must match model. */
+    recipeId?: string | undefined;
 }
 declare const EndpointCreateRequest: MessageFns$1<EndpointCreateRequest>;
 interface EndpointCreateResponse {
     endpointId: string;
     endpointPageUrl: string;
     name: string;
+    /** Model name to send in requests to the endpoint. */
+    modelName: string;
 }
 declare const EndpointCreateResponse: MessageFns$1<EndpointCreateResponse>;
 interface EndpointCustomModelSource {
@@ -1677,6 +1721,8 @@ interface EndpointGetInfoResponse_EndpointInfoSummary {
     /** set only when the model is served from a modal volume */
     volumeId: string;
     modelPath: string;
+    /** Model name to send in requests to the endpoint. */
+    modelName: string;
 }
 declare const EndpointGetInfoResponse_EndpointInfoSummary: MessageFns$1<EndpointGetInfoResponse_EndpointInfoSummary>;
 interface EndpointGetInfoResponse_EndpointHandleMetadata {
@@ -2556,7 +2602,7 @@ interface FunctionGetTimeRangeStatsResponse {
      * as requirements evolve
      */
     inputPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Container lifecycle counts. Started and errored containers are counted when
@@ -2571,7 +2617,7 @@ interface FunctionGetTimeRangeStatsResponse {
      * as requirements evolve
      */
     containerPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Number of direct non-version-pinned variants included in the roll-up.
@@ -2782,13 +2828,13 @@ interface FunctionSchema {
     returnType: GenericPayloadType | undefined;
 }
 declare const FunctionSchema: MessageFns$1<FunctionSchema>;
-interface FunctionStats {
+interface FunctionStats$1 {
     backlog: number;
     numTotalTasks: number;
     numRunningInputs: number;
     inputHeadroom: number;
 }
-declare const FunctionStats: MessageFns$1<FunctionStats>;
+declare const FunctionStats$1: MessageFns$1<FunctionStats$1>;
 interface FunctionUpdateSchedulingParamsRequest {
     functionId: string;
     warmPoolSizeOverride: number;
@@ -3865,6 +3911,11 @@ interface SandboxGetFromNameRequest {
     sandboxName: string;
     environmentName: string;
     appName: string;
+    /**
+     * When set, the lookup also considers sandboxes that have already stopped and
+     * returns the most recently created sandbox with the given name.
+     */
+    includeTerminated: boolean;
 }
 declare const SandboxGetFromNameRequest: MessageFns$1<SandboxGetFromNameRequest>;
 interface SandboxGetFromNameResponse {
@@ -4230,14 +4281,14 @@ interface ServerGetTimeRangeStatsResponse {
     requestRatePerSecond: number;
     /** Metrics include request_latency, subject to change as requirements evolve. */
     requestPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Metrics include startup_time, cpu_usage, memory_usage, and
      * gpu_utilization, subject to change as requirements evolve.
      */
     containerPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /** Absent when the image does not contain a supported inference engine. */
     inference: ServerGetTimeRangeStatsResponse_ServerInferenceStats | undefined;
@@ -4261,7 +4312,7 @@ interface ServerGetTimeRangeStatsResponse_ServerInferenceStats {
      * end_to_end_latency, subject to change as requirements evolve.
      */
     percentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Metrics include input_tokens_per_second, cached_input_tokens_per_second,
@@ -4402,18 +4453,18 @@ interface SharedVolumeRemoveFileRequest {
     recursive: boolean;
 }
 declare const SharedVolumeRemoveFileRequest: MessageFns$1<SharedVolumeRemoveFileRequest>;
-interface StatsPercentile {
+interface StatsPercentile$1 {
     /** The percentile expressed in basis points: 5000 is p50 and 9990 is p99.9. */
     percentileBasisPoints: number;
     value: number;
 }
-declare const StatsPercentile: MessageFns$1<StatsPercentile>;
-interface StatsPercentileDistribution {
+declare const StatsPercentile$1: MessageFns$1<StatsPercentile$1>;
+interface StatsPercentileDistribution$1 {
     /** Unit identifier such as "seconds", "cores", "gibibytes", or "fraction". */
     unit: string;
-    percentiles: StatsPercentile[];
+    percentiles: StatsPercentile$1[];
 }
-declare const StatsPercentileDistribution: MessageFns$1<StatsPercentileDistribution>;
+declare const StatsPercentileDistribution$1: MessageFns$1<StatsPercentileDistribution$1>;
 interface StringMap {
     contents: {
         [key: string]: string;
@@ -5438,6 +5489,14 @@ declare const ModalClientDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly clusterReservationList: {
+            readonly name: "ClusterReservationList";
+            readonly requestType: MessageFns$1<ClusterReservationListRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns$1<ClusterReservationListResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         /** Container */
         readonly containerCheckpoint: {
             readonly name: "ContainerCheckpoint";
@@ -5987,7 +6046,7 @@ declare const ModalClientDefinition: {
             readonly name: "FunctionGetCurrentStats";
             readonly requestType: MessageFns$1<FunctionGetCurrentStatsRequest>;
             readonly requestStream: false;
-            readonly responseType: MessageFns$1<FunctionStats>;
+            readonly responseType: MessageFns$1<FunctionStats$1>;
             readonly responseStream: false;
             readonly options: {};
         };
@@ -7828,6 +7887,39 @@ interface FunctionCurrentStats {
     backlog: number;
     numTotalRunners: number;
 }
+interface StatsPercentile {
+    percentile: number;
+    value: number;
+}
+interface StatsPercentileDistribution {
+    unit: string;
+    percentiles: StatsPercentile[];
+}
+interface FunctionStats {
+    since: Date;
+    until: Date;
+    inputSuccessCount: number;
+    inputFailureCount: number;
+    inputTimeoutCount: number;
+    inputRunningAtEndCount: number;
+    containerStartedCount: number;
+    containerErrorCount: number;
+    containerCreatingAtEndCount: number;
+    variantCount: number;
+    inputPercentileStats: Record<string, StatsPercentileDistribution>;
+    containerPercentileStats: Record<string, StatsPercentileDistribution>;
+    allVariants: boolean;
+}
+interface FunctionStatsParams {
+    /** Inclusive start; defaults to one hour before until. */
+    since?: Date;
+    /** Exclusive end; defaults to the current time. */
+    until?: Date;
+    /** Restrict statistics to this container ID. */
+    container?: string;
+    /** Aggregate the base Function and its variants. Defaults to false. */
+    allVariants?: boolean;
+}
 /** Optional parameters for {@link Function_#updateAutoscaler Function_.updateAutoscaler()}. */
 interface FunctionUpdateAutoscalerParams {
     minContainers?: number;
@@ -7906,6 +7998,29 @@ declare class Function_ {
     instance(): Promise<Function_>;
     remote(args?: any[], kwargs?: Record<string, any>): Promise<any>;
     spawn(args?: any[], kwargs?: Record<string, any>): Promise<FunctionCall>;
+    /**
+     * Return historical statistics. Defaults to the last hour; the maximum range is 7 days.
+     *
+     * @example Read statistics for the last hour.
+     * ```ts
+     * const fn = await modal.functions.fromName("libmodal-test-support", "echo_string");
+     * const stats = await fn.stats();
+     * console.log(stats.inputSuccessCount, stats.inputFailureCount);
+     * ```
+     *
+     * @example Include all variants over the last 24 hours.
+     * ```ts
+     * const until = new Date();
+     * const since = new Date(until.getTime() - 24 * 60 * 60 * 1000);
+     * const variantStats = await fn.stats({ since, until, allVariants: true });
+     * for (const [metric, distribution] of Object.entries(variantStats.inputPercentileStats)) {
+     *   console.log(metric, distribution.unit, distribution.percentiles);
+     * }
+     * ```
+     *
+     * Set `container` to a container ID to restrict statistics to that container.
+     */
+    stats(params?: FunctionStatsParams): Promise<FunctionStats>;
     getCurrentStats(): Promise<FunctionCurrentStats>;
     updateAutoscaler(params: FunctionUpdateAutoscalerParams): Promise<FunctionAutoscalerSettings>;
     /**
@@ -10208,4 +10323,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 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 };
+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, type FunctionStats, type FunctionStatsParams, 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 StatsPercentile, type StatsPercentileDistribution, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };

package/dist/index.d.ts

@@ -211,12 +211,17 @@ declare enum EnvironmentRole {
 }
 /**
  * Creation-time environment classification. Captures whether an environment
- * is public. is_managed and machine_generated may be folded in as future
- * values.
+ * is public or administered by Modal. is_managed and machine_generated may be
+ * folded in as future values.
  */
 declare enum EnvironmentType {
     ENVIRONMENT_TYPE_UNSPECIFIED = 0,
     ENVIRONMENT_TYPE_PUBLIC = 1,
+    /**
+     * ENVIRONMENT_TYPE_MODAL_ADMINISTERED - Restricted environment whose roles are administered by Modal admins rather
+     * than the workspace's own managers.
+     */
+    ENVIRONMENT_TYPE_MODAL_ADMINISTERED = 2,
     UNRECOGNIZED = -1
 }
 declare enum ExecOutputOption {
@@ -1207,6 +1212,41 @@ interface ClusterListResponse {
     clusters: ClusterStats[];
 }
 declare const ClusterListResponse: MessageFns$1<ClusterListResponse>;
+interface ClusterReservation {
+    /** reservation name, as configured by Modal */
+    name: string;
+    /** e.g. "B300" */
+    gpuType: string;
+    region: string;
+    /** workers Modal has committed to keep reserved */
+    minReservedWorkers: number;
+    /** healthy reserved workers currently present (active + idle) */
+    reservedWorkers: number;
+    /** reserved workers running this workspace's containers */
+    activeWorkers: number;
+    /** reserved workers available for new clusters */
+    idleWorkers: number;
+    /** max(0, min_reserved_workers - reserved_workers) */
+    unfulfilledWorkers: number;
+    /** containers on reserved workers, ordered by cluster then rank */
+    tasks: ClusterReservation_Task[];
+}
+declare const ClusterReservation: MessageFns$1<ClusterReservation>;
+/** A container running on a worker reserved for this reservation. */
+interface ClusterReservation_Task {
+    taskId: string;
+    clusterRank: number;
+    appId: string;
+    functionId: string;
+}
+declare const ClusterReservation_Task: MessageFns$1<ClusterReservation_Task>;
+interface ClusterReservationListRequest {
+}
+declare const ClusterReservationListRequest: MessageFns$1<ClusterReservationListRequest>;
+interface ClusterReservationListResponse {
+    reservations: ClusterReservation[];
+}
+declare const ClusterReservationListResponse: MessageFns$1<ClusterReservationListResponse>;
 interface ClusterStats {
     appId: string;
     taskIds: string[];
@@ -1632,12 +1672,16 @@ interface EndpointCreateRequest {
     unauthenticated: boolean;
     servingMode: EndpointServingMode;
     sharedEndpointNoticeAcknowledged: boolean;
+    /** Requires Modal admin access. Dedicated endpoints only; must match model. */
+    recipeId?: string | undefined;
 }
 declare const EndpointCreateRequest: MessageFns$1<EndpointCreateRequest>;
 interface EndpointCreateResponse {
     endpointId: string;
     endpointPageUrl: string;
     name: string;
+    /** Model name to send in requests to the endpoint. */
+    modelName: string;
 }
 declare const EndpointCreateResponse: MessageFns$1<EndpointCreateResponse>;
 interface EndpointCustomModelSource {
@@ -1677,6 +1721,8 @@ interface EndpointGetInfoResponse_EndpointInfoSummary {
     /** set only when the model is served from a modal volume */
     volumeId: string;
     modelPath: string;
+    /** Model name to send in requests to the endpoint. */
+    modelName: string;
 }
 declare const EndpointGetInfoResponse_EndpointInfoSummary: MessageFns$1<EndpointGetInfoResponse_EndpointInfoSummary>;
 interface EndpointGetInfoResponse_EndpointHandleMetadata {
@@ -2556,7 +2602,7 @@ interface FunctionGetTimeRangeStatsResponse {
      * as requirements evolve
      */
     inputPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Container lifecycle counts. Started and errored containers are counted when
@@ -2571,7 +2617,7 @@ interface FunctionGetTimeRangeStatsResponse {
      * as requirements evolve
      */
     containerPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Number of direct non-version-pinned variants included in the roll-up.
@@ -2782,13 +2828,13 @@ interface FunctionSchema {
     returnType: GenericPayloadType | undefined;
 }
 declare const FunctionSchema: MessageFns$1<FunctionSchema>;
-interface FunctionStats {
+interface FunctionStats$1 {
     backlog: number;
     numTotalTasks: number;
     numRunningInputs: number;
     inputHeadroom: number;
 }
-declare const FunctionStats: MessageFns$1<FunctionStats>;
+declare const FunctionStats$1: MessageFns$1<FunctionStats$1>;
 interface FunctionUpdateSchedulingParamsRequest {
     functionId: string;
     warmPoolSizeOverride: number;
@@ -3865,6 +3911,11 @@ interface SandboxGetFromNameRequest {
     sandboxName: string;
     environmentName: string;
     appName: string;
+    /**
+     * When set, the lookup also considers sandboxes that have already stopped and
+     * returns the most recently created sandbox with the given name.
+     */
+    includeTerminated: boolean;
 }
 declare const SandboxGetFromNameRequest: MessageFns$1<SandboxGetFromNameRequest>;
 interface SandboxGetFromNameResponse {
@@ -4230,14 +4281,14 @@ interface ServerGetTimeRangeStatsResponse {
     requestRatePerSecond: number;
     /** Metrics include request_latency, subject to change as requirements evolve. */
     requestPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Metrics include startup_time, cpu_usage, memory_usage, and
      * gpu_utilization, subject to change as requirements evolve.
      */
     containerPercentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /** Absent when the image does not contain a supported inference engine. */
     inference: ServerGetTimeRangeStatsResponse_ServerInferenceStats | undefined;
@@ -4261,7 +4312,7 @@ interface ServerGetTimeRangeStatsResponse_ServerInferenceStats {
      * end_to_end_latency, subject to change as requirements evolve.
      */
     percentileStats: {
-        [key: string]: StatsPercentileDistribution;
+        [key: string]: StatsPercentileDistribution$1;
     };
     /**
      * Metrics include input_tokens_per_second, cached_input_tokens_per_second,
@@ -4402,18 +4453,18 @@ interface SharedVolumeRemoveFileRequest {
     recursive: boolean;
 }
 declare const SharedVolumeRemoveFileRequest: MessageFns$1<SharedVolumeRemoveFileRequest>;
-interface StatsPercentile {
+interface StatsPercentile$1 {
     /** The percentile expressed in basis points: 5000 is p50 and 9990 is p99.9. */
     percentileBasisPoints: number;
     value: number;
 }
-declare const StatsPercentile: MessageFns$1<StatsPercentile>;
-interface StatsPercentileDistribution {
+declare const StatsPercentile$1: MessageFns$1<StatsPercentile$1>;
+interface StatsPercentileDistribution$1 {
     /** Unit identifier such as "seconds", "cores", "gibibytes", or "fraction". */
     unit: string;
-    percentiles: StatsPercentile[];
+    percentiles: StatsPercentile$1[];
 }
-declare const StatsPercentileDistribution: MessageFns$1<StatsPercentileDistribution>;
+declare const StatsPercentileDistribution$1: MessageFns$1<StatsPercentileDistribution$1>;
 interface StringMap {
     contents: {
         [key: string]: string;
@@ -5438,6 +5489,14 @@ declare const ModalClientDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly clusterReservationList: {
+            readonly name: "ClusterReservationList";
+            readonly requestType: MessageFns$1<ClusterReservationListRequest>;
+            readonly requestStream: false;
+            readonly responseType: MessageFns$1<ClusterReservationListResponse>;
+            readonly responseStream: false;
+            readonly options: {};
+        };
         /** Container */
         readonly containerCheckpoint: {
             readonly name: "ContainerCheckpoint";
@@ -5987,7 +6046,7 @@ declare const ModalClientDefinition: {
             readonly name: "FunctionGetCurrentStats";
             readonly requestType: MessageFns$1<FunctionGetCurrentStatsRequest>;
             readonly requestStream: false;
-            readonly responseType: MessageFns$1<FunctionStats>;
+            readonly responseType: MessageFns$1<FunctionStats$1>;
             readonly responseStream: false;
             readonly options: {};
         };
@@ -7828,6 +7887,39 @@ interface FunctionCurrentStats {
     backlog: number;
     numTotalRunners: number;
 }
+interface StatsPercentile {
+    percentile: number;
+    value: number;
+}
+interface StatsPercentileDistribution {
+    unit: string;
+    percentiles: StatsPercentile[];
+}
+interface FunctionStats {
+    since: Date;
+    until: Date;
+    inputSuccessCount: number;
+    inputFailureCount: number;
+    inputTimeoutCount: number;
+    inputRunningAtEndCount: number;
+    containerStartedCount: number;
+    containerErrorCount: number;
+    containerCreatingAtEndCount: number;
+    variantCount: number;
+    inputPercentileStats: Record<string, StatsPercentileDistribution>;
+    containerPercentileStats: Record<string, StatsPercentileDistribution>;
+    allVariants: boolean;
+}
+interface FunctionStatsParams {
+    /** Inclusive start; defaults to one hour before until. */
+    since?: Date;
+    /** Exclusive end; defaults to the current time. */
+    until?: Date;
+    /** Restrict statistics to this container ID. */
+    container?: string;
+    /** Aggregate the base Function and its variants. Defaults to false. */
+    allVariants?: boolean;
+}
 /** Optional parameters for {@link Function_#updateAutoscaler Function_.updateAutoscaler()}. */
 interface FunctionUpdateAutoscalerParams {
     minContainers?: number;
@@ -7906,6 +7998,29 @@ declare class Function_ {
     instance(): Promise<Function_>;
     remote(args?: any[], kwargs?: Record<string, any>): Promise<any>;
     spawn(args?: any[], kwargs?: Record<string, any>): Promise<FunctionCall>;
+    /**
+     * Return historical statistics. Defaults to the last hour; the maximum range is 7 days.
+     *
+     * @example Read statistics for the last hour.
+     * ```ts
+     * const fn = await modal.functions.fromName("libmodal-test-support", "echo_string");
+     * const stats = await fn.stats();
+     * console.log(stats.inputSuccessCount, stats.inputFailureCount);
+     * ```
+     *
+     * @example Include all variants over the last 24 hours.
+     * ```ts
+     * const until = new Date();
+     * const since = new Date(until.getTime() - 24 * 60 * 60 * 1000);
+     * const variantStats = await fn.stats({ since, until, allVariants: true });
+     * for (const [metric, distribution] of Object.entries(variantStats.inputPercentileStats)) {
+     *   console.log(metric, distribution.unit, distribution.percentiles);
+     * }
+     * ```
+     *
+     * Set `container` to a container ID to restrict statistics to that container.
+     */
+    stats(params?: FunctionStatsParams): Promise<FunctionStats>;
     getCurrentStats(): Promise<FunctionCurrentStats>;
     updateAutoscaler(params: FunctionUpdateAutoscalerParams): Promise<FunctionAutoscalerSettings>;
     /**
@@ -10208,4 +10323,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 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 };
+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, type FunctionStats, type FunctionStatsParams, 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 StatsPercentile, type StatsPercentileDistribution, type StdioBehavior, type StreamMode, TimeoutError, Tunnel, Volume, type VolumeDeleteParams, type VolumeEphemeralParams, type VolumeFromNameParams, type VolumeMountOptionsParams, VolumeService, checkForRenamedParams };