@agent-blueprint-protocol/verifier 1.0.1-rc.1 → 1.1.0-rc.1

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 (48) hide show
  1. package/CHANGELOG.md +215 -193
  2. package/README.md +36 -15
  3. package/dist/examples/echo-blueprint.json +1 -0
  4. package/dist/examples/echo-deployment.json +1 -0
  5. package/dist/examples/extension-blueprint.json +1 -0
  6. package/dist/examples/federation-envelope.json +1 -0
  7. package/dist/examples/signed-blueprint.json +1 -0
  8. package/dist/release-history.json +1 -1
  9. package/dist/release-metadata.json +1 -1
  10. package/dist/spec/FOUNDATION-TRANSITION.md +9 -17
  11. package/dist/spec/IPR.md +1 -1
  12. package/dist/spec/README.md +2 -2
  13. package/dist/spec/conformance/runner.md +2 -2
  14. package/dist/spec/errata.md +1 -1
  15. package/dist/spec/grammar/blueprint.cddl +1 -1
  16. package/dist/spec/grammar/deployment.cddl +5 -3
  17. package/dist/spec/grammar/derived/deployment.schema.json +34 -21
  18. package/dist/spec/grammar/taskenvelope.cddl +1 -1
  19. package/dist/spec/protocol.md +86 -93
  20. package/dist/verifier/b64url.js +1 -1
  21. package/dist/verifier/blueprint.d.ts +17 -0
  22. package/dist/verifier/blueprint.js +12 -4
  23. package/dist/verifier/bounds.js +1 -1
  24. package/dist/verifier/bounds_algebra.js +1 -1
  25. package/dist/verifier/canonical.js +3 -3
  26. package/dist/verifier/cli.js +5 -5
  27. package/dist/verifier/compatibility.js +2 -2
  28. package/dist/verifier/corpus.js +2 -2
  29. package/dist/verifier/decode.js +4 -4
  30. package/dist/verifier/deployment.d.ts +17 -0
  31. package/dist/verifier/deployment.js +12 -4
  32. package/dist/verifier/digest.js +1 -1
  33. package/dist/verifier/extension.js +2 -2
  34. package/dist/verifier/facade.d.ts +6 -0
  35. package/dist/verifier/facade.js +6 -0
  36. package/dist/verifier/federation.d.ts +17 -0
  37. package/dist/verifier/federation.js +11 -3
  38. package/dist/verifier/mapping.d.ts +10 -10
  39. package/dist/verifier/mapping.js +1 -1
  40. package/dist/verifier/negotiation.js +4 -4
  41. package/dist/verifier/portability.js +2 -2
  42. package/dist/verifier/registry.js +1 -1
  43. package/dist/verifier/report.js +1 -1
  44. package/dist/verifier/runner.js +2 -2
  45. package/dist/verifier/schema.js +4 -4
  46. package/dist/verifier/signature.js +6 -6
  47. package/dist/verifier/value.js +3 -3
  48. package/package.json +3 -2
@@ -1,11 +1,11 @@
1
- # Agent Blueprint Protocol — specification
1
+ # Agent Blueprint Protocol: specification
2
2
 
3
3
  Status: normative protocol 1.0. This document is
4
4
  the normative specification of the Agent Blueprint Protocol. The
5
5
  reference implementation and its conformance corpus (digest
6
6
  `sha-256:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`, 626 cases) are
7
7
  certified against this document at every release through the release
8
- identity chain — the specification digest, the package version, and the
8
+ identity chain: the specification digest, the package version, and the
9
9
  corpus and registry digests are pinned together per release, and the
10
10
  release-candidate check asserts the chain from live state. Where this
11
11
  document and the implementation disagree, one of them is defective and
@@ -24,16 +24,16 @@ informative.
24
24
  bytes, bounds, compatibility, and evidence. Protocol validity never
25
25
  grants authority: a consuming host remains responsible for identity,
26
26
  tenancy, live policy, effect ownership, execution, and evidence
27
- retention. Every verification result — including a fully green one — is
27
+ retention. Every verification result (including a fully green one) is
28
28
  evidence, never a decision.
29
29
 
30
30
  ## 1. Scope, non-goals, and terminology
31
31
 
32
32
  Two language-neutral artifacts:
33
33
 
34
- - **Blueprint Core** — stable identity, typed ports, logical capability
34
+ - **Blueprint Core**: stable identity, typed ports, logical capability
35
35
  requirements, bounds, evidence commitments, registered extensions.
36
- - **Deployment Manifest** — environment-local tool, principal, data,
36
+ - **Deployment Manifest**: environment-local tool, principal, data,
37
37
  authority, effect, evaluation, and exact-build bindings for one
38
38
  Blueprint release digest.
39
39
 
@@ -43,44 +43,44 @@ clients, billing, evaluation truth. The reference implementation is an inert lib
43
43
 
44
44
  ### Terminology
45
45
 
46
- - **Artifact** — a Blueprint or Deployment Manifest value together with
46
+ - **Artifact**: a Blueprint or Deployment Manifest value together with
47
47
  its exact canonical bytes; the artifact's identity is its content
48
- digest — the digest of the artifact's digest-covered members over
48
+ digest, the digest of the artifact's digest-covered members over
49
49
  those canonical bytes (the digest section defines the exact input;
50
50
  the digest member itself, signatures, and attestations are
51
51
  excluded).
52
- - **Host** — the consuming runtime. Every non-establishment obligation
52
+ - **Host**: the consuming runtime. Every non-establishment obligation
53
53
  in this protocol belongs to a host, and a green result never
54
54
  transfers one to the package.
55
- - **Deny** — the fail-closed outcome: a typed error code with subject
55
+ - **Deny**: the fail-closed outcome: a typed error code with subject
56
56
  and optional detail. A deny is never a repair and never a silent
57
57
  skip; where this document states a requirement as a deny, the
58
58
  requirement is absolute (MUST-level) and the error code named is the
59
59
  code that enforces it.
60
- - **Quarantine** — retain byte-exactly without validating or executing:
60
+ - **Quarantine**: retain byte-exactly without validating or executing:
61
61
  an unknown optional extension's payload round-trips, is typed as
62
62
  unscanned, and confers no portability claim.
