@gradial/aci 0.1.52-rc.34-e2e.1 → 0.1.52-rc.34

package/CHANGELOG.md

@@ -1,26 +1,12 @@
 # Changelog
 
-## 0.1.52-rc.34-e2e.1
-
-Experimental staging build (ADR 0062 assetId-only contract). Not for
-customer use; dist-tagged `rc-e2e`.
-
-### Migration required
-
-- Compiled DAM images no longer carry `src`/`srcset` on their sources: they
-  carry the asset id plus the slot's declared presentation (`widths`, `fit`,
-  format). Sites must render images through the SDK helpers (`imageAttrs()`,
-  `<Picture>`, `<Image>`), which construct the `/dam/{assetId}` permalink and
-  srcset at render time. Reading `image.sources[0].src` directly no longer
-  works for DAM images; static (`static:`) assets are unchanged.
+## 0.1.52-rc.34
 
 ### Changed
 
-- `imageAttrs()` constructs `src`/`srcset` from the closed
-  `{w,h,fit,fm,q}` set (quality default 82, per-width `h` for `fit=crop`).
-- New `configureDamAssets({ baseUrl })` sets an absolute permalink origin
-  for off-origin consumers; default is relative same-origin.
-- `DAMDeliveryEnabled`/`DAM_DELIVERY_ENABLED` handling removed everywhere.
+- The `dam-delivery` agent skill now says a future `expiresAt` is admitted to
+  public delivery and can be set, moved, or cleared on a public version; only
+  a past expiry vetoes approval or is refused on a public version.
 
 ## 0.1.52-rc.33
 

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.52-rc.34-e2e.1` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.52-rc.34` is a pre-1.0 public-surface reset for the ACI
 client SDK. Breaking changes from the old `0.1.x` accidental surface are
 intentional: the root import is framework-neutral, framework runtime behavior is
 behind explicit subpaths, and the first required customer path is React/Next.
@@ -8,7 +8,7 @@ behind explicit subpaths, and the first required customer path is React/Next.
 ## Install
 
 ```bash
-npm install @gradial/aci@0.1.52-rc.34-e2e.1 zod@^4
+npm install @gradial/aci@0.1.52-rc.34 zod@^4
 ```
 
 ## Root Import
