@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.
Files changed (106) hide show
  1. package/CHANGELOG.md +103 -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/release-history.json +1 -0
  21. package/dist/release-metadata.json +1 -1
  22. package/dist/spec/FOUNDATION-TRANSITION.md +67 -0
  23. package/dist/spec/IPR.md +27 -0
  24. package/dist/spec/LICENSE +190 -0
  25. package/dist/spec/NOTICE +4 -0
  26. package/dist/spec/README.md +47 -0
  27. package/dist/spec/conformance/base64url-decode.schema.json +176 -0
  28. package/dist/spec/conformance/blueprint-decode.schema.json +280 -0
  29. package/dist/spec/conformance/bounds-new.schema.json +302 -0
  30. package/dist/spec/conformance/bounds_algebra-intersect.schema.json +457 -0
  31. package/dist/spec/conformance/canonicalization-encode.schema.json +280 -0
  32. package/dist/spec/conformance/case-file.schema.json +122 -0
  33. package/dist/spec/conformance/certified-results.json +1 -0
  34. package/dist/spec/conformance/claim.schema.json +52 -0
  35. package/dist/spec/conformance/compatibility-verify.schema.json +262 -0
  36. package/dist/spec/conformance/deployment-decode.schema.json +322 -0
  37. package/dist/spec/conformance/digest-tagged.schema.json +200 -0
  38. package/dist/spec/conformance/evidence.schema.json +249 -0
  39. package/dist/spec/conformance/execution.md +80 -0
  40. package/dist/spec/conformance/extension-resolve.schema.json +264 -0
  41. package/dist/spec/conformance/federation-decode.schema.json +318 -0
  42. package/dist/spec/conformance/federation-verify_commitment.schema.json +342 -0
  43. package/dist/spec/conformance/index.schema.json +102 -0
  44. package/dist/spec/conformance/json-decode.schema.json +287 -0
  45. package/dist/spec/conformance/negotiation-negotiate.schema.json +264 -0
  46. package/dist/spec/conformance/portability-scan.schema.json +188 -0
  47. package/dist/spec/conformance/predicate.schema.json +201 -0
  48. package/dist/spec/conformance/reconcile.schema.json +287 -0
  49. package/dist/spec/conformance/runner.md +182 -0
  50. package/dist/spec/conformance/schema-validate_instance.schema.json +206 -0
  51. package/dist/spec/conformance/signature-verify.schema.json +224 -0
  52. package/dist/spec/conformance/support.schema.json +72 -0
  53. package/dist/spec/errata.md +13 -0
  54. package/dist/spec/grammar/blueprint.cddl +92 -0
  55. package/dist/spec/grammar/deployment.cddl +125 -0
  56. package/dist/spec/grammar/derived/blueprint.schema.json +340 -0
  57. package/dist/spec/grammar/derived/deployment.schema.json +496 -0
  58. package/dist/spec/grammar/derived/taskenvelope.schema.json +244 -0
  59. package/dist/spec/grammar/taskenvelope.cddl +77 -0
  60. package/dist/spec/protocol.md +1238 -0
  61. package/dist/spec/registry/OPERATIONS.md +69 -0
  62. package/dist/spec/registry/registry.json +68 -0
  63. package/dist/verifier/b64url.js +1 -1
  64. package/dist/verifier/blueprint.d.ts +2 -15
  65. package/dist/verifier/blueprint.js +21 -107
  66. package/dist/verifier/bounds_algebra.d.ts +9 -0
  67. package/dist/verifier/bounds_algebra.js +6 -6
  68. package/dist/verifier/cli.js +14 -31
  69. package/dist/verifier/corpus.d.ts +1 -1
  70. package/dist/verifier/corpus.js +5 -1
  71. package/dist/verifier/decode.js +15 -3
  72. package/dist/verifier/deployment.d.ts +8 -0
  73. package/dist/verifier/deployment.js +17 -2
  74. package/dist/verifier/digest.js +1 -1
  75. package/dist/verifier/errors.d.ts +2 -0
  76. package/dist/verifier/errors.js +1 -0
  77. package/dist/verifier/execution.d.ts +13 -0
  78. package/dist/verifier/execution.js +82 -0
  79. package/dist/verifier/facade.d.ts +325 -0
  80. package/dist/verifier/facade.js +78 -0
  81. package/dist/verifier/federation.d.ts +2 -2
  82. package/dist/verifier/federation.js +10 -7
  83. package/dist/verifier/harness.d.ts +16 -0
  84. package/dist/verifier/harness.js +201 -0
  85. package/dist/verifier/index.d.ts +3 -0
  86. package/dist/verifier/index.js +2 -0
  87. package/dist/verifier/mapping.d.ts +139 -0
  88. package/dist/verifier/mapping.js +1 -0
  89. package/dist/verifier/negotiation.d.ts +2 -1
  90. package/dist/verifier/negotiation.js +6 -3
  91. package/dist/verifier/plain.d.ts +4 -0
  92. package/dist/verifier/plain.js +38 -0
  93. package/dist/verifier/predicate.d.ts +7 -0
  94. package/dist/verifier/predicate.js +60 -1
  95. package/dist/verifier/reconcile.d.ts +37 -0
  96. package/dist/verifier/reconcile.js +115 -0
  97. package/dist/verifier/registry.js +10 -1
  98. package/dist/verifier/registry_engine.d.ts +3 -0
  99. package/dist/verifier/registry_engine.js +8 -8
  100. package/dist/verifier/results.d.ts +3 -0
  101. package/dist/verifier/results.js +13 -0
  102. package/dist/verifier/runner.d.ts +2 -0
  103. package/dist/verifier/runner.js +115 -16
  104. package/dist/verifier/signature.d.ts +17 -6
  105. package/dist/verifier/signature.js +41 -25
  106. 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
- return check(input, parts.v.signature, parts.v.keyId, keys);
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 must be EdDSA (the twin's one
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 !== "EdDSA") {
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 || !digest.fromTagged(contentDigest).ok)
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 === "" || keyId.includes("."))
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, v: "verified" };
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.8.4",
4
- "description": "Installable verifier for the Agent Blueprint Protocol: canonical-bytes, digest, signature, bounds, and conformance-corpus verification. Non-authorizing \u2014 evidence, never a decision.",
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
  }