@adcp/sdk 8.1.0-beta.1 → 8.1.0-beta.11

package/dist/lib/types/server-payload-aliases.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Named server/adopter payload aliases for generated AdCP response types.
+ *
+ * Generated `*Response` and `*Success` types describe wire responses. Server
+ * handlers return the domain payload before the SDK stamps protocol envelope
+ * fields such as `status`, `task_id`, and `adcp_version`. These aliases make
+ * that distinction discoverable from the public barrels.
+ */
+import type { ActivateSignalSuccess, BuildCreativeMultiSuccess, BuildCreativeSuccess, CalibrateContentResponse, CheckGovernanceResponse, CreateCollectionListResponse, CreateContentStandardsResponse, CreateMediaBuySuccess, CreatePropertyListResponse, DeleteCollectionListResponse, DeletePropertyListResponse, GetAccountFinancialsResponse, GetAccountFinancialsSuccess, GetAdCPCapabilitiesResponse, GetCollectionListResponse, GetContentStandardsResponse, GetCreativeDeliveryResponse, GetCreativeFeaturesResponse, GetMediaBuyArtifactsResponse, GetMediaBuyDeliveryResponse, GetMediaBuysResponse, GetPlanAuditLogsResponse, GetProductsResponse, GetPropertyListResponse, GetSignalsResponse, ListAccountsResponse, ListCollectionListsResponse, ListContentStandardsResponse, ListCreativeFormatsResponse, ListCreativesResponse, ListPropertyListsResponse, LogEventSuccess, PreviewCreativeResponse, ProvidePerformanceFeedbackSuccess, ReportPlanOutcomeResponse, ReportUsageResponse, SIGetOfferingResponse, SIInitiateSessionResponse, SISendMessageResponse, SITerminateSessionResponse, SyncAccountsResponse, SyncAccountsSuccess, SyncAudiencesSuccess, SyncCatalogsSuccess, SyncCreativesSuccess, SyncEventSourcesSuccess, SyncGovernanceResponse, SyncGovernanceSuccess, SyncPlansResponse, UpdateCollectionListResponse, UpdateContentStandardsResponse, UpdateMediaBuySuccess, UpdatePropertyListResponse, ValidateContentDeliveryResponse } from './tools.generated';
+import type { AcquireRightsAcquired, AcquireRightsPendingApproval, AcquireRightsRejected, CreativeApproved, CreativePendingReview, CreativeRejected, GetBrandIdentitySuccess, GetRightsResponse, GetRightsSuccess, UpdateRightsSuccess } from './core.generated';
+import type { ServerPayload } from './server-payload';
+export type GetAdCPCapabilitiesPayload = ServerPayload<GetAdCPCapabilitiesResponse>;
+export type ListAccountsPayload = ServerPayload<ListAccountsResponse>;
+export type SyncAccountsPayload = ServerPayload<SyncAccountsResponse>;
+export type SyncAccountsSuccessPayload = ServerPayload<SyncAccountsSuccess>;
+export type SyncGovernancePayload = ServerPayload<SyncGovernanceResponse>;
+export type SyncGovernanceSuccessPayload = ServerPayload<SyncGovernanceSuccess>;
+export type ReportUsagePayload = ServerPayload<ReportUsageResponse>;
+export type GetAccountFinancialsPayload = ServerPayload<GetAccountFinancialsResponse>;
+export type GetAccountFinancialsSuccessPayload = ServerPayload<GetAccountFinancialsSuccess>;
+export type GetProductsPayload = ServerPayload<GetProductsResponse>;
+export type CreateMediaBuyPayload = ServerPayload<CreateMediaBuySuccess>;
+export type UpdateMediaBuyPayload = ServerPayload<UpdateMediaBuySuccess>;
+export type GetMediaBuysPayload = ServerPayload<GetMediaBuysResponse>;
+export type GetMediaBuyDeliveryPayload = ServerPayload<GetMediaBuyDeliveryResponse>;
+export type ProvidePerformanceFeedbackPayload = ServerPayload<ProvidePerformanceFeedbackSuccess>;
+export type ListCreativeFormatsPayload = ServerPayload<ListCreativeFormatsResponse>;
+export type ListCreativesPayload = ServerPayload<ListCreativesResponse>;
+export type SyncCreativesPayload = ServerPayload<SyncCreativesSuccess>;
+export type SyncCatalogsPayload = ServerPayload<SyncCatalogsSuccess>;
+export type SyncEventSourcesPayload = ServerPayload<SyncEventSourcesSuccess>;
+export type LogEventPayload = ServerPayload<LogEventSuccess>;
+export type GetSignalsPayload = ServerPayload<GetSignalsResponse>;
+export type ActivateSignalPayload = ServerPayload<ActivateSignalSuccess>;
+export type SyncAudiencesPayload = ServerPayload<SyncAudiencesSuccess>;
+export type BuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
+export type BuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
+export type PreviewCreativePayload = ServerPayload<PreviewCreativeResponse>;
+export type GetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
+export type CreatePropertyListPayload = ServerPayload<CreatePropertyListResponse>;
+export type UpdatePropertyListPayload = ServerPayload<UpdatePropertyListResponse>;
+export type GetPropertyListPayload = ServerPayload<GetPropertyListResponse>;
+export type ListPropertyListsPayload = ServerPayload<ListPropertyListsResponse>;
+export type DeletePropertyListPayload = ServerPayload<DeletePropertyListResponse>;
+export type CreateCollectionListPayload = ServerPayload<CreateCollectionListResponse>;
+export type UpdateCollectionListPayload = ServerPayload<UpdateCollectionListResponse>;
+export type GetCollectionListPayload = ServerPayload<GetCollectionListResponse>;
+export type ListCollectionListsPayload = ServerPayload<ListCollectionListsResponse>;
+export type DeleteCollectionListPayload = ServerPayload<DeleteCollectionListResponse>;
+export type ListContentStandardsPayload = ServerPayload<ListContentStandardsResponse>;
+export type GetContentStandardsPayload = ServerPayload<GetContentStandardsResponse>;
+export type CreateContentStandardsPayload = ServerPayload<CreateContentStandardsResponse>;
+export type UpdateContentStandardsPayload = ServerPayload<UpdateContentStandardsResponse>;
+export type CalibrateContentPayload = ServerPayload<CalibrateContentResponse>;
+export type ValidateContentDeliveryPayload = ServerPayload<ValidateContentDeliveryResponse>;
+export type GetMediaBuyArtifactsPayload = ServerPayload<GetMediaBuyArtifactsResponse>;
+export type GetCreativeFeaturesPayload = ServerPayload<GetCreativeFeaturesResponse>;
+export type SyncPlansPayload = ServerPayload<SyncPlansResponse>;
+export type CheckGovernancePayload = ServerPayload<CheckGovernanceResponse>;
+export type ReportPlanOutcomePayload = ServerPayload<ReportPlanOutcomeResponse>;
+export type GetPlanAuditLogsPayload = ServerPayload<GetPlanAuditLogsResponse>;
+export type SIGetOfferingPayload = ServerPayload<SIGetOfferingResponse>;
+export type SIInitiateSessionPayload = ServerPayload<SIInitiateSessionResponse>;
+export type SISendMessagePayload = ServerPayload<SISendMessageResponse>;
+export type SITerminateSessionPayload = ServerPayload<SITerminateSessionResponse>;
+export type GetBrandIdentityPayload = ServerPayload<GetBrandIdentitySuccess>;
+export type GetRightsPayload = ServerPayload<GetRightsSuccess>;
+export type GetRightsResponsePayload = ServerPayload<GetRightsResponse>;
+export type AcquireRightsAcquiredPayload = ServerPayload<AcquireRightsAcquired>;
+export type AcquireRightsPendingApprovalPayload = ServerPayload<AcquireRightsPendingApproval>;
+export type AcquireRightsRejectedPayload = ServerPayload<AcquireRightsRejected>;
+export type AcquireRightsPayload = AcquireRightsAcquiredPayload | AcquireRightsPendingApprovalPayload | AcquireRightsRejectedPayload;
+export type UpdateRightsPayload = ServerPayload<UpdateRightsSuccess>;
+export type CreativeApprovedPayload = ServerPayload<CreativeApproved>;
+export type CreativeRejectedPayload = ServerPayload<CreativeRejected>;
+export type CreativePendingReviewPayload = ServerPayload<CreativePendingReview>;
+export type CreativeApprovalPayload = CreativeApprovedPayload | CreativeRejectedPayload | CreativePendingReviewPayload;
+//# sourceMappingURL=server-payload-aliases.d.ts.map

