@kya-os/checkpoint-shared 1.3.0 → 1.4.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.
Files changed (58) hide show
  1. package/CHANGELOG.md +112 -0
  2. package/dist/beacon-types/index.d.mts +3 -1
  3. package/dist/beacon-types/index.d.ts +3 -1
  4. package/dist/beacon-types/index.js +15 -2
  5. package/dist/beacon-types/index.mjs +15 -2
  6. package/dist/browser-posture-report.d.mts +49 -0
  7. package/dist/browser-posture-report.d.ts +49 -0
  8. package/dist/browser-posture-report.js +1 -0
  9. package/dist/browser-posture-report.mjs +1 -0
  10. package/dist/browser-posture.d.mts +78 -0
  11. package/dist/browser-posture.d.ts +78 -0
  12. package/dist/browser-posture.js +19017 -0
  13. package/dist/browser-posture.mjs +19000 -0
  14. package/dist/browser.d.mts +30 -1
  15. package/dist/browser.d.ts +30 -1
  16. package/dist/browser.js +1 -1
  17. package/dist/browser.mjs +1 -1
  18. package/dist/deploy/index.d.mts +268 -703
  19. package/dist/deploy/index.d.ts +268 -703
  20. package/dist/errors/index.d.mts +104 -0
  21. package/dist/errors/index.d.ts +104 -0
  22. package/dist/errors/index.js +338 -0
  23. package/dist/errors/index.mjs +333 -0
  24. package/dist/gateway/index.d.mts +69 -466
  25. package/dist/gateway/index.d.ts +69 -466
  26. package/dist/gateway/index.js +4 -0
  27. package/dist/gateway/index.mjs +4 -1
  28. package/dist/index.d.mts +5442 -28919
  29. package/dist/index.d.ts +5442 -28919
  30. package/dist/index.js +19552 -4142
  31. package/dist/index.mjs +19523 -4135
  32. package/dist/mcpi/dashboard-config/index.d.mts +1295 -12820
  33. package/dist/mcpi/dashboard-config/index.d.ts +1295 -12820
  34. package/dist/signals/index.d.mts +1 -1
  35. package/dist/signals/index.d.ts +1 -1
  36. package/dist/signals/index.js +95 -2
  37. package/dist/signals/index.mjs +95 -2
  38. package/dist/tool-protection/index.d.mts +135 -834
  39. package/dist/tool-protection/index.d.ts +135 -834
  40. package/fixtures/client-ip-resolution.json +103 -0
  41. package/fixtures/detection/reason-codes.json +35 -0
  42. package/fixtures/detection/signal-exposure-example.json +62 -0
  43. package/fixtures/kya-http/README.md +112 -0
  44. package/fixtures/kya-http/challenge-proof.canonical.json +25 -0
  45. package/fixtures/kya-http/challenge.approval-quorum.json +37 -0
  46. package/fixtures/kya-http/challenge.delegation.fetcher-200.json +55 -0
  47. package/fixtures/kya-http/challenge.delegation.full.json +81 -0
  48. package/fixtures/kya-http/challenge.delegation.minimal.json +57 -0
  49. package/fixtures/kya-http/error-codes.json +35 -0
  50. package/fixtures/kya-http/fetcher-200-predicate.vectors.json +72 -0
  51. package/fixtures/kya-http/negative.challenges.json +54 -0
  52. package/fixtures/kya-http/pickup.transcript.json +96 -0
  53. package/fixtures/kya-http/pickup.transcript.quorum.json +156 -0
  54. package/fixtures/kya-http/protected-resource-metadata.full.json +30 -0
  55. package/fixtures/kya-http/protected-resource-metadata.global.json +28 -0
  56. package/fixtures/kya-http/registration.request.json +33 -0
  57. package/fixtures/kya-http/registration.response.json +32 -0
  58. package/package.json +21 -3
