@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/utils/creative-delivery.mjs

@@ -1,4 +1,25 @@
+import {
+  projectCreativeForDelivery
+} from "../v2/projection/creative-delivery.mjs";
+import { resolveCanonicalFormatKind } from "../v2/projection/v1-to-v2.mjs";
 function inlineCreativesForPackages(packages, creatives, options = {}) {
+  assertCanonicalInlineInputs(packages, creatives, options);
+  return inlineCreativesForPackagesInternal(packages, creatives, options, "canonical");
+}
+function inlineCreativesForPackagesLegacy(packages, creatives, options = {}) {
+  const { creativeFormatWireMode = "legacy", ...sharedOptions } = options;
+  return inlineCreativesForPackagesInternal(
+    packages,
+    creatives,
+    {
+      ...sharedOptions,
+      legacyFormatConverter: options.legacyFormatConverter,
+      canonicalFormatLegacyResolver: options.canonicalFormatLegacyResolver
+    },
+    creativeFormatWireMode
+  );
+}
+function inlineCreativesForPackagesInternal(packages, creatives, options, creativeFormatWireMode) {
   const {
     assignments,
     includeUnassignedCreatives = assignments == null || assignments.length === 0,
@@ -6,7 +27,9 @@ function inlineCreativesForPackages(packages, creatives, options = {}) {
     packageId = defaultPackageId,
     onUnmatchedAssignment = "throw",
     onMissingCreative = "throw",
-    onIncompatibleAssignment = "throw"
+    onIncompatibleAssignment = "throw",
+    legacyFormatConverter,
+    canonicalFormatLegacyResolver
   } = options;
   const creativesById = /* @__PURE__ */ new Map();
   for (const creative of creatives) {
@@ -42,9 +65,26 @@ function inlineCreativesForPackages(packages, creatives, options = {}) {
     for (const assignment of assigned) {
       const creative = creativesById.get(assignment.creative_id);
       if (!creative) continue;
-      const compatible = !filterByFormat || creativeMatchesPackage(pkg, creative);
+      const sourceCompatible = !filterByFormat || creativeMatchesPackage(pkg, creative);
+      if (!sourceCompatible) {
+        if (onIncompatibleAssignment === "throw") {
+          throw new Error(
+            `inlineCreativesForPackages assignment creative_id "${assignment.creative_id}" does not match package_id "${assignment.package_id}" format selectors`
+          );
+        }
+        continue;
+      }
+      const projected = projectCreativeForDelivery(
+        creative,
+        pkg,
+        creativeFormatWireMode,
+        "inline_creatives",
+        legacyFormatConverter,
+        canonicalFormatLegacyResolver
+      );
+      const compatible = !filterByFormat || creativeMatchesPackage(pkg, projected);
       if (compatible) {
-        inlined.push(applyAssignmentToCreative(creative, assignment));
+        inlined.push(applyAssignmentToCreative(projected, assignment));
       } else if (onIncompatibleAssignment === "throw") {
         throw new Error(
           `inlineCreativesForPackages assignment creative_id "${assignment.creative_id}" does not match package_id "${assignment.package_id}" format selectors`
@@ -54,8 +94,17 @@ function inlineCreativesForPackages(packages, creatives, options = {}) {
     if (includeUnassignedCreatives) {
       for (const creative of creatives) {
         if (typeof creative.creative_id === "string" && assignedCreativeIds.has(creative.creative_id)) continue;
-        if (!filterByFormat || creativeMatchesPackage(pkg, creative)) {
-          inlined.push({ ...creative });
+        if (filterByFormat && !creativeMatchesPackage(pkg, creative)) continue;
+        const projected = projectCreativeForDelivery(
+          creative,
+          pkg,
+          creativeFormatWireMode,
+          "inline_creatives",
+          legacyFormatConverter,
+          canonicalFormatLegacyResolver
+        );
+        if (!filterByFormat || creativeMatchesPackage(pkg, projected)) {
+          inlined.push({ ...projected });
         }
       }
     }
@@ -74,6 +123,28 @@ function inlineCreativesForPackages(packages, creatives, options = {}) {
   }
   return result;
 }
+function assertCanonicalInlineInputs(packages, creatives, options) {
+  const unsafeOptions = options;
+  if ("creativeFormatWireMode" in unsafeOptions || "legacyFormatConverter" in unsafeOptions || "canonicalFormatLegacyResolver" in unsafeOptions) {
+    throw new Error(
+      "inlineCreativesForPackages is canonical-only; use inlineCreativesForPackagesLegacy for legacy wire projection"
+    );
+  }
+  for (const pkg of packages) {
+    if ("format_ids" in pkg) {
+      throw new Error(
+        "inlineCreativesForPackages does not accept legacy package format_ids; use canonical format selectors or inlineCreativesForPackagesLegacy"
+      );
+    }
+  }
+  for (const creative of creatives) {
+    if ("format_id" in creative) {
+      throw new Error(
+        "inlineCreativesForPackages does not accept legacy creative format_id; use canonical format_kind or inlineCreativesForPackagesLegacy"
+      );
+    }
+  }
+}
 function defaultPackageId(pkg) {
   if (typeof pkg.package_id === "string") return pkg.package_id;
   if (typeof pkg.context?.buyer_ref === "string") return pkg.context.buyer_ref;
@@ -108,13 +179,37 @@ function creativeMatchesPackage(pkg, creative) {
     if (packageFormatIds.length === 0 && packageFormatKind === void 0) return false;
   }
   if (packageFormatKind !== void 0) {
-    return creativeRecord.format_kind === packageFormatKind && paramsMatchCreative(packageParams, creativeFormatId);
+    return creativeRecord.format_kind === packageFormatKind && paramsMatchCreative(packageParams, creativeFormatId ?? creativeParamsFromAssets(creativeRecord.assets));
   }
   if (packageFormatIds.length > 0) {
-    return creativeFormatId !== void 0 && packageFormatIds.some((formatId) => formatIdMatches(formatId, creativeFormatId));
+    if (creativeFormatId !== void 0) {
+      return packageFormatIds.some((formatId) => formatIdMatches(formatId, creativeFormatId));
+    }
+    return packageFormatIds.some(
+      (formatId) => typeof formatId.id === "string" && resolveCanonicalFormatKind(formatId.id, {
+        agentUrl: typeof formatId.agent_url === "string" ? formatId.agent_url : void 0
+      }) === creativeRecord.format_kind
+    );
   }
   return true;
 }
+function creativeParamsFromAssets(value) {
+  const assets = plainObject(value);
+  if (!assets) return void 0;
+  for (const assetValue of Object.values(assets)) {
+    const candidates = Array.isArray(assetValue) ? assetValue : [assetValue];
+    for (const candidate of candidates) {
+      const asset = plainObject(candidate);
+      if (!asset) continue;
+      const params = {};
+      if (typeof asset.width === "number") params.width = asset.width;
+      if (typeof asset.height === "number") params.height = asset.height;
+      if (typeof asset.duration_ms === "number") params.duration_ms = asset.duration_ms;
+      if (Object.keys(params).length > 0) return params;
+    }
+  }
+  return void 0;
+}
 function arrayOfObjects(value) {
   return Array.isArray(value) ? value.flatMap((item) => plainObject(item) ? [item] : []) : [];
 }
@@ -226,6 +321,7 @@ function sortKeys(value) {
   );
 }
 export {
-  inlineCreativesForPackages
+  inlineCreativesForPackages,
+  inlineCreativesForPackagesLegacy
 };
 //# sourceMappingURL=creative-delivery.mjs.map

package/dist/lib/utils/creative-delivery.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/utils/creative-delivery.ts"],"sourcesContent":["import type { CreativeAsset, PackageRequest } from '../types/tools.generated';\n\n/**\n * Package-like input accepted by `inlineCreativesForPackages`.\n *\n * `PackageRequest` is the create-media-buy shape. Update-media-buy package\n * patches are narrower but carry the same `package_id` + `creatives` fields,\n * so the helper accepts both without depending on AgentClient.\n */\nexport type InlineCreativePackage = Partial<PackageRequest> & {\n  package_id?: string;\n  buyer_ref?: string;\n  context?: { buyer_ref?: string; [key: string]: unknown };\n  creatives?: CreativeAsset[];\n  [key: string]: unknown;\n};\n\n/**\n * Assignment shape shared with `sync_creatives.assignments[]`, plus\n * `placement_refs` for callers already authoring the structured placement\n * form accepted by inline `CreativeAsset`.\n */\nexport interface InlineCreativeAssignment {\n  creative_id: string;\n  package_id: string;\n  weight?: number;\n  placement_ids?: string[];\n  placement_refs?: unknown[];\n}\n\nexport interface InlineCreativesForPackagesOptions<TPackage extends InlineCreativePackage = InlineCreativePackage> {\n  /**\n   * Package-scoped assignment instructions. When supplied, only creatives\n   * assigned to each package are inlined unless `includeUnassignedCreatives`\n   * is true.\n   */\n  assignments?: ReadonlyArray<InlineCreativeAssignment>;\n\n  /**\n   * Include compatible creatives that have no assignment entry. Defaults to\n   * false when assignments are supplied and true when no assignments exist.\n   */\n  includeUnassignedCreatives?: boolean;\n\n  /**\n   * Filter creatives by package format selectors (`format_ids`,\n   * `format_option_refs`, or `format_kind`). Defaults to true.\n   */\n  filterByFormat?: boolean;\n\n  /**\n   * Resolve the package identifier used to match assignment.package_id.\n   * Defaults to `package_id`, then `context.buyer_ref`, then `buyer_ref`.\n   */\n  packageId?: (pkg: TPackage, index: number) => string | undefined;\n\n  /**\n   * Behavior when an assignment names a package not present in the package\n   * list. Defaults to throw so package scoping mistakes do not broaden\n   * delivery silently.\n   */\n  onUnmatchedAssignment?: 'throw' | 'ignore';\n\n  /**\n   * Behavior when an assignment names a creative not present in `creatives`.\n   * Defaults to throw because inline payloads cannot reference library-only\n   * creatives.\n   */\n  onMissingCreative?: 'throw' | 'ignore';\n\n  /**\n   * Behavior when an explicit assignment names a creative whose format cannot\n   * satisfy the target package selectors. Defaults to throw so authoring\n   * mistakes do not silently remove assigned delivery.\n   */\n  onIncompatibleAssignment?: 'throw' | 'ignore';\n}\n\nexport type InlineCreativePackagePatch<TPackage extends InlineCreativePackage = InlineCreativePackage> = TPackage & {\n  creatives?: CreativeAsset[];\n};\n\n/**\n * Project library-scoped creative assets into package-scoped inline creative\n * payloads for `create_media_buy` or `update_media_buy`.\n *\n * The helper is pure: it performs no network calls, does not call\n * `sync_creatives`, and does not generate idempotency keys. Use\n * `supportsSyncCreatives(caps)` to decide whether the seller has a creative\n * library. When it does not, spread this helper's result into\n * `packages[].creatives` and use a fresh idempotency key for the enclosing\n * create/update media-buy call.\n *\n * @example\n * ```ts\n * const caps = await agent.getCapabilities();\n * if (supportsSyncCreatives(caps)) {\n *   await agent.syncCreatives({ account, creatives, assignments });\n * } else if (caps.features.inlineCreativeManagement) {\n *   await agent.createMediaBuy({\n *     account,\n *     idempotency_key: crypto.randomUUID(),\n *     packages: inlineCreativesForPackages(packages, creatives, { assignments }),\n *   });\n * } else {\n *   throw new Error('Seller supports neither creative library sync nor inline creative uploads.');\n * }\n * ```\n */\nexport function inlineCreativesForPackages<TPackage extends InlineCreativePackage>(\n  packages: ReadonlyArray<TPackage>,\n  creatives: ReadonlyArray<CreativeAsset>,\n  options: InlineCreativesForPackagesOptions<TPackage> = {}\n): InlineCreativePackagePatch<TPackage>[] {\n  const {\n    assignments,\n    includeUnassignedCreatives = assignments == null || assignments.length === 0,\n    filterByFormat = true,\n    packageId = defaultPackageId,\n    onUnmatchedAssignment = 'throw',\n    onMissingCreative = 'throw',\n    onIncompatibleAssignment = 'throw',\n  } = options;\n\n  const creativesById = new Map<string, CreativeAsset>();\n  for (const creative of creatives) {\n    if (typeof creative.creative_id === 'string') {\n      creativesById.set(creative.creative_id, creative);\n    }\n  }\n\n  const assignmentsByPackage = new Map<string, InlineCreativeAssignment[]>();\n  const matchedPackageIds = new Set<string>();\n  for (const assignment of assignments ?? []) {\n    const creative = creativesById.get(assignment.creative_id);\n    if (!creative) {\n      if (onMissingCreative === 'throw') {\n        throw new Error(\n          `inlineCreativesForPackages assignment references unknown creative_id \"${assignment.creative_id}\"`\n        );\n      }\n      continue;\n    }\n    const existing = assignmentsByPackage.get(assignment.package_id);\n    if (existing) {\n      existing.push(assignment);\n    } else {\n      assignmentsByPackage.set(assignment.package_id, [assignment]);\n    }\n  }\n\n  const result = packages.map((pkg, index) => {\n    const id = packageId(pkg, index);\n    if (id) matchedPackageIds.add(id);\n    const assigned = id ? (assignmentsByPackage.get(id) ?? []) : [];\n    const assignedCreativeIds = new Set(assigned.map(a => a.creative_id));\n    const inlined: CreativeAsset[] = [];\n\n    for (const assignment of assigned) {\n      const creative = creativesById.get(assignment.creative_id);\n      if (!creative) continue;\n      const compatible = !filterByFormat || creativeMatchesPackage(pkg, creative);\n      if (compatible) {\n        inlined.push(applyAssignmentToCreative(creative, assignment));\n      } else if (onIncompatibleAssignment === 'throw') {\n        throw new Error(\n          `inlineCreativesForPackages assignment creative_id \"${assignment.creative_id}\" ` +\n            `does not match package_id \"${assignment.package_id}\" format selectors`\n        );\n      }\n    }\n\n    if (includeUnassignedCreatives) {\n      for (const creative of creatives) {\n        if (typeof creative.creative_id === 'string' && assignedCreativeIds.has(creative.creative_id)) continue;\n        if (!filterByFormat || creativeMatchesPackage(pkg, creative)) {\n          inlined.push({ ...creative });\n        }\n      }\n    }\n\n    const next: Record<string, unknown> = { ...(pkg as Record<string, unknown>) };\n    delete next.creatives;\n    if (inlined.length > 0) {\n      next.creatives = inlined;\n    }\n    return next as InlineCreativePackagePatch<TPackage>;\n  });\n\n  if (onUnmatchedAssignment === 'throw') {\n    const unmatched = [...assignmentsByPackage.keys()].filter(package_id => !matchedPackageIds.has(package_id));\n    if (unmatched.length > 0) {\n      throw new Error(`inlineCreativesForPackages assignment references unknown package_id \"${unmatched[0]}\"`);\n    }\n  }\n\n  return result;\n}\n\nfunction defaultPackageId(pkg: InlineCreativePackage): string | undefined {\n  if (typeof pkg.package_id === 'string') return pkg.package_id;\n  if (typeof pkg.context?.buyer_ref === 'string') return pkg.context.buyer_ref;\n  if (typeof pkg.buyer_ref === 'string') return pkg.buyer_ref;\n  return undefined;\n}\n\nfunction applyAssignmentToCreative(creative: CreativeAsset, assignment: InlineCreativeAssignment): CreativeAsset {\n  const next: Record<string, unknown> = { ...(creative as unknown as Record<string, unknown>) };\n  delete next.weight;\n  delete next.placement_ids;\n  delete next.placement_refs;\n\n  if (assignment.weight !== undefined) next.weight = assignment.weight;\n  if (assignment.placement_refs !== undefined) {\n    next.placement_refs = [...assignment.placement_refs];\n  } else if (assignment.placement_ids !== undefined) {\n    next.placement_ids = [...assignment.placement_ids];\n  }\n  return next as unknown as CreativeAsset;\n}\n\nfunction creativeMatchesPackage(pkg: InlineCreativePackage, creative: CreativeAsset): boolean {\n  const packageFormatIds = arrayOfObjects(pkg.format_ids);\n  const packageFormatOptionRefs = arrayOfObjects(pkg.format_option_refs);\n  const packageFormatKind = typeof pkg.format_kind === 'string' ? pkg.format_kind : undefined;\n  const packageParams = plainObject(pkg.params);\n\n  const creativeRecord = creative as unknown as Record<string, unknown>;\n  const creativeFormatId = plainObject(creativeRecord.format_id);\n  const creativeFormatOptionRef = plainObject(creativeRecord.format_option_ref);\n\n  if (packageFormatOptionRefs.length > 0) {\n    if (creativeFormatOptionRef) {\n      return packageFormatOptionRefs.some(formatOptionRef => deepEqual(formatOptionRef, creativeFormatOptionRef));\n    }\n    if (packageFormatIds.length === 0 && packageFormatKind === undefined) return false;\n  }\n\n  if (packageFormatKind !== undefined) {\n    return creativeRecord.format_kind === packageFormatKind && paramsMatchCreative(packageParams, creativeFormatId);\n  }\n\n  if (packageFormatIds.length > 0) {\n    return (\n      creativeFormatId !== undefined && packageFormatIds.some(formatId => formatIdMatches(formatId, creativeFormatId))\n    );\n  }\n\n  return true;\n}\n\nfunction arrayOfObjects(value: unknown): Record<string, unknown>[] {\n  return Array.isArray(value) ? value.flatMap(item => (plainObject(item) ? [item] : [])) : [];\n}\n\nfunction plainObject(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction formatIdMatches(expected: Record<string, unknown>, actual: Record<string, unknown>): boolean {\n  const expectedId = expected.id;\n  const actualId = actual.id;\n  if (expectedId !== actualId) return false;\n\n  const expectedAgentUrl = normalizeAgentUrl(expected.agent_url);\n  const actualAgentUrl = normalizeAgentUrl(actual.agent_url);\n  if (expectedAgentUrl !== undefined && actualAgentUrl !== undefined && expectedAgentUrl !== actualAgentUrl) {\n    return false;\n  }\n\n  for (const key of ['width', 'height', 'duration_ms']) {\n    if (expected[key] !== undefined && actual[key] !== undefined && expected[key] !== actual[key]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction paramsMatchCreative(\n  packageParams: Record<string, unknown> | undefined,\n  creativeFormatId: Record<string, unknown> | undefined\n): boolean {\n  if (!packageParams) return true;\n\n  let constrained = false;\n  const actualWidth = numberValue(creativeFormatId, 'width');\n  const actualHeight = numberValue(creativeFormatId, 'height');\n  const actualDuration =\n    numberValue(creativeFormatId, 'duration_ms') ?? numberValue(creativeFormatId, 'duration_ms_exact');\n\n  const sizes = Array.isArray(packageParams.sizes)\n    ? packageParams.sizes.flatMap(size => (plainObject(size) ? [size] : []))\n    : [];\n  if (sizes.length > 0) {\n    constrained = true;\n    if (\n      actualWidth === undefined ||\n      actualHeight === undefined ||\n      !sizes.some(size => numberValue(size, 'width') === actualWidth && numberValue(size, 'height') === actualHeight)\n    ) {\n      return false;\n    }\n  }\n\n  const expectedWidth = numberValue(packageParams, 'width');\n  if (expectedWidth !== undefined) {\n    constrained = true;\n    if (actualWidth !== expectedWidth) return false;\n  }\n\n  const expectedHeight = numberValue(packageParams, 'height');\n  if (expectedHeight !== undefined) {\n    constrained = true;\n    if (actualHeight !== expectedHeight) return false;\n  }\n\n  const minWidth = numberValue(packageParams, 'min_width');\n  if (minWidth !== undefined) {\n    constrained = true;\n    if (actualWidth === undefined || actualWidth < minWidth) return false;\n  }\n\n  const maxWidth = numberValue(packageParams, 'max_width');\n  if (maxWidth !== undefined) {\n    constrained = true;\n    if (actualWidth === undefined || actualWidth > maxWidth) return false;\n  }\n\n  const minHeight = numberValue(packageParams, 'min_height');\n  if (minHeight !== undefined) {\n    constrained = true;\n    if (actualHeight === undefined || actualHeight < minHeight) return false;\n  }\n\n  const maxHeight = numberValue(packageParams, 'max_height');\n  if (maxHeight !== undefined) {\n    constrained = true;\n    if (actualHeight === undefined || actualHeight > maxHeight) return false;\n  }\n\n  const exactDuration = numberValue(packageParams, 'duration_ms_exact') ?? numberValue(packageParams, 'duration_ms');\n  if (exactDuration !== undefined) {\n    constrained = true;\n    if (actualDuration !== exactDuration) return false;\n  }\n\n  const durationRange = numberRange(packageParams.duration_ms_range);\n  if (durationRange) {\n    constrained = true;\n    const [minDuration, maxDuration] = durationRange;\n    if (actualDuration === undefined) return false;\n    if (minDuration !== undefined && actualDuration < minDuration) return false;\n    if (maxDuration !== undefined && actualDuration > maxDuration) return false;\n  }\n\n  return constrained ? creativeFormatId !== undefined : true;\n}\n\nfunction numberValue(object: Record<string, unknown> | undefined, key: string): number | undefined {\n  const value = object?.[key];\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction numberRange(value: unknown): [number | undefined, number | undefined] | undefined {\n  if (!Array.isArray(value) || value.length !== 2) return undefined;\n  const [min, max] = value;\n  const minValue = min === null ? undefined : typeof min === 'number' && Number.isFinite(min) ? min : undefined;\n  const maxValue = max === null ? undefined : typeof max === 'number' && Number.isFinite(max) ? max : undefined;\n  return minValue === undefined && maxValue === undefined ? undefined : [minValue, maxValue];\n}\n\nfunction normalizeAgentUrl(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return end === value.length ? value : value.slice(0, end);\n}\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  return JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b));\n}\n\nfunction sortKeys(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(sortKeys);\n  const object = plainObject(value);\n  if (!object) return value;\n  return Object.fromEntries(\n    Object.entries(object)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => [k, sortKeys(v)])\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/lib/utils/creative-delivery.ts"],"sourcesContent":["import type { CreativeAsset, PackageRequest } from '../types/tools.generated';\nimport {\n  projectCreativeForDelivery,\n  type CanonicalCreativeAsset,\n  type CreativeFormatWireMode,\n  type LegacyCreativeAsset,\n} from '../v2/projection/creative-delivery';\nimport type { LegacyFormatConverter } from '../v2/projection/v1-to-v2';\nimport type { CanonicalFormatLegacyResolver } from '../v2/projection/v2-to-v1';\nimport { resolveCanonicalFormatKind } from '../v2/projection/v1-to-v2';\n\n/**\n * Package-like input accepted by `inlineCreativesForPackages`.\n *\n * `PackageRequest` is the create-media-buy shape. Update-media-buy package\n * patches are narrower but carry the same `package_id` + `creatives` fields,\n * so the helper accepts both without depending on AgentClient.\n */\nexport type InlineCreativePackage = {\n  package_id?: string;\n  buyer_ref?: string;\n  context?: NonNullable<PackageRequest['context']> & { buyer_ref?: string };\n  creatives?: CanonicalCreativeAsset[];\n  format_ids?: never;\n  format_option_refs?: PackageRequest['format_option_refs'];\n  format_kind?: PackageRequest['format_kind'];\n  params?: PackageRequest['params'];\n};\n\n/**\n * Compatibility-only package shape accepted by\n * `inlineCreativesForPackagesLegacy`.\n *\n * @deprecated Legacy `format_ids` belong at an explicit compatibility\n * boundary. Prefer `InlineCreativePackage` and canonical format selectors.\n */\nexport type LegacyInlineCreativePackage = Omit<InlineCreativePackage, 'creatives' | 'format_ids'> & {\n  creatives?: CreativeAsset[];\n  format_ids?: PackageRequest['format_ids'];\n};\n\n/**\n * Assignment shape shared with `sync_creatives.assignments[]`, plus\n * `placement_refs` for callers already authoring the structured placement\n * form accepted by inline `CreativeAsset`.\n */\nexport interface InlineCreativeAssignment {\n  creative_id: string;\n  package_id: string;\n  weight?: number;\n  placement_ids?: string[];\n  placement_refs?: unknown[];\n}\n\ninterface InlineCreativesForPackagesBaseOptions<TPackage> {\n  /**\n   * Package-scoped assignment instructions. When supplied, only creatives\n   * assigned to each package are inlined unless `includeUnassignedCreatives`\n   * is true.\n   */\n  assignments?: ReadonlyArray<InlineCreativeAssignment>;\n\n  /**\n   * Include compatible creatives that have no assignment entry. Defaults to\n   * false when assignments are supplied and true when no assignments exist.\n   */\n  includeUnassignedCreatives?: boolean;\n\n  /**\n   * Filter creatives by package format selectors (`format_option_refs` or\n   * `format_kind`). The legacy helper also recognizes `format_ids`. Defaults\n   * to true.\n   */\n  filterByFormat?: boolean;\n\n  /**\n   * Resolve the package identifier used to match assignment.package_id.\n   * Defaults to `package_id`, then `context.buyer_ref`, then `buyer_ref`.\n   */\n  packageId?: (pkg: TPackage, index: number) => string | undefined;\n\n  /**\n   * Behavior when an assignment names a package not present in the package\n   * list. Defaults to throw so package scoping mistakes do not broaden\n   * delivery silently.\n   */\n  onUnmatchedAssignment?: 'throw' | 'ignore';\n\n  /**\n   * Behavior when an assignment names a creative not present in `creatives`.\n   * Defaults to throw because inline payloads cannot reference library-only\n   * creatives.\n   */\n  onMissingCreative?: 'throw' | 'ignore';\n\n  /**\n   * Behavior when an explicit assignment names a creative whose format cannot\n   * satisfy the target package selectors. Defaults to throw so authoring\n   * mistakes do not silently remove assigned delivery.\n   */\n  onIncompatibleAssignment?: 'throw' | 'ignore';\n}\n\nexport interface InlineCreativesForPackagesOptions<\n  TPackage extends InlineCreativePackage = InlineCreativePackage,\n> extends InlineCreativesForPackagesBaseOptions<TPackage> {}\n\n/**\n * Options for the explicit legacy inline-creative compatibility helper.\n *\n * @deprecated Prefer canonical selectors and `inlineCreativesForPackages`.\n */\nexport interface InlineCreativesForPackagesLegacyOptions<\n  TPackage extends LegacyInlineCreativePackage = LegacyInlineCreativePackage,\n> extends InlineCreativesForPackagesBaseOptions<TPackage> {\n  /** Fail closed when the seller's legacy wire shape is not known. */\n  creativeFormatWireMode?: 'legacy' | 'unknown';\n\n  /** Convert custom legacy creative refs before matching/projecting. */\n  legacyFormatConverter?: LegacyFormatConverter;\n\n  /** Resolve canonical custom formats when no built-in or private legacy mapping exists. */\n  canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;\n}\n\nexport type InlineCreativePackagePatch<\n  TPackage extends InlineCreativePackage | LegacyInlineCreativePackage = InlineCreativePackage,\n  TCreative = CanonicalCreativeAsset,\n> = Omit<TPackage, 'creatives'> & {\n  creatives?: TCreative[];\n};\n\n/**\n * Project library-scoped creative assets into package-scoped inline creative\n * payloads for `create_media_buy` or `update_media_buy`.\n *\n * The helper is pure: it performs no network calls, does not call\n * `sync_creatives`, and does not generate idempotency keys. Use\n * `supportsSyncCreatives(caps)` to decide whether the seller has a creative\n * library. When it does not, spread this helper's result into\n * `packages[].creatives` and use a fresh idempotency key for the enclosing\n * create/update media-buy call.\n *\n * @example\n * ```ts\n * const caps = await agent.getCapabilities();\n * if (supportsSyncCreatives(caps)) {\n *   await agent.syncCreatives({ account, creatives, assignments });\n * } else if (caps.features.inlineCreativeManagement) {\n *   await agent.createMediaBuy({\n *     account,\n *     idempotency_key: crypto.randomUUID(),\n *     packages: inlineCreativesForPackages(packages, creatives, { assignments }),\n *   });\n * } else {\n *   throw new Error('Seller supports neither creative library sync nor inline creative uploads.');\n * }\n * ```\n */\nexport function inlineCreativesForPackages<TPackage extends InlineCreativePackage>(\n  packages: ReadonlyArray<TPackage>,\n  creatives: ReadonlyArray<CanonicalCreativeAsset>,\n  options: InlineCreativesForPackagesOptions<TPackage> = {}\n): InlineCreativePackagePatch<TPackage, CanonicalCreativeAsset>[] {\n  assertCanonicalInlineInputs(packages, creatives, options);\n  return inlineCreativesForPackagesInternal(packages, creatives, options, 'canonical') as InlineCreativePackagePatch<\n    TPackage,\n    CanonicalCreativeAsset\n  >[];\n}\n\n/**\n * Project creatives into the legacy inline package wire shape.\n *\n * @deprecated This is an explicit compatibility escape hatch for legacy\n * sellers. New integrations should use canonical package selectors with\n * `inlineCreativesForPackages`; the SDK client performs negotiated wire\n * projection at the transport boundary.\n */\nexport function inlineCreativesForPackagesLegacy<TPackage extends LegacyInlineCreativePackage>(\n  packages: ReadonlyArray<TPackage>,\n  creatives: ReadonlyArray<CreativeAsset>,\n  options: InlineCreativesForPackagesLegacyOptions<TPackage> = {}\n): InlineCreativePackagePatch<TPackage, LegacyCreativeAsset>[] {\n  const { creativeFormatWireMode = 'legacy', ...sharedOptions } = options;\n  return inlineCreativesForPackagesInternal(\n    packages,\n    creatives,\n    {\n      ...sharedOptions,\n      legacyFormatConverter: options.legacyFormatConverter,\n      canonicalFormatLegacyResolver: options.canonicalFormatLegacyResolver,\n    },\n    creativeFormatWireMode\n  ) as InlineCreativePackagePatch<TPackage, LegacyCreativeAsset>[];\n}\n\ntype InternalInlineCreativesOptions<TPackage extends LegacyInlineCreativePackage> =\n  InlineCreativesForPackagesBaseOptions<TPackage> & {\n    legacyFormatConverter?: LegacyFormatConverter;\n    canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;\n  };\n\nfunction inlineCreativesForPackagesInternal<TPackage extends LegacyInlineCreativePackage>(\n  packages: ReadonlyArray<TPackage>,\n  creatives: ReadonlyArray<CreativeAsset>,\n  options: InternalInlineCreativesOptions<TPackage>,\n  creativeFormatWireMode: CreativeFormatWireMode\n): InlineCreativePackagePatch<TPackage, CreativeAsset>[] {\n  const {\n    assignments,\n    includeUnassignedCreatives = assignments == null || assignments.length === 0,\n    filterByFormat = true,\n    packageId = defaultPackageId,\n    onUnmatchedAssignment = 'throw',\n    onMissingCreative = 'throw',\n    onIncompatibleAssignment = 'throw',\n    legacyFormatConverter,\n    canonicalFormatLegacyResolver,\n  } = options;\n\n  const creativesById = new Map<string, CreativeAsset>();\n  for (const creative of creatives) {\n    if (typeof creative.creative_id === 'string') {\n      creativesById.set(creative.creative_id, creative);\n    }\n  }\n\n  const assignmentsByPackage = new Map<string, InlineCreativeAssignment[]>();\n  const matchedPackageIds = new Set<string>();\n  for (const assignment of assignments ?? []) {\n    const creative = creativesById.get(assignment.creative_id);\n    if (!creative) {\n      if (onMissingCreative === 'throw') {\n        throw new Error(\n          `inlineCreativesForPackages assignment references unknown creative_id \"${assignment.creative_id}\"`\n        );\n      }\n      continue;\n    }\n    const existing = assignmentsByPackage.get(assignment.package_id);\n    if (existing) {\n      existing.push(assignment);\n    } else {\n      assignmentsByPackage.set(assignment.package_id, [assignment]);\n    }\n  }\n\n  const result = packages.map((pkg, index) => {\n    const id = packageId(pkg, index);\n    if (id) matchedPackageIds.add(id);\n    const assigned = id ? (assignmentsByPackage.get(id) ?? []) : [];\n    const assignedCreativeIds = new Set(assigned.map(a => a.creative_id));\n    const inlined: CreativeAsset[] = [];\n\n    for (const assignment of assigned) {\n      const creative = creativesById.get(assignment.creative_id);\n      if (!creative) continue;\n      const sourceCompatible = !filterByFormat || creativeMatchesPackage(pkg, creative);\n      if (!sourceCompatible) {\n        if (onIncompatibleAssignment === 'throw') {\n          throw new Error(\n            `inlineCreativesForPackages assignment creative_id \"${assignment.creative_id}\" ` +\n              `does not match package_id \"${assignment.package_id}\" format selectors`\n          );\n        }\n        continue;\n      }\n      const projected = projectCreativeForDelivery(\n        creative,\n        pkg,\n        creativeFormatWireMode,\n        'inline_creatives',\n        legacyFormatConverter,\n        canonicalFormatLegacyResolver\n      );\n      const compatible = !filterByFormat || creativeMatchesPackage(pkg, projected);\n      if (compatible) {\n        inlined.push(applyAssignmentToCreative(projected, assignment));\n      } else if (onIncompatibleAssignment === 'throw') {\n        throw new Error(\n          `inlineCreativesForPackages assignment creative_id \"${assignment.creative_id}\" ` +\n            `does not match package_id \"${assignment.package_id}\" format selectors`\n        );\n      }\n    }\n\n    if (includeUnassignedCreatives) {\n      for (const creative of creatives) {\n        if (typeof creative.creative_id === 'string' && assignedCreativeIds.has(creative.creative_id)) continue;\n        if (filterByFormat && !creativeMatchesPackage(pkg, creative)) continue;\n        const projected = projectCreativeForDelivery(\n          creative,\n          pkg,\n          creativeFormatWireMode,\n          'inline_creatives',\n          legacyFormatConverter,\n          canonicalFormatLegacyResolver\n        );\n        if (!filterByFormat || creativeMatchesPackage(pkg, projected)) {\n          inlined.push({ ...projected });\n        }\n      }\n    }\n\n    const next: Record<string, unknown> = { ...(pkg as Record<string, unknown>) };\n    delete next.creatives;\n    if (inlined.length > 0) {\n      next.creatives = inlined;\n    }\n    return next as InlineCreativePackagePatch<TPackage, CreativeAsset>;\n  });\n\n  if (onUnmatchedAssignment === 'throw') {\n    const unmatched = [...assignmentsByPackage.keys()].filter(package_id => !matchedPackageIds.has(package_id));\n    if (unmatched.length > 0) {\n      throw new Error(`inlineCreativesForPackages assignment references unknown package_id \"${unmatched[0]}\"`);\n    }\n  }\n\n  return result;\n}\n\nfunction assertCanonicalInlineInputs(\n  packages: ReadonlyArray<InlineCreativePackage>,\n  creatives: ReadonlyArray<CanonicalCreativeAsset>,\n  options: object\n): void {\n  const unsafeOptions = options as Record<string, unknown>;\n  if (\n    'creativeFormatWireMode' in unsafeOptions ||\n    'legacyFormatConverter' in unsafeOptions ||\n    'canonicalFormatLegacyResolver' in unsafeOptions\n  ) {\n    throw new Error(\n      'inlineCreativesForPackages is canonical-only; use inlineCreativesForPackagesLegacy for legacy wire projection'\n    );\n  }\n\n  for (const pkg of packages) {\n    if ('format_ids' in (pkg as object)) {\n      throw new Error(\n        'inlineCreativesForPackages does not accept legacy package format_ids; use canonical format selectors or inlineCreativesForPackagesLegacy'\n      );\n    }\n  }\n\n  for (const creative of creatives) {\n    if ('format_id' in (creative as object)) {\n      throw new Error(\n        'inlineCreativesForPackages does not accept legacy creative format_id; use canonical format_kind or inlineCreativesForPackagesLegacy'\n      );\n    }\n  }\n}\n\nfunction defaultPackageId(pkg: LegacyInlineCreativePackage): string | undefined {\n  if (typeof pkg.package_id === 'string') return pkg.package_id;\n  if (typeof pkg.context?.buyer_ref === 'string') return pkg.context.buyer_ref;\n  if (typeof pkg.buyer_ref === 'string') return pkg.buyer_ref;\n  return undefined;\n}\n\nfunction applyAssignmentToCreative(creative: CreativeAsset, assignment: InlineCreativeAssignment): CreativeAsset {\n  const next: Record<string, unknown> = { ...(creative as unknown as Record<string, unknown>) };\n  delete next.weight;\n  delete next.placement_ids;\n  delete next.placement_refs;\n\n  if (assignment.weight !== undefined) next.weight = assignment.weight;\n  if (assignment.placement_refs !== undefined) {\n    next.placement_refs = [...assignment.placement_refs];\n  } else if (assignment.placement_ids !== undefined) {\n    next.placement_ids = [...assignment.placement_ids];\n  }\n  return next as unknown as CreativeAsset;\n}\n\nfunction creativeMatchesPackage(pkg: LegacyInlineCreativePackage, creative: CreativeAsset): boolean {\n  const packageFormatIds = arrayOfObjects(pkg.format_ids);\n  const packageFormatOptionRefs = arrayOfObjects(pkg.format_option_refs);\n  const packageFormatKind = typeof pkg.format_kind === 'string' ? pkg.format_kind : undefined;\n  const packageParams = plainObject(pkg.params);\n\n  const creativeRecord = creative as unknown as Record<string, unknown>;\n  const creativeFormatId = plainObject(creativeRecord.format_id);\n  const creativeFormatOptionRef = plainObject(creativeRecord.format_option_ref);\n\n  if (packageFormatOptionRefs.length > 0) {\n    if (creativeFormatOptionRef) {\n      return packageFormatOptionRefs.some(formatOptionRef => deepEqual(formatOptionRef, creativeFormatOptionRef));\n    }\n    if (packageFormatIds.length === 0 && packageFormatKind === undefined) return false;\n  }\n\n  if (packageFormatKind !== undefined) {\n    return (\n      creativeRecord.format_kind === packageFormatKind &&\n      paramsMatchCreative(packageParams, creativeFormatId ?? creativeParamsFromAssets(creativeRecord.assets))\n    );\n  }\n\n  if (packageFormatIds.length > 0) {\n    if (creativeFormatId !== undefined) {\n      return packageFormatIds.some(formatId => formatIdMatches(formatId, creativeFormatId));\n    }\n    return packageFormatIds.some(\n      formatId =>\n        typeof formatId.id === 'string' &&\n        resolveCanonicalFormatKind(formatId.id, {\n          agentUrl: typeof formatId.agent_url === 'string' ? formatId.agent_url : undefined,\n        }) === creativeRecord.format_kind\n    );\n  }\n\n  return true;\n}\n\nfunction creativeParamsFromAssets(value: unknown): Record<string, unknown> | undefined {\n  const assets = plainObject(value);\n  if (!assets) return undefined;\n  for (const assetValue of Object.values(assets)) {\n    const candidates = Array.isArray(assetValue) ? assetValue : [assetValue];\n    for (const candidate of candidates) {\n      const asset = plainObject(candidate);\n      if (!asset) continue;\n      const params: Record<string, unknown> = {};\n      if (typeof asset.width === 'number') params.width = asset.width;\n      if (typeof asset.height === 'number') params.height = asset.height;\n      if (typeof asset.duration_ms === 'number') params.duration_ms = asset.duration_ms;\n      if (Object.keys(params).length > 0) return params;\n    }\n  }\n  return undefined;\n}\n\nfunction arrayOfObjects(value: unknown): Record<string, unknown>[] {\n  return Array.isArray(value) ? value.flatMap(item => (plainObject(item) ? [item] : [])) : [];\n}\n\nfunction plainObject(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction formatIdMatches(expected: Record<string, unknown>, actual: Record<string, unknown>): boolean {\n  const expectedId = expected.id;\n  const actualId = actual.id;\n  if (expectedId !== actualId) return false;\n\n  const expectedAgentUrl = normalizeAgentUrl(expected.agent_url);\n  const actualAgentUrl = normalizeAgentUrl(actual.agent_url);\n  if (expectedAgentUrl !== undefined && actualAgentUrl !== undefined && expectedAgentUrl !== actualAgentUrl) {\n    return false;\n  }\n\n  for (const key of ['width', 'height', 'duration_ms']) {\n    if (expected[key] !== undefined && actual[key] !== undefined && expected[key] !== actual[key]) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction paramsMatchCreative(\n  packageParams: Record<string, unknown> | undefined,\n  creativeFormatId: Record<string, unknown> | undefined\n): boolean {\n  if (!packageParams) return true;\n\n  let constrained = false;\n  const actualWidth = numberValue(creativeFormatId, 'width');\n  const actualHeight = numberValue(creativeFormatId, 'height');\n  const actualDuration =\n    numberValue(creativeFormatId, 'duration_ms') ?? numberValue(creativeFormatId, 'duration_ms_exact');\n\n  const sizes = Array.isArray(packageParams.sizes)\n    ? packageParams.sizes.flatMap(size => (plainObject(size) ? [size] : []))\n    : [];\n  if (sizes.length > 0) {\n    constrained = true;\n    if (\n      actualWidth === undefined ||\n      actualHeight === undefined ||\n      !sizes.some(size => numberValue(size, 'width') === actualWidth && numberValue(size, 'height') === actualHeight)\n    ) {\n      return false;\n    }\n  }\n\n  const expectedWidth = numberValue(packageParams, 'width');\n  if (expectedWidth !== undefined) {\n    constrained = true;\n    if (actualWidth !== expectedWidth) return false;\n  }\n\n  const expectedHeight = numberValue(packageParams, 'height');\n  if (expectedHeight !== undefined) {\n    constrained = true;\n    if (actualHeight !== expectedHeight) return false;\n  }\n\n  const minWidth = numberValue(packageParams, 'min_width');\n  if (minWidth !== undefined) {\n    constrained = true;\n    if (actualWidth === undefined || actualWidth < minWidth) return false;\n  }\n\n  const maxWidth = numberValue(packageParams, 'max_width');\n  if (maxWidth !== undefined) {\n    constrained = true;\n    if (actualWidth === undefined || actualWidth > maxWidth) return false;\n  }\n\n  const minHeight = numberValue(packageParams, 'min_height');\n  if (minHeight !== undefined) {\n    constrained = true;\n    if (actualHeight === undefined || actualHeight < minHeight) return false;\n  }\n\n  const maxHeight = numberValue(packageParams, 'max_height');\n  if (maxHeight !== undefined) {\n    constrained = true;\n    if (actualHeight === undefined || actualHeight > maxHeight) return false;\n  }\n\n  const exactDuration = numberValue(packageParams, 'duration_ms_exact') ?? numberValue(packageParams, 'duration_ms');\n  if (exactDuration !== undefined) {\n    constrained = true;\n    if (actualDuration !== exactDuration) return false;\n  }\n\n  const durationRange = numberRange(packageParams.duration_ms_range);\n  if (durationRange) {\n    constrained = true;\n    const [minDuration, maxDuration] = durationRange;\n    if (actualDuration === undefined) return false;\n    if (minDuration !== undefined && actualDuration < minDuration) return false;\n    if (maxDuration !== undefined && actualDuration > maxDuration) return false;\n  }\n\n  return constrained ? creativeFormatId !== undefined : true;\n}\n\nfunction numberValue(object: Record<string, unknown> | undefined, key: string): number | undefined {\n  const value = object?.[key];\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction numberRange(value: unknown): [number | undefined, number | undefined] | undefined {\n  if (!Array.isArray(value) || value.length !== 2) return undefined;\n  const [min, max] = value;\n  const minValue = min === null ? undefined : typeof min === 'number' && Number.isFinite(min) ? min : undefined;\n  const maxValue = max === null ? undefined : typeof max === 'number' && Number.isFinite(max) ? max : undefined;\n  return minValue === undefined && maxValue === undefined ? undefined : [minValue, maxValue];\n}\n\nfunction normalizeAgentUrl(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return end === value.length ? value : value.slice(0, end);\n}\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  return JSON.stringify(sortKeys(a)) === JSON.stringify(sortKeys(b));\n}\n\nfunction sortKeys(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(sortKeys);\n  const object = plainObject(value);\n  if (!object) return value;\n  return Object.fromEntries(\n    Object.entries(object)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => [k, sortKeys(v)])\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/lib/utils/format-assets.d.mts

@@ -1,34 +1,38 @@
-import type { Format } from '../types/tools.generated.mjs';
-type FormatAsset = NonNullable<Format['assets']>[number];
-type IndividualAsset = Extract<FormatAsset, {
-    item_type: 'individual';
-}>;
-type RepeatableAssetGroup = Extract<FormatAsset, {
-    item_type: 'repeatable_group';
-}>;
+import type { IndividualAudioAsset, IndividualBriefAsset, IndividualCatalogAsset, IndividualCssAsset, IndividualDaastAsset, IndividualHtmlAsset, IndividualImageAsset, IndividualJavaScriptAsset, IndividualMarkdownAsset, IndividualTextAsset, IndividualUrlAsset, IndividualVastAsset, IndividualVideoAsset, IndividualWebhookAsset, RepeatableGroupAsset } from '../types/tools.generated.mjs';
+/** Canonical structural union for the slots declared in an `assets` array. */
+export type CanonicalFormatAssetSlot = IndividualAudioAsset | IndividualBriefAsset | IndividualCatalogAsset | IndividualCssAsset | IndividualDaastAsset | IndividualHtmlAsset | IndividualImageAsset | IndividualJavaScriptAsset | IndividualMarkdownAsset | IndividualTextAsset | IndividualUrlAsset | IndividualVastAsset | IndividualVideoAsset | IndividualWebhookAsset | RepeatableGroupAsset;
+export type IndividualFormatAssetSlot = Exclude<CanonicalFormatAssetSlot, RepeatableGroupAsset>;
+export type RepeatableFormatAssetGroup = RepeatableGroupAsset;
 /**
- * Get assets from a Format
+ * Minimal structural input for asset inspection. It deliberately has no
+ * `format_id`, `agent_url`, name, or other legacy catalog identity.
+ */
+export interface FormatAssetsInput {
+    assets?: CanonicalFormatAssetSlot[];
+    /** Deprecated v2 compatibility field; values are normalized as required slots. */
+    assets_required?: unknown[];
+}
+/**
+ * Get asset slots from any structural asset container.
  *
  * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,
  * this function also handles the deprecated `assets_required` field if present.
  *
- * @param format - The Format object from list_creative_formats response
+ * @param format - An object containing canonical `assets` slots
  * @returns Array of assets
  *
  * @example
  * ```typescript
- * const formats = await agent.listCreativeFormats({});
- * for (const format of formats.formats) {
- *   const assets = getFormatAssets(format);
- *   console.log(`${format.name} has ${assets.length} assets`);
- * }
+ * const assets = getFormatAssets({
+ *   assets: [FormatAsset.image({ asset_id: 'hero', required: true })]
+ * });
  * ```
  */
-export declare function getFormatAssets(format: Format): FormatAsset[];
+export declare function getFormatAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get only required assets from a Format
+ * Get only required slots from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of required assets only
  *
  * @example
@@ -37,14 +41,14 @@ export declare function getFormatAssets(format: Format): FormatAsset[];
  * console.log(`Must provide ${requiredAssets.length} assets`);
  * ```
  */
-export declare function getRequiredAssets(format: Format): FormatAsset[];
+export declare function getRequiredAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get only optional assets from a Format
+ * Get only optional slots from an asset container.
  *
  * Note: When using deprecated `assets_required`, this will always return empty
  * since assets_required only contained required assets.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of optional assets only
  *
  * @example
@@ -53,47 +57,46 @@ export declare function getRequiredAssets(format: Format): FormatAsset[];
  * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);
  * ```
  */
-export declare function getOptionalAssets(format: Format): FormatAsset[];
+export declare function getOptionalAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get individual assets (not repeatable groups) from a Format
+ * Get individual slots (not repeatable groups) from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of individual assets
  */
-export declare function getIndividualAssets(format: Format): IndividualAsset[];
+export declare function getIndividualAssets(format: FormatAssetsInput): IndividualFormatAssetSlot[];
 /**
- * Get repeatable asset groups from a Format
+ * Get repeatable asset groups from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of repeatable asset groups
  */
-export declare function getRepeatableGroups(format: Format): RepeatableAssetGroup[];
+export declare function getRepeatableGroups(format: FormatAssetsInput): RepeatableFormatAssetGroup[];
 /**
  * Check if format uses deprecated assets_required field (for migration warnings)
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns true if using deprecated field, false if using new field or neither
  *
  * @example
  * ```typescript
  * if (usesDeprecatedAssetsField(format)) {
- *   console.warn(`Format ${format.name} uses deprecated assets_required field`);
+ *   console.warn('Asset container uses deprecated assets_required field');
  * }
  * ```
  */
-export declare function usesDeprecatedAssetsField(format: Format): boolean;
+export declare function usesDeprecatedAssetsField(format: FormatAssetsInput): boolean;
 /**
- * Get the count of assets in a format (for display purposes)
+ * Get the count of slots in an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Number of assets, or 0 if none defined
  */
-export declare function getAssetCount(format: Format): number;
+export declare function getAssetCount(format: FormatAssetsInput): number;
 /**
- * Check if a format has any assets defined
+ * Check if an asset container has any slots defined.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns true if format has assets, false otherwise
  */
-export declare function hasAssets(format: Format): boolean;
-export {};
+export declare function hasAssets(format: FormatAssetsInput): boolean;

package/dist/lib/utils/format-assets.d.ts

@@ -1,34 +1,38 @@
-import type { Format } from '../types/tools.generated';
-type FormatAsset = NonNullable<Format['assets']>[number];
-type IndividualAsset = Extract<FormatAsset, {
-    item_type: 'individual';
-}>;
-type RepeatableAssetGroup = Extract<FormatAsset, {
-    item_type: 'repeatable_group';
-}>;
+import type { IndividualAudioAsset, IndividualBriefAsset, IndividualCatalogAsset, IndividualCssAsset, IndividualDaastAsset, IndividualHtmlAsset, IndividualImageAsset, IndividualJavaScriptAsset, IndividualMarkdownAsset, IndividualTextAsset, IndividualUrlAsset, IndividualVastAsset, IndividualVideoAsset, IndividualWebhookAsset, RepeatableGroupAsset } from '../types/tools.generated';
+/** Canonical structural union for the slots declared in an `assets` array. */
+export type CanonicalFormatAssetSlot = IndividualAudioAsset | IndividualBriefAsset | IndividualCatalogAsset | IndividualCssAsset | IndividualDaastAsset | IndividualHtmlAsset | IndividualImageAsset | IndividualJavaScriptAsset | IndividualMarkdownAsset | IndividualTextAsset | IndividualUrlAsset | IndividualVastAsset | IndividualVideoAsset | IndividualWebhookAsset | RepeatableGroupAsset;
+export type IndividualFormatAssetSlot = Exclude<CanonicalFormatAssetSlot, RepeatableGroupAsset>;
+export type RepeatableFormatAssetGroup = RepeatableGroupAsset;
 /**
- * Get assets from a Format
+ * Minimal structural input for asset inspection. It deliberately has no
+ * `format_id`, `agent_url`, name, or other legacy catalog identity.
+ */
+export interface FormatAssetsInput {
+    assets?: CanonicalFormatAssetSlot[];
+    /** Deprecated v2 compatibility field; values are normalized as required slots. */
+    assets_required?: unknown[];
+}
+/**
+ * Get asset slots from any structural asset container.
  *
  * Returns the assets from the v3 `assets` field. For backward compatibility with v2 servers,
  * this function also handles the deprecated `assets_required` field if present.
  *
- * @param format - The Format object from list_creative_formats response
+ * @param format - An object containing canonical `assets` slots
  * @returns Array of assets
  *
  * @example
  * ```typescript
- * const formats = await agent.listCreativeFormats({});
- * for (const format of formats.formats) {
- *   const assets = getFormatAssets(format);
- *   console.log(`${format.name} has ${assets.length} assets`);
- * }
+ * const assets = getFormatAssets({
+ *   assets: [FormatAsset.image({ asset_id: 'hero', required: true })]
+ * });
  * ```
  */
-export declare function getFormatAssets(format: Format): FormatAsset[];
+export declare function getFormatAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get only required assets from a Format
+ * Get only required slots from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of required assets only
  *
  * @example
@@ -37,14 +41,14 @@ export declare function getFormatAssets(format: Format): FormatAsset[];
  * console.log(`Must provide ${requiredAssets.length} assets`);
  * ```
  */
-export declare function getRequiredAssets(format: Format): FormatAsset[];
+export declare function getRequiredAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get only optional assets from a Format
+ * Get only optional slots from an asset container.
  *
  * Note: When using deprecated `assets_required`, this will always return empty
  * since assets_required only contained required assets.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of optional assets only
  *
  * @example
@@ -53,48 +57,47 @@ export declare function getRequiredAssets(format: Format): FormatAsset[];
  * console.log(`Can optionally provide ${optionalAssets.length} additional assets`);
  * ```
  */
-export declare function getOptionalAssets(format: Format): FormatAsset[];
+export declare function getOptionalAssets(format: FormatAssetsInput): CanonicalFormatAssetSlot[];
 /**
- * Get individual assets (not repeatable groups) from a Format
+ * Get individual slots (not repeatable groups) from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of individual assets
  */
-export declare function getIndividualAssets(format: Format): IndividualAsset[];
+export declare function getIndividualAssets(format: FormatAssetsInput): IndividualFormatAssetSlot[];
 /**
- * Get repeatable asset groups from a Format
+ * Get repeatable asset groups from an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Array of repeatable asset groups
  */
-export declare function getRepeatableGroups(format: Format): RepeatableAssetGroup[];
+export declare function getRepeatableGroups(format: FormatAssetsInput): RepeatableFormatAssetGroup[];
 /**
  * Check if format uses deprecated assets_required field (for migration warnings)
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns true if using deprecated field, false if using new field or neither
  *
  * @example
  * ```typescript
  * if (usesDeprecatedAssetsField(format)) {
- *   console.warn(`Format ${format.name} uses deprecated assets_required field`);
+ *   console.warn('Asset container uses deprecated assets_required field');
  * }
  * ```
  */
-export declare function usesDeprecatedAssetsField(format: Format): boolean;
+export declare function usesDeprecatedAssetsField(format: FormatAssetsInput): boolean;
 /**
- * Get the count of assets in a format (for display purposes)
+ * Get the count of slots in an asset container.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns Number of assets, or 0 if none defined
  */
-export declare function getAssetCount(format: Format): number;
+export declare function getAssetCount(format: FormatAssetsInput): number;
 /**
- * Check if a format has any assets defined
+ * Check if an asset container has any slots defined.
  *
- * @param format - The Format object
+ * @param format - A structural asset container
  * @returns true if format has assets, false otherwise
  */
-export declare function hasAssets(format: Format): boolean;
-export {};
+export declare function hasAssets(format: FormatAssetsInput): boolean;
 //# sourceMappingURL=format-assets.d.ts.map

package/dist/lib/utils/format-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-assets.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGvD,KAAK,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,KAAK,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AACzE,KAAK,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,SAAS,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAQpF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAiB7D;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAI1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD"}
+{"version":3,"file":"format-assets.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/format-assets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,8EAA8E;AAC9E,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC;AAChG,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpC,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,wBAAwB,EAAE,CAiBrF;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,wBAAwB,EAAE,CAEvF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,wBAAwB,EAAE,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,EAAE,CAI1F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,0BAA0B,EAAE,CAI3F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAG5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAE5D"}

package/dist/lib/utils/format-assets.js

@@ -52,7 +52,9 @@ function getOptionalAssets(format) {
   return getFormatAssets(format).filter((asset) => !asset.required);
 }
 function getIndividualAssets(format) {
-  return getFormatAssets(format).filter((asset) => asset.item_type === "individual");
+  return getFormatAssets(format).filter(
+    (asset) => asset.item_type === "individual"
+  );
 }
 function getRepeatableGroups(format) {
   return getFormatAssets(format).filter(