modal 0.3.19 → 0.3.21

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/app.ts
-import { ClientError as ClientError4, Status as Status4 } from "nice-grpc";
+import { ClientError as ClientError5, Status as Status5 } from "nice-grpc";
 
 // node_modules/@bufbuild/protobuf/dist/esm/wire/varint.js
 function varint64read() {
@@ -6460,6 +6460,104 @@ var AutoscalerSettings = {
     return message;
   }
 };
+function createBaseAutoscalingMetrics() {
+  return { cpuUsagePercent: 0, memoryUsagePercent: 0, concurrentRequests: 0, timestamp: 0 };
+}
+var AutoscalingMetrics = {
+  encode(message, writer = new BinaryWriter()) {
+    if (message.cpuUsagePercent !== 0) {
+      writer.uint32(9).double(message.cpuUsagePercent);
+    }
+    if (message.memoryUsagePercent !== 0) {
+      writer.uint32(17).double(message.memoryUsagePercent);
+    }
+    if (message.concurrentRequests !== 0) {
+      writer.uint32(24).uint32(message.concurrentRequests);
+    }
+    if (message.timestamp !== 0) {
+      writer.uint32(33).double(message.timestamp);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseAutoscalingMetrics();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 9) {
+            break;
+          }
+          message.cpuUsagePercent = reader.double();
+          continue;
+        }
+        case 2: {
+          if (tag !== 17) {
+            break;
+          }
+          message.memoryUsagePercent = reader.double();
+          continue;
+        }
+        case 3: {
+          if (tag !== 24) {
+            break;
+          }
+          message.concurrentRequests = reader.uint32();
+          continue;
+        }
+        case 4: {
+          if (tag !== 33) {
+            break;
+          }
+          message.timestamp = reader.double();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return {
+      cpuUsagePercent: isSet3(object.cpuUsagePercent) ? globalThis.Number(object.cpuUsagePercent) : 0,
+      memoryUsagePercent: isSet3(object.memoryUsagePercent) ? globalThis.Number(object.memoryUsagePercent) : 0,
+      concurrentRequests: isSet3(object.concurrentRequests) ? globalThis.Number(object.concurrentRequests) : 0,
+      timestamp: isSet3(object.timestamp) ? globalThis.Number(object.timestamp) : 0
+    };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.cpuUsagePercent !== 0) {
+      obj.cpuUsagePercent = message.cpuUsagePercent;
+    }
+    if (message.memoryUsagePercent !== 0) {
+      obj.memoryUsagePercent = message.memoryUsagePercent;
+    }
+    if (message.concurrentRequests !== 0) {
+      obj.concurrentRequests = Math.round(message.concurrentRequests);
+    }
+    if (message.timestamp !== 0) {
+      obj.timestamp = message.timestamp;
+    }
+    return obj;
+  },
+  create(base) {
+    return AutoscalingMetrics.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseAutoscalingMetrics();
+    message.cpuUsagePercent = object.cpuUsagePercent ?? 0;
+    message.memoryUsagePercent = object.memoryUsagePercent ?? 0;
+    message.concurrentRequests = object.concurrentRequests ?? 0;
+    message.timestamp = object.timestamp ?? 0;
+    return message;
+  }
+};
 function createBaseBaseImage() {
   return { imageId: "", dockerTag: "" };
 }
