@agent-blueprint-protocol/verifier 0.8.3 → 1.0.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 (123) hide show
  1. package/CHANGELOG.md +137 -0
  2. package/LICENSE +1 -1
  3. package/NOTICE +2 -2
  4. package/README.md +164 -255
  5. package/dist/corpus/cases/blueprint-decode.json +1 -1
  6. package/dist/corpus/cases/bounds-new.json +1 -1
  7. package/dist/corpus/cases/bounds_algebra-intersect.json +1 -1
  8. package/dist/corpus/cases/canonicalization-encode.json +1 -1
  9. package/dist/corpus/cases/deployment-decode.json +1 -1
  10. package/dist/corpus/cases/extension-resolve.json +1 -1
  11. package/dist/corpus/cases/federation-decode.json +1 -1
  12. package/dist/corpus/cases/federation-verify_commitment.json +1 -1
  13. package/dist/corpus/cases/json-decode.json +1 -1
  14. package/dist/corpus/cases/negotiation-negotiate.json +1 -1
  15. package/dist/corpus/cases/predicate.json +1 -0
  16. package/dist/corpus/cases/reconcile.json +1 -0
  17. package/dist/corpus/cases/schema-validate_instance.json +1 -1
  18. package/dist/corpus/cases/signature-verify.json +1 -1
  19. package/dist/corpus/index.json +1 -1
  20. package/dist/kit/cli.mjs +1 -4
  21. package/dist/release-history.json +1 -0
  22. package/dist/release-metadata.json +1 -1
  23. package/dist/spec/FOUNDATION-TRANSITION.md +67 -0
  24. package/dist/spec/IPR.md +27 -0
  25. package/dist/spec/LICENSE +190 -0
  26. package/dist/spec/NOTICE +4 -0
  27. package/dist/spec/README.md +47 -0
  28. package/dist/spec/conformance/base64url-decode.schema.json +176 -0
  29. package/dist/spec/conformance/blueprint-decode.schema.json +280 -0
  30. package/dist/spec/conformance/bounds-new.schema.json +302 -0
  31. package/dist/spec/conformance/bounds_algebra-intersect.schema.json +457 -0
  32. package/dist/spec/conformance/canonicalization-encode.schema.json +280 -0
  33. package/dist/spec/conformance/case-file.schema.json +122 -0
  34. package/dist/spec/conformance/certified-results.json +1 -0
  35. package/dist/spec/conformance/claim.schema.json +52 -0
  36. package/dist/spec/conformance/compatibility-verify.schema.json +262 -0
  37. package/dist/spec/conformance/deployment-decode.schema.json +322 -0
  38. package/dist/spec/conformance/digest-tagged.schema.json +200 -0
  39. package/dist/spec/conformance/evidence.schema.json +249 -0
  40. package/dist/spec/conformance/execution.md +80 -0
  41. package/dist/spec/conformance/extension-resolve.schema.json +264 -0
  42. package/dist/spec/conformance/federation-decode.schema.json +318 -0
  43. package/dist/spec/conformance/federation-verify_commitment.schema.json +342 -0
  44. package/dist/spec/conformance/index.schema.json +102 -0
  45. package/dist/spec/conformance/json-decode.schema.json +287 -0
  46. package/dist/spec/conformance/negotiation-negotiate.schema.json +264 -0
  47. package/dist/spec/conformance/portability-scan.schema.json +188 -0
  48. package/dist/spec/conformance/predicate.schema.json +201 -0
  49. package/dist/spec/conformance/reconcile.schema.json +287 -0
  50. package/dist/spec/conformance/runner.md +182 -0
  51. package/dist/spec/conformance/schema-validate_instance.schema.json +206 -0
  52. package/dist/spec/conformance/signature-verify.schema.json +224 -0
  53. package/dist/spec/conformance/support.schema.json +72 -0
  54. package/dist/spec/errata.md +13 -0
  55. package/dist/spec/grammar/blueprint.cddl +92 -0
  56. package/dist/spec/grammar/deployment.cddl +125 -0
  57. package/dist/spec/grammar/derived/blueprint.schema.json +340 -0
  58. package/dist/spec/grammar/derived/deployment.schema.json +496 -0
  59. package/dist/spec/grammar/derived/taskenvelope.schema.json +244 -0
  60. package/dist/spec/grammar/taskenvelope.cddl +77 -0
  61. package/dist/spec/protocol.md +1238 -0
  62. package/dist/spec/registry/OPERATIONS.md +69 -0
  63. package/dist/spec/registry/registry.json +68 -0
  64. package/dist/verifier/b64url.d.ts +6 -2
  65. package/dist/verifier/b64url.js +7 -1
  66. package/dist/verifier/blueprint.d.ts +12 -16
  67. package/dist/verifier/blueprint.js +40 -112
  68. package/dist/verifier/bounds.d.ts +1 -1
  69. package/dist/verifier/bounds.js +2 -2
  70. package/dist/verifier/bounds_algebra.d.ts +9 -0
  71. package/dist/verifier/bounds_algebra.js +10 -7
  72. package/dist/verifier/canonical.d.ts +1 -1
  73. package/dist/verifier/canonical.js +41 -8
  74. package/dist/verifier/cli.js +97 -45
  75. package/dist/verifier/compatibility.js +5 -7
  76. package/dist/verifier/corpus.d.ts +1 -1
  77. package/dist/verifier/corpus.js +10 -2
  78. package/dist/verifier/decode.js +24 -6
  79. package/dist/verifier/deployment.d.ts +20 -3
  80. package/dist/verifier/deployment.js +48 -10
  81. package/dist/verifier/digest.d.ts +12 -0
  82. package/dist/verifier/digest.js +17 -3
  83. package/dist/verifier/errors.d.ts +2 -0
  84. package/dist/verifier/errors.js +1 -0
  85. package/dist/verifier/execution.d.ts +13 -0
  86. package/dist/verifier/execution.js +82 -0
  87. package/dist/verifier/extension.js +4 -4
  88. package/dist/verifier/facade.d.ts +325 -0
  89. package/dist/verifier/facade.js +78 -0
  90. package/dist/verifier/federation.d.ts +2 -2
  91. package/dist/verifier/federation.js +26 -79
  92. package/dist/verifier/harness.d.ts +16 -0
  93. package/dist/verifier/harness.js +201 -0
  94. package/dist/verifier/index.d.ts +3 -0
  95. package/dist/verifier/index.js +2 -0
  96. package/dist/verifier/mapping.d.ts +139 -0
  97. package/dist/verifier/mapping.js +1 -0
  98. package/dist/verifier/negotiation.d.ts +2 -1
  99. package/dist/verifier/negotiation.js +12 -3
  100. package/dist/verifier/plain.d.ts +4 -0
  101. package/dist/verifier/plain.js +38 -0
  102. package/dist/verifier/portability.d.ts +1 -1
  103. package/dist/verifier/portability.js +19 -6
  104. package/dist/verifier/predicate.d.ts +7 -0
  105. package/dist/verifier/predicate.js +63 -7
  106. package/dist/verifier/reconcile.d.ts +37 -0
  107. package/dist/verifier/reconcile.js +115 -0
  108. package/dist/verifier/registry.js +10 -1
  109. package/dist/verifier/registry_engine.d.ts +3 -0
  110. package/dist/verifier/registry_engine.js +37 -20
  111. package/dist/verifier/report.d.ts +8 -0
  112. package/dist/verifier/report.js +9 -2
  113. package/dist/verifier/results.d.ts +3 -0
  114. package/dist/verifier/results.js +13 -0
  115. package/dist/verifier/run_corpus.js +4 -80
  116. package/dist/verifier/runner.d.ts +6 -0
  117. package/dist/verifier/runner.js +123 -17
  118. package/dist/verifier/schema.js +14 -55
  119. package/dist/verifier/signature.d.ts +19 -8
  120. package/dist/verifier/signature.js +51 -29
  121. package/dist/verifier/value.d.ts +9 -2
  122. package/dist/verifier/value.js +81 -11
  123. package/package.json +17 -12