package/dist/lib/types/server-payload-aliases.d.ts.map

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

package/dist/lib/types/server-payload-aliases.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Named server/adopter payload aliases for generated AdCP response types.
+ *
+ * Generated `*Response` and `*Success` types describe wire responses. Server
+ * handlers return the domain payload before the SDK stamps protocol envelope
+ * fields such as `status`, `task_id`, and `adcp_version`. These aliases make
+ * that distinction discoverable from the public barrels.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server-payload-aliases.js.map

package/dist/lib/types/server-payload-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-payload-aliases.js","sourceRoot":"","sources":["../../../src/lib/types/server-payload-aliases.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/lib/types/server-payload.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Server-side handler payload helpers.
+ *
+ * Generated AdCP response types describe the transport/wire shape. In v3.1
+ * that includes protocol envelope fields such as `status: TaskStatus`,
+ * `task_id`, and `adcp_version`. Server handlers should return only the
+ * domain payload; the SDK stamps the protocol envelope at dispatch time.
+ */
+import type { TaskStatus } from './tools.generated';
+type ProtocolTaskStatus = TaskStatus;
+type ProtocolStatusKey<T> = 'status' extends keyof T ? NonNullable<T['status']> extends ProtocolTaskStatus ? 'status' : never : never;
+type ProtocolEnvelopeKeys<T> = ProtocolStatusKey<T> | 'context_id' | 'task_id' | 'message' | 'timestamp' | 'replayed' | 'adcp_error' | 'push_notification_config' | 'payload' | 'adcp_version' | 'adcp_major_version';
+type JsonPrimitive = string | number | boolean | null | undefined;
+type StripAuthenticationCredentials<T> = T extends {
+    authentication?: infer TAuth;
+} ? Omit<T, 'authentication'> & {
+    authentication?: TAuth extends object ? Omit<StripWriteOnlyResponseFields<TAuth>, 'credentials'> : TAuth;
+} : T;
+type StripBusinessEntityBank<T> = T extends {
+    bank?: unknown;
+} ? Omit<T, 'bank'> : T;
+type StripWriteOnlyResponseFields<T> = T extends JsonPrimitive ? T : T extends (infer TItem)[] ? StripWriteOnlyResponseFields<TItem>[] : T extends readonly (infer TItem)[] ? readonly StripWriteOnlyResponseFields<TItem>[] : T extends object ? StripAuthenticationCredentials<StripBusinessEntityBank<{
+    [K in keyof T]: StripWriteOnlyResponseFields<T[K]>;
+}>> : T;
+/**
+ * Domain payload shape a server handler returns for a generated wire response.
+ *
+ * Use this when a generated `*Response` type includes protocol-envelope fields
+ * the SDK owns. Domain-level `status` fields are preserved unless their entire
+ * type is the protocol `TaskStatus` vocabulary.
+ *
+ * Write-only legacy webhook credentials and billing bank coordinates are
+ * also removed from nested objects. Runtime response projection already
+ * strips these; this keeps public server payload annotations aligned with
+ * what can safely appear on response wires and in adopter logs.
+ */
+export type ServerPayload<T> = T extends unknown ? StripWriteOnlyResponseFields<Omit<T, ProtocolEnvelopeKeys<T>>> : never;
+export {};
+//# sourceMappingURL=server-payload.d.ts.map