63
- - **Clamp** — the effective narrowing of an operational bound, emitted
63
+ - **Clamp**: the effective narrowing of an operational bound, emitted
64
64
  with evidence whenever effective differs from requested; protected
65
65
  bounds deny instead of clamping.
66
- - **Ceiling vs bound** — operational bounds are magnitude limits that
66
+ - **Ceiling vs bound**: operational bounds are magnitude limits that
67
67
  narrow pointwise; protected ceilings are ordinal-lattice positions
68
68
  (classification, disclosure, effect impact, authority, approval) that
69
69
  never widen and deny narrowing by default (both in the evolution
70
70
  laws). A parse ceiling is neither: it is a tighten-only decoder
71
71
  limit, never an intersection input.
72
- - **Evidence** — a structured observation about bytes or structure:
72
+ - **Evidence**: a structured observation about bytes or structure:
73
73
  per-surface check results, clamp records, and the non-empty
74
74
  `not_verified` set naming what was NOT established. Evidence is
75
75
  input to a host decision; it is never a decision.
76
- - **Portability** — the property that an artifact carries no
76
+ - **Portability**: the property that an artifact carries no
77
77
  environment-bound values (secrets, keys, grants, tenant ids,
78
78
  endpoints, engine ids); enforced structurally and honestly limited
79
79
  (the portability section).
80
- - **Posture** — the declared stance of a surface: fail-closed (deny),
80
+ - **Posture**: the declared stance of a surface: fail-closed (deny),
81
81
  acknowledge-and-record (clamp with evidence, or a typed notice), or
82
82
  opt-in (a host-supplied policy).
83
- - **Authored channel** — the validated critical-extension path by which a
83
+ - **Authored channel**: the validated critical-extension path by which a
84
84
  producer-declared critical extension body, validated against a
85
85
  digest-pinned host schema, is treated as authored content and spared
