run402-mcp 2.2.0 → 2.3.1

package/sdk/dist/namespaces/assets.types.d.ts

@@ -137,6 +137,27 @@ export interface BlobCdnEnvelope {
  * Tag emitters require the SHA-256 (only computed when uploaded with
  * `immutable: true`). On non-immutable uploads, calling them throws.
  */
+/**
+ * One image variant generated by the gateway (v1.49+) on `assets.put` for
+ * image MIMEs. Three sizes are produced (`thumb` 320w, `medium` 800w,
+ * `large` 1920w) plus a full-resolution `display_jpeg` for HEIC/HEIF
+ * sources. WebP-only in v1; AVIF is deferred (see `imgTagWithSrcSet`'s
+ * JSDoc for the `<picture>` type-precedence footgun).
+ */
+export interface AssetVariant {
+    /** Mutable URL of the variant (preferred-host form). */
+    url: string;
+    /** Content-addressed CDN URL of the variant. Recommended for HTML/CSS. */
+    cdn_url: string;
+    /** Pixel width of the variant in display orientation. */
+    width_px: number;
+    /** Pixel height of the variant in display orientation. */
+    height_px: number;
+    /** Encoded format of the variant. */
+    format: "webp" | "jpeg";
+    /** Hex SHA-256 of the variant bytes. */
+    sha256: string;
+}
 export interface AssetRef {
     key: string;
     size_bytes: number;
@@ -176,6 +197,42 @@ export interface AssetRef {
     /** CloudFront invalidation envelope. For immutable uploads `cdn.ready ===
      *  true` and no further action is needed. */
     cdn: BlobCdnEnvelope;
+    /** Display-oriented width (post-EXIF rotation) of the source image, in
+     *  pixels. Present only for image MIMEs against a v1.49+ gateway. */
+    width_px?: number;
+    /** Display-oriented height (post-EXIF rotation) of the source image, in
+     *  pixels. Present only for image MIMEs against a v1.49+ gateway. */
+    height_px?: number;
+    /** Blurhash string suitable for a low-quality image placeholder (LQIP).
+     *  Present only for image MIMEs against a v1.49+ gateway. */
+    blurhash?: string;
+    /** Variant spec version. v1 in the v1.49 gateway release. Future
+     *  spec-version bumps produce different variant bytes at different URLs. */
+    variant_spec_version?: string;
+    /** Browser-renderable URL for the source. For jpeg/png/webp/avif this
+     *  equals `cdn_url`. For HEIC/HEIF this points to a generated JPEG
+     *  display variant so apps render correctly without HEIC-aware code. */
+    display_url?: string;
+    /** Immutable (content-addressed) form of `display_url`. */
+    display_immutable_url?: string;
+    /** Generated variant set for image MIMEs ≥320×320. Sub-320 images skip
+     *  the WebP set (the source IS the thumbnail at that size). `display_jpeg`
+     *  is present only for HEIC/HEIF sources (full-resolution JPEG transcode). */
+    variants?: {
+        thumb?: AssetVariant;
+        medium?: AssetVariant;
+        large?: AssetVariant;
+        display_jpeg?: AssetVariant;
+    };
+    /** Convenience: `variants.thumb.cdn_url` if a thumb variant exists,
+     *  else `display_url` (acts as the thumbnail for sub-320 images). **Undefined
+     *  for non-image AssetRefs** — TypeScript narrows accordingly; see also
+     *  `imgTag()`. */
+    thumbUrl?: string;
+    /** Convenience: `display_url` falling back to `cdn_url` for images.
+     *  **Undefined for non-image AssetRefs** — TypeScript narrows accordingly;
+     *  see also `imgTag()`. */
+    displayUrl?: string;
     /**
      * Returns a ready-to-paste `<script>` tag with the content-addressed
      * URL + Subresource Integrity + `crossorigin`. The browser will refuse
@@ -234,8 +291,67 @@ export interface AssetRef {
      * @example
      *   asset.imgTag("Company logo")
      *   // → <img src="https://pr-abc.run402.com/_blob/logo-a1b2c3d4.png" alt="Company logo" loading="lazy" decoding="async">
+     *
+     * **v1.49+ HEIC handling:** when the source is HEIC/HEIF, the gateway sets
+     * `display_url` to a generated JPEG transcode of the source and `cdn_url`
+     * to the original HEIC bytes (which browsers can't render). `imgTag()`
+     * defaults `<img src>` to `display_url ?? cdn_url`, so HEIC uploads render
+     * correctly without HEIC-specific code in the caller. When the ref carries
+     * `width_px` and `height_px`, the emitter also adds `width`/`height`
+     * attributes to eliminate Cumulative Layout Shift. Non-image refs omit
+     * those attributes silently — `imgTag()` never throws on absence.
      */
     imgTag(alt?: string): string;
+    /**
+     * Returns a `<picture>` element with a responsive WebP `<source>` (three
+     * sizes: 320w / 800w / 1920w) and the gateway's `display_url` as the
+     * `<img>` fallback. Designed for hero images and any layout where the
+     * browser should pick the right resolution per viewport.
+     *
+     * **Both throw conditions fail loud — no silent fallbacks:**
+     *
+     * - **`opts.sizes` is required.** Without `sizes`, browsers conservatively
+     *   download the largest candidate in `srcset` (defeating the variant
+     *   set). The helper throws `LocalError` with a message that names the
+     *   issue and gives a copy-pasteable example.
+     * - **`variants` must be present.** This helper assumes the gateway
+     *   generated the three WebP variants (image source ≥320×320, encoded
+     *   successfully). On non-image refs, sub-320 images, or older gateway
+     *   responses without variants, the helper throws `LocalError` and tells
+     *   the caller to use `imgTag()` instead. Silent fallback would render a
+     *   broken layout (no srcset, no responsive benefit) with no diagnostic.
+     *
+     * **AVIF footgun — why no `<source type="image/avif">`:** `<picture>`
+     * browsers select sources by `type` precedence, not best size. A single
+     * AVIF source at 1920w would be picked for thumbnails by AVIF-capable
+     * browsers, defeating the variant set. AVIF support, if it returns, must
+     * land at all three sizes simultaneously OR via a separate `imgTagHero()`
+     * helper that opts in explicitly for above-the-fold heroes.
+     *
+     * @example
+     *   ref.imgTagWithSrcSet({
+     *     alt: "Hero",
+     *     sizes: "(max-width: 800px) 100vw, 1920px",
+     *   });
+     *   // → <picture>
+     *   //     <source type="image/webp"
+     *   //             srcset="<thumb-cdn-url> 320w, <medium-cdn-url> 800w, <large-cdn-url> 1920w"
+     *   //             sizes="(max-width: 800px) 100vw, 1920px">
+     *   //     <img src="<display_url>"
+     *   //          alt="Hero"
+     *   //          width="4032" height="3024"
+     *   //          loading="lazy"
+     *   //          decoding="async">
+     *   //   </picture>
+     */
+    imgTagWithSrcSet(opts: {
+        alt?: string;
+        /** REQUIRED. Browser `sizes` attribute (e.g. `"100vw"` or
+         *  `"(max-width: 800px) 100vw, 1920px"`). Throws when missing/empty. */
+        sizes: string;
+        /** Default `"lazy"`. Pass `"eager"` for above-the-fold heroes. */
+        loading?: "lazy" | "eager";
+    }): string;
 }
 /**
  * Return type of `client.blobs.put`. v1.45 widens this to AssetRef; the

package/sdk/dist/namespaces/assets.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.types.d.ts","sourceRoot":"","sources":["../../src/namespaces/assets.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assets.types.d.ts","sourceRoot":"","sources":["../../src/namespaces/assets.types.ts"],"names":[],"mappings":"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"}

package/sdk/dist/namespaces/deploy.d.ts

@@ -145,5 +145,10 @@ export interface ByteReader {
     (): Promise<Uint8Array>;
     label?: string;
     contentType?: string;
+    /** Which spec slice category registered this byte reader. Set by the
+     *  slice-tagged `remember` in `normalizeReleaseSpec` and surfaces on
+     *  `content.upload.*` events so callers can group telemetry by slice.
+     *  Cross-kind CAS dedup escalates the value to `"mixed"`. */
+    slice?: "release" | "asset" | "mixed";
 }
 //# sourceMappingURL=deploy.d.ts.map

package/sdk/dist/namespaces/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/namespaces/deploy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/namespaces/deploy.ts"],"names":[],"mappings":"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"}

package/sdk/dist/namespaces/deploy.js

@@ -362,8 +362,29 @@ function requireNonEmptyStringQueryOption(value, label, context) {
     return value;
 }
 // ─── Internal pipeline ───────────────────────────────────────────────────────
+/**
+ * Compute the sorted set of slice kinds the spec carried. Surfaces on
+ * `commit.phase` and `ready` events so agents can group per-phase
+ * telemetry by slice category. `assets` slice → `"asset"`; any of
+ * `database` / `functions` / `site` → `"release"`. Order is stable
+ * (release before asset).
+ */
+function deriveSliceKinds(spec) {
+    // Guard against non-object spec — the validate phase throws below
+    // (INVALID_SPEC), but this is called before validation in applyOnce so
+    // we must not blow up first.
+    if (!spec || typeof spec !== "object")
+        return [];
+    const set = new Set();
+    if (spec.database || spec.functions || spec.site)
+        set.add("release");
+    if (spec.assets)
+        set.add("asset");
+    return [...set].sort((a, b) => (a === "release" ? -1 : 1));
+}
 async function applyOnce(client, spec, opts, emit) {
     const allowWarningCodes = normalizeAllowWarningCodes(opts.allowWarningCodes);
+    const sliceKinds = deriveSliceKinds(spec);
     emit({ type: "plan.started" });
     const { plan, byteReaders } = await planInternal(client, spec, opts.idempotencyKey);
     emit({ type: "plan.diff", diff: plan.diff });
@@ -383,16 +404,79 @@ async function applyOnce(client, spec, opts, emit) {
         // event and resolve before we hit upload.
     }
     await uploadMissing(client, spec.project, plan.missing_content, byteReaders, emit);
-    emit({ type: "commit.phase", phase: "validate", status: "started" });
+    emit({
+        type: "commit.phase",
+        phase: "validate",
+        status: "started",
+        ...(sliceKinds.length > 0 ? { slice_kinds: sliceKinds } : {}),
+    });
     const { planId } = requirePersistedPlan(plan, "applying deploy");
     const commit = await commitInternal(client, planId, opts.idempotencyKey);
-    const result = await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project);
+    const result = await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
     // v1.48 unified-apply: thread the plan response's `asset_entries[]` back
     // into DeployResult.assets so callers reading `result.assets.byKey[key]`
     // get the gateway-authoritative `AssetRef` envelope (URLs, SRI, etag).
     // Release-only applies leave `result.assets` undefined.
     if (plan.asset_entries && plan.asset_entries.length > 0) {
         result.assets = buildAssetManifestFromPlanEntries(plan.asset_entries);
+        // v1.49 image-variant follow-up: variants are generated AT COMMIT TIME
+        // (parent gateway change Section 5 — `prepareStagedAssetVariants` runs
+        // before the activation txn opens). The plan that funded `result.assets`
+        // was built BEFORE commit, so its `asset_entries[].asset_ref` doesn't
+        // include the variant fields (the gateway only threads `image_data`
+        // through `buildAssetRefForPlan` for SHAs that ALREADY have variants
+        // in `internal.blob_image_variants`).
+        //
+        // For image puts, do a dry-run re-plan with the same spec. Bytes are
+        // now in CAS (the commit just landed) AND variant rows exist in the
+        // DB. The new plan response surfaces the variants. Dry-run keeps it
+        // cheap: no new plan_id or operation_id rows are created.
+        //
+        // Best-effort: a re-plan failure shouldn't fail the apply. The bytes
+        // are committed, the release is live, and the variant fields are
+        // strictly additive — leaving them empty when the recheck errors is
+        // worse than failing the apply.
+        const hasImagePut = spec.assets?.put?.some((entry) => {
+            const ct = ("content_type" in entry && typeof entry.content_type === "string")
+                ? entry.content_type
+                : "";
+            return ct.startsWith("image/");
+        });
+        if (hasImagePut) {
+            try {
+                const { plan: recheck } = await planInternal(client, spec, undefined, true);
+                if (recheck.asset_entries && recheck.asset_entries.length > 0) {
+                    for (const recheckEntry of recheck.asset_entries) {
+                        const existing = result.assets.byKey[recheckEntry.key];
+                        if (!existing)
+                            continue;
+                        const ref = recheckEntry.asset_ref;
+                        if (ref.width_px !== undefined)
+                            existing.width_px = ref.width_px;
+                        if (ref.height_px !== undefined)
+                            existing.height_px = ref.height_px;
+                        if (ref.blurhash !== undefined)
+                            existing.blurhash = ref.blurhash;
+                        if (ref.variant_spec_version !== undefined) {
+                            existing.variant_spec_version = ref.variant_spec_version;
+                        }
+                        if (ref.display_url !== undefined)
+                            existing.display_url = ref.display_url;
+                        if (ref.display_immutable_url !== undefined) {
+                            existing.display_immutable_url = ref.display_immutable_url;
+                        }
+                        if (ref.variants !== undefined)
+                            existing.variants = ref.variants;
+                    }
+                }
+            }
+            catch {
+                // Best-effort: leave variant fields unpopulated rather than
+                // failing a successful apply. Consumers can re-call
+                // `r.assets.put` with the same bytes (dedup) to trigger the
+                // plan-time surfacing if variants are missing.
+            }
+        }
     }
     return result;
 }
