@highflame/policy 2.1.3 → 2.1.4

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.
@@ -0,0 +1,305 @@
1
+ /**
2
+ * Condition Groups — flat UI-friendly representation of ConditionExpression trees.
3
+ *
4
+ * Provides bidirectional conversion between recursive ConditionExpression ASTs
5
+ * and flat ConditionGroup arrays suitable for visual condition builder UIs.
6
+ *
7
+ * Also provides:
8
+ * - expressionToCedar(): render any AST node to valid Cedar condition text
9
+ * - extractContextFields(): collect all context field names from an AST
10
+ */
11
+ import { conditionToCedar, sanitizeIdentifier, isValidRawCondition, } from './builder.js';
12
+ /** Sentinel field name used for raw (unparseable) conditions. */
13
+ export const RAW_CONDITION_FIELD = '__raw';
14
+ // ---------------------------------------------------------------------------
15
+ // ID generation
16
+ // ---------------------------------------------------------------------------
17
+ let _groupCounter = 0;
18
+ /** Generate a unique group ID. Uses a simple counter for deterministic output. */
19
+ function nextGroupId() {
20
+ return `group-${++_groupCounter}`;
21
+ }
22
+ /** Reset the group counter (for testing). */
23
+ export function resetGroupCounter() {
24
+ _groupCounter = 0;
25
+ }
26
+ // ---------------------------------------------------------------------------
27
+ // expressionToGroups
28
+ // ---------------------------------------------------------------------------
29
+ /**
30
+ * Convert a ConditionExpression AST into a flat array of ConditionGroups.
31
+ *
32
+ * The top-level AND is split into separate groups. Each OR subtree becomes
33
+ * a single group with `logic: 'or'`. NOT wrappers set `negated: true`.
34
+ * Raw nodes produce a sentinel condition with `field: "__raw"`.
35
+ */
36
+ export function expressionToGroups(expr) {
37
+ // Top-level AND → split children into groups
38
+ if (expr.kind === 'and') {
39
+ const groups = [];
40
+ for (const child of expr.children) {
41
+ groups.push(...nodeToGroups(child));
42
+ }
43
+ return groups;
44
+ }
45
+ // Anything else → delegate
46
+ return nodeToGroups(expr);
47
+ }
48
+ /**
49
+ * Convert a single AST node (not a top-level AND) into one or more groups.
50
+ */
51
+ function nodeToGroups(expr) {
52
+ switch (expr.kind) {
53
+ case 'and': {
54
+ // Nested AND within a top-level AND child → single AND group
55
+ const conditions = collectLeafConditions(expr.children);
56
+ return [{ id: nextGroupId(), logic: 'and', conditions, negated: false }];
57
+ }
58
+ case 'or': {
59
+ const conditions = collectLeafConditions(expr.children);
60
+ return [{ id: nextGroupId(), logic: 'or', conditions, negated: false }];
61
+ }
62
+ case 'not': {
63
+ return notToGroups(expr.child);
64
+ }
65
+ case 'raw': {
66
+ return [{
67
+ id: nextGroupId(),
68
+ logic: 'and',
69
+ conditions: [{ field: RAW_CONDITION_FIELD, operator: 'eq', value: expr.text }],
70
+ negated: false,
71
+ }];
72
+ }
73
+ default: {
74
+ // Leaf node → single AND group with one condition
75
+ const cond = leafToCondition(expr);
76
+ return [{ id: nextGroupId(), logic: 'and', conditions: [cond], negated: false }];
77
+ }
78
+ }
79
+ }
80
+ /** Convert a NOT node's inner expression into negated group(s). */
81
+ function notToGroups(inner) {
82
+ switch (inner.kind) {
83
+ case 'or': {
84
+ const conditions = collectLeafConditions(inner.children);
85
+ return [{ id: nextGroupId(), logic: 'or', conditions, negated: true }];
86
+ }
87
+ case 'and': {
88
+ const conditions = collectLeafConditions(inner.children);
89
+ return [{ id: nextGroupId(), logic: 'and', conditions, negated: true }];
90
+ }
91
+ case 'not': {
92
+ // Double negation: NOT(NOT(x)) → just x
93
+ return nodeToGroups(inner.child);
94
+ }
95
+ case 'raw': {
96
+ return [{
97
+ id: nextGroupId(),
98
+ logic: 'and',
99
+ conditions: [{ field: RAW_CONDITION_FIELD, operator: 'eq', value: inner.text }],
100
+ negated: true,
101
+ }];
102
+ }
103
+ default: {
104
+ // NOT wrapping a leaf
105
+ const cond = leafToCondition(inner);
106
+ return [{ id: nextGroupId(), logic: 'and', conditions: [cond], negated: true }];
107
+ }
108
+ }
109
+ }
110
+ /** Collect leaf conditions from an array of children. Non-leaf children become raw fallbacks. */
111
+ function collectLeafConditions(children) {
112
+ return children.map(child => {
113
+ if (isLeaf(child)) {
114
+ return leafToCondition(child);
115
+ }
116
+ // Non-leaf in OR/AND children → raw fallback with Cedar text
117
+ return { field: RAW_CONDITION_FIELD, operator: 'eq', value: expressionToCedar(child) };
118
+ });
119
+ }
120
+ /** Check if an expression is a leaf (comparison, contains, like, has). */
121
+ function isLeaf(expr) {
122
+ return expr.kind === 'comparison' || expr.kind === 'contains'
123
+ || expr.kind === 'like' || expr.kind === 'has';
124
+ }
125
+ /** Convert a leaf expression to a PolicyCondition. */
126
+ function leafToCondition(expr) {
127
+ switch (expr.kind) {
128
+ case 'comparison':
129
+ return { field: expr.field, operator: expr.operator, value: expr.value };
130
+ case 'contains':
131
+ return { field: expr.field, operator: 'contains', value: expr.value };
132
+ case 'like':
133
+ return { field: expr.field, operator: 'like', value: expr.pattern };
134
+ case 'has':
135
+ return { field: expr.field, operator: 'eq', value: true };
136
+ default:
137
+ // Fallback — shouldn't reach here for true leaves
138
+ return { field: RAW_CONDITION_FIELD, operator: 'eq', value: expressionToCedar(expr) };
139
+ }
140
+ }
141
+ // ---------------------------------------------------------------------------
142
+ // groupsToExpression
143
+ // ---------------------------------------------------------------------------
144
+ /**
145
+ * Convert a flat array of ConditionGroups back into a ConditionExpression AST.
146
+ *
147
+ * Each group becomes an AND/OR node (or single leaf if only one condition).
148
+ * If `negated`, the group is wrapped in NOT. Multiple groups are combined
149
+ * with a top-level AND.
150
+ */
151
+ export function groupsToExpression(groups) {
152
+ if (groups.length === 0) {
153
+ return { kind: 'and', children: [] };
154
+ }
155
+ const expressions = groups.map(groupToExpression);
156
+ if (expressions.length === 1) {
157
+ return expressions[0];
158
+ }
159
+ return { kind: 'and', children: expressions };
160
+ }
161
+ /** Convert a single ConditionGroup to a ConditionExpression. */
162
+ function groupToExpression(group) {
163
+ const children = group.conditions.map(conditionToExpression);
164
+ let inner;
165
+ if (children.length === 1) {
166
+ inner = children[0];
167
+ }
168
+ else if (group.logic === 'or') {
169
+ inner = { kind: 'or', children };
170
+ }
171
+ else {
172
+ inner = { kind: 'and', children };
173
+ }
174
+ if (group.negated) {
175
+ return { kind: 'not', child: inner };
176
+ }
177
+ return inner;
178
+ }
179
+ /** Convert a PolicyCondition back to a leaf ConditionExpression. */
180
+ function conditionToExpression(cond) {
181
+ // Raw sentinel → raw expression
182
+ if (cond.field === RAW_CONDITION_FIELD) {
183
+ return { kind: 'raw', text: String(cond.value) };
184
+ }
185
+ switch (cond.operator) {
186
+ case 'contains': {
187
+ // contains() checks a single value against a set — value is never string[]
188
+ const containsVal = Array.isArray(cond.value) ? cond.value[0] ?? '' : cond.value;
189
+ return { kind: 'contains', field: cond.field, value: containsVal };
190
+ }
191
+ case 'like':
192
+ return { kind: 'like', field: cond.field, pattern: String(cond.value) };
193
+ default:
194
+ return {
195
+ kind: 'comparison',
196
+ field: cond.field,
197
+ operator: cond.operator,
198
+ value: cond.value,
199
+ };
200
+ }
201
+ }
202
+ // ---------------------------------------------------------------------------
203
+ // expressionToCedar
204
+ // ---------------------------------------------------------------------------
205
+ /**
206
+ * Render any ConditionExpression node to valid Cedar condition text.
207
+ *
208
+ * This handles the full AST including AND, OR, NOT, and raw nodes —
209
+ * unlike `conditionToCedar()` which only handles leaf PolicyConditions.
210
+ *
211
+ * @param expr - The expression tree to render
212
+ * @param optionalFields - Optional set of field names that need `context has` guards
213
+ * @returns Cedar condition text (without the `when { ... }` wrapper)
214
+ */
215
+ export function expressionToCedar(expr, optionalFields) {
216
+ switch (expr.kind) {
217
+ case 'comparison':
218
+ case 'contains':
219
+ case 'like':
220
+ return conditionToCedar(leafToCondition(expr), optionalFields);
221
+ case 'has': {
222
+ const field = sanitizeIdentifier(expr.field, 'field');
223
+ return `context has ${field}`;
224
+ }
225
+ case 'and': {
226
+ if (expr.children.length === 0)
227
+ return 'true';
228
+ if (expr.children.length === 1)
229
+ return expressionToCedar(expr.children[0], optionalFields);
230
+ return expr.children
231
+ .map(c => {
232
+ // Parenthesize OR children to preserve precedence
233
+ if (c.kind === 'or')
234
+ return `(${expressionToCedar(c, optionalFields)})`;
235
+ return expressionToCedar(c, optionalFields);
236
+ })
237
+ .join(' && ');
238
+ }
239
+ case 'or': {
240
+ if (expr.children.length === 0)
241
+ return 'false';
242
+ if (expr.children.length === 1)
243
+ return expressionToCedar(expr.children[0], optionalFields);
244
+ return expr.children
245
+ .map(c => {
246
+ // Parenthesize AND children to preserve precedence
247
+ if (c.kind === 'and')
248
+ return `(${expressionToCedar(c, optionalFields)})`;
249
+ return expressionToCedar(c, optionalFields);
250
+ })
251
+ .join(' || ');
252
+ }
253
+ case 'not': {
254
+ const inner = expressionToCedar(expr.child, optionalFields);
255
+ // If inner is a simple leaf, no parens needed after !
256
+ if (isLeaf(expr.child))
257
+ return `!${inner}`;
258
+ return `!(${inner})`;
259
+ }
260
+ case 'raw': {
261
+ if (isValidRawCondition(expr.text)) {
262
+ return expr.text;
263
+ }
264
+ return '/* invalid raw condition */';
265
+ }
266
+ }
267
+ }
268
+ // ---------------------------------------------------------------------------
269
+ // extractContextFields
270
+ // ---------------------------------------------------------------------------
271
+ /**
272
+ * Extract all unique context field names referenced in a ConditionExpression tree.
273
+ *
274
+ * Used by Shield to determine which detectors to run — only detectors that
275
+ * produce fields referenced in active policies need to execute.
276
+ *
277
+ * @returns Sorted array of unique field names
278
+ */
279
+ export function extractContextFields(expr) {
280
+ const fields = new Set();
281
+ collectFields(expr, fields);
282
+ return Array.from(fields).sort();
283
+ }
284
+ function collectFields(expr, fields) {
285
+ switch (expr.kind) {
286
+ case 'comparison':
287
+ case 'contains':
288
+ case 'like':
289
+ case 'has':
290
+ fields.add(expr.field);
291
+ break;
292
+ case 'and':
293
+ case 'or':
294
+ for (const child of expr.children) {
295
+ collectFields(child, fields);
296
+ }
297
+ break;
298
+ case 'not':
299
+ collectFields(expr.child, fields);
300
+ break;
301
+ case 'raw':
302
+ // Can't reliably extract fields from raw text
303
+ break;
304
+ }
305
+ }
package/dist/index.d.ts CHANGED
@@ -8,16 +8,21 @@ export * from './parser.js';
8
8
  export * from './errors.js';