86
86
  the generic value-shape heuristics (still covered by the artifact's
@@ -89,12 +89,12 @@ clients, billing, evaluation truth. The reference implementation is an inert lib
89
89
  ## 2. Artifacts and the closed world
90
90
 
91
91
  Both artifacts MUST decode as JSON objects under the bounded ceilings
92
- (depth, members, items, nodes, string bytes, key bytes, number lexemes
93
- — the ceiling family). Decoding MUST be fail-closed under the pinned
92
+ (depth, members, items, nodes, string bytes, key bytes, number lexemes:
93
+ the ceiling family). Decoding MUST be fail-closed under the pinned
94
94
  failure precedence: unknown member → missing required → type →
95
95
  constraint → cardinality → nested → cross-field hooks.
96
96
 
97
- The registries are closed worlds — the exact member sets the shipped
97
+ The registries are closed worlds: the exact member sets the shipped
98
98
  tables define:
99
99
 
100
100
  - **Blueprint Core (18 members).** Required: `blueprint_id`,
@@ -118,14 +118,14 @@ vocabulary can only evolve at a revision boundary. Protocol revisions and verifi
118
118
  Release package versions do not appear in the artifact grammar.
119
119
 
120
120
  A complete, valid Blueprint as it travels on the wire (the conformance
121
- corpus's `blueprint-decode-valid` case, byte-exact — every fenced
121
+ corpus's `blueprint-decode-valid` case, byte-exact; every fenced
122
122
  JSON example in this specification is a corpus case):
123
123
 
124
124
  ```json-corpus:blueprint-decode-valid
125
125
  {"blueprint_id":"example.demo/echo","capability_requirements":[{"approval_trait":"none","argument_schema":{"type":"object"},"authority_trait":"none","classification_ceiling":"internal","impact_class":"ordinary","operation_family":"example.demo.read_shape","operation_kind":"read","result_schema":{"type":"object"}}],"ceilings":{"max_attempts":3,"max_concurrency":2,"max_cost":{"amount":1000,"currency":"USD"},"max_depth":8,"max_descendants":64,"max_elapsed_ms":60000,"max_fan_out":4,"max_tokens":100000},"classification_ceiling":"internal","content_digest":"sha-256:b1Aw4cU5AbV9k8bdbZkRCsySDHGpTAwB-aQm57Wh7B8","effect_intents":[{"impact_class":"ordinary","logical_operation":"record_summary","operation_kind":"mutation"}],"evaluation_assertions":[{"kind":"output_schema","port":"result","schema":{"type":"object"}}],"extensions":{"critical":{},"optional":{}},"input_ports":[{"classification_ceiling":"internal","name":"request","required":true,"schema":{"type":"object"}}],"output_contract":{"classification_ceiling":"internal","port":"result"},"output_ports":[{"classification_ceiling":"internal","name":"result","required":true,"schema":{"type":"object"}}],"producer":{"created_at":"2026-08-20T00:00:00Z","identity":"example.demo","toolchain":"example.demo.toolchain"},"protocol_revision":1,"release_number":1,"required_core_fields":[],"triggers":["manual"]}
126
126
  ```
127
127
 
128
- ### Member grammar — Blueprint Core (18 members)
128
+ ### Member grammar: Blueprint Core (18 members)
129
129
 
130
130
  Cardinality `1` members are required; `0..1` members are optional.
131
131
  The failure precedence is the pinned closed-world order: unknown
@@ -144,15 +144,15 @@ reference implementation's to enforce.
144
144
  |---|---|---|---|
145
145
  | `blueprint_id` | 1 | string | value: producer-qualified name |
146
146
  | `capability_requirements` | 1 | array<object{ operation_family:string; argument_schema:custom; result_schema:custom; operation_kind:enum(computation\|mutation\|read); impact_class:enum(authority\|money\|ordinary\|secret); classification_ceiling:enum(confidential\|internal\|public\|restricted); approval_trait:enum(human_required\|none\|separated_human_required); authority_trait:enum(external_authority_required\|local_policy\|none) }> | max 64, unique by operation_family |
147
- | `ceilings` | 1 | object{ max_attempts:integer; max_concurrency:integer; max_depth:integer; max_descendants:integer; max_elapsed_ms:integer; max_fan_out:integer; max_tokens:integer; max_cost:object{ amount:integer; currency:string } } | — |
148
- | `classification_ceiling` | 1 | enum(confidential\|internal\|public\|restricted) | — |
147
+ | `ceilings` | 1 | object{ max_attempts:integer; max_concurrency:integer; max_depth:integer; max_descendants:integer; max_elapsed_ms:integer; max_fan_out:integer; max_tokens:integer; max_cost:object{ amount:integer; currency:string } } | - |
148
+ | `classification_ceiling` | 1 | enum(confidential\|internal\|public\|restricted) | - |
149
149
  | `effect_intents` | 1 | array<object{ logical_operation:string; operation_kind:enum(computation\|mutation\|read); impact_class:enum(authority\|money\|ordinary\|secret) }> | max 64, unique by logical_operation |
150
150
  | `evaluation_assertions` | 1 | array<custom> | max 128 |
151
- | `extensions` | 1 | custom | — |
151
+ | `extensions` | 1 | custom | - |
152
152
  | `input_ports` | 1 | array<object{ name:string; schema:custom; classification_ceiling:enum(confidential\|internal\|public\|restricted); required:boolean }> | max 64, unique by name |
153
- | `output_contract` | 1 | object{ port:string; classification_ceiling:enum(confidential\|internal\|public\|restricted) } | — |
153
+ | `output_contract` | 1 | object{ port:string; classification_ceiling:enum(confidential\|internal\|public\|restricted) } | - |
154
154
  | `output_ports` | 1 | array<object{ name:string; schema:custom; classification_ceiling:enum(confidential\|internal\|public\|restricted); required:boolean }> | max 64, unique by name |
155
- | `producer` | 1 | object{ identity:string; created_at:string; toolchain:string } | — |
155
+ | `producer` | 1 | object{ identity:string; created_at:string; toolchain:string } | - |
156
156
  | `protocol_revision` | 1 | integer | value: positive integer |
157
157
  | `release_number` | 1 | integer | value: positive integer |
158
158
  | `required_core_fields` | 1 | array<string> | unique by value |
@@ -161,7 +161,7 @@ reference implementation's to enforce.
161
161
  | `attestations` | 0..1 | array<any> | max 16 |
162
162
  | `content_digest` | 1 | string | value: tagged digest |
163
163
 
164
- ### Member grammar — Deployment Manifest (19 members)
164
+ ### Member grammar: Deployment Manifest (19 members)
165
165
 
166
166
  Cardinality `1` members are required; `0..1` members are optional.
167
167
  The failure precedence is the pinned closed-world order: unknown
@@ -178,21 +178,21 @@ reference implementation's to enforce.
178
178
 
179
179
  | Member | Card. | Type | Constraints |
180
180
  |---|---|---|---|
181
- | `authority_requirement` | 1 | object{ adapter_identity:string; profile_identity:string } | — |
182
- | `blueprint_release` | 1 | object{ blueprint_id:string; release_number:integer; content_digest:string } | — |
181
+ | `authority_requirement` | 1 | object{ adapter_identity:string; profile_identity:string } | - |
182
+ | `blueprint_release` | 1 | object{ blueprint_id:string; release_number:integer; content_digest:string } | - |
183
183
  | `build_identities` | 1 | array<object{ kind:enum(adapter\|build\|extension\|package); name:string; version:string; digest:string }> | max 128, min 1, unique by name |
184
184
  | `data_bindings` | 1 | array<object{ logical_dataset:string; classification_ceiling:enum(confidential\|internal\|public\|restricted); as_of:object{ mode:enum(none\|required); max_age_ms:custom } }> | max 64, unique by logical_dataset |
185
- | `effect_owner` | 1 | object{ adapter_identity:string; idempotency:object{ key_derivation:enum(host); recovery:enum(authoritative\|none) } } | — |
186
- | `eligibility` | 1 | object{ owner:custom; beneficiary:custom; runtime_principal:custom } | — |
187
- | `evaluation_binding` | 1 | object{ adapter_identity:string; corpus:object{ name:string; digest:string } } | — |
188
- | `extensions` | 1 | custom | — |
189
- | `host_bounds` | 1 | object{ approval_trait:enum(human_required\|none\|separated_human_required); authority_trait:enum(external_authority_required\|local_policy\|none); classification_ceiling:enum(confidential\|internal\|public\|restricted); disclosure_ceiling:enum(detail\|full\|none\|summary); effect_impact_ceiling:enum(authority\|money\|ordinary\|secret); max_attempts:integer; max_concurrency:integer; max_cost:object{ amount:integer; currency:string }; max_depth:integer; max_descendants:integer; max_elapsed_ms:integer; max_fan_out:integer; max_tokens:integer } | — |
190
- | `lifecycle` | 1 | object{ state:enum(active\|draft\|retired); activated_at (opt):string; retired_at (opt):string } | — |
191
- | `model_policy` | 1 | object{ allowed_model_roles:array<string>; max_tokens:integer; max_cost:object{ amount:integer; currency:string } } | — |
185
+ | `effect_owner` | 1 | object{ adapter_identity:string; idempotency:object{ key_derivation:enum(host); recovery:enum(authoritative\|none) } } | - |
186
+ | `eligibility` | 1 | object{ owner:custom; beneficiary:custom; runtime_principal:custom } | - |
187
+ | `evaluation_binding` | 1 | object{ adapter_identity:string; corpus:object{ name:string; digest:string } } | - |
188
+ | `extensions` | 1 | custom | - |
189
+ | `host_bounds` | 1 | object{ approval_trait:enum(human_required\|none\|separated_human_required); authority_trait:enum(external_authority_required\|local_policy\|none); classification_ceiling:enum(confidential\|internal\|public\|restricted); disclosure_ceiling:enum(detail\|full\|none\|summary); effect_impact_ceiling:enum(authority\|money\|ordinary\|secret); max_attempts:integer; max_concurrency:integer; max_cost:object{ amount:integer; currency:string }; max_depth:integer; max_descendants:integer; max_elapsed_ms:integer; max_fan_out:integer; max_tokens:integer } | - |
190
+ | `lifecycle` | 1 | object{ state:enum(active\|draft\|retired); activated_at (opt):string; retired_at (opt):string } | - |
191
+ | `model_policy` | 1 | object{ allowed_model_roles:array<string>; max_tokens:integer; max_cost:object{ amount:integer; currency:string } } | - |
192
192
  | `protocol_revision` | 1 | integer | value: positive integer |
193
193
  | `required_core_fields` | 1 | array<string> | unique by value |
194
- | `scope_projection` | 1 | object{ adapter_identity:string } | — |
195
- | `signer_custody` | 1 | enum(external_kms\|holder_edge\|host_managed) | — |
194
+ | `scope_projection` | 1 | object{ adapter_identity:string } | - |
195
+ | `signer_custody` | 1 | enum(external_kms\|holder_edge\|host_managed) | - |
196
196
  | `tool_bindings` | 1 | array<object{ logical_operation:string; adapter_identity:string; descriptor_digest:string; schema_digest:string; attested_at:string }> | max 128, unique by logical_operation |
197
197
  | `signatures` | 0..1 | array<custom> | max 16 |
198
198
  | `attestations` | 0..1 | array<any> | max 16 |
@@ -200,12 +200,12 @@ reference implementation's to enforce.
200
200
 
201
201
  Every `max_cost.amount`, including Blueprint `ceilings`, Deployment
202
202
  `host_bounds`, and `model_policy`, is an integer count of millionths
203
- (10^-6) of one unit of the currency named by `currency`. The currency is an
204
- three-uppercase-letter string matching `[A-Z]{3}`; verifiers check that
205
- pattern, and the currency's meaning is ISO 4217. The scale never depends on the
203
+ (10^-6) of one unit of the currency named by `currency`. The currency is a string of three uppercase letters matching `[A-Z]{3}`; verifiers check that pattern, and the currency's meaning is ISO 4217. The scale never depends on the
206
204
  currency's minor-unit exponent. Thus `amount: 1000, currency: "USD"` means
207
205
  0.001 USD, with no floating-point amount.
208
206
 
207
+ `as_of` is exactly `none` with a null age, or `required` with a positive integer age in milliseconds.
208
+
209
209
  ### Identifier and timestamp profiles
210
210
 
211
211
  The following ABNF uses ASCII code points. Each identifier or qualified
@@ -275,7 +275,7 @@ and free string members can contain other Unicode scalar values.
275
275
  `invalid_type`.
276
276
  - **base64url:** unpadded, exact alphabet; padded input MUST deny
277
277
  `base64url_padded`, non-alphabet input MUST deny `base64url_invalid`.
278
- - **Canonicality:** interchange bytes MUST already be canonical —
278
+ - **Canonicality:** interchange bytes MUST already be canonical;
279
279
  decode → re-encode → byte-compare; non-canonical bytes MUST deny
280
280
  `non_canonical_bytes` before any semantic read, and digests MUST be
281
281
  computed only over the exact received bytes.
@@ -292,7 +292,7 @@ before that value's sink checks.
292
292
  The canonical form MUST be RFC 8785 JSON Canonicalization Scheme:
293
293
 
294
294
  - No whitespace between tokens (§3.2.1).
295
- - Control characters U+0000–U+001F escaped as lowercase `\uXXXX` except
295
+ - Control characters U+0000 to U+001F escaped as lowercase `\uXXXX` except
296
296
  the five short escapes; `"` and `\` escaped; a lone surrogate denies
297
297
  (§3.2.2.2).
298
298
  - Numbers per ECMA-262 7.1.12.1 including the Note 2 enhancement:
@@ -300,7 +300,7 @@ The canonical form MUST be RFC 8785 JSON Canonicalization Scheme:
300
300
  `1.7976931348623157e308 → "1.7976931348623157e+308"`; NaN and Infinity
301
301
  deny (§3.2.2.3).
302
302
  - Object members sorted as UTF-16 code units compared as unsigned
303
- integers (§3.2.3) — NOT by UTF-8 byte order: for `U+FF3A` vs
303
+ integers (§3.2.3), NOT by UTF-8 byte order: for `U+FF3A` vs
304
304
  `U+10000`, UTF-16 order puts `U+10000` first.
305
305
 
306
306
  On the conformance `canonicalization.encode` surface, input JSON is decoded
@@ -313,7 +313,7 @@ digest_bytes = SHA-256( UTF8(domain_separator) || zero_octet || UTF8(JCS(digest_
313
313
  ```
314
314
 
315
315
  `digest_input` is the artifact object minus `content_digest` (or
316
- `deployment_digest`), `signatures`, and `attestations` — everything
316
+ `deployment_digest`), `signatures`, and `attestations`: everything
317
317
  else is covered, including extensions and unknown-but-optional