@@ -0,0 +1,72 @@
1
+ [
2
+ {
3
+ "description": "opt-in header present, non-agent detection → 200 (header is the primary signal)",
4
+ "headers": { "kya-accept-challenge": "delegation" },
5
+ "detectionClass": "human",
6
+ "isAgent": false,
7
+ "expected": true
8
+ },
9
+ {
10
+ "description": "opt-in header present, detection absent → 200",
11
+ "headers": { "kya-accept-challenge": "delegation" },
12
+ "detectionClass": null,
13
+ "isAgent": false,
14
+ "expected": true
15
+ },
16
+ {
17
+ "description": "detected ai_agent (isAgent agrees), no opt-in → 200 (transitional UA heuristic)",
18
+ "headers": {},
19
+ "detectionClass": "ai_agent",
20
+ "isAgent": true,
21
+ "expected": true
22
+ },
23
+ {
24
+ "description": "Accept: text/html on a detected agent → 200 (Accept MUST NOT branch the body)",
25
+ "headers": { "accept": "text/markdown, text/html, */*" },
26
+ "detectionClass": "ai_agent",
27
+ "isAgent": true,
28
+ "expected": true
29
+ },
30
+ {
31
+ "description": "ai_agent class but isAgent=false (signals disagree) → 401 (require both, matches .NET + worker)",
32
+ "headers": {},
33
+ "detectionClass": "ai_agent",
34
+ "isAgent": false,
35
+ "expected": false
36
+ },
37
+ {
38
+ "description": "human, no opt-in → 401 (spec path)",
39
+ "headers": {},
40
+ "detectionClass": "human",
41
+ "isAgent": false,
42
+ "expected": false
43
+ },
44
+ {
45
+ "description": "bot, no opt-in → 401 (non-cooperative / spoofer lands on spec path)",
46
+ "headers": {},
47
+ "detectionClass": "bot",
48
+ "isAgent": false,
49
+ "expected": false
50
+ },
51
+ {
52
+ "description": "incomplete_data, no opt-in → 401",
53
+ "headers": {},
54
+ "detectionClass": "incomplete_data",
55
+ "isAgent": false,
56
+ "expected": false
57
+ },
58
+ {
59
+ "description": "no signals at all → 401",
60
+ "headers": {},
61
+ "detectionClass": null,
62
+ "isAgent": false,
63
+ "expected": false
64
+ },
65
+ {
66
+ "description": "empty opt-in value is ignored, human → 401",
67
+ "headers": { "kya-accept-challenge": "" },
68
+ "detectionClass": "human",
69
+ "isAgent": false,
70
+ "expected": false
71
+ }
72
+ ]
@@ -0,0 +1,54 @@
1
+ {
2
+ "$fixture": "kya-http/negative.challenges",
3
+ "$spec": "draft-kya-http-02 §8.1 + §12 (ABNF)",
4
+ "description": "Emitter-side: a conforming PEP must NEVER produce the reject cases. Client/validator-side: reject cases fail validation; tolerate cases MUST pass (forward compatibility).",
5
+ "reject": [
6
+ {
7
+ "name": "missing-sid",
8
+ "header": "Delegation realm=\"api.merchant.com\", consent_uri=\"https://auth.merchant.com/consent\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/x\", kind=\"delegation\"",
9
+ "reason": "sid is REQUIRED"
10
+ },
11
+ {
12
+ "name": "missing-kind",
13
+ "header": "Delegation realm=\"api.merchant.com\", sid=\"kya-1\", consent_uri=\"https://auth.merchant.com/consent?sid=kya-1\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/kya-1\"",
14
+ "reason": "kind is REQUIRED"
15
+ },
16
+ {
17
+ "name": "http-consent-uri",
18
+ "header": "Delegation realm=\"api.merchant.com\", sid=\"kya-1\", consent_uri=\"http://auth.merchant.com/consent?sid=kya-1\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/kya-1\", kind=\"delegation\"",
19
+ "reason": "consent_uri/pickup_uri MUST be absolute https URIs"
20
+ },
21
+ {
22
+ "name": "unquoted-param",
23
+ "header": "Delegation realm=api.merchant.com, sid=\"kya-1\", consent_uri=\"https://auth.merchant.com/consent?sid=kya-1\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/kya-1\", kind=\"delegation\"",
24
+ "reason": "all values are quoted-strings"
25
+ },
26
+ {
27
+ "name": "invalid-min-assurance",
28
+ "header": "Delegation realm=\"api.merchant.com\", sid=\"kya-1\", consent_uri=\"https://auth.merchant.com/consent?sid=kya-1\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/kya-1\", min_assurance=\"platinum\", kind=\"delegation\"",
29
+ "reason": "min_assurance enum: anonymous|attested-bearer|key-bound|registered|delegated"
30
+ },
31
+ {
32
+ "name": "missing-instructions-element",
33
+ "body_mutation": "instructions omits the pinning requirement (element 3)",
34
+ "reason": "the four §8.1 instructions elements are REQUIRED"
35
+ }
36
+ ],
37
+ "tolerate": [
38
+ {
39
+ "name": "unknown-param-ignored",
40
+ "header": "Delegation realm=\"api.merchant.com\", sid=\"kya-1\", consent_uri=\"https://auth.merchant.com/consent?sid=kya-1\", pickup_uri=\"https://auth.merchant.com/api/delegation/pickup/kya-1\", kind=\"delegation\", x_future_param=\"x\"",
41
+ "reason": "unrecognized params MUST be ignored"
42
+ },
43
+ {
44
+ "name": "extra-body-members-ignored",
45
+ "body_mutation": "kyaos object carries additional unknown members",
46
+ "reason": "forward compatibility"
47
+ },
48
+ {
49
+ "name": "coexisting-bearer-challenge",
50
+ "note": "second WWW-Authenticate (Bearer resource_metadata=...) present",
51
+ "reason": "RFC 7235 multiple challenges; REQUIRED to tolerate, SHOULD emit"
52
+ }
53
+ ]
54
+ }
@@ -0,0 +1,96 @@
1
+ {
2
+ "$fixture": "kya-http/pickup.transcript",
3
+ "$spec": "draft-kya-http-02 §8.2 + §13 (anchor state machine)",
4
+ "description": "Poll sequences against GET /api/delegation/pickup/kya-9f4e7c2a8b1d4e6f. Token path shown; key path differs only in that polls are RFC 9421-signed and the pin is the keyid (or set at challenge time for signed callers). All responses carry Cache-Control: no-store.",
5
+ "pinned_token": "X-KYA-Pickup-Token: 5f4dcc3b5aa765d61d8327deb882cf995f4dcc3b5aa765d61d8327deb882cf99",
6
+ "sequences": {
7
+ "happy_path_with_redelivery": [
8
+ {
9
+ "step": 1,
10
+ "poll": "token A (first poll — PENDING→PINNED)",
11
+ "status": 202,
12
+ "body": { "status": "pending" }
13
+ },
14
+ {
15
+ "step": 2,
16
+ "poll": "token A (consent not yet granted)",
17
+ "status": 202,
18
+ "body": { "status": "pending" }
19
+ },
20
+ {
21
+ "step": 3,
22
+ "note": "human approves on consent surface — PINNED→APPROVED, credential minted and parked"
23
+ },
24
+ {
25
+ "step": 4,
26
+ "poll": "token A",
27
+ "status": 200,
28
+ "body": {
29
+ "status": "ready",
30
+ "token_type": "Bearer",
31
+ "delegation": "TEST-DELEGATION-VC-JWT",
32
+ "expires_in": 900
33
+ }
34
+ },
35
+ {
36
+ "step": 5,
37
+ "poll": "token A (simulated dropped 200 — RE-DELIVERY, same credential)",
38
+ "status": 200,
39
+ "body": {
40
+ "status": "ready",
41
+ "token_type": "Bearer",
42
+ "delegation": "TEST-DELEGATION-VC-JWT",
43
+ "expires_in": 900
44
+ }
45
+ },
46
+ { "step": 6, "note": "anchor TTL (≤600s) elapses — APPROVED→EXPIRED" },
47
+ { "step": 7, "poll": "token A", "status": 410, "body": { "error": "kyaos/pickup-expired" } }
48
+ ],
49
+ "pinning_race": [
50
+ {
51
+ "step": 1,
52
+ "poll": "token A and token B race the first poll",
53
+ "note": "atomic compare-and-set: exactly one pins"
54
+ },
55
+ { "step": 2, "poll": "winner (token A)", "status": 202, "body": { "status": "pending" } },
56
+ {
57
+ "step": 3,
58
+ "poll": "loser (token B)",
59
+ "status": 403,
60
+ "body": { "error": "kyaos/pickup-pinned" }
61
+ }
62
+ ],
63
+ "non_pinned_after_approval": [
64
+ {
65
+ "step": 1,
66
+ "poll": "token B (anchor pinned to A, credential parked)",
67
+ "status": 403,
68
+ "body": { "error": "kyaos/pickup-pinned" },
69
+ "note": "legitimate-agent 403s SHOULD be surfaced to the org audit stream as a compromise indicator (spec §10)"
70
+ }
71
+ ],
72
+ "unknown_anchor": [
73
+ {
74
+ "step": 1,
75
+ "poll": "any token, sid=kya-DOES-NOT-EXIST",
76
+ "status": 404,
77
+ "body": { "error": "kyaos/invalid-session" }
78
+ }
79
+ ],
80
+ "over_rate": [
81
+ {
82
+ "step": 1,
83
+ "poll": "token A at >1/interval",
84
+ "status": 429,
85
+ "headers": [["Retry-After", "3"]]
86
+ }
87
+ ]
88
+ },
89
+ "invariants": [
90
+ "pin is set at challenge time when the challenged request carried a valid Layer 1 signature (no first-poll race for signed callers)",
91
+ "pinned secret never appears in any URL, log line, or redirect",
92
+ "200 is repeatable for the pinned holder until anchor expiry (no consume-on-read)",
93
+ "consent on an EXPIRED anchor MUST fail",
94
+ "all pickup responses: Cache-Control: no-store"
95
+ ]
96
+ }
@@ -0,0 +1,156 @@
1
+ {
2
+ "$fixture": "kya-http/pickup.transcript.quorum",
3
+ "$spec": "draft-kya-quorum-00 §5–§8 (PENDING engineer approval — not parity-frozen until draft-kya-quorum-00 is accepted; resolves the two items pinned on PR #3264 / #3248)",
4
+ "description": "Quorum pickup against GET /api/delegation/pickup/kya-7a1b3c5d7e9f1a2b. Differences vs kind=delegation: 202 carries quorum progress; 200 returns an org-signed attestation (typ approval-attestation+jwt, exp-iat <= 300s) REQUIRED + raw grants OPTIONAL, no token_type; retry presents KYA-Approvals, not Authorization: Bearer. Anchor/pinning/no-store rules inherit draft-kya-http-02 §8.2 unchanged. Approval window = action-nonce TTL (policy @approval_window, default 3600s); anchors stay <=600s with idempotent re-challenge.",
5
+ "pinned_token": "X-KYA-Pickup-Token: 5f4dcc3b5aa765d61d8327deb882cf995f4dcc3b5aa765d61d8327deb882cf99",
6
+ "sequences": {
7
+ "happy_path_two_approvers_slow": [
8
+ {
9
+ "step": 1,
10
+ "poll": "token A (first poll — pins anchor)",
11
+ "status": 202,
12
+ "body": {
13
+ "status": "pending",
14
+ "kind": "approval_quorum",
15
+ "quorum": { "required": 2, "satisfied": 0 }
16
+ }
17
+ },
18
+ {
19
+ "step": 2,
20
+ "note": "approver 1 signs on the approver page; Authorization Host verifies the grant AT SUBMISSION (within its 300s freshness) and appends to the durable approval record keyed by request_hash"
21
+ },
22
+ {
23
+ "step": 3,
24
+ "poll": "token A",
25
+ "status": 202,
26
+ "body": {
27
+ "status": "pending",
28
+ "kind": "approval_quorum",
29
+ "quorum": { "required": 2, "satisfied": 1 }
30
+ }
31
+ },
32
+ {
33
+ "step": 4,
34
+ "note": "anchor TTL (<=600s) elapses while approver 2 is away — anchor EXPIRED, approval record SURVIVES (record lifetime = nonce TTL)"
35
+ },
36
+ { "step": 5, "poll": "token A", "status": 410, "body": { "error": "kyaos/pickup-expired" } },
37
+ {
38
+ "step": 6,
39
+ "note": "agent re-sends the ORIGINAL request (byte-identical) → same request_hash → idempotent nonce re-issue → fresh 401 challenge with NEW sid kya-8c2d4e6f8a0b1c3d bound to the SAME approval record; challenge body request_hash lets the agent confirm re-anchoring"
40
+ },
41
+ {
42
+ "step": 7,
43
+ "poll": "NEW pickup_uri, token B (fresh anchor, fresh pin)",
44
+ "status": 202,
45
+ "body": {
46
+ "status": "pending",
47
+ "kind": "approval_quorum",
48
+ "quorum": { "required": 2, "satisfied": 1 }
49
+ }
50
+ },
51
+ {
52
+ "step": 8,
53
+ "note": "approver 2 signs; verified-on-submission; record satisfied — attestation minted and parked; action nonce NOT consumed by the Host"
54
+ },
55
+ {
56
+ "step": 9,
57
+ "poll": "token B",
58
+ "status": 200,
59
+ "body": {
60
+ "status": "ready",
61
+ "kind": "approval_quorum",
62
+ "attestation": "TEST-ATTESTATION-JWS-PENDING-VECTORS",
63
+ "grants": ["TEST-GRANT-JWS-APPROVER-1", "TEST-GRANT-JWS-APPROVER-2"],
64
+ "quorum": {
65
+ "required": 2,
66
+ "satisfied": 2,
67
+ "approvers": ["did:key:zApproverA", "did:key:zApproverB"]
68
+ },
69
+ "action_nonce": "TEST-NONCE-43CHAR-base64url-AAAAAAAAAAAAAAAAA",
70
+ "expires_in": 300
71
+ }
72
+ },
73
+ {
74
+ "step": 10,
75
+ "poll": "token B (simulated dropped 200 — re-delivery; attestation RE-ISSUED with refreshed iat/exp)",
76
+ "status": 200,
77
+ "body": {
78
+ "status": "ready",
79
+ "kind": "approval_quorum",
80
+ "attestation": "TEST-ATTESTATION-JWS-REISSUED",
81
+ "quorum": {
82
+ "required": 2,
83
+ "satisfied": 2,
84
+ "approvers": ["did:key:zApproverA", "did:key:zApproverB"]
85
+ },
86
+ "action_nonce": "TEST-NONCE-43CHAR-base64url-AAAAAAAAAAAAAAAAA",
87
+ "expires_in": 300
88
+ }
89
+ },
90
+ {
91
+ "step": 11,
92
+ "note": "agent retries the original request with header 'KYA-Approvals: <attestation>' — PEP recomputes request_hash, verifies attestation (org sig, aud, typ, freshness, hash match), then tryConsume(request_hash) → admitted EXACTLY ONCE"
93
+ },
94
+ {
95
+ "step": 12,
96
+ "poll": "token B (after consumption)",
97
+ "status": 410,
98
+ "body": { "error": "kyaos/pickup-expired" },
99
+ "note": "nonce consumed → approval session over; a NEW identical request mints a FRESH nonce = new action instance requiring new approvals"
100
+ }
101
+ ],
102
+ "signed_deny_not_counted": [
103
+ {
104
+ "step": 1,
105
+ "note": "approver 1 signs decision=deny — recorded in the approval record as evidence, NEVER counted toward quorum"
106
+ },
107
+ {
108
+ "step": 2,
109
+ "poll": "token A",
110
+ "status": 202,
111
+ "body": {
112
+ "status": "pending",
113
+ "kind": "approval_quorum",
114
+ "quorum": { "required": 2, "satisfied": 0 }
115
+ }
116
+ }
117
+ ],
118
+ "duplicate_approver_dedup": [
119
+ {
120
+ "step": 1,
121
+ "note": "approver 1 signs twice (two valid grants, same DID) — Set semantics: counts ONCE"
122
+ },
123
+ {
124
+ "step": 2,
125
+ "poll": "token A",
126
+ "status": 202,
127
+ "body": {
128
+ "status": "pending",
129
+ "kind": "approval_quorum",
130
+ "quorum": { "required": 2, "satisfied": 1 }
131
+ }
132
+ }
133
+ ]
134
+ },
135
+ "retry": {
136
+ "hosted_path_default": ["KYA-Approvals", "TEST-ATTESTATION-JWS-PENDING-VECTORS"],
137
+ "fast_path_fresh_grants": [
138
+ "KYA-Approvals",
139
+ "TEST-GRANT-JWS-APPROVER-1, TEST-GRANT-JWS-APPROVER-2"
140
+ ],
141
+ "admission_errors": {
142
+ "kyaos/quorum-not-met": "k/n detail",
143
+ "kyaos/nonce-consumed": "lost the tryConsume race or replayed",
144
+ "kyaos/grant-invalid": "per-grant reason",
145
+ "kyaos/action-mismatch": "retry bytes differ from approved request_hash"
146
+ }
147
+ },
148
+ "invariants": [
149
+ "approval record lifetime = action-nonce TTL (@approval_window, default 3600s, max 86400s); anchors stay <=600s",
150
+ "grants verified at SUBMISSION time (within their <=300s freshness); collection window is record-time, not signature-time",
151
+ "nonce idempotently re-issued while outstanding; consumed only at PEP admission via atomic tryConsume; never by the Host; partial progress never burns it",
152
+ "empty approver allowlist NEVER satisfies (fail-closed); unresolvable approver keys never count",
153
+ "200 body: attestation REQUIRED, grants OPTIONAL, token_type ABSENT",
154
+ "all pickup responses: Cache-Control: no-store"
155
+ ]
156
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "$fixture": "kya-http/protected-resource-metadata.full",
3
+ "$spec": "RFC 9728 OAuth Protected Resource Metadata (advertised by draft-kya-http-02 §8.1)",
4
+ "description": "Per-org PRM document served at /.well-known/oauth-protected-resource — the URL the §8.1 Bearer challenge advertises. With a resource_org_did carrying an :orgs: slug, authorization_servers advertises the PER-ORG gateway issuer; with scopes present, scopes_supported is emitted. Every PEP that serves this URL (.NET net462 + net8, gateway-worker) must produce this document for the same input.",
5
+ "input": {
6
+ "resource_host": "api.merchant.com",
7
+ "resource_org_did": "did:web:kya.vouched.id:orgs:acme",
8
+ "base_url": "https://kya.vouched.id",
9
+ "scopes": ["commerce.checkout"]
10
+ },
11
+ "expected": {
12
+ "document": {
13
+ "resource": "https://api.merchant.com",
14
+ "authorization_servers": ["https://kya.vouched.id/oauth/gateway/acme"],
15
+ "bearer_methods_supported": ["header"],
16
+ "scopes_supported": ["commerce.checkout"],
17
+ "resource_documentation": "https://kya.vouched.id/docs/enforce/kya-os-enforcement"
18
+ }
19
+ },
20
+ "conformance": {
21
+ "key_order": [
22
+ "resource",
23
+ "authorization_servers",
24
+ "bearer_methods_supported",
25
+ "scopes_supported",
26
+ "resource_documentation"
27
+ ],
28
+ "notes": "resource byte-matches the §8.1 Bearer resource_metadata URL host; authorization_servers is ALWAYS a single-element array; the .NET v1 document does NOT emit the kyaos_needs_authorization extension the gateway-worker adds."
29
+ }
30
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "$fixture": "kya-http/protected-resource-metadata.global",
3
+ "$spec": "RFC 9728 OAuth Protected Resource Metadata (advertised by draft-kya-http-02 §8.1)",
4
+ "description": "Global PRM document: no resource_org_did and no scopes. authorization_servers advertises the GLOBAL gateway issuer (the BaseUrl origin), and scopes_supported is OMITTED entirely (NOT defaulted to a scope). The minimal counterpart of protected-resource-metadata.full.json.",
5
+ "input": {
6
+ "resource_host": "api.merchant.com",
7
+ "resource_org_did": null,
8
+ "base_url": "https://kya.vouched.id",
9
+ "scopes": []
10
+ },
11
+ "expected": {
12
+ "document": {
13
+ "resource": "https://api.merchant.com",
14
+ "authorization_servers": ["https://kya.vouched.id"],
15
+ "bearer_methods_supported": ["header"],
16
+ "resource_documentation": "https://kya.vouched.id/docs/enforce/kya-os-enforcement"
17
+ }
18
+ },
19
+ "conformance": {
20
+ "key_order": [
21
+ "resource",
22
+ "authorization_servers",
23
+ "bearer_methods_supported",
24
+ "resource_documentation"
25
+ ],
26
+ "notes": "scopes_supported is OMITTED (no scopes input); authorization_servers is the global issuer (BaseUrl origin) when no org slug is present — still a single-element array."
27
+ }
28
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$fixture": "kya-http/registration.request",
3
+ "$spec": "H2.4 #3255 \u2014 challenge-anchor registration (POST /api/v1/bouncer/sessions)",
4
+ "description": "Canonical registration REQUEST body, frozen so the TS edge worker (registration-client.ts) and the .NET DelegationAnchorRegistrar.BuildRequestBody cannot drift on field names / required set. Values like client_info.name and agent_did legitimately differ per client (gateway-worker vs the .NET SDK, anonymous-principal vs a verified DID) \u2014 only the SHAPE (top-level keys + nested challenge keys) is normative; the parity tests assert key sets, not values.",
5
+ "body": {
6
+ "session_id": "kya-9f4e7c2a8b1d4e6f0a1b2c3d4e5f6071",
7
+ "agent_did": "did:web:anonymous.example",
8
+ "project_id": "proj_canonical_fixture",
9
+ "created_at": 1700000000000,
10
+ "client_info": {
11
+ "name": "checkpoint-gateway",
12
+ "version": "1.0.0"
13
+ },
14
+ "challenge": {
15
+ "required_scopes": ["commerce.checkout"],
16
+ "pep_surface": "gateway-worker",
17
+ "verdict": "challenge"
18
+ }
19
+ },
20
+ "conformance": {
21
+ "required_top_level_keys": [
22
+ "session_id",
23
+ "agent_did",
24
+ "project_id",
25
+ "created_at",
26
+ "client_info",
27
+ "challenge"
28
+ ],
29
+ "required_client_info_keys": ["name"],
30
+ "required_challenge_keys": ["required_scopes"],
31
+ "notes": "issued_at is NOT a request field (it is response-only). The challenge block also OPTIONALLY carries pep_surface, verdict, detected_agent_did, challenge_pin, audience (X4 cross-resource claims: the resource org's DID that becomes the deployment-minted VC's aud; server-derived on checkpoint's redirect relay), and the #4201 display-only detected-identity keys detected_agent_name, detected_agent_class, detected_confidence (0-100) \u2014 rendered on the consent screen's agent card, never entering the challenge_proof."
32
+ }
33
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "$fixture": "kya-http/registration.response",
3
+ "$spec": "H2.4 #3255 — challenge-anchor registration success envelope",
4
+ "description": "Canonical registration RESPONSE, frozen so both client runtimes parse it without drift. The TS edge worker (registration-client.ts) reads data.challenge.{consent_uri, challenge_proof, issued_at} and NEVER data.session_id; the .NET DelegationAnchorRegistrar.ParseResponse reads data.session_id (echoed into Sid) + data.challenge.{consent_uri, challenge_proof} and NEVER issued_at. consent_uri + challenge_proof are read by BOTH — renaming either must fail BOTH parity tests (the drift-guard verify-by-revert).",
5
+ "body": {
6
+ "success": true,
7
+ "data": {
8
+ "session_id": "kya-9f4e7c2a8b1d4e6f0a1b2c3d4e5f6071",
9
+ "registered": true,
10
+ "created_at": "2023-11-14T22:13:20.000Z",
11
+ "challenge": {
12
+ "consent_uri": "https://auth.merchant.com/consent?sid=kya-9f4e7c2a8b1d4e6f0a1b2c3d4e5f6071",
13
+ "challenge_proof": { "sig": "test-challenge-proof" },
14
+ "required_scopes": ["commerce.checkout"],
15
+ "issued_at": 1700000000000
16
+ }
17
+ }
18
+ },
19
+ "conformance": {
20
+ "ts_worker_reads": [
21
+ "data.challenge.consent_uri",
22
+ "data.challenge.challenge_proof",
23
+ "data.challenge.issued_at"
24
+ ],
25
+ "dotnet_reads": [
26
+ "data.session_id",
27
+ "data.challenge.consent_uri",
28
+ "data.challenge.challenge_proof"
29
+ ],
30
+ "read_by_both": ["data.challenge.consent_uri", "data.challenge.challenge_proof"]
31
+ }
32
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kya-os/checkpoint-shared",
3
- "version": "1.3.0",
3
+ "version": "1.4.0",
4
4
  "description": "Checkpoint shared types and schemas (formerly @kya-os/agentshield-shared)",
5
5
  "keywords": [
6
6
  "ai",
@@ -95,12 +95,28 @@
95
95
  "import": "./dist/signals/index.mjs",
96
96
  "require": "./dist/signals/index.js"
97
97
  },
98
- "./package.json": "./package.json"
98
+ "./errors": {
99
+ "types": "./dist/errors/index.d.ts",
100
+ "import": "./dist/errors/index.mjs",
101
+ "require": "./dist/errors/index.js"
102
+ },
103
+ "./package.json": "./package.json",
104
+ "./browser-posture-report": {
105
+ "types": "./dist/browser-posture-report.d.ts",
106
+ "import": "./dist/browser-posture-report.mjs",
107
+ "require": "./dist/browser-posture-report.js"
108
+ },
109
+ "./browser-posture": {
110
+ "types": "./dist/browser-posture.d.ts",
111
+ "import": "./dist/browser-posture.mjs",
112
+ "require": "./dist/browser-posture.js"
113
+ }
99
114
  },
