@agent-blueprint-protocol/verifier 1.0.0-rc.1 → 1.0.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.
@@ -93,7 +93,10 @@ Support members: `revisions` (integer array, default `[1]`), `core_fields`
93
93
  `schemas` (namespace-to-schema object). Registry-entry members: `owner`
94
94
  string, `criticality` string, `state` string, nullable `schema_digest` and
95
95
  `a2a_uri` strings, nullable integer `promoted_at_revision`. Absent overrides
96
- use the compiled registry. Schemas are digest-pinned by that registry.
96
+ use the compiled registry. A host-supplied entry resolves a namespace absent
97
+ from the compiled registry. For compiled entries, an override changes only
98
+ lifecycle state; criticality and schema digest remain compiled. Held schemas
99
+ must match the resolved entry's digest pin.
97
100
 
98
101
  Bound maps use the thirteen names in the protocol. Costs are
99
102
  `{amount,currency}`; classification is `{ordinal,markers}`; other protected
@@ -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:oYnkSmTkHGk4AmZ8Sul99_6KYJUIuj2SN2GZAiT1glw`, 604 cases) are
6
+ `sha-256:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`, 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
@@ -469,7 +469,7 @@ certified under a released census at the same verification-semantics version. **
469
469
  release's computational meaning for previously-certified inputs:
470
470
  canonicalization, digest computation, decode verdicts, bounds
471
471
  computation, negotiation outcomes, and signature verification behavior.
472
- A security correction or registry addition that moves a verdict is a
472
+ A security correction or registry change that moves a verdict is a
473
473
  verification-semantics change. A release that changes verification
474
474
  semantics MUST name it by incrementing the release's semantics version (the reference
475
475
  implementation carries it in its release manifest), and its release
@@ -491,9 +491,11 @@ federation namespace deprecation, and periods in detached signature key
491
491
  identifiers. Protocol revision remains 1. The release
492
492
  history records the increment; prior-census equivalence remains a per-case
493
493
  projection claim, not a claim that the public APIs are unchanged.
494
- The legacy federation namespace adds an `extension_deprecated` notice to
495
- `negotiation-estate-contract-valid`; its valid verdict and previously
496
- declared projection fields are unchanged.
494
+ Verification-semantics version 3 removes the five
495
+ product example registrations from the shipped registry. Hosts supply their own
496
+ registrations for those namespaces. Earlier censuses that relied on those
497
+ compiled entries diverge by the registry difference, as declared in the release
498
+ manifest and certified by replay. Protocol revision remains 1.
497
499
 
498
500
  Released identities are immutable: a published digest, corpus, registry,
499
501
  manifest, or release-history row is never mutated in place; a correction
@@ -503,21 +505,16 @@ replay), never over the input space at large.
503
505
 
504
506
  ## 8. Extension registry
505
507
 
506
- Namespace form: reverse-DNS-plus-path (`com.example.commerce/graph`),
508
+ Namespace form: reverse-DNS-plus-path (`com.example.vendor/record`),
507
509
  lowercase, one `/`, length-ceilinged, and not parseable as an absolute
508
510
  URI with a network authority (a namespace can never double as an
509
511
  endpoint). Registry content is release-governed data. The reference implementation
510
512
  compiles it into both libraries; that packaging choice is informative. The governance-canonical SOURCE is the specification
511
513
  tree's registry document (`spec/registry/registry.json`), bound to both
512
- compiled twins and the corpus index by the registry equality gate. Registered at this release:
514
+ compiled twins and the corpus index by the registry equality gate. The shipped protocol registrations are:
513
515
 
514
516
  | Namespace | Owner | Criticality | State |
515
517
  |---|---|---|---|
516
- | `com.example.commerce/graph` | ExampleCommerce | critical | active |
517
- | `com.example.commerce/classification-labels` | ExampleCommerce | optional | active |
518
- | `com.example.commerce/rubric-assertion` | ExampleCommerce | optional | active |
519
- | `com.example.platform/estate` | ExamplePlatform | optional | deprecated |
520
- | `com.example.platform/estate-contract` | ExamplePlatform | critical | active |
521
518
  | `com.example/federation` | Agent Blueprint Protocol | critical | deprecated |
522
519
  | `io.github.baselabs/federation` | Agent Blueprint Protocol | critical | active |
523
520
 
@@ -541,13 +538,12 @@ two-label restrictions are stricter than the MCP grammar. Prefixes whose second
541
538
  are reserved. The registry applies these rules at registration, without
542
539
  narrowing revision 1 artifact decoding.
543
540
 
544
- `com.example.platform/estate-contract` is the product-extension registration:
545
- the first product-owned critical namespace with an authored schema pin. The
546
- document ships as corpus data
547
- (`priv/conformance/schemas/estate-contract.schema.json`); `lib/` carries only
548
- the digest pin, test-bound to the shipped file. The deprecated
549
- `com.example.platform/estate` placeholder retains its optional bodies with a
550
- typed notice — existing artifacts stay verifiable.
541
+ The shipped registry contains only the protocol's federation registrations.
542
+ Hosts supply product and third-party registrations through negotiation support:
543
+ a namespace-keyed registry with criticality, lifecycle state, and schema digest,
544
+ plus the schema documents they hold. An unshipped namespace uses that host entry.
545
+ For a compiled entry, a host can supply lifecycle state but MUST NOT change its
546
+ criticality or schema pin. Both implementations expose this registration surface.
551
547
 
552
548
  Critical-extension bodies validate only against a host-supplied schema
553
549
  whose digest matches the registry's `schema_digest`; a missing schema
@@ -941,10 +937,10 @@ unrepresentable in self-fulfilling artifacts.
941
937
  ## 15. Conformance
942
938
 
943
939
  The package ships a portable conformance corpus (`priv/conformance/`):
944
- 604 cases covering every required cell of the 18-surface × 31-class
940
+ 626 cases covering every required cell of the 18-surface × 31-class
945
941
  applicability floor, full-registry golden artifacts, RFC 8785 number
946
942
  vectors, and deterministic Ed25519 fixtures, at corpus digest
947
- `sha-256:oYnkSmTkHGk4AmZ8Sul99_6KYJUIuj2SN2GZAiT1glw`. Corpus identity
943
+ `sha-256:0B_9tnAAo05n3bWVvnIPDxFeqEr2XhJoDdaxNJv0_9A`. Corpus identity
948
944
  is the digest of the domain-separated index — versioned by digest, not
949
945
  by name. The loader is pure over an in-memory path-to-bytes map and verifies
950
946
  per-file hashes, exact file set (both directions), counts, id-uniqueness,
@@ -1071,7 +1067,7 @@ base64url — unchanged across every release to date), the wire
1071
1067
  compatibility matrix: per prior census digest,
1072
1068
  `equivalent` — per-case verdict agreement, certified by replay; or
1073
1069
  `diverged_by_registry_census` — divergences explained by registry
1074
- growth; or `not_equivalent` — an authored semantics-break claim), the
1070
+ differences; or `not_equivalent`, an authored semantics-break claim), the
1075
1071
  specification, corpus, and registry digests, the corpus index hash, the
1076
1072
  verifier runtime floor, the verifier-kit identity (name, registry,
1077
1073
  version), and the archive-authorization stance. The companion
@@ -1164,6 +1160,9 @@ domains, and artifact member sets. Registry operations follow
1164
1160
 
1165
1161
  ### Evolution within a major version
1166
1162
 
1163
+ The namespace deprecation and non-retirement guarantee applies to registered
1164
+ entries shipped by the release. Hosts manage the lifecycle of their own entries.
1165
+
1167
1166
  A minor release MAY add the following opt-in capabilities. It MUST NOT
1168
1167
  change existing bytes, defaults, required inputs, or documented return
1169
1168
  contracts of existing calls:
@@ -1173,7 +1172,7 @@ contracts of existing calls:
1173
1172
  A new signature algorithm MUST enter through a new protocol revision.
1174
1173
  - Registered namespaces and federation profiles. An incompatible federation
1175
1174
  envelope MUST use a new registered critical namespace beside the existing
1176
- profiles; existing profiles MUST NOT retire during the major. The current
1175
+ profiles; existing shipped profiles MUST NOT retire during the major. The current
1177
1176
  envelope and commitment preimage remain unchanged.
1178
1177
  - Conformance surfaces and corpus cases. Each new corpus is a new census;
1179
1178
  claims against an earlier corpus digest remain valid for that digest.
@@ -1187,7 +1186,7 @@ unchanged. `ErrorCode` is closed for all of 1.x. A new mechanism MUST reuse
1187
1186
  an existing code whose meaning fits; otherwise it waits for the next major.
1188
1187
  Inputs certified under a released census MUST keep their verdicts at the
1189
1188
  same verification-semantics version. A security correction or registry
1190
- addition that moves a verdict MUST increment that version and declare it
1189
+ change that moves a verdict MUST increment that version and declare it
1191
1190
  in the release history, recording prior-census equivalence or divergence
1192
1191
  as specified in section 7. Artifact member sets and signed-byte formats
1193
1192
  for existing revisions, and the format of every released results document,
@@ -1,9 +1,18 @@
1
1
  # Registry operations process
2
2
 
3
- How namespaces enter and leave the compiled extension registry. The
4
- registry is governance-canonical in `registry.json` (this directory);
5
- the compiled counterparts (Elixir module and TypeScript verifier) are
6
- hand-mirrored and bound by the registry-equality gate.
3
+ The shipped registry contains the protocol's two federation registrations.
4
+ `registry.json` is its canonical source; the compiled Elixir and TypeScript
5
+ forms are bound to it by the registry equality check. Product and third-party
6
+ entries belong in the host support registry, not in these packages.
7
+
8
+ ## Host registrations
9
+
10
+ A host supplies a namespace-keyed entry through `Negotiation.Support.registry`
11
+ in Elixir or `Support.registry` in TypeScript. Each entry declares criticality
12
+ and lifecycle state, and a critical entry pins the canonical schema digest.
13
+ The host supplies the schema document through `schemas`. Namespaces absent from
14
+ the shipped registry resolve from this input. Overrides for shipped entries
15
+ can change only lifecycle state; compiled criticality and schema pins prevail.
7
16
 
8
17
  ## Qualification
9
18
 
@@ -11,19 +20,18 @@ A registration request MUST provide: the namespace (reverse-DNS-plus-
11
20
  path, not parseable as a network endpoint), an owner, the declared
12
21
  criticality, and, for critical namespaces, a schema document whose JCS
13
22
  digest is pinned. A request SHOULD state the A2A declaration URI.
14
- Example-class identities are the norm until a product is public.
23
+ Examples use generic reserved-domain identities.
15
24
 
16
25
  ## Registration steps
17
26
 
18
- 1. The owner submits the entry (and, for critical entries, the schema
27
+ 1. For a protocol-owned namespace, the owner submits the entry (and, for critical entries, the schema
19
28
  document) as a change to `registry.json` and implements it in both
20
29
  language packages.
21
30
  2. The registry-equality check, corpus checks, and CI checks must pass.
22
31
  Corpus verification fails when cases were generated for a different
23
32
  registry state.
24
33
  3. The change lands with a CHANGELOG entry and an ADR record when it
25
- sets a precedent (the product-extension registration is the
26
- recorded example).
34
+ sets a precedent.
27
35
 
28
36
  ## Lifecycle
29
37
 
@@ -31,7 +39,8 @@ Example-class identities are the norm until a product is public.
31
39
  critical declaration requires a protocol revision increment (the
32
40
  digest-covered evolution rule); demotion does not. A retired namespace
33
41
  is never reused. Deprecated entries retain verifiable artifacts with a
34
- typed notice.
42
+ typed notice. Entries the release ships deprecate and never retire within
43
+ 1.x. The retired state remains available for host-owned entries.
35
44
 
36
45
  ## Decision rights
37
46
 
@@ -1,51 +1,6 @@
1
1
  {
2
2
  "format": "agent-blueprint-protocol-registry",
3
3
  "entries": [
4
- {
5
- "a2a_uri": "https://example.com/extensions/commerce-graph",
6
- "criticality": "critical",
7
- "namespace": "com.example.commerce/graph",
8
- "owner": "ExampleCommerce",
9
- "promoted_at_revision": null,
10
- "schema_digest": null,
11
- "state": "active"
12
- },
13
- {
14
- "a2a_uri": "https://example.com/extensions/commerce-classification-labels",
15
- "criticality": "optional",
16
- "namespace": "com.example.commerce/classification-labels",
17
- "owner": "ExampleCommerce",
18
- "promoted_at_revision": null,
19
- "schema_digest": null,
20
- "state": "active"
21
- },
22
- {
23
- "a2a_uri": "https://example.com/extensions/commerce-rubric-assertion",
24
- "criticality": "optional",
25
- "namespace": "com.example.commerce/rubric-assertion",
26
- "owner": "ExampleCommerce",
27
- "promoted_at_revision": null,
28
- "schema_digest": null,
29
- "state": "active"
30
- },
31
- {
32
- "a2a_uri": "https://example.com/extensions/platform-estate",
33
- "criticality": "optional",
34
- "namespace": "com.example.platform/estate",
35
- "owner": "ExamplePlatform",
36
- "promoted_at_revision": null,
37
- "schema_digest": null,
38
- "state": "deprecated"
39
- },
40
- {
41
- "a2a_uri": "https://example.com/extensions/platform-estate-contract",
42
- "criticality": "critical",
43
- "namespace": "com.example.platform/estate-contract",
44
- "owner": "ExamplePlatform",
45
- "promoted_at_revision": null,
46
- "schema_digest": "sha-256:s_ToZWwxrhhd4vVxAyUh2Q6Gddston4tBSLHTLvCQAw",
47
- "state": "active"
48
- },
49
4
  {
50
5
  "a2a_uri": "https://example.com/extensions/federation",
51
6
  "criticality": "critical",
@@ -120,7 +120,7 @@ export interface PublicKey {
120
120
  readonly algorithm: 'ed25519';
121
121
  readonly key: Uint8Array;
122
122
  }
123
- /** Negotiation support and digest-pinned schema documents. */
123
+ /** Negotiation support with host registrations and held schema documents. Compiled entries preserve their criticality and schema pins. */
124
124
  export interface Support {
125
125
  readonly revisions: ReadonlySet<number>;
126
126
  readonly coreFields: ReadonlySet<string>;
@@ -191,20 +191,6 @@ export interface Inputs {
191
191
  readonly observations: Observations;
192
192
  }
193
193
  /** Receiving context for existing federation receipt verification. */
194
- export interface Context {
195
- readonly keys: readonly PublicKey[];
196
- readonly issuer?: string | null;
197
- readonly subject?: string | null;
198
- readonly audience?: string | null;
199
- readonly issuerKeySets?: Readonly<Record<string, readonly PublicKey[]>> | null;
200
- readonly createdAfter?: string | null;
201
- readonly createdBefore?: string | null;
202
- readonly priorReceipts: readonly {
203
- readonly taskIdentity: string;
204
- readonly terminalState: string;
205
- readonly terminalCommitment: string;
206
- }[];
207
- }
208
194
  /** Verified signed attributes, including the digest and purpose. */
209
195
  export interface SignedAttributes {
210
196
  readonly algorithm: SignatureAlgorithm;
@@ -1,8 +1,6 @@
1
- // The compiled-in extension registry twin: the six entries (five
2
- // first-release rows plus the estate-contract product registration) and
3
- // the federation schema, with the registry content digest the corpus binds
4
- // to. Agreement with the Elixir twin is proven by the corpus's own
5
- // registry_digest check at load — neither side reads the other's source.
1
+ // The protocol-owned federation registry and schema. Hosts supply other
2
+ // registrations through negotiation support. The corpus binds both runtimes
3
+ // to the same registry content digest.
6
4
  import * as digest from "./digest.js";
7
5
  import { encode } from "./canonical.js";
8
6
  import { bool, int, nil, obj, str } from "./value.js";
@@ -30,55 +28,6 @@ function taggedFederationDigest() {
30
28
  }
31
29
  function entries() {
32
30
  return [
33
- {
34
- namespace: "com.example.commerce/graph",
35
- owner: "ExampleCommerce",
36
- criticality: "critical",
37
- state: "active",
38
- schema_digest: null,
39
- a2a_uri: "https://example.com/extensions/commerce-graph",
40
- promoted_at_revision: null,
41
- },
42
- {
43
- namespace: "com.example.commerce/classification-labels",
44
- owner: "ExampleCommerce",
45
- criticality: "optional",
46
- state: "active",
47
- schema_digest: null,
48
- a2a_uri: "https://example.com/extensions/commerce-classification-labels",
49
- promoted_at_revision: null,
50
- },
51
- {
52
- namespace: "com.example.commerce/rubric-assertion",
53
- owner: "ExampleCommerce",
54
- criticality: "optional",
55
- state: "active",
56
- schema_digest: null,
57
- a2a_uri: "https://example.com/extensions/commerce-rubric-assertion",
58
- promoted_at_revision: null,
59
- },
60
- {
61
- namespace: "com.example.platform/estate",
62
- owner: "ExamplePlatform",
63
- criticality: "optional",
64
- state: "deprecated",
65
- schema_digest: null,
66
- a2a_uri: "https://example.com/extensions/platform-estate",
67
- promoted_at_revision: null,
68
- },
69
- {
70
- // The product-extension registration: the first product-owned critical
71
- // pin. The document is corpus data (schemas/estate-contract.schema.json);
72
- // this digest is JCS-of-parsed-document under the extension-schema
73
- // domain, bound to the shipped file by the Elixir pin test.
74
- namespace: "com.example.platform/estate-contract",
75
- owner: "ExamplePlatform",
76
- criticality: "critical",
77
- state: "active",
78
- schema_digest: "sha-256:s_ToZWwxrhhd4vVxAyUh2Q6Gddston4tBSLHTLvCQAw",
79
- a2a_uri: "https://example.com/extensions/platform-estate-contract",
80
- promoted_at_revision: null,
81
- },
82
31
  {
83
32
  namespace: "com.example/federation",
84
33
  owner: "Agent Blueprint Protocol",
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agent-blueprint-protocol/verifier",
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.",
3
+ "version": "1.0.0-rc.3",
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",
@@ -1 +0,0 @@
1
- {"$defs":{"and_over_leaf":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/leaf"},"minItems":1,"type":"array"},"op":{"const":"and"}},"required":["op","args"],"type":"object"},"and_over_tier_1":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_1"},"minItems":1,"type":"array"},"op":{"const":"and"}},"required":["op","args"],"type":"object"},"and_over_tier_2":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_2"},"minItems":1,"type":"array"},"op":{"const":"and"}},"required":["op","args"],"type":"object"},"definition_ref":{"additionalProperties":false,"properties":{"name":{"maxLength":128,"minLength":1,"type":"string"},"version":{"minimum":1,"type":"integer"}},"required":["name","version"],"type":"object"},"leaf":{"oneOf":[{"$ref":"#/$defs/leaf_present"},{"$ref":"#/$defs/leaf_stale"},{"$ref":"#/$defs/leaf_count_within"}]},"leaf_count_within":{"additionalProperties":false,"properties":{"days":{"minimum":1,"type":"integer"},"definition":{"$ref":"#/$defs/definition_ref"},"max":{"minimum":0,"type":"integer"},"op":{"const":"materialization_count_within"}},"required":["op","definition","days","max"],"type":"object"},"leaf_present":{"additionalProperties":false,"properties":{"definition":{"$ref":"#/$defs/definition_ref"},"op":{"const":"materialization_present"}},"required":["op","definition"],"type":"object"},"leaf_stale":{"additionalProperties":false,"properties":{"definition":{"$ref":"#/$defs/definition_ref"},"max_age_days":{"minimum":1,"type":"integer"},"op":{"const":"materialization_stale"}},"required":["op","definition","max_age_days"],"type":"object"},"not_over_leaf":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/leaf"},"maxItems":1,"minItems":1,"type":"array"},"op":{"const":"not"}},"required":["op","args"],"type":"object"},"not_over_tier_1":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_1"},"maxItems":1,"minItems":1,"type":"array"},"op":{"const":"not"}},"required":["op","args"],"type":"object"},"not_over_tier_2":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_2"},"maxItems":1,"minItems":1,"type":"array"},"op":{"const":"not"}},"required":["op","args"],"type":"object"},"or_over_leaf":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/leaf"},"minItems":1,"type":"array"},"op":{"const":"or"}},"required":["op","args"],"type":"object"},"or_over_tier_1":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_1"},"minItems":1,"type":"array"},"op":{"const":"or"}},"required":["op","args"],"type":"object"},"or_over_tier_2":{"additionalProperties":false,"properties":{"args":{"items":{"$ref":"#/$defs/tier_2"},"minItems":1,"type":"array"},"op":{"const":"or"}},"required":["op","args"],"type":"object"},"tier_1":{"oneOf":[{"$ref":"#/$defs/and_over_leaf"},{"$ref":"#/$defs/or_over_leaf"},{"$ref":"#/$defs/not_over_leaf"}]},"tier_2":{"oneOf":[{"$ref":"#/$defs/and_over_tier_1"},{"$ref":"#/$defs/or_over_tier_1"},{"$ref":"#/$defs/not_over_tier_1"}]},"tier_3":{"oneOf":[{"$ref":"#/$defs/and_over_tier_2"},{"$ref":"#/$defs/or_over_tier_2"},{"$ref":"#/$defs/not_over_tier_2"}]}},"additionalProperties":false,"properties":{"asset_materialization_window":{"additionalProperties":false,"properties":{"definition":{"$ref":"#/$defs/definition_ref"},"window_days":{"minimum":1,"type":["integer","null"]}},"required":["definition","window_days"],"type":"object"},"objective_condition":{"oneOf":[{"$ref":"#/$defs/leaf"},{"$ref":"#/$defs/tier_1"},{"$ref":"#/$defs/tier_2"},{"$ref":"#/$defs/tier_3"}]}},"required":["asset_materialization_window","objective_condition"],"type":"object"}