@chatwarden/core 0.1.5 → 0.1.7

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 (131) hide show
  1. package/README.md +51 -1
  2. package/dist/src/ai/agreement.d.ts +46 -0
  3. package/dist/src/ai/agreement.d.ts.map +1 -0
  4. package/dist/src/ai/agreement.js +71 -0
  5. package/dist/src/ai/agreement.js.map +1 -0
  6. package/dist/src/ai/breaker.d.ts +31 -0
  7. package/dist/src/ai/breaker.d.ts.map +1 -0
  8. package/dist/src/ai/breaker.js +62 -0
  9. package/dist/src/ai/breaker.js.map +1 -0
  10. package/dist/src/ai/budget.d.ts +26 -0
  11. package/dist/src/ai/budget.d.ts.map +1 -0
  12. package/dist/src/ai/budget.js +57 -0
  13. package/dist/src/ai/budget.js.map +1 -0
  14. package/dist/src/ai/case.d.ts +37 -0
  15. package/dist/src/ai/case.d.ts.map +1 -0
  16. package/dist/src/ai/case.js +30 -0
  17. package/dist/src/ai/case.js.map +1 -0
  18. package/dist/src/ai/casebook.d.ts +59 -0
  19. package/dist/src/ai/casebook.d.ts.map +1 -0
  20. package/dist/src/ai/casebook.js +47 -0
  21. package/dist/src/ai/casebook.js.map +1 -0
  22. package/dist/src/ai/ceilings.d.ts +42 -0
  23. package/dist/src/ai/ceilings.d.ts.map +1 -0
  24. package/dist/src/ai/ceilings.js +59 -0
  25. package/dist/src/ai/ceilings.js.map +1 -0
  26. package/dist/src/ai/fake.d.ts +41 -0
  27. package/dist/src/ai/fake.d.ts.map +1 -0
  28. package/dist/src/ai/fake.js +75 -0
  29. package/dist/src/ai/fake.js.map +1 -0
  30. package/dist/src/ai/hash.d.ts +13 -0
  31. package/dist/src/ai/hash.d.ts.map +1 -0
  32. package/dist/src/ai/hash.js +19 -0
  33. package/dist/src/ai/hash.js.map +1 -0
  34. package/dist/src/ai/inert.d.ts +5 -0
  35. package/dist/src/ai/inert.d.ts.map +1 -0
  36. package/dist/src/ai/inert.js +22 -0
  37. package/dist/src/ai/inert.js.map +1 -0
  38. package/dist/src/ai/injection.d.ts +8 -0
  39. package/dist/src/ai/injection.d.ts.map +1 -0
  40. package/dist/src/ai/injection.js +30 -0
  41. package/dist/src/ai/injection.js.map +1 -0
  42. package/dist/src/ai/lines.d.ts +64 -0
  43. package/dist/src/ai/lines.d.ts.map +1 -0
  44. package/dist/src/ai/lines.js +172 -0
  45. package/dist/src/ai/lines.js.map +1 -0
  46. package/dist/src/ai/prompt.d.ts +44 -0
  47. package/dist/src/ai/prompt.d.ts.map +1 -0
  48. package/dist/src/ai/prompt.js +185 -0
  49. package/dist/src/ai/prompt.js.map +1 -0
  50. package/dist/src/ai/redact.d.ts +29 -0
  51. package/dist/src/ai/redact.d.ts.map +1 -0
  52. package/dist/src/ai/redact.js +160 -0
  53. package/dist/src/ai/redact.js.map +1 -0
  54. package/dist/src/ai/schema.d.ts +6 -0
  55. package/dist/src/ai/schema.d.ts.map +1 -0
  56. package/dist/src/ai/schema.js +50 -0
  57. package/dist/src/ai/schema.js.map +1 -0
  58. package/dist/src/ai/service.d.ts +328 -0
  59. package/dist/src/ai/service.d.ts.map +1 -0
  60. package/dist/src/ai/service.js +749 -0
  61. package/dist/src/ai/service.js.map +1 -0
  62. package/dist/src/ai/types.d.ts +180 -0
  63. package/dist/src/ai/types.d.ts.map +1 -0
  64. package/dist/src/ai/types.js +23 -0
  65. package/dist/src/ai/types.js.map +1 -0
  66. package/dist/src/ai/validate.d.ts +30 -0
  67. package/dist/src/ai/validate.d.ts.map +1 -0
  68. package/dist/src/ai/validate.js +160 -0
  69. package/dist/src/ai/validate.js.map +1 -0
  70. package/dist/src/ai/worker.d.ts +74 -0
  71. package/dist/src/ai/worker.d.ts.map +1 -0
  72. package/dist/src/ai/worker.js +286 -0
  73. package/dist/src/ai/worker.js.map +1 -0
  74. package/dist/src/audit.d.ts +12 -3
  75. package/dist/src/audit.d.ts.map +1 -1
  76. package/dist/src/audit.js +30 -4
  77. package/dist/src/audit.js.map +1 -1
  78. package/dist/src/chatwarden.d.ts +28 -0
  79. package/dist/src/chatwarden.d.ts.map +1 -1
  80. package/dist/src/chatwarden.js +60 -1
  81. package/dist/src/chatwarden.js.map +1 -1
  82. package/dist/src/decide.d.ts +36 -1
  83. package/dist/src/decide.d.ts.map +1 -1
  84. package/dist/src/decide.js +62 -2
  85. package/dist/src/decide.js.map +1 -1
  86. package/dist/src/documents.d.ts +1 -1
  87. package/dist/src/documents.d.ts.map +1 -1
  88. package/dist/src/documents.js +4 -1
  89. package/dist/src/documents.js.map +1 -1
  90. package/dist/src/index.d.ts +27 -5
  91. package/dist/src/index.d.ts.map +1 -1
  92. package/dist/src/index.js +17 -2
  93. package/dist/src/index.js.map +1 -1
  94. package/dist/src/profile.d.ts +30 -1
  95. package/dist/src/profile.d.ts.map +1 -1
  96. package/dist/src/profile.js +43 -4
  97. package/dist/src/profile.js.map +1 -1
  98. package/dist/src/retention.d.ts +19 -0
  99. package/dist/src/retention.d.ts.map +1 -1
  100. package/dist/src/retention.js +33 -10
  101. package/dist/src/retention.js.map +1 -1
  102. package/dist/src/types.d.ts +269 -2
  103. package/dist/src/types.d.ts.map +1 -1
  104. package/dist/src/types.js.map +1 -1
  105. package/package.json +2 -2
  106. package/src/ai/agreement.ts +106 -0
  107. package/src/ai/breaker.ts +73 -0
  108. package/src/ai/budget.ts +65 -0
  109. package/src/ai/case.ts +74 -0
  110. package/src/ai/casebook.ts +75 -0
  111. package/src/ai/ceilings.ts +68 -0
  112. package/src/ai/fake.ts +105 -0
  113. package/src/ai/hash.ts +20 -0
  114. package/src/ai/inert.ts +26 -0
  115. package/src/ai/injection.ts +32 -0
  116. package/src/ai/lines.ts +216 -0
  117. package/src/ai/prompt.ts +208 -0
  118. package/src/ai/redact.ts +174 -0
  119. package/src/ai/schema.ts +51 -0
  120. package/src/ai/service.ts +955 -0
  121. package/src/ai/types.ts +165 -0
  122. package/src/ai/validate.ts +173 -0
  123. package/src/ai/worker.ts +364 -0
  124. package/src/audit.ts +31 -5
  125. package/src/chatwarden.ts +82 -1
  126. package/src/decide.ts +97 -4
  127. package/src/documents.ts +5 -2
  128. package/src/index.ts +52 -1
  129. package/src/profile.ts +68 -4
  130. package/src/retention.ts +47 -10
  131. package/src/types.ts +294 -2
