@agent-blueprint-protocol/verifier 1.0.1 → 1.1.0-rc.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.
- package/CHANGELOG.md +226 -194
- package/README.md +36 -15
- package/dist/examples/echo-blueprint.json +1 -0
- package/dist/examples/echo-deployment.json +1 -0
- package/dist/examples/extension-blueprint.json +1 -0
- package/dist/examples/federation-envelope.json +1 -0
- package/dist/examples/signed-blueprint.json +1 -0
- package/dist/release-history.json +1 -1
- package/dist/release-metadata.json +1 -1
- package/dist/spec/FOUNDATION-TRANSITION.md +9 -17
- package/dist/spec/IPR.md +1 -1
- package/dist/spec/README.md +2 -2
- package/dist/spec/conformance/runner.md +2 -2
- package/dist/spec/errata.md +1 -1
- package/dist/spec/grammar/blueprint.cddl +1 -1
- package/dist/spec/grammar/deployment.cddl +5 -3
- package/dist/spec/grammar/derived/deployment.schema.json +34 -21
- package/dist/spec/grammar/taskenvelope.cddl +1 -1
- package/dist/spec/protocol.md +86 -93
- package/dist/verifier/b64url.js +1 -1
- package/dist/verifier/blueprint.d.ts +17 -0
- package/dist/verifier/blueprint.js +12 -4
- package/dist/verifier/bounds.js +1 -1
- package/dist/verifier/bounds_algebra.js +1 -1
- package/dist/verifier/canonical.js +3 -3
- package/dist/verifier/cli.js +5 -5
- package/dist/verifier/compatibility.js +2 -2
- package/dist/verifier/corpus.js +2 -2
- package/dist/verifier/decode.js +4 -4
- package/dist/verifier/deployment.d.ts +17 -0
- package/dist/verifier/deployment.js +12 -4
- package/dist/verifier/digest.js +1 -1
- package/dist/verifier/extension.js +2 -2
- package/dist/verifier/facade.d.ts +6 -0
- package/dist/verifier/facade.js +6 -0
- package/dist/verifier/federation.d.ts +17 -0
- package/dist/verifier/federation.js +11 -3
- package/dist/verifier/mapping.d.ts +10 -10
- package/dist/verifier/mapping.js +1 -1
- package/dist/verifier/negotiation.js +4 -4
- package/dist/verifier/portability.js +2 -2
- package/dist/verifier/registry.js +1 -1
- package/dist/verifier/report.js +1 -1
- package/dist/verifier/runner.js +2 -2
- package/dist/verifier/schema.js +4 -4
- package/dist/verifier/signature.js +6 -6
- package/dist/verifier/value.js +3 -3
- package/package.json +3 -2
package/dist/spec/protocol.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# Agent Blueprint Protocol
|
|
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
|
|
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
|
|
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
|
|
34
|
+
- **Blueprint Core**: stable identity, typed ports, logical capability
|
|
35
35
|
requirements, bounds, evidence commitments, registered extensions.
|
|
36
|
-
- **Deployment Manifest
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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
|
|
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
|
|
481
|
+
previously-certified artifacts (for example a newly registered
|
|
482
482
|
critical namespace flipping `extension_unknown_critical` denials to
|
|
483
|
-
supported
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1041
|
+
data, the same posture as any other pre-verification summary.
|
|
1049
1042
|
|
|
1050
|
-
### The release-identity manifest (informative
|
|
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
|
|
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
|
|
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
|
|
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
|
|
1069
|
-
`diverged_by_registry_census
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
package/dist/verifier/b64url.js
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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
|
+
}
|
package/dist/verifier/bounds.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Parse ceilings
|
|
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
|
|
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
|