318
318
  extension payloads retained verbatim.
319
319
 
@@ -373,15 +373,15 @@ The `signature.verify` algorithm cases pin this shape.
373
373
  extensions, and `required_core_fields`, a signature cannot be lifted
374
374
  onto a different artifact, revision, or purpose; `key_id` prevents key
375
375
  substitution. A `key_id` matching no supplied key MUST halt verification
376
- with `signature_key_unsupported`, including during reconcile — the
376
+ with `signature_key_unsupported`, including during reconcile; the
377
377
  package performs no key discovery, fetch, or trust selection.
378
378
  - The attestation kind registry is empty; a nonempty attestation array
379
379
  denies `attestation_malformed`.
380
380
  - A supplied key whose `key_id` matches but which is not a usable
381
- Ed25519 public key — not exactly 32 bytes, a non-canonical encoding
381
+ Ed25519 public key (not exactly 32 bytes, a non-canonical encoding
382
382
  (y ≥ p, or x = 0 with the sign bit set), an encoding that decodes to
383
383
  no curve point, or a small-order point (any of the eight 8-torsion
384
- points, the identity and the order-2 point included) — MUST deny
384
+ points, the identity and the order-2 point included)) MUST deny
385
385
  `signature_algorithm_unsupported` when no matched key is usable.
386
386
  `signature_key_unsupported` is reserved for a `key_id` that matches
387
387
  no supplied key.
@@ -407,7 +407,7 @@ The `signature.verify` algorithm cases pin this shape.
407
407
  `Ed25519` denies `signature_algorithm_unsupported` and any other
408
408
  attribute violation `signature_malformed`; `kid` equal to `key_id`;
409
409
  and a signature body that decodes (unpadded base64url) to exactly
410
- 64 bytes — all else `signature_malformed`. (2) The key facts: with no
410
+ 64 bytes; all else `signature_malformed`. (2) The key facts: with no
411
411
  supplied key for the `key_id`, `signature_key_unsupported`; with