9
9
  export * from './annotations.js';
10
10
  export * from './explain.js';
11
- export { GUARDRAILS_SCHEMA, GUARDRAILS_CONTEXT, OVERWATCH_SCHEMA, OVERWATCH_CONTEXT, PALISADE_SCHEMA, PALISADE_CONTEXT, } from './service-schemas.gen.js';
11
+ export * from './condition-groups.js';
12
+ export { GUARDRAILS_SCHEMA, GUARDRAILS_CONTEXT, OVERWATCH_SCHEMA, OVERWATCH_CONTEXT, PALISADE_SCHEMA, PALISADE_CONTEXT, SENTRY_SCHEMA, SENTRY_CONTEXT, } from './service-schemas.gen.js';
12
13
  export type { ContextAttribute, ActionContext, ServiceContext, } from './service-schemas.gen.js';
13
14
  export { GuardrailsContextKey } from './guardrails-context.gen.js';
14
15
  export { OverwatchContextKey } from './overwatch-context.gen.js';
15
16
  export { PalisadeContextKey } from './palisade-context.gen.js';
17
+ export { SentryContextKey } from './sentry-context.gen.js';
16
18
  export { GUARDRAILS_ENTITIES, GUARDRAILS_ACTION_ENTITIES, } from './guardrails-entities.gen.js';
