@adcp/sdk 14.0.0 → 14.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/dist/lib/adapters/implicit-account-store.d.mts +12 -7
  2. package/dist/lib/adapters/implicit-account-store.d.ts +12 -7
  3. package/dist/lib/adapters/implicit-account-store.js +69 -15
  4. package/dist/lib/adapters/implicit-account-store.mjs +69 -15
  5. package/dist/lib/core/AgentClient.d.mts +1 -0
  6. package/dist/lib/core/AgentClient.d.ts +1 -0
  7. package/dist/lib/core/AgentClient.js +3 -0
  8. package/dist/lib/core/AgentClient.mjs +3 -0
  9. package/dist/lib/core/SingleAgentClient.d.mts +31 -1
  10. package/dist/lib/core/SingleAgentClient.d.ts +31 -1
  11. package/dist/lib/core/SingleAgentClient.js +355 -35
  12. package/dist/lib/core/SingleAgentClient.mjs +365 -37
  13. package/dist/lib/core/TaskExecutor.js +2 -1
  14. package/dist/lib/core/TaskExecutor.mjs +2 -1
  15. package/dist/lib/core/account-key.d.mts +3 -0
  16. package/dist/lib/core/account-key.d.ts +3 -0
  17. package/dist/lib/core/account-key.js +41 -0
  18. package/dist/lib/core/account-key.mjs +17 -0
  19. package/dist/lib/core/account-resolution.d.mts +2 -0
  20. package/dist/lib/core/account-resolution.d.ts +2 -0
  21. package/dist/lib/core/buyer-account-registry.d.mts +65 -0
  22. package/dist/lib/core/buyer-account-registry.d.ts +65 -0
  23. package/dist/lib/core/buyer-account-registry.js +518 -0
  24. package/dist/lib/core/buyer-account-registry.mjs +494 -0
  25. package/dist/lib/core/product-cache.d.mts +18 -0
  26. package/dist/lib/core/product-cache.d.ts +18 -0
  27. package/dist/lib/core/product-cache.js +137 -0
  28. package/dist/lib/core/product-cache.mjs +112 -0
  29. package/dist/lib/errors/index.d.mts +40 -1
  30. package/dist/lib/errors/index.d.ts +40 -1
  31. package/dist/lib/errors/index.js +69 -3
  32. package/dist/lib/errors/index.mjs +64 -3
  33. package/dist/lib/governance/authorization.d.mts +17 -1
  34. package/dist/lib/governance/authorization.d.ts +17 -1
  35. package/dist/lib/governance/authorization.js +55 -7
  36. package/dist/lib/governance/authorization.mjs +59 -7
  37. package/dist/lib/governance/index.d.mts +2 -2
  38. package/dist/lib/governance/index.d.ts +2 -2
  39. package/dist/lib/governance/index.js +2 -0
  40. package/dist/lib/governance/index.mjs +3 -1
  41. package/dist/lib/index.d.mts +5 -3
  42. package/dist/lib/index.d.ts +5 -3
  43. package/dist/lib/index.js +20 -0
  44. package/dist/lib/index.mjs +19 -0
  45. package/dist/lib/protocols/a2a.js +9 -1
  46. package/dist/lib/protocols/a2a.mjs +9 -1
  47. package/dist/lib/protocols/index.js +9 -2
  48. package/dist/lib/protocols/index.mjs +9 -2
  49. package/dist/lib/protocols/mcp-modern.js +2 -1
  50. package/dist/lib/protocols/mcp-modern.mjs +2 -1
  51. package/dist/lib/protocols/mcp.js +5 -2
  52. package/dist/lib/protocols/mcp.mjs +5 -2
  53. package/dist/lib/protocols/rawResponseCapture.d.mts +6 -0
  54. package/dist/lib/protocols/rawResponseCapture.d.ts +6 -0
  55. package/dist/lib/protocols/rawResponseCapture.js +41 -29
  56. package/dist/lib/protocols/rawResponseCapture.mjs +40 -29
  57. package/dist/lib/protocols/signedRequestRejection.d.mts +9 -0
  58. package/dist/lib/protocols/signedRequestRejection.d.ts +9 -0
  59. package/dist/lib/protocols/signedRequestRejection.js +209 -0
  60. package/dist/lib/protocols/signedRequestRejection.mjs +189 -0
  61. package/dist/lib/protocols/transportDiagnostics.d.mts +1 -0
  62. package/dist/lib/protocols/transportDiagnostics.d.ts +1 -0
  63. package/dist/lib/protocols/transportDiagnostics.js +2 -0
  64. package/dist/lib/protocols/transportDiagnostics.mjs +1 -0
  65. package/dist/lib/registry/types.generated.d.mts +112 -45
  66. package/dist/lib/registry/types.generated.d.ts +112 -45
  67. package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
  68. package/dist/lib/server/account-provisioning.d.mts +2 -0
  69. package/dist/lib/server/account-provisioning.d.ts +2 -0
  70. package/dist/lib/server/account-provisioning.js +30 -0
  71. package/dist/lib/server/account-provisioning.mjs +6 -0
  72. package/dist/lib/server/account-reference-warnings.d.mts +12 -0
  73. package/dist/lib/server/account-reference-warnings.d.ts +12 -0
  74. package/dist/lib/server/account-reference-warnings.js +48 -0
  75. package/dist/lib/server/account-reference-warnings.mjs +23 -0
  76. package/dist/lib/server/auth-signature.js +1 -0
  77. package/dist/lib/server/auth-signature.mjs +1 -0
  78. package/dist/lib/server/create-adcp-server.d.mts +34 -0
  79. package/dist/lib/server/create-adcp-server.d.ts +34 -0
  80. package/dist/lib/server/create-adcp-server.js +225 -14
  81. package/dist/lib/server/create-adcp-server.mjs +225 -14
  82. package/dist/lib/server/decisioning/account.d.mts +2 -0
  83. package/dist/lib/server/decisioning/account.d.ts +2 -0
  84. package/dist/lib/server/decisioning/runtime/from-platform.js +49 -10
  85. package/dist/lib/server/decisioning/runtime/from-platform.mjs +49 -10
  86. package/dist/lib/server/index.d.mts +2 -2
  87. package/dist/lib/server/index.d.ts +2 -2
  88. package/dist/lib/server/index.js +2 -0
  89. package/dist/lib/server/index.mjs +3 -1
  90. package/dist/lib/signing/agent-resolver/consistency.d.mts +6 -13
  91. package/dist/lib/signing/agent-resolver/consistency.d.ts +6 -13
  92. package/dist/lib/signing/agent-resolver/consistency.js +0 -1
  93. package/dist/lib/signing/agent-resolver/consistency.mjs +0 -1
  94. package/dist/lib/signing/agent-resolver/errors.d.mts +1 -1
  95. package/dist/lib/signing/agent-resolver/errors.d.ts +1 -1
  96. package/dist/lib/signing/agent-resolver/fetch-helpers.d.mts +2 -0
  97. package/dist/lib/signing/agent-resolver/fetch-helpers.d.ts +2 -0
  98. package/dist/lib/signing/agent-resolver/fetch-helpers.js +2 -1
  99. package/dist/lib/signing/agent-resolver/fetch-helpers.mjs +2 -1
  100. package/dist/lib/signing/agent-resolver/jwks-set.js +24 -3
  101. package/dist/lib/signing/agent-resolver/jwks-set.mjs +24 -3
  102. package/dist/lib/signing/agent-resolver/legacy-brand.d.mts +15 -0
  103. package/dist/lib/signing/agent-resolver/legacy-brand.d.ts +15 -0
  104. package/dist/lib/signing/agent-resolver/legacy-brand.js +60 -0
  105. package/dist/lib/signing/agent-resolver/legacy-brand.mjs +36 -0
  106. package/dist/lib/signing/agent-resolver/operator-authorization.d.mts +13 -0
  107. package/dist/lib/signing/agent-resolver/operator-authorization.d.ts +13 -0
  108. package/dist/lib/signing/agent-resolver/operator-authorization.js +108 -0
  109. package/dist/lib/signing/agent-resolver/operator-authorization.mjs +84 -0
  110. package/dist/lib/signing/agent-resolver/resolve-agent.d.mts +14 -4
  111. package/dist/lib/signing/agent-resolver/resolve-agent.d.ts +14 -4
  112. package/dist/lib/signing/agent-resolver/resolve-agent.js +101 -132
  113. package/dist/lib/signing/agent-resolver/resolve-agent.mjs +102 -133
  114. package/dist/lib/signing/agent-resolver/resolved-agent-jwks.d.mts +7 -1
  115. package/dist/lib/signing/agent-resolver/resolved-agent-jwks.d.ts +7 -1
  116. package/dist/lib/signing/agent-resolver/resolved-agent-jwks.js +50 -17
  117. package/dist/lib/signing/agent-resolver/resolved-agent-jwks.mjs +50 -17
  118. package/dist/lib/signing/agent-resolver/select-agent.d.mts +14 -15
  119. package/dist/lib/signing/agent-resolver/select-agent.d.ts +14 -15
  120. package/dist/lib/signing/agent-resolver/select-agent.js +98 -13
  121. package/dist/lib/signing/agent-resolver/select-agent.mjs +95 -13
  122. package/dist/lib/signing/brand-jwks.d.mts +27 -75
  123. package/dist/lib/signing/brand-jwks.d.ts +27 -75
  124. package/dist/lib/signing/brand-jwks.js +112 -182
  125. package/dist/lib/signing/brand-jwks.mjs +112 -182
  126. package/dist/lib/signing/errors.d.mts +3 -1
  127. package/dist/lib/signing/errors.d.ts +3 -1
  128. package/dist/lib/signing/errors.js +4 -1
  129. package/dist/lib/signing/errors.mjs +4 -1
  130. package/dist/lib/signing/jwks-https.d.mts +7 -0
  131. package/dist/lib/signing/jwks-https.d.ts +7 -0
  132. package/dist/lib/signing/jwks-https.js +31 -8
  133. package/dist/lib/signing/jwks-https.mjs +31 -8
  134. package/dist/lib/signing/jwks.d.mts +8 -0
  135. package/dist/lib/signing/jwks.d.ts +8 -0
  136. package/dist/lib/signing/middleware.js +2 -1
  137. package/dist/lib/signing/middleware.mjs +2 -1
  138. package/dist/lib/signing/publisher-pins.d.mts +11 -0
  139. package/dist/lib/signing/publisher-pins.d.ts +11 -0
  140. package/dist/lib/signing/publisher-pins.js +125 -0
  141. package/dist/lib/signing/publisher-pins.mjs +101 -0
  142. package/dist/lib/signing/server.d.mts +1 -0
  143. package/dist/lib/signing/server.d.ts +1 -0
  144. package/dist/lib/signing/types.d.mts +5 -0
  145. package/dist/lib/signing/types.d.ts +5 -0
  146. package/dist/lib/signing/verifier.js +49 -4
  147. package/dist/lib/signing/verifier.mjs +49 -4
  148. package/dist/lib/signing/webhook-verifier.d.mts +7 -2
  149. package/dist/lib/signing/webhook-verifier.d.ts +7 -2
  150. package/dist/lib/signing/webhook-verifier.js +42 -2
  151. package/dist/lib/signing/webhook-verifier.mjs +43 -3
  152. package/dist/lib/testing/storyboard/account-policy.d.mts +2 -0
  153. package/dist/lib/testing/storyboard/account-policy.d.ts +2 -0
  154. package/dist/lib/testing/storyboard/account-policy.js +35 -0
  155. package/dist/lib/testing/storyboard/account-policy.mjs +11 -0
  156. package/dist/lib/testing/storyboard/context.js +6 -0
  157. package/dist/lib/testing/storyboard/context.mjs +6 -0
  158. package/dist/lib/testing/storyboard/request-builder.js +12 -2
  159. package/dist/lib/testing/storyboard/request-builder.mjs +12 -2
  160. package/dist/lib/testing/storyboard/runner.js +3 -2
  161. package/dist/lib/testing/storyboard/runner.mjs +3 -2
  162. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  163. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  164. package/dist/lib/version.d.mts +3 -3
  165. package/dist/lib/version.d.ts +3 -3
  166. package/dist/lib/version.js +3 -3
  167. package/dist/lib/version.mjs +3 -3
  168. package/dist/lib/wholesale-feed-sync/sync.d.mts +1 -0
  169. package/dist/lib/wholesale-feed-sync/sync.d.ts +1 -0
  170. package/dist/lib/wholesale-feed-sync/sync.js +92 -21
  171. package/dist/lib/wholesale-feed-sync/sync.mjs +92 -21
  172. package/dist/lib/wholesale-feed-sync/types.d.mts +4 -3
  173. package/dist/lib/wholesale-feed-sync/types.d.ts +4 -3
  174. package/docs/TYPE-SUMMARY.md +2 -2
  175. package/docs/guides/BUILD-AN-AGENT.md +2 -2
  176. package/docs/guides/BUYER-QUICKSTART-3.2.md +2 -0
  177. package/docs/guides/FIRST-CALL-TO-A-SELLER.md +104 -0
  178. package/docs/guides/SIGNING-GUIDE.md +16 -7
  179. package/docs/guides/account-resolution.md +86 -0
  180. package/docs/llms.txt +3 -2
  181. package/docs/migration-14.x-rc-worksheet.md +4 -4
  182. package/docs/migration-4.x-to-5.x.md +1 -0
  183. package/docs/migration-agent-resolution-3.3.md +123 -0
  184. package/docs/recipes/verifying-inbound-webhooks.md +56 -15
  185. package/package.json +2 -2
