@adcp/sdk 16.7.1 → 16.7.2

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.
@@ -111,6 +111,7 @@ function validateRefineProposalsRequest(request, capabilities) {
111
111
  fail("governance_context must be a non-empty string of at most 4096 characters", "governance_context");
112
112
  }
113
113
  if (request.context !== void 0 && !isRecord(request.context)) fail("context must be an object", "context");
114
+ if (request.ext !== void 0 && !isRecord(request.ext)) fail("ext must be an object", "ext");
114
115
  if (request.push_notification_config !== void 0 && !isRecord(request.push_notification_config)) {
115
116
  fail("push_notification_config must be an object", "push_notification_config");
116
117
  }
@@ -148,6 +149,7 @@ function validateRefineProposalsRequest(request, capabilities) {
148
149
  } else {
149
150
  assertAllowedKeys(refinement, REVISE_KEYS, base);
150
151
  }
152
+ if (refinement.ext !== void 0 && !isRecord(refinement.ext)) fail("ext must be an object", `${base}.ext`);
151
153
  if (hasFinalize && refinement.action !== "finalize") {
152
154
  throw new ProposalRefinementValidationError(
153
155
  "a batch containing finalize may contain only finalize entries",
@@ -367,7 +369,10 @@ function buildRefineProposalsRequest(input, capabilities, defaultAdcpVersion = i
367
369
  validateRefineProposalsRequest(request, capabilities);
368
370
  return deepFreeze(request);
369
371
  }
370
- const REQUEST_KEYS = /* @__PURE__ */ new Set([
372
+ function withExtensionPoint(keys) {
373
+ return /* @__PURE__ */ new Set([...keys, "ext"]);
374
+ }
375
+ const REQUEST_KEYS = withExtensionPoint([
371
376
  "adcp_version",
372
377
  "adcp_major_version",
373
378
  "context_id",
@@ -377,8 +382,8 @@ const REQUEST_KEYS = /* @__PURE__ */ new Set([
377
382
  "idempotency_key",
378
383
  "refinements"
379
384
  ]);
380
- const FINALIZE_KEYS = /* @__PURE__ */ new Set(["proposal_id", "action"]);
381
- const REVISE_KEYS = /* @__PURE__ */ new Set([
385
+ const FINALIZE_KEYS = withExtensionPoint(["proposal_id", "action"]);
386
+ const REVISE_KEYS = withExtensionPoint([
382
387
  "proposal_id",
383
388
  "action",
384
389
  "change_kind",
@@ -80,6 +80,7 @@ function validateRefineProposalsRequest(request, capabilities) {
80
80
  fail("governance_context must be a non-empty string of at most 4096 characters", "governance_context");
81
81
  }
82
82
  if (request.context !== void 0 && !isRecord(request.context)) fail("context must be an object", "context");
83
+ if (request.ext !== void 0 && !isRecord(request.ext)) fail("ext must be an object", "ext");
83
84
  if (request.push_notification_config !== void 0 && !isRecord(request.push_notification_config)) {
84
85
  fail("push_notification_config must be an object", "push_notification_config");
85
86
  }
@@ -117,6 +118,7 @@ function validateRefineProposalsRequest(request, capabilities) {
117
118
  } else {
118
119
  assertAllowedKeys(refinement, REVISE_KEYS, base);
119
120
  }
121
+ if (refinement.ext !== void 0 && !isRecord(refinement.ext)) fail("ext must be an object", `${base}.ext`);
120
122
  if (hasFinalize && refinement.action !== "finalize") {
121
123
  throw new ProposalRefinementValidationError(
122
124
  "a batch containing finalize may contain only finalize entries",
@@ -336,7 +338,10 @@ function buildRefineProposalsRequest(input, capabilities, defaultAdcpVersion = A
336
338
  validateRefineProposalsRequest(request, capabilities);
337
339
  return deepFreeze(request);
338
340
  }
339
- const REQUEST_KEYS = /* @__PURE__ */ new Set([
341
+ function withExtensionPoint(keys) {
342
+ return /* @__PURE__ */ new Set([...keys, "ext"]);
343
+ }
344
+ const REQUEST_KEYS = withExtensionPoint([
340
345
  "adcp_version",
341
346
  "adcp_major_version",
342
347
  "context_id",
@@ -346,8 +351,8 @@ const REQUEST_KEYS = /* @__PURE__ */ new Set([
346
351
  "idempotency_key",
347
352
  "refinements"
348
353
  ]);
349
- const FINALIZE_KEYS = /* @__PURE__ */ new Set(["proposal_id", "action"]);
350
- const REVISE_KEYS = /* @__PURE__ */ new Set([
354
+ const FINALIZE_KEYS = withExtensionPoint(["proposal_id", "action"]);
355
+ const REVISE_KEYS = withExtensionPoint([
351
356
  "proposal_id",
352
357
  "action",
353
358
  "change_kind",
@@ -78,10 +78,14 @@ export interface ReviseProposalRefinement {
78
78
  ask?: string;
79
79
  criteria?: ProposalDiscoveryCriteria;
80
80
  remove_media_buy_frequency_cap?: true;
81
+ /** Vendor extension point; opaque to the protocol. */
82
+ ext?: Record<string, unknown>;
81
83
  }
82
84
  export interface FinalizeProposalRefinement {
83
85
  proposal_id: string;
84
86
  action: 'finalize';
87
+ /** Vendor extension point; opaque to the protocol. */
88
+ ext?: Record<string, unknown>;
85
89
  }
86
90
  export type ProposalRefinement = ReviseProposalRefinement | FinalizeProposalRefinement;
87
91
  export type Adcp32Version = '3.2' | `3.2-${string}`;
@@ -94,6 +98,8 @@ export interface RefineProposalsRequest {
94
98
  context?: Record<string, unknown>;
95
99
  governance_context?: string;
96
100
  push_notification_config?: Record<string, unknown>;
101
+ /** Vendor extension point; opaque to the protocol. */
102
+ ext?: Record<string, unknown>;
97
103
  adcp_version: ProposalRefinementVersion;
98
104
  adcp_major_version: 3;
99
105
  }
@@ -152,6 +158,7 @@ export interface RefinedProposalResult<TProposal extends CanonicalProposal = Can
152
158
  source_proposal_id: string;
153
159
  outcome: 'revised';
154
160
  proposals: TProposal[];
161
+ ext?: Record<string, unknown>;
155
162
  }
156
163
  export interface PartialProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
157
164
  source_proposal_id: string;
@@ -163,6 +170,7 @@ export interface PartialProposalResult<TProposal extends CanonicalProposal = Can
163
170
  unsatisfied_product_changes?: ProposalProductChanges;
164
171
  suggestions?: string[];
165
172
  targeting_resolution?: Record<string, unknown>;
173
+ ext?: Record<string, unknown>;
166
174
  }
167
175
  export interface UnableProposalResult {
168
176
  source_proposal_id: string;
@@ -172,11 +180,13 @@ export interface UnableProposalResult {
172
180
  unsatisfied_constraints?: string[];
173
181
  unsatisfied_product_changes?: ProposalProductChanges;
174
182
  suggestions?: string[];
183
+ ext?: Record<string, unknown>;
175
184
  }
176
185
  export interface FinalizedProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
177
186
  source_proposal_id: string;
178
187
  outcome: 'finalized';
179
188
  proposal: TProposal;
189
+ ext?: Record<string, unknown>;
180
190
  }
181
191
  export type ProposalRefinementResult<TProposal extends CanonicalProposal = CanonicalProposal> = RefinedProposalResult<TProposal> | PartialProposalResult<TProposal> | UnableProposalResult | FinalizedProposalResult<TProposal>;
182
192
  export interface ProposalAdvisoryError {
@@ -78,10 +78,14 @@ export interface ReviseProposalRefinement {
78
78
  ask?: string;
79
79
  criteria?: ProposalDiscoveryCriteria;
80
80
  remove_media_buy_frequency_cap?: true;
81
+ /** Vendor extension point; opaque to the protocol. */
82
+ ext?: Record<string, unknown>;
81
83
  }
82
84
  export interface FinalizeProposalRefinement {
83
85
  proposal_id: string;
84
86
  action: 'finalize';
87
+ /** Vendor extension point; opaque to the protocol. */
88
+ ext?: Record<string, unknown>;
85
89
  }
86
90
  export type ProposalRefinement = ReviseProposalRefinement | FinalizeProposalRefinement;
87
91
  export type Adcp32Version = '3.2' | `3.2-${string}`;
@@ -94,6 +98,8 @@ export interface RefineProposalsRequest {
94
98
  context?: Record<string, unknown>;
95
99
  governance_context?: string;
96
100
  push_notification_config?: Record<string, unknown>;
101
+ /** Vendor extension point; opaque to the protocol. */
102
+ ext?: Record<string, unknown>;
97
103
  adcp_version: ProposalRefinementVersion;
98
104
  adcp_major_version: 3;
99
105
  }
@@ -152,6 +158,7 @@ export interface RefinedProposalResult<TProposal extends CanonicalProposal = Can
152
158
  source_proposal_id: string;
153
159
  outcome: 'revised';
154
160
  proposals: TProposal[];
161
+ ext?: Record<string, unknown>;
155
162
  }
156
163
  export interface PartialProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
157
164
  source_proposal_id: string;
@@ -163,6 +170,7 @@ export interface PartialProposalResult<TProposal extends CanonicalProposal = Can
163
170
  unsatisfied_product_changes?: ProposalProductChanges;
164
171
  suggestions?: string[];
165
172
  targeting_resolution?: Record<string, unknown>;
173
+ ext?: Record<string, unknown>;
166
174
  }
167
175
  export interface UnableProposalResult {
168
176
  source_proposal_id: string;
@@ -172,11 +180,13 @@ export interface UnableProposalResult {
172
180
  unsatisfied_constraints?: string[];
173
181
  unsatisfied_product_changes?: ProposalProductChanges;
174
182
  suggestions?: string[];
183
+ ext?: Record<string, unknown>;
175
184
  }
176
185
  export interface FinalizedProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
177
186
  source_proposal_id: string;
178
187
  outcome: 'finalized';
179
188
  proposal: TProposal;
189
+ ext?: Record<string, unknown>;
180
190
  }
181
191
  export type ProposalRefinementResult<TProposal extends CanonicalProposal = CanonicalProposal> = RefinedProposalResult<TProposal> | PartialProposalResult<TProposal> | UnableProposalResult | FinalizedProposalResult<TProposal>;
182
192
  export interface ProposalAdvisoryError {
@@ -522,6 +522,7 @@ function validateAdvisoryErrors(value, issues) {
522
522
  function validateResultShape(value, path, issues, adcpVersion) {
523
523
  if (!isRecord(value)) return shape(issues, path, "result must be an object");
524
524
  let valid = allowedKeys(value, RESULT_KEYS, path, issues);
525
+ if (value.ext !== void 0 && !isRecord(value.ext)) valid = shape(issues, `${path}.ext`, "ext must be an object");
525
526
  if (!nonempty(value.source_proposal_id))
526
527
  valid = shape(issues, `${path}.source_proposal_id`, "source_proposal_id is required");
527
528
  if (!OUTCOMES.has(value.outcome)) {
@@ -1091,7 +1092,9 @@ const RESULT_KEYS = /* @__PURE__ */ new Set([
1091
1092
  "unsatisfied_constraints",
1092
1093
  "unsatisfied_product_changes",
1093
1094
  "suggestions",
1094
- "targeting_resolution"
1095
+ "targeting_resolution",
1096
+ // Result items are open in the schema; accept the vendor extension point.
1097
+ "ext"
1095
1098
  ]);
1096
1099
  const PRICING_KEYS = /* @__PURE__ */ new Set([
1097
1100
  "pricing_option_id",
@@ -488,6 +488,7 @@ function validateAdvisoryErrors(value, issues) {
488
488
  function validateResultShape(value, path, issues, adcpVersion) {
489
489
  if (!isRecord(value)) return shape(issues, path, "result must be an object");
490
490
  let valid = allowedKeys(value, RESULT_KEYS, path, issues);
491
+ if (value.ext !== void 0 && !isRecord(value.ext)) valid = shape(issues, `${path}.ext`, "ext must be an object");
491
492
  if (!nonempty(value.source_proposal_id))
492
493
  valid = shape(issues, `${path}.source_proposal_id`, "source_proposal_id is required");
493
494
  if (!OUTCOMES.has(value.outcome)) {
@@ -1057,7 +1058,9 @@ const RESULT_KEYS = /* @__PURE__ */ new Set([
1057
1058
  "unsatisfied_constraints",
1058
1059
  "unsatisfied_product_changes",
1059
1060
  "suggestions",
1060
- "targeting_resolution"
1061
+ "targeting_resolution",
1062
+ // Result items are open in the schema; accept the vendor extension point.
1063
+ "ext"
1061
1064
  ]);
1062
1065
  const PRICING_KEYS = /* @__PURE__ */ new Set([
1063
1066
  "pricing_option_id",
@@ -544,7 +544,7 @@ export interface paths {
544
544
  };
545
545
  /**
546
546
  * Agent domain lookup
547
- * @description Get all publisher domains associated with an agent.
547
+ * @description Get all publisher domains whose adagents.json authorizes an agent. `agentUrl` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule: an origin-only `authorized_agents[].url` (`https://agent.example.com`) authorizes every agent URL at that origin, and an entry with a path matches that canonical URL only, with a non-root trailing slash significant.
548
548
  */
549
549
  get: operations["getAgentDomains"];
550
550
  put?: never;
@@ -568,7 +568,7 @@ export interface paths {
568
568
  *
569
569
  * Spec: [docs/aao/directory-api.mdx](/docs/aao/directory-api) (adcp#4823). This endpoint is the spec-compliant richer-shape replacement for the legacy `/api/registry/lookup/agent/{agentUrl}/domains`, which returns domain strings only.
570
570
  *
571
- * `agent_url` is matched with [AdCP URL canonicalization](/docs/reference/url-canonicalization) and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets, the same rule the SDK applies in `verify_agent_authorization`. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
571
+ * `agent_url` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule, after [AdCP URL canonicalization](/docs/reference/url-canonicalization) of both sides. A publisher whose `authorized_agents[].url` is **origin-only** (`https://a.example` or `https://a.example/`) authorizes every agent URL with that canonical origin (same scheme, host and port), so it is returned for `https://a.example/mcp` and `https://a.example/a2a` alike (DR-0023, AdCP 3.3). An entry **with a path** matches that canonical URL only, and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two trailing-slash spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
572
572
  */
573
573
  get: operations["getPublishersForAgentLegacyApiPrefix"];
574
574
  put?: never;
@@ -592,7 +592,7 @@ export interface paths {
592
592
  *
593
593
  * Spec: [docs/aao/directory-api.mdx](/docs/aao/directory-api) (adcp#4823). This endpoint is the spec-compliant richer-shape replacement for the legacy `/api/registry/lookup/agent/{agentUrl}/domains`, which returns domain strings only.
594
594
  *
595
- * `agent_url` is matched with [AdCP URL canonicalization](/docs/reference/url-canonicalization) and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets, the same rule the SDK applies in `verify_agent_authorization`. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
595
+ * `agent_url` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule, after [AdCP URL canonicalization](/docs/reference/url-canonicalization) of both sides. A publisher whose `authorized_agents[].url` is **origin-only** (`https://a.example` or `https://a.example/`) authorizes every agent URL with that canonical origin (same scheme, host and port), so it is returned for `https://a.example/mcp` and `https://a.example/a2a` alike (DR-0023, AdCP 3.3). An entry **with a path** matches that canonical URL only, and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two trailing-slash spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
596
596
  */
597
597
  get: operations["getPublishersForAgent"];
598
598
  put?: never;
@@ -2582,7 +2582,7 @@ export interface components {
2582
2582
  stats?: components["schemas"]["AgentStats"];
2583
2583
  capabilities?: components["schemas"]["AgentCapabilities"];
2584
2584
  compliance?: components["schemas"]["AgentCompliance"];
2585
- /** @description Every raw agent_url spelling the directory has indexed under this agent's identity, with the listed (canonical) url first. The registry keys an agent by identity, folding a non-root trailing slash, but GET /v1/agents/{agent_url}/publishers matches spec-exactly with the slash significant — so a client answering "which publishers authorize this agent" must query once per spelling here and merge the results. */
2585
+ /** @description Every raw agent_url spelling the directory has indexed under this agent's identity, with the listed (canonical) url first. The registry keys an agent by identity, folding a non-root trailing slash, but GET /v1/agents/{agent_url}/publishers matches with adagents.json agent URL matching, where the slash is significant for an entry with a path — so a client answering "which publishers authorize this agent" must query once per spelling here and merge the results. Publishers that authorize the agent's bare origin are returned for every spelling. */
2586
2586
  declared_urls?: string[];
2587
2587
  publisher_domains?: string[];
2588
2588
  property_summary?: components["schemas"]["PropertySummary"];
@@ -4369,6 +4369,7 @@ export interface components {
4369
4369
  first_failure_validations: unknown[];
4370
4370
  /** @description Up to 5 cascaded prerequisite skips with runner reason/detail and the nearest earlier non-passing step. Populated only for owners and empty for other callers. */
4371
4371
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
4372
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
4372
4373
  last_tested_at: string | null;
4373
4374
  last_passed_at: string | null;
4374
4375
  }[];
@@ -4449,6 +4450,34 @@ export interface components {
4449
4450
  /** @description 'failed', or the skip reason of the earlier step. */
4450
4451
  blocked_by_reason: string | null;
4451
4452
  };
4453
+ /** @description Why the storyboard failed when no counted step did (adcp#8576). Populated only for owners and operators; null for other callers and for passing or step-level verdicts. */
4454
+ StoryboardVerdictExplanation: {
4455
+ /** @description Runner verdict_reason: step_failed, assertion_failed, controller_prerequisite_unmet, required_phase_not_executed, no_executed_steps, fixture_error, coverage_unverified, runner_error, or unexplained. runner_error is not an agent failure. */
4456
+ reason: string;
4457
+ /** @description One-line redacted runner explanation. May echo agent-supplied values. */
4458
+ detail: string | null;
4459
+ /** @description Up to 10 steps, assertions, phases or requirements behind the verdict. */
4460
+ contributing: components["schemas"]["StoryboardVerdictContributor"][];
4461
+ } | null;
4462
+ StoryboardVerdictContributor: {
4463
+ /** @description step, assertion, phase or requirement. */
4464
+ kind: string | null;
4465
+ /** @description Step id, assertion id, phase id, or requirement name. */
4466
+ id: string | null;
4467
+ /** @description The verdict reason this row supports. */
4468
+ reason: string | null;
4469
+ /** @description failed, skipped, or not_passed. */
4470
+ status: string | null;
4471
+ phase_id: string | null;
4472
+ /** @description 1-based pass index in multi-pass runs. */
4473
+ pass_index: number | null;
4474
+ /** @description Runner skip reason, when the step was skipped. */
4475
+ skip_reason: string | null;
4476
+ /** @description Unmet requirement named by the skip, e.g. controller. */
4477
+ requirement: string | null;
4478
+ /** @description Redacted runner text. May echo agent-supplied values. */
4479
+ message: string | null;
4480
+ };
4452
4481
  PublicComplianceNotice: {
4453
4482
  severity: string;
4454
4483
  code: string;
@@ -4678,7 +4707,9 @@ export interface components {
4678
4707
  relevant_bundle_ids: string[];
4679
4708
  failing_bundle_count: number;
4680
4709
  incomplete_bundle_count: number;
4681
- /** @description Universal bundles left partial only because the agent advertises none of the tools for a surface it does not declare. They do not count as incomplete. */
4710
+ /** @description Relevant bundles, as kind:id, that keep Strict Spec partial because their evidence is incomplete: an untested or partially covered storyboard, including runner and test-kit gaps. */
4711
+ incomplete_bundle_ids?: string[];
4712
+ /** @description Universal bundles left partial only because the agent does not offer the surface: it advertises none of the tools for a surface it does not declare, or it does not advertise request signing for signed_requests. They do not count as incomplete. */
4682
4713
  not_applicable_universal_bundle_ids?: string[];
4683
4714
  relevant_failure_count: number;
4684
4715
  missing_universal_bundle: boolean;
@@ -4720,6 +4751,7 @@ export interface components {
4720
4751
  first_failure_message: string | null;
4721
4752
  /** @description Up to 5 cascaded prerequisite skips with runner reason/detail and the nearest earlier non-passing step, when captured. Owner-scoped; empty for other callers. */
4722
4753
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
4754
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
4723
4755
  last_tested_at: string | null;
4724
4756
  last_passed_at: string | null;
4725
4757
  };
@@ -6574,6 +6606,7 @@ export interface operations {
6574
6606
  properties_total: number;
6575
6607
  /** @description Canonical list of property_id strings the agent is authorized for under this publisher. Present iff the request included `?include=properties`. Same population as `properties_authorized` but surfaced as IDs for set-diff comparison. */
6576
6608
  property_ids?: string[];
6609
+ /** @description Scope-agnostic summary: true only when every in-window authorized_agents entry that matches the agent carries signing_keys. Verifiers compute the pin per message scope, so a pin can apply where this reads false. */
6577
6610
  signing_keys_pinned: boolean;
6578
6611
  /** @enum {string} */
6579
6612
  status: "authorized" | "revoked";
@@ -6656,6 +6689,7 @@ export interface operations {
6656
6689
  properties_total: number;
6657
6690
  /** @description Canonical list of property_id strings the agent is authorized for under this publisher. Present iff the request included `?include=properties`. Same population as `properties_authorized` but surfaced as IDs for set-diff comparison. */
6658
6691
  property_ids?: string[];
6692
+ /** @description Scope-agnostic summary: true only when every in-window authorized_agents entry that matches the agent carries signing_keys. Verifiers compute the pin per message scope, so a pin can apply where this reads false. */
6659
6693
  signing_keys_pinned: boolean;
6660
6694
  /** @enum {string} */
6661
6695
  status: "authorized" | "revoked";
@@ -8779,7 +8813,7 @@ export interface operations {
8779
8813
  getAgentAuthorizations: {
8780
8814
  parameters: {
8781
8815
  query: {
8782
- /** @description Agent URL to look up. Canonicalized server-side per AdCP URL canonicalization: the scheme and host fold, the path does not. */
8816
+ /** @description Agent URL to look up. Canonicalized server-side per AdCP URL canonicalization: the scheme and host fold, the path does not. Returns the rows whose `agent_url` authorizes it under adagents.json agent URL matching: rows for the same canonical URL, plus rows whose `agent_url` is origin-only (`https://agent.example.com`) for the same canonical origin, which authorize every path at that origin. */
8783
8817
  agent_url: string;
8784
8818
  /** @description `effective` (default) applies override layer; `raw` reads base table. */
8785
8819
  include?: "raw" | "effective";
@@ -8824,7 +8858,7 @@ export interface operations {
8824
8858
  created_at: string;
8825
8859
  /** Format: date-time */
8826
8860
  updated_at: string;
8827
- /** @description Publisher-pinned JWK set (authorized_agents[*].signing_keys) from the source adagents.json. Consumers verifying inbound TMP signatures key on kid → JWK. Null when the publisher declared no keys; consumers fall back to the agent-hosted JWKS per spec R-2 (docs/governance/property/adagents.mdx). */
8861
+ /** @description Publisher-pinned JWK set (authorized_agents[*].signing_keys) from the source adagents.json. Consumers verifying inbound TMP signatures key on kid → JWK. Null when the publisher declared no keys; consumers fall back to the agent-hosted JWKS per spec R-2 (docs/governance/property/adagents.mdx). This is one entry's pin. Rows from the same publisher combine per message scope: among the rows that authorize that scope, the publisher pins the agent only if every one carries keys, and the pin is the union of their keys (docs/governance/property/adagents.mdx#agent-url-matching). */
8828
8862
  signing_keys: components["schemas"]["SigningKey"][] | null;
8829
8863
  /** @description Collection constraints (authorized_agents[*].collections) from the source adagents.json. Null when the entry is unconstrained. When set, the row does NOT authorize the property unqualified — consumers MUST scope it to these selectors. A selector without collection_ids is a bulk grant for all collections declared at that publisher_domain. */
8830
8864
  collections: ({
@@ -11891,6 +11925,7 @@ export interface operations {
11891
11925
  first_failure_message: string | null;
11892
11926
  first_failure_validations: unknown[];
11893
11927
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
11928
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
11894
11929
  };
11895
11930
  phases?: unknown;
11896
11931
  summary?: unknown;
@@ -544,7 +544,7 @@ export interface paths {
544
544
  };
545
545
  /**
546
546
  * Agent domain lookup
547
- * @description Get all publisher domains associated with an agent.
547
+ * @description Get all publisher domains whose adagents.json authorizes an agent. `agentUrl` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule: an origin-only `authorized_agents[].url` (`https://agent.example.com`) authorizes every agent URL at that origin, and an entry with a path matches that canonical URL only, with a non-root trailing slash significant.
548
548
  */
549
549
  get: operations["getAgentDomains"];
550
550
  put?: never;
@@ -568,7 +568,7 @@ export interface paths {
568
568
  *
569
569
  * Spec: [docs/aao/directory-api.mdx](/docs/aao/directory-api) (adcp#4823). This endpoint is the spec-compliant richer-shape replacement for the legacy `/api/registry/lookup/agent/{agentUrl}/domains`, which returns domain strings only.
570
570
  *
571
- * `agent_url` is matched with [AdCP URL canonicalization](/docs/reference/url-canonicalization) and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets, the same rule the SDK applies in `verify_agent_authorization`. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
571
+ * `agent_url` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule, after [AdCP URL canonicalization](/docs/reference/url-canonicalization) of both sides. A publisher whose `authorized_agents[].url` is **origin-only** (`https://a.example` or `https://a.example/`) authorizes every agent URL with that canonical origin (same scheme, host and port), so it is returned for `https://a.example/mcp` and `https://a.example/a2a` alike (DR-0023, AdCP 3.3). An entry **with a path** matches that canonical URL only, and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two trailing-slash spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
572
572
  */
573
573
  get: operations["getPublishersForAgentLegacyApiPrefix"];
574
574
  put?: never;
@@ -592,7 +592,7 @@ export interface paths {
592
592
  *
593
593
  * Spec: [docs/aao/directory-api.mdx](/docs/aao/directory-api) (adcp#4823). This endpoint is the spec-compliant richer-shape replacement for the legacy `/api/registry/lookup/agent/{agentUrl}/domains`, which returns domain strings only.
594
594
  *
595
- * `agent_url` is matched with [AdCP URL canonicalization](/docs/reference/url-canonicalization) and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets, the same rule the SDK applies in `verify_agent_authorization`. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
595
+ * `agent_url` is matched with the [adagents.json agent URL matching](/docs/governance/property/adagents#agent-url-matching) rule, after [AdCP URL canonicalization](/docs/reference/url-canonicalization) of both sides. A publisher whose `authorized_agents[].url` is **origin-only** (`https://a.example` or `https://a.example/`) authorizes every agent URL with that canonical origin (same scheme, host and port), so it is returned for `https://a.example/mcp` and `https://a.example/a2a` alike (DR-0023, AdCP 3.3). An entry **with a path** matches that canonical URL only, and a **non-root trailing slash is significant**: `https://a.example/mcp` and `https://a.example/mcp/` are different agents and can return different publisher sets. Ask for the spelling the publisher's adagents.json lists. (Through 2026-10-18 this endpoint folded the two trailing-slash spellings together and answered both with the slashless agent's publishers; that disagreed with the spec and with the validator.) The `agent_url` in the response echoes the canonicalized lookup key, slash included.
596
596
  */
597
597
  get: operations["getPublishersForAgent"];
598
598
  put?: never;
@@ -2582,7 +2582,7 @@ export interface components {
2582
2582
  stats?: components["schemas"]["AgentStats"];
2583
2583
  capabilities?: components["schemas"]["AgentCapabilities"];
2584
2584
  compliance?: components["schemas"]["AgentCompliance"];
2585
- /** @description Every raw agent_url spelling the directory has indexed under this agent's identity, with the listed (canonical) url first. The registry keys an agent by identity, folding a non-root trailing slash, but GET /v1/agents/{agent_url}/publishers matches spec-exactly with the slash significant — so a client answering "which publishers authorize this agent" must query once per spelling here and merge the results. */
2585
+ /** @description Every raw agent_url spelling the directory has indexed under this agent's identity, with the listed (canonical) url first. The registry keys an agent by identity, folding a non-root trailing slash, but GET /v1/agents/{agent_url}/publishers matches with adagents.json agent URL matching, where the slash is significant for an entry with a path — so a client answering "which publishers authorize this agent" must query once per spelling here and merge the results. Publishers that authorize the agent's bare origin are returned for every spelling. */
2586
2586
  declared_urls?: string[];
2587
2587
  publisher_domains?: string[];
2588
2588
  property_summary?: components["schemas"]["PropertySummary"];
@@ -4369,6 +4369,7 @@ export interface components {
4369
4369
  first_failure_validations: unknown[];
4370
4370
  /** @description Up to 5 cascaded prerequisite skips with runner reason/detail and the nearest earlier non-passing step. Populated only for owners and empty for other callers. */
4371
4371
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
4372
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
4372
4373
  last_tested_at: string | null;
4373
4374
  last_passed_at: string | null;
4374
4375
  }[];
@@ -4449,6 +4450,34 @@ export interface components {
4449
4450
  /** @description 'failed', or the skip reason of the earlier step. */
4450
4451
  blocked_by_reason: string | null;
4451
4452
  };
4453
+ /** @description Why the storyboard failed when no counted step did (adcp#8576). Populated only for owners and operators; null for other callers and for passing or step-level verdicts. */
4454
+ StoryboardVerdictExplanation: {
4455
+ /** @description Runner verdict_reason: step_failed, assertion_failed, controller_prerequisite_unmet, required_phase_not_executed, no_executed_steps, fixture_error, coverage_unverified, runner_error, or unexplained. runner_error is not an agent failure. */
4456
+ reason: string;
4457
+ /** @description One-line redacted runner explanation. May echo agent-supplied values. */
4458
+ detail: string | null;
4459
+ /** @description Up to 10 steps, assertions, phases or requirements behind the verdict. */
4460
+ contributing: components["schemas"]["StoryboardVerdictContributor"][];
4461
+ } | null;
4462
+ StoryboardVerdictContributor: {
4463
+ /** @description step, assertion, phase or requirement. */
4464
+ kind: string | null;
4465
+ /** @description Step id, assertion id, phase id, or requirement name. */
4466
+ id: string | null;
4467
+ /** @description The verdict reason this row supports. */
4468
+ reason: string | null;
4469
+ /** @description failed, skipped, or not_passed. */
4470
+ status: string | null;
4471
+ phase_id: string | null;
4472
+ /** @description 1-based pass index in multi-pass runs. */
4473
+ pass_index: number | null;
4474
+ /** @description Runner skip reason, when the step was skipped. */
4475
+ skip_reason: string | null;
4476
+ /** @description Unmet requirement named by the skip, e.g. controller. */
4477
+ requirement: string | null;
4478
+ /** @description Redacted runner text. May echo agent-supplied values. */
4479
+ message: string | null;
4480
+ };
4452
4481
  PublicComplianceNotice: {
4453
4482
  severity: string;
4454
4483
  code: string;
@@ -4678,7 +4707,9 @@ export interface components {
4678
4707
  relevant_bundle_ids: string[];
4679
4708
  failing_bundle_count: number;
4680
4709
  incomplete_bundle_count: number;
4681
- /** @description Universal bundles left partial only because the agent advertises none of the tools for a surface it does not declare. They do not count as incomplete. */
4710
+ /** @description Relevant bundles, as kind:id, that keep Strict Spec partial because their evidence is incomplete: an untested or partially covered storyboard, including runner and test-kit gaps. */
4711
+ incomplete_bundle_ids?: string[];
4712
+ /** @description Universal bundles left partial only because the agent does not offer the surface: it advertises none of the tools for a surface it does not declare, or it does not advertise request signing for signed_requests. They do not count as incomplete. */
4682
4713
  not_applicable_universal_bundle_ids?: string[];
4683
4714
  relevant_failure_count: number;
4684
4715
  missing_universal_bundle: boolean;
@@ -4720,6 +4751,7 @@ export interface components {
4720
4751
  first_failure_message: string | null;
4721
4752
  /** @description Up to 5 cascaded prerequisite skips with runner reason/detail and the nearest earlier non-passing step, when captured. Owner-scoped; empty for other callers. */
4722
4753
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
4754
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
4723
4755
  last_tested_at: string | null;
4724
4756
  last_passed_at: string | null;
4725
4757
  };
@@ -6574,6 +6606,7 @@ export interface operations {
6574
6606
  properties_total: number;
6575
6607
  /** @description Canonical list of property_id strings the agent is authorized for under this publisher. Present iff the request included `?include=properties`. Same population as `properties_authorized` but surfaced as IDs for set-diff comparison. */
6576
6608
  property_ids?: string[];
6609
+ /** @description Scope-agnostic summary: true only when every in-window authorized_agents entry that matches the agent carries signing_keys. Verifiers compute the pin per message scope, so a pin can apply where this reads false. */
6577
6610
  signing_keys_pinned: boolean;
6578
6611
  /** @enum {string} */
6579
6612
  status: "authorized" | "revoked";
@@ -6656,6 +6689,7 @@ export interface operations {
6656
6689
  properties_total: number;
6657
6690
  /** @description Canonical list of property_id strings the agent is authorized for under this publisher. Present iff the request included `?include=properties`. Same population as `properties_authorized` but surfaced as IDs for set-diff comparison. */
6658
6691
  property_ids?: string[];
6692
+ /** @description Scope-agnostic summary: true only when every in-window authorized_agents entry that matches the agent carries signing_keys. Verifiers compute the pin per message scope, so a pin can apply where this reads false. */
6659
6693
  signing_keys_pinned: boolean;
6660
6694
  /** @enum {string} */
6661
6695
  status: "authorized" | "revoked";
@@ -8779,7 +8813,7 @@ export interface operations {
8779
8813
  getAgentAuthorizations: {
8780
8814
  parameters: {
8781
8815
  query: {
8782
- /** @description Agent URL to look up. Canonicalized server-side per AdCP URL canonicalization: the scheme and host fold, the path does not. */
8816
+ /** @description Agent URL to look up. Canonicalized server-side per AdCP URL canonicalization: the scheme and host fold, the path does not. Returns the rows whose `agent_url` authorizes it under adagents.json agent URL matching: rows for the same canonical URL, plus rows whose `agent_url` is origin-only (`https://agent.example.com`) for the same canonical origin, which authorize every path at that origin. */
8783
8817
  agent_url: string;
8784
8818
  /** @description `effective` (default) applies override layer; `raw` reads base table. */
8785
8819
  include?: "raw" | "effective";
@@ -8824,7 +8858,7 @@ export interface operations {
8824
8858
  created_at: string;
8825
8859
  /** Format: date-time */
8826
8860
  updated_at: string;
8827
- /** @description Publisher-pinned JWK set (authorized_agents[*].signing_keys) from the source adagents.json. Consumers verifying inbound TMP signatures key on kid → JWK. Null when the publisher declared no keys; consumers fall back to the agent-hosted JWKS per spec R-2 (docs/governance/property/adagents.mdx). */
8861
+ /** @description Publisher-pinned JWK set (authorized_agents[*].signing_keys) from the source adagents.json. Consumers verifying inbound TMP signatures key on kid → JWK. Null when the publisher declared no keys; consumers fall back to the agent-hosted JWKS per spec R-2 (docs/governance/property/adagents.mdx). This is one entry's pin. Rows from the same publisher combine per message scope: among the rows that authorize that scope, the publisher pins the agent only if every one carries keys, and the pin is the union of their keys (docs/governance/property/adagents.mdx#agent-url-matching). */
8828
8862
  signing_keys: components["schemas"]["SigningKey"][] | null;
8829
8863
  /** @description Collection constraints (authorized_agents[*].collections) from the source adagents.json. Null when the entry is unconstrained. When set, the row does NOT authorize the property unqualified — consumers MUST scope it to these selectors. A selector without collection_ids is a bulk grant for all collections declared at that publisher_domain. */
8830
8864
  collections: ({
@@ -11891,6 +11925,7 @@ export interface operations {
11891
11925
  first_failure_message: string | null;
11892
11926
  first_failure_validations: unknown[];
11893
11927
  skipped_steps: components["schemas"]["StoryboardSkippedStep"][];
11928
+ verdict_explanation: components["schemas"]["StoryboardVerdictExplanation"];
11894
11929
  };
11895
11930
  phases?: unknown;
11896
11931
  summary?: unknown;
@@ -581,7 +581,8 @@ const REFINE_PROPOSALS_INPUT_SHAPE = {
581
581
  governance_context: SHALLOW_HINT_FIELD_SCHEMA,
582
582
  push_notification_config: SHALLOW_HINT_FIELD_SCHEMA,
583
583
  adcp_version: SHALLOW_HINT_FIELD_SCHEMA,
584
- adcp_major_version: SHALLOW_HINT_FIELD_SCHEMA
584
+ adcp_major_version: SHALLOW_HINT_FIELD_SCHEMA,
585
+ ext: SHALLOW_HINT_FIELD_SCHEMA
585
586
  };
586
587
  function getToolInputShapes() {
587
588
  cachedToolInputShapes ??= import_schemas.TOOL_INPUT_SHAPES;
@@ -683,7 +683,8 @@ const REFINE_PROPOSALS_INPUT_SHAPE = {
683
683
  governance_context: SHALLOW_HINT_FIELD_SCHEMA,
684
684
  push_notification_config: SHALLOW_HINT_FIELD_SCHEMA,
685
685
  adcp_version: SHALLOW_HINT_FIELD_SCHEMA,
686
- adcp_major_version: SHALLOW_HINT_FIELD_SCHEMA
686
+ adcp_major_version: SHALLOW_HINT_FIELD_SCHEMA,
687
+ ext: SHALLOW_HINT_FIELD_SCHEMA
687
688
  };
688
689
  function getToolInputShapes() {
689
690
  cachedToolInputShapes ??= TOOL_INPUT_SHAPES;
@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
197
197
  */
198
198
  export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
199
199
  /** Capability semver emitted in run summaries and used for advisory expiry. */
200
- export declare const RUNNER_CAPABILITY_VERSION = "16.7.1";
200
+ export declare const RUNNER_CAPABILITY_VERSION = "16.7.2";
201
201
  /** True when a failed validation contributes to the owning step's grade. */
202
202
  export declare function validationFailsStep(result: ValidationResult): boolean;
203
203
  /**
@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
197
197
  */
198
198
  export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
199
199
  /** Capability semver emitted in run summaries and used for advisory expiry. */
200
- export declare const RUNNER_CAPABILITY_VERSION = "16.7.1";
200
+ export declare const RUNNER_CAPABILITY_VERSION = "16.7.2";
201
201
  /** True when a failed validation contributes to the owning step's grade. */
202
202
  export declare function validationFailsStep(result: ValidationResult): boolean;
203
203
  /**
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * AdCP SDK library version
3
3
  */
4
- export declare const LIBRARY_VERSION = "16.7.1";
4
+ export declare const LIBRARY_VERSION = "16.7.2";
5
5
  /**
6
6
  * AdCP specification version this library is built for
7
7
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
33
33
  * Full version information
34
34
  */
35
35
  export declare const VERSION_INFO: {
36
- readonly library: "16.7.1";
36
+ readonly library: "16.7.2";
37
37
  readonly adcp: "3.2.10";
38
38
  readonly compatibleVersions: readonly ["v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.1.25", "3.1.26", "3.1.27", "3.1.28", "3.1.29", "3.1.30", "3.1.31", "3.1.32", "3.1.33", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.2.8", "3.2.9", "3.2.10"];
39
- readonly generatedAt: "2026-11-12T17:18:31.204Z";
39
+ readonly generatedAt: "2026-11-16T20:00:18.564Z";
40
40
  };
41
41
  /**
42
42
  * Get the AdCP specification version this library is built for
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * AdCP SDK library version
3
3
  */
4
- export declare const LIBRARY_VERSION = "16.7.1";
4
+ export declare const LIBRARY_VERSION = "16.7.2";
5
5
  /**
6
6
  * AdCP specification version this library is built for
7
7
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
33
33
  * Full version information
34
34
  */
35
35
  export declare const VERSION_INFO: {
36
- readonly library: "16.7.1";
36
+ readonly library: "16.7.2";
37
37
  readonly adcp: "3.2.10";
38
38
  readonly compatibleVersions: readonly ["v3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.0.13", "3.0.14", "3.0.15", "3.0.16", "3.0.17", "3.0.18", "3.0.19", "3.0.20", "3.0.21", "3.0.22", "3.0.23", "3.0.24", "3.0.25", "3.1.0", "3.1", "3.1.1", "3.1.2", "3.1.3", "3.1.4", "3.1.5", "3.1.6", "3.1.7", "3.1.8", "3.1.9", "3.1.10", "3.1.11", "3.1.12", "3.1.13", "3.1.14", "3.1.15", "3.1.16", "3.1.17", "3.1.18", "3.1.19", "3.1.20", "3.1.21", "3.1.22", "3.1.23", "3.1.24", "3.1.25", "3.1.26", "3.1.27", "3.1.28", "3.1.29", "3.1.30", "3.1.31", "3.1.32", "3.1.33", "3.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.2.8", "3.2.9", "3.2.10"];
39
- readonly generatedAt: "2026-11-12T17:18:31.204Z";
39
+ readonly generatedAt: "2026-11-16T20:00:18.564Z";
40
40
  };
41
41
  /**
42
42
  * Get the AdCP specification version this library is built for
@@ -31,7 +31,7 @@ __export(version_exports, {
31
31
  toReleasePrecisionVersion: () => toReleasePrecisionVersion
32
32
  });
33
33
  module.exports = __toCommonJS(version_exports);
34
- const LIBRARY_VERSION = "16.7.1";
34
+ const LIBRARY_VERSION = "16.7.2";
35
35
  const ADCP_VERSION = "3.2.10";
36
36
  const ADCP_MAJOR_VERSION = 3;
37
37
  const COMPATIBLE_ADCP_VERSIONS = [
@@ -111,10 +111,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
111
111
  "3.2.10"
112
112
  ];
113
113
  const VERSION_INFO = {
114
- library: "16.7.1",
114
+ library: "16.7.2",
115
115
  adcp: "3.2.10",
116
116
  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
117
- generatedAt: "2026-11-12T17:18:31.204Z"
117
+ generatedAt: "2026-11-16T20:00:18.564Z"
118
118
  };
119
119
  function getAdcpVersion() {
120
120
  return ADCP_VERSION;
@@ -1,4 +1,4 @@
1
- const LIBRARY_VERSION = "16.7.1";
1
+ const LIBRARY_VERSION = "16.7.2";
2
2
  const ADCP_VERSION = "3.2.10";
3
3
  const ADCP_MAJOR_VERSION = 3;
4
4
  const COMPATIBLE_ADCP_VERSIONS = [
@@ -78,10 +78,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
78
78
  "3.2.10"
79
79
  ];
80
80
  const VERSION_INFO = {
81
- library: "16.7.1",
81
+ library: "16.7.2",
82
82
  adcp: "3.2.10",
83
83
  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
84
- generatedAt: "2026-11-12T17:18:31.204Z"
84
+ generatedAt: "2026-11-16T20:00:18.564Z"
85
85
  };
86
86
  function getAdcpVersion() {
87
87
  return ADCP_VERSION;
@@ -1,7 +1,7 @@
1
1
  # AdCP Type Summary
2
2
 
3
- > Generated at: 2026-11-12
4
- > @adcp/sdk v16.7.1
3
+ > Generated at: 2026-11-16
4
+ > @adcp/sdk v16.7.2
5
5
 
6
6
  Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
7
7
 
package/docs/llms.txt CHANGED
@@ -1,7 +1,7 @@
1
1
  # Ad Context Protocol (AdCP)
2
2
 
3
- > Generated at: 2026-11-12
4
- > Library: @adcp/sdk v16.7.1
3
+ > Generated at: 2026-11-16
4
+ > Library: @adcp/sdk v16.7.2
5
5
  > AdCP major version: 3
6
6
  > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
7
7
  > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.
@@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball.
16
16
 
17
17
  | Fact | Value |
18
18
  | --- | --- |
19
- | Checkout `package.json` version | `@adcp/sdk@16.7.1` |
20
- | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@16.7.1 dist.integrity` |
19
+ | Checkout `package.json` version | `@adcp/sdk@16.7.2` |
20
+ | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@16.7.2 dist.integrity` |
21
21
  | Node.js runtime | `^20.19.0 || >=22.12.0` |
22
22
  | Default AdCP wire release | `3.2.10` |
23
23
  | Maintained wire releases | `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.1.25`, `3.1.26`, `3.1.27`, `3.1.28`, `3.1.29`, `3.1.30`, `3.1.31`, `3.1.32`, `3.1.33`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3`, `3.2.4`, `3.2.5`, `3.2.6`, `3.2.7`, `3.2.8`, `3.2.9`, `3.2.10` |
@@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball.
26
26
  For a checkout at the published release commit, install the exact package version:
27
27
 
28
28
  ```bash
29
- npm install --save-exact '@adcp/sdk@16.7.1'
30
- npm view '@adcp/sdk@16.7.1' dist.integrity
29
+ npm install --save-exact '@adcp/sdk@16.7.2'
30
+ npm view '@adcp/sdk@16.7.2' dist.integrity
31
31
  ```
32
32
 
33
33
  ### Required and optional peers
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adcp/sdk",
3
- "version": "16.7.1",
3
+ "version": "16.7.2",
4
4
  "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
5
5
  "workspaces": [
6
6
  ".",