@passioncode-ai/fabric-agent-adapter 0.20.0 → 0.21.0

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 CHANGED
@@ -1,5 +1,70 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.21.0 - 2026-10-12
4
+
5
+ The estate record (contract DEC-0055, `estate-record/1`; contract backlog CT-18, CT-20) in both kits, and the pin
6
+ moved to contract `b291bf09e0a9f9fd3c16cf540832cd021203b7d1`, the merge of contract PR #54 (FAA-31).
7
+
8
+ ### Added
9
+
10
+ - **`fabric_estate.py` / `fabric-estate.mjs`** — the contract's `src/estate-record-rules.ts`, `src/webauthn.ts` and
11
+ `src/p256.ts`, ported answer for answer.
12
+ - **`verify_estate_record` / `verifyEstateRecord`.** The checks run in this order:
13
+ 1. the clock, checked first;
14
+ 2. the shape;
15
+ 3. the digest (RFC 8785, without `digest` and `signature`);
16
+ 4. the chain to the parent: estate, next revision, parent digest, issued no earlier, no revocation dropped;
17
+ 5. the signing passkey among the trusted ones and not revoked by the parent (rotation stays valid);
18
+ 6. the WebAuthn Level 3 assertion, offline: type, challenge, origin, cross-origin, RP ID hash, UP, UV, then the
19
+ ES256 or EdDSA signature under a validated key;
20
+ 7. the 30-day window;
21
+ 8. the record's own rules, which answer `rule-violation` with `codes`.
22
+
23
+ Dates are strict RFC 3339. Passkey JWK coordinates must be canonical base64url.
24
+ - **`estate_record_rules` / `estateRecordRules`** implement FAC-SEM-072…076 for `estate-record`,
25
+ `estate-record-revision` and `estate-placement`.
26
+ - **Also:** `placement_trust`, `estate_record_digest`, `estate_challenge` and `is_valid_p256_key` (SEC 1 §3.2.2).
27
+ - **The Python kit verifies ES256 in pure Python** (P-256, strict DER: minimal positive INTEGERs, nothing after
28
+ them, `r` and `s` below the group order). Its strictness matches OpenSSL's on a malleated, padded or trailing
29
+ signature; a test checks the two against each other.
30
+ - **Trusting a delegation key (DL-14, CT-20).**
31
+ - `verify_delegation`, `verify_approval` and `delegation_gate` (and their Node twins) take `estate`: the current
32
+ verified revision, or a function that returns it.
33
+ - A token's `kid` is trusted only while that revision certifies it for a machine (same `kid` and key), does not
34
+ revoke it, and is within its window. Otherwise the token is refused with `kid-not-certified`.
35
+ - A record that cannot be read certifies nothing: `issuer-unavailable` with `estate-unreadable`.
36
+ - Without `estate`, nothing changes.
37
+ - `hub_key_certified` / `hubKeyCertified` answers the question on its own.
38
+ - **Tests.**
39
+ - `test/fixtures/contract/estate-vectors.json` is generated by `make_estate_vectors.mjs` from the contract's own
40
+ functions and fixtures at the pin:
41
+ - 45 `verifyEstateRecord` cases, each re-answered against the contract's;
42
+ - 51 rule cases: the 38 semantic fixtures, the positive records, and strict-date and wrong-length edges;
43
+ - P-256 and passkey-key cases;
44
+ - the digest and challenge.
45
+
46
+ The private test keys of the contract's vectors are dropped: the kits only verify.
47
+ - Mutation testing: 42 planted defects, all caught.
48
+ - **Independent review.** Nothing critical. The ES256 verifier matched OpenSSL on 3,300 signatures, and the Node
49
+ port matched the contract's TypeScript on 470 extra inputs.
50
+ - **One divergence that mattered, now fixed:** Python's `\d` matched a full-width digit in a date. A Python machine
51
+ would have applied a revision the contract refuses. Dates now take ASCII digits only.
52
+ - **`Number()` follows JavaScript.** Its whitespace, `0b`/`0o`/`0x`, and arrays are read as JavaScript reads them.
53
+ - **A verdict, never an exception**, for three inputs: deeply nested client data, a 400-digit revision, and a lone
54
+ surrogate in a pinned RP ID.
55
+ - **New vectors from the contract cover these:** 24 more rule cases.
56
+ - **The docs now require** that `estate` is a verified revision, and the highest one applied, since the rule trusts
57
+ the record it is given.
58
+
59
+ ### Changed
60
+
61
+ - **The pin is `b291bf0`.** `0cacd08` stays supported. The compiled-schema checks pass for all three profiles against
62
+ the new pin.
63
+ - **The settings canonical form refuses a lone surrogate in any string or key** (CT-25, DEC-0052), in both kits,
64
+ answering the contract's refusal vectors.
65
+ - Docs: `references/estate-record.md` (new), `delegation.md` (*Keys the estate record certifies*), and `SKILL.md`.
66
+ The scenario eval `estate-record-and-certified-keys` and a trigger came first.
67
+
3
68
  ## 0.20.0 - 2026-10-12
