@kya-os/checkpoint-shared 1.2.0 → 1.3.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/README.md +1 -1
- package/dist/beacon-types/index.d.mts +10 -1
- package/dist/beacon-types/index.d.ts +10 -1
- package/dist/beacon-types/index.js +20 -1
- package/dist/beacon-types/index.mjs +20 -2
- package/dist/browser.d.mts +6 -1
- package/dist/browser.d.ts +6 -1
- package/dist/browser.js +1 -1
- package/dist/browser.mjs +1 -1
- package/dist/canonical-signer/index.js +31 -2
- package/dist/canonical-signer/index.mjs +31 -2
- package/dist/deploy/index.d.mts +827 -0
- package/dist/deploy/index.d.ts +827 -0
- package/dist/deploy/index.js +458 -0
- package/dist/deploy/index.mjs +433 -0
- package/dist/gateway/index.d.mts +575 -0
- package/dist/gateway/index.d.ts +575 -0
- package/dist/gateway/index.js +98 -0
- package/dist/gateway/index.mjs +88 -0
- package/dist/index.d.mts +3071 -871
- package/dist/index.d.ts +3071 -871
- package/dist/index.js +3344 -1308
- package/dist/index.mjs +4593 -2667
- package/dist/mcpi/agentshield-api/index.d.mts +47 -0
- package/dist/mcpi/agentshield-api/index.d.ts +47 -0
- package/dist/mcpi/agentshield-api/index.js +2 -0
- package/dist/mcpi/agentshield-api/index.mjs +1 -0
- package/dist/mcpi/approval-grant/index.d.mts +79 -0
- package/dist/mcpi/approval-grant/index.d.ts +79 -0
- package/dist/mcpi/approval-grant/index.js +157 -0
- package/dist/mcpi/approval-grant/index.mjs +150 -0
- package/dist/mcpi/dashboard-config/index.d.mts +14075 -0
- package/dist/mcpi/dashboard-config/index.d.ts +14075 -0
- package/dist/mcpi/dashboard-config/index.js +517 -0
- package/dist/mcpi/dashboard-config/index.mjs +492 -0
- package/dist/mcpi/multibase-ed25519.d.mts +8 -0
- package/dist/mcpi/multibase-ed25519.d.ts +8 -0
- package/dist/mcpi/multibase-ed25519.js +125 -0
- package/dist/mcpi/multibase-ed25519.mjs +119 -0
- package/dist/signals/index.d.mts +158 -0
- package/dist/signals/index.d.ts +158 -0
- package/dist/signals/index.js +1574 -0
- package/dist/signals/index.mjs +1544 -0
- package/dist/test-fixtures/index.d.mts +53 -8
- package/dist/test-fixtures/index.d.ts +53 -8
- package/dist/test-fixtures/index.js +164 -7
- package/dist/test-fixtures/index.mjs +158 -8
- package/dist/tool-protection/index.d.mts +1120 -0
- package/dist/tool-protection/index.d.ts +1120 -0
- package/dist/tool-protection/index.js +370 -0
- package/dist/tool-protection/index.mjs +338 -0
- package/package.json +54 -8
- package/src/data/compiled/merged-rules.json +8 -2
|
@@ -31,14 +31,14 @@ declare const MCPI_DELEGATION_TEST_KEYPAIR: {
|
|
|
31
31
|
readonly privateKeyBase64: "AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE=";
|
|
32
32
|
readonly publicKeyBase64: "iojj3XQJ8ZX9UtstPLpdcspnCb8dlBIb83SIAbQPb1w=";
|
|
33
33
|
};
|
|
34
|
-
declare const MCPI_DELEGATION_ISSUER_DID = "did:web:
|
|
35
|
-
declare const MCPI_DELEGATION_ISSUER_KID = "did:web:
|
|
34
|
+
declare const MCPI_DELEGATION_ISSUER_DID = "did:web:kya.vouched.id:orgs:test-org";
|
|
35
|
+
declare const MCPI_DELEGATION_ISSUER_KID = "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
36
36
|
declare const MCPI_DELEGATION_AGENT_DID = "did:key:z6MkTestAgent123";
|
|
37
37
|
declare const MCPI_DELEGATION_USER_DID = "did:key:z6MkTestUser456";
|
|
38
38
|
declare const MCPI_DELEGATION_STATUS_LIST_URL = "https://kya.vouched.id/api/v1/gateway/oauth/status-list";
|
|
39
39
|
declare const MCPI_DELEGATION_AUDIENCE = "https://gateway.knowthat.ai";
|
|
40
40
|
declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
41
|
-
readonly iss: "did:web:
|
|
41
|
+
readonly iss: "did:web:kya.vouched.id:orgs:test-org";
|
|
42
42
|
readonly sub: "did:key:z6MkTestAgent123";
|
|
43
43
|
readonly aud: "https://gateway.knowthat.ai";
|
|
44
44
|
readonly iat: 1712975940;
|
|
@@ -46,14 +46,14 @@ declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
|
46
46
|
readonly vc: {
|
|
47
47
|
readonly '@context': readonly ["https://www.w3.org/2018/credentials/v1", "https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json"];
|
|
48
48
|
readonly type: readonly ["VerifiableCredential", "DelegationCredential"];
|
|
49
|
-
readonly issuer: "did:web:
|
|
49
|
+
readonly issuer: "did:web:kya.vouched.id:orgs:test-org";
|
|
50
50
|
readonly issuanceDate: "2024-04-13T02:39:00.000Z";
|
|
51
51
|
readonly expirationDate: "2024-04-13T03:39:00.000Z";
|
|
52
52
|
readonly credentialSubject: {
|
|
53
53
|
readonly id: "did:key:z6MkTestAgent123";
|
|
54
54
|
readonly delegation: {
|
|
55
55
|
readonly id: "del-test-001";
|
|
56
|
-
readonly issuerDid: "did:web:
|
|
56
|
+
readonly issuerDid: "did:web:kya.vouched.id:orgs:test-org";
|
|
57
57
|
readonly subjectDid: "did:key:z6MkTestAgent123";
|
|
58
58
|
readonly userDid: "did:key:z6MkTestUser456";
|
|
59
59
|
readonly userIdentifier: "alice@vouched.id";
|
|
@@ -82,8 +82,53 @@ declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
|
82
82
|
declare const MCPI_DELEGATION_EXPECTED_HEADER: {
|
|
83
83
|
readonly alg: "EdDSA";
|
|
84
84
|
readonly typ: "JWT";
|
|
85
|
-
readonly kid: "did:web:
|
|
85
|
+
readonly kid: "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
86
|
+
};
|
|
87
|
+
declare const MCPI_DELEGATION_EXPECTED_JWT = "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCIsImtpZCI6ImRpZDp3ZWI6a3lhLnZvdWNoZWQuaWQ6b3Jnczp0ZXN0LW9yZyNrZXktMSJ9.eyJpc3MiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWIiOiJkaWQ6a2V5Ono2TWtUZXN0QWdlbnQxMjMiLCJhdWQiOiJodHRwczovL2dhdGV3YXkua25vd3RoYXQuYWkiLCJpYXQiOjE3MTI5NzU5NDAsImV4cCI6MTcxMjk3OTU0MCwidmMiOnsiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiLCJodHRwczovL3NjaGVtYS5tb2RlbGNvbnRleHRwcm90b2NvbC1pZGVudGl0eS5pby94bWNwLWkvY3JlZGVudGlhbHMvZGVsZWdhdGlvbi52MS4wLjAuanNvbiJdLCJ0eXBlIjpbIlZlcmlmaWFibGVDcmVkZW50aWFsIiwiRGVsZWdhdGlvbkNyZWRlbnRpYWwiXSwiaXNzdWVyIjoiZGlkOndlYjpreWEudm91Y2hlZC5pZDpvcmdzOnRlc3Qtb3JnIiwiaXNzdWFuY2VEYXRlIjoiMjAyNC0wNC0xM1QwMjozOTowMC4wMDBaIiwiZXhwaXJhdGlvbkRhdGUiOiIyMDI0LTA0LTEzVDAzOjM5OjAwLjAwMFoiLCJjcmVkZW50aWFsU3ViamVjdCI6eyJpZCI6ImRpZDprZXk6ejZNa1Rlc3RBZ2VudDEyMyIsImRlbGVnYXRpb24iOnsiaWQiOiJkZWwtdGVzdC0wMDEiLCJpc3N1ZXJEaWQiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWJqZWN0RGlkIjoiZGlkOmtleTp6Nk1rVGVzdEFnZW50MTIzIiwidXNlckRpZCI6ImRpZDprZXk6ejZNa1Rlc3RVc2VyNDU2IiwidXNlcklkZW50aWZpZXIiOiJhbGljZUB2b3VjaGVkLmlkIiwic2NvcGVzIjpbIm1jcCJdLCJjb25zdHJhaW50cyI6eyJub3RCZWZvcmUiOjE3MTI5NzU5NDAsIm5vdEFmdGVyIjoxNzEyOTc5NTQwLCJzY29wZXMiOlsibWNwIl0sImF1ZGllbmNlIjoiaHR0cHM6Ly9nYXRld2F5Lmtub3d0aGF0LmFpIn0sInN0YXR1cyI6ImFjdGl2ZSJ9fSwiY3JlZGVudGlhbFN0YXR1cyI6eyJpZCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QjNDIiLCJ0eXBlIjoiU3RhdHVzTGlzdDIwMjFFbnRyeSIsInN0YXR1c1B1cnBvc2UiOiJyZXZvY2F0aW9uIiwic3RhdHVzTGlzdEluZGV4IjoiNDIiLCJzdGF0dXNMaXN0Q3JlZGVudGlhbCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QifX0sIm9yZ0lkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDEwIiwib3JnU2x1ZyI6InRlc3Qtb3JnIiwic2Vzc2lvbklkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDIwIn0.KEF-cDuLUb-OTJHAXhK2A7VGWpGzdIRY0v4jK-0OXoPqKEadPOHAw1EaEl2V_1NeGyw69V3CRtKug_gx9ZIUBA";
|
|
88
|
+
|
|
89
|
+
type FetcherPredicateDetectionClass = 'human' | 'ai_agent' | 'bot' | 'incomplete_data' | null;
|
|
90
|
+
interface FetcherEnvelopePredicateVector {
|
|
91
|
+
description: string;
|
|
92
|
+
headers: Record<string, string>;
|
|
93
|
+
detectionClass: FetcherPredicateDetectionClass;
|
|
94
|
+
isAgent: boolean;
|
|
95
|
+
expected: boolean;
|
|
96
|
+
}
|
|
97
|
+
declare const FETCHER_200_PREDICATE_VECTORS: readonly FetcherEnvelopePredicateVector[];
|
|
98
|
+
|
|
99
|
+
type DelegationVerdictKind = 'Permit' | 'Block';
|
|
100
|
+
type CoarseReasonKind = 'signature' | 'claim' | 'time' | 'revocation' | 'scope' | 'resolve';
|
|
101
|
+
interface DelegationVerdictReason {
|
|
102
|
+
kind: CoarseReasonKind;
|
|
103
|
+
}
|
|
104
|
+
interface DelegationVerdict {
|
|
105
|
+
kind: DelegationVerdictKind;
|
|
106
|
+
reason: DelegationVerdictReason | null;
|
|
107
|
+
}
|
|
108
|
+
declare function toCoarseReasonKind(rawReasonKind: string): CoarseReasonKind;
|
|
109
|
+
declare function permitDelegationVerdict(): DelegationVerdict;
|
|
110
|
+
declare function blockDelegationVerdict(rawReasonKind: string): DelegationVerdict;
|
|
111
|
+
|
|
112
|
+
declare function detectionSignalFixture(overrides?: Partial<{
|
|
113
|
+
signalType: 'signature' | 'pattern' | 'behavioral' | 'network' | 'fingerprint';
|
|
114
|
+
confidence: number;
|
|
115
|
+
weight: number;
|
|
116
|
+
source: string;
|
|
117
|
+
explanation: string;
|
|
118
|
+
}>): {
|
|
119
|
+
signalType: "signature" | "pattern" | "behavioral" | "network" | "fingerprint";
|
|
120
|
+
confidence: number;
|
|
121
|
+
weight: number;
|
|
122
|
+
source: string;
|
|
123
|
+
explanation: string;
|
|
86
124
|
};
|
|
87
|
-
declare const
|
|
125
|
+
declare const TWO_SIGNAL_EVIDENCE_FIXTURE: {
|
|
126
|
+
signalType: "signature" | "pattern" | "behavioral" | "network" | "fingerprint";
|
|
127
|
+
confidence: number;
|
|
128
|
+
weight: number;
|
|
129
|
+
source: string;
|
|
130
|
+
explanation: string;
|
|
131
|
+
}[];
|
|
132
|
+
declare const TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE = 94.78;
|
|
88
133
|
|
|
89
|
-
export { MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH };
|
|
134
|
+
export { type CoarseReasonKind, type DelegationVerdict, type DelegationVerdictKind, type DelegationVerdictReason, FETCHER_200_PREDICATE_VECTORS, type FetcherEnvelopePredicateVector, type FetcherPredicateDetectionClass, MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE, TWO_SIGNAL_EVIDENCE_FIXTURE, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH, blockDelegationVerdict, detectionSignalFixture, permitDelegationVerdict, toCoarseReasonKind };
|
|
@@ -31,14 +31,14 @@ declare const MCPI_DELEGATION_TEST_KEYPAIR: {
|
|
|
31
31
|
readonly privateKeyBase64: "AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE=";
|
|
32
32
|
readonly publicKeyBase64: "iojj3XQJ8ZX9UtstPLpdcspnCb8dlBIb83SIAbQPb1w=";
|
|
33
33
|
};
|
|
34
|
-
declare const MCPI_DELEGATION_ISSUER_DID = "did:web:
|
|
35
|
-
declare const MCPI_DELEGATION_ISSUER_KID = "did:web:
|
|
34
|
+
declare const MCPI_DELEGATION_ISSUER_DID = "did:web:kya.vouched.id:orgs:test-org";
|
|
35
|
+
declare const MCPI_DELEGATION_ISSUER_KID = "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
36
36
|
declare const MCPI_DELEGATION_AGENT_DID = "did:key:z6MkTestAgent123";
|
|
37
37
|
declare const MCPI_DELEGATION_USER_DID = "did:key:z6MkTestUser456";
|
|
38
38
|
declare const MCPI_DELEGATION_STATUS_LIST_URL = "https://kya.vouched.id/api/v1/gateway/oauth/status-list";
|
|
39
39
|
declare const MCPI_DELEGATION_AUDIENCE = "https://gateway.knowthat.ai";
|
|
40
40
|
declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
41
|
-
readonly iss: "did:web:
|
|
41
|
+
readonly iss: "did:web:kya.vouched.id:orgs:test-org";
|
|
42
42
|
readonly sub: "did:key:z6MkTestAgent123";
|
|
43
43
|
readonly aud: "https://gateway.knowthat.ai";
|
|
44
44
|
readonly iat: 1712975940;
|
|
@@ -46,14 +46,14 @@ declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
|
46
46
|
readonly vc: {
|
|
47
47
|
readonly '@context': readonly ["https://www.w3.org/2018/credentials/v1", "https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json"];
|
|
48
48
|
readonly type: readonly ["VerifiableCredential", "DelegationCredential"];
|
|
49
|
-
readonly issuer: "did:web:
|
|
49
|
+
readonly issuer: "did:web:kya.vouched.id:orgs:test-org";
|
|
50
50
|
readonly issuanceDate: "2024-04-13T02:39:00.000Z";
|
|
51
51
|
readonly expirationDate: "2024-04-13T03:39:00.000Z";
|
|
52
52
|
readonly credentialSubject: {
|
|
53
53
|
readonly id: "did:key:z6MkTestAgent123";
|
|
54
54
|
readonly delegation: {
|
|
55
55
|
readonly id: "del-test-001";
|
|
56
|
-
readonly issuerDid: "did:web:
|
|
56
|
+
readonly issuerDid: "did:web:kya.vouched.id:orgs:test-org";
|
|
57
57
|
readonly subjectDid: "did:key:z6MkTestAgent123";
|
|
58
58
|
readonly userDid: "did:key:z6MkTestUser456";
|
|
59
59
|
readonly userIdentifier: "alice@vouched.id";
|
|
@@ -82,8 +82,53 @@ declare const MCPI_DELEGATION_CANONICAL_PAYLOAD: {
|
|
|
82
82
|
declare const MCPI_DELEGATION_EXPECTED_HEADER: {
|
|
83
83
|
readonly alg: "EdDSA";
|
|
84
84
|
readonly typ: "JWT";
|
|
85
|
-
readonly kid: "did:web:
|
|
85
|
+
readonly kid: "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
86
|
+
};
|
|
87
|
+
declare const MCPI_DELEGATION_EXPECTED_JWT = "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCIsImtpZCI6ImRpZDp3ZWI6a3lhLnZvdWNoZWQuaWQ6b3Jnczp0ZXN0LW9yZyNrZXktMSJ9.eyJpc3MiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWIiOiJkaWQ6a2V5Ono2TWtUZXN0QWdlbnQxMjMiLCJhdWQiOiJodHRwczovL2dhdGV3YXkua25vd3RoYXQuYWkiLCJpYXQiOjE3MTI5NzU5NDAsImV4cCI6MTcxMjk3OTU0MCwidmMiOnsiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiLCJodHRwczovL3NjaGVtYS5tb2RlbGNvbnRleHRwcm90b2NvbC1pZGVudGl0eS5pby94bWNwLWkvY3JlZGVudGlhbHMvZGVsZWdhdGlvbi52MS4wLjAuanNvbiJdLCJ0eXBlIjpbIlZlcmlmaWFibGVDcmVkZW50aWFsIiwiRGVsZWdhdGlvbkNyZWRlbnRpYWwiXSwiaXNzdWVyIjoiZGlkOndlYjpreWEudm91Y2hlZC5pZDpvcmdzOnRlc3Qtb3JnIiwiaXNzdWFuY2VEYXRlIjoiMjAyNC0wNC0xM1QwMjozOTowMC4wMDBaIiwiZXhwaXJhdGlvbkRhdGUiOiIyMDI0LTA0LTEzVDAzOjM5OjAwLjAwMFoiLCJjcmVkZW50aWFsU3ViamVjdCI6eyJpZCI6ImRpZDprZXk6ejZNa1Rlc3RBZ2VudDEyMyIsImRlbGVnYXRpb24iOnsiaWQiOiJkZWwtdGVzdC0wMDEiLCJpc3N1ZXJEaWQiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWJqZWN0RGlkIjoiZGlkOmtleTp6Nk1rVGVzdEFnZW50MTIzIiwidXNlckRpZCI6ImRpZDprZXk6ejZNa1Rlc3RVc2VyNDU2IiwidXNlcklkZW50aWZpZXIiOiJhbGljZUB2b3VjaGVkLmlkIiwic2NvcGVzIjpbIm1jcCJdLCJjb25zdHJhaW50cyI6eyJub3RCZWZvcmUiOjE3MTI5NzU5NDAsIm5vdEFmdGVyIjoxNzEyOTc5NTQwLCJzY29wZXMiOlsibWNwIl0sImF1ZGllbmNlIjoiaHR0cHM6Ly9nYXRld2F5Lmtub3d0aGF0LmFpIn0sInN0YXR1cyI6ImFjdGl2ZSJ9fSwiY3JlZGVudGlhbFN0YXR1cyI6eyJpZCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QjNDIiLCJ0eXBlIjoiU3RhdHVzTGlzdDIwMjFFbnRyeSIsInN0YXR1c1B1cnBvc2UiOiJyZXZvY2F0aW9uIiwic3RhdHVzTGlzdEluZGV4IjoiNDIiLCJzdGF0dXNMaXN0Q3JlZGVudGlhbCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QifX0sIm9yZ0lkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDEwIiwib3JnU2x1ZyI6InRlc3Qtb3JnIiwic2Vzc2lvbklkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDIwIn0.KEF-cDuLUb-OTJHAXhK2A7VGWpGzdIRY0v4jK-0OXoPqKEadPOHAw1EaEl2V_1NeGyw69V3CRtKug_gx9ZIUBA";
|
|
88
|
+
|
|
89
|
+
type FetcherPredicateDetectionClass = 'human' | 'ai_agent' | 'bot' | 'incomplete_data' | null;
|
|
90
|
+
interface FetcherEnvelopePredicateVector {
|
|
91
|
+
description: string;
|
|
92
|
+
headers: Record<string, string>;
|
|
93
|
+
detectionClass: FetcherPredicateDetectionClass;
|
|
94
|
+
isAgent: boolean;
|
|
95
|
+
expected: boolean;
|
|
96
|
+
}
|
|
97
|
+
declare const FETCHER_200_PREDICATE_VECTORS: readonly FetcherEnvelopePredicateVector[];
|
|
98
|
+
|
|
99
|
+
type DelegationVerdictKind = 'Permit' | 'Block';
|
|
100
|
+
type CoarseReasonKind = 'signature' | 'claim' | 'time' | 'revocation' | 'scope' | 'resolve';
|
|
101
|
+
interface DelegationVerdictReason {
|
|
102
|
+
kind: CoarseReasonKind;
|
|
103
|
+
}
|
|
104
|
+
interface DelegationVerdict {
|
|
105
|
+
kind: DelegationVerdictKind;
|
|
106
|
+
reason: DelegationVerdictReason | null;
|
|
107
|
+
}
|
|
108
|
+
declare function toCoarseReasonKind(rawReasonKind: string): CoarseReasonKind;
|
|
109
|
+
declare function permitDelegationVerdict(): DelegationVerdict;
|
|
110
|
+
declare function blockDelegationVerdict(rawReasonKind: string): DelegationVerdict;
|
|
111
|
+
|
|
112
|
+
declare function detectionSignalFixture(overrides?: Partial<{
|
|
113
|
+
signalType: 'signature' | 'pattern' | 'behavioral' | 'network' | 'fingerprint';
|
|
114
|
+
confidence: number;
|
|
115
|
+
weight: number;
|
|
116
|
+
source: string;
|
|
117
|
+
explanation: string;
|
|
118
|
+
}>): {
|
|
119
|
+
signalType: "signature" | "pattern" | "behavioral" | "network" | "fingerprint";
|
|
120
|
+
confidence: number;
|
|
121
|
+
weight: number;
|
|
122
|
+
source: string;
|
|
123
|
+
explanation: string;
|
|
86
124
|
};
|
|
87
|
-
declare const
|
|
125
|
+
declare const TWO_SIGNAL_EVIDENCE_FIXTURE: {
|
|
126
|
+
signalType: "signature" | "pattern" | "behavioral" | "network" | "fingerprint";
|
|
127
|
+
confidence: number;
|
|
128
|
+
weight: number;
|
|
129
|
+
source: string;
|
|
130
|
+
explanation: string;
|
|
131
|
+
}[];
|
|
132
|
+
declare const TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE = 94.78;
|
|
88
133
|
|
|
89
|
-
export { MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH };
|
|
134
|
+
export { type CoarseReasonKind, type DelegationVerdict, type DelegationVerdictKind, type DelegationVerdictReason, FETCHER_200_PREDICATE_VECTORS, type FetcherEnvelopePredicateVector, type FetcherPredicateDetectionClass, MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE, TWO_SIGNAL_EVIDENCE_FIXTURE, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH, blockDelegationVerdict, detectionSignalFixture, permitDelegationVerdict, toCoarseReasonKind };
|
|
@@ -39,32 +39,39 @@ var MCPI_DELEGATION_TEST_KEYPAIR = {
|
|
|
39
39
|
/** Raw 32-byte Ed25519 public key derived from the private seed, base64-encoded. */
|
|
40
40
|
publicKeyBase64: "iojj3XQJ8ZX9UtstPLpdcspnCb8dlBIb83SIAbQPb1w="
|
|
41
41
|
};
|
|
42
|
-
var MCPI_DELEGATION_ISSUER_DID = "did:web:
|
|
43
|
-
var MCPI_DELEGATION_ISSUER_KID = "did:web:
|
|
42
|
+
var MCPI_DELEGATION_ISSUER_DID = "did:web:kya.vouched.id:orgs:test-org";
|
|
43
|
+
var MCPI_DELEGATION_ISSUER_KID = "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
44
44
|
var MCPI_DELEGATION_AGENT_DID = "did:key:z6MkTestAgent123";
|
|
45
45
|
var MCPI_DELEGATION_USER_DID = "did:key:z6MkTestUser456";
|
|
46
46
|
var MCPI_DELEGATION_STATUS_LIST_URL = "https://kya.vouched.id/api/v1/gateway/oauth/status-list";
|
|
47
47
|
var MCPI_DELEGATION_AUDIENCE = "https://gateway.knowthat.ai";
|
|
48
48
|
var MCPI_DELEGATION_CANONICAL_PAYLOAD = {
|
|
49
|
-
iss: "did:web:
|
|
49
|
+
iss: "did:web:kya.vouched.id:orgs:test-org",
|
|
50
50
|
sub: "did:key:z6MkTestAgent123",
|
|
51
51
|
aud: "https://gateway.knowthat.ai",
|
|
52
52
|
iat: 1712975940,
|
|
53
53
|
exp: 1712979540,
|
|
54
54
|
vc: {
|
|
55
|
+
// Pinned to the legacy `modelcontextprotocol-identity.io` host ON PURPOSE.
|
|
56
|
+
// This array is signed over by MCPI_DELEGATION_EXPECTED_JWT (below) and must
|
|
57
|
+
// byte-match it, and it must agree with the counterparty's pinned context in
|
|
58
|
+
// xmcp-i (`packages/contracts/src/delegation/schemas.ts`). The live minter's
|
|
59
|
+
// host migration (`vc-jwt.service.ts` → `schema.kya-os.org`) deliberately does
|
|
60
|
+
// NOT move this vector — that requires re-signing both sides of the #1531
|
|
61
|
+
// contract in lockstep. Do not "fix" this URL without regenerating the JWT.
|
|
55
62
|
"@context": [
|
|
56
63
|
"https://www.w3.org/2018/credentials/v1",
|
|
57
64
|
"https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json"
|
|
58
65
|
],
|
|
59
66
|
type: ["VerifiableCredential", "DelegationCredential"],
|
|
60
|
-
issuer: "did:web:
|
|
67
|
+
issuer: "did:web:kya.vouched.id:orgs:test-org",
|
|
61
68
|
issuanceDate: "2024-04-13T02:39:00.000Z",
|
|
62
69
|
expirationDate: "2024-04-13T03:39:00.000Z",
|
|
63
70
|
credentialSubject: {
|
|
64
71
|
id: "did:key:z6MkTestAgent123",
|
|
65
72
|
delegation: {
|
|
66
73
|
id: "del-test-001",
|
|
67
|
-
issuerDid: "did:web:
|
|
74
|
+
issuerDid: "did:web:kya.vouched.id:orgs:test-org",
|
|
68
75
|
subjectDid: "did:key:z6MkTestAgent123",
|
|
69
76
|
userDid: "did:key:z6MkTestUser456",
|
|
70
77
|
userIdentifier: "alice@vouched.id",
|
|
@@ -93,10 +100,154 @@ var MCPI_DELEGATION_CANONICAL_PAYLOAD = {
|
|
|
93
100
|
var MCPI_DELEGATION_EXPECTED_HEADER = {
|
|
94
101
|
alg: "EdDSA",
|
|
95
102
|
typ: "JWT",
|
|
96
|
-
kid: "did:web:
|
|
103
|
+
kid: "did:web:kya.vouched.id:orgs:test-org#key-1"
|
|
104
|
+
};
|
|
105
|
+
var MCPI_DELEGATION_EXPECTED_JWT = "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCIsImtpZCI6ImRpZDp3ZWI6a3lhLnZvdWNoZWQuaWQ6b3Jnczp0ZXN0LW9yZyNrZXktMSJ9.eyJpc3MiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWIiOiJkaWQ6a2V5Ono2TWtUZXN0QWdlbnQxMjMiLCJhdWQiOiJodHRwczovL2dhdGV3YXkua25vd3RoYXQuYWkiLCJpYXQiOjE3MTI5NzU5NDAsImV4cCI6MTcxMjk3OTU0MCwidmMiOnsiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiLCJodHRwczovL3NjaGVtYS5tb2RlbGNvbnRleHRwcm90b2NvbC1pZGVudGl0eS5pby94bWNwLWkvY3JlZGVudGlhbHMvZGVsZWdhdGlvbi52MS4wLjAuanNvbiJdLCJ0eXBlIjpbIlZlcmlmaWFibGVDcmVkZW50aWFsIiwiRGVsZWdhdGlvbkNyZWRlbnRpYWwiXSwiaXNzdWVyIjoiZGlkOndlYjpreWEudm91Y2hlZC5pZDpvcmdzOnRlc3Qtb3JnIiwiaXNzdWFuY2VEYXRlIjoiMjAyNC0wNC0xM1QwMjozOTowMC4wMDBaIiwiZXhwaXJhdGlvbkRhdGUiOiIyMDI0LTA0LTEzVDAzOjM5OjAwLjAwMFoiLCJjcmVkZW50aWFsU3ViamVjdCI6eyJpZCI6ImRpZDprZXk6ejZNa1Rlc3RBZ2VudDEyMyIsImRlbGVnYXRpb24iOnsiaWQiOiJkZWwtdGVzdC0wMDEiLCJpc3N1ZXJEaWQiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWJqZWN0RGlkIjoiZGlkOmtleTp6Nk1rVGVzdEFnZW50MTIzIiwidXNlckRpZCI6ImRpZDprZXk6ejZNa1Rlc3RVc2VyNDU2IiwidXNlcklkZW50aWZpZXIiOiJhbGljZUB2b3VjaGVkLmlkIiwic2NvcGVzIjpbIm1jcCJdLCJjb25zdHJhaW50cyI6eyJub3RCZWZvcmUiOjE3MTI5NzU5NDAsIm5vdEFmdGVyIjoxNzEyOTc5NTQwLCJzY29wZXMiOlsibWNwIl0sImF1ZGllbmNlIjoiaHR0cHM6Ly9nYXRld2F5Lmtub3d0aGF0LmFpIn0sInN0YXR1cyI6ImFjdGl2ZSJ9fSwiY3JlZGVudGlhbFN0YXR1cyI6eyJpZCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QjNDIiLCJ0eXBlIjoiU3RhdHVzTGlzdDIwMjFFbnRyeSIsInN0YXR1c1B1cnBvc2UiOiJyZXZvY2F0aW9uIiwic3RhdHVzTGlzdEluZGV4IjoiNDIiLCJzdGF0dXNMaXN0Q3JlZGVudGlhbCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QifX0sIm9yZ0lkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDEwIiwib3JnU2x1ZyI6InRlc3Qtb3JnIiwic2Vzc2lvbklkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDIwIn0.KEF-cDuLUb-OTJHAXhK2A7VGWpGzdIRY0v4jK-0OXoPqKEadPOHAw1EaEl2V_1NeGyw69V3CRtKug_gx9ZIUBA";
|
|
106
|
+
|
|
107
|
+
// src/test-fixtures/fetcher-200-predicate.ts
|
|
108
|
+
var FETCHER_200_PREDICATE_VECTORS = [
|
|
109
|
+
{
|
|
110
|
+
description: "opt-in header present, non-agent detection \u2192 200 (header is the primary signal)",
|
|
111
|
+
headers: { "kya-accept-challenge": "delegation" },
|
|
112
|
+
detectionClass: "human",
|
|
113
|
+
isAgent: false,
|
|
114
|
+
expected: true
|
|
115
|
+
},
|
|
116
|
+
{
|
|
117
|
+
description: "opt-in header present, detection absent \u2192 200",
|
|
118
|
+
headers: { "kya-accept-challenge": "delegation" },
|
|
119
|
+
detectionClass: null,
|
|
120
|
+
isAgent: false,
|
|
121
|
+
expected: true
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
description: "detected ai_agent (isAgent agrees), no opt-in \u2192 200 (transitional UA heuristic)",
|
|
125
|
+
headers: {},
|
|
126
|
+
detectionClass: "ai_agent",
|
|
127
|
+
isAgent: true,
|
|
128
|
+
expected: true
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
description: "Accept: text/html on a detected agent \u2192 200 (Accept MUST NOT branch the body)",
|
|
132
|
+
headers: { accept: "text/markdown, text/html, */*" },
|
|
133
|
+
detectionClass: "ai_agent",
|
|
134
|
+
isAgent: true,
|
|
135
|
+
expected: true
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
description: "ai_agent class but isAgent=false (signals disagree) \u2192 401 (require both, matches .NET + worker)",
|
|
139
|
+
headers: {},
|
|
140
|
+
detectionClass: "ai_agent",
|
|
141
|
+
isAgent: false,
|
|
142
|
+
expected: false
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
description: "human, no opt-in \u2192 401 (spec path)",
|
|
146
|
+
headers: {},
|
|
147
|
+
detectionClass: "human",
|
|
148
|
+
isAgent: false,
|
|
149
|
+
expected: false
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
description: "bot, no opt-in \u2192 401 (non-cooperative / spoofer lands on spec path)",
|
|
153
|
+
headers: {},
|
|
154
|
+
detectionClass: "bot",
|
|
155
|
+
isAgent: false,
|
|
156
|
+
expected: false
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
description: "incomplete_data, no opt-in \u2192 401",
|
|
160
|
+
headers: {},
|
|
161
|
+
detectionClass: "incomplete_data",
|
|
162
|
+
isAgent: false,
|
|
163
|
+
expected: false
|
|
164
|
+
},
|
|
165
|
+
{
|
|
166
|
+
description: "no signals at all \u2192 401",
|
|
167
|
+
headers: {},
|
|
168
|
+
detectionClass: null,
|
|
169
|
+
isAgent: false,
|
|
170
|
+
expected: false
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
description: "empty opt-in value is ignored, human \u2192 401",
|
|
174
|
+
headers: { "kya-accept-challenge": "" },
|
|
175
|
+
detectionClass: "human",
|
|
176
|
+
isAgent: false,
|
|
177
|
+
expected: false
|
|
178
|
+
}
|
|
179
|
+
];
|
|
180
|
+
|
|
181
|
+
// src/mcpi/delegation-verdict.ts
|
|
182
|
+
var REASON_KIND_MAP = {
|
|
183
|
+
// --- gateway: apps/gateway/src/lib/mcpi-auth-resolver.ts ---
|
|
184
|
+
missing_bearer_token: "claim",
|
|
185
|
+
parse_error: "claim",
|
|
186
|
+
did_resolve_failed: "resolve",
|
|
187
|
+
signature_invalid: "signature",
|
|
188
|
+
audience_mismatch: "claim",
|
|
189
|
+
expired: "time",
|
|
190
|
+
not_yet_valid: "time",
|
|
191
|
+
revoked: "revocation",
|
|
192
|
+
delegation_inactive: "revocation",
|
|
193
|
+
missing_claim: "claim",
|
|
194
|
+
claim_invalid: "claim",
|
|
195
|
+
// --- gateway: apps/gateway/src/lib/dashboard-delegation-verifier.ts ---
|
|
196
|
+
not_configured: "claim",
|
|
197
|
+
header_missing: "claim",
|
|
198
|
+
claim_mismatch: "claim",
|
|
199
|
+
malformed: "claim",
|
|
200
|
+
// --- engine-rust: rust/crates/kya-os-engine/src/types.rs BlockReason ---
|
|
201
|
+
Revoked: "revocation",
|
|
202
|
+
InvalidSignature: "signature",
|
|
203
|
+
Unauthenticated: "claim",
|
|
204
|
+
Expired: "time",
|
|
205
|
+
OutOfScope: "scope"
|
|
97
206
|
};
|
|
98
|
-
|
|
207
|
+
function toCoarseReasonKind(rawReasonKind) {
|
|
208
|
+
const coarse = REASON_KIND_MAP[rawReasonKind];
|
|
209
|
+
if (!coarse) {
|
|
210
|
+
throw new Error(
|
|
211
|
+
`toCoarseReasonKind: unrecognized raw reason kind ${JSON.stringify(rawReasonKind)} \u2014 add it to REASON_KIND_MAP in delegation-verdict.ts with a deliberate coarse classification`
|
|
212
|
+
);
|
|
213
|
+
}
|
|
214
|
+
return coarse;
|
|
215
|
+
}
|
|
216
|
+
function permitDelegationVerdict() {
|
|
217
|
+
return { kind: "Permit", reason: null };
|
|
218
|
+
}
|
|
219
|
+
function blockDelegationVerdict(rawReasonKind) {
|
|
220
|
+
return { kind: "Block", reason: { kind: toCoarseReasonKind(rawReasonKind) } };
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
// src/test-fixtures/verdict-evidence-fixture.ts
|
|
224
|
+
function detectionSignalFixture(overrides = {}) {
|
|
225
|
+
return {
|
|
226
|
+
signalType: "pattern",
|
|
227
|
+
confidence: 80,
|
|
228
|
+
weight: 0.4,
|
|
229
|
+
source: "tier3_ua_pattern",
|
|
230
|
+
explanation: "Matches a known agent UA pattern",
|
|
231
|
+
...overrides
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
var TWO_SIGNAL_EVIDENCE_FIXTURE = [
|
|
235
|
+
detectionSignalFixture({
|
|
236
|
+
source: "known_scraper_ua",
|
|
237
|
+
signalType: "pattern",
|
|
238
|
+
weight: 1,
|
|
239
|
+
confidence: 90
|
|
240
|
+
}),
|
|
241
|
+
detectionSignalFixture({
|
|
242
|
+
source: "datacenter_ip",
|
|
243
|
+
signalType: "network",
|
|
244
|
+
weight: 0.6,
|
|
245
|
+
confidence: 70
|
|
246
|
+
})
|
|
247
|
+
];
|
|
248
|
+
var TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE = 94.78;
|
|
99
249
|
|
|
250
|
+
exports.FETCHER_200_PREDICATE_VECTORS = FETCHER_200_PREDICATE_VECTORS;
|
|
100
251
|
exports.MCPI_DELEGATION_AGENT_DID = MCPI_DELEGATION_AGENT_DID;
|
|
101
252
|
exports.MCPI_DELEGATION_AUDIENCE = MCPI_DELEGATION_AUDIENCE;
|
|
102
253
|
exports.MCPI_DELEGATION_CANONICAL_PAYLOAD = MCPI_DELEGATION_CANONICAL_PAYLOAD;
|
|
@@ -107,9 +258,15 @@ exports.MCPI_DELEGATION_ISSUER_KID = MCPI_DELEGATION_ISSUER_KID;
|
|
|
107
258
|
exports.MCPI_DELEGATION_STATUS_LIST_URL = MCPI_DELEGATION_STATUS_LIST_URL;
|
|
108
259
|
exports.MCPI_DELEGATION_TEST_KEYPAIR = MCPI_DELEGATION_TEST_KEYPAIR;
|
|
109
260
|
exports.MCPI_DELEGATION_USER_DID = MCPI_DELEGATION_USER_DID;
|
|
261
|
+
exports.TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE = TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE;
|
|
262
|
+
exports.TWO_SIGNAL_EVIDENCE_FIXTURE = TWO_SIGNAL_EVIDENCE_FIXTURE;
|
|
110
263
|
exports.VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD = VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD;
|
|
111
264
|
exports.VAULT_WIRE_CONTRACT_EXPECTED_HEADER = VAULT_WIRE_CONTRACT_EXPECTED_HEADER;
|
|
112
265
|
exports.VAULT_WIRE_CONTRACT_EXPECTED_JWT = VAULT_WIRE_CONTRACT_EXPECTED_JWT;
|
|
113
266
|
exports.VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY = VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY;
|
|
114
267
|
exports.VAULT_WIRE_CONTRACT_TEST_KEYPAIR = VAULT_WIRE_CONTRACT_TEST_KEYPAIR;
|
|
115
268
|
exports.VAULT_WIRE_CONTRACT_URL_PATH = VAULT_WIRE_CONTRACT_URL_PATH;
|
|
269
|
+
exports.blockDelegationVerdict = blockDelegationVerdict;
|
|
270
|
+
exports.detectionSignalFixture = detectionSignalFixture;
|
|
271
|
+
exports.permitDelegationVerdict = permitDelegationVerdict;
|
|
272
|
+
exports.toCoarseReasonKind = toCoarseReasonKind;
|
|
@@ -37,32 +37,39 @@ var MCPI_DELEGATION_TEST_KEYPAIR = {
|
|
|
37
37
|
/** Raw 32-byte Ed25519 public key derived from the private seed, base64-encoded. */
|
|
38
38
|
publicKeyBase64: "iojj3XQJ8ZX9UtstPLpdcspnCb8dlBIb83SIAbQPb1w="
|
|
39
39
|
};
|
|
40
|
-
var MCPI_DELEGATION_ISSUER_DID = "did:web:
|
|
41
|
-
var MCPI_DELEGATION_ISSUER_KID = "did:web:
|
|
40
|
+
var MCPI_DELEGATION_ISSUER_DID = "did:web:kya.vouched.id:orgs:test-org";
|
|
41
|
+
var MCPI_DELEGATION_ISSUER_KID = "did:web:kya.vouched.id:orgs:test-org#key-1";
|
|
42
42
|
var MCPI_DELEGATION_AGENT_DID = "did:key:z6MkTestAgent123";
|
|
43
43
|
var MCPI_DELEGATION_USER_DID = "did:key:z6MkTestUser456";
|
|
44
44
|
var MCPI_DELEGATION_STATUS_LIST_URL = "https://kya.vouched.id/api/v1/gateway/oauth/status-list";
|
|
45
45
|
var MCPI_DELEGATION_AUDIENCE = "https://gateway.knowthat.ai";
|
|
46
46
|
var MCPI_DELEGATION_CANONICAL_PAYLOAD = {
|
|
47
|
-
iss: "did:web:
|
|
47
|
+
iss: "did:web:kya.vouched.id:orgs:test-org",
|
|
48
48
|
sub: "did:key:z6MkTestAgent123",
|
|
49
49
|
aud: "https://gateway.knowthat.ai",
|
|
50
50
|
iat: 1712975940,
|
|
51
51
|
exp: 1712979540,
|
|
52
52
|
vc: {
|
|
53
|
+
// Pinned to the legacy `modelcontextprotocol-identity.io` host ON PURPOSE.
|
|
54
|
+
// This array is signed over by MCPI_DELEGATION_EXPECTED_JWT (below) and must
|
|
55
|
+
// byte-match it, and it must agree with the counterparty's pinned context in
|
|
56
|
+
// xmcp-i (`packages/contracts/src/delegation/schemas.ts`). The live minter's
|
|
57
|
+
// host migration (`vc-jwt.service.ts` → `schema.kya-os.org`) deliberately does
|
|
58
|
+
// NOT move this vector — that requires re-signing both sides of the #1531
|
|
59
|
+
// contract in lockstep. Do not "fix" this URL without regenerating the JWT.
|
|
53
60
|
"@context": [
|
|
54
61
|
"https://www.w3.org/2018/credentials/v1",
|
|
55
62
|
"https://schema.modelcontextprotocol-identity.io/xmcp-i/credentials/delegation.v1.0.0.json"
|
|
56
63
|
],
|
|
57
64
|
type: ["VerifiableCredential", "DelegationCredential"],
|
|
58
|
-
issuer: "did:web:
|
|
65
|
+
issuer: "did:web:kya.vouched.id:orgs:test-org",
|
|
59
66
|
issuanceDate: "2024-04-13T02:39:00.000Z",
|
|
60
67
|
expirationDate: "2024-04-13T03:39:00.000Z",
|
|
61
68
|
credentialSubject: {
|
|
62
69
|
id: "did:key:z6MkTestAgent123",
|
|
63
70
|
delegation: {
|
|
64
71
|
id: "del-test-001",
|
|
65
|
-
issuerDid: "did:web:
|
|
72
|
+
issuerDid: "did:web:kya.vouched.id:orgs:test-org",
|
|
66
73
|
subjectDid: "did:key:z6MkTestAgent123",
|
|
67
74
|
userDid: "did:key:z6MkTestUser456",
|
|
68
75
|
userIdentifier: "alice@vouched.id",
|
|
@@ -91,8 +98,151 @@ var MCPI_DELEGATION_CANONICAL_PAYLOAD = {
|
|
|
91
98
|
var MCPI_DELEGATION_EXPECTED_HEADER = {
|
|
92
99
|
alg: "EdDSA",
|
|
93
100
|
typ: "JWT",
|
|
94
|
-
kid: "did:web:
|
|
101
|
+
kid: "did:web:kya.vouched.id:orgs:test-org#key-1"
|
|
102
|
+
};
|
|
103
|
+
var MCPI_DELEGATION_EXPECTED_JWT = "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCIsImtpZCI6ImRpZDp3ZWI6a3lhLnZvdWNoZWQuaWQ6b3Jnczp0ZXN0LW9yZyNrZXktMSJ9.eyJpc3MiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWIiOiJkaWQ6a2V5Ono2TWtUZXN0QWdlbnQxMjMiLCJhdWQiOiJodHRwczovL2dhdGV3YXkua25vd3RoYXQuYWkiLCJpYXQiOjE3MTI5NzU5NDAsImV4cCI6MTcxMjk3OTU0MCwidmMiOnsiQGNvbnRleHQiOlsiaHR0cHM6Ly93d3cudzMub3JnLzIwMTgvY3JlZGVudGlhbHMvdjEiLCJodHRwczovL3NjaGVtYS5tb2RlbGNvbnRleHRwcm90b2NvbC1pZGVudGl0eS5pby94bWNwLWkvY3JlZGVudGlhbHMvZGVsZWdhdGlvbi52MS4wLjAuanNvbiJdLCJ0eXBlIjpbIlZlcmlmaWFibGVDcmVkZW50aWFsIiwiRGVsZWdhdGlvbkNyZWRlbnRpYWwiXSwiaXNzdWVyIjoiZGlkOndlYjpreWEudm91Y2hlZC5pZDpvcmdzOnRlc3Qtb3JnIiwiaXNzdWFuY2VEYXRlIjoiMjAyNC0wNC0xM1QwMjozOTowMC4wMDBaIiwiZXhwaXJhdGlvbkRhdGUiOiIyMDI0LTA0LTEzVDAzOjM5OjAwLjAwMFoiLCJjcmVkZW50aWFsU3ViamVjdCI6eyJpZCI6ImRpZDprZXk6ejZNa1Rlc3RBZ2VudDEyMyIsImRlbGVnYXRpb24iOnsiaWQiOiJkZWwtdGVzdC0wMDEiLCJpc3N1ZXJEaWQiOiJkaWQ6d2ViOmt5YS52b3VjaGVkLmlkOm9yZ3M6dGVzdC1vcmciLCJzdWJqZWN0RGlkIjoiZGlkOmtleTp6Nk1rVGVzdEFnZW50MTIzIiwidXNlckRpZCI6ImRpZDprZXk6ejZNa1Rlc3RVc2VyNDU2IiwidXNlcklkZW50aWZpZXIiOiJhbGljZUB2b3VjaGVkLmlkIiwic2NvcGVzIjpbIm1jcCJdLCJjb25zdHJhaW50cyI6eyJub3RCZWZvcmUiOjE3MTI5NzU5NDAsIm5vdEFmdGVyIjoxNzEyOTc5NTQwLCJzY29wZXMiOlsibWNwIl0sImF1ZGllbmNlIjoiaHR0cHM6Ly9nYXRld2F5Lmtub3d0aGF0LmFpIn0sInN0YXR1cyI6ImFjdGl2ZSJ9fSwiY3JlZGVudGlhbFN0YXR1cyI6eyJpZCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QjNDIiLCJ0eXBlIjoiU3RhdHVzTGlzdDIwMjFFbnRyeSIsInN0YXR1c1B1cnBvc2UiOiJyZXZvY2F0aW9uIiwic3RhdHVzTGlzdEluZGV4IjoiNDIiLCJzdGF0dXNMaXN0Q3JlZGVudGlhbCI6Imh0dHBzOi8va3lhLnZvdWNoZWQuaWQvYXBpL3YxL2dhdGV3YXkvb2F1dGgvc3RhdHVzLWxpc3QifX0sIm9yZ0lkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDEwIiwib3JnU2x1ZyI6InRlc3Qtb3JnIiwic2Vzc2lvbklkIjoiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDIwIn0.KEF-cDuLUb-OTJHAXhK2A7VGWpGzdIRY0v4jK-0OXoPqKEadPOHAw1EaEl2V_1NeGyw69V3CRtKug_gx9ZIUBA";
|
|
104
|
+
|
|
105
|
+
// src/test-fixtures/fetcher-200-predicate.ts
|
|
106
|
+
var FETCHER_200_PREDICATE_VECTORS = [
|
|
107
|
+
{
|
|
108
|
+
description: "opt-in header present, non-agent detection \u2192 200 (header is the primary signal)",
|
|
109
|
+
headers: { "kya-accept-challenge": "delegation" },
|
|
110
|
+
detectionClass: "human",
|
|
111
|
+
isAgent: false,
|
|
112
|
+
expected: true
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
description: "opt-in header present, detection absent \u2192 200",
|
|
116
|
+
headers: { "kya-accept-challenge": "delegation" },
|
|
117
|
+
detectionClass: null,
|
|
118
|
+
isAgent: false,
|
|
119
|
+
expected: true
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
description: "detected ai_agent (isAgent agrees), no opt-in \u2192 200 (transitional UA heuristic)",
|
|
123
|
+
headers: {},
|
|
124
|
+
detectionClass: "ai_agent",
|
|
125
|
+
isAgent: true,
|
|
126
|
+
expected: true
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
description: "Accept: text/html on a detected agent \u2192 200 (Accept MUST NOT branch the body)",
|
|
130
|
+
headers: { accept: "text/markdown, text/html, */*" },
|
|
131
|
+
detectionClass: "ai_agent",
|
|
132
|
+
isAgent: true,
|
|
133
|
+
expected: true
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
description: "ai_agent class but isAgent=false (signals disagree) \u2192 401 (require both, matches .NET + worker)",
|
|
137
|
+
headers: {},
|
|
138
|
+
detectionClass: "ai_agent",
|
|
139
|
+
isAgent: false,
|
|
140
|
+
expected: false
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
description: "human, no opt-in \u2192 401 (spec path)",
|
|
144
|
+
headers: {},
|
|
145
|
+
detectionClass: "human",
|
|
146
|
+
isAgent: false,
|
|
147
|
+
expected: false
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
description: "bot, no opt-in \u2192 401 (non-cooperative / spoofer lands on spec path)",
|
|
151
|
+
headers: {},
|
|
152
|
+
detectionClass: "bot",
|
|
153
|
+
isAgent: false,
|
|
154
|
+
expected: false
|
|
155
|
+
},
|
|
156
|
+
{
|
|
157
|
+
description: "incomplete_data, no opt-in \u2192 401",
|
|
158
|
+
headers: {},
|
|
159
|
+
detectionClass: "incomplete_data",
|
|
160
|
+
isAgent: false,
|
|
161
|
+
expected: false
|
|
162
|
+
},
|
|
163
|
+
{
|
|
164
|
+
description: "no signals at all \u2192 401",
|
|
165
|
+
headers: {},
|
|
166
|
+
detectionClass: null,
|
|
167
|
+
isAgent: false,
|
|
168
|
+
expected: false
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
description: "empty opt-in value is ignored, human \u2192 401",
|
|
172
|
+
headers: { "kya-accept-challenge": "" },
|
|
173
|
+
detectionClass: "human",
|
|
174
|
+
isAgent: false,
|
|
175
|
+
expected: false
|
|
176
|
+
}
|
|
177
|
+
];
|
|
178
|
+
|
|
179
|
+
// src/mcpi/delegation-verdict.ts
|
|
180
|
+
var REASON_KIND_MAP = {
|
|
181
|
+
// --- gateway: apps/gateway/src/lib/mcpi-auth-resolver.ts ---
|
|
182
|
+
missing_bearer_token: "claim",
|
|
183
|
+
parse_error: "claim",
|
|
184
|
+
did_resolve_failed: "resolve",
|
|
185
|
+
signature_invalid: "signature",
|
|
186
|
+
audience_mismatch: "claim",
|
|
187
|
+
expired: "time",
|
|
188
|
+
not_yet_valid: "time",
|
|
189
|
+
revoked: "revocation",
|
|
190
|
+
delegation_inactive: "revocation",
|
|
191
|
+
missing_claim: "claim",
|
|
192
|
+
claim_invalid: "claim",
|
|
193
|
+
// --- gateway: apps/gateway/src/lib/dashboard-delegation-verifier.ts ---
|
|
194
|
+
not_configured: "claim",
|
|
195
|
+
header_missing: "claim",
|
|
196
|
+
claim_mismatch: "claim",
|
|
197
|
+
malformed: "claim",
|
|
198
|
+
// --- engine-rust: rust/crates/kya-os-engine/src/types.rs BlockReason ---
|
|
199
|
+
Revoked: "revocation",
|
|
200
|
+
InvalidSignature: "signature",
|
|
201
|
+
Unauthenticated: "claim",
|
|
202
|
+
Expired: "time",
|
|
203
|
+
OutOfScope: "scope"
|
|
95
204
|
};
|
|
96
|
-
|
|
205
|
+
function toCoarseReasonKind(rawReasonKind) {
|
|
206
|
+
const coarse = REASON_KIND_MAP[rawReasonKind];
|
|
207
|
+
if (!coarse) {
|
|
208
|
+
throw new Error(
|
|
209
|
+
`toCoarseReasonKind: unrecognized raw reason kind ${JSON.stringify(rawReasonKind)} \u2014 add it to REASON_KIND_MAP in delegation-verdict.ts with a deliberate coarse classification`
|
|
210
|
+
);
|
|
211
|
+
}
|
|
212
|
+
return coarse;
|
|
213
|
+
}
|
|
214
|
+
function permitDelegationVerdict() {
|
|
215
|
+
return { kind: "Permit", reason: null };
|
|
216
|
+
}
|
|
217
|
+
function blockDelegationVerdict(rawReasonKind) {
|
|
218
|
+
return { kind: "Block", reason: { kind: toCoarseReasonKind(rawReasonKind) } };
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
// src/test-fixtures/verdict-evidence-fixture.ts
|
|
222
|
+
function detectionSignalFixture(overrides = {}) {
|
|
223
|
+
return {
|
|
224
|
+
signalType: "pattern",
|
|
225
|
+
confidence: 80,
|
|
226
|
+
weight: 0.4,
|
|
227
|
+
source: "tier3_ua_pattern",
|
|
228
|
+
explanation: "Matches a known agent UA pattern",
|
|
229
|
+
...overrides
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
var TWO_SIGNAL_EVIDENCE_FIXTURE = [
|
|
233
|
+
detectionSignalFixture({
|
|
234
|
+
source: "known_scraper_ua",
|
|
235
|
+
signalType: "pattern",
|
|
236
|
+
weight: 1,
|
|
237
|
+
confidence: 90
|
|
238
|
+
}),
|
|
239
|
+
detectionSignalFixture({
|
|
240
|
+
source: "datacenter_ip",
|
|
241
|
+
signalType: "network",
|
|
242
|
+
weight: 0.6,
|
|
243
|
+
confidence: 70
|
|
244
|
+
})
|
|
245
|
+
];
|
|
246
|
+
var TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE = 94.78;
|
|
97
247
|
|
|
98
|
-
export { MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH };
|
|
248
|
+
export { FETCHER_200_PREDICATE_VECTORS, MCPI_DELEGATION_AGENT_DID, MCPI_DELEGATION_AUDIENCE, MCPI_DELEGATION_CANONICAL_PAYLOAD, MCPI_DELEGATION_EXPECTED_HEADER, MCPI_DELEGATION_EXPECTED_JWT, MCPI_DELEGATION_ISSUER_DID, MCPI_DELEGATION_ISSUER_KID, MCPI_DELEGATION_STATUS_LIST_URL, MCPI_DELEGATION_TEST_KEYPAIR, MCPI_DELEGATION_USER_DID, TWO_SIGNAL_EVIDENCE_EXPECTED_CONFIDENCE, TWO_SIGNAL_EVIDENCE_FIXTURE, VAULT_WIRE_CONTRACT_CANONICAL_PAYLOAD, VAULT_WIRE_CONTRACT_EXPECTED_HEADER, VAULT_WIRE_CONTRACT_EXPECTED_JWT, VAULT_WIRE_CONTRACT_EXPECTED_REQUEST_BODY, VAULT_WIRE_CONTRACT_TEST_KEYPAIR, VAULT_WIRE_CONTRACT_URL_PATH, blockDelegationVerdict, detectionSignalFixture, permitDelegationVerdict, toCoarseReasonKind };
|