@@ -873,6 +957,7 @@ async function uploadMissing(client, projectId, presence, byteReaders, emit) {
             label: reader?.label ?? p.sha256,
             sha256: p.sha256,
             reason: "present",
+            ...(reader?.slice ? { slice_kind: reader.slice } : {}),
         });
     }
     // Filter to refs the gateway reported as missing for this project.
@@ -925,6 +1010,7 @@ async function uploadMissing(client, projectId, presence, byteReaders, emit) {
             sha256: session.sha256,
             done,
             total,
+            ...(reader.slice ? { slice_kind: reader.slice } : {}),
         });
     }
     // Plan-level finalize — marks the plan committed in the deploy_plans
@@ -1040,7 +1126,7 @@ async function putToS3(fetchFn, url, body, checksumBase64, partNumber) {
     }
     return res.headers.get("etag");
 }
-async function pollUntilReady(client, commit, diff, warnings, emit, projectId) {
+async function pollUntilReady(client, commit, diff, warnings, emit, projectId, sliceKinds = []) {
     if (commit.status === "failed") {
         throw translateGatewayError(commit.error, "commit", null, commit.operation_id);
     }
@@ -1054,7 +1140,12 @@ async function pollUntilReady(client, commit, diff, warnings, emit, projectId) {
                 context: "committing deploy",
             });
         }
