@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.
@@ -1,10 +1,6 @@
1
1
  ; Agent Blueprint Protocol: Blueprint Core grammar (normative)
2
- ; RFC 8610 CDDL. This grammar's root member set and required flags are
3
- ; cross-read against the compiled registry table by the derivation
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. Bound to the compiled registry table by the derivation gate
3
- ; (root member set + required flags cross-read); corpus goldens validate under the derived JSON Schema. By-key
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. Bound to the compiled federation table by the derivation
3
- ; gate (member names cross-read); corpus goldens validate under the derived JSON
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
@@ -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:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`, 626 cases) are
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 `lifecycle_state` are always unverified by
914
- reconcile. The timestamp is signed and format-checked but never judged;
915
- lifecycle state is shape-checked and never judged.
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:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`. Corpus identity
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;
@@ -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: ['tenancy', 'live_policy', 'authority', 'effect_ownership', 'execution', 'billing', 'evaluation_truth'] } };
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, 'signature_created_at', 'lifecycle_state', ...checks.flatMap(c => c.verified ? [] : [c.surface]), ...skipped])] } };
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.2",
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": {