@adcp/sdk 14.0.0-beta.8 → 14.0.0-beta.9

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

@@ -38,6 +38,7 @@ import { composeMethod } from "./compose.mjs";
 import { requireAccountMatch, requireAdvertiserMatch, requireOrgScope } from "./resolve-presets.mjs";
 import {
   createAdcpServerFromPlatform,
+  getHydratedLegacyFormatIds,
   getAllAdcpMigrations
 } from "./runtime/from-platform.mjs";
 import { PlatformConfigError, validatePlatform } from "./runtime/validate-platform.mjs";
@@ -170,6 +171,7 @@ export {
   getAsset,
   getAssetSlot,
   getDecisioningTaskRegistryMigration,
+  getHydratedLegacyFormatIds,
   getStatusChangeBus,
   identityStatusMappers,
   maybeHydrateRecipesForMediaBuyId,

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  LegacyBuildCreativeReturn,\n  LegacyBuildCreativePayload,\n  LegacyBuildCreativeMultiPayload,\n  PreviewCreativePayload,\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  PreviewCreativePayload as CreativeAdServerPreviewCreativePayload,\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  MediaBuyLifecyclePlatform,\n  MediaBuyLifecycleCorePlatform,\n  MediaBuyLifecycleProposalPlatform,\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  ListProductsPayload,\n  RequestProposalsPayload,\n  RefineProposalsPayload,\n  DeclineProposalsPayload,\n  BuyProductsPayload,\n  AcceptProposalPayload,\n  ControlMediaBuyPayload,\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;AA2K7E;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":[]}
+{"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  PreviewCreativePayload,\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  PreviewCreativePayload as CreativeAdServerPreviewCreativePayload,\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  MediaBuyLifecyclePlatform,\n  MediaBuyLifecycleCorePlatform,\n  MediaBuyLifecycleProposalPlatform,\n  GetProductsPayload,\n  GetProductsProjectionInput,\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  ListProductsPayload,\n  RequestProposalsPayload,\n  RefineProposalsPayload,\n  DeclineProposalsPayload,\n  BuyProductsPayload,\n  AcceptProposalPayload,\n  ControlMediaBuyPayload,\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  getHydratedLegacyFormatIds,\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;AA4K7E;AAAA,EACE;AAAA,EACA;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/proposal/types.d.mts

@@ -32,11 +32,12 @@ import type { MaybePromise } from '../../create-adcp-server.mjs';
 import type { Account } from '../account.mjs';
 import type { RequestContext } from '../context.mjs';
 import type { GetProductsResponse } from '../../../types/tools.generated.mjs';
-import type { CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalProduct } from '../../../v2/projection/creative-delivery.mjs';
+import type { CanonicalCreativeResponse, CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery.mjs';
 import type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload.mjs';
 import type { TaskHandoff } from '../async-outcome.mjs';
+import type { GetProductsProjectionInput } from '../specialisms/sales.mjs';
 export type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {
-    products?: CanonicalProduct[];
+    products?: GetProductsProjectionInput[];
 }>;
 export type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
 /**

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

@@ -32,11 +32,12 @@ import type { MaybePromise } from '../../create-adcp-server';
 import type { Account } from '../account';
 import type { RequestContext } from '../context';
 import type { GetProductsResponse } from '../../../types/tools.generated';
-import type { CanonicalCreativeResponse, CanonicalGetProductsRequest, CanonicalProduct } from '../../../v2/projection/creative-delivery';
+import type { CanonicalCreativeResponse, CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';
 import type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';
 import type { TaskHandoff } from '../async-outcome';
+import type { GetProductsProjectionInput } from '../specialisms/sales';
 export type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {
-    products?: CanonicalProduct[];
+    products?: GetProductsProjectionInput[];
 }>;
 export type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;
 /**

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

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

package/dist/lib/server/decisioning/proposal/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/types.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * The existing `DecisioningPlatform` conflates two concerns: assembling\n * proposals from briefs (`get_products`, refine) vs. executing media buys\n * against an upstream (`create_media_buy`, `update_media_buy`,\n * `get_media_buy_delivery`). The two-platform composition splits them: a\n * separate {@link ProposalManager} handles the proposal side; the\n * `DecisioningPlatform` keeps the execution side. Either platform can be\n * mock-backed independently.\n *\n * Ports the Python primitives shipped in `adcp-client-python` PRs #504\n * (v1) and #550 (v1.5):\n *\n *   - {@link ProposalManager} — interface with `getProducts` (required)\n *     plus optional `refineProducts` and `finalizeProposal`.\n *   - {@link ProposalCapabilities} — sales-axis-scoped capability flags.\n *   - {@link Recipe} — typed `recipe_kind`-discriminated base; adopters\n *     subclass with their internal-config schema. Rides on\n *     `Product.implementation_config` (opaque to the buyer).\n *   - {@link CapabilityOverlap} — typed declaration of which wire\n *     capabilities the buyer can configure on a product. The framework\n *     validates buyer requests against the overlap pre-adapter.\n *   - {@link FinalizeProposalRequest} / {@link FinalizeProposalSuccess} —\n *     framework-internal shapes for the finalize lifecycle (wired in the\n *     v1.5 dispatch helpers).\n *\n * @public\n * @packageDocumentation\n */\n\nimport type { MaybePromise } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { GetProductsResponse } from '../../../types/tools.generated';\nimport type {\n  CanonicalCreativeResponse,\n  CanonicalGetProductsRequest,\n  CanonicalProduct,\n} from '../../../v2/projection/creative-delivery';\nimport type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type { TaskHandoff } from '../async-outcome';\n\nexport type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<\n  Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & { products?: CanonicalProduct[] }\n>;\nexport type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\n\n// ---------------------------------------------------------------------------\n// Capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Sales specialisms a {@link ProposalManager} can serve. Mirrors the\n * `sales-*` slugs in the spec's specialism enum.\n *\n * v1 scopes to the two `ProposalManager`-relevant flavours; broader\n * coverage (broadcast-tv, social, proposal-mode, catalog-driven) lands\n * as adopter signal grows.\n *\n * @public\n */\nexport type ProposalSalesSpecialism = 'sales-guaranteed' | 'sales-non-guaranteed';\n\n/**\n * Capability declaration for a {@link ProposalManager}.\n *\n * Sales-axis-scoped: proposal handling is a sales-specialism concern,\n * not a generic platform-wide concept. The `salesSpecialism` field\n * declares which AdCP sales specialism this manager serves; capability\n * flags declare which optional behaviours it supports.\n *\n * The framework reads this declaration at server-construction time to\n * decide which dispatch paths apply (e.g. `refineProducts` is only\n * invoked when `refine` is true; `finalizeProposal` is only invoked\n * when `finalize` is true).\n *\n * @public\n */\nexport interface ProposalCapabilities {\n  /**\n   * Which AdCP sales specialism this manager serves.\n   *\n   * `sales-guaranteed` for guaranteed-direct flows with proposal\n   * lifecycle (finalize → committed proposal → media buy).\n   *\n   * `sales-non-guaranteed` for catalog-style flows where `getProducts`\n   * returns a static catalog and buyers reference products directly at\n   * `create_media_buy`.\n   */\n  salesSpecialism: ProposalSalesSpecialism;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.refineProducts}\n   * and the framework routes `get_products` requests with\n   * `buying_mode: 'refine'` to that method. When false, refine requests\n   * fall through to `getProducts` (or surface `UNSUPPORTED_FEATURE` if\n   * the manager rejects them).\n   */\n  refine?: boolean;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.finalizeProposal}\n   * and the framework intercepts `refine[i].action: 'finalize'` entries to\n   * commit drafts via the lifecycle helpers. When false, finalize entries\n   * pass through to the underlying `getProducts` / `refineProducts` method\n   * unchanged.\n   */\n  finalize?: boolean;\n\n  /**\n   * Grace window (in seconds) added to a committed proposal's `expires_at`\n   * before the framework rejects `create_media_buy` calls referencing the\n   * proposal with `PROPOSAL_EXPIRED`. Default 0 (strict).\n   */\n  expiresAtGraceSeconds?: number;\n\n  /**\n   * Signal-driven product assembly — the manager constructs products from\n   * buyer signals at request time rather than enumerating a static\n   * catalogue. Informational in v1.5; future PRs may validate that\n   * inventory / signal stores are wired when this flag is set.\n   */\n  dynamicProducts?: boolean;\n\n  /**\n   * The manager consults rate cards (per buyer relationship per product)\n   * when emitting prices. Informational in v1.5.\n   */\n  rateCardPricing?: boolean;\n\n  /**\n   * The manager reserves capacity at proposal time (typical for\n   * guaranteed). Informational in v1.5; the `finalize` transition that\n   * drives the actual hold is wired via the lifecycle helpers.\n   */\n  availabilityReservations?: boolean;\n}\n\n/**\n * Validate a {@link ProposalCapabilities} object. Throws when the declaration\n * is malformed (unknown `salesSpecialism`, negative `expiresAtGraceSeconds`).\n * The framework calls this at boot; adopters can call it from their own\n * config-validation code paths to fail fast on misconfiguration.\n *\n * Kept as a plain function rather than a class constructor to match the\n * codebase's preference for plain TS interfaces over runtime classes\n * for adopter-facing types.\n *\n * @public\n */\nexport function validateProposalCapabilities(caps: ProposalCapabilities): void {\n  const valid: readonly ProposalSalesSpecialism[] = ['sales-guaranteed', 'sales-non-guaranteed'];\n  if (!valid.includes(caps.salesSpecialism)) {\n    throw new Error(\n      `ProposalCapabilities.salesSpecialism must be one of ${JSON.stringify(valid)}. ` +\n        `Got ${JSON.stringify(caps.salesSpecialism)}. v1.5 scopes ProposalManager to the two ` +\n        `core sales specialisms; broader specialism support lands in subsequent releases.`\n    );\n  }\n  if (caps.expiresAtGraceSeconds != null && caps.expiresAtGraceSeconds < 0) {\n    throw new Error(\n      `ProposalCapabilities.expiresAtGraceSeconds must be >= 0; got ${caps.expiresAtGraceSeconds}. ` +\n        `The grace window extends the inventory hold past expires_at; negative values would shrink it.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Recipe + CapabilityOverlap\n// ---------------------------------------------------------------------------\n\n/**\n * Per-product subset of wire capability flags that the buyer can\n * configure on this product.\n *\n * Buyer requests asking for capabilities outside this overlap are\n * rejected by the framework before the adapter sees them (validated by\n * the lifecycle helpers — see `proposal/lifecycle.ts`).\n *\n * Each field is `ReadonlySet<string> | undefined`:\n *\n *   - `undefined` → framework does not gate this axis (open).\n *   - `ReadonlySet` → buyer choices must be subsets of this set.\n *     An empty set means deny-all on this axis.\n *\n * The undefined vs. empty-set distinction matches set intuition:\n * \"no constraint\" is `undefined`; \"allowed set is empty\" is `new Set()`.\n *\n * **Why no extras dict?** v1.5 deliberately omits an `extras` escape\n * hatch (per Python design § D4). Adopters with novel gating needs\n * extend the interface with typed fields; a dict bag leaves no paper\n * trail. If a new axis turns out to be widely useful, it lands as a\n * typed field on `CapabilityOverlap` upstream.\n *\n * @public\n */\nexport interface CapabilityOverlap {\n  /**\n   * Subset of wire `pricing_models` the buyer can choose. Validated\n   * against the matching `PricingOption.pricing_model` on the buyer's\n   * package.\n   */\n  pricingModels?: ReadonlySet<string>;\n\n  /**\n   * Subset of wire targeting dimensions (`geo`, `device_type`,\n   * `language`, etc.). Validated against the keys present on the\n   * buyer's `targeting_overlay`.\n   */\n  targetingDimensions?: ReadonlySet<string>;\n\n  /**\n   * Subset of `{ guaranteed, non_guaranteed }` the product offers.\n   */\n  deliveryTypes?: ReadonlySet<string>;\n\n  /**\n   * If the seller integrates signals, which signal types this product\n   * accepts. An empty set means the seller explicitly refuses all\n   * signals on this product; `undefined` means no framework gate.\n   */\n  signalTypes?: ReadonlySet<string>;\n}\n\n/**\n * Base type for typed product `implementation_config` payloads.\n *\n * Adopters declare a discriminated subtype with a literal `recipe_kind`:\n *\n * ```ts\n * interface GAMRecipe extends Recipe {\n *   recipe_kind: 'gam';\n *   line_item_template_id: string;\n *   ad_unit_ids: readonly string[];\n *   capability_overlap?: CapabilityOverlap;\n * }\n * ```\n *\n * The kind tag enables router-by-recipe-kind dispatch in the\n * multi-decisioning case (one ProposalManager + many DecisioningPlatforms,\n * each handling a subset of recipe kinds). v1.5 doesn't yet wire that\n * routing — adopters using a single DecisioningPlatform attach recipes\n * freely without registry validation.\n *\n * **The recipe is never on the buyer's wire surface.** It rides inside\n * `Product.implementation_config` (an opaque-to-buyer dict). Buyers treat\n * it as a black box; the framework persists it through the proposal\n * lifecycle so the executing DecisioningPlatform sees a stable view.\n *\n * `capability_overlap` is optional. When present, the framework activates\n * the v1.5 buyer-request validation seam against the declared subsets.\n *\n * @public\n */\nexport interface Recipe {\n  /** Adapter-family discriminator. Subtypes narrow with a literal type. */\n  recipe_kind: string;\n\n  /**\n   * Optional typed declaration of which wire capabilities the buyer can\n   * configure on this product. `undefined` means no framework gating.\n   * An explicit {@link CapabilityOverlap} activates the v1.5 validation.\n   */\n  capability_overlap?: CapabilityOverlap;\n}\n\n// ---------------------------------------------------------------------------\n// Finalize lifecycle shapes\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-internal request shape passed to {@link ProposalManager.finalizeProposal}.\n *\n * Constructed by the framework dispatcher when a buyer's `get_products`\n * request with `buying_mode: 'refine'` carries a `refine[i].action: 'finalize'`\n * entry. Adopters don't parse the wire envelope; the framework projects.\n *\n * @public\n */\nexport interface FinalizeProposalRequest<TRecipe extends Recipe = Recipe> {\n  /**\n   * The draft proposal the buyer is asking to finalize. Hydrated from\n   * the wire's `refine[i].proposal_id` field.\n   */\n  proposalId: string;\n\n  /**\n   * `product_id -> Recipe` mapping pulled from the {@link ProposalStore}\n   * draft. The adopter's finalize logic typically lock-prices these and\n   * emits the committed proposal.\n   */\n  recipes: ReadonlyMap<string, TRecipe>;\n\n  /**\n   * The draft's wire `Proposal` shape (the same payload the adopter\n   * returned on the prior `getProducts` / `refineProducts` call).\n   * Adopter typically modifies this with locked pricing and returns it\n   * on {@link FinalizeProposalSuccess}.\n   */\n  proposalPayload: Record<string, unknown>;\n\n  /**\n   * The buyer's per-entry refine `ask` text — what they want finalized.\n   * Free-form; adopter consumes.\n   */\n  ask?: string;\n\n  /**\n   * The parent canonical get-products request so the adopter sees the full\n   * envelope (account, etc.) without the framework projecting fields\n   * one-by-one.\n   */\n  parentRequest: CanonicalGetProductsRequest;\n}\n\n/**\n * Adopter-returned shape from {@link ProposalManager.finalizeProposal} —\n * inline commit.\n *\n * Framework calls `ProposalStore.commit` with these fields before\n * projecting the wire response. The buyer sees the committed `Proposal`\n * with `proposal_status: 'committed'` + `expires_at` populated on the\n * next `get_products` response payload.\n *\n * @public\n */\nexport interface FinalizeProposalSuccess<TRecipe extends Recipe = Recipe> {\n  /**\n   * The wire `Proposal` shape with locked pricing and\n   * `proposal_status: 'committed'`. Adopter typically derives this from\n   * {@link FinalizeProposalRequest.proposalPayload} with modifications.\n   *\n   * **Must be JSON-serializable end-to-end** — non-JSON values won't\n   * survive a process restart through a durable {@link ProposalStore}.\n   */\n  proposal: Record<string, unknown>;\n\n  /**\n   * Inventory hold deadline. After this (plus the adopter's\n   * {@link ProposalCapabilities.expiresAtGraceSeconds} window), the\n   * framework rejects `create_media_buy` calls referencing the proposal\n   * with `PROPOSAL_EXPIRED`.\n   */\n  expiresAt: Date;\n\n  /**\n   * Optional refreshed recipe mapping. Omitting preserves the draft's\n   * recipes verbatim. Adopters whose finalize logic mutates recipe\n   * fields (e.g. locking a line-item template id) supply a fresh\n   * mapping.\n   */\n  recipes?: ReadonlyMap<string, TRecipe>;\n}\n\n// ---------------------------------------------------------------------------\n// ProposalManager interface\n// ---------------------------------------------------------------------------\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\n/**\n * Assembles proposals from buyer briefs.\n *\n * Reads inventory, signals, rate cards, availability. Produces proposals\n * where each `Product` carries a typed `implementation_config` (a recipe;\n * see {@link Recipe}) that the bound `DecisioningPlatform` consumes at\n * `create_media_buy` time.\n *\n * Methods may be sync or async; the framework awaits whatever is\n * returned. Same convention as `SalesPlatform`.\n *\n * **Required surface:** {@link getProducts}.\n *\n * **Optional surfaces (capability-gated):**\n *\n *   - {@link refineProducts} — only invoked when\n *     {@link ProposalCapabilities.refine} is true.\n *   - {@link finalizeProposal} — only invoked when\n *     {@link ProposalCapabilities.finalize} is true. Wired by the\n *     framework's lifecycle helpers; intercepts `refine[i].action: 'finalize'`\n *     entries before the underlying `getProducts` / `refineProducts` runs.\n *\n * Throw `AdcpError` for buyer-fixable rejection (`BUDGET_TOO_LOW`,\n * `POLICY_VIOLATION`, `UNSUPPORTED_FEATURE`); the framework projects to\n * the wire structured-error envelope.\n *\n * Adopter typing tip: parameterize on your concrete `Recipe` subtype to\n * get end-to-end recipe typing through `ctx.recipes` in the bound\n * `DecisioningPlatform`'s methods:\n *\n * ```ts\n * type MyRecipe = GAMRecipe | KevelRecipe;\n * const manager: ProposalManager<MyRecipe, MyTenantMeta> = { ... };\n * ```\n *\n * @public\n */\nexport interface ProposalManager<TRecipe extends Recipe = Recipe, TCtxMeta = unknown> {\n  /**\n   * What this ProposalManager can do — sales specialism + capability flags.\n   */\n  capabilities: ProposalCapabilities;\n\n  /**\n   * Initial product discovery from a buyer brief.\n   *\n   * Each returned `Product` SHOULD carry an `implementation_config`\n   * matching the bound `DecisioningPlatform`'s recipe schema (see\n   * {@link Recipe}). The framework treats `implementation_config` as\n   * opaque on the wire; recipe typing is enforced through the\n   * `TRecipe` type parameter on the adopter side.\n   *\n   * For non-guaranteed flows: typically a static catalogue, possibly\n   * filtered by buyer brief / signals.\n   *\n   * For guaranteed flows: typically a brief-driven assembly consulting\n   * rate cards + availability. Adopters return draft proposals; the\n   * buyer drives the finalize transition via subsequent refine calls\n   * with `action: 'finalize'`.\n   */\n  getProducts(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Refine-mode iteration on a previous `getProducts` response.\n   *\n   * Per the spec, refine is a `buying_mode` value on `get_products` —\n   * the wire envelope is the same. The framework routes refine requests\n   * to this method when:\n   *\n   * 1. The wired ProposalManager declares `capabilities.refine` = true,\n   * 2. The request has `buying_mode === 'refine'`, AND\n   * 3. The manager implements this method.\n   *\n   * Otherwise refine requests fall through to {@link getProducts}.\n   *\n   * Adopters implementing `refineProducts` without `finalize` support\n   * should treat `action: 'finalize'` entries as `UNSUPPORTED_FEATURE`\n   * and return a structured error. Adopters with `finalize` support\n   * see those entries intercepted by the framework before this method\n   * is called.\n   */\n  refineProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Commit a draft proposal to firm pricing + inventory hold.\n   *\n   * Wired by the framework's lifecycle helpers when:\n   *\n   * 1. `capabilities.finalize === true`,\n   * 2. The buyer's request has `buying_mode === 'refine'` with a\n   *    `refine[i]` entry of `{ scope: 'proposal', action: 'finalize',\n   *    proposal_id }`, AND\n   * 3. The proposal_id resolves to a DRAFT entry in the\n   *    {@link ProposalStore}.\n   *\n   * Return a {@link FinalizeProposalSuccess} for inline commit (the\n   * spec-default route), or a `TaskHandoff<FinalizeProposalSuccess>` to\n   * promote to a HITL background task. The HITL commit hook is wired\n   * in v1.6+; v1.5 inline-only.\n   */\n  finalizeProposal?(\n    req: FinalizeProposalRequest<TRecipe>,\n    ctx: Ctx<TCtxMeta>\n  ): MaybePromise<FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAuJO,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,QAA4C,CAAC,oBAAoB,sBAAsB;AAC7F,MAAI,CAAC,MAAM,SAAS,KAAK,eAAe,GAAG;AACzC,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,KAAK,CAAC,SACnE,KAAK,UAAU,KAAK,eAAe,CAAC;AAAA,IAE/C;AAAA,EACF;AACA,MAAI,KAAK,yBAAyB,QAAQ,KAAK,wBAAwB,GAAG;AACxE,UAAM,IAAI;AAAA,MACR,gEAAgE,KAAK,qBAAqB;AAAA,IAE5F;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/types.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * The existing `DecisioningPlatform` conflates two concerns: assembling\n * proposals from briefs (`get_products`, refine) vs. executing media buys\n * against an upstream (`create_media_buy`, `update_media_buy`,\n * `get_media_buy_delivery`). The two-platform composition splits them: a\n * separate {@link ProposalManager} handles the proposal side; the\n * `DecisioningPlatform` keeps the execution side. Either platform can be\n * mock-backed independently.\n *\n * Ports the Python primitives shipped in `adcp-client-python` PRs #504\n * (v1) and #550 (v1.5):\n *\n *   - {@link ProposalManager} — interface with `getProducts` (required)\n *     plus optional `refineProducts` and `finalizeProposal`.\n *   - {@link ProposalCapabilities} — sales-axis-scoped capability flags.\n *   - {@link Recipe} — typed `recipe_kind`-discriminated base; adopters\n *     subclass with their internal-config schema. Rides on\n *     `Product.implementation_config` (opaque to the buyer).\n *   - {@link CapabilityOverlap} — typed declaration of which wire\n *     capabilities the buyer can configure on a product. The framework\n *     validates buyer requests against the overlap pre-adapter.\n *   - {@link FinalizeProposalRequest} / {@link FinalizeProposalSuccess} —\n *     framework-internal shapes for the finalize lifecycle (wired in the\n *     v1.5 dispatch helpers).\n *\n * @public\n * @packageDocumentation\n */\n\nimport type { MaybePromise } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { GetProductsResponse } from '../../../types/tools.generated';\nimport type { CanonicalCreativeResponse, CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';\nimport type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type { TaskHandoff } from '../async-outcome';\nimport type { GetProductsProjectionInput } from '../specialisms/sales';\n\nexport type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<\n  Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {\n    products?: GetProductsProjectionInput[];\n  }\n>;\nexport type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\n\n// ---------------------------------------------------------------------------\n// Capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Sales specialisms a {@link ProposalManager} can serve. Mirrors the\n * `sales-*` slugs in the spec's specialism enum.\n *\n * v1 scopes to the two `ProposalManager`-relevant flavours; broader\n * coverage (broadcast-tv, social, proposal-mode, catalog-driven) lands\n * as adopter signal grows.\n *\n * @public\n */\nexport type ProposalSalesSpecialism = 'sales-guaranteed' | 'sales-non-guaranteed';\n\n/**\n * Capability declaration for a {@link ProposalManager}.\n *\n * Sales-axis-scoped: proposal handling is a sales-specialism concern,\n * not a generic platform-wide concept. The `salesSpecialism` field\n * declares which AdCP sales specialism this manager serves; capability\n * flags declare which optional behaviours it supports.\n *\n * The framework reads this declaration at server-construction time to\n * decide which dispatch paths apply (e.g. `refineProducts` is only\n * invoked when `refine` is true; `finalizeProposal` is only invoked\n * when `finalize` is true).\n *\n * @public\n */\nexport interface ProposalCapabilities {\n  /**\n   * Which AdCP sales specialism this manager serves.\n   *\n   * `sales-guaranteed` for guaranteed-direct flows with proposal\n   * lifecycle (finalize → committed proposal → media buy).\n   *\n   * `sales-non-guaranteed` for catalog-style flows where `getProducts`\n   * returns a static catalog and buyers reference products directly at\n   * `create_media_buy`.\n   */\n  salesSpecialism: ProposalSalesSpecialism;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.refineProducts}\n   * and the framework routes `get_products` requests with\n   * `buying_mode: 'refine'` to that method. When false, refine requests\n   * fall through to `getProducts` (or surface `UNSUPPORTED_FEATURE` if\n   * the manager rejects them).\n   */\n  refine?: boolean;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.finalizeProposal}\n   * and the framework intercepts `refine[i].action: 'finalize'` entries to\n   * commit drafts via the lifecycle helpers. When false, finalize entries\n   * pass through to the underlying `getProducts` / `refineProducts` method\n   * unchanged.\n   */\n  finalize?: boolean;\n\n  /**\n   * Grace window (in seconds) added to a committed proposal's `expires_at`\n   * before the framework rejects `create_media_buy` calls referencing the\n   * proposal with `PROPOSAL_EXPIRED`. Default 0 (strict).\n   */\n  expiresAtGraceSeconds?: number;\n\n  /**\n   * Signal-driven product assembly — the manager constructs products from\n   * buyer signals at request time rather than enumerating a static\n   * catalogue. Informational in v1.5; future PRs may validate that\n   * inventory / signal stores are wired when this flag is set.\n   */\n  dynamicProducts?: boolean;\n\n  /**\n   * The manager consults rate cards (per buyer relationship per product)\n   * when emitting prices. Informational in v1.5.\n   */\n  rateCardPricing?: boolean;\n\n  /**\n   * The manager reserves capacity at proposal time (typical for\n   * guaranteed). Informational in v1.5; the `finalize` transition that\n   * drives the actual hold is wired via the lifecycle helpers.\n   */\n  availabilityReservations?: boolean;\n}\n\n/**\n * Validate a {@link ProposalCapabilities} object. Throws when the declaration\n * is malformed (unknown `salesSpecialism`, negative `expiresAtGraceSeconds`).\n * The framework calls this at boot; adopters can call it from their own\n * config-validation code paths to fail fast on misconfiguration.\n *\n * Kept as a plain function rather than a class constructor to match the\n * codebase's preference for plain TS interfaces over runtime classes\n * for adopter-facing types.\n *\n * @public\n */\nexport function validateProposalCapabilities(caps: ProposalCapabilities): void {\n  const valid: readonly ProposalSalesSpecialism[] = ['sales-guaranteed', 'sales-non-guaranteed'];\n  if (!valid.includes(caps.salesSpecialism)) {\n    throw new Error(\n      `ProposalCapabilities.salesSpecialism must be one of ${JSON.stringify(valid)}. ` +\n        `Got ${JSON.stringify(caps.salesSpecialism)}. v1.5 scopes ProposalManager to the two ` +\n        `core sales specialisms; broader specialism support lands in subsequent releases.`\n    );\n  }\n  if (caps.expiresAtGraceSeconds != null && caps.expiresAtGraceSeconds < 0) {\n    throw new Error(\n      `ProposalCapabilities.expiresAtGraceSeconds must be >= 0; got ${caps.expiresAtGraceSeconds}. ` +\n        `The grace window extends the inventory hold past expires_at; negative values would shrink it.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Recipe + CapabilityOverlap\n// ---------------------------------------------------------------------------\n\n/**\n * Per-product subset of wire capability flags that the buyer can\n * configure on this product.\n *\n * Buyer requests asking for capabilities outside this overlap are\n * rejected by the framework before the adapter sees them (validated by\n * the lifecycle helpers — see `proposal/lifecycle.ts`).\n *\n * Each field is `ReadonlySet<string> | undefined`:\n *\n *   - `undefined` → framework does not gate this axis (open).\n *   - `ReadonlySet` → buyer choices must be subsets of this set.\n *     An empty set means deny-all on this axis.\n *\n * The undefined vs. empty-set distinction matches set intuition:\n * \"no constraint\" is `undefined`; \"allowed set is empty\" is `new Set()`.\n *\n * **Why no extras dict?** v1.5 deliberately omits an `extras` escape\n * hatch (per Python design § D4). Adopters with novel gating needs\n * extend the interface with typed fields; a dict bag leaves no paper\n * trail. If a new axis turns out to be widely useful, it lands as a\n * typed field on `CapabilityOverlap` upstream.\n *\n * @public\n */\nexport interface CapabilityOverlap {\n  /**\n   * Subset of wire `pricing_models` the buyer can choose. Validated\n   * against the matching `PricingOption.pricing_model` on the buyer's\n   * package.\n   */\n  pricingModels?: ReadonlySet<string>;\n\n  /**\n   * Subset of wire targeting dimensions (`geo`, `device_type`,\n   * `language`, etc.). Validated against the keys present on the\n   * buyer's `targeting_overlay`.\n   */\n  targetingDimensions?: ReadonlySet<string>;\n\n  /**\n   * Subset of `{ guaranteed, non_guaranteed }` the product offers.\n   */\n  deliveryTypes?: ReadonlySet<string>;\n\n  /**\n   * If the seller integrates signals, which signal types this product\n   * accepts. An empty set means the seller explicitly refuses all\n   * signals on this product; `undefined` means no framework gate.\n   */\n  signalTypes?: ReadonlySet<string>;\n}\n\n/**\n * Base type for typed product `implementation_config` payloads.\n *\n * Adopters declare a discriminated subtype with a literal `recipe_kind`:\n *\n * ```ts\n * interface GAMRecipe extends Recipe {\n *   recipe_kind: 'gam';\n *   line_item_template_id: string;\n *   ad_unit_ids: readonly string[];\n *   capability_overlap?: CapabilityOverlap;\n * }\n * ```\n *\n * The kind tag enables router-by-recipe-kind dispatch in the\n * multi-decisioning case (one ProposalManager + many DecisioningPlatforms,\n * each handling a subset of recipe kinds). v1.5 doesn't yet wire that\n * routing — adopters using a single DecisioningPlatform attach recipes\n * freely without registry validation.\n *\n * **The recipe is never on the buyer's wire surface.** It rides inside\n * `Product.implementation_config` (an opaque-to-buyer dict). Buyers treat\n * it as a black box; the framework persists it through the proposal\n * lifecycle so the executing DecisioningPlatform sees a stable view.\n *\n * `capability_overlap` is optional. When present, the framework activates\n * the v1.5 buyer-request validation seam against the declared subsets.\n *\n * @public\n */\nexport interface Recipe {\n  /** Adapter-family discriminator. Subtypes narrow with a literal type. */\n  recipe_kind: string;\n\n  /**\n   * Optional typed declaration of which wire capabilities the buyer can\n   * configure on this product. `undefined` means no framework gating.\n   * An explicit {@link CapabilityOverlap} activates the v1.5 validation.\n   */\n  capability_overlap?: CapabilityOverlap;\n}\n\n// ---------------------------------------------------------------------------\n// Finalize lifecycle shapes\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-internal request shape passed to {@link ProposalManager.finalizeProposal}.\n *\n * Constructed by the framework dispatcher when a buyer's `get_products`\n * request with `buying_mode: 'refine'` carries a `refine[i].action: 'finalize'`\n * entry. Adopters don't parse the wire envelope; the framework projects.\n *\n * @public\n */\nexport interface FinalizeProposalRequest<TRecipe extends Recipe = Recipe> {\n  /**\n   * The draft proposal the buyer is asking to finalize. Hydrated from\n   * the wire's `refine[i].proposal_id` field.\n   */\n  proposalId: string;\n\n  /**\n   * `product_id -> Recipe` mapping pulled from the {@link ProposalStore}\n   * draft. The adopter's finalize logic typically lock-prices these and\n   * emits the committed proposal.\n   */\n  recipes: ReadonlyMap<string, TRecipe>;\n\n  /**\n   * The draft's wire `Proposal` shape (the same payload the adopter\n   * returned on the prior `getProducts` / `refineProducts` call).\n   * Adopter typically modifies this with locked pricing and returns it\n   * on {@link FinalizeProposalSuccess}.\n   */\n  proposalPayload: Record<string, unknown>;\n\n  /**\n   * The buyer's per-entry refine `ask` text — what they want finalized.\n   * Free-form; adopter consumes.\n   */\n  ask?: string;\n\n  /**\n   * The parent canonical get-products request so the adopter sees the full\n   * envelope (account, etc.) without the framework projecting fields\n   * one-by-one.\n   */\n  parentRequest: CanonicalGetProductsRequest;\n}\n\n/**\n * Adopter-returned shape from {@link ProposalManager.finalizeProposal} —\n * inline commit.\n *\n * Framework calls `ProposalStore.commit` with these fields before\n * projecting the wire response. The buyer sees the committed `Proposal`\n * with `proposal_status: 'committed'` + `expires_at` populated on the\n * next `get_products` response payload.\n *\n * @public\n */\nexport interface FinalizeProposalSuccess<TRecipe extends Recipe = Recipe> {\n  /**\n   * The wire `Proposal` shape with locked pricing and\n   * `proposal_status: 'committed'`. Adopter typically derives this from\n   * {@link FinalizeProposalRequest.proposalPayload} with modifications.\n   *\n   * **Must be JSON-serializable end-to-end** — non-JSON values won't\n   * survive a process restart through a durable {@link ProposalStore}.\n   */\n  proposal: Record<string, unknown>;\n\n  /**\n   * Inventory hold deadline. After this (plus the adopter's\n   * {@link ProposalCapabilities.expiresAtGraceSeconds} window), the\n   * framework rejects `create_media_buy` calls referencing the proposal\n   * with `PROPOSAL_EXPIRED`.\n   */\n  expiresAt: Date;\n\n  /**\n   * Optional refreshed recipe mapping. Omitting preserves the draft's\n   * recipes verbatim. Adopters whose finalize logic mutates recipe\n   * fields (e.g. locking a line-item template id) supply a fresh\n   * mapping.\n   */\n  recipes?: ReadonlyMap<string, TRecipe>;\n}\n\n// ---------------------------------------------------------------------------\n// ProposalManager interface\n// ---------------------------------------------------------------------------\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\n/**\n * Assembles proposals from buyer briefs.\n *\n * Reads inventory, signals, rate cards, availability. Produces proposals\n * where each `Product` carries a typed `implementation_config` (a recipe;\n * see {@link Recipe}) that the bound `DecisioningPlatform` consumes at\n * `create_media_buy` time.\n *\n * Methods may be sync or async; the framework awaits whatever is\n * returned. Same convention as `SalesPlatform`.\n *\n * **Required surface:** {@link getProducts}.\n *\n * **Optional surfaces (capability-gated):**\n *\n *   - {@link refineProducts} — only invoked when\n *     {@link ProposalCapabilities.refine} is true.\n *   - {@link finalizeProposal} — only invoked when\n *     {@link ProposalCapabilities.finalize} is true. Wired by the\n *     framework's lifecycle helpers; intercepts `refine[i].action: 'finalize'`\n *     entries before the underlying `getProducts` / `refineProducts` runs.\n *\n * Throw `AdcpError` for buyer-fixable rejection (`BUDGET_TOO_LOW`,\n * `POLICY_VIOLATION`, `UNSUPPORTED_FEATURE`); the framework projects to\n * the wire structured-error envelope.\n *\n * Adopter typing tip: parameterize on your concrete `Recipe` subtype to\n * get end-to-end recipe typing through `ctx.recipes` in the bound\n * `DecisioningPlatform`'s methods:\n *\n * ```ts\n * type MyRecipe = GAMRecipe | KevelRecipe;\n * const manager: ProposalManager<MyRecipe, MyTenantMeta> = { ... };\n * ```\n *\n * @public\n */\nexport interface ProposalManager<TRecipe extends Recipe = Recipe, TCtxMeta = unknown> {\n  /**\n   * What this ProposalManager can do — sales specialism + capability flags.\n   */\n  capabilities: ProposalCapabilities;\n\n  /**\n   * Initial product discovery from a buyer brief.\n   *\n   * Each returned `Product` SHOULD carry an `implementation_config`\n   * matching the bound `DecisioningPlatform`'s recipe schema (see\n   * {@link Recipe}). The framework treats `implementation_config` as\n   * opaque on the wire; recipe typing is enforced through the\n   * `TRecipe` type parameter on the adopter side.\n   *\n   * For non-guaranteed flows: typically a static catalogue, possibly\n   * filtered by buyer brief / signals.\n   *\n   * For guaranteed flows: typically a brief-driven assembly consulting\n   * rate cards + availability. Adopters return draft proposals; the\n   * buyer drives the finalize transition via subsequent refine calls\n   * with `action: 'finalize'`.\n   */\n  getProducts(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Refine-mode iteration on a previous `getProducts` response.\n   *\n   * Per the spec, refine is a `buying_mode` value on `get_products` —\n   * the wire envelope is the same. The framework routes refine requests\n   * to this method when:\n   *\n   * 1. The wired ProposalManager declares `capabilities.refine` = true,\n   * 2. The request has `buying_mode === 'refine'`, AND\n   * 3. The manager implements this method.\n   *\n   * Otherwise refine requests fall through to {@link getProducts}.\n   *\n   * Adopters implementing `refineProducts` without `finalize` support\n   * should treat `action: 'finalize'` entries as `UNSUPPORTED_FEATURE`\n   * and return a structured error. Adopters with `finalize` support\n   * see those entries intercepted by the framework before this method\n   * is called.\n   */\n  refineProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Commit a draft proposal to firm pricing + inventory hold.\n   *\n   * Wired by the framework's lifecycle helpers when:\n   *\n   * 1. `capabilities.finalize === true`,\n   * 2. The buyer's request has `buying_mode === 'refine'` with a\n   *    `refine[i]` entry of `{ scope: 'proposal', action: 'finalize',\n   *    proposal_id }`, AND\n   * 3. The proposal_id resolves to a DRAFT entry in the\n   *    {@link ProposalStore}.\n   *\n   * Return a {@link FinalizeProposalSuccess} for inline commit (the\n   * spec-default route), or a `TaskHandoff<FinalizeProposalSuccess>` to\n   * promote to a HITL background task. The HITL commit hook is wired\n   * in v1.6+; v1.5 inline-only.\n   */\n  finalizeProposal?(\n    req: FinalizeProposalRequest<TRecipe>,\n    ctx: Ctx<TCtxMeta>\n  ): MaybePromise<FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAsJO,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,QAA4C,CAAC,oBAAoB,sBAAsB;AAC7F,MAAI,CAAC,MAAM,SAAS,KAAK,eAAe,GAAG;AACzC,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,KAAK,CAAC,SACnE,KAAK,UAAU,KAAK,eAAe,CAAC;AAAA,IAE/C;AAAA,EACF;AACA,MAAI,KAAK,yBAAyB,QAAQ,KAAK,wBAAwB,GAAG;AACxE,UAAM,IAAI;AAAA,MACR,gEAAgE,KAAK,qBAAqB;AAAA,IAE5F;AAAA,EACF;AACF;","names":[]}

package/dist/lib/server/decisioning/proposal/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/types.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * The existing `DecisioningPlatform` conflates two concerns: assembling\n * proposals from briefs (`get_products`, refine) vs. executing media buys\n * against an upstream (`create_media_buy`, `update_media_buy`,\n * `get_media_buy_delivery`). The two-platform composition splits them: a\n * separate {@link ProposalManager} handles the proposal side; the\n * `DecisioningPlatform` keeps the execution side. Either platform can be\n * mock-backed independently.\n *\n * Ports the Python primitives shipped in `adcp-client-python` PRs #504\n * (v1) and #550 (v1.5):\n *\n *   - {@link ProposalManager} — interface with `getProducts` (required)\n *     plus optional `refineProducts` and `finalizeProposal`.\n *   - {@link ProposalCapabilities} — sales-axis-scoped capability flags.\n *   - {@link Recipe} — typed `recipe_kind`-discriminated base; adopters\n *     subclass with their internal-config schema. Rides on\n *     `Product.implementation_config` (opaque to the buyer).\n *   - {@link CapabilityOverlap} — typed declaration of which wire\n *     capabilities the buyer can configure on a product. The framework\n *     validates buyer requests against the overlap pre-adapter.\n *   - {@link FinalizeProposalRequest} / {@link FinalizeProposalSuccess} —\n *     framework-internal shapes for the finalize lifecycle (wired in the\n *     v1.5 dispatch helpers).\n *\n * @public\n * @packageDocumentation\n */\n\nimport type { MaybePromise } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { GetProductsResponse } from '../../../types/tools.generated';\nimport type {\n  CanonicalCreativeResponse,\n  CanonicalGetProductsRequest,\n  CanonicalProduct,\n} from '../../../v2/projection/creative-delivery';\nimport type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type { TaskHandoff } from '../async-outcome';\n\nexport type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<\n  Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & { products?: CanonicalProduct[] }\n>;\nexport type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\n\n// ---------------------------------------------------------------------------\n// Capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Sales specialisms a {@link ProposalManager} can serve. Mirrors the\n * `sales-*` slugs in the spec's specialism enum.\n *\n * v1 scopes to the two `ProposalManager`-relevant flavours; broader\n * coverage (broadcast-tv, social, proposal-mode, catalog-driven) lands\n * as adopter signal grows.\n *\n * @public\n */\nexport type ProposalSalesSpecialism = 'sales-guaranteed' | 'sales-non-guaranteed';\n\n/**\n * Capability declaration for a {@link ProposalManager}.\n *\n * Sales-axis-scoped: proposal handling is a sales-specialism concern,\n * not a generic platform-wide concept. The `salesSpecialism` field\n * declares which AdCP sales specialism this manager serves; capability\n * flags declare which optional behaviours it supports.\n *\n * The framework reads this declaration at server-construction time to\n * decide which dispatch paths apply (e.g. `refineProducts` is only\n * invoked when `refine` is true; `finalizeProposal` is only invoked\n * when `finalize` is true).\n *\n * @public\n */\nexport interface ProposalCapabilities {\n  /**\n   * Which AdCP sales specialism this manager serves.\n   *\n   * `sales-guaranteed` for guaranteed-direct flows with proposal\n   * lifecycle (finalize → committed proposal → media buy).\n   *\n   * `sales-non-guaranteed` for catalog-style flows where `getProducts`\n   * returns a static catalog and buyers reference products directly at\n   * `create_media_buy`.\n   */\n  salesSpecialism: ProposalSalesSpecialism;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.refineProducts}\n   * and the framework routes `get_products` requests with\n   * `buying_mode: 'refine'` to that method. When false, refine requests\n   * fall through to `getProducts` (or surface `UNSUPPORTED_FEATURE` if\n   * the manager rejects them).\n   */\n  refine?: boolean;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.finalizeProposal}\n   * and the framework intercepts `refine[i].action: 'finalize'` entries to\n   * commit drafts via the lifecycle helpers. When false, finalize entries\n   * pass through to the underlying `getProducts` / `refineProducts` method\n   * unchanged.\n   */\n  finalize?: boolean;\n\n  /**\n   * Grace window (in seconds) added to a committed proposal's `expires_at`\n   * before the framework rejects `create_media_buy` calls referencing the\n   * proposal with `PROPOSAL_EXPIRED`. Default 0 (strict).\n   */\n  expiresAtGraceSeconds?: number;\n\n  /**\n   * Signal-driven product assembly — the manager constructs products from\n   * buyer signals at request time rather than enumerating a static\n   * catalogue. Informational in v1.5; future PRs may validate that\n   * inventory / signal stores are wired when this flag is set.\n   */\n  dynamicProducts?: boolean;\n\n  /**\n   * The manager consults rate cards (per buyer relationship per product)\n   * when emitting prices. Informational in v1.5.\n   */\n  rateCardPricing?: boolean;\n\n  /**\n   * The manager reserves capacity at proposal time (typical for\n   * guaranteed). Informational in v1.5; the `finalize` transition that\n   * drives the actual hold is wired via the lifecycle helpers.\n   */\n  availabilityReservations?: boolean;\n}\n\n/**\n * Validate a {@link ProposalCapabilities} object. Throws when the declaration\n * is malformed (unknown `salesSpecialism`, negative `expiresAtGraceSeconds`).\n * The framework calls this at boot; adopters can call it from their own\n * config-validation code paths to fail fast on misconfiguration.\n *\n * Kept as a plain function rather than a class constructor to match the\n * codebase's preference for plain TS interfaces over runtime classes\n * for adopter-facing types.\n *\n * @public\n */\nexport function validateProposalCapabilities(caps: ProposalCapabilities): void {\n  const valid: readonly ProposalSalesSpecialism[] = ['sales-guaranteed', 'sales-non-guaranteed'];\n  if (!valid.includes(caps.salesSpecialism)) {\n    throw new Error(\n      `ProposalCapabilities.salesSpecialism must be one of ${JSON.stringify(valid)}. ` +\n        `Got ${JSON.stringify(caps.salesSpecialism)}. v1.5 scopes ProposalManager to the two ` +\n        `core sales specialisms; broader specialism support lands in subsequent releases.`\n    );\n  }\n  if (caps.expiresAtGraceSeconds != null && caps.expiresAtGraceSeconds < 0) {\n    throw new Error(\n      `ProposalCapabilities.expiresAtGraceSeconds must be >= 0; got ${caps.expiresAtGraceSeconds}. ` +\n        `The grace window extends the inventory hold past expires_at; negative values would shrink it.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Recipe + CapabilityOverlap\n// ---------------------------------------------------------------------------\n\n/**\n * Per-product subset of wire capability flags that the buyer can\n * configure on this product.\n *\n * Buyer requests asking for capabilities outside this overlap are\n * rejected by the framework before the adapter sees them (validated by\n * the lifecycle helpers — see `proposal/lifecycle.ts`).\n *\n * Each field is `ReadonlySet<string> | undefined`:\n *\n *   - `undefined` → framework does not gate this axis (open).\n *   - `ReadonlySet` → buyer choices must be subsets of this set.\n *     An empty set means deny-all on this axis.\n *\n * The undefined vs. empty-set distinction matches set intuition:\n * \"no constraint\" is `undefined`; \"allowed set is empty\" is `new Set()`.\n *\n * **Why no extras dict?** v1.5 deliberately omits an `extras` escape\n * hatch (per Python design § D4). Adopters with novel gating needs\n * extend the interface with typed fields; a dict bag leaves no paper\n * trail. If a new axis turns out to be widely useful, it lands as a\n * typed field on `CapabilityOverlap` upstream.\n *\n * @public\n */\nexport interface CapabilityOverlap {\n  /**\n   * Subset of wire `pricing_models` the buyer can choose. Validated\n   * against the matching `PricingOption.pricing_model` on the buyer's\n   * package.\n   */\n  pricingModels?: ReadonlySet<string>;\n\n  /**\n   * Subset of wire targeting dimensions (`geo`, `device_type`,\n   * `language`, etc.). Validated against the keys present on the\n   * buyer's `targeting_overlay`.\n   */\n  targetingDimensions?: ReadonlySet<string>;\n\n  /**\n   * Subset of `{ guaranteed, non_guaranteed }` the product offers.\n   */\n  deliveryTypes?: ReadonlySet<string>;\n\n  /**\n   * If the seller integrates signals, which signal types this product\n   * accepts. An empty set means the seller explicitly refuses all\n   * signals on this product; `undefined` means no framework gate.\n   */\n  signalTypes?: ReadonlySet<string>;\n}\n\n/**\n * Base type for typed product `implementation_config` payloads.\n *\n * Adopters declare a discriminated subtype with a literal `recipe_kind`:\n *\n * ```ts\n * interface GAMRecipe extends Recipe {\n *   recipe_kind: 'gam';\n *   line_item_template_id: string;\n *   ad_unit_ids: readonly string[];\n *   capability_overlap?: CapabilityOverlap;\n * }\n * ```\n *\n * The kind tag enables router-by-recipe-kind dispatch in the\n * multi-decisioning case (one ProposalManager + many DecisioningPlatforms,\n * each handling a subset of recipe kinds). v1.5 doesn't yet wire that\n * routing — adopters using a single DecisioningPlatform attach recipes\n * freely without registry validation.\n *\n * **The recipe is never on the buyer's wire surface.** It rides inside\n * `Product.implementation_config` (an opaque-to-buyer dict). Buyers treat\n * it as a black box; the framework persists it through the proposal\n * lifecycle so the executing DecisioningPlatform sees a stable view.\n *\n * `capability_overlap` is optional. When present, the framework activates\n * the v1.5 buyer-request validation seam against the declared subsets.\n *\n * @public\n */\nexport interface Recipe {\n  /** Adapter-family discriminator. Subtypes narrow with a literal type. */\n  recipe_kind: string;\n\n  /**\n   * Optional typed declaration of which wire capabilities the buyer can\n   * configure on this product. `undefined` means no framework gating.\n   * An explicit {@link CapabilityOverlap} activates the v1.5 validation.\n   */\n  capability_overlap?: CapabilityOverlap;\n}\n\n// ---------------------------------------------------------------------------\n// Finalize lifecycle shapes\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-internal request shape passed to {@link ProposalManager.finalizeProposal}.\n *\n * Constructed by the framework dispatcher when a buyer's `get_products`\n * request with `buying_mode: 'refine'` carries a `refine[i].action: 'finalize'`\n * entry. Adopters don't parse the wire envelope; the framework projects.\n *\n * @public\n */\nexport interface FinalizeProposalRequest<TRecipe extends Recipe = Recipe> {\n  /**\n   * The draft proposal the buyer is asking to finalize. Hydrated from\n   * the wire's `refine[i].proposal_id` field.\n   */\n  proposalId: string;\n\n  /**\n   * `product_id -> Recipe` mapping pulled from the {@link ProposalStore}\n   * draft. The adopter's finalize logic typically lock-prices these and\n   * emits the committed proposal.\n   */\n  recipes: ReadonlyMap<string, TRecipe>;\n\n  /**\n   * The draft's wire `Proposal` shape (the same payload the adopter\n   * returned on the prior `getProducts` / `refineProducts` call).\n   * Adopter typically modifies this with locked pricing and returns it\n   * on {@link FinalizeProposalSuccess}.\n   */\n  proposalPayload: Record<string, unknown>;\n\n  /**\n   * The buyer's per-entry refine `ask` text — what they want finalized.\n   * Free-form; adopter consumes.\n   */\n  ask?: string;\n\n  /**\n   * The parent canonical get-products request so the adopter sees the full\n   * envelope (account, etc.) without the framework projecting fields\n   * one-by-one.\n   */\n  parentRequest: CanonicalGetProductsRequest;\n}\n\n/**\n * Adopter-returned shape from {@link ProposalManager.finalizeProposal} —\n * inline commit.\n *\n * Framework calls `ProposalStore.commit` with these fields before\n * projecting the wire response. The buyer sees the committed `Proposal`\n * with `proposal_status: 'committed'` + `expires_at` populated on the\n * next `get_products` response payload.\n *\n * @public\n */\nexport interface FinalizeProposalSuccess<TRecipe extends Recipe = Recipe> {\n  /**\n   * The wire `Proposal` shape with locked pricing and\n   * `proposal_status: 'committed'`. Adopter typically derives this from\n   * {@link FinalizeProposalRequest.proposalPayload} with modifications.\n   *\n   * **Must be JSON-serializable end-to-end** — non-JSON values won't\n   * survive a process restart through a durable {@link ProposalStore}.\n   */\n  proposal: Record<string, unknown>;\n\n  /**\n   * Inventory hold deadline. After this (plus the adopter's\n   * {@link ProposalCapabilities.expiresAtGraceSeconds} window), the\n   * framework rejects `create_media_buy` calls referencing the proposal\n   * with `PROPOSAL_EXPIRED`.\n   */\n  expiresAt: Date;\n\n  /**\n   * Optional refreshed recipe mapping. Omitting preserves the draft's\n   * recipes verbatim. Adopters whose finalize logic mutates recipe\n   * fields (e.g. locking a line-item template id) supply a fresh\n   * mapping.\n   */\n  recipes?: ReadonlyMap<string, TRecipe>;\n}\n\n// ---------------------------------------------------------------------------\n// ProposalManager interface\n// ---------------------------------------------------------------------------\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\n/**\n * Assembles proposals from buyer briefs.\n *\n * Reads inventory, signals, rate cards, availability. Produces proposals\n * where each `Product` carries a typed `implementation_config` (a recipe;\n * see {@link Recipe}) that the bound `DecisioningPlatform` consumes at\n * `create_media_buy` time.\n *\n * Methods may be sync or async; the framework awaits whatever is\n * returned. Same convention as `SalesPlatform`.\n *\n * **Required surface:** {@link getProducts}.\n *\n * **Optional surfaces (capability-gated):**\n *\n *   - {@link refineProducts} — only invoked when\n *     {@link ProposalCapabilities.refine} is true.\n *   - {@link finalizeProposal} — only invoked when\n *     {@link ProposalCapabilities.finalize} is true. Wired by the\n *     framework's lifecycle helpers; intercepts `refine[i].action: 'finalize'`\n *     entries before the underlying `getProducts` / `refineProducts` runs.\n *\n * Throw `AdcpError` for buyer-fixable rejection (`BUDGET_TOO_LOW`,\n * `POLICY_VIOLATION`, `UNSUPPORTED_FEATURE`); the framework projects to\n * the wire structured-error envelope.\n *\n * Adopter typing tip: parameterize on your concrete `Recipe` subtype to\n * get end-to-end recipe typing through `ctx.recipes` in the bound\n * `DecisioningPlatform`'s methods:\n *\n * ```ts\n * type MyRecipe = GAMRecipe | KevelRecipe;\n * const manager: ProposalManager<MyRecipe, MyTenantMeta> = { ... };\n * ```\n *\n * @public\n */\nexport interface ProposalManager<TRecipe extends Recipe = Recipe, TCtxMeta = unknown> {\n  /**\n   * What this ProposalManager can do — sales specialism + capability flags.\n   */\n  capabilities: ProposalCapabilities;\n\n  /**\n   * Initial product discovery from a buyer brief.\n   *\n   * Each returned `Product` SHOULD carry an `implementation_config`\n   * matching the bound `DecisioningPlatform`'s recipe schema (see\n   * {@link Recipe}). The framework treats `implementation_config` as\n   * opaque on the wire; recipe typing is enforced through the\n   * `TRecipe` type parameter on the adopter side.\n   *\n   * For non-guaranteed flows: typically a static catalogue, possibly\n   * filtered by buyer brief / signals.\n   *\n   * For guaranteed flows: typically a brief-driven assembly consulting\n   * rate cards + availability. Adopters return draft proposals; the\n   * buyer drives the finalize transition via subsequent refine calls\n   * with `action: 'finalize'`.\n   */\n  getProducts(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Refine-mode iteration on a previous `getProducts` response.\n   *\n   * Per the spec, refine is a `buying_mode` value on `get_products` —\n   * the wire envelope is the same. The framework routes refine requests\n   * to this method when:\n   *\n   * 1. The wired ProposalManager declares `capabilities.refine` = true,\n   * 2. The request has `buying_mode === 'refine'`, AND\n   * 3. The manager implements this method.\n   *\n   * Otherwise refine requests fall through to {@link getProducts}.\n   *\n   * Adopters implementing `refineProducts` without `finalize` support\n   * should treat `action: 'finalize'` entries as `UNSUPPORTED_FEATURE`\n   * and return a structured error. Adopters with `finalize` support\n   * see those entries intercepted by the framework before this method\n   * is called.\n   */\n  refineProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Commit a draft proposal to firm pricing + inventory hold.\n   *\n   * Wired by the framework's lifecycle helpers when:\n   *\n   * 1. `capabilities.finalize === true`,\n   * 2. The buyer's request has `buying_mode === 'refine'` with a\n   *    `refine[i]` entry of `{ scope: 'proposal', action: 'finalize',\n   *    proposal_id }`, AND\n   * 3. The proposal_id resolves to a DRAFT entry in the\n   *    {@link ProposalStore}.\n   *\n   * Return a {@link FinalizeProposalSuccess} for inline commit (the\n   * spec-default route), or a `TaskHandoff<FinalizeProposalSuccess>` to\n   * promote to a HITL background task. The HITL commit hook is wired\n   * in v1.6+; v1.5 inline-only.\n   */\n  finalizeProposal?(\n    req: FinalizeProposalRequest<TRecipe>,\n    ctx: Ctx<TCtxMeta>\n  ): MaybePromise<FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>>;\n}\n"],"mappings":"AAuJO,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,QAA4C,CAAC,oBAAoB,sBAAsB;AAC7F,MAAI,CAAC,MAAM,SAAS,KAAK,eAAe,GAAG;AACzC,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,KAAK,CAAC,SACnE,KAAK,UAAU,KAAK,eAAe,CAAC;AAAA,IAE/C;AAAA,EACF;AACA,MAAI,KAAK,yBAAyB,QAAQ,KAAK,wBAAwB,GAAG;AACxE,UAAM,IAAI;AAAA,MACR,gEAAgE,KAAK,qBAAqB;AAAA,IAE5F;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/proposal/types.ts"],"sourcesContent":["/**\n * ProposalManager — primitives for the two-platform composition.\n *\n * The existing `DecisioningPlatform` conflates two concerns: assembling\n * proposals from briefs (`get_products`, refine) vs. executing media buys\n * against an upstream (`create_media_buy`, `update_media_buy`,\n * `get_media_buy_delivery`). The two-platform composition splits them: a\n * separate {@link ProposalManager} handles the proposal side; the\n * `DecisioningPlatform` keeps the execution side. Either platform can be\n * mock-backed independently.\n *\n * Ports the Python primitives shipped in `adcp-client-python` PRs #504\n * (v1) and #550 (v1.5):\n *\n *   - {@link ProposalManager} — interface with `getProducts` (required)\n *     plus optional `refineProducts` and `finalizeProposal`.\n *   - {@link ProposalCapabilities} — sales-axis-scoped capability flags.\n *   - {@link Recipe} — typed `recipe_kind`-discriminated base; adopters\n *     subclass with their internal-config schema. Rides on\n *     `Product.implementation_config` (opaque to the buyer).\n *   - {@link CapabilityOverlap} — typed declaration of which wire\n *     capabilities the buyer can configure on a product. The framework\n *     validates buyer requests against the overlap pre-adapter.\n *   - {@link FinalizeProposalRequest} / {@link FinalizeProposalSuccess} —\n *     framework-internal shapes for the finalize lifecycle (wired in the\n *     v1.5 dispatch helpers).\n *\n * @public\n * @packageDocumentation\n */\n\nimport type { MaybePromise } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext } from '../context';\nimport type { GetProductsResponse } from '../../../types/tools.generated';\nimport type { CanonicalCreativeResponse, CanonicalGetProductsRequest } from '../../../v2/projection/creative-delivery';\nimport type { RequireCacheScopeWhenProducts, ServerPayload } from '../../../types/server-payload';\nimport type { TaskHandoff } from '../async-outcome';\nimport type { GetProductsProjectionInput } from '../specialisms/sales';\n\nexport type ProposalGetProductsPayload = RequireCacheScopeWhenProducts<\n  Omit<ServerPayload<CanonicalCreativeResponse<GetProductsResponse>>, 'products'> & {\n    products?: GetProductsProjectionInput[];\n  }\n>;\nexport type LegacyProposalGetProductsPayload = RequireCacheScopeWhenProducts<ServerPayload<GetProductsResponse>>;\n\n// ---------------------------------------------------------------------------\n// Capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Sales specialisms a {@link ProposalManager} can serve. Mirrors the\n * `sales-*` slugs in the spec's specialism enum.\n *\n * v1 scopes to the two `ProposalManager`-relevant flavours; broader\n * coverage (broadcast-tv, social, proposal-mode, catalog-driven) lands\n * as adopter signal grows.\n *\n * @public\n */\nexport type ProposalSalesSpecialism = 'sales-guaranteed' | 'sales-non-guaranteed';\n\n/**\n * Capability declaration for a {@link ProposalManager}.\n *\n * Sales-axis-scoped: proposal handling is a sales-specialism concern,\n * not a generic platform-wide concept. The `salesSpecialism` field\n * declares which AdCP sales specialism this manager serves; capability\n * flags declare which optional behaviours it supports.\n *\n * The framework reads this declaration at server-construction time to\n * decide which dispatch paths apply (e.g. `refineProducts` is only\n * invoked when `refine` is true; `finalizeProposal` is only invoked\n * when `finalize` is true).\n *\n * @public\n */\nexport interface ProposalCapabilities {\n  /**\n   * Which AdCP sales specialism this manager serves.\n   *\n   * `sales-guaranteed` for guaranteed-direct flows with proposal\n   * lifecycle (finalize → committed proposal → media buy).\n   *\n   * `sales-non-guaranteed` for catalog-style flows where `getProducts`\n   * returns a static catalog and buyers reference products directly at\n   * `create_media_buy`.\n   */\n  salesSpecialism: ProposalSalesSpecialism;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.refineProducts}\n   * and the framework routes `get_products` requests with\n   * `buying_mode: 'refine'` to that method. When false, refine requests\n   * fall through to `getProducts` (or surface `UNSUPPORTED_FEATURE` if\n   * the manager rejects them).\n   */\n  refine?: boolean;\n\n  /**\n   * When true, the manager implements {@link ProposalManager.finalizeProposal}\n   * and the framework intercepts `refine[i].action: 'finalize'` entries to\n   * commit drafts via the lifecycle helpers. When false, finalize entries\n   * pass through to the underlying `getProducts` / `refineProducts` method\n   * unchanged.\n   */\n  finalize?: boolean;\n\n  /**\n   * Grace window (in seconds) added to a committed proposal's `expires_at`\n   * before the framework rejects `create_media_buy` calls referencing the\n   * proposal with `PROPOSAL_EXPIRED`. Default 0 (strict).\n   */\n  expiresAtGraceSeconds?: number;\n\n  /**\n   * Signal-driven product assembly — the manager constructs products from\n   * buyer signals at request time rather than enumerating a static\n   * catalogue. Informational in v1.5; future PRs may validate that\n   * inventory / signal stores are wired when this flag is set.\n   */\n  dynamicProducts?: boolean;\n\n  /**\n   * The manager consults rate cards (per buyer relationship per product)\n   * when emitting prices. Informational in v1.5.\n   */\n  rateCardPricing?: boolean;\n\n  /**\n   * The manager reserves capacity at proposal time (typical for\n   * guaranteed). Informational in v1.5; the `finalize` transition that\n   * drives the actual hold is wired via the lifecycle helpers.\n   */\n  availabilityReservations?: boolean;\n}\n\n/**\n * Validate a {@link ProposalCapabilities} object. Throws when the declaration\n * is malformed (unknown `salesSpecialism`, negative `expiresAtGraceSeconds`).\n * The framework calls this at boot; adopters can call it from their own\n * config-validation code paths to fail fast on misconfiguration.\n *\n * Kept as a plain function rather than a class constructor to match the\n * codebase's preference for plain TS interfaces over runtime classes\n * for adopter-facing types.\n *\n * @public\n */\nexport function validateProposalCapabilities(caps: ProposalCapabilities): void {\n  const valid: readonly ProposalSalesSpecialism[] = ['sales-guaranteed', 'sales-non-guaranteed'];\n  if (!valid.includes(caps.salesSpecialism)) {\n    throw new Error(\n      `ProposalCapabilities.salesSpecialism must be one of ${JSON.stringify(valid)}. ` +\n        `Got ${JSON.stringify(caps.salesSpecialism)}. v1.5 scopes ProposalManager to the two ` +\n        `core sales specialisms; broader specialism support lands in subsequent releases.`\n    );\n  }\n  if (caps.expiresAtGraceSeconds != null && caps.expiresAtGraceSeconds < 0) {\n    throw new Error(\n      `ProposalCapabilities.expiresAtGraceSeconds must be >= 0; got ${caps.expiresAtGraceSeconds}. ` +\n        `The grace window extends the inventory hold past expires_at; negative values would shrink it.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Recipe + CapabilityOverlap\n// ---------------------------------------------------------------------------\n\n/**\n * Per-product subset of wire capability flags that the buyer can\n * configure on this product.\n *\n * Buyer requests asking for capabilities outside this overlap are\n * rejected by the framework before the adapter sees them (validated by\n * the lifecycle helpers — see `proposal/lifecycle.ts`).\n *\n * Each field is `ReadonlySet<string> | undefined`:\n *\n *   - `undefined` → framework does not gate this axis (open).\n *   - `ReadonlySet` → buyer choices must be subsets of this set.\n *     An empty set means deny-all on this axis.\n *\n * The undefined vs. empty-set distinction matches set intuition:\n * \"no constraint\" is `undefined`; \"allowed set is empty\" is `new Set()`.\n *\n * **Why no extras dict?** v1.5 deliberately omits an `extras` escape\n * hatch (per Python design § D4). Adopters with novel gating needs\n * extend the interface with typed fields; a dict bag leaves no paper\n * trail. If a new axis turns out to be widely useful, it lands as a\n * typed field on `CapabilityOverlap` upstream.\n *\n * @public\n */\nexport interface CapabilityOverlap {\n  /**\n   * Subset of wire `pricing_models` the buyer can choose. Validated\n   * against the matching `PricingOption.pricing_model` on the buyer's\n   * package.\n   */\n  pricingModels?: ReadonlySet<string>;\n\n  /**\n   * Subset of wire targeting dimensions (`geo`, `device_type`,\n   * `language`, etc.). Validated against the keys present on the\n   * buyer's `targeting_overlay`.\n   */\n  targetingDimensions?: ReadonlySet<string>;\n\n  /**\n   * Subset of `{ guaranteed, non_guaranteed }` the product offers.\n   */\n  deliveryTypes?: ReadonlySet<string>;\n\n  /**\n   * If the seller integrates signals, which signal types this product\n   * accepts. An empty set means the seller explicitly refuses all\n   * signals on this product; `undefined` means no framework gate.\n   */\n  signalTypes?: ReadonlySet<string>;\n}\n\n/**\n * Base type for typed product `implementation_config` payloads.\n *\n * Adopters declare a discriminated subtype with a literal `recipe_kind`:\n *\n * ```ts\n * interface GAMRecipe extends Recipe {\n *   recipe_kind: 'gam';\n *   line_item_template_id: string;\n *   ad_unit_ids: readonly string[];\n *   capability_overlap?: CapabilityOverlap;\n * }\n * ```\n *\n * The kind tag enables router-by-recipe-kind dispatch in the\n * multi-decisioning case (one ProposalManager + many DecisioningPlatforms,\n * each handling a subset of recipe kinds). v1.5 doesn't yet wire that\n * routing — adopters using a single DecisioningPlatform attach recipes\n * freely without registry validation.\n *\n * **The recipe is never on the buyer's wire surface.** It rides inside\n * `Product.implementation_config` (an opaque-to-buyer dict). Buyers treat\n * it as a black box; the framework persists it through the proposal\n * lifecycle so the executing DecisioningPlatform sees a stable view.\n *\n * `capability_overlap` is optional. When present, the framework activates\n * the v1.5 buyer-request validation seam against the declared subsets.\n *\n * @public\n */\nexport interface Recipe {\n  /** Adapter-family discriminator. Subtypes narrow with a literal type. */\n  recipe_kind: string;\n\n  /**\n   * Optional typed declaration of which wire capabilities the buyer can\n   * configure on this product. `undefined` means no framework gating.\n   * An explicit {@link CapabilityOverlap} activates the v1.5 validation.\n   */\n  capability_overlap?: CapabilityOverlap;\n}\n\n// ---------------------------------------------------------------------------\n// Finalize lifecycle shapes\n// ---------------------------------------------------------------------------\n\n/**\n * Framework-internal request shape passed to {@link ProposalManager.finalizeProposal}.\n *\n * Constructed by the framework dispatcher when a buyer's `get_products`\n * request with `buying_mode: 'refine'` carries a `refine[i].action: 'finalize'`\n * entry. Adopters don't parse the wire envelope; the framework projects.\n *\n * @public\n */\nexport interface FinalizeProposalRequest<TRecipe extends Recipe = Recipe> {\n  /**\n   * The draft proposal the buyer is asking to finalize. Hydrated from\n   * the wire's `refine[i].proposal_id` field.\n   */\n  proposalId: string;\n\n  /**\n   * `product_id -> Recipe` mapping pulled from the {@link ProposalStore}\n   * draft. The adopter's finalize logic typically lock-prices these and\n   * emits the committed proposal.\n   */\n  recipes: ReadonlyMap<string, TRecipe>;\n\n  /**\n   * The draft's wire `Proposal` shape (the same payload the adopter\n   * returned on the prior `getProducts` / `refineProducts` call).\n   * Adopter typically modifies this with locked pricing and returns it\n   * on {@link FinalizeProposalSuccess}.\n   */\n  proposalPayload: Record<string, unknown>;\n\n  /**\n   * The buyer's per-entry refine `ask` text — what they want finalized.\n   * Free-form; adopter consumes.\n   */\n  ask?: string;\n\n  /**\n   * The parent canonical get-products request so the adopter sees the full\n   * envelope (account, etc.) without the framework projecting fields\n   * one-by-one.\n   */\n  parentRequest: CanonicalGetProductsRequest;\n}\n\n/**\n * Adopter-returned shape from {@link ProposalManager.finalizeProposal} —\n * inline commit.\n *\n * Framework calls `ProposalStore.commit` with these fields before\n * projecting the wire response. The buyer sees the committed `Proposal`\n * with `proposal_status: 'committed'` + `expires_at` populated on the\n * next `get_products` response payload.\n *\n * @public\n */\nexport interface FinalizeProposalSuccess<TRecipe extends Recipe = Recipe> {\n  /**\n   * The wire `Proposal` shape with locked pricing and\n   * `proposal_status: 'committed'`. Adopter typically derives this from\n   * {@link FinalizeProposalRequest.proposalPayload} with modifications.\n   *\n   * **Must be JSON-serializable end-to-end** — non-JSON values won't\n   * survive a process restart through a durable {@link ProposalStore}.\n   */\n  proposal: Record<string, unknown>;\n\n  /**\n   * Inventory hold deadline. After this (plus the adopter's\n   * {@link ProposalCapabilities.expiresAtGraceSeconds} window), the\n   * framework rejects `create_media_buy` calls referencing the proposal\n   * with `PROPOSAL_EXPIRED`.\n   */\n  expiresAt: Date;\n\n  /**\n   * Optional refreshed recipe mapping. Omitting preserves the draft's\n   * recipes verbatim. Adopters whose finalize logic mutates recipe\n   * fields (e.g. locking a line-item template id) supply a fresh\n   * mapping.\n   */\n  recipes?: ReadonlyMap<string, TRecipe>;\n}\n\n// ---------------------------------------------------------------------------\n// ProposalManager interface\n// ---------------------------------------------------------------------------\n\ntype Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;\n\n/**\n * Assembles proposals from buyer briefs.\n *\n * Reads inventory, signals, rate cards, availability. Produces proposals\n * where each `Product` carries a typed `implementation_config` (a recipe;\n * see {@link Recipe}) that the bound `DecisioningPlatform` consumes at\n * `create_media_buy` time.\n *\n * Methods may be sync or async; the framework awaits whatever is\n * returned. Same convention as `SalesPlatform`.\n *\n * **Required surface:** {@link getProducts}.\n *\n * **Optional surfaces (capability-gated):**\n *\n *   - {@link refineProducts} — only invoked when\n *     {@link ProposalCapabilities.refine} is true.\n *   - {@link finalizeProposal} — only invoked when\n *     {@link ProposalCapabilities.finalize} is true. Wired by the\n *     framework's lifecycle helpers; intercepts `refine[i].action: 'finalize'`\n *     entries before the underlying `getProducts` / `refineProducts` runs.\n *\n * Throw `AdcpError` for buyer-fixable rejection (`BUDGET_TOO_LOW`,\n * `POLICY_VIOLATION`, `UNSUPPORTED_FEATURE`); the framework projects to\n * the wire structured-error envelope.\n *\n * Adopter typing tip: parameterize on your concrete `Recipe` subtype to\n * get end-to-end recipe typing through `ctx.recipes` in the bound\n * `DecisioningPlatform`'s methods:\n *\n * ```ts\n * type MyRecipe = GAMRecipe | KevelRecipe;\n * const manager: ProposalManager<MyRecipe, MyTenantMeta> = { ... };\n * ```\n *\n * @public\n */\nexport interface ProposalManager<TRecipe extends Recipe = Recipe, TCtxMeta = unknown> {\n  /**\n   * What this ProposalManager can do — sales specialism + capability flags.\n   */\n  capabilities: ProposalCapabilities;\n\n  /**\n   * Initial product discovery from a buyer brief.\n   *\n   * Each returned `Product` SHOULD carry an `implementation_config`\n   * matching the bound `DecisioningPlatform`'s recipe schema (see\n   * {@link Recipe}). The framework treats `implementation_config` as\n   * opaque on the wire; recipe typing is enforced through the\n   * `TRecipe` type parameter on the adopter side.\n   *\n   * For non-guaranteed flows: typically a static catalogue, possibly\n   * filtered by buyer brief / signals.\n   *\n   * For guaranteed flows: typically a brief-driven assembly consulting\n   * rate cards + availability. Adopters return draft proposals; the\n   * buyer drives the finalize transition via subsequent refine calls\n   * with `action: 'finalize'`.\n   */\n  getProducts(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Refine-mode iteration on a previous `getProducts` response.\n   *\n   * Per the spec, refine is a `buying_mode` value on `get_products` —\n   * the wire envelope is the same. The framework routes refine requests\n   * to this method when:\n   *\n   * 1. The wired ProposalManager declares `capabilities.refine` = true,\n   * 2. The request has `buying_mode === 'refine'`, AND\n   * 3. The manager implements this method.\n   *\n   * Otherwise refine requests fall through to {@link getProducts}.\n   *\n   * Adopters implementing `refineProducts` without `finalize` support\n   * should treat `action: 'finalize'` entries as `UNSUPPORTED_FEATURE`\n   * and return a structured error. Adopters with `finalize` support\n   * see those entries intercepted by the framework before this method\n   * is called.\n   */\n  refineProducts?(req: CanonicalGetProductsRequest, ctx: Ctx<TCtxMeta>): MaybePromise<ProposalGetProductsPayload>;\n\n  /**\n   * Commit a draft proposal to firm pricing + inventory hold.\n   *\n   * Wired by the framework's lifecycle helpers when:\n   *\n   * 1. `capabilities.finalize === true`,\n   * 2. The buyer's request has `buying_mode === 'refine'` with a\n   *    `refine[i]` entry of `{ scope: 'proposal', action: 'finalize',\n   *    proposal_id }`, AND\n   * 3. The proposal_id resolves to a DRAFT entry in the\n   *    {@link ProposalStore}.\n   *\n   * Return a {@link FinalizeProposalSuccess} for inline commit (the\n   * spec-default route), or a `TaskHandoff<FinalizeProposalSuccess>` to\n   * promote to a HITL background task. The HITL commit hook is wired\n   * in v1.6+; v1.5 inline-only.\n   */\n  finalizeProposal?(\n    req: FinalizeProposalRequest<TRecipe>,\n    ctx: Ctx<TCtxMeta>\n  ): MaybePromise<FinalizeProposalSuccess<TRecipe> | TaskHandoff<FinalizeProposalSuccess<TRecipe>>>;\n}\n"],"mappings":"AAsJO,SAAS,6BAA6B,MAAkC;AAC7E,QAAM,QAA4C,CAAC,oBAAoB,sBAAsB;AAC7F,MAAI,CAAC,MAAM,SAAS,KAAK,eAAe,GAAG;AACzC,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,KAAK,CAAC,SACnE,KAAK,UAAU,KAAK,eAAe,CAAC;AAAA,IAE/C;AAAA,EACF;AACA,MAAI,KAAK,yBAAyB,QAAQ,KAAK,wBAAwB,GAAG;AACxE,UAAM,IAAI;AAAA,MACR,gEAAgE,KAAK,qBAAqB;AAAA,IAE5F;AAAA,EACF;AACF;","names":[]}

package/dist/lib/server/decisioning/runtime/from-platform.d.mts

@@ -59,8 +59,11 @@ import type { PgQueryable } from '../../postgres-task-store.mjs';
 import { type TaskRegistry, type TaskRecord } from './task-registry.mjs';
 import { type StatusChangeBus } from '../status-changes.mjs';
 import { type ComplyControllerConfig } from '../../../testing/comply-controller.mjs';
-import { type LegacyFormatConverter } from '../../../v2/projection/v1-to-v2.mjs';
+import { type LegacyFormatConverter, type LegacyFormatResolver } from '../../../v2/projection/v1-to-v2.mjs';
 import type { CanonicalFormatLegacyResolver } from '../../../v2/projection/v2-to-v1.mjs';
+import { type V1FormatId } from '../../../v2/projection/types.mjs';
+/** Read exact SDK-private legacy routes restored on an auto-hydrated product or placement. */
+export declare function getHydratedLegacyFormatIds(value: unknown): readonly V1FormatId[] | undefined;
 /**
  * Lifecycle observability hooks the v6 runtime fires at well-known points.
  * Each callback is optional; throws are caught and logged via the framework
@@ -183,6 +186,16 @@ export interface CreateAdcpServerFromPlatformOptions extends Omit<AdcpServerConf
      * declaration (normally `format_kind: 'custom'` + shape/schema).
      */
     legacyCreativeFormatConverter?: LegacyFormatConverter;
+    /**
+     * Resolve seller-specific legacy product formats asynchronously before the
+     * canonical `get_products` projection. The resolver receives only the exact
+     * format tuple plus non-secret request routing context and fails closed.
+     */
+    legacyCreativeFormatResolver?: LegacyFormatResolver;
+    /** Shared resolver-phase deadline in milliseconds. Defaults to 10 seconds. */
+    legacyCreativeFormatResolverTimeoutMs?: number;
+    /** Maximum concurrent resolver calls within one get_products response (1–64). Defaults to 8. */
+    legacyCreativeFormatResolverConcurrency?: number;
     /** Resolve persisted canonical custom formats when this server emits a legacy wire response. */
     canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;
     /**

package/dist/lib/server/decisioning/runtime/from-platform.d.ts

@@ -59,8 +59,11 @@ import type { PgQueryable } from '../../postgres-task-store';
 import { type TaskRegistry, type TaskRecord } from './task-registry';
 import { type StatusChangeBus } from '../status-changes';
 import { type ComplyControllerConfig } from '../../../testing/comply-controller';
-import { type LegacyFormatConverter } from '../../../v2/projection/v1-to-v2';
+import { type LegacyFormatConverter, type LegacyFormatResolver } from '../../../v2/projection/v1-to-v2';
 import type { CanonicalFormatLegacyResolver } from '../../../v2/projection/v2-to-v1';
+import { type V1FormatId } from '../../../v2/projection/types';
+/** Read exact SDK-private legacy routes restored on an auto-hydrated product or placement. */
+export declare function getHydratedLegacyFormatIds(value: unknown): readonly V1FormatId[] | undefined;
 /**
  * Lifecycle observability hooks the v6 runtime fires at well-known points.
  * Each callback is optional; throws are caught and logged via the framework
@@ -183,6 +186,16 @@ export interface CreateAdcpServerFromPlatformOptions extends Omit<AdcpServerConf
      * declaration (normally `format_kind: 'custom'` + shape/schema).
      */
     legacyCreativeFormatConverter?: LegacyFormatConverter;
+    /**
+     * Resolve seller-specific legacy product formats asynchronously before the
+     * canonical `get_products` projection. The resolver receives only the exact
+     * format tuple plus non-secret request routing context and fails closed.
+     */
+    legacyCreativeFormatResolver?: LegacyFormatResolver;
+    /** Shared resolver-phase deadline in milliseconds. Defaults to 10 seconds. */
+    legacyCreativeFormatResolverTimeoutMs?: number;
+    /** Maximum concurrent resolver calls within one get_products response (1–64). Defaults to 8. */
+    legacyCreativeFormatResolverConcurrency?: number;
     /** Resolve persisted canonical custom formats when this server emits a legacy wire response. */
     canonicalFormatLegacyResolver?: CanonicalFormatLegacyResolver;
     /**

package/dist/lib/server/decisioning/runtime/from-platform.d.ts.map

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