package/dist/lib/types/server-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-payload.d.ts","sourceRoot":"","sources":["../../../src/lib/types/server-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,KAAK,kBAAkB,GAAG,UAAU,CAAC;AAErC,KAAK,iBAAiB,CAAC,CAAC,IAAI,QAAQ,SAAS,MAAM,CAAC,GAChD,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,kBAAkB,GACjD,QAAQ,GACR,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,oBAAoB,CAAC,CAAC,IACvB,iBAAiB,CAAC,CAAC,CAAC,GACpB,YAAY,GACZ,SAAS,GACT,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,0BAA0B,GAC1B,SAAS,GACT,cAAc,GACd,oBAAoB,CAAC;AAEzB,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAElE,KAAK,8BAA8B,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,cAAc,CAAC,EAAE,MAAM,KAAK,CAAA;CAAE,GAC/E,IAAI,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG;IAC1B,cAAc,CAAC,EAAE,KAAK,SAAS,MAAM,GAAG,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC;CAC1G,GACD,CAAC,CAAC;AAEN,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAErF,KAAK,4BAA4B,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,GAC1D,CAAC,GACD,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACvB,4BAA4B,CAAC,KAAK,CAAC,EAAE,GACrC,CAAC,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GAChC,SAAS,4BAA4B,CAAC,KAAK,CAAC,EAAE,GAC9C,CAAC,SAAS,MAAM,GACd,8BAA8B,CAC5B,uBAAuB,CAAC;KACrB,CAAC,IAAI,MAAM,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnD,CAAC,CACH,GACD,CAAC,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAC5C,4BAA4B,CAAC,IAAI,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9D,KAAK,CAAC"}