-        emit({ type: "ready", releaseId: commit.release_id, urls: commit.urls });
+        emit({
+            type: "ready",
+            releaseId: commit.release_id,
+            urls: commit.urls,
+            ...(sliceKinds.length > 0 ? { slice_kinds: sliceKinds } : {}),
+        });
         return {
             release_id: commit.release_id,
             operation_id: commit.operation_id,
@@ -1065,9 +1156,16 @@ async function pollUntilReady(client, commit, diff, warnings, emit, projectId) {
     }
     const opHeaders = projectId ? await apikeyHeaders(client, projectId) : {};
     const initialSnapshot = await client.request(`/apply/v1/operations/${encodeURIComponent(commit.operation_id)}`, { headers: opHeaders, context: "fetching deploy operation" });
-    return await pollSnapshotUntilReady(client, initialSnapshot, diff, warnings, emit, projectId);
-}
-async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, projectId) {
+    return await pollSnapshotUntilReady(client, initialSnapshot, diff, warnings, emit, projectId, sliceKinds);
+}
+async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, projectId, sliceKinds = []) {
+    // Helper to spread slice_kinds onto every commit.phase / ready emit so
+    // agents grouping per-slice telemetry don't need to track the apply's
+    // spec separately. The low-level commit/upload helpers that pass no
+    // sliceKinds get an empty array → field is omitted from events.
+    const withSliceKinds = (ev) => sliceKinds.length > 0
+        ? { ...ev, slice_kinds: sliceKinds }
+        : ev;
     let snapshot = initial;
     const opHeaders = projectId ? await apikeyHeaders(client, projectId) : {};
     let lastPhaseEmitted = null;
@@ -1107,7 +1205,7 @@ async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, pro
             return;
         if (nextPhase !== undefined && prev.phase === nextPhase)
             return;
-        emit({ type: "commit.phase", phase: prev.phase, status: closeStatus });
+        emit(withSliceKinds({ type: "commit.phase", phase: prev.phase, status: closeStatus }));
     };
     while (true) {
         if (lastPhaseEmitted !== snapshot.status) {
@@ -1115,7 +1213,7 @@ async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, pro
             if (ev) {
                 if (ev.type === "commit.phase")
                     closePreviousPhase(ev.phase);
-                emit(ev);
+                emit(withSliceKinds(ev));
                 lastPhaseEmitted = snapshot.status;
             }
             // If `ev` is null (status not in the phase map, e.g. "ready"), leave
@@ -1133,7 +1231,7 @@ async function pollSnapshotUntilReady(client, initial, diff, warnings, emit, pro
                 });
             }
             closePreviousPhase();