412
412
  matched keys none of which is usable, `signature_algorithm_unsupported`,
413
413
  whatever the well-formed 64-byte signature (an all-zero signature
@@ -429,13 +429,13 @@ never judge its time.
429
429
  `protocol_revision` is a digest-covered body member. This release is
430
430
  revision 1. A consumer's support MUST declare an explicit revision SET
431
431
  (never a range); a revision outside the set MUST deny
432
- `protocol_revision_unsupported` — above-max and below-min alike, both
432
+ `protocol_revision_unsupported`, above-max and below-min alike, both
433
433
  fail-closed.
434
434
 
435
435
  `required_core_fields` is the producer's declaration of which covered
436
436
  core members a consumer must honor. Three checks, all fail-closed:
437
437
  every entry names a known core member (`required_core_field_unsupported`),
438
- is digest-covered (`required_core_field_not_digest_covered` — an
438
+ is digest-covered (`required_core_field_not_digest_covered`: an
439
439
  evidence-only member laundered into a requirement is a tamper blind
440
440
  spot), and is in the consumer's supported set.
441
441
 
@@ -478,9 +478,9 @@ divergence; a release whose semantics version is
478
478
  unchanged MUST produce, for every input certified under a prior census
479
479
  of the same semantics version, the same verdict that prior release
480
480
  produced. A registry change that alters negotiation outcomes for
481
- previously-certified artifacts — for example a newly registered
481
+ previously-certified artifacts (for example a newly registered
482
482
  critical namespace flipping `extension_unknown_critical` denials to
483
- supported — is a verification-semantics change; registry census growth
483
+ supported) is a verification-semantics change; registry census growth
484
484
  that moves no previously-certified artifact's verdict is not. The two
485
485
  axes are independent of `protocol_revision`, which governs what
486
486
  artifacts may say; one event may move more than one axis.
@@ -560,7 +560,7 @@ entries after it was produced; hosts wanting pinning SHOULD use
560
560
  Two bound families, never conflated with parse ceilings (those are
561
561
  tighten-only decoder limits):
562
562
 
563
- - **Operational** (8 members, all REQUIRED — absent is
563
+ - **Operational** (8 members, all REQUIRED; absent is
564
564
  `missing_ceiling`, never infinity): `max_attempts`,
565
565
  `max_concurrency`, `max_cost`, `max_depth`, `max_descendants`,
566
566
  `max_elapsed_ms`, `max_fan_out`, `max_tokens`. Pointwise narrowest
@@ -573,7 +573,7 @@ tighten-only decoder limits):
573
573
  an acknowledge posture, which MUST always record evidence.
574
574
  Obligation families (authority, approval, effect impact) meet at the
575
575
  STRICTEST value; markers are retained regulatory obligations whose
576
- effective set is the UNION of sources — dropping one is a widening.
576
+ effective set is the UNION of sources; dropping one is a widening.
577
577
  Despite its name, `effect_impact_ceiling` is an obligation: the strictest
578
578
  value wins. It does not cap what a Blueprint declares. A Blueprint
579
579
  declaring `secret` with deployment and host values `ordinary` produces
@@ -658,14 +658,14 @@ complexity, reference, type and cardinality cases on `schema.validate_instance`.
658
658
  ## 10. Compatibility and binding
659
659
 
660
660
  A manifest's `blueprint_release` MUST bind to exactly one Blueprint
661
- content digest (digest equality only — no fuzzy match).
661
+ content digest (digest equality only; no fuzzy match).
662
662
  `build_identities` carry exact identities; compatibility verification
663
663
  MUST be identity-exact or deny: a range expression, missing entry, or
664
664
  duplicate denies (`compatibility_identity_inexact`,
665
665
  `compatibility_entry_missing`, `compatibility_duplicate_entry`).
666
666
  Binding verification is a pinned deny-ordered check including
667
667
  attestation freshness (`binding_attestation_stale`) and
668
- descriptor-digest equality (`binding_descriptor_mismatch` — the tool
668
+ descriptor-digest equality (`binding_descriptor_mismatch`: the tool
669
669
  rug-pull case).
670
670
 
671
671
  ## 11. Federation profile
@@ -711,7 +711,7 @@ Terminal Commitment digests task identity, terminal state, result
711
711
  digest, result classification, compatibility ref, authority-proof
712
712
  refs, and checkpoint-history commitment; ANY divergence between
713
713
  receipts for one task identity MUST deny
714
- `federation_terminal_conflict` — not just state divergence.
714
+ `federation_terminal_conflict`, not just state divergence.
715
715
  `Federation.verify_commitment` compares issuer/subject/audience
716
716
  against the receiving context (`audience_mismatch`). AgentCard
717
717
  signing carries a protobuf field-presence pre-normalization on top of
@@ -733,12 +733,12 @@ The hash preimage is UTF-8 `agent-blueprint-protocol/federation-envelope`,
733
733
  one zero octet, then UTF-8 JCS of that object. Corpus reference:
734
734
  the terminal-equivocation cases on `federation.verify_commitment`.
735
735
 
736
- ### Member grammar — Federation TaskEnvelope (23 members)
736
+ ### Member grammar: Federation TaskEnvelope (23 members)
737
737
 
738
738
  The reconstructed envelope is a closed world: one member per logical
739
739
  field. The carrier placement above supplies its native members and
740
740
  extension body before this grammar is applied. Cardinality `1` members are required;
741
- `0..1` members are optional (absent — there is no null form). The
741
+ `0..1` members are optional (absent; there is no null form). The
742
742
  machine-readable grammar ships as the CDDL artifact under
743
743
  `spec/grammar/` with the derived JSON Schema beside it. Cross-
744
744
  member hooks: `checkpoint_status` MUST NOT coexist with `terminal_state`
@@ -865,7 +865,7 @@ raised, the subject it names, and the host action it demands):
865
865
  | `unknown_member` | a member is outside the closed world | the member | reject the artifact |
866
866
  Plus the parameterized ceiling family `ceiling:<key>` over the eight
867
867
  decoder limit names. No authorization vocabulary exists in any
868
- identifier — no `unauthorized` in either polarity (source-scanned
868
+ identifier: no `unauthorized` in either polarity (source-scanned
869
869
  gate).
870
870
 
871
871
  Non-error notices (not members of the error-code union):
@@ -890,7 +890,7 @@ or receiving identity pins retain their existing absent-input meaning.
890
890
  canonical → digest → negotiation → structure → portability →
891
891
  signatures → bind → bounds, in that pinned order. Its result is an
892
892
  evidence record of per-surface checks, effective bounds, clamp evidence,
893
- and `not_verified` — which MUST be non-empty BY CONSTRUCTION, always
893
+ and `not_verified`, which MUST be non-empty BY CONSTRUCTION, always
894
894
  naming at least the seven host-owned surfaces this protocol structurally
895
895
  cannot establish: `tenancy`, `live_policy`, `authority`,
896
896
  `effect_ownership`, `execution`, `billing`, `evaluation_truth`. A
@@ -925,10 +925,10 @@ denies `invalid_constraint`.
925
925
 
926
926
  Portable artifacts MUST NOT contain secrets, private keys, live grants,
927
927
  tenant identifiers, raw endpoints, database primary keys, or backend
928
- engine identifiers — enforced structurally (member-name and value-shape
928
+ engine identifiers, enforced structurally (member-name and value-shape
929
929
  denylists over the open regions, at any depth, name-spelling-normalized)
930
930
  and red-cased per class in the corpus. A portability pass is not
931
- sufficiency — the guard is necessary, not sufficient: opaque
931
+ sufficiency; the guard is necessary, not sufficient: opaque
932
932
  quarantined extension bodies are typed as unscanned, and portability
933
933
  claims attach only to schema-validated content. Concrete provider/model
934
934
  names, credentials, engine ids, and endpoints resolve host-side and are
@@ -941,7 +941,7 @@ The package ships a portable conformance corpus (`priv/conformance/`):
941
941
  applicability floor, full-registry golden artifacts, RFC 8785 number
942
942
  vectors, and deterministic Ed25519 fixtures, at corpus digest
943
943
  `sha-256:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`. Corpus identity
944
- is the digest of the domain-separated index — versioned by digest, not
944
+ is the digest of the domain-separated index, versioned by digest, not
945
945
  by name. The loader is pure over an in-memory path-to-bytes map and verifies
946
946
  per-file hashes, exact file set (both directions), counts, id-uniqueness,
947
947
  and applicability totality; the report refuses a vacuous green. Each shipped
@@ -958,7 +958,7 @@ check with its own scanner, canonicalizer, and `node:crypto` Ed25519
958
958
  path; the release gate requires its report to be byte-identical to the
959
959
  Elixir escript's over both the repo corpus and the built archive's
960
960
  corpus. Mutation gates break the implementation at pinned
961
- points, including each reconcile stage and its order, and require the corpus to go red on each — a vacuous case set
961
+ points, including each reconcile stage and its order, and require the corpus to go red on each; a vacuous case set
962
962
  is a build failure. A `signature.verify` case whose signature decodes
963
963
  to 64 bytes also pins `expected.strict_signature`, the strict
964
964
  signature rule's verdict on those bytes (§6), and an implementation
@@ -971,7 +971,7 @@ backend already rejects the same bytes.
971
971
  The verifier class covers every applicable cell of the corpus. An
972
972
  implementation conforms at a release only when its complete results
973
973
  document for the release-certified corpus is byte-identical to the
974
- [certified results document](conformance/certified-results.json) shipped
974
+ certified results document at `spec/conformance/certified-results.json` shipped
975
975
  with that release. The [runner contract](conformance/runner.md) specifies
976
976
  the case format, dispatch, projections, integrity checks, and summary.
977
977
  The [execution protocol](conformance/execution.md) lets an external harness
@@ -986,7 +986,7 @@ or any host behavior. No producer conformance class is defined: producer
986
986
  round trips and wire validity are covered by verifier cases, not a
987
987
  separate claim of producer behavior.
988
988
 
989
- ## 16. The shipped surface (informative — the reference implementation)
989
+ ## 16. The shipped surface (informative: the reference implementation)
990
990
 
991
991
  The facade (`AgentBlueprintProtocol`) delegates and never implements;
992
992
  every public function carries a `@spec` (build-gated), every public module a
@@ -1017,62 +1017,55 @@ conformance); the engine knows tables, never domains.
1017
1017
  ### Producer surface
1018
1018
 
1019
1019
  Hosts that render artifacts produce them through the per-artifact
1020
- constructors, never through facade-level minting: compose the member
1021
- value, construct it with `Blueprint.from_value/2` or
1022
- `Deployment.from_value/2` (threading `:authored_extensions` for
1023
- critical namespaces whose bodies negotiation validated against a
1024
- digest-pinned schema; the caller supplies that provenance, and the constructor
1025
- checks membership in this artifact's critical region), compute the release identity with the
1026
- artifact's `content_digest/1`, and serialize with its
1027
- `canonical_bytes/1`. The round-trip property (decode → `to_value/1` →
1020
+ constructors, never through facade-level minting: compose the tagged JSON value with a well-formed provisional digest. Construct a draft with the artifact's `from_value/2`, compute `content_digest/1`, convert it with `Digest.to_tagged/1`, and replace the value's `content_digest` or `deployment_digest` member. Canonically encode the updated value and decode those bytes to validate the completed artifact. Sign the completed digest and recreate any signatures affected by the edit. Supply `:authored_extensions` from negotiation of that same value for critical namespaces whose bodies were validated against a digest-pinned schema; the constructor checks membership in this artifact's critical region. The round-trip property (decode → `to_value/1` →
1028
1021
  encode is a fixed point) is the byte-exactness guarantee a producer
1029
1022
  relies on. The conformance CLI emits a separate corpus-certification label on stderr
1030
1023
  without changing the canonical stdout report (§15). The facade stays a verification facade: it delegates and
1031
1024
  never implements, and no facade-level producer functions grow (the
1032
1025
  accepted producer-surface decision record).
1033
1026
 
1034
- ### The blueprint card (informative — a derived projection)
1027
+ ### The blueprint card (informative: a derived projection)
1035
1028
 
1036
1029
  A "blueprint card" is a DERIVED, non-normative projection of a
1037
1030
  Blueprint for discovery and display contexts: a small member set
1038
1031
  (typically the identity, producer, classification ceiling, a capability
1039
1032
  summary, and the content digest) extracted from VERIFIED artifact
1040
1033
  bytes. Three rules govern it. The full artifact remains the only
1041
- source of truth — a card asserts nothing the artifact does not, and
1034
+ source of truth; a card asserts nothing the artifact does not, and
1042
1035
  carries the content digest precisely so any reader can bind the
1043
1036
  summary back to the exact verified bytes. A card is never a conforming
1044
1037
  implementation surface: partial conformance is not conformance (the
1045
1038
  conformance clause), and nothing in this protocol verifies a card as a
1046
1039
  standalone artifact. Consumers either re-derive a card from bytes they
1047
1040
  verified themselves or treat one they received as unverified display
1048
- data — the same posture as any other pre-verification summary.
1041
+ data, the same posture as any other pre-verification summary.
1049
1042
 
1050
- ### The release-identity manifest (informative — the reference implementation)
1043
+ ### The release-identity manifest (informative: the reference implementation)
1051
1044
 
1052
1045
  The reference implementation ships
1053
1046
  `priv/release-metadata.json` (mirrored byte-identically inside its npm
1054
1047
  kit) as the machine-readable release identity. It is a versioned public
1055
- contract of the REFERENCE IMPLEMENTATION — not a conformance
1048
+ contract of the REFERENCE IMPLEMENTATION, not a conformance
1056
1049
  requirement: a third-party conformer publishes its own identity
1057
1050
  statement satisfying the conformance clause (§15). Within a
1058
- `manifest_version`, evolution is additive-only — fields are added,
1051
+ `manifest_version`, evolution is additive-only: fields are added,
1059
1052
  never removed, retyped, or resemanticized; a breaking shape change bumps
1060
1053
  `manifest_version` and is itself a release. The fields at manifest
1061
1054
  version 2: the format tag, the manifest version, the package name and
1062
1055
  version, the `verification_semantics_version` (§7's axis), the
1063
1056
  `digest_identity` label naming the closed digest scheme (RFC 8785 JCS
1064
1057
  canonical bytes; SHA-256; domain-separated preimages; tagged unpadded
1065
- base64url — unchanged across every release to date), the wire
1058
+ base64url, unchanged across every release to date), the wire
1066
1059
  `protocol_revisions_supported`, `prior_census_verdicts` (the certified
1067
1060
  compatibility matrix: per prior census digest,
1068
- `equivalent` — per-case verdict agreement, certified by replay; or
1069
- `diverged_by_registry_census` — divergences explained by registry
1061
+ `equivalent`: per-case verdict agreement, certified by replay; or
1062
+ `diverged_by_registry_census`: divergences explained by registry
1070
1063
  differences; or `not_equivalent`, an authored semantics-break claim), the
1071
1064
  specification, corpus, and registry digests, the corpus index hash, the
1072
1065
  verifier runtime floor, the verifier-kit identity (name, registry,
1073
1066
  version), and the archive-authorization stance. The companion
1074
1067
  `priv/release-history.json` carries one append-only row per manifest-era
1075
- release — the retroactive mapping a consumer binds when upgrading
1068
+ release: the retroactive mapping a consumer binds when upgrading
1076
1069
  between pins.
1077
1070
 
1078
1071
  ## 17. Security considerations (normative)
@@ -1101,7 +1094,7 @@ The non-authorizing boundary is itself a security property: every
1101
1094
  verification result is evidence, the `not_verified` set is non-empty by
1102
1095
  construction naming the host-owned surfaces, and no code path grants
1103
1096
  authority. Small-order Ed25519 keys reject; the package performs no key
1104
- discovery or trust selection — a wrong key is a typed denial, never a
1097
+ discovery or trust selection; a wrong key is a typed denial, never a
1105
1098
  silent pass.
1106
1099
 
1107
1100
  ## 18. Privacy considerations (normative)
@@ -1109,28 +1102,28 @@ silent pass.
1109
1102
  The portability guard is the protocol's data-minimization profile,
1110
1103
  stated as a normative constraint set: portable artifacts MUST NOT carry
1111
1104
  secrets, private keys, live grants, tenant identifiers, raw endpoints,
1112
- database primary keys, or backend engine identifiers — enforced
1105
+ database primary keys, or backend engine identifiers, enforced
1113
1106
  structurally at any depth (member-name and value-shape denylists,
1114
1107
  name-spelling-normalized) and exercised per class by the corpus
1115
1108
  (`forbidden_portable_value`). The honest limits are part of the
1116
1109
  contract: identifier-shaped values with the UUID grammar are exempt
1117
- by shape, so the guard is structural, not semantic — a tenant
1110
+ by shape, so the guard is structural, not semantic; a tenant
1118
1111
  identifier encoded as a UUID is not caught by the value-shape arm; quarantined extension bodies are typed as unscanned
1119
1112
  (`extension_unknown_optional_roundtrip` carries the round-trip
1120
1113
  obligation), and portability claims attach only to schema-validated
1121
- content — a producer MUST NOT present a portability pass as a privacy
1114
+ content; a producer MUST NOT present a portability pass as a privacy
1122
1115
  guarantee. Federation identity members (`issuer`, `subject`,
1123
1116
  `audience`, `identity_mapping_evidence`) are correlation material only:
1124
1117
  an authority-shaped claim in the evidence block denies
1125
1118
  `nonportable_content`, and possession of a key is never an identity
1126
1119
  claim.
1127
1120
 
1128
- ## 19. Positioning — protocol neighbors (informative)
1121
+ ## 19. Positioning: protocol neighbors (informative)
1129
1122
 
1130
1123
  The Agent Blueprint Protocol does not compete with the transport and
1131
1124
  discovery protocols; it completes them. AI Catalog owns discovery,
1132
1125
  verifiable identity, and attestation; A2A owns agent-to-agent tasks;
1133
- MCP owns tools and data. ABP owns the portable CONTRACT layer — the
1126
+ MCP owns tools and data. ABP owns the portable CONTRACT layer: the
1134
1127
  artifact that says what an agent is, what it may do (bounds, ceilings),
1135
1128
  what it must prove (evidence), and how a host verifies all of it
1136
1129
  fail-closed without granting authority. A blueprint rides IN A2A task
@@ -1228,7 +1221,7 @@ is failure. These rules add no host authorization or execution requirement.
1228
1221
  - [JSON Schema Core, draft 2020-12](https://json-schema.org/draft/2020-12/json-schema-core) and [Validation, draft 2020-12](https://json-schema.org/draft/2020-12/json-schema-validation); only the subset (protocol §9) applies.
1229
1222
  - [ECMA-262, sixth edition, June 2015](https://262.ecma-international.org/6.0/#sec-tostring-applied-to-the-number-type), number serialization (ECMA-262 §7.1.12.1) and its Note 2.
1230
1223
  - [A2A v1.0.1](https://github.com/a2aproject/A2A/releases/tag/v1.0.1), released May 2026, the federation mapping's released transport baseline.
1231
- - [MCP revision 2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28) and [Tasks extension v0.2.3, dated specification](https://github.com/modelcontextprotocol/ext-tasks/blob/v0.2.3/specification/2026-07-28/tasks.md). The Tasks lane remains draft-tracking while the extension is Beta.
1224
+ - [MCP revision 2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28) and [Tasks extension v0.2.3, dated specification](https://github.com/modelcontextprotocol/ext-tasks/blob/v0.2.3/specification/2026-07-28/tasks.md). The upstream Tasks contract remains draft-tracking while the extension is Beta; ABP's shipped mapping remains supported throughout 1.x under the stability policy (§20).
1232
1225
 
1233
1226
  ### Informative references
1234
1227
 
@@ -1,6 +1,6 @@
1
1
  // Two base64url decoders, mirroring the substrate's split (design note Q3b):
2
2
  //
3
- // - decodeStrict: the package codec's exact matrix (AgentBlueprintProtocol.Base64Url) —
3
+ // - decodeStrict: the package codec's exact matrix (AgentBlueprintProtocol.Base64Url):
4
4
  // `=` anywhere → `base64url_padded`; non-alphabet → `base64url_invalid`;
5
5
  // a spelling that is not the byte-exact encoding of its own decoded bytes
6
6
  // (impossible lengths, non-zero pad bits) → `base64url_invalid`.
@@ -50,3 +50,20 @@ export declare function verifyContentDigest(blueprint: Blueprint): VResult;
50
50
  export declare function scan(value: Value, authoredNs: Set<string>): VResult;
51
51
  export { attributes as signatureAttributes } from "./signature.ts";
52
52
  export declare function validZFormDate(stamped: string): boolean;
53
+ /** Sorted artifact vocabulary for a supported protocol revision. */
54
+ export declare function members(revision: unknown): {
55
+ ok: true;
56
+ v: string[];
57
+ subject?: undefined;
58
+ e?: undefined;
59
+ } | {
60
+ v?: undefined;
61
+ ok: false;
62
+ e: string;
63
+ subject: string[];
64
+ } | {
65
+ v?: undefined;
66
+ subject?: undefined;
67
+ ok: false;
68
+ e: string;
69
+ };
@@ -1,5 +1,5 @@
1
1
  import { isValue } from "./value.js";
2
- // The Blueprint artifact — the mirror of AgentBlueprintProtocol.Blueprint:
2
+ // The Blueprint artifact, the mirror of AgentBlueprintProtocol.Blueprint:
3
3
  // canonical verify → the 18-member registry table → the portability scan →
4
4
  // the content-digest comparison, over the digest-covered members minus the
5
5
  // evidence trio. The artifact tables share the signature parser for
@@ -327,7 +327,7 @@ function checkSchemaDocument(value) {
327
327
  return { ok: false, e: parsed.e };
328
328
  }
329
329
  // The purpose is the artifact's fact: the envelope parses AND must be
330
- // "blueprint" here — a deployment-purpose signature riding a Blueprint is a
330
+ // "blueprint" here; a deployment-purpose signature riding a Blueprint is a
331
331
  // wrong-position entry, denied as a table constraint.
332
332
  function checkSignatureIds(value) {
333
333
  if (value.t !== "arr")
@@ -561,7 +561,7 @@ export function scan(value, authoredNs) {
561
561
  return coreStrings;
562
562
  return scanEvidenceKeyIds(members);
563
563
  }
564
- // Extension bodies: names + strict values — EXCEPT negotiation-validated
564
+ // Extension bodies: names + strict values, EXCEPT negotiation-validated
565
565
  // critical namespaces. Schema documents and predicate operands: names +
566
566
  // exempting values.
567
567
  function scanOpenRegions(members, validatedNs) {
@@ -576,7 +576,7 @@ function scanOpenRegions(members, validatedNs) {
576
576
  }
577
577
  return { ok: true };
578
578
  }
579
- // The arbitrary-JSON operands a deterministic_predicate carries — open
579
+ // The arbitrary-JSON operands a deterministic_predicate carries: open
580
580
  // content in a digest-covered core position.
581
581
  function predicateOperands(members) {
582
582
  const out = [];
@@ -721,3 +721,11 @@ export function validZFormDate(stamped) {
721
721
  const lengths = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
722
722
  return day <= lengths[month - 1];
723
723
  }
724
+ /** Sorted artifact vocabulary for a supported protocol revision. */
725
+ export function members(revision) {
726
+ if (revision === 1)
727
+ return { ok: true, v: table().map(spec => spec.name).sort() };
728
+ if (typeof revision === 'number' && Number.isInteger(revision))
729
+ return { ok: false, e: 'protocol_revision_unsupported', subject: ['protocol_revision'] };
730
+ return { ok: false, e: 'invalid_type' };
731
+ }
@@ -1,4 +1,4 @@
1
- // Parse ceilings — the mirror of AgentBlueprintProtocol.Bounds: the immutable
1
+ // Parse ceilings, the mirror of AgentBlueprintProtocol.Bounds: the immutable
2
2
  // profile maxima and the tighten-only override rule (unknown key denies
3
3
  // `unknown_bound`; a non-positive, non-integer, or super-maximum value denies
4
4
  // `ceiling:<field>`).
@@ -1,4 +1,4 @@
1
- // The bounds algebra — the mirror of AgentBlueprintProtocol.BoundsAlgebra:
1
+ // The bounds algebra, the mirror of AgentBlueprintProtocol.BoundsAlgebra:
2
2
  // the pointwise narrowest intersection of three total bound sets over the
3
3
  // closed 13-bound vocabulary. Scope families meet at the written-order
4
4
  // minimum with marker-union retention; obligation families at the