@agent-blueprint-protocol/verifier 0.8.4 → 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.
- package/CHANGELOG.md +103 -0
- package/LICENSE +1 -1
- package/NOTICE +2 -2
- package/README.md +164 -255
- package/dist/corpus/cases/blueprint-decode.json +1 -1
- package/dist/corpus/cases/bounds-new.json +1 -1
- package/dist/corpus/cases/bounds_algebra-intersect.json +1 -1
- package/dist/corpus/cases/canonicalization-encode.json +1 -1
- package/dist/corpus/cases/deployment-decode.json +1 -1
- package/dist/corpus/cases/extension-resolve.json +1 -1
- package/dist/corpus/cases/federation-decode.json +1 -1
- package/dist/corpus/cases/federation-verify_commitment.json +1 -1
- package/dist/corpus/cases/json-decode.json +1 -1
- package/dist/corpus/cases/negotiation-negotiate.json +1 -1
- package/dist/corpus/cases/predicate.json +1 -0
- package/dist/corpus/cases/reconcile.json +1 -0
- package/dist/corpus/cases/schema-validate_instance.json +1 -1
- package/dist/corpus/cases/signature-verify.json +1 -1
- package/dist/corpus/index.json +1 -1
- package/dist/release-history.json +1 -0
- package/dist/release-metadata.json +1 -1
- package/dist/spec/FOUNDATION-TRANSITION.md +67 -0
- package/dist/spec/IPR.md +27 -0
- package/dist/spec/LICENSE +190 -0
- package/dist/spec/NOTICE +4 -0
- package/dist/spec/README.md +47 -0
- package/dist/spec/conformance/base64url-decode.schema.json +176 -0
- package/dist/spec/conformance/blueprint-decode.schema.json +280 -0
- package/dist/spec/conformance/bounds-new.schema.json +302 -0
- package/dist/spec/conformance/bounds_algebra-intersect.schema.json +457 -0
- package/dist/spec/conformance/canonicalization-encode.schema.json +280 -0
- package/dist/spec/conformance/case-file.schema.json +122 -0
- package/dist/spec/conformance/certified-results.json +1 -0
- package/dist/spec/conformance/claim.schema.json +52 -0
- package/dist/spec/conformance/compatibility-verify.schema.json +262 -0
- package/dist/spec/conformance/deployment-decode.schema.json +322 -0
- package/dist/spec/conformance/digest-tagged.schema.json +200 -0
- package/dist/spec/conformance/evidence.schema.json +249 -0
- package/dist/spec/conformance/execution.md +80 -0
- package/dist/spec/conformance/extension-resolve.schema.json +264 -0
- package/dist/spec/conformance/federation-decode.schema.json +318 -0
- package/dist/spec/conformance/federation-verify_commitment.schema.json +342 -0
- package/dist/spec/conformance/index.schema.json +102 -0
- package/dist/spec/conformance/json-decode.schema.json +287 -0
- package/dist/spec/conformance/negotiation-negotiate.schema.json +264 -0
- package/dist/spec/conformance/portability-scan.schema.json +188 -0
- package/dist/spec/conformance/predicate.schema.json +201 -0
- package/dist/spec/conformance/reconcile.schema.json +287 -0
- package/dist/spec/conformance/runner.md +182 -0
- package/dist/spec/conformance/schema-validate_instance.schema.json +206 -0
- package/dist/spec/conformance/signature-verify.schema.json +224 -0
- package/dist/spec/conformance/support.schema.json +72 -0
- package/dist/spec/errata.md +13 -0
- package/dist/spec/grammar/blueprint.cddl +92 -0
- package/dist/spec/grammar/deployment.cddl +125 -0
- package/dist/spec/grammar/derived/blueprint.schema.json +340 -0
- package/dist/spec/grammar/derived/deployment.schema.json +496 -0
- package/dist/spec/grammar/derived/taskenvelope.schema.json +244 -0
- package/dist/spec/grammar/taskenvelope.cddl +77 -0
- package/dist/spec/protocol.md +1238 -0
- package/dist/spec/registry/OPERATIONS.md +69 -0
- package/dist/spec/registry/registry.json +68 -0
- package/dist/verifier/b64url.js +1 -1
- package/dist/verifier/blueprint.d.ts +2 -15
- package/dist/verifier/blueprint.js +21 -107
- package/dist/verifier/bounds_algebra.d.ts +9 -0
- package/dist/verifier/bounds_algebra.js +6 -6
- package/dist/verifier/cli.js +14 -31
- package/dist/verifier/corpus.d.ts +1 -1
- package/dist/verifier/corpus.js +5 -1
- package/dist/verifier/decode.js +15 -3
- package/dist/verifier/deployment.d.ts +8 -0
- package/dist/verifier/deployment.js +17 -2
- package/dist/verifier/digest.js +1 -1
- package/dist/verifier/errors.d.ts +2 -0
- package/dist/verifier/errors.js +1 -0
- package/dist/verifier/execution.d.ts +13 -0
- package/dist/verifier/execution.js +82 -0
- package/dist/verifier/facade.d.ts +325 -0
- package/dist/verifier/facade.js +78 -0
- package/dist/verifier/federation.d.ts +2 -2
- package/dist/verifier/federation.js +10 -7
- package/dist/verifier/harness.d.ts +16 -0
- package/dist/verifier/harness.js +201 -0
- package/dist/verifier/index.d.ts +3 -0
- package/dist/verifier/index.js +2 -0
- package/dist/verifier/mapping.d.ts +139 -0
- package/dist/verifier/mapping.js +1 -0
- package/dist/verifier/negotiation.d.ts +2 -1
- package/dist/verifier/negotiation.js +6 -3
- package/dist/verifier/plain.d.ts +4 -0
- package/dist/verifier/plain.js +38 -0
- package/dist/verifier/predicate.d.ts +7 -0
- package/dist/verifier/predicate.js +60 -1
- package/dist/verifier/reconcile.d.ts +37 -0
- package/dist/verifier/reconcile.js +115 -0
- package/dist/verifier/registry.js +10 -1
- package/dist/verifier/registry_engine.d.ts +3 -0
- package/dist/verifier/registry_engine.js +8 -8
- package/dist/verifier/results.d.ts +3 -0
- package/dist/verifier/results.js +13 -0
- package/dist/verifier/runner.d.ts +2 -0
- package/dist/verifier/runner.js +115 -16
- package/dist/verifier/signature.d.ts +17 -6
- package/dist/verifier/signature.js +41 -25
- package/package.json +17 -12
|
@@ -18,10 +18,11 @@ import * as b64 from "./b64url.js";
|
|
|
18
18
|
import { encode } from "./canonical.js";
|
|
19
19
|
import * as digest from "./digest.js";
|
|
20
20
|
import { member, memberString } from "./corpus.js";
|
|
21
|
+
const HEADER_ALGORITHMS = new Set(["EdDSA", "Ed25519"]);
|
|
21
22
|
const PURPOSES = new Set(["blueprint", "deployment", "federation-envelope"]);
|
|
22
23
|
const CREATED_AT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
|
|
23
|
-
function malformed() {
|
|
24
|
-
return { ok: false, e: "signature_malformed" };
|
|
24
|
+
function malformed(subject = []) {
|
|
25
|
+
return { ok: false, e: "signature_malformed", subject };
|
|
25
26
|
}
|
|
26
27
|
export function verify(entry, keys) {
|
|
27
28
|
if (!Array.isArray(keys) || keys.some((key) => key === null || typeof key !== "object"))
|
|
@@ -30,7 +31,12 @@ export function verify(entry, keys) {
|
|
|
30
31
|
if (!parts.ok)
|
|
31
32
|
return parts;
|
|
32
33
|
const input = parts.v.headerB64 + "." + parts.v.payload;
|
|
33
|
-
|
|
34
|
+
const result = check(input, parts.v.signature, parts.v.keyId, keys);
|
|
35
|
+
return result.ok ? { ok: true, v: parts.v.attributes } : result;
|
|
36
|
+
}
|
|
37
|
+
export function attributes(entry) {
|
|
38
|
+
const parts = parseParts(entry);
|
|
39
|
+
return parts.ok ? { ok: true, v: parts.v.attributes } : parts;
|
|
34
40
|
}
|
|
35
41
|
export function signingInput(entry) {
|
|
36
42
|
const parts = parseParts(entry);
|
|
@@ -61,70 +67,73 @@ function parseParts(entry) {
|
|
|
61
67
|
}
|
|
62
68
|
const header = member(entry, "protected");
|
|
63
69
|
const attrs = member(entry, "signed_attributes");
|
|
64
|
-
// Header: exactly {alg, b64, crit, kid}; alg
|
|
70
|
+
// Header: exactly {alg, b64, crit, kid}; alg is EdDSA or Ed25519 (the twin's
|
|
65
71
|
// algorithm-unsupported denial in the header), b64 exactly false, crit
|
|
66
72
|
// exactly ["b64"], kid a non-empty string.
|
|
67
73
|
if (header.t !== "obj")
|
|
68
|
-
return malformed();
|
|
74
|
+
return malformed(["protected"]);
|
|
69
75
|
const headerNames = header.v.map(([k]) => k).sort();
|
|
70
76
|
if (headerNames.length !== 4 || headerNames.join() !== "alg,b64,crit,kid") {
|
|
71
|
-
return malformed();
|
|
77
|
+
return malformed(["protected"]);
|
|
72
78
|
}
|
|
73
79
|
const alg = member(header, "alg");
|
|
74
|
-
if (alg !== null && alg.t === "str" && alg.v
|
|
75
|
-
return { ok: false, e: "signature_algorithm_unsupported" };
|
|
80
|
+
if (alg !== null && alg.t === "str" && !HEADER_ALGORITHMS.has(alg.v)) {
|
|
81
|
+
return { ok: false, e: "signature_algorithm_unsupported", subject: ["protected"] };
|
|
76
82
|
}
|
|
77
83
|
if (alg === null || alg.t !== "str")
|
|
78
|
-
return malformed();
|
|
84
|
+
return malformed(["protected"]);
|
|
79
85
|
const b64Flag = member(header, "b64");
|
|
80
86
|
if (b64Flag === null || b64Flag.t !== "bool" || b64Flag.v !== false)
|
|
81
|
-
return malformed();
|
|
87
|
+
return malformed(["protected"]);
|
|
82
88
|
const crit = member(header, "crit");
|
|
83
89
|
if (crit === null ||
|
|
84
90
|
crit.t !== "arr" ||
|
|
85
91
|
crit.v.length !== 1 ||
|
|
86
92
|
crit.v[0].t !== "str" ||
|
|
87
93
|
crit.v[0].v !== "b64") {
|
|
88
|
-
return malformed();
|
|
94
|
+
return malformed(["protected"]);
|
|
89
95
|
}
|
|
90
96
|
const kid = member(header, "kid");
|
|
91
97
|
if (kid === null || kid.t !== "str" || kid.v === "")
|
|
92
|
-
return malformed();
|
|
98
|
+
return malformed(["protected"]);
|
|
93
99
|
// Attributes: exactly the five closed members.
|
|
94
100
|
if (attrs.t !== "obj")
|
|
95
|
-
return malformed();
|
|
101
|
+
return malformed(["signed_attributes"]);
|
|
96
102
|
const attrNames = attrs.v.map(([k]) => k).sort();
|
|
97
103
|
if (attrNames.length !== 5 ||
|
|
98
104
|
attrNames.join() !== "algorithm,content_digest,created_at,key_id,purpose") {
|
|
99
|
-
return malformed();
|
|
105
|
+
return malformed(["signed_attributes"]);
|
|
100
106
|
}
|
|
101
107
|
const algorithm = member(attrs, "algorithm");
|
|
102
108
|
if (algorithm !== null && algorithm.t === "str" && algorithm.v !== "Ed25519") {
|
|
103
|
-
return { ok: false, e: "signature_algorithm_unsupported" };
|
|
109
|
+
return { ok: false, e: "signature_algorithm_unsupported", subject: ["signed_attributes"] };
|
|
104
110
|
}
|
|
105
111
|
if (algorithm === null || algorithm.t !== "str")
|
|
106
|
-
return malformed();
|
|
112
|
+
return malformed(["signed_attributes"]);
|
|
107
113
|
const contentDigest = memberString(attrs, "content_digest");
|
|
108
|
-
if (contentDigest === null
|
|
109
|
-
return malformed();
|
|
114
|
+
if (contentDigest === null)
|
|
115
|
+
return malformed(["signed_attributes"]);
|
|
116
|
+
const parsedDigest = digest.fromTagged(contentDigest);
|
|
117
|
+
if (!parsedDigest.ok)
|
|
118
|
+
return malformed(["signed_attributes"]);
|
|
110
119
|
const createdAt = memberString(attrs, "created_at");
|
|
111
120
|
if (createdAt === null || !CREATED_AT.test(createdAt) || !validZFormDate(createdAt)) {
|
|
112
|
-
return malformed();
|
|
121
|
+
return malformed(["signed_attributes"]);
|
|
113
122
|
}
|
|
114
123
|
const keyId = memberString(attrs, "key_id");
|
|
115
|
-
if (keyId === null || keyId === ""
|
|
116
|
-
return malformed();
|
|
124
|
+
if (keyId === null || keyId === "")
|
|
125
|
+
return malformed(["signed_attributes"]);
|
|
117
126
|
const purpose = memberString(attrs, "purpose");
|
|
118
127
|
if (purpose === null || !PURPOSES.has(purpose))
|
|
119
|
-
return malformed();
|
|
128
|
+
return malformed(["signed_attributes"]);
|
|
120
129
|
if (kid.v !== keyId)
|
|
121
130
|
return malformed();
|
|
122
131
|
const signatureBody = member(entry, "signature");
|
|
123
132
|
if (signatureBody === null || signatureBody.t !== "str")
|
|
124
|
-
return malformed();
|
|
133
|
+
return malformed(["signature"]);
|
|
125
134
|
const decodedSignature = b64.decodeStrict(signatureBody.v);
|
|
126
135
|
if (!decodedSignature.ok || decodedSignature.v.length !== 64)
|
|
127
|
-
return malformed();
|
|
136
|
+
return malformed(["signature"]);
|
|
128
137
|
const headerJson = encode(header);
|
|
129
138
|
const attrsJson = encode(attrs);
|
|
130
139
|
if (!headerJson.ok || !attrsJson.ok)
|
|
@@ -136,6 +145,13 @@ function parseParts(entry) {
|
|
|
136
145
|
payload: attrsJson.v,
|
|
137
146
|
signature: decodedSignature.v,
|
|
138
147
|
keyId,
|
|
148
|
+
attributes: {
|
|
149
|
+
algorithm: "Ed25519",
|
|
150
|
+
contentDigest: parsedDigest.v,
|
|
151
|
+
createdAt,
|
|
152
|
+
keyId,
|
|
153
|
+
purpose: purpose,
|
|
154
|
+
},
|
|
139
155
|
},
|
|
140
156
|
};
|
|
141
157
|
}
|
|
@@ -169,7 +185,7 @@ function check(input, signature, keyId, keys) {
|
|
|
169
185
|
const inputBytes = Buffer.from(input, "utf8");
|
|
170
186
|
for (const key of usable) {
|
|
171
187
|
if (cryptoVerify(null, inputBytes, keyObject(key.key), signature)) {
|
|
172
|
-
return { ok: true
|
|
188
|
+
return { ok: true };
|
|
173
189
|
}
|
|
174
190
|
}
|
|
175
191
|
return { ok: false, e: "signature_not_verified" };
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-blueprint-protocol/verifier",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Installable verifier for the Agent Blueprint Protocol: canonical-bytes, digest, signature, bounds, and conformance-corpus verification. Non-authorizing
|
|
3
|
+
"version": "1.0.0-rc.1",
|
|
4
|
+
"description": "Installable verifier for the Agent Blueprint Protocol: canonical-bytes, digest, signature, bounds, and conformance-corpus verification. Non-authorizing — evidence, never a decision.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -16,21 +16,18 @@
|
|
|
16
16
|
"verifier": "dist/kit/cli.mjs"
|
|
17
17
|
},
|
|
18
18
|
"files": [
|
|
19
|
-
"dist",
|
|
19
|
+
"dist/verifier",
|
|
20
20
|
"!dist/verifier/self_checks.*",
|
|
21
|
+
"dist/kit",
|
|
22
|
+
"dist/corpus",
|
|
23
|
+
"dist/spec",
|
|
24
|
+
"dist/release-metadata.json",
|
|
25
|
+
"dist/release-history.json",
|
|
21
26
|
"README.md",
|
|
22
27
|
"CHANGELOG.md",
|
|
23
28
|
"LICENSE",
|
|
24
29
|
"NOTICE"
|
|
25
30
|
],
|
|
26
|
-
"scripts": {
|
|
27
|
-
"build": "tsc -p tsconfig.json && node scripts/build_kit.mjs",
|
|
28
|
-
"prepack": "npm run build"
|
|
29
|
-
},
|
|
30
|
-
"devDependencies": {
|
|
31
|
-
"@types/node": "^25.0.0",
|
|
32
|
-
"typescript": "^7.0.2"
|
|
33
|
-
},
|
|
34
31
|
"keywords": [
|
|
35
32
|
"agent",
|
|
36
33
|
"protocol",
|
|
@@ -39,5 +36,13 @@
|
|
|
39
36
|
"interoperability",
|
|
40
37
|
"mcp",
|
|
41
38
|
"a2a"
|
|
42
|
-
]
|
|
39
|
+
],
|
|
40
|
+
"exports": {
|
|
41
|
+
".": {
|
|
42
|
+
"types": "./dist/verifier/index.d.ts",
|
|
43
|
+
"import": "./dist/verifier/index.js"
|
|
44
|
+
},
|
|
45
|
+
"./package.json": "./package.json"
|
|
46
|
+
},
|
|
47
|
+
"types": "./dist/verifier/index.d.ts"
|
|
43
48
|
}
|