4
69
 
5
70
  Runner routes in both kits: the closed probe results and the route checks FAC-SEM-028…034. These come from contract
package/README.md CHANGED
@@ -203,7 +203,7 @@ Scaffolding is non-destructive by default. It writes only the paths declared in
203
203
  The default pin for new bundles is [`fabric-contract.lock.json`](fabric-contract.lock.json):
204
204
 
205
205
  - version: `0.1.0`
206
- - commit: `0cacd08b0e95b6abf131eae1206b60792138bc3c`
206
+ - commit: `b291bf09e0a9f9fd3c16cf540832cd021203b7d1`
207
207
 
208
208
  Every other mention of the default contract revision — this section, the skills' metadata, the
209
209
  skill card, `adapt_project.py` — must equal it; `python3 test/validate.py` fails a tree
@@ -230,8 +230,8 @@ FABRIC_CONTRACT_OLD=/path/to/legacy-contract FABRIC_CONTRACT_NEW=/path/to/curren
230
230
  ```
231
231
 
232
232
  Without both environment variables, those tests explicitly skip as `NOT_RUN`.
233
- This source checkout is 0.20.0. 0.19.0 is the latest published GitHub/npm release (2026-10-12; 0.7.0 and 0.11.0
234
- were never released); 0.20.0 is published by its `v0.20.0` tag. Source delivery does not update installed skills or live sessions.
233
+ This source checkout is 0.21.0. 0.20.0 is the latest published GitHub/npm release (2026-10-12; 0.7.0 and 0.11.0
234
+ were never released); 0.21.0 is published by its `v0.21.0` tag. Source delivery does not update installed skills or live sessions.
235
235
 
236
236
  ## License
237
237
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@passioncode-ai/fabric-agent-adapter",
3
- "version": "0.20.0",
3
+ "version": "0.21.0",
4
4
  "description": "Create Fabric-compatible agents, run them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract. This package is the installer CLI.",
5
5
  "scripts": {
6
6
  "test": "python3 test/validate.py && python3 -m unittest discover -s test -q && node --test 'test/*.test.mjs'"
@@ -3,7 +3,7 @@
3
3
  "name": "fabric-agent-adapter",
4
4
  "displayName": "Fabric Agent Adapter",
5
5
  "description": "Create new Fabric-compatible agents, build them as always-alive local services with dashboards (fabric-service/0.1), and adapt existing projects to the Fabric Agent Contract through evidence-backed MCP, A2A, or local-runner provider bundles.",
6
- "version": "0.20.0",
6
+ "version": "0.21.0",
7
7
  "author": {
8
8
  "name": "PassionCode.ai",
9
9
  "url": "https://passioncode.ai/"
@@ -5,9 +5,9 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
5
5
  compatibility: Requires filesystem access and Python 3.9+. Exact schema checks additionally need git, Node.js, pnpm, and the pinned fabric-agent-contract checkout (a public repository). Works without those tools in an explicitly degraded structural-check mode.
6
6
  metadata:
7
7
  author: PassionCode.ai
8
- version: "0.20.0"
8
+ version: "0.21.0"
9
9
  contract-version: "0.1.0"
10
- contract-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
10
+ contract-commit: "b291bf09e0a9f9fd3c16cf540832cd021203b7d1"
11
11
  ---
12
12
 
13
13
  # Adapting projects to Fabric
@@ -70,7 +70,7 @@ Use exactly:
70
70
 
71
71
  - contract version `0.1.0`;
72
72
  - repository `https://github.com/passioncode-ai/fabric-agent-contract`;