100
115
  "files": [
101
116
  "dist",
102
117
  "src/data/compiled",
103
118
  "src/data/default-rules.json",
119
+ "fixtures",
104
120
  "README.md",
105
121
  "CHANGELOG.md"
106
122
  ],
@@ -114,7 +130,7 @@
114
130
  "canonicalize": "^3.0.0",
115
131
  "jose": "^5.10.0",
116
132
  "js-yaml": "^5.0.0",
117
- "zod": "^3.22.4"
133
+ "zod": "^4.5.4"
118
134
  },
119
135
  "devDependencies": {
120
136
  "@types/js-yaml": "^4.0.9",
@@ -139,6 +155,8 @@
139
155
  "signals:snapshot:write": "tsx scripts/signal-registry-snapshot.ts --write",
140
156
  "signals:docs": "tsx scripts/generate-signal-docs.ts",
141
157
  "errors:docs": "tsx scripts/generate-error-docs.ts",
158
+ "reason-codes:docs": "tsx scripts/generate-reason-code-docs.ts",
159
+ "signal-exposure:docs": "tsx scripts/generate-signal-exposure-docs.ts",
142
160
  "build": "rimraf dist && pnpm run compile-rules && pnpm run build:patterns && tsup",
143
161
  "build:watch": "tsup --watch",
144
162
  "dev": "tsup --watch",