17
19
  export { OVERWATCH_ENTITIES, OVERWATCH_ACTION_ENTITIES, } from './overwatch-entities.gen.js';
18
20
  export { PALISADE_ENTITIES, PALISADE_ACTION_ENTITIES, } from './palisade-entities.gen.js';
21
+ export { SENTRY_ENTITIES, SENTRY_ACTION_ENTITIES, } from './sentry-entities.gen.js';
19
22
  export type { ServiceEntityMetadata, ActionEntityMetadata } from './entity-metadata-types.gen.js';
20
23
  export { GUARDRAILS_DEFAULTS, GUARDRAILS_TEMPLATES, GUARDRAILS_CATEGORIES, GUARDRAILS_TEMPLATES_JSON, getGuardrailsDefaultsByCategory, getGuardrailsTemplatesByCategory, getGuardrailsTemplateById, } from './guardrails-defaults.gen.js';
21
24
  export type { GuardrailsCategory, GuardrailsCategoryInfo, GuardrailsDefaultPolicy, GuardrailsTemplate, } from './guardrails-defaults.gen.js';
22
25
  export { OVERWATCH_DEFAULTS, OVERWATCH_TEMPLATES, OVERWATCH_CATEGORIES, OVERWATCH_TEMPLATES_JSON, getOverwatchDefaultsByCategory, getOverwatchTemplatesByCategory, getOverwatchTemplateById, } from './overwatch-defaults.gen.js';
