@tensorlakeai/tensorlake 0.5.153 → 0.5.156

package/dist/sandbox-image.cjs

@@ -151,10 +151,11 @@ var init_image = __esm({
         });
       }
       /**
-       * Build this image as a sandbox template and register it.
+       * Build this image and register it as a CAS sandbox image (the default) or,
+       * with `cas: false`, a legacy sandbox image.
        *
        * Materializes the image in a build sandbox, snapshots the filesystem,
-       * and registers the snapshot as a named sandbox template.
+       * and registers the snapshot under the image's name.
        */
       async build(options = {}) {
         const { createSandboxImage: createSandboxImage2 } = await Promise.resolve().then(() => (init_sandbox_image(), sandbox_image_exports));
@@ -314,7 +315,24 @@ var init_native_binding = __esm({
   }
 });
 
+// src/enum.ts
+function enumValue(values, value) {
+  return typeof value === "string" && Object.values(values).includes(value) ? value : values.UNKNOWN;
+}
+function withRaw(value, raw) {
+  return Object.defineProperty(value, "raw", { value: raw, enumerable: false, configurable: true });
+}
+var init_enum = __esm({
+  "src/enum.ts"() {
+    "use strict";
+    init_cjs_shims();
+  }
+});
+
 // src/image-builds.ts
+function isConfirmedCancellation(outcome) {
+  return outcome === "cancelled" /* CANCELLED */ || outcome === "already_cancelled" /* ALREADY_CANCELLED */ || outcome === "already_failed" /* ALREADY_FAILED */;
+}
 function camelize(key) {
   return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
 }
@@ -332,48 +350,73 @@ function toImageBuildError(error) {
     if (key === "category") continue;
     details[camelize(key)] = value;
   }
+  details.code = enumValue(ImageBuildErrorCode, details.code || "internal" /* INTERNAL */);
+  if ("activeKind" in details) details.activeKind = details.activeKind ? enumValue(ImageBuildKind, details.activeKind) : null;
+  if ("activeStatus" in details) details.activeStatus = details.activeStatus ? enumValue(ImageBuildStatus, details.activeStatus) : null;
+  if ("outcome" in details) details.outcome = details.outcome ? enumValue(ImageBuildCancellationOutcome, details.outcome) : null;
+  if ("info" in details) details.info = buildInfoOrNull(details.info);
   const typed = details;
-  switch (typed.code) {
-    case "not_found":
-      return new ImageBuildNotFoundError(typed);
-    case "image_build_in_progress":
-      return new ImageBuildInProgressError(typed);
-    case "failed":
-      return new ImageBuildFailedError(typed);
-    case "cancelled":
-      return new ImageBuildCancelledError(typed);
-    case "timeout":
-      return new ImageBuildTimeoutError(typed);
-    case "interrupted":
-      return new ImageBuildInterruptedError(typed);
-    default:
-      return new ImageBuildError(typed);
-  }
+  const errors = {
+    not_found: ImageBuildNotFoundError,
+    image_build_in_progress: ImageBuildInProgressError,
+    failed: ImageBuildFailedError,
+    cancelled: ImageBuildCancelledError,
+    timeout: ImageBuildTimeoutError,
+    interrupted: ImageBuildInterruptedError
+  };
+  const ErrorClass = errors[typed.code] ?? ImageBuildError;
+  return withRaw(new ErrorClass(typed), payload);
 }
 function camelizeRecord(value) {
   const out = {};
   for (const [key, inner] of Object.entries(value)) out[camelize(key)] = inner;
   return out;
 }
