@kya-os/mcp 1.10.1 → 1.11.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 (220) hide show
  1. package/AUDITABILITY.md +441 -0
  2. package/CHANGELOG.md +88 -0
  3. package/CONFORMANCE.md +598 -0
  4. package/README.md +67 -4
  5. package/SPEC.md +1827 -0
  6. package/dist/audit/adapters/legacy-audit-log.d.ts +20 -0
  7. package/dist/audit/adapters/legacy-audit-log.d.ts.map +1 -0
  8. package/dist/audit/adapters/legacy-audit-log.js +56 -0
  9. package/dist/audit/adapters/legacy-audit-log.js.map +1 -0
  10. package/dist/audit/adapters/mcp.d.ts +105 -0
  11. package/dist/audit/adapters/mcp.d.ts.map +1 -0
  12. package/dist/audit/adapters/mcp.js +213 -0
  13. package/dist/audit/adapters/mcp.js.map +1 -0
  14. package/dist/audit/assurance.d.ts +22 -0
  15. package/dist/audit/assurance.d.ts.map +1 -0
  16. package/dist/audit/assurance.js +39 -0
  17. package/dist/audit/assurance.js.map +1 -0
  18. package/dist/audit/checkpoint-coordinator.d.ts +51 -0
  19. package/dist/audit/checkpoint-coordinator.d.ts.map +1 -0
  20. package/dist/audit/checkpoint-coordinator.js +112 -0
  21. package/dist/audit/checkpoint-coordinator.js.map +1 -0
  22. package/dist/audit/checkpoint.d.ts +59 -0
  23. package/dist/audit/checkpoint.d.ts.map +1 -0
  24. package/dist/audit/checkpoint.js +219 -0
  25. package/dist/audit/checkpoint.js.map +1 -0
  26. package/dist/audit/cli.d.ts +8 -0
  27. package/dist/audit/cli.d.ts.map +1 -0
  28. package/dist/audit/cli.js +85 -0
  29. package/dist/audit/cli.js.map +1 -0
  30. package/dist/audit/crypto.d.ts +37 -0
  31. package/dist/audit/crypto.d.ts.map +1 -0
  32. package/dist/audit/crypto.js +68 -0
  33. package/dist/audit/crypto.js.map +1 -0
  34. package/dist/audit/errors.d.ts +29 -0
  35. package/dist/audit/errors.d.ts.map +1 -0
  36. package/dist/audit/errors.js +33 -0
  37. package/dist/audit/errors.js.map +1 -0
  38. package/dist/audit/evidence.d.ts +45 -0
  39. package/dist/audit/evidence.d.ts.map +1 -0
  40. package/dist/audit/evidence.js +151 -0
  41. package/dist/audit/evidence.js.map +1 -0
  42. package/dist/audit/index.d.ts +27 -0
  43. package/dist/audit/index.d.ts.map +1 -0
  44. package/dist/audit/index.js +27 -0
  45. package/dist/audit/index.js.map +1 -0
  46. package/dist/audit/integrity.d.ts +19 -0
  47. package/dist/audit/integrity.d.ts.map +1 -0
  48. package/dist/audit/integrity.js +64 -0
  49. package/dist/audit/integrity.js.map +1 -0
  50. package/dist/audit/merkle.d.ts +31 -0
  51. package/dist/audit/merkle.d.ts.map +1 -0
  52. package/dist/audit/merkle.js +195 -0
  53. package/dist/audit/merkle.js.map +1 -0
  54. package/dist/audit/mirror-service.d.ts +19 -0
  55. package/dist/audit/mirror-service.d.ts.map +1 -0
  56. package/dist/audit/mirror-service.js +54 -0
  57. package/dist/audit/mirror-service.js.map +1 -0
  58. package/dist/audit/projection.d.ts +90 -0
  59. package/dist/audit/projection.d.ts.map +1 -0
  60. package/dist/audit/projection.js +142 -0
  61. package/dist/audit/projection.js.map +1 -0
  62. package/dist/audit/providers/anchor.d.ts +23 -0
  63. package/dist/audit/providers/anchor.d.ts.map +1 -0
  64. package/dist/audit/providers/anchor.js +25 -0
  65. package/dist/audit/providers/anchor.js.map +1 -0
  66. package/dist/audit/providers/evidence.d.ts +36 -0
  67. package/dist/audit/providers/evidence.d.ts.map +1 -0
  68. package/dist/audit/providers/evidence.js +2 -0
  69. package/dist/audit/providers/evidence.js.map +1 -0
  70. package/dist/audit/providers/journal.d.ts +35 -0
  71. package/dist/audit/providers/journal.d.ts.map +1 -0
  72. package/dist/audit/providers/journal.js +2 -0
  73. package/dist/audit/providers/journal.js.map +1 -0
  74. package/dist/audit/providers/memory-journal.d.ts +24 -0
  75. package/dist/audit/providers/memory-journal.d.ts.map +1 -0
  76. package/dist/audit/providers/memory-journal.js +73 -0
  77. package/dist/audit/providers/memory-journal.js.map +1 -0
  78. package/dist/audit/providers/observer.d.ts +30 -0
  79. package/dist/audit/providers/observer.d.ts.map +1 -0
  80. package/dist/audit/providers/observer.js +100 -0
  81. package/dist/audit/providers/observer.js.map +1 -0
  82. package/dist/audit/providers/outbox.d.ts +37 -0
  83. package/dist/audit/providers/outbox.d.ts.map +1 -0
  84. package/dist/audit/providers/outbox.js +52 -0
  85. package/dist/audit/providers/outbox.js.map +1 -0
  86. package/dist/audit/providers/recorder-client.d.ts +22 -0
  87. package/dist/audit/providers/recorder-client.d.ts.map +1 -0
  88. package/dist/audit/providers/recorder-client.js +17 -0
  89. package/dist/audit/providers/recorder-client.js.map +1 -0
  90. package/dist/audit/providers/source-state.d.ts +37 -0
  91. package/dist/audit/providers/source-state.d.ts.map +1 -0
  92. package/dist/audit/providers/source-state.js +94 -0
  93. package/dist/audit/providers/source-state.js.map +1 -0
  94. package/dist/audit/recorder-service.d.ts +78 -0
  95. package/dist/audit/recorder-service.d.ts.map +1 -0
  96. package/dist/audit/recorder-service.js +331 -0
  97. package/dist/audit/recorder-service.js.map +1 -0
  98. package/dist/audit/replay-bundle.d.ts +52 -0
  99. package/dist/audit/replay-bundle.d.ts.map +1 -0
  100. package/dist/audit/replay-bundle.js +551 -0
  101. package/dist/audit/replay-bundle.js.map +1 -0
  102. package/dist/audit/schemas.d.ts +1144 -0
  103. package/dist/audit/schemas.d.ts.map +1 -0
  104. package/dist/audit/schemas.js +483 -0
  105. package/dist/audit/schemas.js.map +1 -0
  106. package/dist/audit/service.d.ts +91 -0
  107. package/dist/audit/service.d.ts.map +1 -0
  108. package/dist/audit/service.js +222 -0
  109. package/dist/audit/service.js.map +1 -0
  110. package/dist/audit/testing/index.d.ts +2 -0
  111. package/dist/audit/testing/index.d.ts.map +1 -0
  112. package/dist/audit/testing/index.js +2 -0
  113. package/dist/audit/testing/index.js.map +1 -0
  114. package/dist/audit/testing/provider-contracts.d.ts +51 -0
  115. package/dist/audit/testing/provider-contracts.d.ts.map +1 -0
  116. package/dist/audit/testing/provider-contracts.js +391 -0
  117. package/dist/audit/testing/provider-contracts.js.map +1 -0
  118. package/dist/audit/types.d.ts +356 -0
  119. package/dist/audit/types.d.ts.map +1 -0
  120. package/dist/audit/types.js +49 -0
  121. package/dist/audit/types.js.map +1 -0
  122. package/dist/audit/verifier.d.ts +73 -0
  123. package/dist/audit/verifier.d.ts.map +1 -0
  124. package/dist/audit/verifier.js +322 -0
  125. package/dist/audit/verifier.js.map +1 -0
  126. package/dist/card/proof/canonical.d.ts.map +1 -1
  127. package/dist/card/proof/canonical.js +19 -1
  128. package/dist/card/proof/canonical.js.map +1 -1
  129. package/dist/delegation/delegation-graph.d.ts +4 -0
  130. package/dist/delegation/delegation-graph.d.ts.map +1 -1
  131. package/dist/delegation/delegation-graph.js +28 -2
  132. package/dist/delegation/delegation-graph.js.map +1 -1
  133. package/dist/delegation/statuslist-manager.d.ts +5 -0
  134. package/dist/delegation/statuslist-manager.d.ts.map +1 -1
  135. package/dist/delegation/statuslist-manager.js.map +1 -1
  136. package/dist/delegation/storage/memory-graph-storage.d.ts +4 -2
  137. package/dist/delegation/storage/memory-graph-storage.d.ts.map +1 -1
  138. package/dist/delegation/storage/memory-graph-storage.js +18 -0
  139. package/dist/delegation/storage/memory-graph-storage.js.map +1 -1
  140. package/dist/delegation/storage/memory-statuslist-storage.d.ts +5 -2
  141. package/dist/delegation/storage/memory-statuslist-storage.d.ts.map +1 -1
  142. package/dist/delegation/storage/memory-statuslist-storage.js +21 -2
  143. package/dist/delegation/storage/memory-statuslist-storage.js.map +1 -1
  144. package/dist/delegation/utils.d.ts.map +1 -1
  145. package/dist/delegation/utils.js +2 -42
  146. package/dist/delegation/utils.js.map +1 -1
  147. package/dist/delegation/vc-verifier.d.ts +4 -0
  148. package/dist/delegation/vc-verifier.d.ts.map +1 -1
  149. package/dist/delegation/vc-verifier.js +44 -13
  150. package/dist/delegation/vc-verifier.js.map +1 -1
  151. package/dist/errors.d.ts +1 -1
  152. package/dist/errors.js +1 -1
  153. package/dist/index.d.ts +2 -1
  154. package/dist/index.d.ts.map +1 -1
  155. package/dist/index.js +3 -1
  156. package/dist/index.js.map +1 -1
  157. package/dist/middleware/kya-os-transport.d.ts.map +1 -1
  158. package/dist/middleware/kya-os-transport.js +10 -3
  159. package/dist/middleware/kya-os-transport.js.map +1 -1
  160. package/dist/middleware/with-kya-os-server.d.ts +6 -0
  161. package/dist/middleware/with-kya-os-server.d.ts.map +1 -1
  162. package/dist/middleware/with-kya-os-server.js +2 -0
  163. package/dist/middleware/with-kya-os-server.js.map +1 -1
  164. package/dist/middleware/with-kya-os.config-types.d.ts +15 -0
  165. package/dist/middleware/with-kya-os.config-types.d.ts.map +1 -1
  166. package/dist/middleware/with-kya-os.config-types.js.map +1 -1
  167. package/dist/middleware/with-kya-os.d.ts.map +1 -1
  168. package/dist/middleware/with-kya-os.delegation-gate.d.ts.map +1 -1
  169. package/dist/middleware/with-kya-os.delegation-gate.js +96 -3
  170. package/dist/middleware/with-kya-os.delegation-gate.js.map +1 -1
  171. package/dist/middleware/with-kya-os.deps.d.ts +2 -0
  172. package/dist/middleware/with-kya-os.deps.d.ts.map +1 -1
  173. package/dist/middleware/with-kya-os.js +23 -0
  174. package/dist/middleware/with-kya-os.js.map +1 -1
  175. package/dist/middleware/with-kya-os.policy-gate.d.ts.map +1 -1
  176. package/dist/middleware/with-kya-os.policy-gate.js +29 -4
  177. package/dist/middleware/with-kya-os.policy-gate.js.map +1 -1
  178. package/dist/middleware/with-kya-os.protocol.d.ts.map +1 -1
  179. package/dist/middleware/with-kya-os.protocol.js +10 -0
  180. package/dist/middleware/with-kya-os.protocol.js.map +1 -1
  181. package/dist/middleware/with-kya-os.session.d.ts.map +1 -1
  182. package/dist/middleware/with-kya-os.session.js +208 -2
  183. package/dist/middleware/with-kya-os.session.js.map +1 -1
  184. package/dist/middleware/with-kya-os.types.d.ts +6 -0
  185. package/dist/middleware/with-kya-os.types.d.ts.map +1 -1
  186. package/dist/middleware/with-kya-os.types.js.map +1 -1
  187. package/dist/proof/generator.d.ts.map +1 -1
  188. package/dist/proof/generator.js +6 -5
  189. package/dist/proof/generator.js.map +1 -1
  190. package/dist/proof/verifier.d.ts +12 -0
  191. package/dist/proof/verifier.d.ts.map +1 -1
  192. package/dist/proof/verifier.js +35 -4
  193. package/dist/proof/verifier.js.map +1 -1
  194. package/dist/session/manager.js +1 -1
  195. package/dist/session/manager.js.map +1 -1
  196. package/dist/utils/canonical-json.d.ts +15 -0
  197. package/dist/utils/canonical-json.d.ts.map +1 -0
  198. package/dist/utils/canonical-json.js +109 -0
  199. package/dist/utils/canonical-json.js.map +1 -0
  200. package/dist/utils/crypto-service.d.ts.map +1 -1
  201. package/dist/utils/crypto-service.js +5 -0
  202. package/dist/utils/crypto-service.js.map +1 -1
  203. package/dist/utils/index.d.ts +1 -0
  204. package/dist/utils/index.d.ts.map +1 -1
  205. package/dist/utils/index.js +1 -0
  206. package/dist/utils/index.js.map +1 -1
  207. package/package.json +29 -11
  208. package/schemas/README.md +27 -1
  209. package/schemas/audit-anchor-receipt.schema.json +16 -0
  210. package/schemas/audit-bundle-manifest.schema.json +71 -0
  211. package/schemas/audit-checkpoint.schema.json +37 -0
  212. package/schemas/audit-consistency-proof.schema.json +17 -0
  213. package/schemas/audit-entry.schema.json +33 -0
  214. package/schemas/audit-event.schema.json +168 -0
  215. package/schemas/audit-inclusion-proof.schema.json +17 -0
  216. package/schemas/audit-observation.schema.json +40 -0
  217. package/schemas/audit-receipt.schema.json +32 -0
  218. package/schemas/audit-verification-policy.schema.json +71 -0
  219. package/schemas/audit-verification-report.schema.json +29 -0
  220. package/schemas/well-known-mcpi.json +17 -0