23
26
  export type { OverwatchCategory, OverwatchCategoryInfo, OverwatchDefaultPolicy, OverwatchTemplate, } from './overwatch-defaults.gen.js';
27
+ export { SENTRY_DEFAULTS, SENTRY_TEMPLATES, SENTRY_CATEGORIES, SENTRY_TEMPLATES_JSON, getSentryDefaultsByCategory, getSentryTemplatesByCategory, getSentryTemplateById, } from './sentry-defaults.gen.js';
28
+ export type { SentryCategory, SentryCategoryInfo, SentryDefaultPolicy, SentryTemplate, } from './sentry-defaults.gen.js';
package/dist/index.js CHANGED
@@ -15,16 +15,21 @@ export * from './errors.js';
15
15
  export * from './annotations.js';
16
16
  // Decision explanation
17
17
  export * from './explain.js';
18
+ // Condition groups (AST ↔ flat UI groups)
19
+ export * from './condition-groups.js';
18
20
  // Service-specific schemas and context (inlined)
19
- export { GUARDRAILS_SCHEMA, GUARDRAILS_CONTEXT, OVERWATCH_SCHEMA, OVERWATCH_CONTEXT, PALISADE_SCHEMA, PALISADE_CONTEXT, } from './service-schemas.gen.js';
21
+ export { GUARDRAILS_SCHEMA, GUARDRAILS_CONTEXT, OVERWATCH_SCHEMA, OVERWATCH_CONTEXT, PALISADE_SCHEMA, PALISADE_CONTEXT, SENTRY_SCHEMA, SENTRY_CONTEXT, } from './service-schemas.gen.js';
20
22
  // Service-specific context key enums