@@ -137,13 +137,13 @@ host bundles select and serve immutable release artifacts.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.52-rc.34-e2e.1 init my-site --template next-starter
+npx @gradial/aci@0.1.52-rc.34 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.52-rc.34-e2e.1 init --list
+npx @gradial/aci@0.1.52-rc.34 init --list
 ```
 
 ## Personalization: The One-Tag Install

package/dist/cli/compile-registry.mjs

@@ -352,10 +352,12 @@ function isImageSchema(schema) {
         return compiled?.type === 'object'
             && properties.$type?.const === 'gradial.image'
             && properties.assetId?.type === 'string'
+            && properties.versionId?.type === 'string'
             && properties.alt?.type === 'string'
             && properties.sources?.type === 'array'
             && required.has('$type')
             && required.has('assetId')
+            && required.has('versionId')
             && required.has('alt')
             && required.has('sources');
     }

package/dist/react/VideoPlayer.js

@@ -1,5 +1,5 @@
 import { createElement } from 'react';
-import { imageAttrs } from '../types/image.js';
+import { primaryImageSource } from '../types/image.js';
 function isEmbed(video) {
     return video.type === 'text/html';
 }
@@ -23,7 +23,7 @@ export function VideoPlayer({ video, ...attrs }) {
             ...attrs,
         });
     }
-    const posterSrc = video.poster ? String(imageAttrs(video.poster).src ?? '') : undefined;
+    const posterSrc = video.poster ? primaryImageSource(video.poster).src : undefined;
     const hasSources = video.sources && video.sources.length > 0;
     const videoAttrs = {
         poster: posterSrc,

package/dist/react/index.d.ts

@@ -19,9 +19,9 @@ export declare function Image({ image, value, ...attrs }: ImageProps): import("r
     width?: number | string | undefined | undefined;
     height?: number | string | undefined | undefined;
     sizes?: string | undefined | undefined;
+    srcSet?: string | undefined | undefined;
     loading?: "eager" | "lazy" | undefined | undefined;
     decoding?: "async" | "auto" | "sync" | undefined | undefined;
-    srcSet?: string | undefined | undefined;
     rel?: string | undefined | undefined;
     content?: string | undefined | undefined;
     referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;

package/dist/react/index.js

@@ -9,11 +9,12 @@ export { VideoPlayer } from './VideoPlayer.js';
 export function Image({ image, value, ...attrs }) {
     const resolved = image ?? value ?? {
         $type: 'gradial.image',
-        assetId: 'static:',
+        assetId: '',
+        versionId: '',
         alt: '',
         sources: [],
     };
-    if (!resolved.sources[0]) {
+    if (!resolved.sources[0]?.src) {
         return createElement('img', {
             src: '',
             alt: resolved.alt,

package/dist/types/image.d.ts

@@ -1,19 +1,13 @@
 import { z } from 'zod';
 export interface ImageSource {
-    /** Authored asset path — static sources only; DAM sources never set it. */
-    src?: string;
-    /** Declared candidate widths for the srcset (DAM sources). Empty or absent
-     *  when the slot declares no outputs: the SDK renders the bare permalink
-     *  (no params, original bytes). */
-    widths?: number[];
-    /** Layout width in pixels — the largest declared width, or the intrinsic
-     *  width for static/original-aspect sources. */
+    /** Primary derivative URL for this rendition candidate. */
+    src: string;
+    /** Intrinsic width in pixels (0 when the format carries none, e.g. SVG). */
     width?: number;
-    /** Layout height in pixels — the height at `width` (aspect carrier). */
+    /** Intrinsic height in pixels (0 when the format carries none). */
     height?: number;
-    /** Transform fit for DAM sources: 'max' fits inside the box; 'crop' fills
-     *  the declared aspect and emits an h param per srcset width. */
-    fit?: 'max' | 'crop';
+    /** Optional width-descriptor rendition candidates. */
+    srcset?: string;
     /** sizes attribute from the slot contract. */
     sizes?: string;
     /** Media query scoping this source (art direction). */
@@ -26,9 +20,8 @@ export interface Image {
     $type: 'gradial.image';
     /** DAM asset identifier (or "static:<path>" for non-DAM assets). */
     assetId: string;
-    /** DAM version identifier — absent for DAM images, which compile to the
-     *  versionless live URL /dam/{assetId}; never set for static images. */
-    versionId?: string;
+    /** DAM version identifier (or "static" for non-DAM assets). */
+    versionId: string;
     /** Accessible description of the image content. */
     alt: string;
     /** <source> candidates produced for the asset slot. */
@@ -45,14 +38,10 @@ export interface SlotOutput {
     media?: string;
 }
 export declare const ImageSourceSchema: z.ZodObject<{
-    src: z.ZodOptional<z.ZodString>;
-    widths: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    src: z.ZodString;
+    srcset: z.ZodOptional<z.ZodString>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
-    fit: z.ZodOptional<z.ZodEnum<{
-        max: "max";
-        crop: "crop";
-    }>>;
     sizes: z.ZodOptional<z.ZodString>;
     media: z.ZodOptional<z.ZodString>;
     type: z.ZodString;
@@ -60,43 +49,19 @@ export declare const ImageSourceSchema: z.ZodObject<{
 export declare const ImageSchema: z.ZodObject<{
     $type: z.ZodLiteral<"gradial.image">;
     assetId: z.ZodString;
-    versionId: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodString;
     alt: z.ZodString;
     sources: z.ZodArray<z.ZodObject<{
-        src: z.ZodOptional<z.ZodString>;
-        widths: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        src: z.ZodString;
+        srcset: z.ZodOptional<z.ZodString>;
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
-        fit: z.ZodOptional<z.ZodEnum<{
-            max: "max";
-            crop: "crop";
-        }>>;
         sizes: z.ZodOptional<z.ZodString>;
         media: z.ZodOptional<z.ZodString>;
         type: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-/** Default DAM delivery quality, matching the edge's DEFAULT_QUALITY. */
-export declare const DAM_IMAGE_QUALITY = 82;
-/**
- * Configures the origin for DAM permalinks. The default is the empty string:
- * relative same-origin URLs (`/dam/{assetId}`), served by the site's own
- * hosting edge. Set a base (e.g. `https://assets.example.com`) when images
- * are consumed off-origin — email, external CMS fields, social cards — or
- * when delivery is hosted on a dedicated domain. Call once during app setup,
- * before the first render.
- */
-export declare function configureDamAssets(options?: {
-    baseUrl?: string;
-}): void;
-/**
- * The DAM permalink for an asset: `{base}/dam/{assetId}`. No params means
- * original bytes.
- */
-export declare function damAssetUrl(assetId: string): string;
 export type ImageAttrs = Record<string, unknown>;
-/** True when the image resolves to authored static bytes, not a DAM asset. */
-export declare function isStaticImage(image: Image): boolean;
 /**
  * The primary rendition of an image — its first source entry.
  */
@@ -105,11 +70,9 @@ export declare function primaryImageSource(image: Image): ImageSource;
  * Computes the full set of <img> attributes for an Image.
  *
  * Framework components (React <Picture>, Astro <img>, Svelte <img>) call this
- * and spread the result into the native element. No HTML string
- * serialization. DAM images construct their /dam/{assetId} permalink and
- * srcset here from the slot-declared widths; static images pass their
- * authored src through. Media-scoped sources need a <picture> wrapper and
- * are not representable as plain <img> attributes, so srcset/sizes are taken
- * from the first unscoped source only.
+ * and spread the result into their native element.  No HTML string
+ * serialization. Media-scoped sources need a <picture> wrapper and are not
+ * representable as plain <img> attributes, so srcset/sizes are taken from the
+ * first unscoped source only.
  */
 export declare function imageAttrs(image: Image, overrides?: ImageAttrs): ImageAttrs;

