@agent-blueprint-protocol/verifier 1.1.0-rc.2 → 1.1.0-rc.3
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 +210 -548
- package/README.md +9 -9
- package/dist/corpus/cases/blueprint-decode.json +1 -1
- package/dist/corpus/cases/reconcile.json +1 -1
- package/dist/corpus/index.json +1 -1
- package/dist/corpus/vectors/blueprint-golden.json +1 -1
- package/dist/corpus/vectors/deployment-golden.json +1 -1
- package/dist/examples/signed-blueprint.json +1 -1
- package/dist/release-history.json +1 -1
- package/dist/release-metadata.json +1 -1
- package/dist/spec/FOUNDATION-TRANSITION.md +3 -28
- package/dist/spec/conformance/certified-results.json +1 -1
- package/dist/spec/grammar/blueprint.cddl +2 -6
- package/dist/spec/grammar/deployment.cddl +2 -4
- package/dist/spec/grammar/taskenvelope.cddl +2 -5
- package/dist/spec/protocol.md +13 -5
- package/dist/spec/registry/OPERATIONS.md +0 -11
- package/dist/verifier/facade.d.ts +3 -1
- package/dist/verifier/facade.js +2 -2
- package/dist/verifier/reconcile.d.ts +4 -1
- package/dist/verifier/reconcile.js +2 -2
- package/package.json +1 -1
|
@@ -1,10 +1,6 @@
|
|
|
1
1
|
; Agent Blueprint Protocol: Blueprint Core grammar (normative)
|
|
2
|
-
; RFC 8610 CDDL
|
|
3
|
-
;
|
|
4
|
-
; gate; sub-object closure remains the reference implementation's; the corpus goldens validate under the derived
|
|
5
|
-
; JSON Schema. By-key uniqueness (operation_family, logical_operation,
|
|
6
|
-
; name, value) is enforced by the reference implementation and is not
|
|
7
|
-
; expressible in JSON Schema; the members are marked unique in comments.
|
|
2
|
+
; RFC 8610 CDDL; JSON Schemas are derived from this grammar.
|
|
3
|
+
; By-key uniqueness is enforced by the reference implementation.
|
|
8
4
|
|
|
9
5
|
blueprint = {
|
|
10
6
|
blueprint_id: producer-qualified
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
; Agent Blueprint Protocol: Deployment Manifest grammar (normative)
|
|
2
|
-
; RFC 8610 CDDL
|
|
3
|
-
;
|
|
4
|
-
; uniqueness (name, logical_operation, logical_dataset, value) and the
|
|
5
|
-
; cross-field hooks are reference-implementation-enforced.
|
|
2
|
+
; RFC 8610 CDDL; JSON Schemas are derived from this grammar.
|
|
3
|
+
; By-key uniqueness and cross-field hooks are implementation-enforced.
|
|
6
4
|
|
|
7
5
|
deployment = {
|
|
8
6
|
protocol_revision: positive-integer
|
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
; Agent Blueprint Protocol: Federation TaskEnvelope grammar (normative)
|
|
2
|
-
; RFC 8610 CDDL
|
|
3
|
-
;
|
|
4
|
-
; Schema. Cross-member hooks (checkpoint_status vs terminal_state
|
|
5
|
-
; coexistence, terminal hook binding) are reference-implementation-
|
|
6
|
-
; enforced and noted here as comments.
|
|
2
|
+
; RFC 8610 CDDL; JSON Schemas are derived from this grammar.
|
|
3
|
+
; Cross-member hooks are enforced by the reference implementation.
|
|
7
4
|
|
|
8
5
|
taskenvelope = {
|
|
9
6
|
task_identity: identity-string
|
package/dist/spec/protocol.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
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
|
-
`sha-256:
|
|
6
|
+
`sha-256:uwbwaxugSBQKC_3Byy86_3N-Z6RBCBvW7rP79SGmSLE`, 626 cases) are
|
|
7
7
|
certified against this document at every release through the release
|
|
8
8
|
identity chain: the specification digest, the package version, and the
|
|
9
9
|
corpus and registry digests are pinned together per release, and the
|
|
@@ -496,6 +496,11 @@ product example registrations from the shipped registry. Hosts supply their own
|
|
|
496
496
|
registrations for those namespaces. Earlier censuses that relied on those
|
|
497
497
|
compiled entries diverge by the registry difference, as declared in the release
|
|
498
498
|
manifest and certified by replay. Protocol revision remains 1.
|
|
499
|
+
Verification-semantics version 4 makes the validity periods of the signing
|
|
500
|
+
key and the signature host-owned: reconcile lists `signature_time_validity`
|
|
501
|
+
in `not_verified` and never judges it. Reconcile outcomes certified under
|
|
502
|
+
earlier censuses differ by that entry, and the release manifest declares
|
|
503
|
+
the affected censuses not equivalent. Protocol revision remains 1.
|
|
499
504
|
|
|
500
505
|
Released identities are immutable: a published digest, corpus, registry,
|
|
501
506
|
manifest, or release-history row is never mutated in place; a correction
|
|
@@ -910,9 +915,12 @@ and both `now` and a maximum attestation age are supplied; a future-date
|
|
|
910
915
|
check alone does not establish staleness verification. Those skipped surfaces and every false
|
|
911
916
|
check surface join `not_verified`. Canonical checks on structs establish
|
|
912
917
|
encodability; they do not establish equality to unavailable received bytes.
|
|
913
|
-
`signature_created_at` and `
|
|
914
|
-
|
|
915
|
-
|
|
918
|
+
`signature_created_at`, `lifecycle_state`, and `signature_time_validity` MUST
|
|
919
|
+
appear in `not_verified`, in that order after the other host-owned facts.
|
|
920
|
+
The signature timestamp is signed and format-checked but never judged;
|
|
921
|
+
lifecycle state is shape-checked and never judged. The validity periods of
|
|
922
|
+
the signing key and the signature are host-owned and MUST NOT be judged by
|
|
923
|
+
reconcile.
|
|
916
924
|
|
|
917
925
|
Federation receipt verification separately supports the existing explicit
|
|
918
926
|
`created_after` and `created_before` receiving-context pins. Both are
|
|
@@ -940,7 +948,7 @@ The package ships a portable conformance corpus (`priv/conformance/`):
|
|
|
940
948
|
626 cases covering every required cell of the 18-surface × 31-class
|
|
941
949
|
applicability floor, full-registry golden artifacts, RFC 8785 number
|
|
942
950
|
vectors, and deterministic Ed25519 fixtures, at corpus digest
|
|
943
|
-
`sha-256:
|
|
951
|
+
`sha-256:uwbwaxugSBQKC_3Byy86_3N-Z6RBCBvW7rP79SGmSLE`. Corpus identity
|
|
944
952
|
is the digest of the domain-separated index, versioned by digest, not
|
|
945
953
|
by name. The loader is pure over an in-memory path-to-bytes map and verifies
|
|
946
954
|
per-file hashes, exact file set (both directions), counts, id-uniqueness,
|
|
@@ -22,17 +22,6 @@ criticality, and, for critical namespaces, a schema document whose JCS
|
|
|
22
22
|
digest is pinned. A request SHOULD state the A2A declaration URI.
|
|
23
23
|
Examples use generic reserved-domain identities.
|
|
24
24
|
|
|
25
|
-
## Registration steps
|
|
26
|
-
|
|
27
|
-
1. For a protocol-owned namespace, the owner submits the entry (and, for critical entries, the schema
|
|
28
|
-
document) as a change to `registry.json` and implements it in both
|
|
29
|
-
language packages.
|
|
30
|
-
2. The registry-equality check, corpus checks, and CI checks must pass.
|
|
31
|
-
Corpus verification fails when cases were generated for a different
|
|
32
|
-
registry state.
|
|
33
|
-
3. The change lands with a CHANGELOG entry and an ADR record when it
|
|
34
|
-
sets a precedent.
|
|
35
|
-
|
|
36
25
|
## Lifecycle
|
|
37
26
|
|
|
38
27
|
`reserved` → `active` → `deprecated` → `retired`. Promotion to a
|
|
@@ -29,6 +29,7 @@ export declare const KNOWN_EVIDENCE_SURFACES: Readonly<{
|
|
|
29
29
|
readonly evaluation_truth: 'evaluation_truth';
|
|
30
30
|
readonly signature_created_at: 'signature_created_at';
|
|
31
31
|
readonly lifecycle_state: 'lifecycle_state';
|
|
32
|
+
readonly signature_time_validity: 'signature_time_validity';
|
|
32
33
|
readonly binding_descriptors: 'binding_descriptors';
|
|
33
34
|
readonly binding_staleness: 'binding_staleness';
|
|
34
35
|
}>;
|
|
@@ -229,7 +230,8 @@ export interface Check {
|
|
|
229
230
|
readonly verified: boolean;
|
|
230
231
|
readonly detail: JsonValue;
|
|
231
232
|
}
|
|
232
|
-
/** Typed import evidence; its unverified surfaces never form an empty set.
|
|
233
|
+
/** Typed import evidence; its unverified surfaces never form an empty set.
|
|
234
|
+
* Time facts, including signing-key and signature validity periods, remain host-owned. */
|
|
233
235
|
export interface Evidence {
|
|
234
236
|
readonly protocol_revision: number | null;
|
|
235
237
|
readonly blueprint_digest: string | null;
|
package/dist/verifier/facade.js
CHANGED
|
@@ -16,7 +16,7 @@ import { toTagged } from './digest.js';
|
|
|
16
16
|
/** Known output identifiers; future values remain valid strings throughout 1.x. */
|
|
17
17
|
export const KNOWN_NOTICES = Object.freeze({ clamp_applied: 'clamp_applied', extension_deprecated: 'extension_deprecated', extension_retired: 'extension_retired', extension_unknown_optional_retained: 'extension_unknown_optional_retained' });
|
|
18
18
|
/** Known evidence surfaces, never an exhaustive proof checklist. */
|
|
19
|
-
export const KNOWN_EVIDENCE_SURFACES = Object.freeze({ canonical: 'canonical', digest: 'digest', negotiation: 'negotiation', structure: 'structure', portability: 'portability', signatures: 'signatures', extensions: 'extensions', bind: 'bind', bounds: 'bounds', compatibility: 'compatibility', tenancy: 'tenancy', live_policy: 'live_policy', authority: 'authority', effect_ownership: 'effect_ownership', execution: 'execution', billing: 'billing', evaluation_truth: 'evaluation_truth', signature_created_at: 'signature_created_at', lifecycle_state: 'lifecycle_state', binding_descriptors: 'binding_descriptors', binding_staleness: 'binding_staleness' });
|
|
19
|
+
export const KNOWN_EVIDENCE_SURFACES = Object.freeze({ canonical: 'canonical', digest: 'digest', negotiation: 'negotiation', structure: 'structure', portability: 'portability', signatures: 'signatures', extensions: 'extensions', bind: 'bind', bounds: 'bounds', compatibility: 'compatibility', tenancy: 'tenancy', live_policy: 'live_policy', authority: 'authority', effect_ownership: 'effect_ownership', execution: 'execution', billing: 'billing', evaluation_truth: 'evaluation_truth', signature_created_at: 'signature_created_at', lifecycle_state: 'lifecycle_state', signature_time_validity: 'signature_time_validity', binding_descriptors: 'binding_descriptors', binding_staleness: 'binding_staleness' });
|
|
20
20
|
/** Known binding check kinds; unknown kinds establish no familiar check. */
|
|
21
21
|
export const KNOWN_EVIDENCE_CHECK_KINDS = Object.freeze({ release_binding: 'release_binding', binding_completeness: 'binding_completeness', effect_recovery: 'effect_recovery', binding_descriptors: 'binding_descriptors', binding_staleness: 'binding_staleness' });
|
|
22
22
|
/** Known returned signature identifiers; verification inputs retain their strict types. */
|
|
@@ -62,7 +62,7 @@ export function verifyCompatibility(value, observed) {
|
|
|
62
62
|
if (!result.ok)
|
|
63
63
|
return result;
|
|
64
64
|
const entries = value.value.build_identities;
|
|
65
|
-
return { ok: true, v: { protocol_revision: value.value.protocol_revision, blueprint_digest: null, deployment_digest: null, effective_bounds: null, clamps: [], optional_extensions_retained: [], checks: entries.map((entry, index) => ({ surface: 'compatibility', subject: ['build_identities', index], verified: true, detail: entry.digest })), not_verified: [
|
|
65
|
+
return { ok: true, v: { protocol_revision: value.value.protocol_revision, blueprint_digest: null, deployment_digest: null, effective_bounds: null, clamps: [], optional_extensions_retained: [], checks: entries.map((entry, index) => ({ surface: 'compatibility', subject: ['build_identities', index], verified: true, detail: entry.digest })), not_verified: [...imports.HOST_OWNED] } };
|
|
66
66
|
});
|
|
67
67
|
}
|
|
68
68
|
/** Run the eight-stage import pass and return non-authorizing evidence. */
|
|
@@ -28,8 +28,11 @@ export interface Evidence {
|
|
|
28
28
|
effective_bounds: Record<string, unknown>;
|
|
29
29
|
clamps: unknown[];
|
|
30
30
|
optional_extensions_retained: string[];
|
|
31
|
-
not_verified: string[];
|
|
31
|
+
not_verified: (HostOwnedFact | (string & {}))[];
|
|
32
32
|
}
|
|
33
|
+
export declare const HOST_OWNED: readonly ['tenancy', 'live_policy', 'authority', 'effect_ownership', 'execution', 'billing', 'evaluation_truth', 'signature_created_at', 'lifecycle_state', 'signature_time_validity'];
|
|
34
|
+
/** Time facts are reported without judging clocks, key lifetimes, or signature lifetimes. */
|
|
35
|
+
export type HostOwnedFact = typeof HOST_OWNED[number];
|
|
33
36
|
export declare function reconcile(bp: blueprint.Blueprint, dep: deployment.Deployment, inputs: Inputs): {
|
|
34
37
|
ok: true;
|
|
35
38
|
v: Evidence;
|
|
@@ -8,7 +8,7 @@ import { validate } from './registry_engine.js';
|
|
|
8
8
|
import { member, memberString } from './corpus.js';
|
|
9
9
|
import { plain, jsonValue } from './plain.js';
|
|
10
10
|
import { isValue } from './value.js';
|
|
11
|
-
const HOST_OWNED = ['tenancy', 'live_policy', 'authority', 'effect_ownership', 'execution', 'billing', 'evaluation_truth'];
|
|
11
|
+
export const HOST_OWNED = ['tenancy', 'live_policy', 'authority', 'effect_ownership', 'execution', 'billing', 'evaluation_truth', 'signature_created_at', 'lifecycle_state', 'signature_time_validity'];
|
|
12
12
|
const CLASSIFICATION = ['public', 'internal', 'confidential', 'restricted'];
|
|
13
13
|
function failure(e, subject = []) { return { ok: false, e, subject }; }
|
|
14
14
|
function lift(bp) {
|
|
@@ -111,5 +111,5 @@ export function reconcile(bp, dep, inputs) {
|
|
|
111
111
|
const clamps = jsonValue(bounds.v.clamps.map(c => ({ field: c.field, class: c.cls, unit: c.cls === 'protected' ? 'ordinal' : c.field === 'max_cost' ? 'money' : c.field === 'max_elapsed_ms' ? 'millisecond' : c.field === 'max_tokens' ? 'token' : 'count', requested: c.requested, effective: c.effective, source: c.source, acknowledged: c.acknowledged }))).map((c) => { delete c.cls; return c; });
|
|
112
112
|
for (const clamp of clamps)
|
|
113
113
|
checked('bounds', clamp.field, true, clamp);
|
|
114
|
-
return { ok: true, v: { protocol_revision: plain(member(bp.value, 'protocol_revision')), blueprint_digest: blueprint.contentDigest(bp), deployment_digest: deployment.contentDigest(dep), checks, effective_bounds: bounds.v.effective, clamps, optional_extensions_retained: [...new Set(outcomes.flatMap(o => o.optionalRetained))], not_verified: [...new Set([...HOST_OWNED,
|
|
114
|
+
return { ok: true, v: { protocol_revision: plain(member(bp.value, 'protocol_revision')), blueprint_digest: blueprint.contentDigest(bp), deployment_digest: deployment.contentDigest(dep), checks, effective_bounds: bounds.v.effective, clamps, optional_extensions_retained: [...new Set(outcomes.flatMap(o => o.optionalRetained))], not_verified: [...new Set([...HOST_OWNED, ...checks.flatMap(c => c.verified ? [] : [c.surface]), ...skipped])] } };
|
|
115
115
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-blueprint-protocol/verifier",
|
|
3
|
-
"version": "1.1.0-rc.
|
|
3
|
+
"version": "1.1.0-rc.3",
|
|
4
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": {
|