21
23
  export { GuardrailsContextKey } from './guardrails-context.gen.js';
22
24
  export { OverwatchContextKey } from './overwatch-context.gen.js';
23
25
  export { PalisadeContextKey } from './palisade-context.gen.js';
26
+ export { SentryContextKey } from './sentry-context.gen.js';
24
27
  // Service-specific entity metadata (for UI - principals, resources, actions)
25
28
  export { GUARDRAILS_ENTITIES, GUARDRAILS_ACTION_ENTITIES, } from './guardrails-entities.gen.js';
26
29
  export { OVERWATCH_ENTITIES, OVERWATCH_ACTION_ENTITIES, } from './overwatch-entities.gen.js';
27
30
  export { PALISADE_ENTITIES, PALISADE_ACTION_ENTITIES, } from './palisade-entities.gen.js';
31
+ export { SENTRY_ENTITIES, SENTRY_ACTION_ENTITIES, } from './sentry-entities.gen.js';
28
32
  // Service-specific default policies, templates, and categories
29
33
  export { GUARDRAILS_DEFAULTS, GUARDRAILS_TEMPLATES, GUARDRAILS_CATEGORIES, GUARDRAILS_TEMPLATES_JSON, getGuardrailsDefaultsByCategory, getGuardrailsTemplatesByCategory, getGuardrailsTemplateById, } from './guardrails-defaults.gen.js';
30
34
  export { OVERWATCH_DEFAULTS, OVERWATCH_TEMPLATES, OVERWATCH_CATEGORIES, OVERWATCH_TEMPLATES_JSON, getOverwatchDefaultsByCategory, getOverwatchTemplatesByCategory, getOverwatchTemplateById, } from './overwatch-defaults.gen.js';
