@agent-blueprint-protocol/verifier 0.8.1 → 0.8.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 +81 -0
- package/README.md +41 -15
- package/dist/release-metadata.json +1 -1
- package/dist/verifier/signature.js +6 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,87 @@
|
|
|
2
2
|
|
|
3
3
|
All notable public changes to `agent_blueprint_protocol` are documented here.
|
|
4
4
|
|
|
5
|
+
## [0.8.2] — 2026-11-05
|
|
6
|
+
|
|
7
|
+
### Fixed — documentation
|
|
8
|
+
|
|
9
|
+
- Correction to an earlier entry: bare `npx agent-blueprint-protocol` and
|
|
10
|
+
`npx verifier` work only where `@agent-blueprint-protocol/verifier` is
|
|
11
|
+
installed. Elsewhere, npx looks the bare name up on the public registry,
|
|
12
|
+
where it is not this project's. Use `npx @agent-blueprint-protocol/verifier`.
|
|
13
|
+
- The post-publish check runs `npx --no-install verifier`, so it can never
|
|
14
|
+
fetch the unrelated npm package named `verifier`.
|
|
15
|
+
|
|
16
|
+
### Added — documentation
|
|
17
|
+
|
|
18
|
+
- A Livebook walkthrough, `docs/livebooks/abp-walkthrough.livemd`,
|
|
19
|
+
shipped in the package and on HexDocs. It installs the package from
|
|
20
|
+
Hex, composes and signs a Blueprint, negotiates extensions, binds a
|
|
21
|
+
Deployment Manifest, reconciles the pair, runs the shipped corpus, and
|
|
22
|
+
shows each denial: a tampered signature, the wrong key, an unknown
|
|
23
|
+
`key_id`, a small-order key, an edited member, non-canonical bytes,
|
|
24
|
+
and the strict R and S rule. The test suite runs every cell in order
|
|
25
|
+
and compares each result with the output printed in the notebook.
|
|
26
|
+
- The README opens with a first-verification example, and the
|
|
27
|
+
TypeScript guide with an import example; the README example runs in
|
|
28
|
+
the guide mirror test, and the TypeScript one runs against the kit
|
|
29
|
+
as npm packs it (installed from the `npm pack` tarball) in a new
|
|
30
|
+
quality step, `mix typescript.guide`, which the doc-gates workflow also
|
|
31
|
+
runs.
|
|
32
|
+
|
|
33
|
+
### Changed — documentation
|
|
34
|
+
|
|
35
|
+
- The CI workflows' GitHub Action pins move with their dependabot bumps
|
|
36
|
+
(`actions/setup-node` v7.1.0, `actions/upload-pages-artifact` v5.0.0,
|
|
37
|
+
`actions/deploy-pages` v5.0.1); the toolchain lockstep test's pinned
|
|
38
|
+
setup-node identity moves with them. No workflow inputs changed.
|
|
39
|
+
- npm kit commands in the README, the TypeScript guide, and the landing
|
|
40
|
+
page stay unpinned, with a line saying npx runs the latest published
|
|
41
|
+
kit and how to check its version (a kit release goes live after a
|
|
42
|
+
maintainer approves its staged publish). The documentation-currency
|
|
43
|
+
gate requires the README's npm commands to stay unpinned.
|
|
44
|
+
- The document-citation gate now checks the guides under
|
|
45
|
+
`documentation/` and the Livebook (it skipped directory entries
|
|
46
|
+
before), and the version gate scans the Livebook.
|
|
47
|
+
- Corrected guide statements: the Deployment binding check has six
|
|
48
|
+
ordered stages, not three; the echo example has 16 members (the table
|
|
49
|
+
has 18); the kit has four modes and two bin names; the error guide
|
|
50
|
+
lists the `{:ceiling, key}` decoder-limit family; SECURITY.md names
|
|
51
|
+
the Security tab's **Report a vulnerability** form; the battery lists
|
|
52
|
+
in the README, CONTRIBUTING.md, and the operations guide name every
|
|
53
|
+
step; the evidence-commitments guide cites the AI Act articles it
|
|
54
|
+
relies on (12, 25(4), and 26) and points to Regulation (EU) 2026/1744,
|
|
55
|
+
which moved the high-risk application dates.
|
|
56
|
+
- The release-candidate reprove turns off git's automatic maintenance in
|
|
57
|
+
its scratch repositories, as does the privacy gate's throwaway
|
|
58
|
+
repository. From git 2.54, `git commit` starts a detached repack that
|
|
59
|
+
keeps writing into `.git` after the command returns; on hosted CI
|
|
60
|
+
(git 2.55) it raced the scratch cleanup and failed the check with
|
|
61
|
+
`could not remove files and directories recursively ... file already
|
|
62
|
+
exists`. A new architecture test requires every script or test that
|
|
63
|
+
commits in a scratch repository to set `maintenance.auto` false.
|
|
64
|
+
- Removed duplicated sentences from eighteen module docs. The comments
|
|
65
|
+
on small-order keys in `Signature` and the TypeScript verifier now say
|
|
66
|
+
exactly what the backends accept: under the identity key, R = identity
|
|
67
|
+
with S = 0 verifies for every message; under the all-zero key, the
|
|
68
|
+
all-zero signature verifies for about one message in four.
|
|
69
|
+
- The errata table's release boundaries now name the recording date
|
|
70
|
+
instead of a concrete version ("every release published before
|
|
71
|
+
2026-10-13 that ships this specification"), so each row stays true and
|
|
72
|
+
gate-clean at every later release without rewording. The corrections'
|
|
73
|
+
substance is unchanged; the specification digest moves with the
|
|
74
|
+
rewording (the digest covers the whole extracted specification,
|
|
75
|
+
errata included), which is recorded in the release history;
|
|
76
|
+
`verification_semantics_version` stays 1.
|
|
77
|
+
|
|
78
|
+
This is a documentation-only release; the public API, the registry, and
|
|
79
|
+
the corpus are unchanged from 0.8.1, and `spec/protocol.md` is
|
|
80
|
+
byte-identical. The test suite is 957 tests (63 properties) at 100%
|
|
81
|
+
coverage. Corpus: 129 cases, digest
|
|
82
|
+
`sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4`; registry
|
|
83
|
+
`sha-256:FG2f38K0hba8tTP7iUaw7vHjgcnN_5F5Mp0v4G6UDVs`; specification
|
|
84
|
+
digest `sha-256:aBgeih79woOR7YmJ_OBhyFgKU0j2euO-eieJKxLVDeA`.
|
|
85
|
+
|
|
5
86
|
## [0.8.1] — 2026-10-14
|
|
6
87
|
|
|
7
88
|
### Fixed
|
package/README.md
CHANGED
|
@@ -31,13 +31,32 @@ and evidence retention.
|
|
|
31
31
|
```elixir
|
|
32
32
|
def deps do
|
|
33
33
|
[
|
|
34
|
-
{:agent_blueprint_protocol, "~> 0.8.
|
|
34
|
+
{:agent_blueprint_protocol, "~> 0.8.2"}
|
|
35
35
|
]
|
|
36
36
|
end
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
The package has **zero production dependencies**, no application callback, and
|
|
40
|
-
no supervision tree.
|
|
40
|
+
no supervision tree. It requires Elixir 1.19 or newer on OTP 27, 28, or 29.
|
|
41
|
+
|
|
42
|
+
## A first verification
|
|
43
|
+
|
|
44
|
+
From a checkout of this repository (or with the example file fetched as
|
|
45
|
+
the [quickstart](documentation/quickstart.md) shows), decode the example
|
|
46
|
+
Blueprint, then watch a value that is not a Blueprint get a typed denial:
|
|
47
|
+
|
|
48
|
+
```elixir
|
|
49
|
+
bytes = File.read!("examples/echo-blueprint.json")
|
|
50
|
+
{:ok, blueprint} = AgentBlueprintProtocol.decode_blueprint(bytes)
|
|
51
|
+
AgentBlueprintProtocol.canonical_bytes(blueprint) == {:ok, bytes} # => true
|
|
52
|
+
{:ok, other} = AgentBlueprintProtocol.Canonicalization.encode({:object, [{"a", {:integer, 1}}]})
|
|
53
|
+
AgentBlueprintProtocol.decode_blueprint(other) # => {:error, :unknown_member}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
The quickstart runs this from a new Mix project, and the
|
|
57
|
+
[Livebook walkthrough](docs/livebooks/abp-walkthrough.livemd)
|
|
58
|
+
goes end to end: compose, sign, negotiate, reconcile, and the attacks that
|
|
59
|
+
fail closed.
|
|
41
60
|
|
|
42
61
|
## Installation (TypeScript)
|
|
43
62
|
|
|
@@ -51,6 +70,8 @@ npx @agent-blueprint-protocol/verifier # verify the embed
|
|
|
51
70
|
npx @agent-blueprint-protocol/verifier --artifact <file.json> # verify one artifact
|
|
52
71
|
```
|
|
53
72
|
|
|
73
|
+
npx runs the latest published kit; `npm view @agent-blueprint-protocol/verifier version` shows which.
|
|
74
|
+
|
|
54
75
|
See the [TypeScript quickstart](documentation/typescript.md) and the
|
|
55
76
|
[examples gallery](documentation/examples.md).
|
|
56
77
|
|
|
@@ -109,7 +130,7 @@ against its tags' actual trees.
|
|
|
109
130
|
## Status
|
|
110
131
|
|
|
111
132
|
The protocol API, schemas, canonicalization profile, extension registry,
|
|
112
|
-
and conformance corpus are implemented and gated:
|
|
133
|
+
and conformance corpus are implemented and gated: 957 tests
|
|
113
134
|
(63 properties) at 100% coverage, zero Dialyzer errors, `--strict`
|
|
114
135
|
Credo clean, a 129-case conformance corpus with a mutation gate, and a
|
|
115
136
|
byte-agreement gate against an independent second-language verifier.
|
|
@@ -159,12 +180,16 @@ mix deps.get
|
|
|
159
180
|
mix quality
|
|
160
181
|
```
|
|
161
182
|
|
|
162
|
-
`mix quality` runs dependency audits
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
183
|
+
`mix quality` runs dependency audits (retirement, the unused-lock-entry
|
|
184
|
+
check `deps.unlock --check-unused`, advisories, and dependency
|
|
185
|
+
currency), formatting, warnings-as-errors compilation, Credo,
|
|
186
|
+
tests with the 100% coverage threshold, the conformance corpus and its
|
|
187
|
+
mutation gate, the npm kit build, the TypeScript guide's import example,
|
|
188
|
+
the second-language verifier agreement gate, the compatibility replay, Dialyzer, documentation with
|
|
189
|
+
warnings-as-errors, the specification-extraction, grammar-derivation,
|
|
190
|
+
registry-equality, and release-asset gates, and the release-candidate
|
|
191
|
+
check (requirement-map completeness, specification coupling, and the
|
|
192
|
+
release identity chain). Every gate carries a recorded red proof — see the requirement map at
|
|
168
193
|
`docs/design/requirement-map.md` in this repository.
|
|
169
194
|
|
|
170
195
|
### Conformance corpus
|
|
@@ -200,11 +225,11 @@ compatibility, and federation semantics. Run it:
|
|
|
200
225
|
```bash
|
|
201
226
|
node verifier/cli.ts --corpus priv/conformance # exit 0/1/2, report bytes on stdout
|
|
202
227
|
node verifier/self_checks.ts # RFC 8785 Appendix B, window matrix,
|
|
203
|
-
|
|
204
|
-
mix verifier.agreement
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
228
|
+
# Ed25519 keys, stored JOSE vectors
|
|
229
|
+
mix verifier.agreement # byte-agrees the TS report with the
|
|
230
|
+
# escript's (repo AND built archive),
|
|
231
|
+
# runs the self-checks, and proves its
|
|
232
|
+
# seeded reds (planted breaks) fire
|
|
208
233
|
```
|
|
209
234
|
|
|
210
235
|
The agreement gate is part of `mix quality`: the two implementations must
|
|
@@ -217,7 +242,8 @@ Every guide ships in the package and renders on HexDocs:
|
|
|
217
242
|
|
|
218
243
|
- Start here: [getting started](documentation/getting-started.md) ·
|
|
219
244
|
[quickstart](documentation/quickstart.md) ·
|
|
220
|
-
[TypeScript quickstart](documentation/typescript.md)
|
|
245
|
+
[TypeScript quickstart](documentation/typescript.md) ·
|
|
246
|
+
[Livebook walkthrough](docs/livebooks/abp-walkthrough.livemd)
|
|
221
247
|
- Concepts: [what a blueprint is](documentation/what-a-blueprint-is.md) ·
|
|
222
248
|
[what a deployment is](documentation/what-a-deployment-is.md) ·
|
|
223
249
|
[portability](documentation/portability.md) ·
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"archive_is_publication_authorization":false,"corpus_digest":"sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4","digest_identity":"rfc8785-jcs+sha-256+domain-separated+base64url-unpadded","format":"agent-blueprint-protocol-release-metadata","index_sha256_base64url":"GKUP9TjzCWcyTCwYtEMWvFJNOWzztpY-aJBjm6vceZQ","manifest_version":2,"package":"agent_blueprint_protocol","package_version":"0.8.
|
|
1
|
+
{"archive_is_publication_authorization":false,"corpus_digest":"sha-256:WOZcBfvCW88L6TG_66vxG1fw0QN8cCXrJxveqHgI8a4","digest_identity":"rfc8785-jcs+sha-256+domain-separated+base64url-unpadded","format":"agent-blueprint-protocol-release-metadata","index_sha256_base64url":"GKUP9TjzCWcyTCwYtEMWvFJNOWzztpY-aJBjm6vceZQ","manifest_version":2,"package":"agent_blueprint_protocol","package_version":"0.8.2","prior_census_verdicts":{"sha-256:sg6Fo7p8nZpJDzxFn4dXHBWgbGvEvtOk-7t3m7OT7Yo":"equivalent","sha-256:vMyREM8ggUqVvGG0y2e4Gf-KmpksJjnx2eF8UjtpVP8":"equivalent"},"protocol_revisions_supported":[1],"registry_digest":"sha-256:FG2f38K0hba8tTP7iUaw7vHjgcnN_5F5Mp0v4G6UDVs","spec_digest":"sha-256:aBgeih79woOR7YmJ_OBhyFgKU0j2euO-eieJKxLVDeA","verification_semantics_version":1,"verifier_kit":{"name":"@agent-blueprint-protocol/verifier","registry":"npm","version":"0.8.2"},"verifier_runtime":"node>=24"}
|
|
@@ -2,9 +2,12 @@
|
|
|
2
2
|
// RFC 7515 compact + RFC 7797 b64=false unencoded detached payload, Ed25519
|
|
3
3
|
// via node:crypto (one-shot verify arg order on node ≥ 24 is
|
|
4
4
|
// (algorithm, data, key, signature) — probed on v25.9.0), and the
|
|
5
|
-
// small-order / off-curve public-key rejection the twin
|
|
6
|
-
//
|
|
7
|
-
// with
|
|
5
|
+
// small-order / off-curve public-key rejection the Elixir twin also
|
|
6
|
+
// carries, added after a live finding (:crypto accepts forgeries under small-order keys: under the
|
|
7
|
+
// identity key, R = identity with S = 0 verifies for every message; measured
|
|
8
|
+
// October 14, 2026, node:crypto on Node 22.23.1 accepts the same forgery and
|
|
9
|
+
// Node 24.19.0 rejects it — runtime-dependent, which is why the rule lives
|
|
10
|
+
// here), and the strict
|
|
8
11
|
// signature rule (R canonical and not small-order, S < L) checked before
|
|
9
12
|
// node:crypto, so the verdict never depends on the runtime's backend.
|
|
10
13
|
//
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-blueprint-protocol/verifier",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.2",
|
|
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.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|