llm-trust-guard 4.0.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 (115) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +318 -0
  3. package/dist/guards/agent-communication-guard.d.ts +169 -0
  4. package/dist/guards/agent-communication-guard.d.ts.map +1 -0
  5. package/dist/guards/agent-communication-guard.js +468 -0
  6. package/dist/guards/agent-communication-guard.js.map +1 -0
  7. package/dist/guards/autonomy-escalation-guard.d.ts +137 -0
  8. package/dist/guards/autonomy-escalation-guard.d.ts.map +1 -0
  9. package/dist/guards/autonomy-escalation-guard.js +470 -0
  10. package/dist/guards/autonomy-escalation-guard.js.map +1 -0
  11. package/dist/guards/circuit-breaker.d.ts +142 -0
  12. package/dist/guards/circuit-breaker.d.ts.map +1 -0
  13. package/dist/guards/circuit-breaker.js +347 -0
  14. package/dist/guards/circuit-breaker.js.map +1 -0
  15. package/dist/guards/code-execution-guard.d.ts +114 -0
  16. package/dist/guards/code-execution-guard.d.ts.map +1 -0
  17. package/dist/guards/code-execution-guard.js +467 -0
  18. package/dist/guards/code-execution-guard.js.map +1 -0
  19. package/dist/guards/conversation-guard.d.ts +73 -0
  20. package/dist/guards/conversation-guard.d.ts.map +1 -0
  21. package/dist/guards/conversation-guard.js +281 -0
  22. package/dist/guards/conversation-guard.js.map +1 -0
  23. package/dist/guards/drift-detector.d.ts +182 -0
  24. package/dist/guards/drift-detector.d.ts.map +1 -0
  25. package/dist/guards/drift-detector.js +480 -0
  26. package/dist/guards/drift-detector.js.map +1 -0
  27. package/dist/guards/encoding-detector.d.ts +76 -0
  28. package/dist/guards/encoding-detector.d.ts.map +1 -0
  29. package/dist/guards/encoding-detector.js +698 -0
  30. package/dist/guards/encoding-detector.js.map +1 -0
  31. package/dist/guards/execution-monitor.d.ts +73 -0
  32. package/dist/guards/execution-monitor.d.ts.map +1 -0
  33. package/dist/guards/execution-monitor.js +205 -0
  34. package/dist/guards/execution-monitor.js.map +1 -0
  35. package/dist/guards/input-sanitizer.d.ts +87 -0
  36. package/dist/guards/input-sanitizer.d.ts.map +1 -0
  37. package/dist/guards/input-sanitizer.js +301 -0
  38. package/dist/guards/input-sanitizer.js.map +1 -0
  39. package/dist/guards/mcp-security-guard.d.ts +204 -0
  40. package/dist/guards/mcp-security-guard.d.ts.map +1 -0
  41. package/dist/guards/mcp-security-guard.js +618 -0
  42. package/dist/guards/mcp-security-guard.js.map +1 -0
  43. package/dist/guards/memory-guard.d.ts +124 -0
  44. package/dist/guards/memory-guard.d.ts.map +1 -0
  45. package/dist/guards/memory-guard.js +476 -0
  46. package/dist/guards/memory-guard.js.map +1 -0
  47. package/dist/guards/multimodal-guard.d.ts +93 -0
  48. package/dist/guards/multimodal-guard.d.ts.map +1 -0
  49. package/dist/guards/multimodal-guard.js +507 -0
  50. package/dist/guards/multimodal-guard.js.map +1 -0
  51. package/dist/guards/output-filter.d.ts +76 -0
  52. package/dist/guards/output-filter.d.ts.map +1 -0
  53. package/dist/guards/output-filter.js +289 -0
  54. package/dist/guards/output-filter.js.map +1 -0
  55. package/dist/guards/policy-gate.d.ts +57 -0
  56. package/dist/guards/policy-gate.d.ts.map +1 -0
  57. package/dist/guards/policy-gate.js +182 -0
  58. package/dist/guards/policy-gate.js.map +1 -0
  59. package/dist/guards/prompt-leakage-guard.d.ts +110 -0
  60. package/dist/guards/prompt-leakage-guard.d.ts.map +1 -0
  61. package/dist/guards/prompt-leakage-guard.js +529 -0
  62. package/dist/guards/prompt-leakage-guard.js.map +1 -0
  63. package/dist/guards/rag-guard.d.ts +188 -0
  64. package/dist/guards/rag-guard.d.ts.map +1 -0
  65. package/dist/guards/rag-guard.js +769 -0
  66. package/dist/guards/rag-guard.js.map +1 -0
  67. package/dist/guards/schema-validator.d.ts +35 -0
  68. package/dist/guards/schema-validator.d.ts.map +1 -0
  69. package/dist/guards/schema-validator.js +316 -0
  70. package/dist/guards/schema-validator.js.map +1 -0
  71. package/dist/guards/state-persistence-guard.d.ts +153 -0
  72. package/dist/guards/state-persistence-guard.d.ts.map +1 -0
  73. package/dist/guards/state-persistence-guard.js +484 -0
  74. package/dist/guards/state-persistence-guard.js.map +1 -0
  75. package/dist/guards/tenant-boundary.d.ts +67 -0
  76. package/dist/guards/tenant-boundary.d.ts.map +1 -0
  77. package/dist/guards/tenant-boundary.js +187 -0
  78. package/dist/guards/tenant-boundary.js.map +1 -0
  79. package/dist/guards/tool-chain-validator.d.ts +102 -0
  80. package/dist/guards/tool-chain-validator.d.ts.map +1 -0
  81. package/dist/guards/tool-chain-validator.js +480 -0
  82. package/dist/guards/tool-chain-validator.js.map +1 -0
  83. package/dist/guards/tool-registry.d.ts +45 -0
  84. package/dist/guards/tool-registry.d.ts.map +1 -0
  85. package/dist/guards/tool-registry.js +155 -0
  86. package/dist/guards/tool-registry.js.map +1 -0
  87. package/dist/guards/trust-exploitation-guard.d.ts +134 -0
  88. package/dist/guards/trust-exploitation-guard.d.ts.map +1 -0
  89. package/dist/guards/trust-exploitation-guard.js +354 -0
  90. package/dist/guards/trust-exploitation-guard.js.map +1 -0
  91. package/dist/index.d.ts +133 -0
  92. package/dist/index.d.ts.map +1 -0
  93. package/dist/index.js +430 -0
  94. package/dist/index.js.map +1 -0
  95. package/dist/integrations/express.d.ts +119 -0
  96. package/dist/integrations/express.d.ts.map +1 -0
  97. package/dist/integrations/express.js +244 -0
  98. package/dist/integrations/express.js.map +1 -0
  99. package/dist/integrations/index.d.ts +9 -0
  100. package/dist/integrations/index.d.ts.map +1 -0
  101. package/dist/integrations/index.js +26 -0
  102. package/dist/integrations/index.js.map +1 -0
  103. package/dist/integrations/langchain.d.ts +165 -0
  104. package/dist/integrations/langchain.d.ts.map +1 -0
  105. package/dist/integrations/langchain.js +308 -0
  106. package/dist/integrations/langchain.js.map +1 -0
  107. package/dist/integrations/openai.d.ts +205 -0
  108. package/dist/integrations/openai.d.ts.map +1 -0
  109. package/dist/integrations/openai.js +380 -0
  110. package/dist/integrations/openai.js.map +1 -0
  111. package/dist/types/index.d.ts +245 -0
  112. package/dist/types/index.d.ts.map +1 -0
  113. package/dist/types/index.js +6 -0
  114. package/dist/types/index.js.map +1 -0
  115. package/package.json +64 -0
