@tensorlakeai/tensorlake 0.5.153 → 0.5.156

package/dist/{remote-B3vn4tt1.d.cts → remote-CEs4GFGP.d.cts}

@@ -1,4 +1,4 @@
-import { C as CloudClientOptions, A as ApplicationManifest, F as FileSystem, a as ApplicationSummary, R as RequestInput, b as RequestOutput, I as Image } from './sandbox-image-BMiFlzAs.cjs';
+import { C as CloudClientOptions, A as ApplicationManifest, F as FileSystem, a as ApplicationSummary, R as RequestInput, b as RequestOutput, I as Image } from './sandbox-image-C2GTVnx3.cjs';
 
 declare class APIClient {
     private readonly cloudClient;

package/dist/{remote-DqBUuciu.d.ts → remote-DYBXCTNC.d.ts}

@@ -1,4 +1,4 @@
-import { C as CloudClientOptions, A as ApplicationManifest, F as FileSystem, a as ApplicationSummary, R as RequestInput, b as RequestOutput, I as Image } from './sandbox-image-BMiFlzAs.js';
+import { C as CloudClientOptions, A as ApplicationManifest, F as FileSystem, a as ApplicationSummary, R as RequestInput, b as RequestOutput, I as Image } from './sandbox-image-C2GTVnx3.js';
 
 declare class APIClient {
     private readonly cloudClient;

package/dist/{sandbox-image-BMiFlzAs.d.cts → sandbox-image-C2GTVnx3.d.cts}

@@ -137,12 +137,12 @@ interface ApplicationBuildResponse {
     imageBuilds: ApplicationBuildImageResult[];
 }
 /**
- * A registered sandbox image in the platform template shape. Both image
- * families answer it: legacy templates verbatim from the platform API, and
- * CAS images (`snapshotFormatVersion === "content_addressed_streaming_v1"`)
- * derived by the core from the Image Service's trimmed record (id, name,
- * snapshot id, visibility, sizes, timestamps); no content digest or build
- * provenance rides on either.
+ * A registered CAS or legacy sandbox image in the sandbox-template shape.
+ * Both image families answer it: legacy images verbatim from the legacy image
+ * registry, and CAS images (`snapshotFormatVersion ===
+ * "content_addressed_streaming_v1"`) derived by the core from the CAS image
+ * registry's trimmed record (id, name, snapshot id, visibility, sizes,
+ * timestamps); no content digest or build provenance rides on either.
  */
 interface SandboxTemplate {
     id?: string;
@@ -208,10 +208,11 @@ declare class Image {
     run(commands: string | string[], options?: Record<string, string> | undefined): this;
     workdir(directory: string): this;
     /**
-     * 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.
      */
     build(options?: CreateSandboxImageOptions): Promise<Record<string, unknown>>;
     private _addOperation;
@@ -235,6 +236,14 @@ interface CreateSandboxImageOptions {
      * Pass "{}" to disable discovery and use no registry credentials.
      */
     dockerConfigJson?: string;
+    /**
+     * Name to register the image under. Defaults to the image's `name` or the
+     * Dockerfile stem (the parent directory's name for a file named
+     * `Dockerfile`).
+     * A CAS image name is lowercased, as the CAS image registry stores it; a
+     * default CAS image name is also made valid (other characters become `-`).
+     * Legacy image names are kept as given.
+     */
     registeredName?: string;
     cpus?: number;
     memoryMb?: number;
@@ -257,22 +266,22 @@ interface CreateSandboxImageOptions {
      */
     dockerCompat?: boolean;
     /**
-     * Build a CAS (content-addressed streaming) image through the Image
-     * Service instead of a legacy template. Off by default.
+     * Build a CAS (content-addressed streaming) image, the default. Pass
+     * `false` to build a legacy image instead.
      */
     cas?: boolean;
     /**
      * Dockerfile build args (`--build-arg KEY=VALUE`), forwarded to BuildKit
-     * and expanded in `FROM` references. CAS builds only; a legacy build with
-     * build args is rejected.
+     * and expanded in `FROM` references. CAS images only; a legacy image build
+     * with build args is rejected.
      */
     buildArgs?: Record<string, string>;
     /**
-     * CAS builds only (`cas: true`): aborting requests *remote cancellation*
-     * of the Image Service build through a bounded handshake, and the call
-     * rejects with `ImageBuildInterruptedError` carrying the outcome. It is
-     * rejected for legacy builds, which have no build operation to cancel.
-     * Abandoning the promise alone never cancels anything.
+     * CAS images only: aborting requests *remote cancellation* of the CAS
+     * image build through a bounded handshake, and the call rejects with
+     * `ImageBuildInterruptedError` carrying the outcome. It is rejected for a
+     * legacy image build (`cas: false`), which has no build operation to
+     * cancel. Abandoning the promise alone never cancels anything.
      */
     signal?: AbortSignal;
     /**
@@ -293,6 +302,9 @@ interface ImportSandboxImageOptions {
      * Name to register the image under. Defaults to the image reference's last
      * path segment with any tag/digest stripped (e.g. `pytorch/pytorch:2.4.1`
      * -> `pytorch`).
+     * A CAS image name is lowercased, as the CAS image registry stores it; a
+     * default CAS image name is also made valid (other characters become `-`).
+     * Legacy image names are kept as given.
      */
     registeredName?: string;
     cpus?: number;
@@ -306,13 +318,13 @@ interface ImportSandboxImageOptions {
      */
     dockerCompat?: boolean;
     /**
-     * Import as a CAS (content-addressed streaming) image through the Image
-     * Service instead of a legacy template. Off by default.
+     * Import as a CAS (content-addressed streaming) image, the default. Pass
+     * `false` to import a legacy image instead.
      */
     cas?: boolean;
     /**
-     * CAS imports only (`cas: true`): aborting requests remote cancellation of
-     * the Image Service import; see `CreateSandboxImageOptions.signal`.
+     * CAS images only: aborting requests remote cancellation of the CAS image
+     * import; see `CreateSandboxImageOptions.signal`.
      */
     signal?: AbortSignal;
     /**
@@ -415,8 +427,12 @@ interface NativeBinding {
     listSandboxImages(options: NativeBindingCatalogOptions): Promise<string>;
     /** JSON record of one image by name or id, or null when unknown. */
     findSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<string | null>;
-    /** Delete one image by name or id; unknown in both catalogs rejects. */
-    deleteSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<void>;
+    /**
+     * Delete one image by name or id; a name is deleted from both catalogs.
+     * Unknown in both catalogs rejects. Resolves to the same-named legacy
+     * image a name's CAS delete could not remove, or null.
+     */
+    deleteSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<NativeLegacyCleanupFailure | null | undefined>;
 }
 /** Test seam: replace the native binding with a stub. */
 declare function __setNativeBindingForTest(binding: NativeBinding | undefined): void;
@@ -431,9 +447,9 @@ interface BuildContext {
 }
 declare function buildContextFromEnv(): BuildContext;
 /**
- * @internal Shared with `image-builds.ts`, which implements the Image
- * Service build operations on top of the same native binding and
- * environment context.
+ * @internal Shared with `image-builds.ts`, which implements the CAS image
+ * build operations on top of the same native binding and environment
+ * context.
  */
 declare const __imageBuildInternals: {
     loadNativeBinding: () => NativeBinding;
@@ -444,6 +460,11 @@ declare const __imageBuildInternals: {
     imageRequiresContext: (image: Image) => boolean;
     defaultRegisteredName: (dockerfilePath: string) => string;
     defaultRegisteredNameFromImage: (reference: string) => string;
+    registeredImageName: (explicit: string | undefined, generated: string | undefined, cas: boolean, fallback?: string) => string;
+    casImageNameFrom: (raw: string, fallback: string) => string;
+    canonicalCasImageName: (name: string) => string;
+    isAddressableCasImageName: (name: string) => boolean;
+    defaultImportedImageName: string;
 };
 declare function createSandboxImage(source: SandboxImageSource, options?: CreateSandboxImageOptions, deps?: CreateSandboxImageDeps): Promise<Record<string, unknown>>;
 /**
@@ -466,47 +487,73 @@ interface SandboxImageCatalogCredentials {
     projectId?: string;
 }
 /**
- * Delete a registered sandbox image by name or id. Both families are
- * covered: an `image_` id or a name registered in the Image Service deletes
- * a CAS image, a `sandbox_template_` id or a name registered only in the
- * platform registry deletes a legacy image. Rejects when neither catalog
- * knows the reference.
+ * Delete a registered CAS or legacy sandbox image by name or id. Both
+ * families are covered: an `image_` id or a name registered in the CAS image
+ * registry deletes a CAS image, a `sandbox_template_` id or a name registered
+ * only in the legacy image registry deletes a legacy image. Rejects when
+ * neither the CAS nor the legacy image registry knows the reference.
+ *
+ * A name is deleted from both the CAS and the legacy image registries: once
+ * its CAS image is deleted, a legacy image of the same name can no longer
+ * start sandboxes, so it is deleted too. CAS image names ignore case
+ * (`MyProject` deletes the CAS image `myproject`), legacy image names match
+ * exactly. Failing to delete that legacy image
+ * does not reject, since the CAS image is already gone: a `console.warn`
+ * names the legacy image, the error and the call that deletes it. An
+ * `image_` or `sandbox_template_` id deletes only the image it names.
  *
- * Deleting removes a *published* image. An unfinished CAS build is cancelled
- * with `cancelImageBuild({ buildId })` (or `tl sbx image build cancel
- * BUILD_ID`), never by deleting its name: a name whose only state is an
- * unfinished first build has no image, so the Image Service answers 404 and
- * the lookup falls through to the platform registry as usual. A 202
- * (deletion in progress) counts as success; a 409 `image_build_in_progress`,
- * a 5xx or a transport failure rejects as is and never falls through.
+ * Deleting removes a *published* image. An unfinished CAS image build is
+ * cancelled with `cancelImageBuild({ buildId })` (or `tl sbx image build
+ * cancel BUILD_ID`), never by deleting its name: a name whose only state is
+ * an unfinished first build has no CAS image, so the CAS image registry
+ * answers 404 and the lookup falls through to the legacy image registry as
+ * usual. A 202 (deletion in progress) counts as success; a 409
+ * `image_build_in_progress`, a 5xx or a transport failure rejects as is and
+ * never falls through.
  *
  * Accepted merged-catalog differences from the released SDKs, for legacy
- * images: this deletes the platform-api template itself (the released SDKs
- * only removed the engine registration and left the template listed), and
- * an unknown name rejects instead of succeeding silently.
+ * images: this removes the legacy image from the legacy image registry (the
+ * released SDKs only made it unusable and left it listed), and an unknown
+ * name rejects instead of succeeding silently.
  */
 declare function deleteSandboxImage(imageName: string): Promise<void>;
 /** @internal `APIClient.deleteSandboxImage` with the client's credentials. */
 declare function deleteSandboxImageWithCredentials(credentials: SandboxImageCatalogCredentials, imageName: string): Promise<void>;
 /**
- * Look up a registered sandbox image by its registered name or id.
+ * The same-named legacy image a name's CAS delete could not remove. Its name
+ * is the deleted CAS image's name, in the CAS image registry's lowercase
+ * spelling.
+ */
+interface NativeLegacyCleanupFailure {
+    legacyImageName: string;
+    legacyImageId?: string | null;
+    error: string;
+}
+/**
+ * Look up a registered CAS or legacy sandbox image by its registered name or
+ * id.
  *
  * Returns the image in the sandbox-template shape (CAS images carry
  * `snapshotFormatVersion === "content_addressed_streaming_v1"`; the shape is
- * derived from the Image Service's trimmed record, so no content digest or
- * build provenance rides on it), or `null` if neither the Image Service nor
- * the platform registry knows the reference. Uses the same environment-based Tensorlake
- * auth as `createSandboxImage`. Ingress derives project scope from the API key.
+ * derived from the CAS image registry's trimmed record, so no content digest
+ * or build provenance rides on it), or `null` if neither the CAS nor the
+ * legacy image registry knows the reference. Uses the same environment-based
+ * Tensorlake auth as `createSandboxImage`. Ingress derives project scope from
+ * the API key.
  *
- * An `image_` id names the *current* image under its name; a rebuild
+ * An `image_` id names the *current* CAS image under its name; a rebuild
  * replaces it. A build's own immutable result is read with `getImageBuild`.
  *
+ * A name is looked up in the CAS image registry in lowercase, as the
+ * registry stores it, and in the legacy image registry exactly as given.
+ *
  * Accepted merged-catalog difference from the released SDKs, for legacy
- * images: a name that fits the Image Service grammar is looked up there first
- * and only a clean 404 falls through to the platform registry, so Image
- * Service unavailability (or a deploy 5xx) rejects the lookup of a legacy name
- * where the released SDKs touched only platform-api. A `sandbox_template_` id
- * never consults the Image Service.
+ * images: a name that fits the CAS image registry's grammar is looked up
+ * there first and only a clean 404 falls through to the legacy image
+ * registry, so CAS image registry unavailability (or a deploy 5xx) rejects
+ * the lookup of a legacy image name where the released SDKs touched only the
+ * legacy image registry. A `sandbox_template_` id never consults the CAS
+ * image registry.
  */
 declare function findSandboxImageByName(imageName: string): Promise<SandboxTemplate | null>;
 /** @internal `CloudClient.findSandboxImageByName` with the client's credentials. */

package/dist/{sandbox-image-BMiFlzAs.d.ts → sandbox-image-C2GTVnx3.d.ts}

@@ -137,12 +137,12 @@ interface ApplicationBuildResponse {
     imageBuilds: ApplicationBuildImageResult[];
 }
 /**
- * A registered sandbox image in the platform template shape. Both image
- * families answer it: legacy templates verbatim from the platform API, and
- * CAS images (`snapshotFormatVersion === "content_addressed_streaming_v1"`)
- * derived by the core from the Image Service's trimmed record (id, name,
- * snapshot id, visibility, sizes, timestamps); no content digest or build
- * provenance rides on either.
+ * A registered CAS or legacy sandbox image in the sandbox-template shape.
+ * Both image families answer it: legacy images verbatim from the legacy image
+ * registry, and CAS images (`snapshotFormatVersion ===
+ * "content_addressed_streaming_v1"`) derived by the core from the CAS image
+ * registry's trimmed record (id, name, snapshot id, visibility, sizes,
+ * timestamps); no content digest or build provenance rides on either.
  */
 interface SandboxTemplate {
     id?: string;
@@ -208,10 +208,11 @@ declare class Image {
     run(commands: string | string[], options?: Record<string, string> | undefined): this;
     workdir(directory: string): this;
     /**
-     * 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.
      */
     build(options?: CreateSandboxImageOptions): Promise<Record<string, unknown>>;
     private _addOperation;
@@ -235,6 +236,14 @@ interface CreateSandboxImageOptions {
      * Pass "{}" to disable discovery and use no registry credentials.
      */
     dockerConfigJson?: string;
+    /**
+     * Name to register the image under. Defaults to the image's `name` or the
+     * Dockerfile stem (the parent directory's name for a file named
+     * `Dockerfile`).
+     * A CAS image name is lowercased, as the CAS image registry stores it; a
+     * default CAS image name is also made valid (other characters become `-`).
+     * Legacy image names are kept as given.
+     */
     registeredName?: string;
     cpus?: number;
     memoryMb?: number;
@@ -257,22 +266,22 @@ interface CreateSandboxImageOptions {
      */
     dockerCompat?: boolean;
     /**
-     * Build a CAS (content-addressed streaming) image through the Image
-     * Service instead of a legacy template. Off by default.
+     * Build a CAS (content-addressed streaming) image, the default. Pass
+     * `false` to build a legacy image instead.
      */
     cas?: boolean;
     /**
      * Dockerfile build args (`--build-arg KEY=VALUE`), forwarded to BuildKit
-     * and expanded in `FROM` references. CAS builds only; a legacy build with
-     * build args is rejected.
+     * and expanded in `FROM` references. CAS images only; a legacy image build
+     * with build args is rejected.
      */
     buildArgs?: Record<string, string>;
     /**
-     * CAS builds only (`cas: true`): aborting requests *remote cancellation*
-     * of the Image Service build through a bounded handshake, and the call
-     * rejects with `ImageBuildInterruptedError` carrying the outcome. It is
-     * rejected for legacy builds, which have no build operation to cancel.
-     * Abandoning the promise alone never cancels anything.
+     * CAS images only: aborting requests *remote cancellation* of the CAS
+     * image build through a bounded handshake, and the call rejects with
+     * `ImageBuildInterruptedError` carrying the outcome. It is rejected for a
+     * legacy image build (`cas: false`), which has no build operation to
+     * cancel. Abandoning the promise alone never cancels anything.
      */
     signal?: AbortSignal;
     /**
@@ -293,6 +302,9 @@ interface ImportSandboxImageOptions {
      * Name to register the image under. Defaults to the image reference's last
      * path segment with any tag/digest stripped (e.g. `pytorch/pytorch:2.4.1`
      * -> `pytorch`).
+     * A CAS image name is lowercased, as the CAS image registry stores it; a
+     * default CAS image name is also made valid (other characters become `-`).
+     * Legacy image names are kept as given.
      */
     registeredName?: string;
     cpus?: number;
@@ -306,13 +318,13 @@ interface ImportSandboxImageOptions {
      */
     dockerCompat?: boolean;
     /**
-     * Import as a CAS (content-addressed streaming) image through the Image
-     * Service instead of a legacy template. Off by default.
+     * Import as a CAS (content-addressed streaming) image, the default. Pass
+     * `false` to import a legacy image instead.
      */
     cas?: boolean;
     /**
-     * CAS imports only (`cas: true`): aborting requests remote cancellation of
-     * the Image Service import; see `CreateSandboxImageOptions.signal`.
+     * CAS images only: aborting requests remote cancellation of the CAS image
+     * import; see `CreateSandboxImageOptions.signal`.
      */
     signal?: AbortSignal;
     /**
@@ -415,8 +427,12 @@ interface NativeBinding {
     listSandboxImages(options: NativeBindingCatalogOptions): Promise<string>;
     /** JSON record of one image by name or id, or null when unknown. */
     findSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<string | null>;
-    /** Delete one image by name or id; unknown in both catalogs rejects. */
-    deleteSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<void>;
+    /**
+     * Delete one image by name or id; a name is deleted from both catalogs.
+     * Unknown in both catalogs rejects. Resolves to the same-named legacy
+     * image a name's CAS delete could not remove, or null.
+     */
+    deleteSandboxImage(options: NativeBindingCatalogOptions, reference: string): Promise<NativeLegacyCleanupFailure | null | undefined>;
 }
 /** Test seam: replace the native binding with a stub. */
 declare function __setNativeBindingForTest(binding: NativeBinding | undefined): void;
@@ -431,9 +447,9 @@ interface BuildContext {
 }
 declare function buildContextFromEnv(): BuildContext;
 /**
- * @internal Shared with `image-builds.ts`, which implements the Image
- * Service build operations on top of the same native binding and
- * environment context.
+ * @internal Shared with `image-builds.ts`, which implements the CAS image
+ * build operations on top of the same native binding and environment
+ * context.
  */
 declare const __imageBuildInternals: {
     loadNativeBinding: () => NativeBinding;
@@ -444,6 +460,11 @@ declare const __imageBuildInternals: {
     imageRequiresContext: (image: Image) => boolean;
     defaultRegisteredName: (dockerfilePath: string) => string;
     defaultRegisteredNameFromImage: (reference: string) => string;
+    registeredImageName: (explicit: string | undefined, generated: string | undefined, cas: boolean, fallback?: string) => string;
+    casImageNameFrom: (raw: string, fallback: string) => string;
+    canonicalCasImageName: (name: string) => string;
+    isAddressableCasImageName: (name: string) => boolean;
+    defaultImportedImageName: string;
 };
 declare function createSandboxImage(source: SandboxImageSource, options?: CreateSandboxImageOptions, deps?: CreateSandboxImageDeps): Promise<Record<string, unknown>>;
 /**
@@ -466,47 +487,73 @@ interface SandboxImageCatalogCredentials {
     projectId?: string;
 }
 /**
- * Delete a registered sandbox image by name or id. Both families are
- * covered: an `image_` id or a name registered in the Image Service deletes
- * a CAS image, a `sandbox_template_` id or a name registered only in the
- * platform registry deletes a legacy image. Rejects when neither catalog
- * knows the reference.
+ * Delete a registered CAS or legacy sandbox image by name or id. Both
+ * families are covered: an `image_` id or a name registered in the CAS image
+ * registry deletes a CAS image, a `sandbox_template_` id or a name registered
+ * only in the legacy image registry deletes a legacy image. Rejects when
+ * neither the CAS nor the legacy image registry knows the reference.
+ *
+ * A name is deleted from both the CAS and the legacy image registries: once
+ * its CAS image is deleted, a legacy image of the same name can no longer
+ * start sandboxes, so it is deleted too. CAS image names ignore case
+ * (`MyProject` deletes the CAS image `myproject`), legacy image names match
+ * exactly. Failing to delete that legacy image
+ * does not reject, since the CAS image is already gone: a `console.warn`
+ * names the legacy image, the error and the call that deletes it. An
+ * `image_` or `sandbox_template_` id deletes only the image it names.
  *
- * Deleting removes a *published* image. An unfinished CAS build is cancelled
- * with `cancelImageBuild({ buildId })` (or `tl sbx image build cancel
- * BUILD_ID`), never by deleting its name: a name whose only state is an
- * unfinished first build has no image, so the Image Service answers 404 and
- * the lookup falls through to the platform registry as usual. A 202
- * (deletion in progress) counts as success; a 409 `image_build_in_progress`,
- * a 5xx or a transport failure rejects as is and never falls through.
+ * Deleting removes a *published* image. An unfinished CAS image build is
+ * cancelled with `cancelImageBuild({ buildId })` (or `tl sbx image build
+ * cancel BUILD_ID`), never by deleting its name: a name whose only state is
+ * an unfinished first build has no CAS image, so the CAS image registry
+ * answers 404 and the lookup falls through to the legacy image registry as
+ * usual. A 202 (deletion in progress) counts as success; a 409
+ * `image_build_in_progress`, a 5xx or a transport failure rejects as is and
+ * never falls through.
  *
  * Accepted merged-catalog differences from the released SDKs, for legacy
- * images: this deletes the platform-api template itself (the released SDKs
- * only removed the engine registration and left the template listed), and
- * an unknown name rejects instead of succeeding silently.
+ * images: this removes the legacy image from the legacy image registry (the
+ * released SDKs only made it unusable and left it listed), and an unknown
+ * name rejects instead of succeeding silently.
  */
 declare function deleteSandboxImage(imageName: string): Promise<void>;
 /** @internal `APIClient.deleteSandboxImage` with the client's credentials. */
 declare function deleteSandboxImageWithCredentials(credentials: SandboxImageCatalogCredentials, imageName: string): Promise<void>;
 /**
- * Look up a registered sandbox image by its registered name or id.
+ * The same-named legacy image a name's CAS delete could not remove. Its name
+ * is the deleted CAS image's name, in the CAS image registry's lowercase
+ * spelling.
+ */
+interface NativeLegacyCleanupFailure {
+    legacyImageName: string;
+    legacyImageId?: string | null;
+    error: string;
+}
+/**
+ * Look up a registered CAS or legacy sandbox image by its registered name or
+ * id.
  *
  * Returns the image in the sandbox-template shape (CAS images carry
  * `snapshotFormatVersion === "content_addressed_streaming_v1"`; the shape is
- * derived from the Image Service's trimmed record, so no content digest or
- * build provenance rides on it), or `null` if neither the Image Service nor
- * the platform registry knows the reference. Uses the same environment-based Tensorlake
- * auth as `createSandboxImage`. Ingress derives project scope from the API key.
+ * derived from the CAS image registry's trimmed record, so no content digest
+ * or build provenance rides on it), or `null` if neither the CAS nor the
+ * legacy image registry knows the reference. Uses the same environment-based
+ * Tensorlake auth as `createSandboxImage`. Ingress derives project scope from
+ * the API key.
  *
- * An `image_` id names the *current* image under its name; a rebuild
+ * An `image_` id names the *current* CAS image under its name; a rebuild
  * replaces it. A build's own immutable result is read with `getImageBuild`.
  *
+ * A name is looked up in the CAS image registry in lowercase, as the
+ * registry stores it, and in the legacy image registry exactly as given.
+ *
  * Accepted merged-catalog difference from the released SDKs, for legacy
- * images: a name that fits the Image Service grammar is looked up there first
- * and only a clean 404 falls through to the platform registry, so Image
- * Service unavailability (or a deploy 5xx) rejects the lookup of a legacy name
- * where the released SDKs touched only platform-api. A `sandbox_template_` id
- * never consults the Image Service.
+ * images: a name that fits the CAS image registry's grammar is looked up
+ * there first and only a clean 404 falls through to the legacy image
+ * registry, so CAS image registry unavailability (or a deploy 5xx) rejects
+ * the lookup of a legacy image name where the released SDKs touched only the
+ * legacy image registry. A `sandbox_template_` id never consults the CAS
+ * image registry.
  */
 declare function findSandboxImageByName(imageName: string): Promise<SandboxTemplate | null>;
 /** @internal `CloudClient.findSandboxImageByName` with the client's credentials. */