@@ -0,0 +1,356 @@
1
+ /** Wire-level types for the KYA-OS Auditability Protocol v1. */
2
+ export type Digest = `sha256:${string}`;
3
+ export type DecimalString = string;
4
+ export type ProtocolBindingId = `urn:kya-os:audit-binding:${string}`;
5
+ export type PartyRef = {
6
+ kind: 'public_did';
7
+ did: string;
8
+ } | {
9
+ kind: 'pairwise_did';
10
+ did: string;
11
+ } | {
12
+ kind: 'keyed_commitment';
13
+ value: Digest;
14
+ keyId: string;
15
+ } | {
16
+ kind: 'evidence_ref';
17
+ ref: EvidenceRef;
18
+ };
19
+ /** A cryptographically resolvable signer; never substitute a privacy PartyRef. */
20
+ export interface SignerRef {
21
+ did: string;
22
+ kid: string;
23
+ alg: 'EdDSA' | 'ES256';
24
+ }
25
+ export interface EvidenceEncryptionMetadata {
26
+ suite: 'A256GCM';
27
+ keyId: string;
28
+ nonce: string;
29
+ aadDigest: Digest;
30
+ }
31
+ export interface EvidenceRef {
32
+ objectId: string;
33
+ ciphertextDigest: Digest;
34
+ plaintextCommitment?: Digest;
35
+ mediaType: string;
36
+ size: DecimalString;
37
+ encryption: EvidenceEncryptionMetadata;
38
+ }
39
+ export declare const AUDIT_EVENT_TYPES: readonly ["session.established", "session.rejected", "session.expired", "session.replay_rejected", "tool.call.started", "tool.call.completed", "tool.call.failed", "tool.call.denied", "tool.call.challenged", "proof.generated", "proof.verified", "proof.rejected", "delegation.issued", "delegation.verified", "delegation.rejected", "delegation.revoked", "delegation.cascade_revoked", "delegation.outbound_attached", "authorization.evaluated", "authorization.approved", "authorization.denied", "authorization.step_up_required", "grant.used", "consent.requested", "consent.approved", "consent.denied", "credential.required", "credential.verified", "credential.failed", "key.rotated", "policy.changed", "configuration.changed", "integrity_suite.transitioned", "ledger.epoch.started", "ledger.epoch.transitioned", "checkpoint.created", "checkpoint.anchored", "checkpoint.anchor_failed", "evidence.disposed", "projection.reconciled", "audit.source_high_water", "audit.accessed", "audit.exported", "legal_hold.applied", "retention.executed"];
40
+ export type AuditEventType = (typeof AUDIT_EVENT_TYPES)[number];
41
+ export type AuditEventFamily = 'session' | 'tool' | 'proof' | 'delegation' | 'authorization' | 'consent' | 'key' | 'ledger' | 'administration';
42
+ export type AuditEventDetails = {
43
+ family: 'session';
44
+ phase: 'established' | 'rejected' | 'expired' | 'replay_rejected';
45
+ reasonCode?: string;
46
+ } | {
47
+ family: 'tool';
48
+ phase: 'started' | 'completed' | 'failed' | 'denied' | 'challenged';
49
+ attempt: DecimalString;
50
+ idempotencyRef?: string;
51
+ } | {
52
+ family: 'proof';
53
+ phase: 'generated' | 'verified' | 'rejected';
54
+ proofDigest?: Digest;
55
+ verificationCode?: string;
56
+ } | {
57
+ family: 'delegation';
58
+ phase: 'issued' | 'verified' | 'rejected' | 'revoked' | 'cascade_revoked' | 'outbound_attached';
59
+ delegationRef: string;
60
+ parentRef?: string;
61
+ statusEvidence?: EvidenceRef[];
62
+ } | {
63
+ family: 'authorization';
64
+ phase: 'evaluated' | 'approved' | 'denied' | 'step_up_required' | 'grant_used';
65
+ policyDigest?: Digest;
66
+ grantRef?: string;
67
+ } | {
68
+ family: 'consent';
69
+ phase: 'requested' | 'approved' | 'denied' | 'credential_required' | 'credential_verified' | 'credential_failed';
70
+ consentRef?: string;
71
+ } | {
72
+ family: 'key';
73
+ phase: 'rotated' | 'policy_changed' | 'configuration_changed' | 'integrity_suite_transitioned';
74
+ previousSigner?: SignerRef;
75
+ nextSigner?: SignerRef;
76
+ configurationDigest?: Digest;
77
+ } | {
78
+ family: 'ledger';
79
+ phase: 'epoch_started' | 'epoch_transitioned' | 'checkpoint_created' | 'checkpoint_anchored' | 'checkpoint_anchor_failed' | 'evidence_disposed' | 'projection_reconciled';
80
+ checkpointDigest?: Digest;
81
+ previousEpochId?: string;
82
+ previousTerminalCheckpointDigest?: Digest;
83
+ successorEpochIds?: string[];
84
+ targetEvidenceRef?: EvidenceRef;
85
+ } | {
86
+ family: 'administration';
87
+ phase: 'source_high_water' | 'accessed' | 'exported' | 'legal_hold_applied' | 'retention_executed';
88
+ purpose?: string;
89
+ sourceSequence?: DecimalString;
90
+ selectionDigest?: Digest;
91
+ };
92
+ export interface AuthorizationEvidence {
93
+ source: 'delegation' | 'grant' | 'anonymous' | 'policy';
94
+ decision: 'allowed' | 'denied' | 'step_up_required' | 'needs_authorization';
95
+ scopeId?: string;
96
+ delegationRef?: string;
97
+ delegationCredentialDigest?: Digest;
98
+ delegationChainDigests?: Digest[];
99
+ statusEvidence?: EvidenceRef[];
100
+ grantRef?: string;
101
+ policyId?: string;
102
+ policyVersion?: string;
103
+ policyDigest?: Digest;
104
+ verificationCode?: string;
105
+ }
106
+ export interface AuditProducerEventCoreV1 {
107
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/event/v1.0.0';
108
+ eventId: string;
109
+ eventType: AuditEventType;
110
+ eventVersion: '1.0.0';
111
+ binding: ProtocolBindingId;
112
+ occurredAt: number;
113
+ tenantRef: PartyRef;
114
+ source: {
115
+ producer: PartyRef;
116
+ sourceId: string;
117
+ sourceSequence?: DecimalString;
118
+ previousSourceEventDigest?: Digest;
119
+ };
120
+ correlationId?: string;
121
+ causationId?: string;
122
+ trace?: {
123
+ traceId?: string;
124
+ spanId?: string;
125
+ };
126
+ session?: {
127
+ ref: PartyRef;
128
+ handshakeNonceCommitment?: Digest;
129
+ };
130
+ actor?: PartyRef;
131
+ responsibleParty?: PartyRef;
132
+ resource?: PartyRef;
133
+ action: {
134
+ category: string;
135
+ name?: string;
136
+ detailRef?: EvidenceRef;
137
+ };
138
+ outcome: 'succeeded' | 'failed' | 'denied' | 'challenged' | 'unknown';
139
+ reason?: {
140
+ code: string;
141
+ detailRef?: EvidenceRef;
142
+ };
143
+ authorization?: AuthorizationEvidence;
144
+ proof?: EvidenceRef;
145
+ evidence: EvidenceRef[];
146
+ details: AuditEventDetails;
147
+ privacy: {
148
+ classification: 'public' | 'internal' | 'confidential' | 'restricted';
149
+ retentionClass: string;
150
+ legalHold?: string;
151
+ };
152
+ }
153
+ export interface AuditEntryCoreV1 {
154
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/entry/v1.0.0';
155
+ ledgerId: string;
156
+ ledgerEpochId: string;
157
+ sequence: DecimalString;
158
+ previousEntryDigest: Digest | null;
159
+ recordedAt: number;
160
+ recorder: SignerRef;
161
+ eventDigest: Digest;
162
+ event: AuditProducerEventCoreV1;
163
+ evidenceManifestDigest: Digest;
164
+ integritySuite: 'KYA-AUDIT-JCS-SHA256-JWS-2026';
165
+ }
166
+ export interface AuditRecorderReceiptCoreV1 {
167
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/receipt/v1.0.0';
168
+ ledgerId: string;
169
+ ledgerEpochId: string;
170
+ sequence: DecimalString;
171
+ eventId: string;
172
+ entryDigest: Digest;
173
+ previousEntryDigest: Digest | null;
174
+ recordedAt: number;
175
+ recorder: SignerRef;
176
+ integritySuite: 'KYA-AUDIT-JCS-SHA256-JWS-2026';
177
+ }
178
+ export interface SignedAuditEntryV1 {
179
+ core: AuditEntryCoreV1;
180
+ eventDigest: Digest;
181
+ entryDigest: Digest;
182
+ recorderReceipt: {
183
+ core: AuditRecorderReceiptCoreV1;
184
+ jws: string;
185
+ };
186
+ }
187
+ export interface AuditHead {
188
+ ledgerId: string;
189
+ ledgerEpochId: string;
190
+ sequence: DecimalString;
191
+ entryDigest: Digest;
192
+ }
193
+ export interface AuditLedgerRef {
194
+ ledgerId: string;
195
+ ledgerEpochId: string;
196
+ }
197
+ export type AuditVerdict = 'valid' | 'invalid' | 'indeterminate';
198
+ export interface AuditVerificationDimension {
199
+ verdict: AuditVerdict;
200
+ reasonCodes: string[];
201
+ }
202
+ export interface HistoricalAuditKeyPolicy {
203
+ signer: SignerRef;
204
+ validFrom?: number;
205
+ validUntil?: number;
206
+ validFromCheckpoint?: Digest;
207
+ validUntilCheckpoint?: Digest;
208
+ }
209
+ export interface AuditVerificationPolicyV1 {
210
+ policyId: string;
211
+ trustedLedgerEpochs: Array<{
212
+ ledgerId: string;
213
+ ledgerEpochId: string;
214
+ recorderKeys: HistoricalAuditKeyPolicy[];
215
+ validFromCheckpoint?: Digest;
216
+ validUntilCheckpoint?: Digest;
217
+ }>;
218
+ trustedObservers: HistoricalAuditKeyPolicy[];
219
+ trustedSupportingAnchors?: Array<{
220
+ kind: AuditAnchorReceipt['kind'];
221
+ providerId: string;
222
+ validFrom?: number;
223
+ validUntil?: number;
224
+ }>;
225
+ authorizedExporters: Array<{
226
+ signerKeys: HistoricalAuditKeyPolicy[];
227
+ allowedLedgerIds: string[];
228
+ allowedPurposes: string[];
229
+ }>;
230
+ acceptedIntegritySuites: string[];
231
+ acceptedAlgorithms: Array<'EdDSA' | 'ES256'>;
232
+ keyRevocationMode: 'as_observed' | 'current' | 'both';
233
+ requiredCheckpointFreshnessMs?: number;
234
+ requiredAuditProfile?: 'AAP-0' | 'AAP-1' | 'AAP-2' | 'AAP-3' | 'AAP-4';
235
+ }
236
+ export interface AuditVerificationReportV1 {
237
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/verification-report/v1.0.0';
238
+ policyId: string;
239
+ verifiedAt?: number;
240
+ cryptographicIntegrity: AuditVerificationDimension;
241
+ chainIntegrity: AuditVerificationDimension;
242
+ checkpointIntegrity: AuditVerificationDimension;
243
+ anchorIntegrity: AuditVerificationDimension;
244
+ scopeEvidenceCompleteness: AuditVerificationDimension;
245
+ authorizedAsObserved: AuditVerificationDimension;
246
+ currentAuthorization: AuditVerificationDimension;
247
+ }
248
+ export interface AuditCheckpointCoreV1 {
249
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/checkpoint/v1.0.0';
250
+ checkpointId: string;
251
+ ledgerId: string;
252
+ ledgerEpochId: string;
253
+ treeSize: DecimalString;
254
+ firstSequence: DecimalString;
255
+ lastSequence: DecimalString;
256
+ rootDigest: Digest;
257
+ headEntryDigest: Digest;
258
+ previousCheckpointDigest: Digest | null;
259
+ createdAt: number;
260
+ issuer: SignerRef;
261
+ integritySuite: 'KYA-AUDIT-RFC9162-SHA256-JWS-2026';
262
+ }
263
+ export interface SignedAuditCheckpointV1 {
264
+ core: AuditCheckpointCoreV1;
265
+ checkpointDigest: Digest;
266
+ jws: string;
267
+ }
268
+ export interface AuditMerkleInclusionProofV1 {
269
+ leafIndex: DecimalString;
270
+ treeSize: DecimalString;
271
+ auditPath: Digest[];
272
+ }
273
+ export interface AuditMerkleConsistencyProofV1 {
274
+ oldTreeSize: DecimalString;
275
+ newTreeSize: DecimalString;
276
+ auditPath: Digest[];
277
+ }
278
+ export interface AuditBundleInclusionProofV1 extends AuditLedgerRef {
279
+ sequence: DecimalString;
280
+ entryDigest: Digest;
281
+ checkpointDigest: Digest;
282
+ proof: AuditMerkleInclusionProofV1;
283
+ }
284
+ export interface AuditBundleConsistencyProofV1 extends AuditLedgerRef {
285
+ oldCheckpointDigest: Digest;
286
+ newCheckpointDigest: Digest;
287
+ proof: AuditMerkleConsistencyProofV1;
288
+ }
289
+ export interface AuditObservationReceiptCoreV1 {
290
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/observation/v1.0.0';
291
+ observerId: string;
292
+ observer: SignerRef;
293
+ ledgerId: string;
294
+ ledgerEpochId: string;
295
+ checkpointDigest: Digest;
296
+ treeSize: DecimalString;
297
+ observedAt: number;
298
+ previousObservationDigest: Digest | null;
299
+ }
300
+ export interface AuditObservationReceiptV1 {
301
+ core: AuditObservationReceiptCoreV1;
302
+ observationDigest: Digest;
303
+ jws: string;
304
+ }
305
+ export interface ObservedAuditCheckpoint {
306
+ checkpoint: SignedAuditCheckpointV1;
307
+ receipt: AuditObservationReceiptV1;
308
+ }
309
+ export interface AuditAnchorReceipt {
310
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/anchor-receipt/v1.0.0';
311
+ kind: 'worm' | 'rfc3161' | 'scitt';
312
+ providerId: string;
313
+ checkpointDigest: Digest;
314
+ issuedAt: number;
315
+ receiptData?: string;
316
+ }
317
+ export type AuditBundleDisposition = 'included' | 'redacted' | 'disposed' | 'unavailable' | 'policy_excluded';
318
+ export interface AuditBundleSelectionV1 extends AuditLedgerRef {
319
+ firstSequence: DecimalString;
320
+ lastSequence: DecimalString;
321
+ expectedHeadDigest: Digest;
322
+ checkpointTreeSizes: DecimalString[];
323
+ }
324
+ export interface AuditBundleInventoryItemV1 {
325
+ path: string;
326
+ mediaType: string;
327
+ disposition: AuditBundleDisposition;
328
+ digest?: Digest;
329
+ size?: DecimalString;
330
+ reasonCode?: string;
331
+ }
332
+ export interface AuditBundleManifestCoreV1 {
333
+ schema: 'https://schema.kya-os.org/v1/protocol/audit/bundle-manifest/v1.0.0';
334
+ bundleId: string;
335
+ formatVersion: '1.0.0';
336
+ selections: AuditBundleSelectionV1[];
337
+ exporter: SignerRef;
338
+ purpose: string;
339
+ exportedAt: number;
340
+ verificationPolicyDigest: Digest;
341
+ inventory: AuditBundleInventoryItemV1[];
342
+ integritySuite: 'KYA-AUDIT-BUNDLE-JCS-SHA256-JWS-2026';
343
+ }
344
+ export interface SignedAuditBundleManifestV1 {
345
+ core: AuditBundleManifestCoreV1;
346
+ manifestDigest: Digest;
347
+ jws: string;
348
+ }
349
+ export interface AuditBundleComponentV1 extends AuditBundleInventoryItemV1 {
350
+ content?: unknown;
351
+ }
352
+ export interface AuditReplayBundleV1 {
353
+ manifest: SignedAuditBundleManifestV1;
354
+ components: AuditBundleComponentV1[];
355
+ }
356
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ /** Wire-level types for the KYA-OS Auditability Protocol v1. */
2
+ export const AUDIT_EVENT_TYPES = [
3
+ 'session.established',
4
+ 'session.rejected',
5
+ 'session.expired',
6
+ 'session.replay_rejected',
7
+ 'tool.call.started',
8
+ 'tool.call.completed',
9
+ 'tool.call.failed',
10
+ 'tool.call.denied',
11
+ 'tool.call.challenged',
12
+ 'proof.generated',
13
+ 'proof.verified',
14
+ 'proof.rejected',
15
+ 'delegation.issued',
16
+ 'delegation.verified',
17
+ 'delegation.rejected',
18
+ 'delegation.revoked',
19
+ 'delegation.cascade_revoked',
20
+ 'delegation.outbound_attached',
21
+ 'authorization.evaluated',
22
+ 'authorization.approved',
23
+ 'authorization.denied',
24
+ 'authorization.step_up_required',
25
+ 'grant.used',
26
+ 'consent.requested',
27
+ 'consent.approved',
28
+ 'consent.denied',
29
+ 'credential.required',
30
+ 'credential.verified',
31
+ 'credential.failed',
32
+ 'key.rotated',
33
+ 'policy.changed',
34
+ 'configuration.changed',
35
+ 'integrity_suite.transitioned',
36
+ 'ledger.epoch.started',
37
+ 'ledger.epoch.transitioned',
38
+ 'checkpoint.created',
39
+ 'checkpoint.anchored',
40
+ 'checkpoint.anchor_failed',
41
+ 'evidence.disposed',
42
+ 'projection.reconciled',
43
+ 'audit.source_high_water',
44
+ 'audit.accessed',
45
+ 'audit.exported',
46
+ 'legal_hold.applied',
47
+ 'retention.executed',
48
+ ];
49
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAmChE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,qBAAqB;IACrB,kBAAkB;IAClB,iBAAiB;IACjB,yBAAyB;IACzB,mBAAmB;IACnB,qBAAqB;IACrB,kBAAkB;IAClB,kBAAkB;IAClB,sBAAsB;IACtB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,4BAA4B;IAC5B,8BAA8B;IAC9B,yBAAyB;IACzB,wBAAwB;IACxB,sBAAsB;IACtB,gCAAgC;IAChC,YAAY;IACZ,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,qBAAqB;IACrB,qBAAqB;IACrB,mBAAmB;IACnB,aAAa;IACb,gBAAgB;IAChB,uBAAuB;IACvB,8BAA8B;IAC9B,sBAAsB;IACtB,2BAA2B;IAC3B,oBAAoB;IACpB,qBAAqB;IACrB,0BAA0B;IAC1B,mBAAmB;IACnB,uBAAuB;IACvB,yBAAyB;IACzB,gBAAgB;IAChB,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;CACZ,CAAC"}
@@ -0,0 +1,73 @@
1
+ import { type AuditHasher, type AuditSignatureVerifier } from './crypto.js';
2
+ import type { AuditVerificationDimension, AuditObservationReceiptV1, AuditVerificationPolicyV1, AuditVerificationReportV1, SignedAuditCheckpointV1, SignedAuditEntryV1 } from './types.js';
3
+ export declare const AUDIT_REASON_CODES: Readonly<{
4
+ readonly NOT_EVALUATED: "AUDIT_NOT_EVALUATED";
5
+ readonly SCHEMA_INVALID: "AUDIT_SCHEMA_INVALID";
6
+ readonly UNSUPPORTED_SUITE: "AUDIT_UNSUPPORTED_SUITE";
7
+ readonly UNSUPPORTED_ALGORITHM: "AUDIT_UNSUPPORTED_ALGORITHM";
8
+ readonly UNTRUSTED_RECORDER: "AUDIT_UNTRUSTED_RECORDER";
9
+ readonly SIGNATURE_INVALID: "AUDIT_SIGNATURE_INVALID";
10
+ readonly EVENT_DIGEST_MISMATCH: "AUDIT_EVENT_DIGEST_MISMATCH";
11
+ readonly EVIDENCE_MANIFEST_DIGEST_MISMATCH: "AUDIT_EVIDENCE_MANIFEST_DIGEST_MISMATCH";
12
+ readonly ENTRY_DIGEST_MISMATCH: "AUDIT_ENTRY_DIGEST_MISMATCH";
13
+ readonly RECEIPT_MISMATCH: "AUDIT_RECEIPT_MISMATCH";
14
+ readonly LEDGER_SCOPE_MISMATCH: "AUDIT_LEDGER_SCOPE_MISMATCH";
15
+ readonly SEQUENCE_GAP: "AUDIT_SEQUENCE_GAP";
16
+ readonly PREDECESSOR_MISMATCH: "AUDIT_PREDECESSOR_MISMATCH";
17
+ readonly GENESIS_INVALID: "AUDIT_GENESIS_INVALID";
18
+ readonly CHECKPOINT_MISSING: "AUDIT_CHECKPOINT_MISSING";
19
+ readonly CHECKPOINT_DIGEST_MISMATCH: "AUDIT_CHECKPOINT_DIGEST_MISMATCH";
20
+ readonly CHECKPOINT_SIGNATURE_INVALID: "AUDIT_CHECKPOINT_SIGNATURE_INVALID";
21
+ readonly CHECKPOINT_ROOT_MISMATCH: "AUDIT_CHECKPOINT_ROOT_MISMATCH";
22
+ readonly CHECKPOINT_RANGE_MISMATCH: "AUDIT_CHECKPOINT_RANGE_MISMATCH";
23
+ readonly CHECKPOINT_CHAIN_MISMATCH: "AUDIT_CHECKPOINT_CHAIN_MISMATCH";
24
+ readonly CHECKPOINT_FORK_DETECTED: "AUDIT_CHECKPOINT_FORK_DETECTED";
25
+ readonly MERKLE_PROOF_INVALID: "AUDIT_MERKLE_PROOF_INVALID";
26
+ readonly OBSERVER_EVIDENCE_MISSING: "AUDIT_OBSERVER_EVIDENCE_MISSING";
27
+ readonly OBSERVATION_DIGEST_MISMATCH: "AUDIT_OBSERVATION_DIGEST_MISMATCH";
28
+ readonly OBSERVATION_SIGNATURE_INVALID: "AUDIT_OBSERVATION_SIGNATURE_INVALID";
29
+ readonly OBSERVATION_SCOPE_MISMATCH: "AUDIT_OBSERVATION_SCOPE_MISMATCH";
30
+ readonly UNTRUSTED_OBSERVER: "AUDIT_UNTRUSTED_OBSERVER";
31
+ readonly OBSERVATION_STALE: "AUDIT_OBSERVATION_STALE";
32
+ readonly OBSERVATION_CHAIN_MISMATCH: "AUDIT_OBSERVATION_CHAIN_MISMATCH";
33
+ readonly UNTRUSTED_SUPPORTING_ANCHOR: "AUDIT_UNTRUSTED_SUPPORTING_ANCHOR";
34
+ readonly SUPPORTING_ANCHOR_INVALID: "AUDIT_SUPPORTING_ANCHOR_INVALID";
35
+ readonly AUTHORIZATION_EVIDENCE_MISSING: "AUDIT_AUTHORIZATION_EVIDENCE_MISSING";
36
+ readonly AUTHORIZATION_COLLATERAL_NOT_VERIFIED: "AUDIT_AUTHORIZATION_COLLATERAL_NOT_VERIFIED";
37
+ readonly CURRENT_AUTHORIZATION_NOT_EVALUATED: "AUDIT_CURRENT_AUTHORIZATION_NOT_EVALUATED";
38
+ readonly BUNDLE_SCHEMA_INVALID: "AUDIT_BUNDLE_SCHEMA_INVALID";
39
+ readonly BUNDLE_MANIFEST_DIGEST_MISMATCH: "AUDIT_BUNDLE_MANIFEST_DIGEST_MISMATCH";
40
+ readonly BUNDLE_SIGNATURE_INVALID: "AUDIT_BUNDLE_SIGNATURE_INVALID";
41
+ readonly BUNDLE_EXPORTER_UNAUTHORIZED: "AUDIT_BUNDLE_EXPORTER_UNAUTHORIZED";
42
+ readonly BUNDLE_INVENTORY_MISMATCH: "AUDIT_BUNDLE_INVENTORY_MISMATCH";
43
+ readonly BUNDLE_COMPONENT_DIGEST_MISMATCH: "AUDIT_BUNDLE_COMPONENT_DIGEST_MISMATCH";
44
+ readonly BUNDLE_SELECTION_INCOMPLETE: "AUDIT_BUNDLE_SELECTION_INCOMPLETE";
45
+ readonly VERIFICATION_POLICY_MISMATCH: "AUDIT_VERIFICATION_POLICY_MISMATCH";
46
+ readonly VERIFICATION_POLICY_INVALID: "AUDIT_VERIFICATION_POLICY_INVALID";
47
+ readonly EXPLICITLY_REDACTED: "AUDIT_EXPLICITLY_REDACTED";
48
+ readonly EXPLICITLY_DISPOSED: "AUDIT_EXPLICITLY_DISPOSED";
49
+ readonly EXPLICITLY_UNAVAILABLE: "AUDIT_EXPLICITLY_UNAVAILABLE";
50
+ }>;
51
+ export interface AuditArtifactVerifierOptions {
52
+ hasher: AuditHasher;
53
+ signatures: AuditSignatureVerifier;
54
+ verifiedAt?: () => number;
55
+ authorization?: AuditAuthorizationVerifier;
56
+ }
57
+ /** Optional collateral verifier kept separate from structural/cryptographic verification. */
58
+ export interface AuditAuthorizationVerifier {
59
+ verifyAsObserved(entries: readonly SignedAuditEntryV1[], policy: AuditVerificationPolicyV1): Promise<AuditVerificationDimension>;
60
+ verifyCurrent(entries: readonly SignedAuditEntryV1[], policy: AuditVerificationPolicyV1): Promise<AuditVerificationDimension>;
61
+ }
62
+ /** Pure historical verifier. It never reads live nonce state or applies current freshness. */
63
+ export declare class AuditArtifactVerifier {
64
+ private readonly options;
65
+ constructor(options: AuditArtifactVerifierOptions);
66
+ verifyEntries(entries: readonly unknown[], policy: AuditVerificationPolicyV1 | unknown): Promise<AuditVerificationReportV1>;
67
+ verifyCheckpoint(checkpoint: SignedAuditCheckpointV1, entries: readonly SignedAuditEntryV1[], policy: AuditVerificationPolicyV1): Promise<AuditVerificationDimension>;
68
+ verifyObservation(checkpoint: SignedAuditCheckpointV1, receipt: AuditObservationReceiptV1, policy: AuditVerificationPolicyV1): Promise<AuditVerificationDimension>;
69
+ private verifyEntry;
70
+ private verifyChainPosition;
71
+ }
72
+ export declare function mergeAuditDimensions(...values: readonly AuditVerificationDimension[]): AuditVerificationDimension;
73
+ //# sourceMappingURL=verifier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/audit/verifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAe5F,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EAEzB,uBAAuB,EACvB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CpB,CAAC;AA6CZ,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,sBAAsB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,0BAA0B,CAAC;CAC5C;AAED,6FAA6F;AAC7F,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CACd,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,aAAa,CACX,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC;AAED,8FAA8F;AAC9F,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,4BAA4B;IAE5D,aAAa,CACjB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,MAAM,EAAE,yBAAyB,GAAG,OAAO,GAC1C,OAAO,CAAC,yBAAyB,CAAC;IAqE/B,gBAAgB,CACpB,UAAU,EAAE,uBAAuB,EACnC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC;IA4DhC,iBAAiB,CACrB,UAAU,EAAE,uBAAuB,EACnC,OAAO,EAAE,yBAAyB,EAClC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,0BAA0B,CAAC;YA6DxB,WAAW;IA+CzB,OAAO,CAAC,mBAAmB;CAgC5B;AAED,wBAAgB,oBAAoB,CAClC,GAAG,MAAM,EAAE,SAAS,0BAA0B,EAAE,GAC/C,0BAA0B,CAS5B"}