35
+ export { SENTRY_DEFAULTS, SENTRY_TEMPLATES, SENTRY_CATEGORIES, SENTRY_TEMPLATES_JSON, getSentryDefaultsByCategory, getSentryTemplatesByCategory, getSentryTemplateById, } from './sentry-defaults.gen.js';
@@ -41,6 +41,13 @@ export declare const OverwatchContextKey: {
41
41
  readonly SecretCount: "secret_count";
42
42
  readonly SecretTypes: "secret_types";
43
43
  readonly SequenceRisk: "sequence_risk";
44
+ readonly SessionCommandInjection: "session_command_injection";
45
+ readonly SessionInjectionDetected: "session_injection_detected";
46
+ readonly SessionPiiDetected: "session_pii_detected";
47
+ readonly SessionPiiTypes: "session_pii_types";
48
+ readonly SessionSecretTypes: "session_secret_types";
49
+ readonly SessionSecretsDetected: "session_secrets_detected";
50
+ readonly SessionThreatTurns: "session_threat_turns";
44
51
  readonly SexualScore: "sexual_score";
45
52
  readonly Source: "source";
46
53
  readonly SuspiciousPattern: "suspicious_pattern";
@@ -43,6 +43,13 @@ export const OverwatchContextKey = {
43
43
  SecretCount: 'secret_count',
44
44
  SecretTypes: 'secret_types',
45
45
  SequenceRisk: 'sequence_risk',
46
+ SessionCommandInjection: 'session_command_injection',
47
+ SessionInjectionDetected: 'session_injection_detected',
48
+ SessionPiiDetected: 'session_pii_detected',
49
+ SessionPiiTypes: 'session_pii_types',
50
+ SessionSecretTypes: 'session_secret_types',
51
+ SessionSecretsDetected: 'session_secrets_detected',
52
+ SessionThreatTurns: 'session_threat_turns',
46
53
  SexualScore: 'sexual_score',
47
54
  Source: 'source',
48
55
  SuspiciousPattern: 'suspicious_pattern',
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Context attribute keys for Sentry Sentry browser security — monitors AI chat interactions and enforces data-protection, content-safety, and compliance policies.
3
+ *
4
+ * These constants correspond to the context attributes defined in the
5
+ * Sentry Cedar schema and are used at policy evaluation time.
6
+ */
7
+ export declare const SentryContextKey: {
8
+ readonly CodeLanguages: "code_languages";
9
+ readonly CodeRatio: "code_ratio";
10
+ readonly ContainsCode: "contains_code";
11
+ readonly ContainsInvisibleChars: "contains_invisible_chars";
12
+ readonly ContainsSecrets: "contains_secrets";
13
+ readonly Content: "content";
14
+ readonly ContentTopics: "content_topics";
15
+ readonly CrimeScore: "crime_score";
16
+ readonly DetectedLanguage: "detected_language";
17
+ readonly DetectedScript: "detected_script";
18
+ readonly DetectedThreats: "detected_threats";
19
+ readonly EncodedContentDetected: "encoded_content_detected";
20
+ readonly EncodedCount: "encoded_count";
21
+ readonly EncodedScore: "encoded_score";
22
+ readonly EncodedTypes: "encoded_types";
23
+ readonly Event: "event";
24
+ readonly FactualityScore: "factuality_score";
25
+ readonly FileExtension: "file_extension";
26
+ readonly FileName: "file_name";
27
+ readonly FileSizeBytes: "file_size_bytes";
28
+ readonly FileType: "file_type";
29
+ readonly HallucinationScore: "hallucination_score";
30
+ readonly HateSpeechScore: "hate_speech_score";
31
+ readonly HighestSeverity: "highest_severity";
32
+ readonly InjectionScore: "injection_score";
33
+ readonly InvisibleCharsScore: "invisible_chars_score";
34
+ readonly IsEncrypted: "is_encrypted";
35
+ readonly IsEnglish: "is_english";
36
+ readonly IsLatinScript: "is_latin_script";
37
+ readonly IsRightsManaged: "is_rights_managed";
38
+ readonly JailbreakScore: "jailbreak_score";
39
+ readonly KeywordCategories: "keyword_categories";
40
+ readonly KeywordCount: "keyword_count";
41
+ readonly KeywordMatched: "keyword_matched";
42
+ readonly LanguageConfidence: "language_confidence";
43
+ readonly MaxThreatSeverity: "max_threat_severity";
44
+ readonly MipLabelId: "mip_label_id";
45
+ readonly MipLabelName: "mip_label_name";
46
+ readonly PasteLength: "paste_length";
47
+ readonly PasteSourceApp: "paste_source_app";
48
+ readonly PasteSourceUrl: "paste_source_url";
49
+ readonly PhishingDetected: "phishing_detected";
50
+ readonly PiiConfidence: "pii_confidence";
51
+ readonly PiiCount: "pii_count";
52
+ readonly PiiDetected: "pii_detected";
53
+ readonly PiiTypes: "pii_types";
54
+ readonly ProfanityScore: "profanity_score";
55
+ readonly ScriptConfidence: "script_confidence";
56
+ readonly SecretCount: "secret_count";
57
+ readonly SecretTypes: "secret_types";
58
+ readonly SensitivityLevel: "sensitivity_level";
59
+ readonly SessionInjectionDetected: "session_injection_detected";
60
+ readonly SessionPiiDetected: "session_pii_detected";
61
+ readonly SessionPiiTypes: "session_pii_types";
62
+ readonly SessionSecretTypes: "session_secret_types";
63
+ readonly SessionSecretsDetected: "session_secrets_detected";
64
+ readonly SessionThreatTurns: "session_threat_turns";
65
+ readonly SexualScore: "sexual_score";
66
+ readonly Source: "source";
67
+ readonly TargetApp: "target_app";
68
+ readonly TargetUrl: "target_url";
69
+ readonly ThreatCategories: "threat_categories";
70
+ readonly ThreatCount: "threat_count";
71
+ readonly TopicConfidence: "topic_confidence";
72
+ readonly UserEmail: "user_email";
73
+ readonly ViolenceScore: "violence_score";
74
+ readonly WeaponsScore: "weapons_score";
75
+ };
76
+ export type SentryContextKey = (typeof SentryContextKey)[keyof typeof SentryContextKey];
@@ -0,0 +1,77 @@
1
+ // Code generated by highflame-policy-codegen. DO NOT EDIT.
2
+ // Source: schemas/sentry/context.json
3
+ /**
4
+ * Context attribute keys for Sentry Sentry browser security — monitors AI chat interactions and enforces data-protection, content-safety, and compliance policies.
5
+ *
6
+ * These constants correspond to the context attributes defined in the
7
+ * Sentry Cedar schema and are used at policy evaluation time.
8
+ */
9
+ export const SentryContextKey = {
10
+ CodeLanguages: 'code_languages',
11
+ CodeRatio: 'code_ratio',
12
+ ContainsCode: 'contains_code',
13
+ ContainsInvisibleChars: 'contains_invisible_chars',
14
+ ContainsSecrets: 'contains_secrets',
15
+ Content: 'content',
16
+ ContentTopics: 'content_topics',
17
+ CrimeScore: 'crime_score',
18
+ DetectedLanguage: 'detected_language',
19
+ DetectedScript: 'detected_script',
20
+ DetectedThreats: 'detected_threats',
21
+ EncodedContentDetected: 'encoded_content_detected',
22
+ EncodedCount: 'encoded_count',
23
+ EncodedScore: 'encoded_score',
24
+ EncodedTypes: 'encoded_types',
25
+ Event: 'event',
26
+ FactualityScore: 'factuality_score',
27
+ FileExtension: 'file_extension',
28
+ FileName: 'file_name',
29
+ FileSizeBytes: 'file_size_bytes',
30
+ FileType: 'file_type',
31
+ HallucinationScore: 'hallucination_score',
32
+ HateSpeechScore: 'hate_speech_score',
33
+ HighestSeverity: 'highest_severity',
34
+ InjectionScore: 'injection_score',
35
+ InvisibleCharsScore: 'invisible_chars_score',
36
+ IsEncrypted: 'is_encrypted',
37
+ IsEnglish: 'is_english',
38
+ IsLatinScript: 'is_latin_script',
39
+ IsRightsManaged: 'is_rights_managed',
40
+ JailbreakScore: 'jailbreak_score',
41
+ KeywordCategories: 'keyword_categories',
42
+ KeywordCount: 'keyword_count',
43
+ KeywordMatched: 'keyword_matched',
44
+ LanguageConfidence: 'language_confidence',
45
+ MaxThreatSeverity: 'max_threat_severity',
46
+ MipLabelId: 'mip_label_id',
47
+ MipLabelName: 'mip_label_name',
48
+ PasteLength: 'paste_length',
49
+ PasteSourceApp: 'paste_source_app',
50
+ PasteSourceUrl: 'paste_source_url',
51
+ PhishingDetected: 'phishing_detected',
52
+ PiiConfidence: 'pii_confidence',
53
+ PiiCount: 'pii_count',
54
+ PiiDetected: 'pii_detected',
55
+ PiiTypes: 'pii_types',
56
+ ProfanityScore: 'profanity_score',
57
+ ScriptConfidence: 'script_confidence',
58
+ SecretCount: 'secret_count',
59
+ SecretTypes: 'secret_types',
60
+ SensitivityLevel: 'sensitivity_level',
61
+ SessionInjectionDetected: 'session_injection_detected',
62
+ SessionPiiDetected: 'session_pii_detected',
63
+ SessionPiiTypes: 'session_pii_types',
64
+ SessionSecretTypes: 'session_secret_types',
65
+ SessionSecretsDetected: 'session_secrets_detected',
66
+ SessionThreatTurns: 'session_threat_turns',
67
+ SexualScore: 'sexual_score',
68
+ Source: 'source',
69
+ TargetApp: 'target_app',
70
+ TargetUrl: 'target_url',
71
+ ThreatCategories: 'threat_categories',
72
+ ThreatCount: 'threat_count',
73
+ TopicConfidence: 'topic_confidence',
74
+ UserEmail: 'user_email',
75
+ ViolenceScore: 'violence_score',
76
+ WeaponsScore: 'weapons_score',
77
+ };
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Sentry policy category identifiers.
3
+ * Maps to UI tab names in Studio.
4
+ */
5
+ export type SentryCategory = 'pii' | 'semantic' | 'content_safety' | 'file_safety' | 'organization';
6
+ /**
7
+ * Category metadata for UI display.
8
+ */
9
+ export interface SentryCategoryInfo {
10
+ id: SentryCategory;
11
+ name: string;
12
+ description: string;
13
+ }
14
+ /**
15
+ * A default policy that is auto-created for new projects.
16
+ */
17
+ export interface SentryDefaultPolicy {
18
+ /** Template identifier */
19
+ id: string;
20
+ /** Human-readable name */
21
+ name: string;
22
+ /** Description for UI display */
23
+ description: string;
24
+ /** Policy category */
25
+ category: SentryCategory;
26
+ /** Cedar policy text (source of truth) */
27
+ cedarText: string;
28
+ /** Severity level */
29
+ severity: string;
30
+ /** Tags for filtering */
31
+ tags: string[];
32
+ /** Whether this default should be activated immediately */
33
+ isActive: boolean;
34
+ }
35
+ /**
36
+ * A policy template available for users to create from.
37
+ */
38
+ export interface SentryTemplate {
39
+ /** Template identifier */
40
+ id: string;
41
+ /** Human-readable name */
42
+ name: string;
43
+ /** Description for UI display */
44
+ description: string;
45
+ /** Policy category */
46
+ category: SentryCategory;
47
+ /** Cedar policy text */
48
+ cedarText: string;
49
+ /** Severity level */
50
+ severity: string;
51
+ /** Tags for filtering */
52
+ tags: string[];
53
+ }
54
+ export declare const SENTRY_CATEGORIES: SentryCategoryInfo[];
55
+ export declare const SENTRY_DEFAULTS: SentryDefaultPolicy[];
56
+ export declare const SENTRY_TEMPLATES: SentryTemplate[];
57
+ /** Raw templates.json metadata for the Sentry service. */
58
+ export declare const SENTRY_TEMPLATES_JSON: string;
59
+ export declare function getSentryDefaultsByCategory(category: SentryCategory): SentryDefaultPolicy[];
60
+ export declare function getSentryTemplatesByCategory(category: SentryCategory): SentryTemplate[];
61
+ export declare function getSentryTemplateById(id: string): SentryTemplate | undefined;