@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/server/decisioning/index.mjs

@@ -54,8 +54,11 @@ import {
   createSelfSignedTenantKey,
   createNoopJwksValidator
 } from "./tenant-registry.mjs";
-import { getAsset, requireAsset } from "./manifest-helpers.mjs";
-import { buildListCreativesResponse } from "./list-helpers.mjs";
+import { getAsset, getAssetSlot, requireAsset } from "./manifest-helpers.mjs";
+import {
+  buildListCreativesResponse,
+  buildListCreativesResponseLegacy
+} from "./list-helpers.mjs";
 import { resolveStartTime } from "./start-time.mjs";
 import {
   createTenantAdminRouter,
@@ -96,7 +99,7 @@ import {
   releaseProposalReservation,
   maybeHydrateRecipesForMediaBuyId
 } from "./proposal/index.mjs";
-import { buildProduct, buildPricingOption, buildPackage } from "./assembly-helpers.mjs";
+import { buildProduct, buildProductLegacy, buildPricingOption, buildPackage } from "./assembly-helpers.mjs";
 export {
   AccountNotFoundError,
   AdcpError,
@@ -128,9 +131,11 @@ export {
   UnsupportedFeatureError,
   batchPoll,
   buildListCreativesResponse,
+  buildListCreativesResponseLegacy,
   buildPackage,
   buildPricingOption,
   buildProduct,
+  buildProductLegacy,
   composeMethod,
   createAdcpServerFromPlatform,
   createDefaultJwksValidator,
@@ -163,6 +168,7 @@ export {
   finalizeProposalConsumption,
   getAllAdcpMigrations,
   getAsset,
+  getAssetSlot,
   getDecisioningTaskRegistryMigration,
   getStatusChangeBus,
   identityStatusMappers,

package/dist/lib/server/decisioning/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/index.ts"],"sourcesContent":["/**\n * DecisioningPlatform v1.0 — preview surface for the v6.0 architecture.\n *\n * Status: PREVIEW. Types only; not yet wired into the framework. Subject\n * to change before 6.0 ships. Don't build production adapters against this\n * yet — the framework still routes through the v5.x handler-style API.\n *\n * Design proposal: `.context/proposals/specialism-platform-interfaces-v3.md`\n *\n * @packageDocumentation\n */\n\n// Adopter-facing structured-error primitive.\n//\n// `AdcpError` is the canonical throwable for structured rejection. Specialism\n// methods return plain `T` for success or `throw new AdcpError(...)` to project\n// to the wire `adcp_error` envelope.\n//\n// HITL is expressed in the type system via the dual-method shape on each\n// spec-HITL tool (`xxx` for sync, `xxxTask` for HITL). No adopter-facing\n// task primitives — the framework owns task lifecycle and dispatches the\n// `*Task` method in the background.\nexport { type AdcpStructuredError, type ErrorCode, AdcpError } from './async-outcome';\nexport type { TaskHandoffOptions } from './async-outcome';\nexport type { ServerPayload } from '../../types/server-payload';\n\n// Typed `AdcpError` subclasses — adopter convenience for the highest-traffic\n// error codes. Each class encodes the canonical code/recovery/field shape.\n// LLM-generated platforms get autocomplete on the import; humans skim the\n// list to find the right class. See `errors-typed.ts`.\nexport {\n  PackageNotFoundError,\n  MediaBuyNotFoundError,\n  ProductNotFoundError,\n  CreativeNotFoundError,\n  ProductUnavailableError,\n  CreativeRejectedError,\n  BudgetTooLowError,\n  BudgetExhaustedError,\n  IdempotencyConflictError,\n  InvalidRequestError,\n  InvalidStateError,\n  BackwardsTimeRangeError,\n  AuthMissingError,\n  AuthInvalidError,\n  AuthRequiredError,\n  PermissionDeniedError,\n  RateLimitedError,\n  ServiceUnavailableError,\n  UnsupportedFeatureError,\n  ComplianceUnsatisfiedError,\n  GovernanceDeniedError,\n  PolicyViolationError,\n} from './errors-typed';\n\n// Cursor pagination\nexport type { CursorPage, CursorRequest } from './pagination';\n\n// Status-change event bus — adopter-facing primitive for spec-native\n// lifecycle channels (media_buy / creative / audience / signal / proposal /\n// plan / rights_grant / delivery_report). Module-level so adopters can\n// publish from webhook handlers, crons, in-process workers without holding\n// a server reference.\nexport {\n  publishStatusChange,\n  setStatusChangeBus,\n  getStatusChangeBus,\n  createInMemoryStatusChangeBus,\n  type StatusChange,\n  type StatusChangeBus,\n  type StatusChangeResourceType,\n  type StatusChangeListener,\n  type PublishStatusChangeOpts,\n} from './status-changes';\n\n// Capabilities (single source of truth for get_adcp_capabilities)\nexport type {\n  DecisioningCapabilities,\n  ComplianceTestingCapabilities,\n  CreativeAgentRef,\n  TargetingCapabilities,\n  TargetingPostalAreaSupport,\n  ReportingCapabilities,\n} from './capabilities';\nexport { normalizePostalAreaSupport, normalizeTargetingCapabilities } from './capabilities';\n\n// Account model\nexport type {\n  Account,\n  AuthPrincipal,\n  AccountStore,\n  AccountFilter,\n  ListAccountsPayload,\n  SyncAccountsPayload,\n  SyncAccountsSuccessPayload,\n  SyncAccountsRow,\n  SyncAccountsResultRow,\n  SyncGovernancePayload,\n  SyncGovernanceSuccessPayload,\n  SyncGovernanceRow,\n  ReportUsagePayload,\n  GetAccountFinancialsPayload,\n  GetAccountFinancialsSuccessPayload,\n  ListAccountsHandlerResult,\n  SyncAccountsHandlerResult,\n  SyncGovernanceHandlerResult,\n  ReportUsageHandlerResult,\n  GetAccountFinancialsHandlerResult,\n  AdcpAccountStatus,\n  ResolveContext,\n  AccountToolContext,\n  ResolvedAuthInfo,\n} from './account';\n\nexport { AccountNotFoundError, refAccountId } from './account';\n\n// Multi-tenant AccountStore builder. Bakes in the two-path resolution\n// (operator-routed + auth-derived) and the per-entry tenant-isolation gate\n// that adopters historically had to hand-write — and silently fail to\n// hand-write — on `accounts.upsert` / `accounts.syncGovernance`.\nexport { createTenantStore, narrowAccountRef } from './tenant-store';\nexport type { TenantStoreConfig } from './tenant-store';\n\n// Buyer-agent identity surface — Phase 1 of #1269. Durable commercial\n// relationship records keyed off the request credential. Factory-pattern\n// registry (signing-only / bearer-only / mixed) encodes the implementer\n// posture at construction; framework calls `BuyerAgentRegistry.resolve`\n// once per request before `accounts.resolve`. Phase 1 ships the shape and\n// resolution; framework-level billing-capability enforcement and the\n// AdCP-3.1 error-code emission land in Phase 2 (#1292).\nexport type {\n  BuyerAgent,\n  BuyerAgentBillingMode,\n  BuyerAgentStatus,\n  BuyerAgentRegistry as BuyerAgentRegistryProtocol,\n  BuyerAgentResolveInput,\n  BuyerAgentCacheOptions,\n  CachedBuyerAgentRegistry,\n  AdcpCredential,\n  ResolveBuyerAgentByAgentUrl,\n  ResolveBuyerAgentByCredential,\n} from './buyer-agent';\nexport { BuyerAgentRegistry } from './buyer-agent';\n\n// Native status mapping\nexport type { StatusMappers, AdcpMediaBuyStatus, AdcpCreativeStatus, AdcpPlanStatus } from './status-mappers';\nexport { identityStatusMappers } from './status-mappers';\n\n// Request context (state + resolve)\nexport type {\n  RequestContext,\n  WorkflowStateReader,\n  ResourceResolver,\n  WorkflowObjectType,\n  WorkflowStep,\n  Proposal,\n  GovernanceContextJWS,\n} from './context';\n\n// Top-level platform + compile-time capability enforcement\nexport type { DecisioningPlatform, RequiredPlatformsFor, RequiredCapabilitiesFor } from './platform';\n\n// Method-level composition (closes #1314) — wrap individual platform methods\n// with `before` / `after` hooks for short-circuit + enrichment patterns.\nexport { composeMethod } from './compose';\nexport type { ComposeHooks, ComposeShortCircuit } from './compose';\n\n// `accounts.resolve` security presets (closes #1339) — canonical post-resolve\n// guards that standardize the multi-tenant authorization pattern instead of\n// every adopter rolling their own.\nexport { requireAccountMatch, requireAdvertiserMatch, requireOrgScope } from './resolve-presets';\nexport type { ResolveAccountHooks, ResolveGuardOptions } from './resolve-presets';\n\n// Specialism interfaces (v1.0)\nexport type {\n  CreativeBuilderPlatform,\n  BuildCreativeReturn,\n  BuildCreativePayload,\n  BuildCreativeMultiPayload,\n  PreviewCreativePayload as CreativePreviewCreativePayload,\n  ListCreativeFormatsPayload as CreativeListCreativeFormatsPayload,\n  // Deprecated aliases — kept for one-release source compat. Both\n  // resolve to CreativeBuilderPlatform; see specialisms/creative.ts.\n  CreativeTemplatePlatform,\n  CreativeGenerativePlatform,\n  RefinementMessage,\n  SyncCreativesRow,\n} from './specialisms/creative';\n\nexport type {\n  CreativeAdServerPlatform,\n  BuildCreativeReturn as CreativeAdServerBuildCreativeReturn,\n  BuildCreativePayload as CreativeAdServerBuildCreativePayload,\n  BuildCreativeMultiPayload as CreativeAdServerBuildCreativeMultiPayload,\n  PreviewCreativePayload as CreativeAdServerPreviewCreativePayload,\n  ListCreativeFormatsPayload as CreativeAdServerListCreativeFormatsPayload,\n  ListCreativesPayload as CreativeAdServerListCreativesPayload,\n  GetCreativeDeliveryPayload as CreativeAdServerGetCreativeDeliveryPayload,\n} from './specialisms/creative-ad-server';\n\nexport type {\n  CampaignGovernancePlatform,\n  CheckGovernancePayload,\n  SyncPlansPayload,\n  ReportPlanOutcomePayload,\n  GetPlanAuditLogsPayload,\n} from './specialisms/campaign-governance';\n\nexport type {\n  ContentStandardsPlatform,\n  ListContentStandardsPayload,\n  GetContentStandardsPayload,\n  CreateContentStandardsPayload,\n  UpdateContentStandardsPayload,\n  CalibrateContentPayload,\n  ValidateContentDeliveryPayload,\n  GetMediaBuyArtifactsPayload,\n  GetCreativeFeaturesPayload,\n} from './specialisms/content-standards';\n\nexport type {\n  PropertyListsPlatform,\n  CollectionListsPlatform,\n  CreatePropertyListPayload,\n  UpdatePropertyListPayload,\n  GetPropertyListPayload,\n  ListPropertyListsPayload,\n  DeletePropertyListPayload,\n  CreateCollectionListPayload,\n  UpdateCollectionListPayload,\n  GetCollectionListPayload,\n  ListCollectionListsPayload,\n  DeleteCollectionListPayload,\n} from './specialisms/lists';\n\nexport type {\n  SalesPlatform,\n  SalesCorePlatform,\n  SalesIngestionPlatform,\n  GetProductsPayload,\n  GetProductsHandlerResult,\n  CreateMediaBuyPayload,\n  CreateMediaBuyHandlerResult,\n  UpdateMediaBuyPayload,\n  UpdateMediaBuyHandlerResult,\n  GetMediaBuyDeliveryPayload,\n  GetMediaBuysPayload,\n  ProvidePerformanceFeedbackPayload,\n  ListCreativeFormatsPayload,\n  ListCreativesPayload,\n  SyncCreativesPayload,\n  SyncCreativesHandlerResult,\n  SyncCatalogsPayload,\n  LogEventPayload,\n  SyncEventSourcesPayload,\n} from './specialisms/sales';\n\nexport type {\n  AudiencePlatform,\n  Audience,\n  SyncAudiencesPayload,\n  SyncAudiencesRow,\n  SyncAudiencesHandlerResult,\n  AudienceStatus,\n} from './specialisms/audiences';\n\nexport type {\n  SignalsPlatform,\n  GetSignalsPayload,\n  GetSignalsHandlerResult,\n  ActivateSignalPayload,\n} from './specialisms/signals';\n\nexport type {\n  SponsoredIntelligencePlatform,\n  SIGetOfferingPayload,\n  SIInitiateSessionPayload,\n  SISendMessagePayload,\n  SITerminateSessionPayload,\n} from './specialisms/sponsored-intelligence';\n\nexport type {\n  BrandRightsPlatform,\n  GetBrandIdentityPayload,\n  GetRightsPayload,\n  AcquireRightsAcquiredPayload,\n  AcquireRightsPendingApprovalPayload,\n  AcquireRightsRejectedPayload,\n  AcquireRightsPayload,\n  UpdateRightsPayload,\n  CreativeApprovedPayload,\n  CreativeRejectedPayload,\n  CreativePendingReviewPayload,\n  CreativeApprovalPayload,\n} from './specialisms/brand-rights';\n\n// Brand-rights wire types — re-exported from `@adcp/sdk/server/decisioning`\n// because brand-rights is the only specialism whose wire types live in\n// `core.generated` (not `tools.generated`), and the public `@adcp/sdk/types`\n// barrel doesn't surface them. Adopters typing their own helper functions\n// import these from here, NOT from the deep `core.generated` path.\nexport type {\n  GetBrandIdentityRequest,\n  GetBrandIdentitySuccess,\n  GetRightsRequest,\n  GetRightsSuccess,\n  AcquireRightsRequest,\n  AcquireRightsAcquired,\n  AcquireRightsPendingApproval,\n  AcquireRightsRejected,\n  AcquireRightsError,\n  RightUse,\n  RightType,\n  RightsConstraint,\n  RightsTerms,\n  RightsPricingOption,\n  GenerationCredential,\n} from '../../types/core.generated';\n\n// Runtime (v6.0 alpha) — preview surface for adopters spiking against the\n// new shape. Subject to change before 6.0 GA.\nexport {\n  createAdcpServerFromPlatform,\n  getAllAdcpMigrations,\n  type CreateAdcpServerFromPlatformOptions,\n  type RequiredOptsFor,\n  type DecisioningAdcpServer,\n  type DecisioningObservabilityHooks,\n} from './runtime/from-platform';\nexport { PlatformConfigError, validatePlatform } from './runtime/validate-platform';\nexport {\n  createInMemoryTaskRegistry,\n  type TaskRegistry,\n  type TaskRecord,\n  type TaskStatus,\n} from './runtime/task-registry';\nexport {\n  createPostgresTaskRegistry,\n  getDecisioningTaskRegistryMigration,\n  type CreatePostgresTaskRegistryOptions,\n  type PgQueryable,\n} from './runtime/postgres-task-registry';\n\n// Multi-tenant deployment helper — wraps createAdcpServerFromPlatform with\n// per-tenant config, health states (healthy/unverified/disabled), and JWKS\n// validation. Composes with the existing serve() host-routing surface.\nexport {\n  createTenantRegistry,\n  createDefaultJwksValidator,\n  createSelfSignedTenantKey,\n  createNoopJwksValidator,\n  type TenantRegistry,\n  type TenantConfig,\n  type TenantSigningKey,\n  type TenantStatus,\n  type TenantHealth,\n  type TenantRegistryOptions,\n  type JwksValidator,\n  type JwksValidationResult,\n} from './tenant-registry';\n\n// Manifest helpers — typed accessors for creative_manifest.assets values.\n// Save adopters from writing the same null-check + discriminator-check\n// boilerplate per call.\nexport { getAsset, requireAsset } from './manifest-helpers';\n\n// List helpers — wrap row arrays + pagination into the heavier wire shapes\n// (today: list_creatives, which carries query_summary alongside the rows).\nexport { buildListCreativesResponse, type BuildListCreativesResponseOpts } from './list-helpers';\n\n// Start-time helper — normalize the wire `start_time` union into a Date,\n// with platform-aware ASAP lead-time injection.\nexport { resolveStartTime, type ResolveStartTimeOptions } from './start-time';\n\n// Admin Express router for ops visibility into the TenantRegistry.\n// Mount on a separate port/path with operator auth.\nexport {\n  createTenantAdminRouter,\n  createTenantAdminHandlers,\n  mountTenantAdmin,\n  type TenantAdminHandlers,\n  type RouterLike,\n} from './admin-router';\n\n// Adopter helpers — batchPoll, validationError, upstreamError, RequestShape.\n// All opt-in convenience; nothing in the framework calls these internally.\nexport { batchPoll, validationError, upstreamError } from './helpers';\nexport type { RequestShape } from './helpers';\n\n// Platform identity helpers — fix TypeScript's contextual-typing gap when\n// building a DecisioningPlatform (or sub-interface) as an object literal.\n// Without these, `createAdcpServerFromPlatform({ sales: { syncEventSources:\n// async (req, ctx) => {...} } })` gives `req: unknown` because the generic\n// `P extends DecisioningPlatform<any,any>` is inferred, not declared.\n// Wrapping the sub-object with e.g. `defineSalesPlatform<MyMeta>({...})`\n// forces the concrete type annotation TypeScript needs. The helpers are\n// pure identity functions — zero runtime cost.\nexport {\n  definePlatform,\n  defineSalesPlatform,\n  defineSalesCorePlatform,\n  defineSalesIngestionPlatform,\n  defineAudiencePlatform,\n  defineSignalsPlatform,\n  defineSponsoredIntelligencePlatform,\n  defineCreativeBuilderPlatform,\n  defineCreativeAdServerPlatform,\n  defineCampaignGovernancePlatform,\n  defineContentStandardsPlatform,\n  definePropertyListsPlatform,\n  defineCollectionListsPlatform,\n  defineBrandRightsPlatform,\n  definePlatformWithCompliance,\n} from './platform-helpers';\n\n// ProposalManager — primitives for the two-platform composition (port of\n// adcp-client-python PRs #504 + #550). Splits proposal assembly from\n// media-buy execution; either side can be mock-backed independently.\n// Framework dispatch wiring lands in a follow-up release.\nexport type {\n  ProposalManager,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalState,\n  ProposalRecord,\n  ProposalStore,\n  InMemoryProposalStoreOptions,\n  MockProposalManagerOptions,\n} from './proposal';\nexport {\n  validateProposalCapabilities,\n  InMemoryProposalStore,\n  MockProposalManager,\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './proposal';\nexport type { FinalizeActionRef, ProposalLifecycleLogger, FinalizeInterceptResult, ReservedProposal } from './proposal';\n\n// Wire-shape assembly helpers — emit correct Product / PricingOption /\n// package shapes from intent-shaped input. Reduces 30+ lines of wire\n// boilerplate per resource. Used in slim skill examples so LLMs scaffold\n// correct shapes from first attempt.\nexport { buildProduct, buildPricingOption, buildPackage } from './assembly-helpers';\nexport type { BuildProductInput, BuildPricingOptionInput, BuildPackageInput } from './assembly-helpers';\n"],"mappings":"AAsBA,SAAmD,iBAAiB;AAQpE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AAWP,SAAS,4BAA4B,sCAAsC;AA8B3E,SAAS,sBAAsB,oBAAoB;AAMnD,SAAS,mBAAmB,wBAAwB;AAsBpD,SAAS,0BAA0B;AAInC,SAAS,6BAA6B;AAkBtC,SAAS,qBAAqB;AAM9B,SAAS,qBAAqB,wBAAwB,uBAAuB;AAuJ7E;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP,SAAS,qBAAqB,wBAAwB;AACtD;AAAA,EACE;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OASK;AAKP,SAAS,UAAU,oBAAoB;AAIvC,SAAS,kCAAuE;AAIhF,SAAS,wBAAsD;AAI/D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAIP,SAAS,WAAW,iBAAiB,qBAAqB;AAW1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAOP,SAAS,cAAc,oBAAoB,oBAAoB;","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/index.ts"],"sourcesContent":["/**\n * DecisioningPlatform v1.0 — preview surface for the v6.0 architecture.\n *\n * Status: PREVIEW. Types only; not yet wired into the framework. Subject\n * to change before 6.0 ships. Don't build production adapters against this\n * yet — the framework still routes through the v5.x handler-style API.\n *\n * Design proposal: `.context/proposals/specialism-platform-interfaces-v3.md`\n *\n * @packageDocumentation\n */\n\n// Adopter-facing structured-error primitive.\n//\n// `AdcpError` is the canonical throwable for structured rejection. Specialism\n// methods return plain `T` for success or `throw new AdcpError(...)` to project\n// to the wire `adcp_error` envelope.\n//\n// HITL is expressed in the type system via the dual-method shape on each\n// spec-HITL tool (`xxx` for sync, `xxxTask` for HITL). No adopter-facing\n// task primitives — the framework owns task lifecycle and dispatches the\n// `*Task` method in the background.\nexport { type AdcpStructuredError, type ErrorCode, AdcpError } from './async-outcome';\nexport type { TaskHandoffOptions } from './async-outcome';\nexport type { ServerPayload } from '../../types/server-payload';\n\n// Typed `AdcpError` subclasses — adopter convenience for the highest-traffic\n// error codes. Each class encodes the canonical code/recovery/field shape.\n// LLM-generated platforms get autocomplete on the import; humans skim the\n// list to find the right class. See `errors-typed.ts`.\nexport {\n  PackageNotFoundError,\n  MediaBuyNotFoundError,\n  ProductNotFoundError,\n  CreativeNotFoundError,\n  ProductUnavailableError,\n  CreativeRejectedError,\n  BudgetTooLowError,\n  BudgetExhaustedError,\n  IdempotencyConflictError,\n  InvalidRequestError,\n  InvalidStateError,\n  BackwardsTimeRangeError,\n  AuthMissingError,\n  AuthInvalidError,\n  AuthRequiredError,\n  PermissionDeniedError,\n  RateLimitedError,\n  ServiceUnavailableError,\n  UnsupportedFeatureError,\n  ComplianceUnsatisfiedError,\n  GovernanceDeniedError,\n  PolicyViolationError,\n} from './errors-typed';\n\n// Cursor pagination\nexport type { CursorPage, CursorRequest } from './pagination';\n\n// Status-change event bus — adopter-facing primitive for spec-native\n// lifecycle channels (media_buy / creative / audience / signal / proposal /\n// plan / rights_grant / delivery_report). Module-level so adopters can\n// publish from webhook handlers, crons, in-process workers without holding\n// a server reference.\nexport {\n  publishStatusChange,\n  setStatusChangeBus,\n  getStatusChangeBus,\n  createInMemoryStatusChangeBus,\n  type StatusChange,\n  type StatusChangeBus,\n  type StatusChangeResourceType,\n  type StatusChangeListener,\n  type PublishStatusChangeOpts,\n} from './status-changes';\n\n// Capabilities (single source of truth for get_adcp_capabilities)\nexport type {\n  DecisioningCapabilities,\n  ComplianceTestingCapabilities,\n  CreativeAgentRef,\n  TargetingCapabilities,\n  TargetingPostalAreaSupport,\n  ReportingCapabilities,\n} from './capabilities';\nexport { normalizePostalAreaSupport, normalizeTargetingCapabilities } from './capabilities';\n\n// Account model\nexport type {\n  Account,\n  AuthPrincipal,\n  AccountStore,\n  AccountFilter,\n  ListAccountsPayload,\n  SyncAccountsPayload,\n  SyncAccountsSuccessPayload,\n  SyncAccountsRow,\n  SyncAccountsResultRow,\n  SyncGovernancePayload,\n  SyncGovernanceSuccessPayload,\n  SyncGovernanceRow,\n  ReportUsagePayload,\n  GetAccountFinancialsPayload,\n  GetAccountFinancialsSuccessPayload,\n  ListAccountsHandlerResult,\n  SyncAccountsHandlerResult,\n  SyncGovernanceHandlerResult,\n  ReportUsageHandlerResult,\n  GetAccountFinancialsHandlerResult,\n  AdcpAccountStatus,\n  ResolveContext,\n  AccountToolContext,\n  ResolvedAuthInfo,\n} from './account';\n\nexport { AccountNotFoundError, refAccountId } from './account';\n\n// Multi-tenant AccountStore builder. Bakes in the two-path resolution\n// (operator-routed + auth-derived) and the per-entry tenant-isolation gate\n// that adopters historically had to hand-write — and silently fail to\n// hand-write — on `accounts.upsert` / `accounts.syncGovernance`.\nexport { createTenantStore, narrowAccountRef } from './tenant-store';\nexport type { TenantStoreConfig } from './tenant-store';\n\n// Buyer-agent identity surface — Phase 1 of #1269. Durable commercial\n// relationship records keyed off the request credential. Factory-pattern\n// registry (signing-only / bearer-only / mixed) encodes the implementer\n// posture at construction; framework calls `BuyerAgentRegistry.resolve`\n// once per request before `accounts.resolve`. Phase 1 ships the shape and\n// resolution; framework-level billing-capability enforcement and the\n// AdCP-3.1 error-code emission land in Phase 2 (#1292).\nexport type {\n  BuyerAgent,\n  BuyerAgentBillingMode,\n  BuyerAgentStatus,\n  BuyerAgentRegistry as BuyerAgentRegistryProtocol,\n  BuyerAgentResolveInput,\n  BuyerAgentCacheOptions,\n  CachedBuyerAgentRegistry,\n  AdcpCredential,\n  ResolveBuyerAgentByAgentUrl,\n  ResolveBuyerAgentByCredential,\n} from './buyer-agent';\nexport { BuyerAgentRegistry } from './buyer-agent';\n\n// Native status mapping\nexport type { StatusMappers, AdcpMediaBuyStatus, AdcpCreativeStatus, AdcpPlanStatus } from './status-mappers';\nexport { identityStatusMappers } from './status-mappers';\n\n// Request context (state + resolve)\nexport type {\n  RequestContext,\n  WorkflowStateReader,\n  ResourceResolver,\n  WorkflowObjectType,\n  WorkflowStep,\n  Proposal,\n  GovernanceContextJWS,\n} from './context';\n\n// Top-level platform + compile-time capability enforcement\nexport type { DecisioningPlatform, RequiredPlatformsFor, RequiredCapabilitiesFor } from './platform';\n\n// Method-level composition (closes #1314) — wrap individual platform methods\n// with `before` / `after` hooks for short-circuit + enrichment patterns.\nexport { composeMethod } from './compose';\nexport type { ComposeHooks, ComposeShortCircuit } from './compose';\n\n// `accounts.resolve` security presets (closes #1339) — canonical post-resolve\n// guards that standardize the multi-tenant authorization pattern instead of\n// every adopter rolling their own.\nexport { requireAccountMatch, requireAdvertiserMatch, requireOrgScope } from './resolve-presets';\nexport type { ResolveAccountHooks, ResolveGuardOptions } from './resolve-presets';\n\n// Specialism interfaces (v1.0)\nexport type {\n  CreativeBuilderPlatform,\n  LegacyBuildCreativeReturn,\n  LegacyBuildCreativePayload,\n  LegacyBuildCreativeMultiPayload,\n  LegacyPreviewCreativePayload,\n  LegacyListCreativeFormatsPayload,\n  // Deprecated aliases — kept for one-release source compat. Both\n  // resolve to CreativeBuilderPlatform; see specialisms/creative.ts.\n  CreativeTemplatePlatform,\n  CreativeGenerativePlatform,\n  RefinementMessage,\n  SyncCreativesRow,\n} from './specialisms/creative';\n\nexport type {\n  CreativeAdServerPlatform,\n  LegacyBuildCreativeReturn as CreativeAdServerLegacyBuildCreativeReturn,\n  LegacyBuildCreativePayload as CreativeAdServerLegacyBuildCreativePayload,\n  LegacyBuildCreativeMultiPayload as CreativeAdServerLegacyBuildCreativeMultiPayload,\n  LegacyPreviewCreativePayload as CreativeAdServerLegacyPreviewCreativePayload,\n  LegacyListCreativeFormatsPayload as CreativeAdServerLegacyListCreativeFormatsPayload,\n  ListCreativesPayload as CreativeAdServerListCreativesPayload,\n  GetCreativeDeliveryPayload,\n  GetCreativeDeliveryPayload as CreativeAdServerGetCreativeDeliveryPayload,\n  LegacyGetCreativeDeliveryPayload as CreativeAdServerLegacyGetCreativeDeliveryPayload,\n} from './specialisms/creative-ad-server';\n\nexport type {\n  CampaignGovernancePlatform,\n  CheckGovernancePayload,\n  SyncPlansPayload,\n  ReportPlanOutcomePayload,\n  GetPlanAuditLogsPayload,\n} from './specialisms/campaign-governance';\n\nexport type {\n  ContentStandardsPlatform,\n  LegacyListContentStandardsPayload,\n  LegacyGetContentStandardsPayload,\n  LegacyCreateContentStandardsPayload,\n  LegacyUpdateContentStandardsPayload,\n  LegacyCalibrateContentPayload,\n  LegacyValidateContentDeliveryPayload,\n  LegacyGetMediaBuyArtifactsPayload,\n  LegacyGetCreativeFeaturesPayload,\n} from './specialisms/content-standards';\n\nexport type {\n  PropertyListsPlatform,\n  CollectionListsPlatform,\n  CreatePropertyListPayload,\n  UpdatePropertyListPayload,\n  GetPropertyListPayload,\n  ListPropertyListsPayload,\n  DeletePropertyListPayload,\n  CreateCollectionListPayload,\n  UpdateCollectionListPayload,\n  GetCollectionListPayload,\n  ListCollectionListsPayload,\n  DeleteCollectionListPayload,\n} from './specialisms/lists';\n\nexport type {\n  SalesPlatform,\n  SalesCorePlatform,\n  SalesIngestionPlatform,\n  GetProductsPayload,\n  LegacyGetProductsPayload,\n  GetProductsHandlerResult,\n  CreateMediaBuyPayload,\n  LegacyCreateMediaBuyPayload,\n  CreateMediaBuyHandlerResult,\n  UpdateMediaBuyPayload,\n  LegacyUpdateMediaBuyPayload,\n  UpdateMediaBuyHandlerResult,\n  GetMediaBuyDeliveryPayload,\n  LegacyGetMediaBuyDeliveryPayload,\n  GetMediaBuysPayload,\n  LegacyGetMediaBuysPayload,\n  ProvidePerformanceFeedbackPayload,\n  LegacyListCreativeFormatsPayload as SalesLegacyListCreativeFormatsPayload,\n  ListCreativesPayload,\n  LegacyListCreativesPayload,\n  SyncCreativesPayload,\n  SyncCreativesHandlerResult,\n  SyncCatalogsPayload,\n  LogEventPayload,\n  SyncEventSourcesPayload,\n} from './specialisms/sales';\n\nexport type {\n  AudiencePlatform,\n  Audience,\n  SyncAudiencesPayload,\n  SyncAudiencesRow,\n  SyncAudiencesHandlerResult,\n  AudienceStatus,\n} from './specialisms/audiences';\n\nexport type {\n  SignalsPlatform,\n  GetSignalsPayload,\n  GetSignalsHandlerResult,\n  ActivateSignalPayload,\n} from './specialisms/signals';\n\nexport type {\n  SponsoredIntelligencePlatform,\n  SIGetOfferingPayload,\n  SIInitiateSessionPayload,\n  SISendMessagePayload,\n  SITerminateSessionPayload,\n} from './specialisms/sponsored-intelligence';\n\nexport type {\n  BrandRightsPlatform,\n  GetBrandIdentityPayload,\n  LegacyGetRightsPayload,\n  LegacyAcquireRightsAcquiredPayload,\n  LegacyAcquireRightsPendingApprovalPayload,\n  LegacyAcquireRightsRejectedPayload,\n  LegacyAcquireRightsPayload,\n  LegacyUpdateRightsPayload,\n  CreativeApprovedPayload,\n  CreativeRejectedPayload,\n  CreativePendingReviewPayload,\n  CreativeApprovalPayload,\n} from './specialisms/brand-rights';\n\n// Brand-rights wire types — re-exported from `@adcp/sdk/server/decisioning`\n// because brand-rights is the only specialism whose wire types live in\n// `core.generated` (not `tools.generated`), and the public `@adcp/sdk/types`\n// barrel doesn't surface them. Adopters typing their own helper functions\n// import these from here, NOT from the deep `core.generated` path.\nexport type {\n  GetBrandIdentityRequest,\n  GetBrandIdentitySuccess,\n  GetRightsRequest as LegacyGetRightsRequest,\n  GetRightsSuccess as LegacyGetRightsSuccess,\n  AcquireRightsRequest as LegacyAcquireRightsRequest,\n  AcquireRightsAcquired as LegacyAcquireRightsAcquired,\n  AcquireRightsPendingApproval as LegacyAcquireRightsPendingApproval,\n  AcquireRightsRejected as LegacyAcquireRightsRejected,\n  AcquireRightsError as LegacyAcquireRightsError,\n  RightUse,\n  RightType,\n  RightsConstraint,\n  RightsTerms,\n  RightsPricingOption,\n  GenerationCredential,\n} from '../../types/core.generated';\n\n// Runtime (v6.0 alpha) — preview surface for adopters spiking against the\n// new shape. Subject to change before 6.0 GA.\nexport {\n  createAdcpServerFromPlatform,\n  getAllAdcpMigrations,\n  type CreateAdcpServerFromPlatformOptions,\n  type LegacyDecisioningHandlerGroups,\n  type RequiredOptsFor,\n  type DecisioningAdcpServer,\n  type DecisioningObservabilityHooks,\n} from './runtime/from-platform';\nexport { PlatformConfigError, validatePlatform } from './runtime/validate-platform';\nexport {\n  createInMemoryTaskRegistry,\n  type TaskRegistry,\n  type TaskRecord,\n  type TaskStatus,\n} from './runtime/task-registry';\nexport {\n  createPostgresTaskRegistry,\n  getDecisioningTaskRegistryMigration,\n  type CreatePostgresTaskRegistryOptions,\n  type PgQueryable,\n} from './runtime/postgres-task-registry';\n\n// Multi-tenant deployment helper — wraps createAdcpServerFromPlatform with\n// per-tenant config, health states (healthy/unverified/disabled), and JWKS\n// validation. Composes with the existing serve() host-routing surface.\nexport {\n  createTenantRegistry,\n  createDefaultJwksValidator,\n  createSelfSignedTenantKey,\n  createNoopJwksValidator,\n  type TenantRegistry,\n  type TenantConfig,\n  type TenantSigningKey,\n  type TenantStatus,\n  type TenantHealth,\n  type TenantRegistryOptions,\n  type JwksValidator,\n  type JwksValidationResult,\n} from './tenant-registry';\n\n// Manifest helpers — typed accessors for creative_manifest.assets values.\n// Save adopters from writing the same null-check + discriminator-check\n// boilerplate per call.\nexport { getAsset, getAssetSlot, requireAsset } from './manifest-helpers';\nexport type { CreativeAssetsContainer } from './manifest-helpers';\n\n// List helpers — wrap row arrays + pagination into the heavier wire shapes\n// (today: list_creatives, which carries query_summary alongside the rows).\nexport {\n  buildListCreativesResponse,\n  buildListCreativesResponseLegacy,\n  type BuildListCreativesResponseOpts,\n  type BuildListCreativesResponseLegacyOpts,\n} from './list-helpers';\n\n// Start-time helper — normalize the wire `start_time` union into a Date,\n// with platform-aware ASAP lead-time injection.\nexport { resolveStartTime, type ResolveStartTimeOptions } from './start-time';\n\n// Admin Express router for ops visibility into the TenantRegistry.\n// Mount on a separate port/path with operator auth.\nexport {\n  createTenantAdminRouter,\n  createTenantAdminHandlers,\n  mountTenantAdmin,\n  type TenantAdminHandlers,\n  type RouterLike,\n} from './admin-router';\n\n// Adopter helpers — batchPoll, validationError, upstreamError, RequestShape.\n// All opt-in convenience; nothing in the framework calls these internally.\nexport { batchPoll, validationError, upstreamError } from './helpers';\nexport type { RequestShape } from './helpers';\n\n// Platform identity helpers — fix TypeScript's contextual-typing gap when\n// building a DecisioningPlatform (or sub-interface) as an object literal.\n// Without these, `createAdcpServerFromPlatform({ sales: { syncEventSources:\n// async (req, ctx) => {...} } })` gives `req: unknown` because the generic\n// `P extends DecisioningPlatform<any,any>` is inferred, not declared.\n// Wrapping the sub-object with e.g. `defineSalesPlatform<MyMeta>({...})`\n// forces the concrete type annotation TypeScript needs. The helpers are\n// pure identity functions — zero runtime cost.\nexport {\n  definePlatform,\n  defineSalesPlatform,\n  defineSalesCorePlatform,\n  defineSalesIngestionPlatform,\n  defineAudiencePlatform,\n  defineSignalsPlatform,\n  defineSponsoredIntelligencePlatform,\n  defineCreativeBuilderPlatform,\n  defineCreativeAdServerPlatform,\n  defineCampaignGovernancePlatform,\n  defineContentStandardsPlatform,\n  definePropertyListsPlatform,\n  defineCollectionListsPlatform,\n  defineBrandRightsPlatform,\n  definePlatformWithCompliance,\n} from './platform-helpers';\n\n// ProposalManager — primitives for the two-platform composition (port of\n// adcp-client-python PRs #504 + #550). Splits proposal assembly from\n// media-buy execution; either side can be mock-backed independently.\n// Framework dispatch wiring lands in a follow-up release.\nexport type {\n  ProposalManager,\n  ProposalGetProductsPayload,\n  LegacyProposalGetProductsPayload,\n  ProposalCapabilities,\n  ProposalSalesSpecialism,\n  Recipe,\n  CapabilityOverlap,\n  FinalizeProposalRequest,\n  FinalizeProposalSuccess,\n  ProposalState,\n  ProposalRecord,\n  ProposalStore,\n  InMemoryProposalStoreOptions,\n  MockProposalManagerOptions,\n} from './proposal';\nexport {\n  validateProposalCapabilities,\n  InMemoryProposalStore,\n  MockProposalManager,\n  enforceProposalExpiry,\n  validateCapabilityOverlap,\n  validateOverlapSubsetOfWire,\n  detectFinalizeAction,\n  setProposalLifecycleLogger,\n  maybeInterceptFinalize,\n  maybePersistDraftAfterGetProducts,\n  maybeReserveProposalForCreateMediaBuy,\n  finalizeProposalConsumption,\n  releaseProposalReservation,\n  maybeHydrateRecipesForMediaBuyId,\n} from './proposal';\nexport type { FinalizeActionRef, ProposalLifecycleLogger, FinalizeInterceptResult, ReservedProposal } from './proposal';\n\n// Canonical assembly helpers — emit Product / PricingOption / package shapes\n// from intent-shaped input. Raw named-format product assembly is available\n// only through the explicit buildProductLegacy compatibility helper.\nexport { buildProduct, buildProductLegacy, buildPricingOption, buildPackage } from './assembly-helpers';\nexport type {\n  BuildProductInput,\n  BuildProductLegacyInput,\n  BuildPricingOptionInput,\n  BuildPackageInput,\n} from './assembly-helpers';\n"],"mappings":"AAsBA,SAAmD,iBAAiB;AAQpE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AAWP,SAAS,4BAA4B,sCAAsC;AA8B3E,SAAS,sBAAsB,oBAAoB;AAMnD,SAAS,mBAAmB,wBAAwB;AAsBpD,SAAS,0BAA0B;AAInC,SAAS,6BAA6B;AAkBtC,SAAS,qBAAqB;AAM9B,SAAS,qBAAqB,wBAAwB,uBAAuB;AA+J7E;AAAA,EACE;AAAA,EACA;AAAA,OAMK;AACP,SAAS,qBAAqB,wBAAwB;AACtD;AAAA,EACE;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OASK;AAKP,SAAS,UAAU,cAAc,oBAAoB;AAKrD;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAIP,SAAS,wBAAsD;AAI/D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAIP,SAAS,WAAW,iBAAiB,qBAAqB;AAW1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAsBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,cAAc,oBAAoB,oBAAoB,oBAAoB;","names":[]}

package/dist/lib/server/decisioning/list-helpers.d.mts

@@ -18,11 +18,12 @@
  */
 import type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated.mjs';
 import type { ServerPayload } from '../../types/server-payload.mjs';
+import type { CanonicalListCreativesRequest, CanonicalListCreativesResponse } from '../../v2/projection/creative-delivery.mjs';
 export interface BuildListCreativesResponseOpts {
     /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */
-    request: ListCreativesRequest;
+    request: CanonicalListCreativesRequest;
     /** The page of creative rows. Length determines `query_summary.returned`. */
-    creatives: ServerPayload<ListCreativesResponse>['creatives'];
+    creatives: ServerPayload<CanonicalListCreativesResponse>['creatives'];
     /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */
     pagination: PaginationResponse;
     /**
@@ -33,6 +34,13 @@ export interface BuildListCreativesResponseOpts {
      */
     totalMatching?: number;
 }
+/** @deprecated Explicit compatibility input for legacy `format_id` rows and filters. */
+export interface BuildListCreativesResponseLegacyOpts {
+    request: ListCreativesRequest;
+    creatives: ServerPayload<ListCreativesResponse>['creatives'];
+    pagination: PaginationResponse;
+    totalMatching?: number;
+}
 /**
  * Build a `ListCreativesResponse` from a row array + pagination + the
  * original request. Computes `query_summary.filters_applied` from
@@ -50,4 +58,6 @@ export interface BuildListCreativesResponseOpts {
  * }
  * ```
  */
-export declare function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<ListCreativesResponse>;
+export declare function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<CanonicalListCreativesResponse>;
+/** @deprecated Use `buildListCreativesResponse` with canonical creative rows. */
+export declare function buildListCreativesResponseLegacy(opts: BuildListCreativesResponseLegacyOpts): ServerPayload<ListCreativesResponse>;

package/dist/lib/server/decisioning/list-helpers.d.ts

@@ -18,11 +18,12 @@
  */
 import type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';
 import type { ServerPayload } from '../../types/server-payload';
+import type { CanonicalListCreativesRequest, CanonicalListCreativesResponse } from '../../v2/projection/creative-delivery';
 export interface BuildListCreativesResponseOpts {
     /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */
-    request: ListCreativesRequest;
+    request: CanonicalListCreativesRequest;
     /** The page of creative rows. Length determines `query_summary.returned`. */
-    creatives: ServerPayload<ListCreativesResponse>['creatives'];
+    creatives: ServerPayload<CanonicalListCreativesResponse>['creatives'];
     /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */
     pagination: PaginationResponse;
     /**
@@ -33,6 +34,13 @@ export interface BuildListCreativesResponseOpts {
      */
     totalMatching?: number;
 }
+/** @deprecated Explicit compatibility input for legacy `format_id` rows and filters. */
+export interface BuildListCreativesResponseLegacyOpts {
+    request: ListCreativesRequest;
+    creatives: ServerPayload<ListCreativesResponse>['creatives'];
+    pagination: PaginationResponse;
+    totalMatching?: number;
+}
 /**
  * Build a `ListCreativesResponse` from a row array + pagination + the
  * original request. Computes `query_summary.filters_applied` from
@@ -50,5 +58,7 @@ export interface BuildListCreativesResponseOpts {
  * }
  * ```
  */
-export declare function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<ListCreativesResponse>;
+export declare function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<CanonicalListCreativesResponse>;
+/** @deprecated Use `buildListCreativesResponse` with canonical creative rows. */
+export declare function buildListCreativesResponseLegacy(opts: BuildListCreativesResponseLegacyOpts): ServerPayload<ListCreativesResponse>;
 //# sourceMappingURL=list-helpers.d.ts.map

package/dist/lib/server/decisioning/list-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,8BAA8B;IAC7C,uFAAuF;IACvF,OAAO,EAAE,oBAAoB,CAAC;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7D,6GAA6G;IAC7G,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,8BAA8B,GAAG,aAAa,CAAC,qBAAqB,CAAC,CA0CrH"}
+{"version":3,"file":"list-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACnH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,8BAA8B;IAC7C,uFAAuF;IACvF,OAAO,EAAE,6BAA6B,CAAC;IACvC,6EAA6E;IAC7E,SAAS,EAAE,aAAa,CAAC,8BAA8B,CAAC,CAAC,WAAW,CAAC,CAAC;IACtE,6GAA6G;IAC7G,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7D,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,8BAA8B,GACnC,aAAa,CAAC,8BAA8B,CAAC,CAE/C;AAED,iFAAiF;AACjF,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,oCAAoC,GACzC,aAAa,CAAC,qBAAqB,CAAC,CAEtC"}

package/dist/lib/server/decisioning/list-helpers.js

@@ -18,10 +18,17 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var list_helpers_exports = {};
 __export(list_helpers_exports, {
-  buildListCreativesResponse: () => buildListCreativesResponse
+  buildListCreativesResponse: () => buildListCreativesResponse,
+  buildListCreativesResponseLegacy: () => buildListCreativesResponseLegacy
 });
 module.exports = __toCommonJS(list_helpers_exports);
 function buildListCreativesResponse(opts) {
+  return buildListCreativesResponseBase(opts, false);
+}
+function buildListCreativesResponseLegacy(opts) {
+  return buildListCreativesResponseBase(opts, true);
+}
+function buildListCreativesResponseBase(opts, includeLegacyFormatFilter) {
   const { request, creatives, pagination, totalMatching } = opts;
   const filters = request.filters;
   const filtersApplied = [];
@@ -41,7 +48,9 @@ function buildListCreativesResponse(opts) {
     if (filters.unassigned !== void 0) filtersApplied.push("unassigned");
     if (filters.has_served !== void 0) filtersApplied.push("has_served");
     if (filters.concept_ids?.length) filtersApplied.push("concept_ids");
-    if (filters.format_ids?.length) filtersApplied.push("format_ids");
+    if (includeLegacyFormatFilter && "format_ids" in filters && Array.isArray(filters.format_ids) && filters.format_ids.length > 0) {
+      filtersApplied.push("format_ids");
+    }
     if (filters.has_variables !== void 0) filtersApplied.push("has_variables");
   }
   const summary = {
@@ -63,6 +72,7 @@ function buildListCreativesResponse(opts) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  buildListCreativesResponse
+  buildListCreativesResponse,
+  buildListCreativesResponseLegacy
 });
 //# sourceMappingURL=list-helpers.js.map

package/dist/lib/server/decisioning/list-helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"sourcesContent":["/**\n * Helpers for building paginated list responses.\n *\n * `list_creatives` is the heaviest of the read tools: its response wraps the\n * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,\n * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).\n * Adopters writing the wrapper by hand re-derive the same fields per call;\n * this helper threads a row array + pagination cursor + the original request\n * into the wire shape.\n *\n * `list_property_lists`, `list_collection_lists`, and other governance reads\n * use a simpler `{ lists: [...] }` wrapper that the framework's response\n * builders already cover — those don't need a row helper.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';\nimport type { ServerPayload } from '../../types/server-payload';\n\nexport interface BuildListCreativesResponseOpts {\n  /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */\n  request: ListCreativesRequest;\n  /** The page of creative rows. Length determines `query_summary.returned`. */\n  creatives: ServerPayload<ListCreativesResponse>['creatives'];\n  /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */\n  pagination: PaginationResponse;\n  /**\n   * Total count across all pages. When omitted, defaults to\n   * `pagination.total_count` if present, else `creatives.length` (last-page\n   * approximation). Set explicitly when your backend can compute the true\n   * total.\n   */\n  totalMatching?: number;\n}\n\n/**\n * Build a `ListCreativesResponse` from a row array + pagination + the\n * original request. Computes `query_summary.filters_applied` from\n * `request.filters` and threads `request.sort` into `sort_applied`.\n *\n * ```ts\n * listCreatives: async (req, ctx) => {\n *   const rows = await this.db.queryCreatives(req);\n *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;\n *   return buildListCreativesResponse({\n *     request: req,\n *     creatives: rows,\n *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },\n *   });\n * }\n * ```\n */\nexport function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<ListCreativesResponse> {\n  const { request, creatives, pagination, totalMatching } = opts;\n\n  const filters = request.filters;\n  const filtersApplied: string[] = [];\n  if (filters) {\n    if (filters.accounts?.length) filtersApplied.push('accounts');\n    if (filters.statuses?.length) filtersApplied.push('statuses');\n    if (filters.tags?.length) filtersApplied.push('tags');\n    if (filters.tags_any?.length) filtersApplied.push('tags_any');\n    if (filters.name_contains) filtersApplied.push('name_contains');\n    if (filters.creative_ids?.length) filtersApplied.push('creative_ids');\n    if (filters.created_after) filtersApplied.push('created_after');\n    if (filters.created_before) filtersApplied.push('created_before');\n    if (filters.updated_after) filtersApplied.push('updated_after');\n    if (filters.updated_before) filtersApplied.push('updated_before');\n    if (filters.assigned_to_packages?.length) filtersApplied.push('assigned_to_packages');\n    if (filters.media_buy_ids?.length) filtersApplied.push('media_buy_ids');\n    if (filters.unassigned !== undefined) filtersApplied.push('unassigned');\n    if (filters.has_served !== undefined) filtersApplied.push('has_served');\n    if (filters.concept_ids?.length) filtersApplied.push('concept_ids');\n    if (filters.format_ids?.length) filtersApplied.push('format_ids');\n    if (filters.has_variables !== undefined) filtersApplied.push('has_variables');\n  }\n\n  const summary: ServerPayload<ListCreativesResponse>['query_summary'] = {\n    total_matching: totalMatching ?? pagination.total_count ?? creatives.length,\n    returned: creatives.length,\n    ...(filtersApplied.length > 0 && { filters_applied: filtersApplied }),\n    ...(request.sort && {\n      sort_applied: {\n        ...(request.sort.field !== undefined && { field: request.sort.field }),\n        ...(request.sort.direction !== undefined && { direction: request.sort.direction }),\n      },\n    }),\n  };\n\n  return {\n    query_summary: summary,\n    pagination,\n    creatives,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAuDO,SAAS,2BAA2B,MAA4E;AACrH,QAAM,EAAE,SAAS,WAAW,YAAY,cAAc,IAAI;AAE1D,QAAM,UAAU,QAAQ;AACxB,QAAM,iBAA2B,CAAC;AAClC,MAAI,SAAS;AACX,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,MAAM,OAAQ,gBAAe,KAAK,MAAM;AACpD,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,cAAc,OAAQ,gBAAe,KAAK,cAAc;AACpE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,sBAAsB,OAAQ,gBAAe,KAAK,sBAAsB;AACpF,QAAI,QAAQ,eAAe,OAAQ,gBAAe,KAAK,eAAe;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,aAAa,OAAQ,gBAAe,KAAK,aAAa;AAClE,QAAI,QAAQ,YAAY,OAAQ,gBAAe,KAAK,YAAY;AAChE,QAAI,QAAQ,kBAAkB,OAAW,gBAAe,KAAK,eAAe;AAAA,EAC9E;AAEA,QAAM,UAAiE;AAAA,IACrE,gBAAgB,iBAAiB,WAAW,eAAe,UAAU;AAAA,IACrE,UAAU,UAAU;AAAA,IACpB,GAAI,eAAe,SAAS,KAAK,EAAE,iBAAiB,eAAe;AAAA,IACnE,GAAI,QAAQ,QAAQ;AAAA,MAClB,cAAc;AAAA,QACZ,GAAI,QAAQ,KAAK,UAAU,UAAa,EAAE,OAAO,QAAQ,KAAK,MAAM;AAAA,QACpE,GAAI,QAAQ,KAAK,cAAc,UAAa,EAAE,WAAW,QAAQ,KAAK,UAAU;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"sourcesContent":["/**\n * Helpers for building paginated list responses.\n *\n * `list_creatives` is the heaviest of the read tools: its response wraps the\n * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,\n * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).\n * Adopters writing the wrapper by hand re-derive the same fields per call;\n * this helper threads a row array + pagination cursor + the original request\n * into the wire shape.\n *\n * `list_property_lists`, `list_collection_lists`, and other governance reads\n * use a simpler `{ lists: [...] }` wrapper that the framework's response\n * builders already cover — those don't need a row helper.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';\nimport type { ServerPayload } from '../../types/server-payload';\nimport type {\n  CanonicalListCreativesRequest,\n  CanonicalListCreativesResponse,\n} from '../../v2/projection/creative-delivery';\n\nexport interface BuildListCreativesResponseOpts {\n  /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */\n  request: CanonicalListCreativesRequest;\n  /** The page of creative rows. Length determines `query_summary.returned`. */\n  creatives: ServerPayload<CanonicalListCreativesResponse>['creatives'];\n  /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */\n  pagination: PaginationResponse;\n  /**\n   * Total count across all pages. When omitted, defaults to\n   * `pagination.total_count` if present, else `creatives.length` (last-page\n   * approximation). Set explicitly when your backend can compute the true\n   * total.\n   */\n  totalMatching?: number;\n}\n\n/** @deprecated Explicit compatibility input for legacy `format_id` rows and filters. */\nexport interface BuildListCreativesResponseLegacyOpts {\n  request: ListCreativesRequest;\n  creatives: ServerPayload<ListCreativesResponse>['creatives'];\n  pagination: PaginationResponse;\n  totalMatching?: number;\n}\n\n/**\n * Build a `ListCreativesResponse` from a row array + pagination + the\n * original request. Computes `query_summary.filters_applied` from\n * `request.filters` and threads `request.sort` into `sort_applied`.\n *\n * ```ts\n * listCreatives: async (req, ctx) => {\n *   const rows = await this.db.queryCreatives(req);\n *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;\n *   return buildListCreativesResponse({\n *     request: req,\n *     creatives: rows,\n *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },\n *   });\n * }\n * ```\n */\nexport function buildListCreativesResponse(\n  opts: BuildListCreativesResponseOpts\n): ServerPayload<CanonicalListCreativesResponse> {\n  return buildListCreativesResponseBase(opts, false) as ServerPayload<CanonicalListCreativesResponse>;\n}\n\n/** @deprecated Use `buildListCreativesResponse` with canonical creative rows. */\nexport function buildListCreativesResponseLegacy(\n  opts: BuildListCreativesResponseLegacyOpts\n): ServerPayload<ListCreativesResponse> {\n  return buildListCreativesResponseBase(opts, true) as ServerPayload<ListCreativesResponse>;\n}\n\nfunction buildListCreativesResponseBase(\n  opts: BuildListCreativesResponseOpts | BuildListCreativesResponseLegacyOpts,\n  includeLegacyFormatFilter: boolean\n): ServerPayload<CanonicalListCreativesResponse> | ServerPayload<ListCreativesResponse> {\n  const { request, creatives, pagination, totalMatching } = opts;\n\n  const filters = request.filters;\n  const filtersApplied: string[] = [];\n  if (filters) {\n    if (filters.accounts?.length) filtersApplied.push('accounts');\n    if (filters.statuses?.length) filtersApplied.push('statuses');\n    if (filters.tags?.length) filtersApplied.push('tags');\n    if (filters.tags_any?.length) filtersApplied.push('tags_any');\n    if (filters.name_contains) filtersApplied.push('name_contains');\n    if (filters.creative_ids?.length) filtersApplied.push('creative_ids');\n    if (filters.created_after) filtersApplied.push('created_after');\n    if (filters.created_before) filtersApplied.push('created_before');\n    if (filters.updated_after) filtersApplied.push('updated_after');\n    if (filters.updated_before) filtersApplied.push('updated_before');\n    if (filters.assigned_to_packages?.length) filtersApplied.push('assigned_to_packages');\n    if (filters.media_buy_ids?.length) filtersApplied.push('media_buy_ids');\n    if (filters.unassigned !== undefined) filtersApplied.push('unassigned');\n    if (filters.has_served !== undefined) filtersApplied.push('has_served');\n    if (filters.concept_ids?.length) filtersApplied.push('concept_ids');\n    if (\n      includeLegacyFormatFilter &&\n      'format_ids' in filters &&\n      Array.isArray(filters.format_ids) &&\n      filters.format_ids.length > 0\n    ) {\n      filtersApplied.push('format_ids');\n    }\n    if (filters.has_variables !== undefined) filtersApplied.push('has_variables');\n  }\n\n  const summary: ServerPayload<ListCreativesResponse>['query_summary'] = {\n    total_matching: totalMatching ?? pagination.total_count ?? creatives.length,\n    returned: creatives.length,\n    ...(filtersApplied.length > 0 && { filters_applied: filtersApplied }),\n    ...(request.sort && {\n      sort_applied: {\n        ...(request.sort.field !== undefined && { field: request.sort.field }),\n        ...(request.sort.direction !== undefined && { direction: request.sort.direction }),\n      },\n    }),\n  };\n\n  return {\n    query_summary: summary,\n    pagination,\n    creatives,\n  } as ServerPayload<CanonicalListCreativesResponse> | ServerPayload<ListCreativesResponse>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmEO,SAAS,2BACd,MAC+C;AAC/C,SAAO,+BAA+B,MAAM,KAAK;AACnD;AAGO,SAAS,iCACd,MACsC;AACtC,SAAO,+BAA+B,MAAM,IAAI;AAClD;AAEA,SAAS,+BACP,MACA,2BACsF;AACtF,QAAM,EAAE,SAAS,WAAW,YAAY,cAAc,IAAI;AAE1D,QAAM,UAAU,QAAQ;AACxB,QAAM,iBAA2B,CAAC;AAClC,MAAI,SAAS;AACX,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,MAAM,OAAQ,gBAAe,KAAK,MAAM;AACpD,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,cAAc,OAAQ,gBAAe,KAAK,cAAc;AACpE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,sBAAsB,OAAQ,gBAAe,KAAK,sBAAsB;AACpF,QAAI,QAAQ,eAAe,OAAQ,gBAAe,KAAK,eAAe;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,aAAa,OAAQ,gBAAe,KAAK,aAAa;AAClE,QACE,6BACA,gBAAgB,WAChB,MAAM,QAAQ,QAAQ,UAAU,KAChC,QAAQ,WAAW,SAAS,GAC5B;AACA,qBAAe,KAAK,YAAY;AAAA,IAClC;AACA,QAAI,QAAQ,kBAAkB,OAAW,gBAAe,KAAK,eAAe;AAAA,EAC9E;AAEA,QAAM,UAAiE;AAAA,IACrE,gBAAgB,iBAAiB,WAAW,eAAe,UAAU;AAAA,IACrE,UAAU,UAAU;AAAA,IACpB,GAAI,eAAe,SAAS,KAAK,EAAE,iBAAiB,eAAe;AAAA,IACnE,GAAI,QAAQ,QAAQ;AAAA,MAClB,cAAc;AAAA,QACZ,GAAI,QAAQ,KAAK,UAAU,UAAa,EAAE,OAAO,QAAQ,KAAK,MAAM;AAAA,QACpE,GAAI,QAAQ,KAAK,cAAc,UAAa,EAAE,WAAW,QAAQ,KAAK,UAAU;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/lib/server/decisioning/list-helpers.mjs

@@ -1,4 +1,10 @@
 function buildListCreativesResponse(opts) {
+  return buildListCreativesResponseBase(opts, false);
+}
+function buildListCreativesResponseLegacy(opts) {
+  return buildListCreativesResponseBase(opts, true);
+}
+function buildListCreativesResponseBase(opts, includeLegacyFormatFilter) {
   const { request, creatives, pagination, totalMatching } = opts;
   const filters = request.filters;
   const filtersApplied = [];
@@ -18,7 +24,9 @@ function buildListCreativesResponse(opts) {
     if (filters.unassigned !== void 0) filtersApplied.push("unassigned");
     if (filters.has_served !== void 0) filtersApplied.push("has_served");
     if (filters.concept_ids?.length) filtersApplied.push("concept_ids");
-    if (filters.format_ids?.length) filtersApplied.push("format_ids");
+    if (includeLegacyFormatFilter && "format_ids" in filters && Array.isArray(filters.format_ids) && filters.format_ids.length > 0) {
+      filtersApplied.push("format_ids");
+    }
     if (filters.has_variables !== void 0) filtersApplied.push("has_variables");
   }
   const summary = {
@@ -39,6 +47,7 @@ function buildListCreativesResponse(opts) {
   };
 }
 export {
-  buildListCreativesResponse
+  buildListCreativesResponse,
+  buildListCreativesResponseLegacy
 };
 //# sourceMappingURL=list-helpers.mjs.map

package/dist/lib/server/decisioning/list-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"sourcesContent":["/**\n * Helpers for building paginated list responses.\n *\n * `list_creatives` is the heaviest of the read tools: its response wraps the\n * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,\n * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).\n * Adopters writing the wrapper by hand re-derive the same fields per call;\n * this helper threads a row array + pagination cursor + the original request\n * into the wire shape.\n *\n * `list_property_lists`, `list_collection_lists`, and other governance reads\n * use a simpler `{ lists: [...] }` wrapper that the framework's response\n * builders already cover — those don't need a row helper.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';\nimport type { ServerPayload } from '../../types/server-payload';\n\nexport interface BuildListCreativesResponseOpts {\n  /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */\n  request: ListCreativesRequest;\n  /** The page of creative rows. Length determines `query_summary.returned`. */\n  creatives: ServerPayload<ListCreativesResponse>['creatives'];\n  /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */\n  pagination: PaginationResponse;\n  /**\n   * Total count across all pages. When omitted, defaults to\n   * `pagination.total_count` if present, else `creatives.length` (last-page\n   * approximation). Set explicitly when your backend can compute the true\n   * total.\n   */\n  totalMatching?: number;\n}\n\n/**\n * Build a `ListCreativesResponse` from a row array + pagination + the\n * original request. Computes `query_summary.filters_applied` from\n * `request.filters` and threads `request.sort` into `sort_applied`.\n *\n * ```ts\n * listCreatives: async (req, ctx) => {\n *   const rows = await this.db.queryCreatives(req);\n *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;\n *   return buildListCreativesResponse({\n *     request: req,\n *     creatives: rows,\n *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },\n *   });\n * }\n * ```\n */\nexport function buildListCreativesResponse(opts: BuildListCreativesResponseOpts): ServerPayload<ListCreativesResponse> {\n  const { request, creatives, pagination, totalMatching } = opts;\n\n  const filters = request.filters;\n  const filtersApplied: string[] = [];\n  if (filters) {\n    if (filters.accounts?.length) filtersApplied.push('accounts');\n    if (filters.statuses?.length) filtersApplied.push('statuses');\n    if (filters.tags?.length) filtersApplied.push('tags');\n    if (filters.tags_any?.length) filtersApplied.push('tags_any');\n    if (filters.name_contains) filtersApplied.push('name_contains');\n    if (filters.creative_ids?.length) filtersApplied.push('creative_ids');\n    if (filters.created_after) filtersApplied.push('created_after');\n    if (filters.created_before) filtersApplied.push('created_before');\n    if (filters.updated_after) filtersApplied.push('updated_after');\n    if (filters.updated_before) filtersApplied.push('updated_before');\n    if (filters.assigned_to_packages?.length) filtersApplied.push('assigned_to_packages');\n    if (filters.media_buy_ids?.length) filtersApplied.push('media_buy_ids');\n    if (filters.unassigned !== undefined) filtersApplied.push('unassigned');\n    if (filters.has_served !== undefined) filtersApplied.push('has_served');\n    if (filters.concept_ids?.length) filtersApplied.push('concept_ids');\n    if (filters.format_ids?.length) filtersApplied.push('format_ids');\n    if (filters.has_variables !== undefined) filtersApplied.push('has_variables');\n  }\n\n  const summary: ServerPayload<ListCreativesResponse>['query_summary'] = {\n    total_matching: totalMatching ?? pagination.total_count ?? creatives.length,\n    returned: creatives.length,\n    ...(filtersApplied.length > 0 && { filters_applied: filtersApplied }),\n    ...(request.sort && {\n      sort_applied: {\n        ...(request.sort.field !== undefined && { field: request.sort.field }),\n        ...(request.sort.direction !== undefined && { direction: request.sort.direction }),\n      },\n    }),\n  };\n\n  return {\n    query_summary: summary,\n    pagination,\n    creatives,\n  };\n}\n"],"mappings":"AAuDO,SAAS,2BAA2B,MAA4E;AACrH,QAAM,EAAE,SAAS,WAAW,YAAY,cAAc,IAAI;AAE1D,QAAM,UAAU,QAAQ;AACxB,QAAM,iBAA2B,CAAC;AAClC,MAAI,SAAS;AACX,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,MAAM,OAAQ,gBAAe,KAAK,MAAM;AACpD,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,cAAc,OAAQ,gBAAe,KAAK,cAAc;AACpE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,sBAAsB,OAAQ,gBAAe,KAAK,sBAAsB;AACpF,QAAI,QAAQ,eAAe,OAAQ,gBAAe,KAAK,eAAe;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,aAAa,OAAQ,gBAAe,KAAK,aAAa;AAClE,QAAI,QAAQ,YAAY,OAAQ,gBAAe,KAAK,YAAY;AAChE,QAAI,QAAQ,kBAAkB,OAAW,gBAAe,KAAK,eAAe;AAAA,EAC9E;AAEA,QAAM,UAAiE;AAAA,IACrE,gBAAgB,iBAAiB,WAAW,eAAe,UAAU;AAAA,IACrE,UAAU,UAAU;AAAA,IACpB,GAAI,eAAe,SAAS,KAAK,EAAE,iBAAiB,eAAe;AAAA,IACnE,GAAI,QAAQ,QAAQ;AAAA,MAClB,cAAc;AAAA,QACZ,GAAI,QAAQ,KAAK,UAAU,UAAa,EAAE,OAAO,QAAQ,KAAK,MAAM;AAAA,QACpE,GAAI,QAAQ,KAAK,cAAc,UAAa,EAAE,WAAW,QAAQ,KAAK,UAAU;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/list-helpers.ts"],"sourcesContent":["/**\n * Helpers for building paginated list responses.\n *\n * `list_creatives` is the heaviest of the read tools: its response wraps the\n * row array in `query_summary` (`total_matching`, `returned`, `filters_applied`,\n * `sort_applied`) AND `pagination` (`has_more`, `cursor`, `total_count`).\n * Adopters writing the wrapper by hand re-derive the same fields per call;\n * this helper threads a row array + pagination cursor + the original request\n * into the wire shape.\n *\n * `list_property_lists`, `list_collection_lists`, and other governance reads\n * use a simpler `{ lists: [...] }` wrapper that the framework's response\n * builders already cover — those don't need a row helper.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { ListCreativesRequest, ListCreativesResponse, PaginationResponse } from '../../types/tools.generated';\nimport type { ServerPayload } from '../../types/server-payload';\nimport type {\n  CanonicalListCreativesRequest,\n  CanonicalListCreativesResponse,\n} from '../../v2/projection/creative-delivery';\n\nexport interface BuildListCreativesResponseOpts {\n  /** Original request — used to surface `filters_applied` + `sort_applied` summaries. */\n  request: CanonicalListCreativesRequest;\n  /** The page of creative rows. Length determines `query_summary.returned`. */\n  creatives: ServerPayload<CanonicalListCreativesResponse>['creatives'];\n  /** Pagination cursor for the next page. Required — pass `{ has_more: false }` when this is the last page. */\n  pagination: PaginationResponse;\n  /**\n   * Total count across all pages. When omitted, defaults to\n   * `pagination.total_count` if present, else `creatives.length` (last-page\n   * approximation). Set explicitly when your backend can compute the true\n   * total.\n   */\n  totalMatching?: number;\n}\n\n/** @deprecated Explicit compatibility input for legacy `format_id` rows and filters. */\nexport interface BuildListCreativesResponseLegacyOpts {\n  request: ListCreativesRequest;\n  creatives: ServerPayload<ListCreativesResponse>['creatives'];\n  pagination: PaginationResponse;\n  totalMatching?: number;\n}\n\n/**\n * Build a `ListCreativesResponse` from a row array + pagination + the\n * original request. Computes `query_summary.filters_applied` from\n * `request.filters` and threads `request.sort` into `sort_applied`.\n *\n * ```ts\n * listCreatives: async (req, ctx) => {\n *   const rows = await this.db.queryCreatives(req);\n *   const cursor = rows.length === req.pagination?.limit ? this.nextCursor(rows) : undefined;\n *   return buildListCreativesResponse({\n *     request: req,\n *     creatives: rows,\n *     pagination: { has_more: cursor != null, cursor, total_count: rows.totalCount },\n *   });\n * }\n * ```\n */\nexport function buildListCreativesResponse(\n  opts: BuildListCreativesResponseOpts\n): ServerPayload<CanonicalListCreativesResponse> {\n  return buildListCreativesResponseBase(opts, false) as ServerPayload<CanonicalListCreativesResponse>;\n}\n\n/** @deprecated Use `buildListCreativesResponse` with canonical creative rows. */\nexport function buildListCreativesResponseLegacy(\n  opts: BuildListCreativesResponseLegacyOpts\n): ServerPayload<ListCreativesResponse> {\n  return buildListCreativesResponseBase(opts, true) as ServerPayload<ListCreativesResponse>;\n}\n\nfunction buildListCreativesResponseBase(\n  opts: BuildListCreativesResponseOpts | BuildListCreativesResponseLegacyOpts,\n  includeLegacyFormatFilter: boolean\n): ServerPayload<CanonicalListCreativesResponse> | ServerPayload<ListCreativesResponse> {\n  const { request, creatives, pagination, totalMatching } = opts;\n\n  const filters = request.filters;\n  const filtersApplied: string[] = [];\n  if (filters) {\n    if (filters.accounts?.length) filtersApplied.push('accounts');\n    if (filters.statuses?.length) filtersApplied.push('statuses');\n    if (filters.tags?.length) filtersApplied.push('tags');\n    if (filters.tags_any?.length) filtersApplied.push('tags_any');\n    if (filters.name_contains) filtersApplied.push('name_contains');\n    if (filters.creative_ids?.length) filtersApplied.push('creative_ids');\n    if (filters.created_after) filtersApplied.push('created_after');\n    if (filters.created_before) filtersApplied.push('created_before');\n    if (filters.updated_after) filtersApplied.push('updated_after');\n    if (filters.updated_before) filtersApplied.push('updated_before');\n    if (filters.assigned_to_packages?.length) filtersApplied.push('assigned_to_packages');\n    if (filters.media_buy_ids?.length) filtersApplied.push('media_buy_ids');\n    if (filters.unassigned !== undefined) filtersApplied.push('unassigned');\n    if (filters.has_served !== undefined) filtersApplied.push('has_served');\n    if (filters.concept_ids?.length) filtersApplied.push('concept_ids');\n    if (\n      includeLegacyFormatFilter &&\n      'format_ids' in filters &&\n      Array.isArray(filters.format_ids) &&\n      filters.format_ids.length > 0\n    ) {\n      filtersApplied.push('format_ids');\n    }\n    if (filters.has_variables !== undefined) filtersApplied.push('has_variables');\n  }\n\n  const summary: ServerPayload<ListCreativesResponse>['query_summary'] = {\n    total_matching: totalMatching ?? pagination.total_count ?? creatives.length,\n    returned: creatives.length,\n    ...(filtersApplied.length > 0 && { filters_applied: filtersApplied }),\n    ...(request.sort && {\n      sort_applied: {\n        ...(request.sort.field !== undefined && { field: request.sort.field }),\n        ...(request.sort.direction !== undefined && { direction: request.sort.direction }),\n      },\n    }),\n  };\n\n  return {\n    query_summary: summary,\n    pagination,\n    creatives,\n  } as ServerPayload<CanonicalListCreativesResponse> | ServerPayload<ListCreativesResponse>;\n}\n"],"mappings":"AAmEO,SAAS,2BACd,MAC+C;AAC/C,SAAO,+BAA+B,MAAM,KAAK;AACnD;AAGO,SAAS,iCACd,MACsC;AACtC,SAAO,+BAA+B,MAAM,IAAI;AAClD;AAEA,SAAS,+BACP,MACA,2BACsF;AACtF,QAAM,EAAE,SAAS,WAAW,YAAY,cAAc,IAAI;AAE1D,QAAM,UAAU,QAAQ;AACxB,QAAM,iBAA2B,CAAC;AAClC,MAAI,SAAS;AACX,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,MAAM,OAAQ,gBAAe,KAAK,MAAM;AACpD,QAAI,QAAQ,UAAU,OAAQ,gBAAe,KAAK,UAAU;AAC5D,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,cAAc,OAAQ,gBAAe,KAAK,cAAc;AACpE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,cAAe,gBAAe,KAAK,eAAe;AAC9D,QAAI,QAAQ,eAAgB,gBAAe,KAAK,gBAAgB;AAChE,QAAI,QAAQ,sBAAsB,OAAQ,gBAAe,KAAK,sBAAsB;AACpF,QAAI,QAAQ,eAAe,OAAQ,gBAAe,KAAK,eAAe;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,eAAe,OAAW,gBAAe,KAAK,YAAY;AACtE,QAAI,QAAQ,aAAa,OAAQ,gBAAe,KAAK,aAAa;AAClE,QACE,6BACA,gBAAgB,WAChB,MAAM,QAAQ,QAAQ,UAAU,KAChC,QAAQ,WAAW,SAAS,GAC5B;AACA,qBAAe,KAAK,YAAY;AAAA,IAClC;AACA,QAAI,QAAQ,kBAAkB,OAAW,gBAAe,KAAK,eAAe;AAAA,EAC9E;AAEA,QAAM,UAAiE;AAAA,IACrE,gBAAgB,iBAAiB,WAAW,eAAe,UAAU;AAAA,IACrE,UAAU,UAAU;AAAA,IACpB,GAAI,eAAe,SAAS,KAAK,EAAE,iBAAiB,eAAe;AAAA,IACnE,GAAI,QAAQ,QAAQ;AAAA,MAClB,cAAc;AAAA,QACZ,GAAI,QAAQ,KAAK,UAAU,UAAa,EAAE,OAAO,QAAQ,KAAK,MAAM;AAAA,QACpE,GAAI,QAAQ,KAAK,cAAc,UAAa,EAAE,WAAW,QAAQ,KAAK,UAAU;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/lib/server/decisioning/manifest-helpers.d.mts

@@ -13,6 +13,8 @@
  */
 import type { CreativeManifest } from '../../types/tools.generated.mjs';
 import type { AssetInstance, AssetInstanceType } from '../../types/asset-instances.mjs';
+/** Identity-free manifest view accepted by canonical asset helpers. */
+export type CreativeAssetsContainer = Pick<CreativeManifest, 'assets'>;
 /**
  * Type-narrowed asset accessor by asset_id and expected asset_type.
  *
@@ -32,7 +34,7 @@ import type { AssetInstance, AssetInstanceType } from '../../types/asset-instanc
  *
  * For the require-or-throw flavor, see {@link requireAsset}.
  */
-export declare function getAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T): Extract<AssetInstance, {
+export declare function getAsset<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T): Extract<AssetInstance, {
     asset_type: T;
 }> | undefined;
 /**
@@ -52,7 +54,7 @@ export declare function getAsset<T extends AssetInstanceType>(manifest: Creative
  *
  * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).
  */
-export declare function getAssetSlot<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T): Array<Extract<AssetInstance, {
+export declare function getAssetSlot<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T): Array<Extract<AssetInstance, {
     asset_type: T;
 }>> | undefined;
 /**
@@ -70,6 +72,6 @@ export declare function getAssetSlot<T extends AssetInstanceType>(manifest: Crea
  * await audioStackClient.synthesize({ text: script.content });
  * ```
  */
-export declare function requireAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T, messageOverride?: string): Extract<AssetInstance, {
+export declare function requireAsset<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T, messageOverride?: string): Extract<AssetInstance, {
     asset_type: T;
 }>;

package/dist/lib/server/decisioning/manifest-helpers.d.ts

@@ -13,6 +13,8 @@
  */
 import type { CreativeManifest } from '../../types/tools.generated';
 import type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';
+/** Identity-free manifest view accepted by canonical asset helpers. */
+export type CreativeAssetsContainer = Pick<CreativeManifest, 'assets'>;
 /**
  * Type-narrowed asset accessor by asset_id and expected asset_type.
  *
@@ -32,7 +34,7 @@ import type { AssetInstance, AssetInstanceType } from '../../types/asset-instanc
  *
  * For the require-or-throw flavor, see {@link requireAsset}.
  */
-export declare function getAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T): Extract<AssetInstance, {
+export declare function getAsset<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T): Extract<AssetInstance, {
     asset_type: T;
 }> | undefined;
 /**
@@ -52,7 +54,7 @@ export declare function getAsset<T extends AssetInstanceType>(manifest: Creative
  *
  * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).
  */
-export declare function getAssetSlot<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T): Array<Extract<AssetInstance, {
+export declare function getAssetSlot<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T): Array<Extract<AssetInstance, {
     asset_type: T;
 }>> | undefined;
 /**
@@ -70,7 +72,7 @@ export declare function getAssetSlot<T extends AssetInstanceType>(manifest: Crea
  * await audioStackClient.synthesize({ text: script.content });
  * ```
  */