-            emit({ type: "ready", releaseId: snapshot.release_id, urls: snapshot.urls });
+            emit(withSliceKinds({ type: "ready", releaseId: snapshot.release_id, urls: snapshot.urls }));
             return {
                 release_id: snapshot.release_id,
                 operation_id: snapshot.operation_id,
@@ -1215,12 +1313,18 @@ async function startInternal(client, spec, opts) {
             reason: plan.payment_required.reason,
         });
     }
+    const sliceKinds = deriveSliceKinds(spec);
     const resultPromise = (async () => {
         await uploadMissing(client, spec.project, plan.missing_content, byteReaders, emit);
-        emit({ type: "commit.phase", phase: "validate", status: "started" });
+        emit({
+            type: "commit.phase",
+            phase: "validate",
+            status: "started",
+            ...(sliceKinds.length > 0 ? { slice_kinds: sliceKinds } : {}),
+        });
         const { planId } = requirePersistedPlan(plan, "starting deploy");
         const commit = await commitInternal(client, planId, opts.idempotencyKey);
-        return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project);
+        return await pollUntilReady(client, commit, plan.diff, plan.warnings, emit, spec.project, sliceKinds);
     })();
     // Avoid an unhandled-rejection at construction time. Consumers must call
     // .result() to actually observe the error.