@@ -0,0 +1,165 @@
1
+ import type { ConductLevel } from '../types.js';
2
+
3
+ // The provider-free AI contract (design 2026-11-11, section 3). Core defines the shapes, the prompt, the redaction, the validation
4
+ // and the ceilings; an adapter only sends the rendered prompt to a model and returns what came back. Nothing here imports a
5
+ // provider SDK, `fetch` or a sanction module: the AI reads and advises, it never acts.
6
+
7
+ /**
8
+ * The prompt version. Bumped when the prompt or the output schema changes; part of the input hash, so a bump makes every stored
9
+ * read stale.
10
+ * @experimental
11
+ */
12
+ export const AI_PROMPT_VERSION = 2;
13
+
14
+ /**
15
+ * One speaker in a read: an alias (`P1` is the reported person, `P2` the reporter, the rest `P3...` in order of first appearance)
16
+ * and the part they play. No identifier ever travels with it.
17
+ * @experimental
18
+ */
19
+ export interface AIPerson {
20
+ alias: string;
21
+ role: 'reported' | 'reporter' | 'other';
22
+ }
23
+
24
+ /**
25
+ * A pseudonymised casebook example: a decided case, as aliases and redacted lines only (at most 6), with the human's final
26
+ * verdict as its label. It sits in the variable part of the prompt.
27
+ * @experimental
28
+ */
29
+ export interface AIExample {
30
+ rule: number | 'uncovered' | null;
31
+ severity: ConductLevel;
32
+ /** What the human settled on. */
33
+ verdict: 'upheld' | 'noted' | 'no_action';
34
+ lines: Array<{ who: string; text: string }>;
35
+ }
36
+
37
+ /**
38
+ * A casebook example as the store hands it over: the {@link AIExample} and its row id. The id never reaches the provider; the read
39
+ * stores the ids of the examples it used (`AIStoredRead.exampleIds`).
40
+ * @experimental
41
+ */
42
+ export type AIExampleInput = AIExample & { id: string };
43
+
44
+ /**
45
+ * Everything an adapter may use to read one report. The lines and the note are already redacted and carry aliases and refs
46
+ * only; no identifier is in here.
47
+ * @experimental
48
+ */
49
+ export interface AIReadInput {
50
+ /** Bumped when the prompt or schema changes; part of the cache key and of the invalidation hash. */
51
+ promptVersion: number;
52
+ /** The structured facts, for an adapter that wants to render its own prompt. */
53
+ report: { reason: { id: string; label: string } | null; note: string | null };
54
+ /** `P1` reported, `P2` reporter, `P3...` the rest. */
55
+ people: AIPerson[];
56
+ /** `L1...Ln`, redacted, in time order. */
57
+ lines: Array<{ ref: string; secondsIn: number; who: string; text: string; blocked: boolean; filtered: boolean }>;
58
+ /** The ref the reporter pointed at, or null. */
59
+ reportedLine: string | null;
60
+ /** True when lines were left out of the 40 kept. */
61
+ truncated: boolean;
62
+ /** Active rules only, in number order. */
63
+ rules: Array<{ number: number; title: string; text: string }>;
64
+ levels: Array<{ level: ConductLevel; meaning: string; examples: string[] }>;
65
+ /** `profile.aiContext`. */
66
+ standard: string;
67
+ /** Casebook, at most 2, pseudonymised. */
68
+ examples: AIExample[];
69
+ /** The same content rendered by core. An adapter should use it as is. */
70
+ prompt: { stable: string; variable: string; schema: object };
71
+ }
72
+
73
+ /**
74
+ * A read as it is stored: the validated answer plus the ids of the casebook examples that were in its prompt. The examples are not part
75
+ * of the input hash (a growing casebook must not make every stored read look stale), so the read records which ones it saw.
76
+ * @experimental
77
+ */
78
+ export interface AIStoredRead extends AIRead {
79
+ exampleIds: string[];
80
+ }
81
+
82
+ /**
83
+ * What an adapter returns. No outcome, no sanction: `output` is the model's JSON, which core validates.
84
+ * @experimental
85
+ */
86
+ export interface AIReadResult {
87
+ /** Parsed JSON as the model produced it. Core validates it; the adapter does not need to. */
88
+ output: unknown;
89
+ usage: AIUsage;
90
+ }
91
+
92
+ /**
93
+ * What one call cost. Core only sums it.
94
+ * @experimental
95
+ */
96
+ export interface AIUsage {
97
+ model: string;
98
+ inputTokens: number;
99
+ outputTokens: number;
100
+ cacheReadTokens: number;
101
+ cacheWriteTokens: number;
102
+ /** Integer micro-dollars (1 = $0.000001), computed by the adapter from its own price table. */
103
+ costMicros: number;
104
+ }
105
+
106
+ /**
107
+ * The part of an `AbortSignal` that core and an adapter use, written out so core's published declarations need no DOM or Node lib: a real
108
+ * `AbortSignal` is one. It says whether the call was given up on, and tells a listener once when it is.
109
+ * @experimental
110
+ */
111
+ export interface AbortSignalLike {
112
+ readonly aborted: boolean;
113
+ addEventListener(type: 'abort', listener: () => void, options?: { once?: boolean }): void;
114
+ removeEventListener(type: 'abort', listener: () => void): void;
115
+ }
116
+
117
+ /**
118
+ * Implemented outside core. Runs on the server only. No method may hold or return a credential.
119
+ * @experimental
120
+ */
121
+ export interface ModerationAI {
122
+ /** Stable label for audit and logs, e.g. `anthropic:claude-haiku-5-5`. Never a key. */
123
+ readonly id: string;
124
+ read(input: AIReadInput, options: { signal: AbortSignalLike }): Promise<AIReadResult>;
125
+ }
126
+
127
+ /**
128
+ * What an adapter throws. Core never inspects a provider error type.
129
+ * `declined` means the provider refused to answer.
130
+ * @experimental
131
+ */
132
+ export class AIError extends Error {
133
+ readonly kind: 'retryable' | 'fatal' | 'declined' | 'timeout';
134
+ constructor(kind: AIError['kind'], message?: string) {
135
+ super(message ?? kind);
136
+ this.name = 'AIError';
137
+ this.kind = kind;
138
+ }
139
+ }
140
+
141
+ /**
142
+ * The validated output core stores and the hub shows. The recommendation never carries an outcome (no kind, no duration): the
143
+ * hub asks the ladder for one. It can never be `bad_faith`.
144
+ * @experimental
145
+ */
146
+ export interface AIRead {
147
+ /** banter | rude | hostile | severe, as the profile defines them. */
148
+ severity: ConductLevel;
149
+ /** The Community Rule it falls under. */
150
+ rule: number | 'uncovered' | null;
151
+ /** One line, at most 160 characters, plain text. */
152
+ summary: string;
153
+ /** Line refs, at most 5. */
154
+ evidence: string[];
155
+ confidence: 'low' | 'medium' | 'high';
156
+ /** A line tried to instruct the AI. */
157
+ injectionSuspected: boolean;
158
+ /** Exposed at level 2 only; always computed. */
159
+ recommendation: null | {
160
+ verdict: 'upheld' | 'noted' | 'no_action' | 'unclear';
161
+ severity: ConductLevel;
162
+ rule: number | 'uncovered' | null;
163
+ evidence: string[];
164
+ };
165
+ }
@@ -0,0 +1,173 @@
1
+ import { CONDUCT_LEVELS } from '../types.js';
2
+ import type { ConductLevel } from '../types.js';
3
+ import { isInvisible } from './redact.js';
4
+ import type { AIRead } from './types.js';
5
+
6
+ // Core's own check of a model's answer (design section 8, layer 4). Hand-written: core keeps no dependency. It downgrades, it does
7
+ // not guess: a thing that cannot be trusted is `ok: false` with a fixed code (never the offending text), and an uphold or note
8
+ // with no line by the reported person is softened to `unclear`.
9
+
10
+ /** The facts about what was sent, which the answer is checked against. */
11
+ export interface AIValidationContext {
12
+ /** Every line ref that was in the prompt. */
13
+ sent: ReadonlySet<string>;
14
+ /** The numbers of the rules that were active when the prompt was built. */
15
+ activeRules: ReadonlySet<number>;
16
+ /** The refs (a subset of `sent`) of lines written by the reported person. */
17
+ ownRefs: ReadonlySet<string>;
18
+ }
19
+
20
+ /**
21
+ * The result of {@link validateAIOutput}. `code` on an `ok` result says the read was softened (today only `no_own_line`).
22
+ * @experimental
23
+ */
24
+ export type AIValidation =
25
+ | { ok: true; read: AIRead; code?: 'no_own_line' }
26
+ | { ok: false; code: string };
27
+
28
+ const SUMMARY_MAX = 160;
29
+ const EVIDENCE_MAX = 5;
30
+ const READ_KEYS = ['severity', 'rule', 'summary', 'evidence', 'confidence', 'injectionSuspected', 'recommendation'] as const;
31
+ const REC_KEYS = ['verdict', 'severity', 'rule', 'evidence'] as const;
32
+ const VERDICTS = ['upheld', 'noted', 'no_action', 'unclear'] as const;
33
+ const CONFIDENCES = ['low', 'medium', 'high'] as const;
34
+
35
+ const has = (o: object, k: string): boolean => Object.prototype.hasOwnProperty.call(o, k);
36
+ const isPlainObject = (v: unknown): v is Record<string, unknown> => typeof v === 'object' && v !== null && !Array.isArray(v);
37
+
38
+ type Fail = { ok: false; code: string };
39
+ const fail = (code: string): Fail => ({ ok: false, code });
40
+
41
+ /** Exactly these keys, own, no more and no fewer. */
42
+ function keysCode(o: Record<string, unknown>, expected: readonly string[]): string | null {
43
+ const own = Object.keys(o);
44
+ if (own.some((k) => !expected.includes(k))) return 'extra_key';
45
+ if (expected.some((k) => !has(o, k))) return 'missing_key';
46
+ return null;
47
+ }
48
+
49
+ function checkSeverity(v: unknown): v is ConductLevel {
50
+ return typeof v === 'string' && (CONDUCT_LEVELS as readonly string[]).includes(v);
51
+ }
52
+
53
+ function checkRule(v: unknown, active: ReadonlySet<number>): v is number | 'uncovered' | null {
54
+ if (v === null || v === 'uncovered') return true;
55
+ return typeof v === 'number' && Number.isInteger(v) && active.has(v);
56
+ }
57
+
58
+ /** The refs, duplicates collapsed in first-seen order; a code when one was not sent or there are more than five. */
59
+ function checkEvidence(v: unknown, sent: ReadonlySet<string>): string[] | string {
60
+ if (!Array.isArray(v)) return 'bad_evidence';
61
+ const out: string[] = [];
62
+ for (const ref of v as unknown[]) {
63
+ if (typeof ref !== 'string' || !sent.has(ref)) return 'bad_evidence';
64
+ if (!out.includes(ref)) out.push(ref);
65
+ }
66
+ return out.length > EVIDENCE_MAX ? 'too_much_evidence' : out;
67
+ }
68
+
69
+ // The summary is shown to a moderator as plain text, so it is checked as the hub will show it: after NFKC (full-width letters and dots
70
+ // fold to ASCII), with no control or invisible character, no tag, no link or address of any kind, no alias and no markdown.
71
+ const LINK = new RegExp(
72
+ [
73
+ String.raw`\b(?:https?|ftp)://`,
74
+ String.raw`\bwww\.`,
75
+ // Any domain-like token: label(.label)*.ending, the ending being 2 to 24 letters. "apologises.Later" is one too: a summary that
76
+ // runs two sentences together is rejected rather than risk a link.
77
+ String.raw`[\p{L}\p{N}-]+(?:\.[\p{L}\p{N}-]+)*\.\p{L}{2,24}(?![\p{L}\p{N}_-])`,
78
+ ].join('|'),
79
+ 'iu',
80
+ );
81
+ const IPV4 = /(?<![\w.])\d{1,3}(?:\.\d{1,3}){3}(?![\w]|\.\d)/;
82
+ const IPV6 = new RegExp(
83
+ [
84
+ String.raw`(?:[0-9a-f]{1,4}:){7}[0-9a-f]{1,4}`,
85
+ String.raw`(?:[0-9a-f]{1,4}:){1,7}:(?:[0-9a-f]{1,4}(?::[0-9a-f]{1,4}){0,6})?`,
86
+ String.raw`::(?:[0-9a-f]{1,4}:){0,6}[0-9a-f]{1,4}`,
87
+ ]
88
+ .map((p) => String.raw`(?<![\w:])${p}(?![\w:])`)
89
+ .join('|'),
90
+ 'i',
91
+ );
92
+ const MENTION = /@[\p{L}\p{N}_]/u;
93
+ const ALIAS = /\bP\d+\b/i;
94
+ const hasControl = (s: string): boolean => [...s].some((c) => c.charCodeAt(0) < 0x20 || c.charCodeAt(0) === 0x7f);
95
+ const hasInvisible = (s: string): boolean => [...s].some((c) => isInvisible(c.codePointAt(0) ?? 0));
96
+ const MARKDOWN = [
97
+ /^\s*#{1,6}(?:\s|$)/, // a heading
98
+ /^\s*(?:[-*+>]|\d+\.)\s/, // a list item, a quote
99
+ /`/, // code
100
+ /\*\*|__|~~/, // bold, underline, strike
101
+ /\[[^\]]*\]\([^)]*\)/, // a markdown link
102
+ ];
103
+
104
+ function checkSummary(v: unknown): string | { summary: string } {
105
+ if (typeof v !== 'string') return 'bad_summary';
106
+ const summary = v.normalize('NFKC').trim();
107
+ if (summary === '') return 'summary_empty';
108
+ if ([...summary].length > SUMMARY_MAX) return 'summary_too_long';
109
+ if (hasControl(summary)) return 'summary_markdown';
110
+ if (hasInvisible(summary)) return 'summary_invisible';
111
+ if (MENTION.test(summary)) return 'summary_mention';
112
+ if (LINK.test(summary)) return 'summary_link';
113
+ if (IPV4.test(summary) || IPV6.test(summary)) return 'summary_ip';
114
+ if (ALIAS.test(summary)) return 'summary_alias';
115
+ if (MARKDOWN.some((re) => re.test(summary))) return 'summary_markdown';
116
+ if (/[<>]/.test(summary)) return 'summary_markup';
117
+ return { summary };
118
+ }
119
+
120
+
121
+
122
+ /**
123
+ * Validate a model's parsed JSON against the answer shape and against what was sent. Never throws and never echoes the text it
124
+ * rejects: a failure is a fixed `code`. A recommendation to uphold or note whose cited lines include none by the reported person
125
+ * is softened to `unclear` (`code: 'no_own_line'`, still `ok`). `bad_faith` is not a valid verdict.
126
+ * @experimental
127
+ */
128
+ export function validateAIOutput(raw: unknown, ctx: AIValidationContext): AIValidation {
129
+ if (!isPlainObject(raw)) return fail('not_object');
130
+ const shape = keysCode(raw, READ_KEYS);
131
+ if (shape) return fail(shape);
132
+
133
+ if (!checkSeverity(raw.severity)) return fail('bad_severity');
134
+ if (!checkRule(raw.rule, ctx.activeRules)) return fail('bad_rule');
135
+ const summary = checkSummary(raw.summary);
136
+ if (typeof summary === 'string') return fail(summary);
137
+ const evidence = checkEvidence(raw.evidence, ctx.sent);
138
+ if (typeof evidence === 'string') return fail(evidence);
139
+ if (typeof raw.confidence !== 'string' || !(CONFIDENCES as readonly string[]).includes(raw.confidence)) return fail('bad_confidence');
140
+ if (typeof raw.injectionSuspected !== 'boolean') return fail('bad_injection_flag');
141
+
142
+ let recommendation: AIRead['recommendation'] = null;
143
+ let code: 'no_own_line' | undefined;
144
+ const r = raw.recommendation;
145
+ if (r !== null) {
146
+ if (!isPlainObject(r)) return fail('bad_recommendation');
147
+ const recShape = keysCode(r, REC_KEYS);
148
+ if (recShape) return fail(recShape);
149
+ if (r.verdict === 'bad_faith') return fail('bad_faith_verdict');
150
+ if (typeof r.verdict !== 'string' || !(VERDICTS as readonly string[]).includes(r.verdict)) return fail('bad_verdict');
151
+ if (!checkSeverity(r.severity)) return fail('bad_severity');
152
+ if (!checkRule(r.rule, ctx.activeRules)) return fail('bad_rule');
153
+ const recEvidence = checkEvidence(r.evidence, ctx.sent);
154
+ if (typeof recEvidence === 'string') return fail(recEvidence);
155
+ let verdict = r.verdict as (typeof VERDICTS)[number];
156
+ if ((verdict === 'upheld' || verdict === 'noted') && !recEvidence.some((ref) => ctx.ownRefs.has(ref))) {
157
+ verdict = 'unclear';
158
+ code = 'no_own_line';
159
+ }
160
+ recommendation = { verdict, severity: r.severity, rule: r.rule, evidence: recEvidence };
161
+ }
162
+
163
+ const read: AIRead = {
164
+ severity: raw.severity,
165
+ rule: raw.rule,
166
+ summary: summary.summary,
167
+ evidence,
168
+ confidence: raw.confidence as AIRead['confidence'],
169
+ injectionSuspected: raw.injectionSuspected,
170
+ recommendation,
171
+ };
172
+ return code ? { ok: true, read, code } : { ok: true, read };
173
+ }