package/dist/types/image.js

@@ -3,11 +3,10 @@ import { z } from 'zod';
 // Zod schema
 // ---------------------------------------------------------------------------
 export const ImageSourceSchema = z.object({
-    src: z.string().min(1).optional(),
-    widths: z.array(z.number().int().positive()).optional(),
+    src: z.string().min(1),
+    srcset: z.string().min(1).optional(),
     width: z.number().int().nonnegative().optional(),
     height: z.number().int().nonnegative().optional(),
-    fit: z.enum(['max', 'crop']).optional(),
     sizes: z.string().min(1).optional(),
     media: z.string().min(1).optional(),
     type: z.string().min(1),
@@ -15,97 +14,10 @@ export const ImageSourceSchema = z.object({
 export const ImageSchema = z.object({
     $type: z.literal('gradial.image'),
     assetId: z.string().min(1),
-    versionId: z.string().min(1).optional(),
+    versionId: z.string().min(1),
     alt: z.string(),
     sources: z.array(ImageSourceSchema).min(1),
 });
-// ---------------------------------------------------------------------------
-// DAM permalink construction (ADR 0062)
-// ---------------------------------------------------------------------------
-/** Default DAM delivery quality, matching the edge's DEFAULT_QUALITY. */
-export const DAM_IMAGE_QUALITY = 82;
-let damAssetBase = '';
-/**
- * Configures the origin for DAM permalinks. The default is the empty string:
- * relative same-origin URLs (`/dam/{assetId}`), served by the site's own
- * hosting edge. Set a base (e.g. `https://assets.example.com`) when images
- * are consumed off-origin — email, external CMS fields, social cards — or
- * when delivery is hosted on a dedicated domain. Call once during app setup,
- * before the first render.
- */
-export function configureDamAssets(options = {}) {
-    damAssetBase = (options.baseUrl ?? '').replace(/\/+$/, '');
-}
-/**
- * The DAM permalink for an asset: `{base}/dam/{assetId}`. No params means
- * original bytes.
- */
-export function damAssetUrl(assetId) {
-    return `${damAssetBase}/dam/${assetId}`;
-}
-const FORMAT_PARAMS = {
-    'image/avif': 'avif',
-    'image/webp': 'webp',
-    'image/jpeg': 'jpg',
-    'image/png': 'png',
-};
-function sourceFormatParams(source) {
-    const fm = FORMAT_PARAMS[source.type] ?? 'webp';
-    return `fm=${fm}&q=${DAM_IMAGE_QUALITY}`;
-}
-function srcsetWidth(assetId, source, width) {
-    const params = [`w=${width}`];
-    if (source.fit === 'crop' && source.width && source.height) {
-        const height = Math.round((width * source.height) / source.width);
-        params.push(`h=${height}`, 'fit=crop');
-    }
-    else {
-        params.push('fit=max');
-    }
-    params.push(sourceFormatParams(source));
-    return `${damAssetUrl(assetId)}?${params.join('&')} ${width}w`;
-}
-function damImageAttrs(image, primary) {
-    const base = {
-        src: damAssetUrl(image.assetId),
-        alt: image.alt,
-        width: primary.width && primary.width > 0 ? primary.width : undefined,
-        height: primary.height && primary.height > 0 ? primary.height : undefined,
-        loading: 'lazy',
-        decoding: 'async',
-    };
-    if (primary.widths && primary.widths.length > 0) {
-        // Primary src at the largest declared width; srcset covers them all.
-        const largest = primary.widths[primary.widths.length - 1];
-        const params = [`w=${largest}`];
-        if (primary.fit === 'crop' && primary.width && primary.height) {
-            params.push(`h=${Math.round((largest * primary.height) / primary.width)}`, 'fit=crop');
-        }
-        else {
-            params.push('fit=max');
-        }
-        params.push(sourceFormatParams(primary));
-        base.src = `${damAssetUrl(image.assetId)}?${params.join('&')}`;
-        if (primary.widths.length > 1) {
-            base.srcSet = primary.widths.map((w) => srcsetWidth(image.assetId, primary, w)).join(', ');
-        }
-    }
-    return base;
-}
-function staticImageAttrs(image, primary) {
-    return {
-        src: primary.src ?? '',
-        alt: image.alt,
-        width: primary.width && primary.width > 0 ? primary.width : undefined,
-        height: primary.height && primary.height > 0 ? primary.height : undefined,
-        loading: 'lazy',
-        decoding: 'async',
-    };
-}
-/** True when the image resolves to authored static bytes, not a DAM asset. */
-export function isStaticImage(image) {
-    return image.assetId.startsWith('static:');
-}
 /**
  * The primary rendition of an image — its first source entry.
  */
@@ -116,19 +28,23 @@ export function primaryImageSource(image) {
  * Computes the full set of <img> attributes for an Image.
  *
  * Framework components (React <Picture>, Astro <img>, Svelte <img>) call this
- * and spread the result into the native element. No HTML string
- * serialization. DAM images construct their /dam/{assetId} permalink and
- * srcset here from the slot-declared widths; static images pass their
- * authored src through. Media-scoped sources need a <picture> wrapper and
- * are not representable as plain <img> attributes, so srcset/sizes are taken
- * from the first unscoped source only.
+ * and spread the result into their native element.  No HTML string
+ * serialization. Media-scoped sources need a <picture> wrapper and are not
+ * representable as plain <img> attributes, so srcset/sizes are taken from the
+ * first unscoped source only.
  */
 export function imageAttrs(image, overrides = {}) {
     const primary = image.sources[0];
     const unscoped = image.sources.find((s) => !s.media) ?? primary;
-    const base = isStaticImage(image) ? staticImageAttrs(image, primary) : damImageAttrs(image, primary);
-    if (unscoped?.sizes) {
-        base.sizes = unscoped.sizes;
-    }
-    return { ...base, ...overrides };
+    return {
+        src: primary.src,
+        alt: image.alt,
+        width: primary.width && primary.width > 0 ? primary.width : undefined,
+        height: primary.height && primary.height > 0 ? primary.height : undefined,
+        srcSet: unscoped?.srcset || undefined,
+        sizes: unscoped?.sizes || undefined,
+        loading: 'lazy',
+        decoding: 'async',
+        ...overrides,
+    };
 }

package/dist/types/media.d.ts

@@ -7,17 +7,13 @@ export type Asset = Image | Video;
 export declare const AssetSchema: z.ZodUnion<readonly [z.ZodObject<{
     $type: z.ZodLiteral<"gradial.image">;
     assetId: z.ZodString;
-    versionId: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodString;
     alt: z.ZodString;
     sources: z.ZodArray<z.ZodObject<{
-        src: z.ZodOptional<z.ZodString>;
-        widths: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        src: z.ZodString;
+        srcset: z.ZodOptional<z.ZodString>;
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
-        fit: z.ZodOptional<z.ZodEnum<{
-            max: "max";
-            crop: "crop";
-        }>>;
         sizes: z.ZodOptional<z.ZodString>;
         media: z.ZodOptional<z.ZodString>;
         type: z.ZodString;
@@ -34,17 +30,13 @@ export declare const AssetSchema: z.ZodUnion<readonly [z.ZodObject<{
     poster: z.ZodOptional<z.ZodObject<{
         $type: z.ZodLiteral<"gradial.image">;
         assetId: z.ZodString;
-        versionId: z.ZodOptional<z.ZodString>;
+        versionId: z.ZodString;
         alt: z.ZodString;
         sources: z.ZodArray<z.ZodObject<{
-            src: z.ZodOptional<z.ZodString>;
-            widths: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            src: z.ZodString;
+            srcset: z.ZodOptional<z.ZodString>;
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
-            fit: z.ZodOptional<z.ZodEnum<{
-                max: "max";
-                crop: "crop";
-            }>>;
             sizes: z.ZodOptional<z.ZodString>;
             media: z.ZodOptional<z.ZodString>;
             type: z.ZodString;

package/dist/types/video.d.ts

@@ -50,17 +50,13 @@ export declare const VideoSchema: z.ZodObject<{
     poster: z.ZodOptional<z.ZodObject<{
         $type: z.ZodLiteral<"gradial.image">;
         assetId: z.ZodString;
-        versionId: z.ZodOptional<z.ZodString>;
+        versionId: z.ZodString;
         alt: z.ZodString;
         sources: z.ZodArray<z.ZodObject<{
-            src: z.ZodOptional<z.ZodString>;
-            widths: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            src: z.ZodString;
+            srcset: z.ZodOptional<z.ZodString>;
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
-            fit: z.ZodOptional<z.ZodEnum<{
-                max: "max";
-                crop: "crop";
-            }>>;
             sizes: z.ZodOptional<z.ZodString>;
             media: z.ZodOptional<z.ZodString>;
             type: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.52-rc.34-e2e.1",
+  "version": "0.1.52-rc.34",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -160,11 +160,11 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.52-rc.34-e2e.1",
-    "@gradial/aci-cli-darwin-x64": "0.1.52-rc.34-e2e.1",
-    "@gradial/aci-cli-linux-arm64": "0.1.52-rc.34-e2e.1",
-    "@gradial/aci-cli-linux-x64": "0.1.52-rc.34-e2e.1",
-    "@gradial/aci-cli-win32-arm64": "0.1.52-rc.34-e2e.1",
-    "@gradial/aci-cli-win32-x64": "0.1.52-rc.34-e2e.1"
+    "@gradial/aci-cli-darwin-arm64": "0.1.52-rc.34",
+    "@gradial/aci-cli-darwin-x64": "0.1.52-rc.34",
+    "@gradial/aci-cli-linux-arm64": "0.1.52-rc.34",
+    "@gradial/aci-cli-linux-x64": "0.1.52-rc.34",
+    "@gradial/aci-cli-win32-arm64": "0.1.52-rc.34",
+    "@gradial/aci-cli-win32-x64": "0.1.52-rc.34"
   }
 }

package/src/cli/compile-registry.mjs

@@ -346,10 +346,12 @@ function isImageSchema(schema) {
     return compiled?.type === 'object'
       && properties.$type?.const === 'gradial.image'
       && properties.assetId?.type === 'string'
+      && properties.versionId?.type === 'string'
       && properties.alt?.type === 'string'
       && properties.sources?.type === 'array'
       && required.has('$type')
       && required.has('assetId')
+      && required.has('versionId')
       && required.has('alt')
       && required.has('sources');
   } catch {

package/src/types/image.ts

@@ -3,28 +3,19 @@ import { z } from 'zod';
 // ---------------------------------------------------------------------------
 // Image source variants
 //
-// A DAM source carries the asset identity's slot presentation — the declared
-// candidate widths, the fit, and the MIME format — and NEVER a URL: the SDK
-// constructs the /dam/{assetId} permalink and its srcset at render time
-// (ADR 0062: the compiler emits asset ids only). Static assets keep their
-// authored src passthrough.
+// Each source provides a primary src and may include a ready-made srcset
+// scoped by the optional media/sizes of the slot output that produced it.
 // ---------------------------------------------------------------------------
 
 export interface ImageSource {
-  /** Authored asset path — static sources only; DAM sources never set it. */
-  src?: string;
-  /** Declared candidate widths for the srcset (DAM sources). Empty or absent
-   *  when the slot declares no outputs: the SDK renders the bare permalink
-   *  (no params, original bytes). */
-  widths?: number[];
-  /** Layout width in pixels — the largest declared width, or the intrinsic
-   *  width for static/original-aspect sources. */
+  /** Primary derivative URL for this rendition candidate. */
+  src: string;
+  /** Intrinsic width in pixels (0 when the format carries none, e.g. SVG). */
   width?: number;
-  /** Layout height in pixels — the height at `width` (aspect carrier). */
+  /** Intrinsic height in pixels (0 when the format carries none). */
   height?: number;
-  /** Transform fit for DAM sources: 'max' fits inside the box; 'crop' fills
-   *  the declared aspect and emits an h param per srcset width. */
-  fit?: 'max' | 'crop';
+  /** Optional width-descriptor rendition candidates. */
+  srcset?: string;
   /** sizes attribute from the slot contract. */
   sizes?: string;
   /** Media query scoping this source (art direction). */
@@ -34,7 +25,7 @@ export interface ImageSource {
 }
 
 // ---------------------------------------------------------------------------
-// Image — DAM-backed image asset with compiler-resolved live asset URLs
+// Image — DAM-backed image asset with compiler-resolved derivatives
 //
 // Content authors write an asset reference: { "$type": "dam.assetRef", ... }
 // or for static files: { "$type": "static.assetRef", "src": "/path" }
@@ -46,9 +37,8 @@ export interface Image {
   $type: 'gradial.image';
   /** DAM asset identifier (or "static:<path>" for non-DAM assets). */
   assetId: string;
-  /** DAM version identifier — absent for DAM images, which compile to the
-   *  versionless live URL /dam/{assetId}; never set for static images. */
-  versionId?: string;
+  /** DAM version identifier (or "static" for non-DAM assets). */
+  versionId: string;
   /** Accessible description of the image content. */
   alt: string;
   /** <source> candidates produced for the asset slot. */
@@ -76,11 +66,10 @@ export interface SlotOutput {
 // ---------------------------------------------------------------------------
 
 export const ImageSourceSchema = z.object({
-  src: z.string().min(1).optional(),
-  widths: z.array(z.number().int().positive()).optional(),
+  src: z.string().min(1),
+  srcset: z.string().min(1).optional(),
   width: z.number().int().nonnegative().optional(),
   height: z.number().int().nonnegative().optional(),
-  fit: z.enum(['max', 'crop']).optional(),
   sizes: z.string().min(1).optional(),
   media: z.string().min(1).optional(),
   type: z.string().min(1),
@@ -89,113 +78,17 @@ export const ImageSourceSchema = z.object({
 export const ImageSchema = z.object({
   $type: z.literal('gradial.image'),
   assetId: z.string().min(1),
-  versionId: z.string().min(1).optional(),
+  versionId: z.string().min(1),
   alt: z.string(),
   sources: z.array(ImageSourceSchema).min(1),
 });
 
-// ---------------------------------------------------------------------------
-// DAM permalink construction (ADR 0062)
-// ---------------------------------------------------------------------------
-
-/** Default DAM delivery quality, matching the edge's DEFAULT_QUALITY. */
-export const DAM_IMAGE_QUALITY = 82;
-
-let damAssetBase = '';
-
-/**
- * Configures the origin for DAM permalinks. The default is the empty string:
- * relative same-origin URLs (`/dam/{assetId}`), served by the site's own
- * hosting edge. Set a base (e.g. `https://assets.example.com`) when images
- * are consumed off-origin — email, external CMS fields, social cards — or
- * when delivery is hosted on a dedicated domain. Call once during app setup,
- * before the first render.
- */
-export function configureDamAssets(options: { baseUrl?: string } = {}): void {
-  damAssetBase = (options.baseUrl ?? '').replace(/\/+$/, '');
-}
-
-/**
- * The DAM permalink for an asset: `{base}/dam/{assetId}`. No params means
- * original bytes.
- */
-export function damAssetUrl(assetId: string): string {
-  return `${damAssetBase}/dam/${assetId}`;
-}
-
-const FORMAT_PARAMS: Record<string, string> = {
-  'image/avif': 'avif',
-  'image/webp': 'webp',
-  'image/jpeg': 'jpg',
-  'image/png': 'png',
-};
-
-function sourceFormatParams(source: ImageSource): string {
-  const fm = FORMAT_PARAMS[source.type] ?? 'webp';
-  return `fm=${fm}&q=${DAM_IMAGE_QUALITY}`;
-}
-
-function srcsetWidth(assetId: string, source: ImageSource, width: number): string {
-  const params = [`w=${width}`];
-  if (source.fit === 'crop' && source.width && source.height) {
-    const height = Math.round((width * source.height) / source.width);
-    params.push(`h=${height}`, 'fit=crop');
-  } else {
-    params.push('fit=max');
-  }
-  params.push(sourceFormatParams(source));
-  return `${damAssetUrl(assetId)}?${params.join('&')} ${width}w`;
-}
-
-function damImageAttrs(image: Image, primary: ImageSource): ImageAttrs {
-  const base: ImageAttrs = {
-    src: damAssetUrl(image.assetId),
-    alt: image.alt,
-    width: primary.width && primary.width > 0 ? primary.width : undefined,
-    height: primary.height && primary.height > 0 ? primary.height : undefined,
-    loading: 'lazy',
-    decoding: 'async',
-  };
-  if (primary.widths && primary.widths.length > 0) {
-    // Primary src at the largest declared width; srcset covers them all.
-    const largest = primary.widths[primary.widths.length - 1];
-    const params = [`w=${largest}`];
-    if (primary.fit === 'crop' && primary.width && primary.height) {
-      params.push(`h=${Math.round((largest * primary.height) / primary.width)}`, 'fit=crop');
-    } else {
-      params.push('fit=max');
-    }
-    params.push(sourceFormatParams(primary));
-    base.src = `${damAssetUrl(image.assetId)}?${params.join('&')}`;
-    if (primary.widths.length > 1) {
-      base.srcSet = primary.widths.map((w) => srcsetWidth(image.assetId, primary, w)).join(', ');
-    }
-  }
-  return base;
-}
-
-function staticImageAttrs(image: Image, primary: ImageSource): ImageAttrs {
-  return {
-    src: primary.src ?? '',
-    alt: image.alt,
-    width: primary.width && primary.width > 0 ? primary.width : undefined,
-    height: primary.height && primary.height > 0 ? primary.height : undefined,
-    loading: 'lazy',
-    decoding: 'async',
-  };
-}
-
 // ---------------------------------------------------------------------------
 // Shared attrs helper — consumed by React, Astro, and Svelte components
 // ---------------------------------------------------------------------------
 
 export type ImageAttrs = Record<string, unknown>;
 
-/** True when the image resolves to authored static bytes, not a DAM asset. */
-export function isStaticImage(image: Image): boolean {
-  return image.assetId.startsWith('static:');
-}
-
 /**
  * The primary rendition of an image — its first source entry.
  */
@@ -207,21 +100,24 @@ export function primaryImageSource(image: Image): ImageSource {
  * Computes the full set of <img> attributes for an Image.
  *
  * Framework components (React <Picture>, Astro <img>, Svelte <img>) call this
- * and spread the result into the native element. No HTML string
- * serialization. DAM images construct their /dam/{assetId} permalink and
- * srcset here from the slot-declared widths; static images pass their
- * authored src through. Media-scoped sources need a <picture> wrapper and
- * are not representable as plain <img> attributes, so srcset/sizes are taken
- * from the first unscoped source only.
+ * and spread the result into their native element.  No HTML string
+ * serialization. Media-scoped sources need a <picture> wrapper and are not
+ * representable as plain <img> attributes, so srcset/sizes are taken from the
+ * first unscoped source only.
  */
 export function imageAttrs(image: Image, overrides: ImageAttrs = {}): ImageAttrs {
   const primary = image.sources[0];
   const unscoped = image.sources.find((s) => !s.media) ?? primary;
 
-  const base = isStaticImage(image) ? staticImageAttrs(image, primary) : damImageAttrs(image, primary);
-
-  if (unscoped?.sizes) {
-    base.sizes = unscoped.sizes;
-  }
-  return { ...base, ...overrides };
+  return {
+    src: primary.src,
+    alt: image.alt,
+    width: primary.width && primary.width > 0 ? primary.width : undefined,
+    height: primary.height && primary.height > 0 ? primary.height : undefined,
+    srcSet: unscoped?.srcset || undefined,
+    sizes: unscoped?.sizes || undefined,
+    loading: 'lazy',
+    decoding: 'async',
+    ...overrides,
+  };
 }

package/src/types/video.ts

@@ -11,7 +11,7 @@ export interface VideoSource {
 }
 
 // ---------------------------------------------------------------------------
-// Video — DAM-backed video asset with compiler-resolved live asset URLs
+// Video — DAM-backed video asset with compiler-resolved derivatives
 //
 // Content authors write: { "$type": "dam.assetRef", ... }
 // or for static files: { "$type": "static.assetRef", "src": "/path" }

package/templates/astro/starter-content/src/fixtures/sections.ts

@@ -26,6 +26,7 @@ export const sectionStoryFixtures: SectionStoryFixture[] = [
         image: {
           $type: 'gradial.image',
           assetId: '3Ih26etWBTYfnAd0EjD0pP2h902',
+          versionId: 'v0001',
           alt: 'Seattle skyline at dusk',
           sources: [
             { src: '/assets/seattle.avif', width: 1920, height: 1280, sizes: '100vw', type: 'image/avif' }

package/templates/common/.agents/skills/dam-delivery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dam-delivery
-description: Build and use public DAM asset links (`/dam/{assetId}`) with on-the-fly image shaping (resize, crop, format, quality). Use when a page, a CMS field, or an email needs a URL for an approved DAM asset, when choosing between a compiled content link and a shaped public link, when making an asset public or taking it down, or when a `/dam/…` URL answers 301, 403, or 404 unexpectedly.
+description: Build and use public DAM asset links (`/dam/{assetId}`) with on-the-fly image shaping (resize, crop, format, quality). Use when a page, a CMS field, or an email needs a URL for an approved DAM asset, when choosing between pre-baked derivatives and a shaped public link, when making an asset public or taking it down, or when a `/dam/…` URL answers 301, 403, or 404 unexpectedly.
 ---
 
 # DAM Delivery — Public Asset Links
@@ -59,9 +59,9 @@ the link above. They are not served and they do not redirect.
   ```
 
 The route is served by the deployed site's hosting edge. The site's own
-dev server (`npm run dev`) serves `/dam/…` links for assets seeded in the
-local `.content/dam/` tree; anything else answers 404 there — test it
-against the deployed domain.
+dev server (`npm run dev`) only serves compiled derivatives under
+`/dam/…`, so a public link answers 404 there — test it against the
+deployed domain.
 
 ## Shaping an Image
 
@@ -70,7 +70,7 @@ Five query parameters, and only these. Full rules and worked examples:
 
 | Param | Values | Default | Notes |
 | --- | --- | --- | --- |
-| `w`, `h` | whole numbers | none | 1–4096, honored exactly — no snapping or size ladder |
+| `w`, `h` | whole numbers | none | held to 16–3840, then snapped down to a fixed ladder of sizes |
 | `fit` | `max` \| `crop` | `max` | `max` fits inside the box; `crop` fills it and needs both `w` and `h` |
 | `fm` | `webp` \| `avif` \| `jpg` \| `png` | `webp` | the format is always this parameter, never the browser's `Accept` header |
 | `q` | 5–100 | 80 | snapped down to steps of 5 |
@@ -120,7 +120,7 @@ Read `effects` in the response to see what happened:
 | Effect | Meaning |
 | --- | --- |
 | `live_published` | the link now serves this version |
-| `public_admission_vetoed:<cause>` | the version is approved but **not public**: it carries an expiry date, an embargo still in force, a usage block, or a license that does not allow publication. The link keeps serving the previous public version, if there is one |
+| `public_admission_vetoed:<cause>` | the version is approved but **not public**: its expiry date has already passed, an embargo is still in force, a usage block, or a license that does not allow publication. A future expiry date does not veto; the link serves until that date. The link keeps serving the previous public version, if there is one |
 | `live_plane_unconfigured` | a local or dev stack with no delivery wired; nothing was made public |
 
 On the asset record (`GET /v1/dam/assets/{assetId}`), a public version
@@ -133,9 +133,11 @@ shows `deliveryTier: "public"` in its governance, and a refused one shows
   the previous public version, or stops serving if there is none) or
   `archive` the asset. Both use the same lifecycle endpoint.
 - **Governance that would have blocked the approval cannot be added while
-  a version is public.** A patch adding an expiry date, an embargo, a
+  a version is public.** A patch adding a past expiry date, an embargo, a
   usage block, or a license without publication is refused with a
-  conflict that tells you to demote first.
+  conflict that tells you to demote first. A future expiry date can be
+  set, moved, or cleared on a public version; the link stops serving the
+  version when that date arrives.
 - **Changes take up to five minutes to show everywhere.** Responses are
   `Cache-Control: public, max-age=300`, so a new version or a take-down
   can lag by that long in browsers and CDN caches. On AWS CloudFront,
@@ -145,22 +147,19 @@ shows `deliveryTier: "public"` in its governance, and a refused one shows
   not treat a public link as instantly revocable, and do not re-cache it
   for longer downstream.
 
-## Compiled Content Link or a Public Link?
+## Pre-Baked Derivatives or a Public Link?
 
-- **Images a page renders from content: use the compiled live link.**
-  Author a `dam.assetRef` (asset id + alt); the compiler emits the
-  versionless permalink and the SDK asset component builds the `srcset`
-  from the slot's declared widths at render time. Declare `imageSlots` in
-  the contract and render with `imageAttrs()` or `Picture`; you never
-  construct a URL. There is no pre-baked derivative pipeline — publish
-  stages no asset bytes.
+- **Images a page renders from content: keep using the pre-baked
+  pipeline.** Declare `imageSlots` in the contract and render with
+  `imageAttrs()` or `Picture`. The build produces fixed sizes per slot and
+  you never construct a URL. See the authoring skill.
 - **A URL that lives outside the build: use the public link.** A field in
   an external CMS, an email, a social card, a partner page, or a one-off
   size that no slot declares.
 
-The difference that matters: a compiled link follows approval and take-down
-through each publish, while a public link follows them on its own, within
-the five-minute window.
+The difference that matters: a pre-baked image is fixed at publish time
+and changes with the next publish. A public link follows approval and
+take-down on its own, within the five-minute window.
 
 Published content may carry `/dam/{assetId}` links. The publish check
 rejects a payload that contains a raw source path (`dam/blobs/…`) or a

package/templates/common/starter-content/.content/dam/folders/seed/000000000000000000000000101/governance.json

@@ -17,8 +17,7 @@
       "license": {
         "kind": "unsplash-local-fixture"
       },
-      "publicationRestriction": "none",
-      "deliveryTier": "public"
+      "publicationRestriction": "none"
     }
   }
 }

package/templates/common/starter-content/.content/dam/folders/seed/000000000000000000000000102/governance.json

@@ -17,8 +17,7 @@
       "license": {
         "kind": "unsplash-local-fixture"
       },
-      "publicationRestriction": "none",
-      "deliveryTier": "public"
+      "publicationRestriction": "none"
     }
   }
 }

package/templates/common/starter-content/.content/patterns/components/button.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "button",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/container.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "container",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/feature_card.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "feature_card",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/feature_grid.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "feature_grid",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/home_hero.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "home_hero",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -54,13 +54,9 @@
                   "type": "string",
                   "minLength": 1
                 },
-                "widths": {
-                  "type": "array",
-                  "items": {
-                    "type": "integer",
-                    "exclusiveMinimum": 0,
-                    "maximum": 9007199254740991
-                  }
+                "srcset": {
+                  "type": "string",
+                  "minLength": 1
                 },
                 "width": {
                   "type": "integer",
@@ -72,13 +68,6 @@
                   "minimum": 0,
                   "maximum": 9007199254740991
                 },
-                "fit": {
-                  "type": "string",
-                  "enum": [
-                    "max",
-                    "crop"
-                  ]
-                },
                 "sizes": {
                   "type": "string",
                   "minLength": 1
@@ -93,6 +82,7 @@
                 }
               },
               "required": [
+                "src",
                 "type"
               ],
               "additionalProperties": false
@@ -102,6 +92,7 @@
         "required": [
           "$type",
           "assetId",
+          "versionId",
           "alt",
           "sources"
         ],

package/templates/common/starter-content/.content/patterns/components/personalization_choice.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "personalization_choice",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/site-footer.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "site-footer",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/site-navigation.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "site-navigation",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",

package/templates/common/starter-content/.content/patterns/components/stats_bar.json

@@ -1,7 +1,7 @@
 {
   "$type": "componentPattern",
-  "buildId": "codebuild_01a12331-b86d-7d20-8a35-a7a71d96e8be",
-  "codeDigest": "sha256:f1246860864e55359c7ad442a7a956b61a835a4826cd6229cc9971db1fe29a67",
+  "buildId": "codebuild_01a0d03d-1243-7f49-9ead-8599ed577882",
+  "codeDigest": "sha256:44327370dc42bcabe39daf8b86fca1fe191e19dbd8dd39db71df2109c11b3635",
   "name": "stats_bar",
   "schema": {
     "$schema": "https://json-schema.org/draft/2020-12/schema",