@@ -2033,7 +2137,13 @@ function invalidSecretSpec(message, resource) {
 }
 async function normalizeReleaseSpec(client, spec) {
     const byteReaders = new Map();
-    const remember = (resolved) => {
+    // Slice-tagged `remember`. Each slice category creates its own remember
+    // closure so the registered reader carries `reader.slice = "release" |
+    // "asset"`. On cross-kind dedup (same SHA from both a release-bound
+    // slice and the asset slice) the value escalates to `"mixed"`. This
+    // value surfaces on `content.upload.*` events so agents can group
+    // upload telemetry by slice kind.
+    const makeRemember = (slice) => (resolved) => {
         // Propagate the final content-type onto the deferred reader so the CAS
         // upload session can declare it correctly. Callers may set
         // ref.contentType *after* resolveContent returns (e.g. normalizeFileSet
@@ -2042,18 +2152,25 @@ async function normalizeReleaseSpec(client, spec) {
             resolved.reader.contentType = resolved.ref.contentType;
         }
         if (!byteReaders.has(resolved.ref.sha256)) {
+            resolved.reader.slice = slice;
             byteReaders.set(resolved.ref.sha256, resolved.reader);
         }
         else {
             // Already remembered — but if the existing reader has no contentType
-            // and we just learned it, fill it in.
+            // and we just learned it, fill it in. Also escalate slice tag when
+            // the second registration comes from a different kind.
             const existing = byteReaders.get(resolved.ref.sha256);
             if (resolved.ref.contentType && !existing.contentType) {
                 existing.contentType = resolved.ref.contentType;
             }
+            if (existing.slice && existing.slice !== slice && existing.slice !== "mixed") {
+                existing.slice = "mixed";
+            }
         }
         return resolved.ref;
     };
+    const rememberRelease = makeRemember("release");
+    const rememberAsset = makeRemember("asset");
     const normalized = { project: spec.project };
     if (spec.base)
         normalized.base = spec.base;
@@ -2074,19 +2191,19 @@ async function normalizeReleaseSpec(client, spec) {
             db.zero_downtime = spec.database.zero_downtime;
         }
         if (spec.database.migrations && spec.database.migrations.length > 0) {
-            db.migrations = await Promise.all(spec.database.migrations.map(async (m) => normalizeMigration(client, spec.project, m, remember)));
+            db.migrations = await Promise.all(spec.database.migrations.map(async (m) => normalizeMigration(client, spec.project, m, rememberRelease)));
         }
         normalized.database = db;
     }
     if (spec.functions) {
         const fns = {};
         if (spec.functions.replace) {
-            fns.replace = await normalizeFunctionMap(spec.functions.replace, remember);
+            fns.replace = await normalizeFunctionMap(spec.functions.replace, rememberRelease);
         }
         if (spec.functions.patch) {
             fns.patch = {};
             if (spec.functions.patch.set) {
-                fns.patch.set = await normalizeFunctionMap(spec.functions.patch.set, remember);
+                fns.patch.set = await normalizeFunctionMap(spec.functions.patch.set, rememberRelease);
             }
             if (spec.functions.patch.delete)
                 fns.patch.delete = spec.functions.patch.delete;
@@ -2096,7 +2213,7 @@ async function normalizeReleaseSpec(client, spec) {
     if (spec.site) {
         const publicPaths = "public_paths" in spec.site ? spec.site.public_paths : undefined;
         if ("replace" in spec.site && spec.site.replace) {
-            const map = await normalizeFileSet(spec.site.replace, remember);
+            const map = await normalizeFileSet(spec.site.replace, rememberRelease);
             normalized.site = {
                 replace: map,
                 ...(publicPaths ? { public_paths: publicPaths } : {}),
@@ -2105,7 +2222,7 @@ async function normalizeReleaseSpec(client, spec) {
         else if ("patch" in spec.site && spec.site.patch) {
             const patch = {};
             if (spec.site.patch.put) {
-                patch.put = await normalizeFileSet(spec.site.patch.put, remember);
+                patch.put = await normalizeFileSet(spec.site.patch.put, rememberRelease);
             }
             if (spec.site.patch.delete)
                 patch.delete = spec.site.patch.delete;
@@ -2123,7 +2240,7 @@ async function normalizeReleaseSpec(client, spec) {
     // register a byte-reader; emit the wire-shaped `AssetPutEntry[]`.
     // Cross-kind SHA dedup is automatic via the shared `byteReaders` map.
     if (spec.assets) {
-        normalized.assets = await normalizeAssetSlice(spec.assets, remember);
+        normalized.assets = await normalizeAssetSlice(spec.assets, rememberAsset);
     }
     return { normalized, byteReaders };
 }
@@ -2186,20 +2303,41 @@ function buildAssetManifestFromPlanEntries(entries) {
     let bytesUploaded = 0;
     let bytesReused = 0;
     for (const entry of entries) {
+        const ref = entry.asset_ref;
         const e = {
             key: entry.key,
             sha256: entry.sha256,
             size_bytes: entry.size_bytes,
             content_type: entry.content_type,
             visibility: entry.visibility,
-            url: entry.asset_ref.url,
-            immutable_url: entry.asset_ref.immutable_url,
-            cdn_url: entry.asset_ref.cdn_url,
-            cdn_immutable_url: entry.asset_ref.cdn_immutable_url,
-            sri: entry.asset_ref.sri,
-            etag: entry.asset_ref.etag,
-            content_digest: entry.asset_ref.content_digest,
+            url: ref.url,
+            immutable_url: ref.immutable_url,
+            cdn_url: ref.cdn_url,
+            cdn_immutable_url: ref.cdn_immutable_url,
+            sri: ref.sri,
+            etag: ref.etag,
+            content_digest: ref.content_digest,
         };
+        // v1.49+ image-variant pass-through. Only emitted when the gateway
+        // returned them (image MIMEs ≥320×320; HEIC/HEIF sources also include
+        // `display_jpeg`). Pre-v1.49 plan responses omit these fields entirely
+        // and the manifest entry stays bytewise-identical to before.
+        if (ref.width_px !== undefined)
+            e.width_px = ref.width_px;
+        if (ref.height_px !== undefined)
+            e.height_px = ref.height_px;
+        if (ref.blurhash !== undefined)
+            e.blurhash = ref.blurhash;
+        if (ref.variant_spec_version !== undefined) {
+            e.variant_spec_version = ref.variant_spec_version;
+        }
+        if (ref.display_url !== undefined)
+            e.display_url = ref.display_url;
+        if (ref.display_immutable_url !== undefined) {
+            e.display_immutable_url = ref.display_immutable_url;
+        }
+        if (ref.variants !== undefined)
+            e.variants = ref.variants;
         list.push(e);
         byKey[entry.key] = e;
         manifest[entry.key] = e;