-function parseBuildInfo(raw) {
+function buildInfoOrNull(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  try {
+    return parseBuildInfo(value);
+  } catch (error) {
+    if (error instanceof ImageBuildError) return null;
+    throw error;
+  }
+}
+function decodeResponse(value) {
+  try {
+    const raw = typeof value === "string" ? JSON.parse(value) : value;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) throw new TypeError("expected a response object");
+    return raw;
+  } catch (error) {
+    throw withRaw(new ImageBuildError({ code: "service" /* SERVICE */, message: `Invalid image-build response: ${String(error)}` }), { response: value });
+  }
+}
+function parseBuildInfo(value) {
+  const raw = decodeResponse(value);
+  if (raw.status == null) {
+    throw withRaw(new ImageBuildError({ code: "service" /* SERVICE */, message: "Invalid image-build response: missing status" }), { response: value });
+  }
+  const attempt = raw.attempt_no ?? 0;
+  const attemptNo = Number(attempt);
+  if (typeof attempt !== "number" && typeof attempt !== "string" || typeof attempt === "string" && attempt.trim() === "" || !Number.isSafeInteger(attemptNo)) {
+    throw withRaw(new ImageBuildError({ code: "service" /* SERVICE */, message: "Invalid image-build attempt_no" }), { response: value });
+  }
   const camel = camelizeRecord(raw);
   const result = raw.result && typeof raw.result === "object" ? camelizeRecord(raw.result) : null;
-  return {
+  return withRaw({
     buildId: String(raw.build_id ?? ""),
     clientRequestId: camel.clientRequestId ?? null,
-    kind: String(raw.kind ?? ""),
+    kind: raw.kind ? enumValue(ImageBuildKind, raw.kind) : null,
     name: raw.name ?? null,
-    status: String(raw.status ?? ""),
-    phase: raw.phase ?? null,
-    attemptNo: Number(raw.attempt_no ?? 0),
+    status: enumValue(ImageBuildStatus, raw.status),
+    phase: raw.phase ? enumValue(ImageBuildPhase, raw.phase) : null,
+    attemptNo,
     builderSandboxId: camel.builderSandboxId ?? null,
     error: raw.error ?? null,
     result,
     operationDeadlineMs: camel.operationDeadlineMs ?? null,
     createdAtMs: camel.createdAtMs ?? null,
-    updatedAtMs: camel.updatedAtMs ?? null,
-    raw
-  };
+    updatedAtMs: camel.updatedAtMs ?? null
+  }, raw);
 }
 async function __runWithInterrupt(signal, run) {
   const binding = __imageBuildInternals.loadNativeBinding();
@@ -397,16 +440,68 @@ async function __runWithInterrupt(signal, run) {
     binding.releaseImageBuildInterrupt(interruptId);
   }
 }