@@ -19629,7 +19727,8 @@ function createBaseFunctionHandleMetadata() {
     functionSchema: void 0,
     inputPlaneUrl: void 0,
     inputPlaneRegion: void 0,
-    maxObjectSizeBytes: void 0
+    maxObjectSizeBytes: void 0,
+    ExperimentalFlashUrls: []
   };
 }
 var FunctionHandleMetadata = {
@@ -19673,6 +19772,9 @@ var FunctionHandleMetadata = {
     if (message.maxObjectSizeBytes !== void 0) {
       writer.uint32(384).uint64(message.maxObjectSizeBytes);
     }
+    for (const v of message.ExperimentalFlashUrls) {
+      writer.uint32(394).string(v);
+    }
     return writer;
   },
   decode(input, length) {
@@ -19776,6 +19878,13 @@ var FunctionHandleMetadata = {
           message.maxObjectSizeBytes = longToNumber(reader.uint64());
           continue;
         }
+        case 49: {
+          if (tag !== 394) {
+            break;
+          }
+          message.ExperimentalFlashUrls.push(reader.string());
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -19804,7 +19913,8 @@ var FunctionHandleMetadata = {
       functionSchema: isSet3(object.functionSchema) ? FunctionSchema.fromJSON(object.functionSchema) : void 0,
       inputPlaneUrl: isSet3(object.inputPlaneUrl) ? globalThis.String(object.inputPlaneUrl) : void 0,
       inputPlaneRegion: isSet3(object.inputPlaneRegion) ? globalThis.String(object.inputPlaneRegion) : void 0,
-      maxObjectSizeBytes: isSet3(object.maxObjectSizeBytes) ? globalThis.Number(object.maxObjectSizeBytes) : void 0
+      maxObjectSizeBytes: isSet3(object.maxObjectSizeBytes) ? globalThis.Number(object.maxObjectSizeBytes) : void 0,
+      ExperimentalFlashUrls: globalThis.Array.isArray(object?.ExperimentalFlashUrls) ? object.ExperimentalFlashUrls.map((e) => globalThis.String(e)) : []
     };
   },
   toJSON(message) {
@@ -19854,6 +19964,9 @@ var FunctionHandleMetadata = {
     if (message.maxObjectSizeBytes !== void 0) {
       obj.maxObjectSizeBytes = Math.round(message.maxObjectSizeBytes);
     }
+    if (message.ExperimentalFlashUrls?.length) {
+      obj.ExperimentalFlashUrls = message.ExperimentalFlashUrls;
+    }
     return obj;
   },
   create(base) {
@@ -19879,6 +19992,7 @@ var FunctionHandleMetadata = {
     message.inputPlaneUrl = object.inputPlaneUrl ?? void 0;
     message.inputPlaneRegion = object.inputPlaneRegion ?? void 0;
     message.maxObjectSizeBytes = object.maxObjectSizeBytes ?? void 0;
+    message.ExperimentalFlashUrls = object.ExperimentalFlashUrls?.map((e) => e) || [];
     return message;
   }
 };
@@ -22941,6 +23055,57 @@ var ImageContextFile = {
     return message;
   }
 };
+function createBaseImageDeleteRequest() {
+  return { imageId: "" };
+}
+var ImageDeleteRequest = {
+  encode(message, writer = new BinaryWriter()) {
+    if (message.imageId !== "") {
+      writer.uint32(10).string(message.imageId);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseImageDeleteRequest();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.imageId = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return { imageId: isSet3(object.imageId) ? globalThis.String(object.imageId) : "" };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.imageId !== "") {
+      obj.imageId = message.imageId;
+    }
+    return obj;
+  },
+  create(base) {
+    return ImageDeleteRequest.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseImageDeleteRequest();
+    message.imageId = object.imageId ?? "";
+    return message;
+  }
+};
 function createBaseImageFromIdRequest() {
   return { imageId: "" };
 }
@@ -34946,6 +35111,108 @@ var TaskCurrentInputsResponse = {
     return message;
   }
 };
+function createBaseTaskGetAutoscalingMetricsRequest() {
+  return { taskId: "" };
+}
+var TaskGetAutoscalingMetricsRequest = {
+  encode(message, writer = new BinaryWriter()) {
+    if (message.taskId !== "") {
+      writer.uint32(10).string(message.taskId);
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseTaskGetAutoscalingMetricsRequest();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.taskId = reader.string();
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return { taskId: isSet3(object.taskId) ? globalThis.String(object.taskId) : "" };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.taskId !== "") {
+      obj.taskId = message.taskId;
+    }
+    return obj;
+  },
+  create(base) {
+    return TaskGetAutoscalingMetricsRequest.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseTaskGetAutoscalingMetricsRequest();
+    message.taskId = object.taskId ?? "";
+    return message;
+  }
+};
+function createBaseTaskGetAutoscalingMetricsResponse() {
+  return { metrics: void 0 };
+}
+var TaskGetAutoscalingMetricsResponse = {
+  encode(message, writer = new BinaryWriter()) {
+    if (message.metrics !== void 0) {
+      AutoscalingMetrics.encode(message.metrics, writer.uint32(10).fork()).join();
+    }
+    return writer;
+  },
+  decode(input, length) {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    let end = length === void 0 ? reader.len : reader.pos + length;
+    const message = createBaseTaskGetAutoscalingMetricsResponse();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1: {
+          if (tag !== 10) {
+            break;
+          }
+          message.metrics = AutoscalingMetrics.decode(reader, reader.uint32());
+          continue;
+        }
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skip(tag & 7);
+    }
+    return message;
+  },
+  fromJSON(object) {
+    return { metrics: isSet3(object.metrics) ? AutoscalingMetrics.fromJSON(object.metrics) : void 0 };
+  },
+  toJSON(message) {
+    const obj = {};
+    if (message.metrics !== void 0) {
+      obj.metrics = AutoscalingMetrics.toJSON(message.metrics);
+    }
+    return obj;
+  },
+  create(base) {
+    return TaskGetAutoscalingMetricsResponse.fromPartial(base ?? {});
+  },
+  fromPartial(object) {
+    const message = createBaseTaskGetAutoscalingMetricsResponse();
+    message.metrics = object.metrics !== void 0 && object.metrics !== null ? AutoscalingMetrics.fromPartial(object.metrics) : void 0;
+    return message;
+  }
+};
 function createBaseTaskInfo() {
   return {
     id: "",
@@ -40378,6 +40645,14 @@ var ModalClientDefinition = {
       options: {}
     },
     /** Images */
+    imageDelete: {
+      name: "ImageDelete",
+      requestType: ImageDeleteRequest,
+      requestStream: false,
+      responseType: Empty,
+      responseStream: false,
+      options: {}
+    },
     imageFromId: {
       name: "ImageFromId",
       requestType: ImageFromIdRequest,
@@ -40844,6 +41119,15 @@ var ModalClientDefinition = {
       responseStream: false,
       options: {}
     },
+    /** Used for flash autoscaling */
+    taskGetAutoscalingMetrics: {
+      name: "TaskGetAutoscalingMetrics",
+      requestType: TaskGetAutoscalingMetricsRequest,
+      requestStream: false,
+      responseType: TaskGetAutoscalingMetricsResponse,
+      responseStream: false,
+      options: {}
+    },
     taskList: {
       name: "TaskList",
       requestType: TaskListRequest,
@@ -41428,6 +41712,8 @@ var Secret = class _Secret {
 };
 
 // src/image.ts
+import { ClientError as ClientError3 } from "nice-grpc";
+import { Status as Status3 } from "nice-grpc";
 var Image2 = class _Image {
   #imageId;
   #tag;
@@ -41442,18 +41728,27 @@ var Image2 = class _Image {
     return this.#imageId;
   }
   /**
-   * Creates an `Image` instance from an image id
+   * Creates an Image from an Image ID
    *
-   * @param imageId - Image id.
+   * @param imageId - Image ID.
    */
-  static fromId(imageId) {
-    return new _Image(imageId, "");
+  static async fromId(imageId) {
+    try {
+      const resp = await client.imageFromId({ imageId });
+      return new _Image(resp.imageId, "");
+    } catch (err) {
+      if (err instanceof ClientError3 && err.code === Status3.NOT_FOUND)
+        throw new NotFoundError(err.details);
+      if (err instanceof ClientError3 && err.code === Status3.FAILED_PRECONDITION && err.details.includes("Could not find image with ID"))
+        throw new NotFoundError(err.details);
+      throw err;
+    }
   }
   /**
-   * Creates an `Image` instance from a raw registry tag, optionally using a secret for authentication.
+   * Creates an Image from a raw registry tag, optionally using a Secret for authentication.
    *
-   * @param tag - The registry tag for the image.
-   * @param secret - Optional. A `Secret` instance containing credentials for registry authentication.
+   * @param tag - The registry tag for the Image.
+   * @param secret - Optional. A Secret containing credentials for registry authentication.
    */
   static fromRegistry(tag, secret) {
     let imageRegistryConfig;
@@ -41471,10 +41766,10 @@ var Image2 = class _Image {
     return new _Image("", tag, imageRegistryConfig);
   }
   /**
-   * Creates an `Image` instance from a raw registry tag, optionally using a secret for authentication.
+   * Creates an Image from a raw registry tag, optionally using a Secret for authentication.
    *
-   * @param tag - The registry tag for the image.
-   * @param secret - A `Secret` instance containing credentials for registry authentication.
+   * @param tag - The registry tag for the Image.
+   * @param secret - A Secret containing credentials for registry authentication.
    */
   static fromAwsEcr(tag, secret) {
     let imageRegistryConfig;
@@ -41492,10 +41787,10 @@ var Image2 = class _Image {
     return new _Image("", tag, imageRegistryConfig);
   }
   /**
-   * Creates an `Image` instance from a raw registry tag, optionally using a secret for authentication.
+   * Creates an Image from a raw registry tag, optionally using a Secret for authentication.
    *
-   * @param tag - The registry tag for the image.
-   * @param secret - A `Secret` instance containing credentials for registry authentication.
+   * @param tag - The registry tag for the Image.
+   * @param secret - A Secret containing credentials for registry authentication.
    */
   static fromGcpArtifactRegistry(tag, secret) {
     let imageRegistryConfig;
@@ -41513,9 +41808,9 @@ var Image2 = class _Image {
     return new _Image("", tag, imageRegistryConfig);
   }
   /**
-   * Eagerly builds an `Image` on Modal.
+   * Eagerly builds an Image on Modal.
    *
-   * @param app - App to use to build image.
+   * @param app - App to use to build the Image.
    */
   async build(app) {
     if (this.imageId !== "") {
@@ -41575,10 +41870,15 @@ ${result.exception}`
     this.#imageId = resp.imageId;
     return this;
   }
+  /** Delete an Image by ID. Warning: This removes an *entire Image*, and cannot be undone. */
+  static async delete(imageId, _ = {}) {
+    const image = await _Image.fromId(imageId);
+    await client.imageDelete({ imageId: image.imageId });
+  }
 };
 
 // src/sandbox.ts
-import { ClientError as ClientError3, Status as Status3 } from "nice-grpc";
+import { ClientError as ClientError4, Status as Status4 } from "nice-grpc";
 
 // src/sandbox_filesystem.ts
 var SandboxFile = class {
@@ -41856,7 +42156,7 @@ var Sandbox2 = class _Sandbox {
         tags: tagsList
       });
     } catch (err) {
-      if (err instanceof ClientError3 && err.code === Status3.INVALID_ARGUMENT) {
+      if (err instanceof ClientError4 && err.code === Status4.INVALID_ARGUMENT) {
         throw new InvalidError(err.details || err.message);
       }
       throw err;
@@ -41873,7 +42173,7 @@ var Sandbox2 = class _Sandbox {
         timeout: 0
       });
     } catch (err) {
-      if (err instanceof ClientError3 && err.code === Status3.NOT_FOUND)
+      if (err instanceof ClientError4 && err.code === Status4.NOT_FOUND)
         throw new NotFoundError(`Sandbox with id: '${sandboxId}' not found`);
       throw err;
     }
@@ -41884,8 +42184,8 @@ var Sandbox2 = class _Sandbox {
    * Raises a NotFoundError if no running Sandbox is found with the given name.
    * A Sandbox's name is the `name` argument passed to `App.createSandbox`.
    *
-   * @param appName - Name of the deployed app
-   * @param name - Name of the sandbox
+   * @param appName - Name of the deployed App
+   * @param name - Name of the Sandbox
    * @param environment - Optional override for the environment
    * @returns Promise that resolves to a Sandbox
    */
@@ -41898,15 +42198,15 @@ var Sandbox2 = class _Sandbox {
       });
       return new _Sandbox(resp.sandboxId);
     } catch (err) {
-      if (err instanceof ClientError3 && err.code === Status3.NOT_FOUND)
+      if (err instanceof ClientError4 && err.code === Status4.NOT_FOUND)
         throw new NotFoundError(
-          `Sandbox with name '${name}' not found in app '${appName}'`
+          `Sandbox with name '${name}' not found in App '${appName}'`
         );
       throw err;
     }
   }
   /**
-   * Open a file in the sandbox filesystem.
+   * Open a file in the Sandbox filesystem.
    * @param path - Path to the file to open
    * @param mode - File open mode (r, w, a, r+, w+, a+)
    * @returns Promise that resolves to a SandboxFile
@@ -41969,7 +42269,7 @@ var Sandbox2 = class _Sandbox {
       }
     }
   }
-  /** Get Tunnel metadata for the sandbox.
+  /** Get Tunnel metadata for the Sandbox.
    *
    * Raises `SandboxTimeoutError` if the tunnels are not available after the timeout.
    *
@@ -42017,7 +42317,7 @@ var Sandbox2 = class _Sandbox {
       );
     }
     if (!resp.imageId) {
-      throw new Error("Sandbox snapshot response missing image ID");
+      throw new Error("Sandbox snapshot response missing `imageId`");
     }
     return new Image2(resp.imageId, "");
   }
@@ -42061,7 +42361,7 @@ var Sandbox2 = class _Sandbox {
         }
         beforeTimestamp = resp.sandboxes[resp.sandboxes.length - 1].createdAt;
       } catch (err) {
-        if (err instanceof ClientError3 && err.code === Status3.INVALID_ARGUMENT) {
+        if (err instanceof ClientError4 && err.code === Status4.INVALID_ARGUMENT) {
           throw new InvalidError(err.details || err.message);
         }
         throw err;
@@ -42327,7 +42627,7 @@ var App = class _App {
     this.appId = appId;
     this.name = name;
   }
-  /** Lookup a deployed app by name, or create if it does not exist. */
+  /** Lookup a deployed App by name, or create if it does not exist. */
   static async lookup(name, options = {}) {
     try {
       const resp = await client.appGetOrCreate({
@@ -42337,7 +42637,7 @@ var App = class _App {
       });
       return new _App(resp.appId, name);
     } catch (err) {
-      if (err instanceof ClientError4 && err.code === Status4.NOT_FOUND)
+      if (err instanceof ClientError5 && err.code === Status5.NOT_FOUND)
         throw new NotFoundError(`App '${name}' not found`);
       throw err;
     }
@@ -42346,7 +42646,12 @@ var App = class _App {
     const gpuConfig = parseGpuConfig(options.gpu);
     if (options.timeout && options.timeout % 1e3 !== 0) {
       throw new Error(
-        `Timeout must be a multiple of 1000ms, got ${options.timeout}`
+        `timeout must be a multiple of 1000ms, got ${options.timeout}`
+      );
+    }
+    if (options.idleTimeout && options.idleTimeout % 1e3 !== 0) {
+      throw new Error(
+        `idleTimeout must be a multiple of 1000ms, got ${options.idleTimeout}`
       );
     }
     await image.build(this);
@@ -42425,6 +42730,7 @@ var App = class _App {
           entrypointArgs: options.command ?? ["sleep", "48h"],
           imageId: image.imageId,
           timeoutSecs: options.timeout != void 0 ? options.timeout / 1e3 : 600,
+          idleTimeoutSecs: options.idleTimeout != void 0 ? options.idleTimeout / 1e3 : void 0,
           workdir: options.workdir ?? void 0,
           networkAccess,
           resources: {
@@ -42445,7 +42751,7 @@ var App = class _App {
         }
       });
     } catch (err) {
-      if (err instanceof ClientError4 && err.code === Status4.ALREADY_EXISTS) {
+      if (err instanceof ClientError5 && err.code === Status5.ALREADY_EXISTS) {
         throw new AlreadyExistsError(err.details || err.message);
       }
       throw err;
@@ -42473,7 +42779,7 @@ var App = class _App {
 };
 
 // src/cls.ts
-import { ClientError as ClientError6, Status as Status6 } from "nice-grpc";
+import { ClientError as ClientError7, Status as Status7 } from "nice-grpc";
 
 // src/function.ts
 import { createHash } from "node:crypto";
@@ -42639,7 +42945,9 @@ function encodeValue(val, w, proto) {
     }
     return;
   }
-  throw new PickleError(`Unsupported type in dumps(): ${typeof val}`);
+  throw new PickleError(
+    `The JS Modal SDK does not support encoding/pickling data of type ${typeof val}`
+  );
 }
 function maybeMemoize(w, proto) {
   if (proto >= 4) {
@@ -42648,7 +42956,9 @@ function maybeMemoize(w, proto) {
 }
 function dumps(obj, protocol = 4) {
   if (![3, 4, 5].includes(protocol))
-    throw new PickleError("Protocol must be 3, 4, or 5");
+    throw new PickleError(
+      `The JS Modal SDK does not support pickle protocol version ${protocol}`
+    );
   const w = new Writer();
   w.byte(128 /* PROTO */);
   w.byte(protocol);
@@ -42665,8 +42975,10 @@ function loads(buf) {
   const op0 = r.byte();
   if (op0 !== 128 /* PROTO */) throw new PickleError("pickle missing PROTO header");
   const proto = r.byte();
-  if (!(proto === 3 || proto === 4 || proto === 5))
-    throw new PickleError(`Unsupported protocol ${proto}`);
+  if (![3, 4, 5].includes(proto))
+    throw new PickleError(
+      `The JS Modal SDK does not support pickle protocol version ${proto}`
+    );
   const stack = [];
   const memo = [];
   const tdec = new TextDecoder();
@@ -42819,7 +43131,9 @@ function loads(buf) {
         break;
       }
       default:
-        throw new PickleError(`Unsupported opcode 0x${op.toString(16)}`);
+        throw new PickleError(
+          `The JS Modal SDK does not support decoding/unpickling this kind of data. Error: unsupported opcode 0x${op.toString(16)}`
+        );
     }
   }
   throw new PickleError("pickle stream ended without STOP");
@@ -42879,7 +43193,7 @@ var ControlPlaneInvocation = class _ControlPlaneInvocation {
   }
   async retry(retryCount) {
     if (!this.input) {
-      throw new Error("Cannot retry function invocation - input missing");
+      throw new Error("Cannot retry Function invocation - input missing");
     }
     const retryItem = {
       inputJwt: this.inputJwt,
@@ -43022,11 +43336,11 @@ var FunctionCall = class _FunctionCall {
   constructor(functionCallId) {
     this.functionCallId = functionCallId;
   }
-  /** Create a new function call from ID. */
+  /** Create a new Function call from ID. */
   fromId(functionCallId) {
     return new _FunctionCall(functionCallId);
   }
-  /** Get the result of a function call, optionally waiting with a timeout. */
+  /** Get the result of a Function call, optionally waiting with a timeout. */
   async get(options = {}) {
     const timeout = options.timeout;
     const invocation = ControlPlaneInvocation.fromFunctionCallId(
@@ -43034,7 +43348,7 @@ var FunctionCall = class _FunctionCall {
     );
     return invocation.awaitOutput(timeout);
   }
-  /** Cancel a running function call. */
+  /** Cancel a running Function call. */
   async cancel(options = {}) {
     await client.functionCallCancel({
       functionCallId: this.functionCallId,
@@ -43044,7 +43358,7 @@ var FunctionCall = class _FunctionCall {
 };
 
 // src/function.ts
-import { ClientError as ClientError5, Status as Status5 } from "nice-grpc";
+import { ClientError as ClientError6, Status as Status6 } from "nice-grpc";
 var maxObjectSizeBytes = 2 * 1024 * 1024;
 var maxSystemRetries = 8;
 var Function_ = class _Function_ {
@@ -43073,7 +43387,7 @@ var Function_ = class _Function_ {
         resp.handleMetadata?.webUrl
       );
     } catch (err) {
-      if (err instanceof ClientError5 && err.code === Status5.NOT_FOUND)
+      if (err instanceof ClientError6 && err.code === Status6.NOT_FOUND)
         throw new NotFoundError(`Function '${appName}/${name}' not found`);
       throw err;
     }
@@ -43110,7 +43424,7 @@ var Function_ = class _Function_ {
       4 /* FUNCTION_CALL_INVOCATION_TYPE_SYNC */
     );
   }
-  // Spawn a single input into a remote function.
+  // Spawn a single input into a remote Function.
   async spawn(args = [], kwargs = {}) {
     const input = await this.#createInput(args, kwargs);
     const invocation = await ControlPlaneInvocation.create(
@@ -43147,7 +43461,7 @@ var Function_ = class _Function_ {
   }
   /**
    * URL of a Function running as a web endpoint.
-   * @returns The web URL if this function is a web endpoint, otherwise undefined
+   * @returns The web URL if this Function is a web endpoint, otherwise undefined
    */
   async getWebUrl() {
     return this.#webUrl || void 0;
@@ -43305,7 +43619,7 @@ var Cls = class _Cls {
         void 0
       );
     } catch (err) {
-      if (err instanceof ClientError6 && err.code === Status6.NOT_FOUND)
+      if (err instanceof ClientError7 && err.code === Status7.NOT_FOUND)
         throw new NotFoundError(`Class '${appName}/${name}' not found`);
       throw err;
     }
@@ -43501,7 +43815,7 @@ var ClsInstance = class {
 };
 
 // src/queue.ts
-import { ClientError as ClientError7, Status as Status7 } from "nice-grpc";
+import { ClientError as ClientError8, Status as Status8 } from "nice-grpc";
 
 // src/ephemeral.ts
 var ephemeralObjectHeartbeatSleep = 3e5;
@@ -43560,8 +43874,8 @@ var Queue = class _Queue {
     return new Uint8Array();
   }
   /**
-   * Create a nameless, temporary queue.
-   * You will need to call `closeEphemeral()` to delete the queue.
+   * Create a nameless, temporary Queue.
+   * You will need to call `closeEphemeral()` to delete the Queue.
    */
   static async ephemeral(options = {}) {
     const resp = await client.queueGetOrCreate({
@@ -43573,7 +43887,7 @@ var Queue = class _Queue {
     );
     return new _Queue(resp.queueId, void 0, ephemeralHbManager);
   }
-  /** Delete the ephemeral queue. Only usable with `Queue.ephemeral()`. */
+  /** Delete the ephemeral Queue. Only usable with `Queue.ephemeral()`. */
   closeEphemeral() {
     if (this.#ephemeralHbManager) {
       this.#ephemeralHbManager.stop();
@@ -43582,7 +43896,7 @@ var Queue = class _Queue {
     }
   }
   /**
-   * Lookup a queue by name.
+   * Lookup a Queue by name.
    */
   static async lookup(name, options = {}) {
     const resp = await client.queueGetOrCreate({
@@ -43592,13 +43906,13 @@ var Queue = class _Queue {
     });
     return new _Queue(resp.queueId, name);
   }
-  /** Delete a queue by name. */
+  /** Delete a Queue by name. */
   static async delete(name, options = {}) {
     const queue = await _Queue.lookup(name, options);
     await client.queueDelete({ queueId: queue.queueId });
   }
   /**
-   * Remove all objects from a queue partition.
+   * Remove all objects from a Queue partition.
    */
   async clear(options = {}) {
     if (options.partition && options.all) {
@@ -43640,9 +43954,9 @@ var Queue = class _Queue {
     }
   }
   /**
-   * Remove and return the next object from the queue.
+   * Remove and return the next object from the Queue.
    *
-   * By default, this will wait until at least one item is present in the queue.
+   * By default, this will wait until at least one item is present in the Queue.
    * If `timeout` is set, raises `QueueEmptyError` if no items are available
    * within that timeout in milliseconds.
    */
@@ -43651,9 +43965,9 @@ var Queue = class _Queue {
     return values[0];
   }
   /**
-   * Remove and return up to `n` objects from the queue.
+   * Remove and return up to `n` objects from the Queue.
    *
-   * By default, this will wait until at least one item is present in the queue.
+   * By default, this will wait until at least one item is present in the Queue.
    * If `timeout` is set, raises `QueueEmptyError` if no items are available
    * within that timeout in milliseconds.
    */
@@ -43675,7 +43989,7 @@ var Queue = class _Queue {
         });
         break;
       } catch (e) {
-        if (e instanceof ClientError7 && e.code === Status7.RESOURCE_EXHAUSTED) {
+        if (e instanceof ClientError8 && e.code === Status8.RESOURCE_EXHAUSTED) {
           delay = Math.min(delay * 2, 3e4);
           if (deadline !== void 0) {
             const remaining = deadline - Date.now();
@@ -43691,11 +44005,11 @@ var Queue = class _Queue {
     }
   }
   /**
-   * Add an item to the end of the queue.
+   * Add an item to the end of the Queue.
    *
-   * If the queue is full, this will retry with exponential backoff until the
+   * If the Queue is full, this will retry with exponential backoff until the
    * provided `timeout` is reached, or indefinitely if `timeout` is not set.
-   * Raises `QueueFullError` if the queue is still full after the timeout.
+   * Raises `QueueFullError` if the Queue is still full after the timeout.
    */
   async put(v, options = {}) {
     await this.#put(
@@ -43706,11 +44020,11 @@ var Queue = class _Queue {
     );
   }
   /**
-   * Add several items to the end of the queue.
+   * Add several items to the end of the Queue.
    *
-   * If the queue is full, this will retry with exponential backoff until the
+   * If the Queue is full, this will retry with exponential backoff until the
    * provided `timeout` is reached, or indefinitely if `timeout` is not set.
-   * Raises `QueueFullError` if the queue is still full after the timeout.
+   * Raises `QueueFullError` if the Queue is still full after the timeout.
    */
   async putMany(values, options = {}) {
     await this.#put(
@@ -43720,7 +44034,7 @@ var Queue = class _Queue {
       options.partitionTtl
     );
   }
-  /** Return the number of objects in the queue. */
+  /** Return the number of objects in the Queue. */
   async len(options = {}) {
     if (options.partition && options.total) {
       throw new InvalidError(
@@ -43734,7 +44048,7 @@ var Queue = class _Queue {
     });
     return resp.len;
   }
-  /** Iterate through items in a queue without mutation. */
+  /** Iterate through items in a Queue without mutation. */
   async *iterate(options = {}) {
     const { partition, itemPollTimeout = 0 } = options;
     let lastEntryId = void 0;
@@ -43767,7 +44081,7 @@ var Queue = class _Queue {
 };
 
 // src/volume.ts
-import { ClientError as ClientError8, Status as Status8 } from "nice-grpc";
+import { ClientError as ClientError9, Status as Status9 } from "nice-grpc";
 var Volume = class _Volume {
   volumeId;
   name;
@@ -43789,7 +44103,7 @@ var Volume = class _Volume {
       });
       return new _Volume(resp.volumeId, name);
     } catch (err) {
-      if (err instanceof ClientError8 && err.code === Status8.NOT_FOUND)
+      if (err instanceof ClientError9 && err.code === Status9.NOT_FOUND)
         throw new NotFoundError(err.details);
       throw err;
     }
@@ -43802,8 +44116,8 @@ var Volume = class _Volume {
     return this._readOnly;
   }
   /**
-   * Create a nameless, temporary volume.
-   * You will need to call `closeEphemeral()` to delete the volume.
+   * Create a nameless, temporary Volume.
+   * You will need to call `closeEphemeral()` to delete the Volume.
    */
   static async ephemeral(options = {}) {
     const resp = await client.volumeGetOrCreate({
@@ -43815,7 +44129,7 @@ var Volume = class _Volume {
     );
     return new _Volume(resp.volumeId, void 0, false, ephemeralHbManager);
   }
-  /** Delete the ephemeral volume. Only usable with `Volume.ephemeral()`. */
+  /** Delete the ephemeral Volume. Only usable with `Volume.ephemeral()`. */
   closeEphemeral() {
     if (this.#ephemeralHbManager) {
       this.#ephemeralHbManager.stop();
@@ -43826,7 +44140,7 @@ var Volume = class _Volume {
 };
 
 // src/proxy.ts
-import { ClientError as ClientError9, Status as Status9 } from "nice-grpc";
+import { ClientError as ClientError10, Status as Status10 } from "nice-grpc";
 var Proxy2 = class _Proxy {
   proxyId;
   /** @ignore */
@@ -43845,7 +44159,7 @@ var Proxy2 = class _Proxy {
       }
       return new _Proxy(resp.proxy.proxyId);
     } catch (err) {
-      if (err instanceof ClientError9 && err.code === Status9.NOT_FOUND)
+      if (err instanceof ClientError10 && err.code === Status10.NOT_FOUND)
         throw new NotFoundError(`Proxy '${name}' not found`);
       throw err;
     }