@@ -1756,11 +1756,11 @@ export interface paths {
1756
1756
  put?: never;
1757
1757
  /**
1758
1758
  * Refresh agent snapshot
1759
- * @description Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartbeat (~1h).
1759
+ * @description Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartbeat.
1760
1760
  *
1761
- * **Compliance re-run:** when the caller owns the agent or is an AAO admin and the capability probe succeeds, the full storyboard suite can run for several minutes on capability-rich agents with a fresh test session, and `agent_storyboard_status` is updated. Owner-triggered runs use `triggered_by: 'owner_test'`; admin-triggered support runs use `triggered_by: 'manual'`. Badge fan-out reissues verification badges off the new run. If the compliance call fails (timeout, OAuth wall, internal error), the capability/health portion still returns successfully — `compliance.ran` is `false` with an `error` string.
1761
+ * **Compliance re-run:** when the caller owns the agent or is an AgenticAdvertising.org admin and the capability probe succeeds, the full storyboard suite runs with a fresh test session. Owner-triggered runs use `triggered_by: 'owner_test'`; admin-triggered support runs use `triggered_by: 'manual'`. Only a complete authoritative run can update public grades or badges.
1762
1762
  *
1763
- * **Auth:** owner of the agent, AAO admin, or static `ADMIN_API_KEY`. Human submissions are temporarily fenced with HTTP 503 until durable authorization provenance is supported; static admin API key submissions remain available.
1763
+ * **Auth:** an authenticated owner or administrator credential is checked at admission and throughout execution. Static admin API keys cannot queue a refresh.
1764
1764
  *
1765
1765
  * **Rate limits:** 60 seconds per agent URL, 30 requests per user per hour.
1766
1766
  */
@@ -2641,7 +2641,7 @@ export interface components {
2641
2641
  verified?: boolean;
2642
2642
  /** @description Canonical badge roles the agent is AgenticAdvertising.org Verified for (e.g. media-buy, creative). */
2643
2643
  verified_roles?: components["schemas"]["BadgeRole"][];
2644
- /** @description Active AgenticAdvertising.org Verified AdCP releases for each verified role, keyed by canonical badge role and sorted newest-first (e.g. { media-buy: ['3.1', '3.0'] }). Use this when choosing a version-pinned badge URL. */
2644
+ /** @description Active AgenticAdvertising.org Verified AdCP releases for each verified role, keyed by canonical badge role and sorted newest-first (e.g. { media-buy: ['3.2', '3.1'] }). Use this when choosing a version-pinned badge URL. */
2645
2645
  verified_role_versions?: {
2646
2646
  [key: string]: string[];
2647
2647
  };
@@ -4164,21 +4164,48 @@ export interface components {
4164
4164
  compliance_opt_out?: boolean;
4165
4165
  /** @description True when monitoring is enabled but badges remain suppressed until a fresh passing full-suite run completes. */
4166
4166
  badge_requalification_required?: boolean;
4167
- /** @description Current human refresh admission state. Monitoring requeue is a separate scheduler operation and is not a retry or ETA for this endpoint. */
4167
+ /** @description Whether authenticated owners and administrators can queue an agent refresh. */
4168
4168
  refresh_availability?: {
4169
4169
  available: boolean;
4170
- /** @description Whether retrying the same human refresh request later is expected to succeed without a platform change. */
4171
- retryable: boolean;
4172
- /** @enum {string} */
4173
- scope: "platform";
4174
- /** @enum {string} */
4175
- applies_to: "human_session";
4176
- /** @enum {string} */
4177
- code: "refresh_authorization_provenance_required";
4178
- notice: string;
4179
- /** @enum {string} */
4180
- alternative_action: "monitoring_requeue";
4181
- alternative_description: string;
4170
+ /**
4171
+ * @deprecated
4172
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4173
+ */
4174
+ retryable?: boolean;
4175
+ /**
4176
+ * @deprecated
4177
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4178
+ * @enum {string}
4179
+ */
4180
+ scope?: "platform";
4181
+ /**
4182
+ * @deprecated
4183
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4184
+ * @enum {string}
4185
+ */
4186
+ applies_to?: "human_session";
4187
+ /**
4188
+ * @deprecated
4189
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4190
+ * @enum {string}
4191
+ */
4192
+ code?: "refresh_authorization_provenance_required";
4193
+ /**
4194
+ * @deprecated
4195
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4196
+ */
4197
+ notice?: string;
4198
+ /**
4199
+ * @deprecated
4200
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4201
+ * @enum {string}
4202
+ */
4203
+ alternative_action?: "monitoring_requeue";
4204
+ /**
4205
+ * @deprecated
4206
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4207
+ */
4208
+ alternative_description?: string;
4182
4209
  };
4183
4210
  tracks?: {
4184
4211
  [key: string]: string;
@@ -4200,6 +4227,21 @@ export interface components {
4200
4227
  status_changed_at?: string | null;
4201
4228
  storyboards_passing?: number;
4202
4229
  storyboards_total?: number;
4230
+ /** @description Owner/operator-only newest persisted full assessment, including audit-only timeouts. Null for other viewers. This does not change the public verdict. */
4231
+ latest_attempt?: {
4232
+ /** Format: uuid */
4233
+ id: string;
4234
+ tested_at: string;
4235
+ /** @enum {string} */
4236
+ triggered_by: "heartbeat" | "owner_test" | "manual" | "webhook";
4237
+ /** @enum {string} */
4238
+ completeness: "complete" | "timed_out" | "not_completed";
4239
+ is_authoritative: boolean;
4240
+ requested_compliance_target: string | null;
4241
+ storyboards_completed: number | null;
4242
+ storyboards_total: number | null;
4243
+ first_blocker: string | null;
4244
+ } | null;
4203
4245
  /** @description How often the heartbeat re-tests this agent, in hours */
4204
4246
  check_interval_hours?: number;
4205
4247
  /** @description Specialisms the agent declared in get_adcp_capabilities, from the latest run */
@@ -4329,7 +4371,7 @@ export interface components {
4329
4371
  };
4330
4372
  VerificationBadge: {
4331
4373
  role: components["schemas"]["BadgeRole"] & unknown;
4332
- /** @description AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.0', '3.1'). Load-bearing for badge identity — pairs with the (agent_url, role, adcp_version) PK. */
4374
+ /** @description AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.1', '3.2'). Load-bearing for badge identity — pairs with the (agent_url, role, adcp_version) PK. */
4333
4375
  adcp_version: string;
4334
4376
  verified_at: string;
4335
4377
  /** @description Specialisms demonstrably passed (enums/specialism.json). Preview specialisms are excluded from stable badges. */
@@ -9299,7 +9341,7 @@ export interface operations {
9299
9341
  encodedUrl: string;
9300
9342
  /** @description Canonical badge role */
9301
9343
  role: components["schemas"]["BadgeRole"] & unknown;
9302
- /** @description AdCP release as MAJOR.MINOR (e.g. '3.0', '3.1') */
9344
+ /** @description AdCP release as MAJOR.MINOR (e.g. '3.1', '3.2') */
9303
9345
  version: string;
9304
9346
  };
9305
9347
  cookie?: never;
@@ -10208,13 +10250,13 @@ export interface operations {
10208
10250
  run_id?: string;
10209
10251
  /** @description Fresh test session id used for the compliance run. Useful when matching seller-side logs to the refresh. */
10210
10252
  test_session_id?: string;
10211
- /** @description Requested compliance target before alias resolution, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta. Present when `ran` is true. */
10253
+ /** @description Requested compliance target before alias resolution, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta. Present when `ran` is true. */
10212
10254
  requested_compliance_target?: string;
10213
- /** @description Concrete AdCP compliance bundle version used for the run, e.g. 3.0.12 or 3.1.0-beta.7. Present when `ran` is true. */
10255
+ /** @description Concrete AdCP compliance bundle version used for the run, e.g. 3.2.1, 3.1.24, or 3.2.0-rc.7. Present when `ran` is true. */
10214
10256
  adcp_version?: string;
10215
10257
  /** @description True when this run can update public badge state. */
10216
10258
  badge_eligible?: boolean;
10217
- /** @description Public badge versions this run can issue, e.g. ['3.0']. */
10259
+ /** @description Public badge versions this run can issue, e.g. ['3.2']. */
10218
10260
  badge_eligible_adcp_versions?: string[];
10219
10261
  /** @description Aggregate verdict from the run (passing / failing / partial / unknown). Only present when `ran` is true. */
10220
10262
  overall_status?: string;
@@ -10327,34 +10369,59 @@ export interface operations {
10327
10369
  "application/json": components["schemas"]["Error"];
10328
10370
  };
10329
10371
  };
10330
- /** @description Refresh queue or authorization unavailable. Human submissions are fenced with refresh_authorization_provenance_required until durable authorization provenance is supported; this response is non-retryable and carries no ETA. Static admin API key submissions remain supported. */
10372
+ /** @description Refresh queue or authorization temporarily unavailable. */
10331
10373
  503: {
10332
10374
  headers: {
10333
10375
  [name: string]: unknown;
10334
10376
  };
10335
10377
  content: {
10336
- "application/json": {
10337
- /** @enum {string} */
10338
- error: "admin_authorization_unavailable";
10339
- message: string;
10340
- } | {
10341
- error: string;
10342
- /** @enum {string} */
10343
- code: "refresh_authorization_provenance_required";
10344
- /** @enum {boolean} */
10345
- retryable: false;
10346
- /** @enum {string} */
10347
- scope: "platform";
10348
- /** @enum {string} */
10349
- applies_to: "human_session";
10350
- /** @enum {string} */
10351
- alternative_action: "monitoring_requeue";
10352
- alternative_description: string;
10378
+ "application/json": components["schemas"]["Error"] & {
10379
+ /**
10380
+ * @deprecated
10381
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10382
+ */
10383
+ message?: string;
10384
+ /**
10385
+ * @deprecated
10386
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10387
+ * @enum {string}
10388
+ */
10389
+ code?: "refresh_authorization_provenance_required";
10390
+ /**
10391
+ * @deprecated
10392
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10393
+ * @enum {boolean}
10394
+ */
10395
+ retryable?: false;
10396
+ /**
10397
+ * @deprecated
10398
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10399
+ * @enum {string}
10400
+ */
10401
+ scope?: "platform";
10402
+ /**
10403
+ * @deprecated
10404
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10405
+ * @enum {string}
10406
+ */
10407
+ applies_to?: "human_session";
10408
+ /**
10409
+ * @deprecated
10410
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10411
+ * @enum {string}
10412
+ */
10413
+ alternative_action?: "monitoring_requeue";
10414
+ /**
10415
+ * @deprecated
10416
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10417
+ */
10418
+ alternative_description?: string;
10353
10419
  /**
10354
10420
  * Format: uri
10355
- * @description Issue tracking the restoration of human-initiated refresh
10421
+ * @deprecated
10422
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10356
10423
  */
10357
- tracking_issue: string;
10424
+ tracking_issue?: string;
10358
10425
  };
10359
10426
  };
10360
10427
  };
@@ -10922,7 +10989,7 @@ export interface operations {
10922
10989
  query?: {
10923
10990
  /** @description Filter by storyboard category */
10924
10991
  category?: string;
10925
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
10992
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
10926
10993
  compliance_target?: string;
10927
10994
  };
10928
10995
  header?: never;
@@ -10959,7 +11026,7 @@ export interface operations {
10959
11026
  getStoryboard: {
10960
11027
  parameters: {
10961
11028
  query?: {
10962
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
11029
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
10963
11030
  compliance_target?: string;
10964
11031
  };
10965
11032
  header?: never;
@@ -11342,7 +11409,7 @@ export interface operations {
11342
11409
  getStoryboardFirstStep: {
11343
11410
  parameters: {
11344
11411
  query?: {
11345
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
11412
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
11346
11413
  compliance_target?: string;
11347
11414
  };
11348
11415
  header?: never;
@@ -1756,11 +1756,11 @@ export interface paths {
1756
1756
  put?: never;
1757
1757
  /**
1758
1758
  * Refresh agent snapshot
1759
- * @description Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartbeat (~1h).
1759
+ * @description Re-probe the agent and update its registry health (online, tools_count, response_time_ms), capability snapshot (inferred type, discovered tools), and compliance verdict (storyboard pass/fail counts). Use after fixing your agent so the registry shows fresh data without waiting for the periodic heartbeat.
1760
1760
  *
1761
- * **Compliance re-run:** when the caller owns the agent or is an AAO admin and the capability probe succeeds, the full storyboard suite can run for several minutes on capability-rich agents with a fresh test session, and `agent_storyboard_status` is updated. Owner-triggered runs use `triggered_by: 'owner_test'`; admin-triggered support runs use `triggered_by: 'manual'`. Badge fan-out reissues verification badges off the new run. If the compliance call fails (timeout, OAuth wall, internal error), the capability/health portion still returns successfully — `compliance.ran` is `false` with an `error` string.
1761
+ * **Compliance re-run:** when the caller owns the agent or is an AgenticAdvertising.org admin and the capability probe succeeds, the full storyboard suite runs with a fresh test session. Owner-triggered runs use `triggered_by: 'owner_test'`; admin-triggered support runs use `triggered_by: 'manual'`. Only a complete authoritative run can update public grades or badges.
1762
1762
  *
1763
- * **Auth:** owner of the agent, AAO admin, or static `ADMIN_API_KEY`. Human submissions are temporarily fenced with HTTP 503 until durable authorization provenance is supported; static admin API key submissions remain available.
1763
+ * **Auth:** an authenticated owner or administrator credential is checked at admission and throughout execution. Static admin API keys cannot queue a refresh.
1764
1764
  *
1765
1765
  * **Rate limits:** 60 seconds per agent URL, 30 requests per user per hour.
1766
1766
  */
@@ -2641,7 +2641,7 @@ export interface components {
2641
2641
  verified?: boolean;
2642
2642
  /** @description Canonical badge roles the agent is AgenticAdvertising.org Verified for (e.g. media-buy, creative). */
2643
2643
  verified_roles?: components["schemas"]["BadgeRole"][];
2644
- /** @description Active AgenticAdvertising.org Verified AdCP releases for each verified role, keyed by canonical badge role and sorted newest-first (e.g. { media-buy: ['3.1', '3.0'] }). Use this when choosing a version-pinned badge URL. */
2644
+ /** @description Active AgenticAdvertising.org Verified AdCP releases for each verified role, keyed by canonical badge role and sorted newest-first (e.g. { media-buy: ['3.2', '3.1'] }). Use this when choosing a version-pinned badge URL. */
2645
2645
  verified_role_versions?: {
2646
2646
  [key: string]: string[];
2647
2647
  };
@@ -4164,21 +4164,48 @@ export interface components {
4164
4164
  compliance_opt_out?: boolean;
4165
4165
  /** @description True when monitoring is enabled but badges remain suppressed until a fresh passing full-suite run completes. */
4166
4166
  badge_requalification_required?: boolean;
4167
- /** @description Current human refresh admission state. Monitoring requeue is a separate scheduler operation and is not a retry or ETA for this endpoint. */
4167
+ /** @description Whether authenticated owners and administrators can queue an agent refresh. */
4168
4168
  refresh_availability?: {
4169
4169
  available: boolean;
4170
- /** @description Whether retrying the same human refresh request later is expected to succeed without a platform change. */
4171
- retryable: boolean;
4172
- /** @enum {string} */
4173
- scope: "platform";
4174
- /** @enum {string} */
4175
- applies_to: "human_session";
4176
- /** @enum {string} */
4177
- code: "refresh_authorization_provenance_required";
4178
- notice: string;
4179
- /** @enum {string} */
4180
- alternative_action: "monitoring_requeue";
4181
- alternative_description: string;
4170
+ /**
4171
+ * @deprecated
4172
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4173
+ */
4174
+ retryable?: boolean;
4175
+ /**
4176
+ * @deprecated
4177
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4178
+ * @enum {string}
4179
+ */
4180
+ scope?: "platform";
4181
+ /**
4182
+ * @deprecated
4183
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4184
+ * @enum {string}
4185
+ */
4186
+ applies_to?: "human_session";
4187
+ /**
4188
+ * @deprecated
4189
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4190
+ * @enum {string}
4191
+ */
4192
+ code?: "refresh_authorization_provenance_required";
4193
+ /**
4194
+ * @deprecated
4195
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4196
+ */
4197
+ notice?: string;
4198
+ /**
4199
+ * @deprecated
4200
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4201
+ * @enum {string}
4202
+ */
4203
+ alternative_action?: "monitoring_requeue";
4204
+ /**
4205
+ * @deprecated
4206
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
4207
+ */
4208
+ alternative_description?: string;
4182
4209
  };
4183
4210
  tracks?: {
4184
4211
  [key: string]: string;
@@ -4200,6 +4227,21 @@ export interface components {
4200
4227
  status_changed_at?: string | null;
4201
4228
  storyboards_passing?: number;
4202
4229
  storyboards_total?: number;
4230
+ /** @description Owner/operator-only newest persisted full assessment, including audit-only timeouts. Null for other viewers. This does not change the public verdict. */
4231
+ latest_attempt?: {
4232
+ /** Format: uuid */
4233
+ id: string;
4234
+ tested_at: string;
4235
+ /** @enum {string} */
4236
+ triggered_by: "heartbeat" | "owner_test" | "manual" | "webhook";
4237
+ /** @enum {string} */
4238
+ completeness: "complete" | "timed_out" | "not_completed";
4239
+ is_authoritative: boolean;
4240
+ requested_compliance_target: string | null;
4241
+ storyboards_completed: number | null;
4242
+ storyboards_total: number | null;
4243
+ first_blocker: string | null;
4244
+ } | null;
4203
4245
  /** @description How often the heartbeat re-tests this agent, in hours */
4204
4246
  check_interval_hours?: number;
4205
4247
  /** @description Specialisms the agent declared in get_adcp_capabilities, from the latest run */
@@ -4329,7 +4371,7 @@ export interface components {
4329
4371
  };
4330
4372
  VerificationBadge: {
4331
4373
  role: components["schemas"]["BadgeRole"] & unknown;
4332
- /** @description AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.0', '3.1'). Load-bearing for badge identity — pairs with the (agent_url, role, adcp_version) PK. */
4374
+ /** @description AdCP release this badge was issued against, MAJOR.MINOR (e.g. '3.1', '3.2'). Load-bearing for badge identity — pairs with the (agent_url, role, adcp_version) PK. */
4333
4375
  adcp_version: string;
4334
4376
  verified_at: string;
4335
4377
  /** @description Specialisms demonstrably passed (enums/specialism.json). Preview specialisms are excluded from stable badges. */
@@ -9299,7 +9341,7 @@ export interface operations {
9299
9341
  encodedUrl: string;
9300
9342
  /** @description Canonical badge role */
9301
9343
  role: components["schemas"]["BadgeRole"] & unknown;
9302
- /** @description AdCP release as MAJOR.MINOR (e.g. '3.0', '3.1') */
9344
+ /** @description AdCP release as MAJOR.MINOR (e.g. '3.1', '3.2') */
9303
9345
  version: string;
9304
9346
  };
9305
9347
  cookie?: never;
@@ -10208,13 +10250,13 @@ export interface operations {
10208
10250
  run_id?: string;
10209
10251
  /** @description Fresh test session id used for the compliance run. Useful when matching seller-side logs to the refresh. */
10210
10252
  test_session_id?: string;
10211
- /** @description Requested compliance target before alias resolution, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta. Present when `ran` is true. */
10253
+ /** @description Requested compliance target before alias resolution, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta. Present when `ran` is true. */
10212
10254
  requested_compliance_target?: string;
10213
- /** @description Concrete AdCP compliance bundle version used for the run, e.g. 3.0.12 or 3.1.0-beta.7. Present when `ran` is true. */
10255
+ /** @description Concrete AdCP compliance bundle version used for the run, e.g. 3.2.1, 3.1.24, or 3.2.0-rc.7. Present when `ran` is true. */
10214
10256
  adcp_version?: string;
10215
10257
  /** @description True when this run can update public badge state. */
10216
10258
  badge_eligible?: boolean;
10217
- /** @description Public badge versions this run can issue, e.g. ['3.0']. */
10259
+ /** @description Public badge versions this run can issue, e.g. ['3.2']. */
10218
10260
  badge_eligible_adcp_versions?: string[];
10219
10261
  /** @description Aggregate verdict from the run (passing / failing / partial / unknown). Only present when `ran` is true. */
10220
10262
  overall_status?: string;
@@ -10327,34 +10369,59 @@ export interface operations {
10327
10369
  "application/json": components["schemas"]["Error"];
10328
10370
  };
10329
10371
  };
10330
- /** @description Refresh queue or authorization unavailable. Human submissions are fenced with refresh_authorization_provenance_required until durable authorization provenance is supported; this response is non-retryable and carries no ETA. Static admin API key submissions remain supported. */
10372
+ /** @description Refresh queue or authorization temporarily unavailable. */
10331
10373
  503: {
10332
10374
  headers: {
10333
10375
  [name: string]: unknown;
10334
10376
  };
10335
10377
  content: {
10336
- "application/json": {
10337
- /** @enum {string} */
10338
- error: "admin_authorization_unavailable";
10339
- message: string;
10340
- } | {
10341
- error: string;
10342
- /** @enum {string} */
10343
- code: "refresh_authorization_provenance_required";
10344
- /** @enum {boolean} */
10345
- retryable: false;
10346
- /** @enum {string} */
10347
- scope: "platform";
10348
- /** @enum {string} */
10349
- applies_to: "human_session";
10350
- /** @enum {string} */
10351
- alternative_action: "monitoring_requeue";
10352
- alternative_description: string;
10378
+ "application/json": components["schemas"]["Error"] & {
10379
+ /**
10380
+ * @deprecated
10381
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10382
+ */
10383
+ message?: string;
10384
+ /**
10385
+ * @deprecated
10386
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10387
+ * @enum {string}
10388
+ */
10389
+ code?: "refresh_authorization_provenance_required";
10390
+ /**
10391
+ * @deprecated
10392
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10393
+ * @enum {boolean}
10394
+ */
10395
+ retryable?: false;
10396
+ /**
10397
+ * @deprecated
10398
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10399
+ * @enum {string}
10400
+ */
10401
+ scope?: "platform";
10402
+ /**
10403
+ * @deprecated
10404
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10405
+ * @enum {string}
10406
+ */
10407
+ applies_to?: "human_session";
10408
+ /**
10409
+ * @deprecated
10410
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10411
+ * @enum {string}
10412
+ */
10413
+ alternative_action?: "monitoring_requeue";
10414
+ /**
10415
+ * @deprecated
10416
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10417
+ */
10418
+ alternative_description?: string;
10353
10419
  /**
10354
10420
  * Format: uri
10355
- * @description Issue tracking the restoration of human-initiated refresh
10421
+ * @deprecated
10422
+ * @description Deprecated: removed from the AgenticAdvertising.org registry OpenAPI and no longer sent. Retained as an optional property for SDK 14.x type compatibility; it will be removed in the next major release.
10356
10423
  */
10357
- tracking_issue: string;
10424
+ tracking_issue?: string;
10358
10425
  };
10359
10426
  };
10360
10427
  };
@@ -10922,7 +10989,7 @@ export interface operations {
10922
10989
  query?: {
10923
10990
  /** @description Filter by storyboard category */
10924
10991
  category?: string;
10925
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
10992
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
10926
10993
  compliance_target?: string;
10927
10994
  };
10928
10995
  header?: never;
@@ -10959,7 +11026,7 @@ export interface operations {
10959
11026
  getStoryboard: {
10960
11027
  parameters: {
10961
11028
  query?: {
10962
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
11029
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
10963
11030
  compliance_target?: string;
10964
11031
  };
10965
11032
  header?: never;
@@ -11342,7 +11409,7 @@ export interface operations {
11342
11409
  getStoryboardFirstStep: {
11343
11410
  parameters: {
11344
11411
  query?: {
11345
- /** @description Compliance target to inspect, e.g. 3.1, 3.0, 3.1-rc, or 3.1-beta */
11412
+ /** @description Compliance target to inspect, e.g. 3.2, 3.1, 3.0, 3.2-rc, or 3.2-beta */
11346
11413
  compliance_target?: string;
11347
11414
  };
11348
11415
  header?: never;
@@ -4,5 +4,5 @@
4
4
  "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
5
5
  "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
6
6
  "upstream_adcp_version": "2.5.3",
7
- "synced_at": "2026-10-01T12:26:53.290Z"
7
+ "synced_at": "2026-10-04T04:04:58.987Z"
8
8
  }
@@ -0,0 +1,2 @@
1
+ /** Only spend commitments and account-owned resource creation may provision. */
2
+ export declare function isAccountProvisioningTask(toolName: string | undefined): boolean;
@@ -0,0 +1,2 @@
1
+ /** Only spend commitments and account-owned resource creation may provision. */
2
+ export declare function isAccountProvisioningTask(toolName: string | undefined): boolean;
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+ var account_provisioning_exports = {};
20
+ __export(account_provisioning_exports, {
21
+ isAccountProvisioningTask: () => isAccountProvisioningTask
22
+ });
23
+ module.exports = __toCommonJS(account_provisioning_exports);
24
+ function isAccountProvisioningTask(toolName) {
25
+ return toolName !== void 0 && (toolName.startsWith("sync_") || ["create_media_buy", "buy_products", "accept_proposal", "activate_signal", "acquire_rights"].includes(toolName));
26
+ }
27
+ // Annotate the CommonJS export names for ESM import in node:
28
+ 0 && (module.exports = {
29
+ isAccountProvisioningTask
30
+ });
@@ -0,0 +1,6 @@
1
+ function isAccountProvisioningTask(toolName) {
2
+ return toolName !== void 0 && (toolName.startsWith("sync_") || ["create_media_buy", "buy_products", "accept_proposal", "activate_signal", "acquire_rights"].includes(toolName));
3
+ }
4
+ export {
5
+ isAccountProvisioningTask
6
+ };
@@ -0,0 +1,12 @@
1
+ import type { AdcpLogger } from './create-adcp-server.mjs';
2
+ /**
3
+ * Compatibility-window warnings for account-reference behavior that becomes
4
+ * strict by default in the next major release (`strictAccountReferences`).
5
+ */
6
+ export type AccountReferenceWarningCode = 'ADCP_UNRESOLVED_ACCOUNT_REFERENCE' | 'ADCP_IMPLICIT_ACCOUNT_IDENTITY_MISMATCH' | 'ADCP_REQUIRED_FOR_PRODUCTS_NOT_ENFORCED' | 'ADCP_LIST_ACCOUNTS_FILTER_RESOLVED';
7
+ /**
8
+ * Warn once per process per code (`logger.warn`, plus `process.emitWarning`
9
+ * outside production). Later occurrences go to `logger.debug`. Messages and
10
+ * metadata are server-side only; never echo them to the buyer.
11
+ */
12
+ export declare function warnAccountReferenceDeprecation(logger: AdcpLogger, code: AccountReferenceWarningCode, message: string, meta?: Record<string, unknown>): void;
@@ -0,0 +1,12 @@
1
+ import type { AdcpLogger } from './create-adcp-server';
2
+ /**
3
+ * Compatibility-window warnings for account-reference behavior that becomes
4
+ * strict by default in the next major release (`strictAccountReferences`).
5
+ */
6
+ export type AccountReferenceWarningCode = 'ADCP_UNRESOLVED_ACCOUNT_REFERENCE' | 'ADCP_IMPLICIT_ACCOUNT_IDENTITY_MISMATCH' | 'ADCP_REQUIRED_FOR_PRODUCTS_NOT_ENFORCED' | 'ADCP_LIST_ACCOUNTS_FILTER_RESOLVED';
7
+ /**
8
+ * Warn once per process per code (`logger.warn`, plus `process.emitWarning`
9
+ * outside production). Later occurrences go to `logger.debug`. Messages and
10
+ * metadata are server-side only; never echo them to the buyer.
11
+ */
12
+ export declare function warnAccountReferenceDeprecation(logger: AdcpLogger, code: AccountReferenceWarningCode, message: string, meta?: Record<string, unknown>): void;