package/dist/lib/types/server-payload.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Server-side handler payload helpers.
+ *
+ * Generated AdCP response types describe the transport/wire shape. In v3.1
+ * that includes protocol envelope fields such as `status: TaskStatus`,
+ * `task_id`, and `adcp_version`. Server handlers should return only the
+ * domain payload; the SDK stamps the protocol envelope at dispatch time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server-payload.js.map

package/dist/lib/types/server-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-payload.js","sourceRoot":"","sources":["../../../src/lib/types/server-payload.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/lib/types/si-get-offering.d.ts

@@ -0,0 +1,259 @@
+// AUTO-GENERATED — DO NOT EDIT.
+// Per-tool .d.ts slice for `si_get_offering`. Built from the published
+// `tools.generated.d.ts` + `core.generated.d.ts` + `enums.generated.d.ts`
+// by `scripts/generate-per-tool-types.ts`.
+//
+// Self-contained: imports nothing from the broader SDK. Adopters who
+// import only this slice pay a fraction of the tsc cost of pulling in
+// `@adcp/sdk` root — useful when strict + skipLibCheck:false adopters
+// hit memory pressure on the full surface.
+
+/**
+ * Get offering details and availability before session handoff. Returns offering information, availability status, and optionally matching products based on context.
+ */
+export interface SIGetOfferingRequest {
+    /**
+     * Release-precision AdCP version (VERSION.RELEASE, e.g. "3.0", "3.1", "3.1-beta"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = "3.1.0-beta.1") MUST normalize to release-precision ("3.1-beta.1") before emitting on the wire — meta-field values are NOT valid wire values.
+     */
+    adcp_version?: string;
+    /**
+     * DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
+    /**
+     * Offering identifier from the catalog to get details for
+     */
+    offering_id: string;
+    /**
+     * Optional natural language description of user intent for personalized results (e.g., 'mens size 14 near Cincinnati'). Must be anonymous - no PII.
+     */
+    intent?: string;
+    context?: ContextObject;
+    /**
+     * Whether to include matching products in the response
+     */
+    include_products?: boolean;
+    /**
+     * Maximum number of matching products to return
+     * @minimum 1
+     * @maximum 50
+     */
+    product_limit?: number;
+    ext?: ExtensionObject;
+}
+
+/**
+ * Offering details, availability status, and optionally matching products. Use the offering_token in si_initiate_session for correlation.
+ */
+export interface SIGetOfferingResponse {
+    /**
+     * Session/conversation identifier for tracking related operations across multiple task invocations. Managed by the protocol layer to maintain conversational context. Distinct from `context` (per-request opaque echo, see below).
+     */
+    context_id?: string;
+    context?: ContextObject;
+    /**
+     * Unique identifier for tracking asynchronous operations. Present when a task requires extended processing time. Used to query task status and retrieve results when complete.
+     */
+    task_id?: string;
+    status: TaskStatus;
+    /**
+     * Human-readable summary of the task result. Provides natural language explanation of what happened, suitable for display to end users or for AI agent comprehension. Generated by the protocol layer based on the task response.
+     */
+    message?: string;
+    /**
+     * ISO 8601 timestamp when the response was generated. Useful for debugging, logging, cache validation, and tracking async operation progress.
+     */
+    timestamp?: string;
+    /**
+     * Set to true when this response was returned from the idempotency cache rather than from a fresh execution. Set to false (or omitted) when the request was executed fresh. Buyers use this to distinguish cached replays from new executions — matters for billing reconciliation, audit logs, state-machine routing (cached state-tracking fields are historical snapshots, not current state — re-read via the resource's read endpoint), and any downstream system that assumes exactly-once event semantics. From 3.1 onward, `replayed` MAY appear on responses to any request that resolved via the idempotency cache, including read tools — universal `idempotency_key` (see security.mdx §Idempotency) means the cache holds read responses too.
+     */
+    replayed?: boolean;
+    adcp_error?: Error;
+    push_notification_config?: PushNotificationConfig;
+    /**
+     * Governance context token issued by the account's governance agent during check_governance. Buyers attach it to governed purchase requests (media buys, rights acquisitions, signal activations, creative services); sellers persist it and include it on all subsequent governance calls for that action's lifecycle. An account binds to one governance agent (see sync_governance); governance is phased across `purchase` / `modification` / `delivery`, not partitioned across specialist agents, so the envelope carries a single token for the full lifecycle.
+     *
+     * Value format: governance agents MUST emit a compact JWS per the AdCP JWS profile (see Security — Signed Governance Context). Sellers MAY verify; sellers that do not verify MUST persist and forward the token unchanged. In 3.1 all sellers MUST verify. Non-JWS values from pre-3.0 governance agents are deprecated.
+     *
+     * This is the primary correlation key for audit and reporting across the governance lifecycle.
+     */
+    governance_context?: string;
+    /**
+     * Conceptual grouping for the task-specific response data defined by individual task response schemas (e.g., get-products-response.json, create-media-buy-response.json). `payload` is a documentary construct — it is NOT a required wire field, and its on-the-wire shape depends on transport (see Transport serialization below). Task response schemas declare body fields without wrapping them in a `payload` object; the wire representation places those body fields per transport convention. On MCP the body fields appear as siblings of envelope fields at the root of the tool response; on A2A they appear inside `task.artifacts[0].parts[].DataPart`; on REST they appear at the root of the JSON body.
+     */
+    payload?: {};
+    /**
+     * Release-precision AdCP version (VERSION.RELEASE, e.g. "3.0", "3.1", "3.1-beta"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = "3.1.0-beta.1") MUST normalize to release-precision ("3.1-beta.1") before emitting on the wire — meta-field values are NOT valid wire values.
+     */
+    adcp_version?: string;
+    /**
+     * DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
+    /**
+     * Whether the offering is currently available
+     */
+    available: boolean;
+    /**
+     * Token to pass to si_initiate_session for session continuity. Brand stores the full query context server-side (products shown, order, context) so they can resolve references like 'the second one' when the session starts.
+     */
+    offering_token?: string;
+    /**
+     * How long this offering information is valid (seconds). Host should re-fetch after TTL expires.
+     * @minimum 0
+     */
+    ttl_seconds?: number;
+    /**
+     * When this offering information was retrieved
+     * @format date-time
+     */
+    checked_at?: string;
+    /**
+     * Offering details
+     */
+    offering?: {
+        /**
+         * Offering identifier
+         */
+        offering_id?: string;
+        /**
+         * Offering title
+         */
+        title?: string;
+        /**
+         * Brief summary of the offering
+         */
+        summary?: string;
+        /**
+         * Short promotional tagline
+         */
+        tagline?: string;
+        /**
+         * When this offering expires
+         * @format date-time
+         */
+        expires_at?: string;
+        /**
+         * Price indication (e.g., 'from $199', '50% off')
+         */
+        price_hint?: string;
+        /**
+         * Hero image for the offering
+         */
+        image_url?: string;
+        /**
+         * Landing page URL
+         */
+        landing_url?: string;
+    };
+    /**
+     * Products matching the request context. Only included if include_products was true.
+     */
+    matching_products?: {
+        /**
+         * Product identifier
+         */
+        product_id: string;
+        /**
+         * Product name
+         */
+        name: string;
+        /**
+         * Display price (e.g., '$129', '$89.99')
+         */
+        price?: string;
+        /**
+         * Original price if on sale
+         */
+        original_price?: string;
+        /**
+         * Product image
+         */
+        image_url?: string;
+        /**
+         * Brief availability info (e.g., 'In stock', 'Size 14 available', '3 left')
+         */
+        availability_summary?: string;
+        /**
+         * Product detail page URL
+         */
+        url?: string;
+    }[];
+    /**
+     * Total number of products matching the context (may be more than returned in matching_products)
+     * @minimum 0
+     */
+    total_matching?: number;
+    /**
+     * If not available, why (e.g., 'expired', 'sold_out', 'region_restricted')
+     */
+    unavailable_reason?: string;
+    /**
+     * Alternative offerings to consider if this one is unavailable
+     */
+    alternative_offering_ids?: string[];
+    /**
+     * Errors during offering lookup
+     */
+    errors?: Error[];
+    ext?: ExtensionObject;
+}
+
+/**
+ * Legacy authentication schemes for the webhook auth block. Bearer: token sent in Authorization header. HMAC-SHA256: legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit the authentication block and use the RFC 9421 webhook signing profile (applicable on schemas where authentication is optional). Removed in AdCP 4.0.
+ */
+export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
+
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+export interface ContextObject {
+}
+
+/**
+ * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ */
+export interface ExtensionObject {
+}
+
+/**
+ * Push notification configuration for async task updates (A2A and REST protocols). Echoed from the request to confirm webhook settings. Specifies URL, authentication scheme (Bearer or HMAC-SHA256), and credentials. MCP uses progress notifications instead of webhooks.
+ */
+export interface PushNotificationConfig {
+    /**
+     * Webhook endpoint URL for task status notifications. The wire contract is unconstrained beyond `format: "uri"` — in particular, publishers SHOULD NOT enforce a destination-port allowlist by default, since buyers legitimately host receivers on non-standard TLS ports (`:9443`, `:4443`, path-routed multi-tenant gateways). The SSRF guard the protocol relies on is the IP-range check + DNS-rebinding-resistant connect pin defined in [Webhook URL validation (SSRF)](/docs/building/by-layer/L1/security#webhook-url-validation-ssrf), not port filtering. Operators who want a hardened destination-port allowlist as defense-in-depth (e.g., locked-down enterprise egress) opt in explicitly — see [Destination port: permissive by default](/docs/building/by-layer/L1/security#destination-port-permissive-by-default).
+     */
+    url: string;
+    /**
+     * Buyer-supplied correlation identifier for the operation that will produce webhooks against this registration. The seller MUST echo this value verbatim into every webhook payload's `operation_id` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) and [Webhooks — Operation IDs](/docs/building/by-layer/L3/webhooks#operation-ids-and-url-templates)). Buyers SHOULD generate a unique value per task invocation (UUID recommended). This field is the canonical registration channel for `operation_id`; buyers MAY additionally embed the same value in the URL path or query as a routing aid for their own HTTP server, but the URL is opaque to the seller and the wire-level source of truth is this field. Sellers MUST NOT parse the URL to recover `operation_id`. Sellers that receive a webhook registration without `operation_id` MAY reject the task with `INVALID_REQUEST`.
+     * @minLength 1
+     * @maxLength 255
+     * @pattern ^[A-Za-z0-9_.:-]{1,255}$
+     */
+    operation_id?: string;
+    /**
+     * Optional client-provided token for webhook validation. The seller MUST echo this value verbatim in every webhook payload's `token` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) for the receiver-side validation obligation). Length bounds give receivers a defensive range check on the echoed value; senders SHOULD generate tokens with at least 128 bits of entropy (≥22 base64url characters). This is a complementary authenticity mechanism that can layer on top of the RFC 9421 webhook signature — unlike the `authentication` block below, it is not on the 4.0 removal track. Receivers that registered both a signing key (RFC 9421) and a `token` MUST NOT treat a valid token echo as authorization to skip signature verification; both checks remain independent obligations.
+     * @minLength 16
+     * @maxLength 4096
+     */
+    token?: string;
+    /**
+     * Legacy authentication configuration (A2A-compatible). Opts the seller into Bearer or HMAC-SHA256 signing instead of the default RFC 9421 webhook profile. Deprecated; removed in AdCP 4.0. **Precedence is a switch, not a fallback:** presence of this block selects the legacy scheme; absence selects 9421. A seller MUST NOT sign the same webhook both ways, and a buyer MUST NOT attempt 'try 9421 first, fall back to HMAC' verification — signature mode is determined solely by whether this block was present at registration time. The seller's baseline 9421 webhook-signing key published at its brand.json `agents[]` `jwks_uri` does not override this selector; it is always discoverable but only used when `authentication` is omitted. See docs/building/implementation/security.mdx#webhook-callbacks for the full precedence and downgrade-resistance rules (including the `webhook_mode_mismatch` rejection a buyer MUST apply when a received webhook's signing mode does not match the registered mode).
+     */
+    authentication?: {
+        /**
+         * Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit `authentication` and use the RFC 9421 webhook profile.
+         */
+        schemes: AuthenticationScheme[];
+        /**
+         * Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.
+         * @minLength 32
+         */
+        credentials: string;
+    };
+}
+
+/**
+ * Current task execution state. Indicates whether the task is completed, in progress (working), submitted for async processing, failed, or requires user input. REQUIRED on every task response envelope. Synchronous tasks (including read-only metadata calls like `get_adcp_capabilities`) MUST emit `status: "completed"`; async tasks emit `submitted`, `working`, `input-required`, etc. per their lifecycle. Agents MUST NOT emit the legacy task_status or response_status fields alongside this field — the status field is the single authoritative task state.
+ */
+export type TaskStatus = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'rejected' | 'auth-required' | 'unknown';