73
- - commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`.
73
+ - commit `b291bf09e0a9f9fd3c16cf540832cd021203b7d1`.
74
74
 
75
75
  This is the default for new bundles. When checking an issued legacy bundle, preserve its
76
76
  explicit supported lock and use that exact clean checkout. Never silently upgrade or
@@ -21,10 +21,10 @@ import fabric_secrets as _secrets # noqa: E402 - the contract's credential dete
21
21
 
22
22
  CONTRACT_VERSION = "0.1.0"
23
23
  CONTRACT_REPOSITORY = "https://github.com/passioncode-ai/fabric-agent-contract"
24
- CONTRACT_COMMIT = "0cacd08b0e95b6abf131eae1206b60792138bc3c"
24
+ CONTRACT_COMMIT = "b291bf09e0a9f9fd3c16cf540832cd021203b7d1"
25
25
  # #region supported-contract-revisions — docs: README.md#contract-pin
26
26
  # Only this declaration may name a legacy revision in live files.
27
- SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "2eb91c00e852d9c31d804310d38fad91589fcbac", "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
27
+ SUPPORTED_CONTRACT_COMMITS = (CONTRACT_COMMIT, "0cacd08b0e95b6abf131eae1206b60792138bc3c", "2eb91c00e852d9c31d804310d38fad91589fcbac", "8e49fbd5fbbf230e32c1969cd24ac3c22422f0a5", "a83bec6b47776af688402c18efec507143061f68", "52da526d7cc1e063d74c5b520dbc03d0ace15246", "78b2da018d2c4bd9ac1bde1dc3b7f1a110a175f5", "623bf61358c339cb10297807b3f024b5d9f1f327", "23f9fda4c05f8a3852246ee98d4f2adf74ed0875", "9091d3d6606b0c4b5591a38c3674356a01fd7f55", "df55c8c54a23251342a7ee57ba95642b7eb39e61", "2ce392291c6668598d12cd38327e24696b5ca15c")
28
28
  # #endregion supported-contract-revisions
29
29
  INTEROP_KEY = "https://fabric.passioncode.ai/agent-contract/extensions/interop/0.1"
30
30
  MCP_REVISION = "2026-07-28"
@@ -16,10 +16,10 @@ license: AGPL-3.0-only OR LicenseRef-PassionCode-Commercial
16
16
  compatibility: Python 3.9+ or Node.js 20+ for the kits; the probe needs Python 3.9+. launchd steps are macOS-only; Linux services install a systemd user unit and Windows ones a per-user Scheduled Task with the kits' writers. Dashboard handoff optionally uses Fabric Dashboards MCP link/host_status/open; without it, report unresolved host capability. The contract checkout is optional.
17
17
  metadata:
18
18
  author: PassionCode.ai
19
- version: "0.20.0"
19
+ version: "0.21.0"
20
20
  contract-version: "0.1.0"
21
21
  extension: "fabric-service/0.1"
22
- extension-commit: "0cacd08b0e95b6abf131eae1206b60792138bc3c"
22
+ extension-commit: "b291bf09e0a9f9fd3c16cf540832cd021203b7d1"
23
23
  ---
24
24
 
25
25
  # Building Fabric services
@@ -83,7 +83,9 @@ are in [`scripts/fabric_interop.py`](scripts/fabric_interop.py) and
83
83
  [`scripts/fabric-interop.mjs`](scripts/fabric-interop.mjs). When the callers are agents of the estate, the
84
84
  service checks each call's delegation token (DEC-0039): read [the delegation reference](references/delegation.md);
85
85
  the verifier is [`scripts/fabric_delegation.py`](scripts/fabric_delegation.py) /
86
- [`scripts/fabric-delegation.mjs`](scripts/fabric-delegation.mjs). When Fabric chooses the service's runner and models
86
+ [`scripts/fabric-delegation.mjs`](scripts/fabric-delegation.mjs). A service on the operator's machines that
87
+ applies the estate record (DEC-0055) verifies each revision first and trusts only the keys it certifies: read
88
+ [the estate record reference](references/estate-record.md). When Fabric chooses the service's runner and models
87
89
  (DEC-0046), or a project routes its work through an ordered list of runners (DEC-0026: the doctor's closed probe
88
90
  results, the route checks FAC-SEM-028…034), read [the profiles reference](references/profiles.md).
89
91
 
@@ -16,6 +16,7 @@ contract's own verifier does.
16
16
  - Approvals
17
17
  - What a refusal looks like
18
18
  - Keys and the cache
19
+ - Keys the estate record certifies
19
20
  - What the kit does not do
20
21
 
21
22
  ## Declaring it
@@ -92,6 +93,19 @@ Python kit verifies Ed25519 itself (RFC 8032, standard library only, strict as O
92
93
  canonical points, no small-order key); it follows no redirect when it reads the key set; the Node kit uses `node:crypto` and refuses small-order keys
93
94
  itself (`isSmallOrderKey`), because Node before 26 lets OpenSSL accept a signature under one.
94
95
 
96
+ ## Keys the estate record certifies
97
+
98
+ A verifier that also reads the estate's record (DEC-0055, [the estate record reference](estate-record.md)) trusts a
99
+ `kid` only while a current revision certifies it for a machine and does not revoke it (DL-14). Pass the current
100
+ verified revision as `estate=` / `{ estate }`, as a value or as a function returning it, to `delegation_gate`,
101
+ `verify_delegation` or `verify_approval`.
102
+ - An uncertified `kid` is refused `unauthenticated` (`approval-invalid` for an approval), with detail
103
+ `kid-not-certified`.
104
+ - An unreadable record is refused `issuer-unavailable`, with detail `estate-unreadable`.
105
+ - Without `estate`, nothing changes.
106
+ - Pass only a revision `verify_estate_record` accepted, and the highest one the machine has applied. The rule trusts
107
+ what it is given, so an unverified or older revision would certify a key the current one revoked.
108
+
95
109
  ## What the kit does not do
96
110
 
97
111
  It does not mint tokens, check attenuation against a parent (the issuer's rule, DL-5), check a grant or a spend
@@ -0,0 +1,90 @@
1
+ # The estate record — what the operator's machines are, signed by their passkey (DEC-0055)
2
+
3
+ Fabric Agent Contract DEC-0055, `docs/specification/estate-record.md`, schema `schemas/estate-record.schema.json`,
4
+ rules `FAC-SEM-072…076`. One revision of one person's estate lists:
5
+ - the passkeys that sign it;
6
+ - the machines, with their device keys and a certificate of each machine's hub key;
7
+ - the packages placed on each machine;
8
+ - where each secret slot is filled from (by reference only);
9
+ - share grants and revocations.
10
+
11
+ A revision names its parent's digest and is signed by a passkey assertion (WebAuthn Level 3) over a challenge
12
+ derived from its own digest. Python: [`scripts/fabric_estate.py`](../scripts/fabric_estate.py). Node:
13
+ [`scripts/fabric-estate.mjs`](../scripts/fabric-estate.mjs). Both answer the contract's own vectors.
14
+
15
+ ## Contents
16
+
17
+ - Applying a revision
18
+ - Trusting a delegation key
19
+ - Checking a record you produce
20
+ - What the kit does not do
21
+
22
+ ## Applying a revision
23
+
24
+ A machine applies a revision only when it is valid against `estate-record.schema.json` **and** the verifier accepts
25
+ it. The verifier does not check the schema.
26
+
27
+ ```python
28
+ verdict = fe.verify_estate_record(record, at=datetime.now(timezone.utc), parent=current) # revision 2 and later
29
+ verdict = fe.verify_estate_record(record, at=now, authorities=pinned_passkeys) # revision 1
30
+ if verdict["ok"]:
31
+ current = record # verdict: digest, revision, signedBy, signCount
32
+ ```
33
+
34
+ ```js
35
+ const verdict = verifyEstateRecord(record, { at: new Date(), parent: current });
36
+ ```
37
+
38
+ It checks, in the order of the ER table:
39
+ 1. **The clock.** An unreadable one is `no-clock`, and it comes first.
40
+ 2. **The shape.**
41
+ 3. **The digest.** SHA-256 over the RFC 8785 form, without `digest` and `signature`.
42
+ 4. **The chain to the parent.** Same estate, the next revision number, the parent's digest, never issued before the
43
+ parent, and no revocation dropped.
44
+ 5. **The signer.** The signing passkey must be among the trusted ones and not revoked by the parent. A revision may
45
+ revoke its own signer: that is rotation.
46
+ 6. **The assertion.**
47
+ - Client data: type, challenge, origin, no cross-origin use.
48
+ - The RP ID hash, and the user-presence and user-verification flags.
49
+ - The signature: ES256 or EdDSA, under a key validated first (a valid P-256 point; an Ed25519 key of full order).
50
+ 7. **The window.** At most 30 days.
51
+ 8. **The record's own rules.** A violation is `rule-violation` with its `codes`.
52
+
53
+ Dates are strict RFC 3339: a `T`, an offset, and a day that exists. `:60` and a space are refused. Passkey JWK `x`
54
+ and `y` must be canonical base64url. The Python kit verifies ES256 in pure Python (P-256, strict DER), and the Node
55
+ kit through `node:crypto`.
56
+
57
+ ## Trusting a delegation key
58
+
59
+ A delegation verifier that reads the estate record trusts a token's `kid` only while a current revision certifies it
60
+ for a machine and does not revoke it (DL-14, contract CT-20). Give the gate the current verified revision, or a
61
+ function that returns it:
62
+
63
+ ```python
64
+ gate = fd.delegation_gate(audience=..., jwks=keys, issuer=..., effects=..., estate=lambda: current)
65
+ ```
66
+
67
+ - A `kid` the record does not certify is refused like an unknown key: `unauthenticated` (for an approval,
68
+ `approval-invalid`) with detail `kid-not-certified`. The same holds when the record names another key under that
69
+ kid, revokes it, or is outside its window.
70
+ - A record that cannot be read certifies nothing: `issuer-unavailable` with detail `estate-unreadable`.
71
+ - **What you pass in.** Pass only a revision that `verify_estate_record` accepted, and the highest revision the
72
+ machine has applied. The rule trusts the record it is given. A record nobody verified, or an older revision still
73
+ inside its window, would certify a key the current revision revoked (a rollback).
74
+ - `hub_key_certified(record, kid, x, at)` / `hubKeyCertified(...)` answers the question on its own.
75
+
76
+ ## Checking a record you produce
77
+
78
+ `estate_record_rules(kind, value)` / `estateRecordRules(kind, value)` are the contract's rules, finding for finding:
79
+ - `estate-record` (FAC-SEM-072…076);
80
+ - `estate-record-revision` `{parent, next}` (072);
81
+ - `estate-placement` `{record, machine, package}` (074, 075).
82
+
83
+ `placement_trust(record, machine, agentRef)` names the publisher keys a package verifier trusts for a placed package.
84
+
85
+ ## What the kit does not do
86
+
87
+ - It does not sign: it holds no passkey and no private key.
88
+ - It does not check the schema or verify packages.
89
+ - It does not attest the authenticator (an assertion carries no attestation).
90
+ - It does not track the signature counter: passkeys sync between devices.
@@ -1,6 +1,6 @@
1
1
  # fabric-service/0.1 — wire reference
2
2
 
3
- Pinned to `fabric-agent-contract` commit `0cacd08b0e95b6abf131eae1206b60792138bc3c`
3
+ Pinned to `fabric-agent-contract` commit `b291bf09e0a9f9fd3c16cf540832cd021203b7d1`
4
4
  (`docs/specification/service.md`, DEC-0015; the usage report DEC-0021; Windows and Linux supervision
5
5
  DEC-0032 and DEC-0033; the operator channel DEC-0034 and DEC-0035; the embedded dashboard DEC-0036;
6
6
  delegation and the operator session's lifetime DEC-0039; the meter's call window DEC-0041; session handoff DEC-0042;
@@ -14,6 +14,7 @@ import crypto from 'node:crypto';
14
14
  import fs from 'node:fs';
15
15
  import net from 'node:net';
16
16
  import path from 'node:path';
17
+ import { hubKeyCertified } from './fabric-estate.mjs';
17
18
 
18
19
  export const REFUSAL_CODES = Object.freeze([
19
20
  'unauthenticated', 'token-expired', 'wrong-audience', 'scope-not-granted', 'effect-above-ceiling', 'no-grant',
@@ -252,11 +253,30 @@ function approvalShape(payload) {
252
253
  * DL-13, in its fixed order: nothing about a token is believed before its signature is. `now` is seconds since
253
254
  * the epoch. Answers {ok: true, claims, principal, caller, chain, kid} or {ok: false, code, detail}.
254
255
  */
255
- export function verifyDelegation(token, { audience, jwks, now, capability, effect, issuer, readOnly } = {}) {
256
+ /**
257
+ * DL-14 with DEC-0055: a verifier that reads the estate record trusts a kid only while a current revision certifies it
258
+ * for a machine and does not revoke it. `estate` is a revision the caller verified (fabric-estate.mjs
259
+ * verifyEstateRecord) or a function returning the current one; undefined skips the rule. `[kind, detail]` or null.
260
+ */
261
+ function estateProblem(estate, jwks, kid, now) {
262
+ if (estate === undefined || estate === null) return null;
263
+ let record;
264
+ try {
265
+ record = typeof estate === 'function' ? estate() : estate;
266
+ } catch {
267
+ return ['issuer', 'estate-unreadable']; // an unreadable record certifies nothing; it is never a pass
268
+ }
269
+ const jwk = jwks.keys.find((candidate) => isObject(candidate) && candidate.kid === kid) ?? {};
270
+ return hubKeyCertified(record, kid, jwk.x, now) ? null : ['token', 'kid-not-certified'];
271
+ }
272
+
273
+ export function verifyDelegation(token, { audience, jwks, now, capability, effect, issuer, readOnly, estate } = {}) {
256
274
  if (!isString(issuer)) return refuse('issuer-unavailable', 'no-trusted-issuer');
257
275
  if (!hasKeys(jwks)) return refuse('issuer-unavailable', 'no-published-keys');
258
276
  const checked = authentic(token, jwks, DELEGATION_TYP);
259
277
  if ('problem' in checked) return refuse(checked.issuer ? 'issuer-unavailable' : 'unauthenticated', checked.problem);
278
+ const uncertified = estateProblem(estate, jwks, checked.kid, now);
279
+ if (uncertified) return refuse(uncertified[0] === 'issuer' ? 'issuer-unavailable' : 'unauthenticated', uncertified[1]);
260
280
  const shaped = delegationShape(checked.compact.payload);
261
281
  if ('problem' in shaped) return refuse('unauthenticated', shaped.problem);
262
282
  const { claims, depth } = shaped;
@@ -275,13 +295,15 @@ export function verifyDelegation(token, { audience, jwks, now, capability, effec
275
295
  }
276
296
 
277
297
  /** DL-18: approval-required carries the digest; any fault is approval-invalid; the jti is consumed last. */
278
- export function verifyApproval(approval, { audience, jwks, now, actionDigest: expected, issuer, jtiStore } = {}) {
298
+ export function verifyApproval(approval, { audience, jwks, now, actionDigest: expected, issuer, jtiStore, estate } = {}) {
279
299
  if (approval === undefined || approval === null || approval === '') return refuse('approval-required', 'no-approval', { actionDigest: expected });
280
300
  if (!isObject(jtiStore) || typeof jtiStore.consume !== 'function') return refuse('unknown-state', 'no-jti-store');
281
301
  if (!isString(issuer)) return refuse('issuer-unavailable', 'no-trusted-issuer');
282
302
  if (!hasKeys(jwks)) return refuse('issuer-unavailable', 'no-published-keys');
283
303
  const checked = authentic(approval, jwks, APPROVAL_TYP);
284
304
  if ('problem' in checked) return refuse(checked.issuer ? 'issuer-unavailable' : 'approval-invalid', checked.problem);
305
+ const uncertified = estateProblem(estate, jwks, checked.kid, now);
306
+ if (uncertified) return refuse(uncertified[0] === 'issuer' ? 'issuer-unavailable' : 'approval-invalid', uncertified[1]);
285
307
  const claims = approvalShape(checked.compact.payload);
286
308
  if (!claims) return refuse('approval-invalid', 'malformed-claims');
287
309
  if (claims.iss !== issuer) return refuse('approval-invalid', 'wrong-issuer');
@@ -447,7 +469,7 @@ export const TIERS = Object.freeze(['T0', 'T1', 'T2']);
447
469
  * relayed from off the machine). A T0 or T1 caller is never required to present a token: with none, the call passes
448
470
  * with no delegation. A present token is verified at every tier. `issuer` (auth.delegation.issuer) is required.
449
471
  */
450
- export function delegationGate({ audience, jwks, effects, issuer, readOnly = false, clock = () => Date.now() / 1000 }) {
472
+ export function delegationGate({ audience, jwks, effects, issuer, readOnly = false, clock = () => Date.now() / 1000, estate }) {
451
473
  if (!isString(issuer)) throw new Error('the gate needs the issuer it trusts (auth.delegation.issuer)');
452
474
  return async (tool, headers, tier = 'T2') => {
453
475
  const effect = effects?.[tool];
@@ -458,7 +480,7 @@ export function delegationGate({ audience, jwks, effects, issuer, readOnly = fal
458
480
  return refuse('unauthenticated', 'no-token');
459
481
  }
460
482
  const keys = jwks instanceof JwksCache ? await jwks.get(kidOf(carried.token)) : jwks;
461
- const verdict = verifyDelegation(carried.token, { audience, jwks: keys, now: clock(), capability: tool, effect, readOnly, issuer });
483
+ const verdict = verifyDelegation(carried.token, { audience, jwks: keys, now: clock(), capability: tool, effect, readOnly, issuer, estate });
462
484
  if (verdict.ok) verdict.tier = TIERS.includes(tier) ? tier : 'T2';
463
485
  return verdict;
464
486
  };