-export declare function requireAsset<T extends AssetInstanceType>(manifest: CreativeManifest | undefined, assetId: string, assetType: T, messageOverride?: string): Extract<AssetInstance, {
+export declare function requireAsset<T extends AssetInstanceType>(manifest: CreativeAssetsContainer | undefined, assetId: string, assetType: T, messageOverride?: string): Extract<AssetInstance, {
     asset_type: T;
 }>;
 //# sourceMappingURL=manifest-helpers.d.ts.map

package/dist/lib/server/decisioning/manifest-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAClD,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GACX,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,SAAS,CAUvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,GAAG,SAAS,CAK9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,EACZ,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAoB3C"}
+{"version":3,"file":"manifest-helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGpF,uEAAuE;AACvE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAClD,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GACX,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,SAAS,CAUvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GACX,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,GAAG,SAAS,CAK9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,EACZ,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,EAAE;IAAE,UAAU,EAAE,CAAC,CAAA;CAAE,CAAC,CAoB3C"}

package/dist/lib/server/decisioning/manifest-helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"sourcesContent":["/**\n * Helpers for reading typed assets out of `creative_manifest.assets`.\n *\n * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)\n * where each value is a discriminated union by `asset_type`. Adopters\n * narrowing per-call write the same null-check + discriminator-check\n * boilerplate over and over. These helpers replace that boilerplate\n * without compromising the discriminator-narrowing story.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { CreativeManifest } from '../../types/tools.generated';\nimport type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';\nimport { AdcpError } from './async-outcome';\n\n/**\n * Type-narrowed asset accessor by asset_id and expected asset_type.\n *\n * Returns the asset narrowed to the matching variant, or `undefined` if the\n * asset is missing or the asset_type doesn't match. Use when you want a\n * silent skip for the wrong-type case (e.g., processing a heterogeneous\n * batch where some entries don't apply to your transform).\n *\n * ```ts\n * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');\n * // audio is `AudioAsset | undefined` — narrowed by the discriminator\n * if (audio) {\n *   const url = audio.url;             // typed access\n *   const ms = audio.duration_ms;\n * }\n * ```\n *\n * For the require-or-throw flavor, see {@link requireAsset}.\n */\nexport function getAsset<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T\n): Extract<AssetInstance, { asset_type: T }> | undefined {\n  // AdCP 3.1.0-beta.2 widened each slot from `AssetVariant` to\n  // `AssetVariant | AssetVariant[]` so carousel `cards` and\n  // responsive_creative `headlines` can carry multiple assets per slot.\n  // For single-slot callers, take the first array element — preserves the\n  // pre-3.1 behavior. Multi-asset slots use {@link getAssetSlot}.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset || asset.asset_type !== assetType) return undefined;\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n\n/**\n * Type-narrowed asset slot accessor for multi-element slots (carousel\n * `cards`, responsive_creative `headlines`, etc.). Returns the full\n * array — every element must match `assetType`; mixed-type slots are\n * the adopter's responsibility to discriminate per-element.\n *\n * Returns `undefined` only when the slot is missing from the manifest\n * (`manifest.assets[assetId]` is absent). Returns `[]` when the slot\n * is present but empty, or present and non-empty with no elements\n * matching `assetType`. Empty arrays are spec-invalid per the\n * `minItems: 1` constraint on slot arrays, but the helper accepts\n * malformed input defensively — returning `[]` is more consistent\n * with the \"filter result on the slot\" contract than collapsing it\n * to `undefined`.\n *\n * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).\n */\nexport function getAssetSlot<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T\n): Array<Extract<AssetInstance, { asset_type: T }>> | undefined {\n  const slot = manifest?.assets?.[assetId];\n  if (!slot) return undefined;\n  const arr = Array.isArray(slot) ? slot : [slot];\n  return arr.filter(a => a.asset_type === assetType) as Array<Extract<AssetInstance, { asset_type: T }>>;\n}\n\n/**\n * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when\n * the asset is missing or the wrong type. Use when the asset is required\n * for the platform method to proceed (the typical creative-template case).\n *\n * Throws with a precomposed `field` path so the buyer sees actionable\n * feedback. Customize the message via the `messageOverride` arg if the\n * default doesn't fit.\n *\n * ```ts\n * const script = requireAsset(req.creative_manifest, 'script', 'text');\n * // script is `TextAsset` — never undefined past this line\n * await audioStackClient.synthesize({ text: script.content });\n * ```\n */\nexport function requireAsset<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T,\n  messageOverride?: string\n): Extract<AssetInstance, { asset_type: T }> {\n  // Slot widening (3.1.0-beta.2): unwrap array slots to the first element\n  // for single-asset callers. Multi-element slots go through getAssetSlot.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message: messageOverride ?? `creative_manifest.assets.${assetId} is required`,\n      field: `creative_manifest.assets.${assetId}`,\n    });\n  }\n  if (asset.asset_type !== assetType) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message:\n        messageOverride ??\n        `creative_manifest.assets.${assetId} must be a ${assetType} asset (got asset_type='${asset.asset_type}')`,\n      field: `creative_manifest.assets.${assetId}.asset_type`,\n    });\n  }\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,2BAA0B;AAqBnB,SAAS,SACd,UACA,SACA,WACuD;AAMvD,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,SAAS,MAAM,eAAe,UAAW,QAAO;AACrD,SAAO;AACT;AAmBO,SAAS,aACd,UACA,SACA,WAC8D;AAC9D,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,SAAO,IAAI,OAAO,OAAK,EAAE,eAAe,SAAS;AACnD;AAiBO,SAAS,aACd,UACA,SACA,WACA,iBAC2C;AAG3C,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,+BAAU,mBAAmB;AAAA,MACrC,SAAS,mBAAmB,4BAA4B,OAAO;AAAA,MAC/D,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,MAAI,MAAM,eAAe,WAAW;AAClC,UAAM,IAAI,+BAAU,mBAAmB;AAAA,MACrC,SACE,mBACA,4BAA4B,OAAO,cAAc,SAAS,2BAA2B,MAAM,UAAU;AAAA,MACvG,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"sourcesContent":["/**\n * Helpers for reading typed assets out of `creative_manifest.assets`.\n *\n * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)\n * where each value is a discriminated union by `asset_type`. Adopters\n * narrowing per-call write the same null-check + discriminator-check\n * boilerplate over and over. These helpers replace that boilerplate\n * without compromising the discriminator-narrowing story.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { CreativeManifest } from '../../types/tools.generated';\nimport type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';\nimport { AdcpError } from './async-outcome';\n\n/** Identity-free manifest view accepted by canonical asset helpers. */\nexport type CreativeAssetsContainer = Pick<CreativeManifest, 'assets'>;\n\n/**\n * Type-narrowed asset accessor by asset_id and expected asset_type.\n *\n * Returns the asset narrowed to the matching variant, or `undefined` if the\n * asset is missing or the asset_type doesn't match. Use when you want a\n * silent skip for the wrong-type case (e.g., processing a heterogeneous\n * batch where some entries don't apply to your transform).\n *\n * ```ts\n * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');\n * // audio is `AudioAsset | undefined` — narrowed by the discriminator\n * if (audio) {\n *   const url = audio.url;             // typed access\n *   const ms = audio.duration_ms;\n * }\n * ```\n *\n * For the require-or-throw flavor, see {@link requireAsset}.\n */\nexport function getAsset<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T\n): Extract<AssetInstance, { asset_type: T }> | undefined {\n  // AdCP 3.1.0-beta.2 widened each slot from `AssetVariant` to\n  // `AssetVariant | AssetVariant[]` so carousel `cards` and\n  // responsive_creative `headlines` can carry multiple assets per slot.\n  // For single-slot callers, take the first array element — preserves the\n  // pre-3.1 behavior. Multi-asset slots use {@link getAssetSlot}.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset || asset.asset_type !== assetType) return undefined;\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n\n/**\n * Type-narrowed asset slot accessor for multi-element slots (carousel\n * `cards`, responsive_creative `headlines`, etc.). Returns the full\n * array — every element must match `assetType`; mixed-type slots are\n * the adopter's responsibility to discriminate per-element.\n *\n * Returns `undefined` only when the slot is missing from the manifest\n * (`manifest.assets[assetId]` is absent). Returns `[]` when the slot\n * is present but empty, or present and non-empty with no elements\n * matching `assetType`. Empty arrays are spec-invalid per the\n * `minItems: 1` constraint on slot arrays, but the helper accepts\n * malformed input defensively — returning `[]` is more consistent\n * with the \"filter result on the slot\" contract than collapsing it\n * to `undefined`.\n *\n * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).\n */\nexport function getAssetSlot<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T\n): Array<Extract<AssetInstance, { asset_type: T }>> | undefined {\n  const slot = manifest?.assets?.[assetId];\n  if (!slot) return undefined;\n  const arr = Array.isArray(slot) ? slot : [slot];\n  return arr.filter(a => a.asset_type === assetType) as Array<Extract<AssetInstance, { asset_type: T }>>;\n}\n\n/**\n * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when\n * the asset is missing or the wrong type. Use when the asset is required\n * for the platform method to proceed (the typical creative-template case).\n *\n * Throws with a precomposed `field` path so the buyer sees actionable\n * feedback. Customize the message via the `messageOverride` arg if the\n * default doesn't fit.\n *\n * ```ts\n * const script = requireAsset(req.creative_manifest, 'script', 'text');\n * // script is `TextAsset` — never undefined past this line\n * await audioStackClient.synthesize({ text: script.content });\n * ```\n */\nexport function requireAsset<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T,\n  messageOverride?: string\n): Extract<AssetInstance, { asset_type: T }> {\n  // Slot widening (3.1.0-beta.2): unwrap array slots to the first element\n  // for single-asset callers. Multi-element slots go through getAssetSlot.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message: messageOverride ?? `creative_manifest.assets.${assetId} is required`,\n      field: `creative_manifest.assets.${assetId}`,\n    });\n  }\n  if (asset.asset_type !== assetType) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message:\n        messageOverride ??\n        `creative_manifest.assets.${assetId} must be a ${assetType} asset (got asset_type='${asset.asset_type}')`,\n      field: `creative_manifest.assets.${assetId}.asset_type`,\n    });\n  }\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,2BAA0B;AAwBnB,SAAS,SACd,UACA,SACA,WACuD;AAMvD,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,SAAS,MAAM,eAAe,UAAW,QAAO;AACrD,SAAO;AACT;AAmBO,SAAS,aACd,UACA,SACA,WAC8D;AAC9D,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,SAAO,IAAI,OAAO,OAAK,EAAE,eAAe,SAAS;AACnD;AAiBO,SAAS,aACd,UACA,SACA,WACA,iBAC2C;AAG3C,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,+BAAU,mBAAmB;AAAA,MACrC,SAAS,mBAAmB,4BAA4B,OAAO;AAAA,MAC/D,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,MAAI,MAAM,eAAe,WAAW;AAClC,UAAM,IAAI,+BAAU,mBAAmB;AAAA,MACrC,SACE,mBACA,4BAA4B,OAAO,cAAc,SAAS,2BAA2B,MAAM,UAAU;AAAA,MACvG,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}

package/dist/lib/server/decisioning/manifest-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"sourcesContent":["/**\n * Helpers for reading typed assets out of `creative_manifest.assets`.\n *\n * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)\n * where each value is a discriminated union by `asset_type`. Adopters\n * narrowing per-call write the same null-check + discriminator-check\n * boilerplate over and over. These helpers replace that boilerplate\n * without compromising the discriminator-narrowing story.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { CreativeManifest } from '../../types/tools.generated';\nimport type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';\nimport { AdcpError } from './async-outcome';\n\n/**\n * Type-narrowed asset accessor by asset_id and expected asset_type.\n *\n * Returns the asset narrowed to the matching variant, or `undefined` if the\n * asset is missing or the asset_type doesn't match. Use when you want a\n * silent skip for the wrong-type case (e.g., processing a heterogeneous\n * batch where some entries don't apply to your transform).\n *\n * ```ts\n * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');\n * // audio is `AudioAsset | undefined` — narrowed by the discriminator\n * if (audio) {\n *   const url = audio.url;             // typed access\n *   const ms = audio.duration_ms;\n * }\n * ```\n *\n * For the require-or-throw flavor, see {@link requireAsset}.\n */\nexport function getAsset<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T\n): Extract<AssetInstance, { asset_type: T }> | undefined {\n  // AdCP 3.1.0-beta.2 widened each slot from `AssetVariant` to\n  // `AssetVariant | AssetVariant[]` so carousel `cards` and\n  // responsive_creative `headlines` can carry multiple assets per slot.\n  // For single-slot callers, take the first array element — preserves the\n  // pre-3.1 behavior. Multi-asset slots use {@link getAssetSlot}.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset || asset.asset_type !== assetType) return undefined;\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n\n/**\n * Type-narrowed asset slot accessor for multi-element slots (carousel\n * `cards`, responsive_creative `headlines`, etc.). Returns the full\n * array — every element must match `assetType`; mixed-type slots are\n * the adopter's responsibility to discriminate per-element.\n *\n * Returns `undefined` only when the slot is missing from the manifest\n * (`manifest.assets[assetId]` is absent). Returns `[]` when the slot\n * is present but empty, or present and non-empty with no elements\n * matching `assetType`. Empty arrays are spec-invalid per the\n * `minItems: 1` constraint on slot arrays, but the helper accepts\n * malformed input defensively — returning `[]` is more consistent\n * with the \"filter result on the slot\" contract than collapsing it\n * to `undefined`.\n *\n * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).\n */\nexport function getAssetSlot<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T\n): Array<Extract<AssetInstance, { asset_type: T }>> | undefined {\n  const slot = manifest?.assets?.[assetId];\n  if (!slot) return undefined;\n  const arr = Array.isArray(slot) ? slot : [slot];\n  return arr.filter(a => a.asset_type === assetType) as Array<Extract<AssetInstance, { asset_type: T }>>;\n}\n\n/**\n * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when\n * the asset is missing or the wrong type. Use when the asset is required\n * for the platform method to proceed (the typical creative-template case).\n *\n * Throws with a precomposed `field` path so the buyer sees actionable\n * feedback. Customize the message via the `messageOverride` arg if the\n * default doesn't fit.\n *\n * ```ts\n * const script = requireAsset(req.creative_manifest, 'script', 'text');\n * // script is `TextAsset` — never undefined past this line\n * await audioStackClient.synthesize({ text: script.content });\n * ```\n */\nexport function requireAsset<T extends AssetInstanceType>(\n  manifest: CreativeManifest | undefined,\n  assetId: string,\n  assetType: T,\n  messageOverride?: string\n): Extract<AssetInstance, { asset_type: T }> {\n  // Slot widening (3.1.0-beta.2): unwrap array slots to the first element\n  // for single-asset callers. Multi-element slots go through getAssetSlot.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message: messageOverride ?? `creative_manifest.assets.${assetId} is required`,\n      field: `creative_manifest.assets.${assetId}`,\n    });\n  }\n  if (asset.asset_type !== assetType) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message:\n        messageOverride ??\n        `creative_manifest.assets.${assetId} must be a ${assetType} asset (got asset_type='${asset.asset_type}')`,\n      field: `creative_manifest.assets.${assetId}.asset_type`,\n    });\n  }\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n"],"mappings":"AAgBA,SAAS,iBAAiB;AAqBnB,SAAS,SACd,UACA,SACA,WACuD;AAMvD,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,SAAS,MAAM,eAAe,UAAW,QAAO;AACrD,SAAO;AACT;AAmBO,SAAS,aACd,UACA,SACA,WAC8D;AAC9D,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,SAAO,IAAI,OAAO,OAAK,EAAE,eAAe,SAAS;AACnD;AAiBO,SAAS,aACd,UACA,SACA,WACA,iBAC2C;AAG3C,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,UAAU,mBAAmB;AAAA,MACrC,SAAS,mBAAmB,4BAA4B,OAAO;AAAA,MAC/D,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,MAAI,MAAM,eAAe,WAAW;AAClC,UAAM,IAAI,UAAU,mBAAmB;AAAA,MACrC,SACE,mBACA,4BAA4B,OAAO,cAAc,SAAS,2BAA2B,MAAM,UAAU;AAAA,MACvG,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/lib/server/decisioning/manifest-helpers.ts"],"sourcesContent":["/**\n * Helpers for reading typed assets out of `creative_manifest.assets`.\n *\n * `creative_manifest.assets` is a keyed map (`{ [asset_id]: AssetInstance }`)\n * where each value is a discriminated union by `asset_type`. Adopters\n * narrowing per-call write the same null-check + discriminator-check\n * boilerplate over and over. These helpers replace that boilerplate\n * without compromising the discriminator-narrowing story.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport type { CreativeManifest } from '../../types/tools.generated';\nimport type { AssetInstance, AssetInstanceType } from '../../types/asset-instances';\nimport { AdcpError } from './async-outcome';\n\n/** Identity-free manifest view accepted by canonical asset helpers. */\nexport type CreativeAssetsContainer = Pick<CreativeManifest, 'assets'>;\n\n/**\n * Type-narrowed asset accessor by asset_id and expected asset_type.\n *\n * Returns the asset narrowed to the matching variant, or `undefined` if the\n * asset is missing or the asset_type doesn't match. Use when you want a\n * silent skip for the wrong-type case (e.g., processing a heterogeneous\n * batch where some entries don't apply to your transform).\n *\n * ```ts\n * const audio = getAsset(req.creative_manifest, 'rendered_audio', 'audio');\n * // audio is `AudioAsset | undefined` — narrowed by the discriminator\n * if (audio) {\n *   const url = audio.url;             // typed access\n *   const ms = audio.duration_ms;\n * }\n * ```\n *\n * For the require-or-throw flavor, see {@link requireAsset}.\n */\nexport function getAsset<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T\n): Extract<AssetInstance, { asset_type: T }> | undefined {\n  // AdCP 3.1.0-beta.2 widened each slot from `AssetVariant` to\n  // `AssetVariant | AssetVariant[]` so carousel `cards` and\n  // responsive_creative `headlines` can carry multiple assets per slot.\n  // For single-slot callers, take the first array element — preserves the\n  // pre-3.1 behavior. Multi-asset slots use {@link getAssetSlot}.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset || asset.asset_type !== assetType) return undefined;\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n\n/**\n * Type-narrowed asset slot accessor for multi-element slots (carousel\n * `cards`, responsive_creative `headlines`, etc.). Returns the full\n * array — every element must match `assetType`; mixed-type slots are\n * the adopter's responsibility to discriminate per-element.\n *\n * Returns `undefined` only when the slot is missing from the manifest\n * (`manifest.assets[assetId]` is absent). Returns `[]` when the slot\n * is present but empty, or present and non-empty with no elements\n * matching `assetType`. Empty arrays are spec-invalid per the\n * `minItems: 1` constraint on slot arrays, but the helper accepts\n * malformed input defensively — returning `[]` is more consistent\n * with the \"filter result on the slot\" contract than collapsing it\n * to `undefined`.\n *\n * @since AdCP 3.1.0-beta.2 (slot widening to `AssetVariant | AssetVariant[]`).\n */\nexport function getAssetSlot<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T\n): Array<Extract<AssetInstance, { asset_type: T }>> | undefined {\n  const slot = manifest?.assets?.[assetId];\n  if (!slot) return undefined;\n  const arr = Array.isArray(slot) ? slot : [slot];\n  return arr.filter(a => a.asset_type === assetType) as Array<Extract<AssetInstance, { asset_type: T }>>;\n}\n\n/**\n * Same as {@link getAsset} but throws `AdcpError('INVALID_REQUEST')` when\n * the asset is missing or the wrong type. Use when the asset is required\n * for the platform method to proceed (the typical creative-template case).\n *\n * Throws with a precomposed `field` path so the buyer sees actionable\n * feedback. Customize the message via the `messageOverride` arg if the\n * default doesn't fit.\n *\n * ```ts\n * const script = requireAsset(req.creative_manifest, 'script', 'text');\n * // script is `TextAsset` — never undefined past this line\n * await audioStackClient.synthesize({ text: script.content });\n * ```\n */\nexport function requireAsset<T extends AssetInstanceType>(\n  manifest: CreativeAssetsContainer | undefined,\n  assetId: string,\n  assetType: T,\n  messageOverride?: string\n): Extract<AssetInstance, { asset_type: T }> {\n  // Slot widening (3.1.0-beta.2): unwrap array slots to the first element\n  // for single-asset callers. Multi-element slots go through getAssetSlot.\n  const slot = manifest?.assets?.[assetId];\n  const asset = Array.isArray(slot) ? slot[0] : slot;\n  if (!asset) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message: messageOverride ?? `creative_manifest.assets.${assetId} is required`,\n      field: `creative_manifest.assets.${assetId}`,\n    });\n  }\n  if (asset.asset_type !== assetType) {\n    throw new AdcpError('INVALID_REQUEST', {\n      message:\n        messageOverride ??\n        `creative_manifest.assets.${assetId} must be a ${assetType} asset (got asset_type='${asset.asset_type}')`,\n      field: `creative_manifest.assets.${assetId}.asset_type`,\n    });\n  }\n  return asset as Extract<AssetInstance, { asset_type: T }>;\n}\n"],"mappings":"AAgBA,SAAS,iBAAiB;AAwBnB,SAAS,SACd,UACA,SACA,WACuD;AAMvD,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,SAAS,MAAM,eAAe,UAAW,QAAO;AACrD,SAAO;AACT;AAmBO,SAAS,aACd,UACA,SACA,WAC8D;AAC9D,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC9C,SAAO,IAAI,OAAO,OAAK,EAAE,eAAe,SAAS;AACnD;AAiBO,SAAS,aACd,UACA,SACA,WACA,iBAC2C;AAG3C,QAAM,OAAO,UAAU,SAAS,OAAO;AACvC,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAC9C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,UAAU,mBAAmB;AAAA,MACrC,SAAS,mBAAmB,4BAA4B,OAAO;AAAA,MAC/D,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,MAAI,MAAM,eAAe,WAAW;AAClC,UAAM,IAAI,UAAU,mBAAmB;AAAA,MACrC,SACE,mBACA,4BAA4B,OAAO,cAAc,SAAS,2BAA2B,MAAM,UAAU;AAAA,MACvG,OAAO,4BAA4B,OAAO;AAAA,IAC5C,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":[]}