-var import_node_path2, import_node_os, import_node_fs, ImageBuildError, ImageBuildNotFoundError, ImageBuildInProgressError, ImageBuildFailedError, ImageBuildCancelledError, ImageBuildTimeoutError, ImageBuildInterruptedError;
+var import_node_path2, import_node_os, import_node_fs, ImageBuildStatus, ImageBuildPhase, ImageBuildKind, ImageBuildCancellationOutcome, ImageBuildErrorCode, ImageBuildError, ImageBuildNotFoundError, ImageBuildInProgressError, ImageBuildFailedError, ImageBuildCancelledError, ImageBuildTimeoutError, ImageBuildInterruptedError;
 var init_image_builds = __esm({
   "src/image-builds.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_path2 = __toESM(require("path"), 1);
+    init_enum();
     import_node_os = __toESM(require("os"), 1);
     import_node_fs = require("fs");
     init_image();
     init_sandbox_image();
+    ImageBuildStatus = /* @__PURE__ */ ((ImageBuildStatus2) => {
+      ImageBuildStatus2["PENDING"] = "pending";
+      ImageBuildStatus2["RUNNING"] = "running";
+      ImageBuildStatus2["SUCCEEDED"] = "succeeded";
+      ImageBuildStatus2["FAILED"] = "failed";
+      ImageBuildStatus2["CANCELLED"] = "cancelled";
+      ImageBuildStatus2["UNKNOWN"] = "unknown";
+      return ImageBuildStatus2;
+    })(ImageBuildStatus || {});
+    ImageBuildPhase = /* @__PURE__ */ ((ImageBuildPhase2) => {
+      ImageBuildPhase2["AWAITING_CONTEXT"] = "awaiting_context";
+      ImageBuildPhase2["STARTING_BUILDER"] = "starting_builder";
+      ImageBuildPhase2["EXECUTING"] = "executing";
+      ImageBuildPhase2["SNAPSHOTTING"] = "snapshotting";
+      ImageBuildPhase2["PUBLISHING"] = "publishing";
+      ImageBuildPhase2["FINISHED"] = "finished";
+      ImageBuildPhase2["UNKNOWN"] = "unknown";
+      return ImageBuildPhase2;
+    })(ImageBuildPhase || {});
+    ImageBuildKind = /* @__PURE__ */ ((ImageBuildKind2) => {
+      ImageBuildKind2["DOCKERFILE"] = "dockerfile";
+      ImageBuildKind2["IMPORT"] = "import";
+      ImageBuildKind2["DIRECT"] = "direct";
+      ImageBuildKind2["UNKNOWN"] = "unknown";
+      return ImageBuildKind2;
+    })(ImageBuildKind || {});
+    ImageBuildCancellationOutcome = /* @__PURE__ */ ((ImageBuildCancellationOutcome2) => {
+      ImageBuildCancellationOutcome2["CANCELLED"] = "cancelled";
+      ImageBuildCancellationOutcome2["ALREADY_CANCELLED"] = "already_cancelled";
+      ImageBuildCancellationOutcome2["ALREADY_COMPLETED"] = "already_completed";
+      ImageBuildCancellationOutcome2["ALREADY_FAILED"] = "already_failed";
+      ImageBuildCancellationOutcome2["NOT_ADMITTED"] = "not_admitted";
+      ImageBuildCancellationOutcome2["UNCONFIRMED"] = "unconfirmed";
+      ImageBuildCancellationOutcome2["UNKNOWN"] = "unknown";
+      return ImageBuildCancellationOutcome2;
+    })(ImageBuildCancellationOutcome || {});
+    ImageBuildErrorCode = /* @__PURE__ */ ((ImageBuildErrorCode2) => {
+      ImageBuildErrorCode2["USAGE"] = "usage";
+      ImageBuildErrorCode2["AUTH"] = "auth";
+      ImageBuildErrorCode2["NOT_FOUND"] = "not_found";
+      ImageBuildErrorCode2["IMAGE_BUILD_IN_PROGRESS"] = "image_build_in_progress";
+      ImageBuildErrorCode2["CLIENT_REQUEST_ID_MISMATCH"] = "client_request_id_mismatch";
+      ImageBuildErrorCode2["FAILED"] = "failed";
+      ImageBuildErrorCode2["CANCELLED"] = "cancelled";
+      ImageBuildErrorCode2["TIMEOUT"] = "timeout";
+      ImageBuildErrorCode2["INTERRUPTED"] = "interrupted";
+      ImageBuildErrorCode2["SERVICE"] = "service";
+      ImageBuildErrorCode2["INTERNAL"] = "internal";
+      ImageBuildErrorCode2["UNKNOWN"] = "unknown";
+      return ImageBuildErrorCode2;
+    })(ImageBuildErrorCode || {});
     ImageBuildError = class extends Error {
       code;
       buildId;
@@ -416,7 +511,11 @@ var init_image_builds = __esm({
         super(details.message);
         this.name = "ImageBuildError";
         this.code = details.code;
-        this.details = details;
+        this.details = { ...details };
+        withRaw(this, {});
+        if ("confirmed" in details) {
+          this.details.confirmed = details.confirmed === true && isConfirmedCancellation(details.outcome);
+        }
         if (details.buildId) this.buildId = details.buildId;
         if (details.clientRequestId) this.clientRequestId = details.clientRequestId;
       }
@@ -448,7 +547,7 @@ var init_image_builds = __esm({
         super(details);
         this.name = "ImageBuildFailedError";
         this.error = details.error ?? "no error recorded";
-        if (details.info) this.info = parseBuildInfo(details.info);
+        if (details.info) this.info = details.info;
       }
     };
     ImageBuildCancelledError = class extends ImageBuildError {
@@ -456,7 +555,7 @@ var init_image_builds = __esm({
       constructor(details) {
         super(details);
         this.name = "ImageBuildCancelledError";
-        if (details.info) this.info = parseBuildInfo(details.info);
+        if (details.info) this.info = details.info;
       }
     };
     ImageBuildTimeoutError = class extends ImageBuildError {
@@ -472,8 +571,8 @@ var init_image_builds = __esm({
       constructor(details) {
         super(details);
         this.name = "ImageBuildInterruptedError";
-        this.outcome = details.outcome ?? "unconfirmed";
-        this.confirmed = details.confirmed === true;
+        this.outcome = details.outcome ?? "unconfirmed" /* UNCONFIRMED */;
+        this.confirmed = this.details.confirmed === true;
         if (details.result) this.result = details.result;
       }
     };
@@ -533,16 +632,58 @@ function defaultRegisteredName(dockerfilePath) {
   const parsed = import_node_path3.default.parse(dockerfilePath);
   if (parsed.name.toLowerCase() === "dockerfile") {
     const parentName = import_node_path3.default.basename(import_node_path3.default.dirname(dockerfilePath)).trim();
-    return parentName || "sandbox-image";
+    return parentName || DEFAULT_SANDBOX_IMAGE_NAME;
   }
-  return parsed.name || "sandbox-image";
+  return parsed.name || DEFAULT_SANDBOX_IMAGE_NAME;
+}
+function registeredImageName(explicit, generated, cas, fallback = DEFAULT_SANDBOX_IMAGE_NAME) {
+  if (explicit || generated === void 0) {
+    const name = explicit ?? "";
+    return cas ? canonicalCasImageName(name) : name;
+  }
+  return cas ? casImageNameFrom(generated, fallback) : generated;
+}
+function canonicalCasImageName(name) {
+  return name.replace(/[A-Z]/g, (c) => c.toLowerCase());
+}
+function casImageNameFrom(raw, fallback) {
+  const lowered = canonicalCasImageName(raw);
+  if (isAddressableCasImageName(lowered)) {
+    return lowered;
+  }
+  let name = "";
+  for (const original of lowered) {
+    const ch = /^[a-z0-9._-]$/.test(original) ? original : "-";
+    const previous = name[name.length - 1];
+    if (CAS_NAME_SEPARATORS.includes(ch) && previous !== void 0 && CAS_NAME_SEPARATORS.includes(previous)) {
+      continue;
+    }
+    name += ch;
+  }
+  name = name.replace(/^[._-]+|[._-]+$/g, "").slice(0, MAX_CAS_IMAGE_NAME_LENGTH).replace(/[._-]+$/, "");
+  return isAddressableCasImageName(name) ? name : fallback;
+}
+function isAddressableCasImageName(name) {
+  if (name.length === 0 || name.length > MAX_CAS_IMAGE_NAME_LENGTH || RESERVED_IMAGE_NAME_PREFIXES.some((prefix) => name.startsWith(prefix)) || /^[0-9a-f]{64}$/.test(name)) {
+    return false;
+  }
+  const colon = name.indexOf(":");
+  const repository = colon === -1 ? name : name.slice(0, colon);
+  if (!repository.split("/").every((component) => /^[a-z0-9]+(?:[._-][a-z0-9]+)*$/.test(component))) {
+    return false;
+  }
+  if (colon === -1) {
+    return true;
+  }
+  const tag = name.slice(colon + 1);
+  return tag.length > 0 && tag.length <= 128 && /^[a-z0-9._-]+$/.test(tag) && !tag.startsWith(".") && !tag.startsWith("-");
 }
 function defaultRegisteredNameFromImage(imageReference) {
   const withoutDigest = imageReference.split("@", 1)[0] ?? imageReference;
   const lastSegment = withoutDigest.split("/").pop() ?? withoutDigest;
   const colonIndex = lastSegment.lastIndexOf(":");
   const name = colonIndex > 0 && colonIndex < lastSegment.length - 1 ? lastSegment.slice(0, colonIndex) : lastSegment;
-  return name || "imported-image";
+  return name || DEFAULT_IMPORTED_IMAGE_NAME;
 }
 function noopEmit(_event) {
 }
@@ -645,7 +786,11 @@ async function createSandboxImage(source, options = {}, deps = {}) {
     if (!text.endsWith("\n")) text += "\n";
     dockerfileText = text;
     nativeContextDir = resolvedContext;
-    effectiveName = options.registeredName ?? source.name;
+    effectiveName = registeredImageName(
+      options.registeredName ?? source.name,
+      void 0,
+      options.cas ?? true
+    );
   } else if (typeof source === "string") {
     const resolvedPath = import_node_path3.default.resolve(source);
     if (!(0, import_node_fs2.existsSync)(resolvedPath)) {
@@ -654,7 +799,11 @@ async function createSandboxImage(source, options = {}, deps = {}) {
     dockerfilePath = resolvedPath;
     dockerfileText = void 0;
     nativeContextDir = void 0;
-    effectiveName = options.registeredName ?? defaultRegisteredName(resolvedPath);
+    effectiveName = registeredImageName(
+      options.registeredName,
+      defaultRegisteredName(resolvedPath),
+      options.cas ?? true
+    );
   } else {
     throw new TypeError(
       `source must be an Image or a Dockerfile path, got ${typeof source}`
@@ -678,12 +827,16 @@ async function createSandboxImage(source, options = {}, deps = {}) {
         deps._allowPat ? "Missing TENSORLAKE_API_KEY or TENSORLAKE_PAT credentials." : "Missing TENSORLAKE_API_KEY credentials."
       );
     }
-    if (options.signal !== void 0 && !options.cas) {
+    const cas = options.cas ?? true;
+    if (options.signal !== void 0 && !cas) {
       throw new Error(
-        "signal is only supported for CAS image builds (cas: true); a legacy build has no Image Service build operation to cancel"
+        "signal is not supported for legacy image builds (cas: false): a legacy image build has no build operation to cancel"
       );
     }
-    emit({ type: "status", message: `Building image '${effectiveName}'...` });
+    emit({
+      type: "status",
+      message: `Building ${cas ? "CAS" : "legacy"} image '${effectiveName}'...`
+    });
     const binding = loadNativeBinding();
     let emitError;
     const nativeOptions = {
@@ -705,7 +858,7 @@ async function createSandboxImage(source, options = {}, deps = {}) {
       dockerConfigJson: options.dockerConfigJson,
       dockerfileText,
       contextDir: nativeContextDir,
-      cas: options.cas ?? false,
+      cas,
       buildArgs: options.buildArgs
     };
     const forward = (event) => {
@@ -715,7 +868,7 @@ async function createSandboxImage(source, options = {}, deps = {}) {
         emitError ??= error;
       }
     };
-    const resultJson = options.cas ? await __runWithInterrupt(
+    const resultJson = cas ? await __runWithInterrupt(
       options.signal,
       (interruptId) => binding.buildSandboxImage(nativeOptions, forward, interruptId)
     ) : await binding.buildSandboxImage(nativeOptions, forward);
@@ -746,7 +899,12 @@ async function importSandboxImage(imageReference, options = {}, deps = {}) {
   }
   const reference = imageReference.trim();
   const context = buildContextFromEnv();
-  const effectiveName = options.registeredName ?? defaultRegisteredNameFromImage(reference);
+  const effectiveName = registeredImageName(
+    options.registeredName,
+    defaultRegisteredNameFromImage(reference),
+    options.cas ?? true,
+    DEFAULT_IMPORTED_IMAGE_NAME
+  );
   if (effectiveName === DEFAULT_IMAGE_NAME2) {
     console.warn(
       `Importing sandbox image with the default name "${DEFAULT_IMAGE_NAME2}". Pass \`registeredName\` to avoid collisions with other default-named images in this project.`
@@ -764,14 +922,15 @@ async function importSandboxImage(imageReference, options = {}, deps = {}) {
       deps._allowPat ? "Missing TENSORLAKE_API_KEY or TENSORLAKE_PAT credentials." : "Missing TENSORLAKE_API_KEY credentials."
     );
   }
-  if (options.signal !== void 0 && !options.cas) {
+  const cas = options.cas ?? true;
+  if (options.signal !== void 0 && !cas) {
     throw new Error(
-      "signal is only supported for CAS image imports (cas: true); a legacy import has no Image Service build operation to cancel"
+      "signal is not supported for legacy image imports (cas: false): a legacy image import has no build operation to cancel"
     );
   }
   emit({
     type: "status",
-    message: `Importing image '${reference}' as '${effectiveName}'...`
+    message: `Importing '${reference}' as ${cas ? "CAS" : "legacy"} image '${effectiveName}'...`
   });
   const binding = loadNativeBinding();
   let emitError;
@@ -792,7 +951,7 @@ async function importSandboxImage(imageReference, options = {}, deps = {}) {
     userAgent: void 0,
     dockerCompat: options.dockerCompat ?? false,
     dockerConfigJson: options.dockerConfigJson,
-    cas: options.cas ?? false
+    cas
   };
   const forward = (event) => {
     try {
@@ -801,7 +960,7 @@ async function importSandboxImage(imageReference, options = {}, deps = {}) {
       emitError ??= error;
     }
   };
-  const resultJson = options.cas ? await __runWithInterrupt(
+  const resultJson = cas ? await __runWithInterrupt(
     options.signal,
     (interruptId) => binding.importSandboxImage(nativeOptions, forward, interruptId)
   ) : await binding.importSandboxImage(nativeOptions, forward);
@@ -858,15 +1017,29 @@ async function deleteSandboxImage(imageName) {
   if (typeof imageName !== "string" || imageName.length === 0) {
     throw new TypeError("imageName must be a non-empty string");
   }
-  await loadNativeBinding().deleteSandboxImage(catalogOptionsFromEnv(), imageName);
+  warnIncompleteLegacyCleanup(
+    await loadNativeBinding().deleteSandboxImage(catalogOptionsFromEnv(), imageName)
+  );
 }
 async function deleteSandboxImageWithCredentials(credentials, imageName) {
   if (typeof imageName !== "string" || imageName.length === 0) {
     throw new TypeError("imageName must be a non-empty string");
   }
-  await loadNativeBinding().deleteSandboxImage(
-    catalogOptionsFromCredentials(credentials),
-    imageName
+  warnIncompleteLegacyCleanup(
+    await loadNativeBinding().deleteSandboxImage(
+      catalogOptionsFromCredentials(credentials),
+      imageName
+    )
+  );
+}
+function warnIncompleteLegacyCleanup(failure) {
+  if (failure == null) {
+    return;
+  }
+  const legacyImageId = failure.legacyImageId ?? void 0;
+  const label = legacyImageId ? ` (${legacyImageId})` : "";
+  console.warn(
+    `Deleted CAS image '${failure.legacyImageName}', but could not delete the legacy image of the same name${label}, which can no longer start sandboxes: ${failure.error}. Delete it with deleteSandboxImage("${legacyImageId ?? failure.legacyImageName}").`
   );
 }
 async function findSandboxImageByName(imageName) {
@@ -910,13 +1083,14 @@ async function runCreateSandboxImageCli(argv = process.argv.slice(2)) {
       disk_mb: { type: "string" },
       builder_disk_mb: { type: "string" },
       docker_compat: { type: "boolean", default: false },
-      public: { type: "boolean", default: false }
+      public: { type: "boolean", default: false },
+      "no-cas": { type: "boolean", default: false }
     }
   });
   const dockerfilePath = parsed.positionals[0];
   if (!dockerfilePath) {
     throw new Error(
-      "Usage: tensorlake-create-sandbox-image <dockerfile_path> [--name NAME] [--cpus N] [--memory MiB] [--disk_mb MiB] [--builder_disk_mb MiB] [--docker_compat] [--public]"
+      "Usage: tensorlake-create-sandbox-image <dockerfile_path> [--name NAME] [--cpus N] [--memory MiB] [--disk_mb MiB] [--builder_disk_mb MiB] [--docker_compat] [--public] [--no-cas]"
     );
   }
   const cpus = parsed.values.cpus != null ? Number(parsed.values.cpus) : void 0;
@@ -948,7 +1122,8 @@ async function runCreateSandboxImageCli(argv = process.argv.slice(2)) {
       diskMb,
       builderDiskMb,
       dockerCompat: parsed.values.docker_compat,
-      isPublic: parsed.values.public
+      isPublic: parsed.values.public,
+      cas: !parsed.values["no-cas"]
     },
     { emit: ndjsonStdoutEmit, _allowPat: true }
   );
@@ -964,13 +1139,14 @@ async function runImportSandboxImageCli(argv = process.argv.slice(2)) {
       disk_mb: { type: "string" },
       builder_disk_mb: { type: "string" },
       docker_compat: { type: "boolean", default: false },
-      public: { type: "boolean", default: false }
+      public: { type: "boolean", default: false },
+      "no-cas": { type: "boolean", default: false }
     }
   });
   const imageReference = parsed.positionals[0];
   if (!imageReference) {
     throw new Error(
-      "Usage: tensorlake-import-sandbox-image <image_reference> [--name NAME] [--cpus N] [--memory MiB] [--disk_mb MiB] [--builder_disk_mb MiB] [--docker_compat] [--public]"
+      "Usage: tensorlake-import-sandbox-image <image_reference> [--name NAME] [--cpus N] [--memory MiB] [--disk_mb MiB] [--builder_disk_mb MiB] [--docker_compat] [--public] [--no-cas]"
     );
   }
   const cpus = parsed.values.cpus != null ? Number(parsed.values.cpus) : void 0;
@@ -1002,12 +1178,13 @@ async function runImportSandboxImageCli(argv = process.argv.slice(2)) {
       diskMb,
       builderDiskMb,
       dockerCompat: parsed.values.docker_compat,
-      isPublic: parsed.values.public
+      isPublic: parsed.values.public,
+      cas: !parsed.values["no-cas"]
     },
     { emit: ndjsonStdoutEmit, _allowPat: true }
   );
 }
-var import_node_path3, import_node_os2, import_node_fs2, import_node_util, cachedNativeBinding, cachedNativeBindingError, DEFAULT_IMAGE_NAME2, __imageBuildInternals;
+var import_node_path3, import_node_os2, import_node_fs2, import_node_util, cachedNativeBinding, cachedNativeBindingError, DEFAULT_IMAGE_NAME2, DEFAULT_SANDBOX_IMAGE_NAME, DEFAULT_IMPORTED_IMAGE_NAME, CAS_NAME_SEPARATORS, RESERVED_IMAGE_NAME_PREFIXES, MAX_CAS_IMAGE_NAME_LENGTH, __imageBuildInternals;
 var init_sandbox_image = __esm({
   "src/sandbox-image.ts"() {
     init_cjs_shims();
@@ -1019,6 +1196,11 @@ var init_sandbox_image = __esm({
     init_native_binding();
     init_image_builds();
     DEFAULT_IMAGE_NAME2 = "default";
+    DEFAULT_SANDBOX_IMAGE_NAME = "sandbox-image";
+    DEFAULT_IMPORTED_IMAGE_NAME = "imported-image";
+    CAS_NAME_SEPARATORS = "._-";
+    RESERVED_IMAGE_NAME_PREFIXES = ["sandbox_template_", "image_", "cas-v1:"];
+    MAX_CAS_IMAGE_NAME_LENGTH = 255;
     __imageBuildInternals = {
       loadNativeBinding: () => loadNativeBinding(),
       buildContextFromEnv: () => buildContextFromEnv(),
@@ -1027,7 +1209,12 @@ var init_sandbox_image = __esm({
       eventToEmitDict: (event) => eventToEmitDict(event),
       imageRequiresContext: (image) => imageRequiresContext(image),
       defaultRegisteredName: (dockerfilePath) => defaultRegisteredName(dockerfilePath),
-      defaultRegisteredNameFromImage: (reference) => defaultRegisteredNameFromImage(reference)
+      defaultRegisteredNameFromImage: (reference) => defaultRegisteredNameFromImage(reference),
+      registeredImageName: (explicit, generated, cas, fallback) => registeredImageName(explicit, generated, cas, fallback),
+      casImageNameFrom: (raw, fallback) => casImageNameFrom(raw, fallback),
+      canonicalCasImageName: (name) => canonicalCasImageName(name),
+      isAddressableCasImageName: (name) => isAddressableCasImageName(name),
+      defaultImportedImageName: DEFAULT_IMPORTED_IMAGE_NAME
     };
   }
 });