@@ -0,0 +1,47 @@
1
+ # Agent Blueprint Protocol — specification directory
2
+
3
+ This directory holds the normative specification of the Agent Blueprint
4
+ Protocol (`protocol.md`), kept deliberately self-contained: no build
5
+ tool, package manager, or repository context is needed to read it. The
6
+ license terms for this tree ship beside it (`LICENSE`, `NOTICE`).
7
+
8
+ ## Extraction
9
+
10
+ The specification is extraction-ready. The two paths that constitute a
11
+ standalone specification tree are this directory and the conformance
12
+ corpus:
13
+
14
+ ```bash
15
+ git filter-repo --path spec/ --path priv/conformance
16
+ ```
17
+
18
+ The result renders with no dangling references: the document cites the
19
+ conformance corpus and the extension registry **by digest** (the pinned
20
+ values inside `priv/conformance/index.json`, which extracts beside this
21
+ tree), never by a repository-relative path that would dangle once
22
+ extracted. The repository's own build asserts this on every run, and
23
+ its continuous-integration workflow re-proves the extraction against
24
+ the filter command above.
25
+
26
+ ## Release identity chain
27
+
28
+ Every release pins the specification and its evidence together:
29
+
30
+ | Field | Meaning |
31
+ |---|---|
32
+ | specification digest | SHA-256 over the framed, path-sorted files of this directory |
33
+ | package version | the reference-implementation release this specification certifies |
34
+ | corpus digest · registry digest | the conformance corpus and compiled registry this release ships |
35
+ | corpus index hash | SHA-256 of the corpus index bytes |
36
+ | manifest version | the SHAPE version of the release-identity manifest (additive-only within a version) |
37
+ | verification semantics version | the release's computational meaning for previously-certified inputs — the semantics/census split's axis (the specification's Evolution clause) |
38
+ | digest identity | the closed digest scheme (canonical bytes, hash, domain separation, wire form), stable across every release |
39
+ | compatibility matrix | the certified verdict per prior census digest, replay-certified by the reference implementation's gate |
40
+ | verifier kit identity | the npm kit's name and version, bound to the Hex line |
41
+
42
+ These values are pinned per release in the reference implementation's
43
+ release metadata and asserted from live state by its release-candidate
44
+ check; a disagreement anywhere in the chain blocks the release. The
45
+ companion release history (one append-only row per release, the
46
+ manifest era onward) is verified against each release tag's actual
47
+ tree by the compatibility gate.
@@ -0,0 +1,176 @@
1
+ {
2
+ "type": "object",
3
+ "properties": {
4
+ "surface": {
5
+ "const": "base64url.decode"
6
+ },
7
+ "input": {
8
+ "type": "object",
9
+ "properties": {
10
+ "base64url": {
11
+ "type": "string"
12
+ }
13
+ },
14
+ "required": [],
15
+ "additionalProperties": false
16
+ },
17
+ "expected": {
18
+ "oneOf": [
19
+ {
20
+ "type": "object",
21
+ "properties": {
22
+ "verdict": {
23
+ "const": "valid"
24
+ },
25
+ "decoded": {
26
+ "type": "string"
27
+ }
28
+ },
29
+ "required": [
30
+ "verdict"
31
+ ],
32
+ "additionalProperties": false
33
+ },
34
+ {
35
+ "type": "object",
36
+ "properties": {
37
+ "verdict": {
38
+ "const": "invalid"
39
+ },
40
+ "code": {
41
+ "enum": [
42
+ "attestation_malformed",
43
+ "audience_mismatch",
44
+ "base64url_invalid",
45
+ "base64url_padded",
46
+ "binding_attestation_stale",
47
+ "binding_descriptor_mismatch",
48
+ "binding_incomplete",
49
+ "bound_source_missing",
50
+ "bound_unit_mismatch",
51
+ "bound_unknown",
52
+ "bound_value_invalid",
53
+ "ceiling:bytes",
54
+ "ceiling:depth",
55
+ "ceiling:items",
56
+ "ceiling:key",
57
+ "ceiling:members",
58
+ "ceiling:nodes",
59
+ "ceiling:number_lexeme",
60
+ "ceiling:string",
61
+ "compatibility_duplicate_entry",
62
+ "compatibility_entry_missing",
63
+ "compatibility_identity_inexact",
64
+ "corpus_applicability_incomplete",
65
+ "corpus_case_id_duplicate",
66
+ "corpus_case_invalid",
67
+ "corpus_count_mismatch",
68
+ "corpus_empty",
69
+ "corpus_file_set_mismatch",
70
+ "corpus_hash_mismatch",
71
+ "corpus_index_invalid",
72
+ "deployment_digest_mismatch",
73
+ "digest_algorithm_unsupported",
74
+ "digest_encoding_invalid",
75
+ "digest_mismatch",
76
+ "duplicate_member",
77
+ "extension_criticality_conflict",
78
+ "extension_duplicate",
79
+ "extension_namespace_invalid",
80
+ "extension_payload_forbidden",
81
+ "extension_retired",
82
+ "extension_schema_digest_mismatch",
83
+ "extension_schema_unavailable",
84
+ "extension_unknown_critical",
85
+ "federation_mapping_conflict",
86
+ "federation_state_unmappable",
87
+ "federation_terminal_conflict",
88
+ "forbidden_portable_value",
89
+ "integer_magnitude",
90
+ "invalid_cardinality",
91
+ "invalid_constraint",
92
+ "invalid_encoding",
93
+ "invalid_number",
94
+ "invalid_syntax",
95
+ "invalid_type",
96
+ "lifecycle_state_invalid",
97
+ "missing_ceiling",
98
+ "missing_required_field",
99
+ "no_authoritative_recovery",
100
+ "non_canonical_bytes",
101
+ "nonportable_content",
102
+ "number_not_double_expressible",
103
+ "predicate_nodes_exceeded",
104
+ "predicate_op_unknown",
105
+ "predicate_path_unresolved",
106
+ "protected_bound_clamp_denied",
107
+ "protocol_revision_unsupported",
108
+ "required_core_field_not_digest_covered",
109
+ "required_core_field_unsupported",
110
+ "schema_complexity_exceeded",
111
+ "schema_dialect_unknown",
112
+ "schema_invalid_shape",
113
+ "schema_keyword_not_allowed",
114
+ "schema_keyword_value_invalid",
115
+ "schema_ref_cycle",
116
+ "schema_ref_unresolvable",
117
+ "signature_algorithm_unsupported",
118
+ "signature_key_unsupported",
119
+ "signature_malformed",
120
+ "signature_not_verified",
121
+ "trailing_bytes",
122
+ "unknown_bound",
123
+ "unknown_member"
124
+ ]
125
+ }
126
+ },
127
+ "required": [
128
+ "verdict",
129
+ "code"
130
+ ],
131
+ "additionalProperties": false
132
+ }
133
+ ]
134
+ },
135
+ "class": {
136
+ "enum": [
137
+ "valid",
138
+ "boundary_near",
139
+ "exact_bound",
140
+ "maximum_plus_one",
141
+ "invalid_encoding",
142
+ "invalid_duplicate",
143
+ "invalid_type",
144
+ "invalid_constraint",
145
+ "invalid_cardinality",
146
+ "unknown_member",
147
+ "tamper_meaningful_byte",
148
+ "digest_mismatch",
149
+ "signature_invalid",
150
+ "revision_above_max",
151
+ "revision_below_min",
152
+ "required_field_unsupported",
153
+ "required_field_not_covered",
154
+ "extension_unknown_critical",
155
+ "extension_unknown_optional_roundtrip",
156
+ "extension_criticality_conflict",
157
+ "extension_schema_unavailable",
158
+ "extension_deprecated_retained",
159
+ "bound_widening_operational",
160
+ "bound_widening_protected",
161
+ "forbidden_portable_value",
162
+ "compatibility_range_rejected",
163
+ "binding_stale",
164
+ "federation_state_unmappable",
165
+ "federation_terminal_conflict",
166
+ "audience_mismatch",
167
+ "terminal_equivocation"
168
+ ]
169
+ }
170
+ },
171
+ "required": [
172
+ "surface",
173
+ "input",
174
+ "expected"
175
+ ]
176
+ }
@@ -0,0 +1,280 @@
1
+ {
2
+ "type": "object",
3
+ "properties": {
4
+ "surface": {
5
+ "const": "blueprint.decode"
6
+ },
7
+ "input": {
8
+ "type": "object",
9
+ "properties": {
10
+ "text": {
11
+ "type": "string"
12
+ },
13
+ "base64url": {
14
+ "type": "string"
15
+ },
16
+ "raw_file": {
17
+ "type": "string"
18
+ },
19
+ "non_binary": {
20
+ "type": "boolean"
21
+ },
22
+ "bounds": {
23
+ "type": [
24
+ "null",
25
+ "boolean",
26
+ "object",
27
+ "array",
28
+ "number",
29
+ "string"
30
+ ],
31
+ "properties": {
32
+ "bytes": {
33
+ "type": [
34
+ "null",
35
+ "boolean",
36
+ "object",
37
+ "array",
38
+ "number",
39
+ "string"
40
+ ]
41
+ },
42
+ "depth": {
43
+ "type": [
44
+ "null",
45
+ "boolean",
46
+ "object",
47
+ "array",
48
+ "number",
49
+ "string"
50
+ ]
51
+ },
52
+ "members": {
53
+ "type": [
54
+ "null",
55
+ "boolean",
56
+ "object",
57
+ "array",
58
+ "number",
59
+ "string"
60
+ ]
61
+ },
62
+ "items": {
63
+ "type": [
64
+ "null",
65
+ "boolean",
66
+ "object",
67
+ "array",
68
+ "number",
69
+ "string"
70
+ ]
71
+ },
72
+ "nodes": {
73
+ "type": [
74
+ "null",
75
+ "boolean",
76
+ "object",
77
+ "array",
78
+ "number",
79
+ "string"
80
+ ]
81
+ },
82
+ "string": {
83
+ "type": [
84
+ "null",
85
+ "boolean",
86
+ "object",
87
+ "array",
88
+ "number",
89
+ "string"
90
+ ]
91
+ },
92
+ "key": {
93
+ "type": [
94
+ "null",
95
+ "boolean",
96
+ "object",
97
+ "array",
98
+ "number",
99
+ "string"
100
+ ]
101
+ },
102
+ "number_lexeme": {
103
+ "type": [
104
+ "null",
105
+ "boolean",
106
+ "object",
107
+ "array",
108
+ "number",
109
+ "string"
110
+ ]
111
+ }
112
+ }
113
+ },
114
+ "sha256_base64url": {
115
+ "type": "string"
116
+ }
117
+ },
118
+ "required": [],
119
+ "additionalProperties": false
120
+ },
121
+ "expected": {
122
+ "oneOf": [
123
+ {
124
+ "type": "object",
125
+ "properties": {
126
+ "verdict": {
127
+ "const": "valid"
128
+ },
129
+ "digest": {
130
+ "type": "string"
131
+ }
132
+ },
133
+ "required": [
134
+ "verdict"
135
+ ],
136
+ "additionalProperties": false
137
+ },
138
+ {
139
+ "type": "object",
140
+ "properties": {
141
+ "verdict": {
142
+ "const": "invalid"
143
+ },
144
+ "code": {
145
+ "enum": [
146
+ "attestation_malformed",
147
+ "audience_mismatch",
148
+ "base64url_invalid",
149
+ "base64url_padded",
150
+ "binding_attestation_stale",
151
+ "binding_descriptor_mismatch",
152
+ "binding_incomplete",
153
+ "bound_source_missing",
154
+ "bound_unit_mismatch",
155
+ "bound_unknown",
156
+ "bound_value_invalid",
157
+ "ceiling:bytes",
158
+ "ceiling:depth",
159
+ "ceiling:items",
160
+ "ceiling:key",
161
+ "ceiling:members",
162
+ "ceiling:nodes",
163
+ "ceiling:number_lexeme",
164
+ "ceiling:string",
165
+ "compatibility_duplicate_entry",
166
+ "compatibility_entry_missing",
167
+ "compatibility_identity_inexact",
168
+ "corpus_applicability_incomplete",
169
+ "corpus_case_id_duplicate",
170
+ "corpus_case_invalid",
171
+ "corpus_count_mismatch",
172
+ "corpus_empty",
173
+ "corpus_file_set_mismatch",
174
+ "corpus_hash_mismatch",
175
+ "corpus_index_invalid",
176
+ "deployment_digest_mismatch",
177
+ "digest_algorithm_unsupported",
178
+ "digest_encoding_invalid",
179
+ "digest_mismatch",
180
+ "duplicate_member",
181
+ "extension_criticality_conflict",
182
+ "extension_duplicate",
183
+ "extension_namespace_invalid",
184
+ "extension_payload_forbidden",
185
+ "extension_retired",
186
+ "extension_schema_digest_mismatch",
187
+ "extension_schema_unavailable",
188
+ "extension_unknown_critical",
189
+ "federation_mapping_conflict",
190
+ "federation_state_unmappable",
191
+ "federation_terminal_conflict",
192
+ "forbidden_portable_value",
193
+ "integer_magnitude",
194
+ "invalid_cardinality",
195
+ "invalid_constraint",
196
+ "invalid_encoding",
197
+ "invalid_number",
198
+ "invalid_syntax",
199
+ "invalid_type",
200
+ "lifecycle_state_invalid",
201
+ "missing_ceiling",
202
+ "missing_required_field",
203
+ "no_authoritative_recovery",
204
+ "non_canonical_bytes",
205
+ "nonportable_content",
206
+ "number_not_double_expressible",
207
+ "predicate_nodes_exceeded",
208
+ "predicate_op_unknown",
209
+ "predicate_path_unresolved",
210
+ "protected_bound_clamp_denied",
211
+ "protocol_revision_unsupported",
212
+ "required_core_field_not_digest_covered",
213
+ "required_core_field_unsupported",
214
+ "schema_complexity_exceeded",
215
+ "schema_dialect_unknown",
216
+ "schema_invalid_shape",
217
+ "schema_keyword_not_allowed",
218
+ "schema_keyword_value_invalid",
219
+ "schema_ref_cycle",
220
+ "schema_ref_unresolvable",
221
+ "signature_algorithm_unsupported",
222
+ "signature_key_unsupported",
223
+ "signature_malformed",
224
+ "signature_not_verified",
225
+ "trailing_bytes",
226
+ "unknown_bound",
227
+ "unknown_member"
228
+ ]
229
+ }
230
+ },
231
+ "required": [
232
+ "verdict",
233
+ "code"
234
+ ],
235
+ "additionalProperties": false
236
+ }
237
+ ]
238
+ },
239
+ "class": {
240
+ "enum": [
241
+ "valid",
242
+ "boundary_near",
243
+ "exact_bound",
244
+ "maximum_plus_one",
245
+ "invalid_encoding",
246
+ "invalid_duplicate",
247
+ "invalid_type",
248
+ "invalid_constraint",
249
+ "invalid_cardinality",
250
+ "unknown_member",
251
+ "tamper_meaningful_byte",
252
+ "digest_mismatch",
253
+ "signature_invalid",
254
+ "revision_above_max",
255
+ "revision_below_min",
256
+ "required_field_unsupported",
257
+ "required_field_not_covered",
258
+ "extension_unknown_critical",
259
+ "extension_unknown_optional_roundtrip",
260
+ "extension_criticality_conflict",
261
+ "extension_schema_unavailable",
262
+ "extension_deprecated_retained",
263
+ "bound_widening_operational",
264
+ "bound_widening_protected",
265
+ "forbidden_portable_value",
266
+ "compatibility_range_rejected",
267
+ "binding_stale",
268
+ "federation_state_unmappable",
269
+ "federation_terminal_conflict",
270
+ "audience_mismatch",
271
+ "terminal_equivocation"
272
+ ]
273
+ }
274
+ },
275
+ "required": [
276
+ "surface",
277
+ "input",
278
+ "expected"
279
+ ]
280
+ }