@@ -0,0 +1,76 @@
1
+ /**
2
+ * L7: Output Filter
3
+ *
4
+ * Prevents sensitive data leakage by:
5
+ * - Detecting and masking PII (emails, phone numbers, SSN, credit cards)
6
+ * - Filtering sensitive fields from responses
7
+ * - Blocking responses that contain secrets or credentials
8
+ * - Applying role-based output filtering
9
+ */
10
+ export interface OutputFilterConfig {
11
+ detectPII?: boolean;
12
+ piiPatterns?: PIIPattern[];
13
+ sensitiveFields?: string[];
14
+ detectSecrets?: boolean;
15
+ secretPatterns?: SecretPattern[];
16
+ roleFilters?: Record<string, string[]>;
17
+ maskingChar?: string;
18
+ preserveLength?: boolean;
19
+ }
20
+ export interface PIIPattern {
21
+ name: string;
22
+ pattern: RegExp;
23
+ maskAs?: string;
24
+ }
25
+ export interface SecretPattern {
26
+ name: string;
27
+ pattern: RegExp;
28
+ severity: "low" | "medium" | "high" | "critical";
29
+ }
30
+ export interface OutputFilterResult {
31
+ allowed: boolean;
32
+ reason?: string;
33
+ violations: string[];
34
+ pii_detected: PIIDetection[];
35
+ secrets_detected: SecretDetection[];
36
+ filtered_fields: string[];
37
+ original_response?: any;
38
+ filtered_response?: any;
39
+ blocking_reason?: string;
40
+ }
41
+ export interface PIIDetection {
42
+ type: string;
43
+ count: number;
44
+ masked: boolean;
45
+ locations: string[];
46
+ }
47
+ export interface SecretDetection {
48
+ type: string;
49
+ severity: string;
50
+ blocked: boolean;
51
+ location: string;
52
+ }
53
+ export declare class OutputFilter {
54
+ private config;
55
+ private defaultPIIPatterns;
56
+ private defaultSecretPatterns;
57
+ private defaultSensitiveFields;
58
+ constructor(config?: OutputFilterConfig);
59
+ /**
60
+ * Filter output and detect sensitive data
61
+ */
62
+ filter(output: any, role?: string, requestId?: string): OutputFilterResult;
63
+ /**
64
+ * Quick check if output contains any sensitive data
65
+ */
66
+ containsSensitiveData(output: any): boolean;
67
+ /**
68
+ * Mask a specific value
69
+ */
70
+ mask(value: string, type?: string): string;
71
+ private filterObject;
72
+ private maskPIIInString;
73
+ private generateMask;
74
+ private findLocations;
75
+ }
76
+ //# sourceMappingURL=output-filter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output-filter.d.ts","sourceRoot":"","sources":["../../src/guards/output-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,kBAAkB;IAEjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAE3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IAEjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,kBAAkB,CAyCxB;IAEF,OAAO,CAAC,qBAAqB,CAyC3B;IAEF,OAAO,CAAC,sBAAsB,CAoB5B;gBAEU,MAAM,GAAE,kBAAuB;IAa3C;;OAEG;IACH,MAAM,CACJ,MAAM,EAAE,GAAG,EACX,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,GAAE,MAAW,GACrB,kBAAkB;IA0FrB;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO;IAS3C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAQ1C,OAAO,CAAC,YAAY;IAuDpB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;CAUtB"}
@@ -0,0 +1,289 @@
1
+ "use strict";
2
+ /**
3
+ * L7: Output Filter
4
+ *
5
+ * Prevents sensitive data leakage by:
6
+ * - Detecting and masking PII (emails, phone numbers, SSN, credit cards)
7
+ * - Filtering sensitive fields from responses
8
+ * - Blocking responses that contain secrets or credentials
9
+ * - Applying role-based output filtering
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.OutputFilter = void 0;
13
+ class OutputFilter {
14
+ constructor(config = {}) {
15
+ this.defaultPIIPatterns = [
16
+ {
17
+ name: "email",
18
+ pattern: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,
19
+ maskAs: "[EMAIL]",
20
+ },
21
+ {
22
+ name: "phone_us",
23
+ pattern: /\b(?:\+1[-.\s]?)?(?:\(?\d{3}\)?[-.\s]?)?\d{3}[-.\s]?\d{4}\b/g,
24
+ maskAs: "[PHONE]",
25
+ },
26
+ {
27
+ name: "ssn",
28
+ pattern: /\b\d{3}[-.\s]?\d{2}[-.\s]?\d{4}\b/g,
29
+ maskAs: "[SSN]",
30
+ },
31
+ {
32
+ name: "credit_card",
33
+ pattern: /\b(?:\d{4}[-.\s]?){3}\d{4}\b/g,
34
+ maskAs: "[CREDIT_CARD]",
35
+ },
36
+ {
37
+ name: "ip_address",
38
+ pattern: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g,
39
+ maskAs: "[IP_ADDRESS]",
40
+ },
41
+ {
42
+ name: "date_of_birth",
43
+ pattern: /\b(?:0?[1-9]|1[0-2])[\/\-](?:0?[1-9]|[12]\d|3[01])[\/\-](?:19|20)\d{2}\b/g,
44
+ maskAs: "[DOB]",
45
+ },
46
+ {
47
+ name: "passport",
48
+ pattern: /\b[A-Z]{1,2}\d{6,9}\b/g,
49
+ maskAs: "[PASSPORT]",
50
+ },
51
+ {
52
+ name: "bank_account",
53
+ pattern: /\b\d{8,17}\b/g,
54
+ maskAs: "[BANK_ACCOUNT]",
55
+ },
56
+ ];
57
+ this.defaultSecretPatterns = [
58
+ {
59
+ name: "api_key",
60
+ pattern: /(?:api[_-]?key|apikey)[=:\s]["']?[A-Za-z0-9_\-]{20,}["']?/gi,
61
+ severity: "critical",
62
+ },
63
+ {
64
+ name: "aws_secret",
65
+ pattern: /(?:aws[_-]?secret|secret[_-]?key)[=:\s]["']?[A-Za-z0-9\/+=]{40}["']?/gi,
66
+ severity: "critical",
67
+ },
68
+ {
69
+ name: "password",
70
+ pattern: /(?:password|passwd|pwd)[=:\s]["']?[^\s"']{8,}["']?/gi,
71
+ severity: "critical",
72
+ },
73
+ {
74
+ name: "private_key",
75
+ pattern: /-----BEGIN (?:RSA |EC |DSA )?PRIVATE KEY-----/g,
76
+ severity: "critical",
77
+ },
78
+ {
79
+ name: "jwt_token",
80
+ pattern: /eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g,
81
+ severity: "high",
82
+ },
83
+ {
84
+ name: "bearer_token",
85
+ pattern: /Bearer\s+[A-Za-z0-9_\-\.]+/gi,
86
+ severity: "high",
87
+ },
88
+ {
89
+ name: "database_url",
90
+ pattern: /(?:mongodb|mysql|postgres|redis):\/\/[^\s]+/gi,
91
+ severity: "critical",
92
+ },
93
+ {
94
+ name: "github_token",
95
+ pattern: /gh[pousr]_[A-Za-z0-9_]{36,}/g,
96
+ severity: "critical",
97
+ },
98
+ ];
99
+ this.defaultSensitiveFields = [
100
+ "password",
101
+ "secret",
102
+ "token",
103
+ "api_key",
104
+ "apiKey",
105
+ "private_key",
106
+ "privateKey",
107
+ "ssn",
108
+ "social_security",
109
+ "credit_card",
110
+ "creditCard",
111
+ "card_number",
112
+ "cardNumber",
113
+ "cvv",
114
+ "pin",
115
+ "account_number",
116
+ "accountNumber",
117
+ "routing_number",
118
+ "routingNumber",
119
+ ];
120
+ this.config = {
121
+ detectPII: config.detectPII ?? true,
122
+ piiPatterns: config.piiPatterns ?? this.defaultPIIPatterns,
123
+ sensitiveFields: config.sensitiveFields ?? this.defaultSensitiveFields,
124
+ detectSecrets: config.detectSecrets ?? true,
125
+ secretPatterns: config.secretPatterns ?? this.defaultSecretPatterns,
126
+ roleFilters: config.roleFilters ?? {},
127
+ maskingChar: config.maskingChar ?? "*",
128
+ preserveLength: config.preserveLength ?? false,
129
+ };
130
+ }
131
+ /**
132
+ * Filter output and detect sensitive data
133
+ */
134
+ filter(output, role, requestId = "") {
135
+ const violations = [];
136
+ const piiDetections = [];
137
+ const secretDetections = [];
138
+ const filteredFields = [];
139
+ let blockingReason;
140
+ // Convert to string for pattern matching
141
+ const outputStr = typeof output === "string" ? output : JSON.stringify(output);
142
+ // Detect PII
143
+ if (this.config.detectPII) {
144
+ for (const pattern of this.config.piiPatterns) {
145
+ const matches = outputStr.match(pattern.pattern);
146
+ if (matches && matches.length > 0) {
147
+ piiDetections.push({
148
+ type: pattern.name,
149
+ count: matches.length,
150
+ masked: true,
151
+ locations: this.findLocations(outputStr, pattern.pattern),
152
+ });
153
+ violations.push(`PII_DETECTED_${pattern.name.toUpperCase()}`);
154
+ }
155
+ }
156
+ }
157
+ // Detect secrets
158
+ if (this.config.detectSecrets) {
159
+ for (const pattern of this.config.secretPatterns) {
160
+ const matches = outputStr.match(pattern.pattern);
161
+ if (matches && matches.length > 0) {
162
+ secretDetections.push({
163
+ type: pattern.name,
164
+ severity: pattern.severity,
165
+ blocked: pattern.severity === "critical",
166
+ location: "response",
167
+ });
168
+ violations.push(`SECRET_DETECTED_${pattern.name.toUpperCase()}`);
169
+ // Block critical secrets
170
+ if (pattern.severity === "critical") {
171
+ blockingReason = `Critical secret detected: ${pattern.name}`;
172
+ }
173
+ }
174
+ }
175
+ }
176
+ // Filter output
177
+ let filteredOutput = typeof output === "string" ? output : JSON.parse(JSON.stringify(output));
178
+ // Mask PII in output
179
+ if (this.config.detectPII && typeof filteredOutput === "string") {
180
+ for (const pattern of this.config.piiPatterns) {
181
+ filteredOutput = filteredOutput.replace(pattern.pattern, pattern.maskAs || this.generateMask(8));
182
+ }
183
+ }
184
+ else if (typeof filteredOutput === "object" && filteredOutput !== null) {
185
+ filteredOutput = this.filterObject(filteredOutput, role, filteredFields, piiDetections);
186
+ }
187
+ // Determine if blocked
188
+ const hasBlockingSecrets = secretDetections.some((s) => s.blocked);
189
+ const allowed = !hasBlockingSecrets;
190
+ if (!allowed) {
191
+ console.log(`[OutputFilter:${requestId}] BLOCKED: ${blockingReason}`);
192
+ }
193
+ return {
194
+ allowed,
195
+ reason: allowed ? undefined : blockingReason,
196
+ violations,
197
+ pii_detected: piiDetections,
198
+ secrets_detected: secretDetections,
199
+ filtered_fields: filteredFields,
200
+ original_response: output,
201
+ filtered_response: filteredOutput,
202
+ blocking_reason: blockingReason,
203
+ };
204
+ }
205
+ /**
206
+ * Quick check if output contains any sensitive data
207
+ */
208
+ containsSensitiveData(output) {
209
+ const result = this.filter(output);
210
+ return (result.pii_detected.length > 0 ||
211
+ result.secrets_detected.length > 0 ||
212
+ result.filtered_fields.length > 0);
213
+ }
214
+ /**
215
+ * Mask a specific value
216
+ */
217
+ mask(value, type) {
218
+ const piiPattern = this.config.piiPatterns?.find((p) => p.name === type);
219
+ if (piiPattern?.maskAs) {
220
+ return piiPattern.maskAs;
221
+ }
222
+ return this.generateMask(value.length);
223
+ }
224
+ filterObject(obj, role, filteredFields, piiDetections) {
225
+ if (Array.isArray(obj)) {
226
+ return obj.map((item) => this.filterObject(item, role, filteredFields, piiDetections));
227
+ }
228
+ if (typeof obj !== "object" || obj === null) {
229
+ // Check for PII in string values
230
+ if (typeof obj === "string") {
231
+ return this.maskPIIInString(obj, piiDetections);
232
+ }
233
+ return obj;
234
+ }
235
+ const result = {};
236
+ const roleSpecificFilter = role ? this.config.roleFilters?.[role] : undefined;
237
+ for (const [key, value] of Object.entries(obj)) {
238
+ // Check if field should be filtered
239
+ const lowerKey = key.toLowerCase();
240
+ const isSensitive = this.config.sensitiveFields?.some((f) => lowerKey.includes(f.toLowerCase()));
241
+ const isRoleFiltered = roleSpecificFilter?.includes(key);
242
+ if (isSensitive || isRoleFiltered) {
243
+ filteredFields.push(key);
244
+ result[key] = "[FILTERED]";
245
+ continue;
246
+ }
247
+ // Recursively filter nested objects
248
+ if (typeof value === "object" && value !== null) {
249
+ result[key] = this.filterObject(value, role, filteredFields, piiDetections);
250
+ }
251
+ else if (typeof value === "string") {
252
+ result[key] = this.maskPIIInString(value, piiDetections);
253
+ }
254
+ else {
255
+ result[key] = value;
256
+ }
257
+ }
258
+ return result;
259
+ }
260
+ maskPIIInString(str, piiDetections) {
261
+ let result = str;
262
+ for (const pattern of this.config.piiPatterns) {
263
+ const matches = result.match(pattern.pattern);
264
+ if (matches && matches.length > 0) {
265
+ result = result.replace(pattern.pattern, pattern.maskAs || this.generateMask(8));
266
+ }
267
+ }
268
+ return result;
269
+ }
270
+ generateMask(length) {
271
+ if (this.config.preserveLength) {
272
+ return this.config.maskingChar.repeat(length);
273
+ }
274
+ return this.config.maskingChar.repeat(8);
275
+ }
276
+ findLocations(text, pattern) {
277
+ const locations = [];
278
+ let match;
279
+ const regex = new RegExp(pattern.source, pattern.flags);
280
+ while ((match = regex.exec(text)) !== null) {
281
+ locations.push(`index:${match.index}`);
282
+ if (!pattern.flags.includes("g"))
283
+ break;
284
+ }
285
+ return locations;
286
+ }
287
+ }
288
+ exports.OutputFilter = OutputFilter;
289
+ //# sourceMappingURL=output-filter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output-filter.js","sourceRoot":"","sources":["../../src/guards/output-filter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAwDH,MAAa,YAAY;IA8GvB,YAAY,SAA6B,EAAE;QA5GnC,uBAAkB,GAAiB;YACzC;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,qDAAqD;gBAC9D,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,8DAA8D;gBACvE,MAAM,EAAE,SAAS;aAClB;YACD;gBACE,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,oCAAoC;gBAC7C,MAAM,EAAE,OAAO;aAChB;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,+BAA+B;gBACxC,MAAM,EAAE,eAAe;aACxB;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,8BAA8B;gBACvC,MAAM,EAAE,cAAc;aACvB;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,2EAA2E;gBACpF,MAAM,EAAE,OAAO;aAChB;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,wBAAwB;gBACjC,MAAM,EAAE,YAAY;aACrB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,eAAe;gBACxB,MAAM,EAAE,gBAAgB;aACzB;SACF,CAAC;QAEM,0BAAqB,GAAoB;YAC/C;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,6DAA6D;gBACtE,QAAQ,EAAE,UAAU;aACrB;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,wEAAwE;gBACjF,QAAQ,EAAE,UAAU;aACrB;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,sDAAsD;gBAC/D,QAAQ,EAAE,UAAU;aACrB;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,gDAAgD;gBACzD,QAAQ,EAAE,UAAU;aACrB;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,uDAAuD;gBAChE,QAAQ,EAAE,MAAM;aACjB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,8BAA8B;gBACvC,QAAQ,EAAE,MAAM;aACjB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,+CAA+C;gBACxD,QAAQ,EAAE,UAAU;aACrB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,8BAA8B;gBACvC,QAAQ,EAAE,UAAU;aACrB;SACF,CAAC;QAEM,2BAAsB,GAAa;YACzC,UAAU;YACV,QAAQ;YACR,OAAO;YACP,SAAS;YACT,QAAQ;YACR,aAAa;YACb,YAAY;YACZ,KAAK;YACL,iBAAiB;YACjB,aAAa;YACb,YAAY;YACZ,aAAa;YACb,YAAY;YACZ,KAAK;YACL,KAAK;YACL,gBAAgB;YAChB,eAAe;YACf,gBAAgB;YAChB,eAAe;SAChB,CAAC;QAGA,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;YACnC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,kBAAkB;YAC1D,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC,sBAAsB;YACtE,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;YAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,qBAAqB;YACnE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,GAAG;YACtC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,MAAW,EACX,IAAa,EACb,YAAoB,EAAE;QAEtB,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,aAAa,GAAmB,EAAE,CAAC;QACzC,MAAM,gBAAgB,GAAsB,EAAE,CAAC;QAC/C,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,IAAI,cAAkC,CAAC;QAEvC,yCAAyC;QACzC,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE/E,aAAa;QACb,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAY,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACjD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,aAAa,CAAC,IAAI,CAAC;wBACjB,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,KAAK,EAAE,OAAO,CAAC,MAAM;wBACrB,MAAM,EAAE,IAAI;wBACZ,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC;qBAC1D,CAAC,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,cAAe,EAAE,CAAC;gBAClD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACjD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,gBAAgB,CAAC,IAAI,CAAC;wBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,OAAO,EAAE,OAAO,CAAC,QAAQ,KAAK,UAAU;wBACxC,QAAQ,EAAE,UAAU;qBACrB,CAAC,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAEjE,yBAAyB;oBACzB,IAAI,OAAO,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;wBACpC,cAAc,GAAG,6BAA6B,OAAO,CAAC,IAAI,EAAE,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,cAAc,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAE9F,qBAAqB;QACrB,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YAChE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAY,EAAE,CAAC;gBAC/C,cAAc,GAAG,cAAc,CAAC,OAAO,CACrC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YACzE,cAAc,GAAG,IAAI,CAAC,YAAY,CAChC,cAAc,EACd,IAAI,EACJ,cAAc,EACd,aAAa,CACd,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,CAAC,kBAAkB,CAAC;QAEpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CACT,iBAAiB,SAAS,cAAc,cAAc,EAAE,CACzD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc;YAC5C,UAAU;YACV,YAAY,EAAE,aAAa;YAC3B,gBAAgB,EAAE,gBAAgB;YAClC,eAAe,EAAE,cAAc;YAC/B,iBAAiB,EAAE,MAAM;YACzB,iBAAiB,EAAE,cAAc;YACjC,eAAe,EAAE,cAAc;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,MAAW;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,CACL,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;YAC9B,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;YAClC,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAClC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,IAAa;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACzE,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAEO,YAAY,CAClB,GAAQ,EACR,IAAwB,EACxB,cAAwB,EACxB,aAA6B;QAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAC7D,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,iCAAiC;YACjC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,MAAM,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,oCAAoC;YACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC1C,CAAC;YACF,MAAM,cAAc,GAAG,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;YAEzD,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;gBAClC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,oCAAoC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAC7B,KAAK,EACL,IAAI,EACJ,cAAc,EACd,aAAa,CACd,CAAC;YACJ,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CACrB,GAAW,EACX,aAA6B;QAE7B,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,WAAY,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,YAAY,CAAC,MAAc;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,WAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,OAAe;QACjD,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC;QACV,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,MAAM;QAC1C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA5UD,oCA4UC"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * L3 Policy Gate
3
+ *
4
+ * Enforces role-based access control with constraint validation.
5
+ * The definitive layer for authorization decisions.
6
+ */
7
+ import { SessionContext, ToolDefinition, PolicyGateResult, Role } from "../types";
8
+ export interface PolicyGateConfig {
9
+ roleHierarchy?: Record<Role, number>;
10
+ toolPermissions?: Map<string, {
11
+ roles: Role[];
12
+ constraints?: Record<Role, any>;
13
+ }>;
14
+ }
15
+ export declare class PolicyGate {
16
+ private roleHierarchy;
17
+ private toolPermissions;
18
+ constructor(config?: PolicyGateConfig);
19
+ /**
20
+ * Validate session is authentic
21
+ */
22
+ validateSession(session: SessionContext | undefined, requestId?: string): {
23
+ valid: boolean;
24
+ error?: string;
25
+ };
26
+ /**
27
+ * Detect role tampering (claimed vs session role)
28
+ */
29
+ detectRoleTampering(session: SessionContext, claimedRole: Role | undefined): {
30
+ tampered: boolean;
31
+ actual: Role;
32
+ claimed?: Role;
33
+ };
34
+ /**
35
+ * Check tool access for a session
36
+ */
37
+ checkToolAccess(tool: ToolDefinition, session: SessionContext, requestId?: string): {
38
+ allowed: boolean;
39
+ reason?: string;
40
+ };
41
+ /**
42
+ * Check constraints for a tool call
43
+ */
44
+ checkConstraints(tool: ToolDefinition, params: Record<string, any>, session: SessionContext, requestId?: string): {
45
+ valid: boolean;
46
+ violations: string[];
47
+ };
48
+ /**
49
+ * Complete policy check
50
+ */
51
+ check(tool: ToolDefinition, params: Record<string, any>, session: SessionContext | undefined, claimedRole: Role | undefined, requestId?: string): PolicyGateResult;
52
+ /**
53
+ * Set role hierarchy
54
+ */
55
+ setRoleHierarchy(hierarchy: Record<Role, number>): void;
56
+ }
57
+ //# sourceMappingURL=policy-gate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy-gate.d.ts","sourceRoot":"","sources":["../../src/guards/policy-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;CACnF;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,eAAe,CAAkE;gBAE7E,MAAM,GAAE,gBAAqB;IAKzC;;OAEG;IACH,eAAe,CACb,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,GAAE,MAAW,GACrB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAmBrC;;OAEG;IACH,mBAAmB,CACjB,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,IAAI,GAAG,SAAS,GAC5B;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAA;KAAE;IAYtD;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,SAAS,GAAE,MAAW,GACrB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IA6BxC;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,EAAE,cAAc,EACvB,SAAS,GAAE,MAAW,GACrB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IA6C3C;;OAEG;IACH,KAAK,CACH,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,WAAW,EAAE,IAAI,GAAG,SAAS,EAC7B,SAAS,GAAE,MAAW,GACrB,gBAAgB;IAgEnB;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI;CAGxD"}
@@ -0,0 +1,182 @@
1
+ "use strict";
2
+ /**
3
+ * L3 Policy Gate
4
+ *
5
+ * Enforces role-based access control with constraint validation.
6
+ * The definitive layer for authorization decisions.
7
+ */
8
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.PolicyGate = void 0;
10
+ class PolicyGate {
11
+ constructor(config = {}) {
12
+ this.roleHierarchy = config.roleHierarchy || {};
13
+ this.toolPermissions = config.toolPermissions || new Map();
14
+ }
15
+ /**
16
+ * Validate session is authentic
17
+ */
18
+ validateSession(session, requestId = "") {
19
+ if (!session) {
20
+ if (requestId)
21
+ console.log(`[L3:${requestId}] BLOCKED: No session`);
22
+ return { valid: false, error: "Missing session context" };
23
+ }
24
+ if (!session.authenticated) {
25
+ if (requestId)
26
+ console.log(`[L3:${requestId}] BLOCKED: Not authenticated`);
27
+ return { valid: false, error: "Session not authenticated" };
28
+ }
29
+ if (!session.role) {
30
+ if (requestId)
31
+ console.log(`[L3:${requestId}] BLOCKED: No role in session`);
32
+ return { valid: false, error: "Missing role in session" };
33
+ }
34
+ return { valid: true };
35
+ }
36
+ /**
37
+ * Detect role tampering (claimed vs session role)
38
+ */
39
+ detectRoleTampering(session, claimedRole) {
40
+ if (!claimedRole) {
41
+ return { tampered: false, actual: session.role };
42
+ }
43
+ if (claimedRole !== session.role) {
44
+ return { tampered: true, actual: session.role, claimed: claimedRole };
45
+ }
46
+ return { tampered: false, actual: session.role };
47
+ }
48
+ /**
49
+ * Check tool access for a session
50
+ */
51
+ checkToolAccess(tool, session, requestId = "") {
52
+ // If tool has no role restrictions, allow
53
+ if (!tool.roles || tool.roles.length === 0) {
54
+ return { allowed: true };
55
+ }
56
+ // Check if session role is in allowed roles
57
+ if (!tool.roles.includes(session.role)) {
58
+ // Check hierarchy if defined
59
+ const sessionRoleLevel = this.roleHierarchy[session.role] ?? -1;
60
+ const hasHigherRole = tool.roles.some((r) => {
61
+ const requiredLevel = this.roleHierarchy[r] ?? -1;
62
+ return sessionRoleLevel >= requiredLevel && requiredLevel >= 0;
63
+ });
64
+ if (!hasHigherRole) {
65
+ if (requestId) {
66
+ console.log(`[L3:${requestId}] BLOCKED: Role '${session.role}' cannot use '${tool.name}'`);
67
+ }
68
+ return {
69
+ allowed: false,
70
+ reason: `Role '${session.role}' is not authorized for tool '${tool.name}'`,
71
+ };
72
+ }
73
+ }
74
+ return { allowed: true };
75
+ }
76
+ /**
77
+ * Check constraints for a tool call
78
+ */
79
+ checkConstraints(tool, params, session, requestId = "") {
80
+ const violations = [];
81
+ if (!tool.constraints) {
82
+ return { valid: true, violations: [] };
83
+ }
84
+ const roleConstraints = tool.constraints[session.role];
85
+ if (!roleConstraints) {
86
+ return { valid: true, violations: [] };
87
+ }
88
+ // Check max_amount
89
+ if (roleConstraints.max_amount !== undefined) {
90
+ const amount = params.amount || params.total_amount;
91
+ if (amount && amount > roleConstraints.max_amount) {
92
+ violations.push(`Amount ${amount} exceeds limit of ${roleConstraints.max_amount} for role '${session.role}'`);
93
+ if (requestId) {
94
+ console.log(`[L3:${requestId}] CONSTRAINT: Amount exceeds limit`);
95
+ }
96
+ }
97
+ }
98
+ // Check require_approval
99
+ if (roleConstraints.require_approval && !params.approval_id) {
100
+ violations.push(`Tool '${tool.name}' requires approval for role '${session.role}'`);
101
+ if (requestId) {
102
+ console.log(`[L3:${requestId}] CONSTRAINT: Requires approval`);
103
+ }
104
+ }
105
+ // Check allowed_values
106
+ if (roleConstraints.allowed_values) {
107
+ for (const [field, allowedVals] of Object.entries(roleConstraints.allowed_values)) {
108
+ if (params[field] && !allowedVals.includes(params[field])) {
109
+ violations.push(`Value '${params[field]}' not allowed for field '${field}'`);
110
+ }
111
+ }
112
+ }
113
+ return { valid: violations.length === 0, violations };
114
+ }
115
+ /**
116
+ * Complete policy check
117
+ */
118
+ check(tool, params, session, claimedRole, requestId = "") {
119
+ // Validate session
120
+ const sessionCheck = this.validateSession(session, requestId);
121
+ if (!sessionCheck.valid) {
122
+ return {
123
+ allowed: false,
124
+ reason: sessionCheck.error,
125
+ violations: ["INVALID_SESSION"],
126
+ session_role: "",
127
+ required_roles: tool.roles || [],
128
+ };
129
+ }
130
+ const validSession = session;
131
+ // Detect tampering
132
+ const tamperCheck = this.detectRoleTampering(validSession, claimedRole);
133
+ const violations = [];
134
+ if (tamperCheck.tampered) {
135
+ violations.push("ROLE_TAMPERING");
136
+ if (requestId) {
137
+ console.log(`[L3:${requestId}] ALERT: Role tampering detected`);
138
+ console.log(`[L3:${requestId}] Claimed: ${tamperCheck.claimed}, Actual: ${tamperCheck.actual}`);
139
+ }
140
+ }
141
+ // Check tool access (using SESSION role)
142
+ const accessCheck = this.checkToolAccess(tool, validSession, requestId);
143
+ if (!accessCheck.allowed) {
144
+ return {
145
+ allowed: false,
146
+ reason: accessCheck.reason,
147
+ violations: [...violations, "UNAUTHORIZED_TOOL"],
148
+ session_role: validSession.role,
149
+ required_roles: tool.roles || [],
150
+ };
151
+ }
152
+ // Check constraints
153
+ const constraintCheck = this.checkConstraints(tool, params, validSession, requestId);
154
+ if (!constraintCheck.valid) {
155
+ return {
156
+ allowed: false,
157
+ reason: "Constraint violation",
158
+ violations: [...violations, ...constraintCheck.violations],
159
+ session_role: validSession.role,
160
+ required_roles: tool.roles || [],
161
+ constraint_violations: constraintCheck.violations,
162
+ };
163
+ }
164
+ if (requestId) {
165
+ console.log(`[L3:${requestId}] Policy check PASSED`);
166
+ }
167
+ return {
168
+ allowed: true,
169
+ violations: tamperCheck.tampered ? ["ROLE_TAMPERING_HANDLED"] : [],
170
+ session_role: validSession.role,
171
+ required_roles: tool.roles || [],
172
+ };
173
+ }
174
+ /**
175
+ * Set role hierarchy
176
+ */
177
+ setRoleHierarchy(hierarchy) {
178
+ this.roleHierarchy = hierarchy;
179
+ }
180
+ }
181
+ exports.PolicyGate = PolicyGate;
182
+ //# sourceMappingURL=policy-gate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy-gate.js","sourceRoot":"","sources":["../../src/guards/policy-gate.ts"],"names":[],"mappings":"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"}