package/dist/lib/server/decisioning/proposal/dispatch.d.mts

@@ -35,7 +35,7 @@
  * @packageDocumentation
  */
 import { type TaskHandoff } from '../async-outcome.mjs';
-import type { GetProductsRequest } from '../../../types/tools.generated.mjs';
+import type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery.mjs';
 import type { ProposalRecord, ProposalStore } from './store.mjs';
 import type { FinalizeProposalSuccess, ProposalGetProductsPayload, ProposalManager, Recipe } from './types.mjs';
 /**
@@ -88,7 +88,7 @@ export type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> = {
  * @public
  */
 export declare function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {
-    request: GetProductsRequest;
+    request: CanonicalGetProductsRequest;
     manager: ProposalManager<TRecipe, TCtxMeta> | undefined;
     store: ProposalStore<TRecipe> | undefined;
     ctx: {

package/dist/lib/server/decisioning/proposal/dispatch.d.ts

@@ -35,7 +35,7 @@
  * @packageDocumentation
  */
 import { type TaskHandoff } from '../async-outcome';
-import type { GetProductsRequest } from '../../../types/tools.generated';
+import type { CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';
 import type { ProposalRecord, ProposalStore } from './store';
 import type { FinalizeProposalSuccess, ProposalGetProductsPayload, ProposalManager, Recipe } from './types';
 /**
@@ -88,7 +88,7 @@ export type FinalizeInterceptResult<TRecipe extends Recipe = Recipe> = {
  * @public
  */
 export declare function maybeInterceptFinalize<TRecipe extends Recipe, TCtxMeta>(args: {
-    request: GetProductsRequest;
+    request: CanonicalGetProductsRequest;
     manager: ProposalManager<TRecipe, TCtxMeta> | undefined;
     store: ProposalStore<TRecipe> | undefined;
     ctx: {

package/dist/lib/server/decisioning/proposal/dispatch.d.ts.map

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