advisers 0.3.2 → 0.4.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 (44) hide show
  1. package/README-zh.md +13 -14
  2. package/README.md +32 -23
  3. package/THIRD-PARTY-NOTICES.md +1 -1
  4. package/bin/advisers.js +2180 -92
  5. package/index.js +1 -1
  6. package/lib/brief-archive.js +267 -0
  7. package/lib/client-pack.js +1016 -0
  8. package/lib/consent.js +390 -0
  9. package/lib/credentials.js +195 -0
  10. package/lib/error-codes.js +516 -7
  11. package/lib/evidence.js +697 -113
  12. package/lib/kb-extract.js +626 -0
  13. package/lib/kb-facts.js +429 -0
  14. package/lib/kb-pages.js +1084 -0
  15. package/lib/kb.js +1036 -0
  16. package/lib/mail-errors.js +46 -0
  17. package/lib/mail-extract.js +351 -0
  18. package/lib/mail-imap.js +446 -0
  19. package/lib/mail-import.js +176 -0
  20. package/lib/mail-parse.js +223 -0
  21. package/lib/mail-store.js +731 -0
  22. package/lib/mail.js +506 -0
  23. package/lib/mcp-server.js +196 -10
  24. package/lib/notify.js +265 -7
  25. package/lib/policy/decision.js +315 -0
  26. package/lib/policy/egress.js +268 -0
  27. package/lib/policy/errors.js +71 -0
  28. package/lib/policy/index.js +99 -0
  29. package/lib/policy/rules.js +468 -0
  30. package/lib/policy/surfaces.js +141 -0
  31. package/lib/receipt-verify.js +199 -19
  32. package/lib/receivables.js +1653 -0
  33. package/lib/scheduler.js +453 -9
  34. package/lib/shell.js +1406 -0
  35. package/lib/source.js +98 -3
  36. package/lib/sqlite.js +366 -49
  37. package/lib/tos/index.js +2 -2
  38. package/lib/tos/manifest.json +6 -6
  39. package/lib/tos/privacy.zh-CN.md +33 -20
  40. package/lib/tos/safety.zh-CN.md +7 -6
  41. package/lib/tos/summary.zh-CN.md +3 -2
  42. package/lib/tos/terms.zh-CN.md +31 -16
  43. package/lib/urgency.js +467 -0
  44. package/package.json +4 -4
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 0.4.0 mail-entry error helpers.
3
+ *
4
+ * Every failure in lib/mail*.js and lib/credentials.js is an Error with a stable
5
+ * `code` (the mail/IMAP/credential codes below), an optional `hint`,
6
+ * and a message that never contains a password or email body text. The new
7
+ * codes are registered in lib/error-codes.js at integration time (see the 0.4
8
+ * implementation report).
9
+ *
10
+ * This module is pure (no I/O, no network, no console).
11
+ */
12
+
13
+ /** All mail/IMAP/credential codes this feature can raise. */
14
+ export const MAIL_ERROR_CODES = Object.freeze({
15
+ CONFIG: 'E_MAIL_CONFIG',
16
+ ACCOUNT_NOT_FOUND: 'E_MAIL_ACCOUNT_NOT_FOUND',
17
+ MESSAGE_NOT_FOUND: 'E_MAIL_MESSAGE_NOT_FOUND',
18
+ CREDENTIALS_MISSING: 'E_MAIL_CREDENTIALS_MISSING',
19
+ CREDENTIALS_INSECURE: 'E_CREDENTIALS_INSECURE',
20
+ IMAP_AUTH: 'E_IMAP_AUTH',
21
+ IMAP_TLS: 'E_IMAP_TLS',
22
+ IMAP_UIDVALIDITY: 'E_IMAP_UIDVALIDITY',
23
+ IMAP_PROTOCOL: 'E_IMAP_PROTOCOL',
24
+ IMAP_TIMEOUT: 'E_IMAP_TIMEOUT',
25
+ MAIL_TOO_LARGE: 'E_MAIL_TOO_LARGE',
26
+ NOT_RETAINED: 'E_MAIL_NOT_RETAINED',
27
+ MODEL_DISABLED: 'E_MAIL_MODEL_DISABLED',
28
+ // Reuses the existing ledger schema code: mail needs the v22 tables.
29
+ SCHEMA_STALE: 'E_SCHEMA_STALE',
30
+ })
31
+
32
+ const KNOWN = new Set(Object.values(MAIL_ERROR_CODES))
33
+
34
+ /** A business error with a stable code (message keeps the code for stderr). */
35
+ export function mailError(code, message, hint) {
36
+ if (!KNOWN.has(code)) throw new TypeError('unknown mail error code: ' + String(code))
37
+ const error = new Error(code + ': ' + message + (hint ? ' (hint: ' + hint + ')' : ''))
38
+ error.code = code
39
+ if (hint) error.hint = hint
40
+ return error
41
+ }
42
+
43
+ /** True when `error` is one of this feature's coded errors. */
44
+ export function isMailError(error) {
45
+ return Boolean(error && typeof error === 'object' && KNOWN.has(error.code))
46
+ }
@@ -0,0 +1,351 @@
1
+ /**
2
+ * Local-first commitment extraction for the 0.4.0 mail entry.
3
+ *
4
+ * DEFAULT PATH (`extractLocalCandidates`) is fully offline/deterministic:
5
+ * sentence split -> commitment trigger patterns (zh/en) -> verbatim quote
6
+ * -> due date via lib/relative-date.js (Asia/Shanghai) -> amount/currency
7
+ * -> client/project HINTS (never automatic binding) -> memory_candidates
8
+ * compatible payload (kind 'commitment').
9
+ *
10
+ * The model path (`extractCandidatesWithModel`) is OPT-IN and never called by
11
+ * mailSync or by the default `mailExtract` flow. It requires an explicit
12
+ * ADVISERS_API_KEY, wraps the body with lib/untrusted.js, clips it to 8 KiB,
13
+ * sends no attachment/header bytes and reuses the audited capture pipeline
14
+ * (safety classify + verbatim quote validation). Candidates stay pending;
15
+ * nothing is auto-accepted.
16
+ *
17
+ * Known limits (documented, not bugs): request/polite sentences are not
18
+ * promises; meeting reschedules are a known false-positive class; the rules
19
+ * are calibrated for typical Chinese/English business mail and every
20
+ * candidate is reviewed by a human before it reaches the ledger.
21
+ */
22
+ import { normalizeDue } from './relative-date.js'
23
+ import { mailError, MAIL_ERROR_CODES } from './mail-errors.js'
24
+
25
+ export const LOCAL_MAX_CANDIDATES = 5
26
+ export const MODEL_MAX_INPUT_CHARS = 8000
27
+ export const MAX_QUOTE_CHARS = 500
28
+ export const MAX_ACTION_CHARS = 40
29
+
30
+ const ACTION_VERBS = [
31
+ '发送', '发', '提交', '交付', '回复', '确认', '提供', '安排', '完成', '给出',
32
+ '上线', '付款', '打款', '支付', '签署', '签', '寄', '送', '对接', '处理',
33
+ '反馈', '准备', '整理', '跟进', '汇报', '报价', '回访', '续约',
34
+ ]
35
+ const EN_ACTION_VERBS = ['send', 'submit', 'deliver', 'reply', 'confirm', 'provide', 'finish', 'complete', 'pay', 'share', 'prepare', 'upload', 'review', 'fix', 'quote']
36
+ // A request is only a request when the sentence STARTS with one: a promise
37
+ // sentence may legitimately mention "please" later ("I will send it, please review").
38
+ const REQUEST_RE = /^(?:请|麻烦|烦请|劳驾|能否|可否|能不能|可以(?:帮我|帮忙)?|帮忙|劳烦)|^\s*(?:could|can|would|please)\b/i
39
+ const RESCHEDULE_RE = /(?:改期|改到|改在|推迟|延后|另行通知|时间改|推到|挪到|顺延)/
40
+ const TENTATIVE_RE = /(?:尽量|争取|应该|大概|可能|回头|到时候|看看|有空)/
41
+ const STRONG_RE = /(?:一定|保证|承诺|答应|务必|准时|肯定)/
42
+ const FIRST_PERSON_RE = /(?:我|我们|本人|咱们)/
43
+ const THIRD_PERSON_RE = /(?:他|她|他们|她们|对方|客户|乙方|供应商|厂家|甲方)/
44
+
45
+ function splitSentences(text) {
46
+ return String(text == null ? '' : text)
47
+ .replace(/\r\n/g, '\n').replace(/\r/g, '\n')
48
+ // Chinese/ASCII sentence punctuation plus an ASCII full stop followed by
49
+ // a capitalised new sentence (keeps 3.5 / U.S. intact).
50
+ .split(/[\n。!?!?;;]+|\.\s+(?=[A-Z])/u)
51
+ .map((sentence) => sentence.trim())
52
+ .filter(Boolean)
53
+ }
54
+
55
+ function compact(text) {
56
+ return String(text == null ? '' : text).replace(/\s+/g, '')
57
+ }
58
+
59
+ function capAction(value) {
60
+ const text = String(value == null ? '' : value).replace(/[\u0000-\u001f\u007f]+/g, ' ').replace(/\s+/g, ' ').trim()
61
+ return text ? text.slice(0, MAX_ACTION_CHARS) : undefined
62
+ }
63
+
64
+ function actionOf(sentence) {
65
+ const carry = /(?:把|将)([^。!?!?\n,,::]{1,16}?)(发送|发|提交|交付|回复|确认|提供|安排|完成|给出|上线|付款|打款|支付|签署|寄|送|对接|处理|反馈|报价)/.exec(sentence)
66
+ if (carry) return capAction(carry[2] + carry[1])
67
+ let first = null
68
+ for (const verb of ACTION_VERBS) {
69
+ const index = sentence.indexOf(verb)
70
+ if (index === -1) continue
71
+ if (!first || index < first.index) first = { index, verb }
72
+ }
73
+ if (first) {
74
+ const after = sentence.slice(first.index + first.verb.length).replace(/^[\s,,::]*(?:给|到|至|你|您|他|她|他们|客户|对方)?/, '').slice(0, 12)
75
+ return capAction(first.verb + after)
76
+ }
77
+ const english = /\b(?:will|'ll|promise to|going to|shall)\s+([a-z]+(?:\s+[a-z]+){0,4})/i.exec(sentence)
78
+ if (english) {
79
+ const words = english[1].split(/\s+/).slice(0, 5).join(' ')
80
+ return capAction(words.replace(/\b(the|a|an)\b\s*/gi, ''))
81
+ }
82
+ for (const verb of EN_ACTION_VERBS) {
83
+ const match = new RegExp('\\b' + verb + '\\b([^.!?\\n]{0,30})', 'i').exec(sentence)
84
+ if (match) return capAction((verb + match[1]).replace(/\s+/g, ' ').trim().slice(0, MAX_ACTION_CHARS))
85
+ }
86
+ return undefined
87
+ }
88
+
89
+ function toMinor(numberText, unit) {
90
+ const clean = String(numberText).replace(/,/g, '')
91
+ const [integerPart, fractionRaw = ''] = clean.split('.')
92
+ if (!/^\d+$/.test(integerPart)) return null
93
+ const fraction = (fractionRaw + '00').slice(0, 2)
94
+ let minor = BigInt(integerPart) * 100n + BigInt(fraction)
95
+ if (unit === '万') minor *= 10000n
96
+ else if (unit === '千') minor *= 1000n
97
+ if (minor <= 0n || minor > 100_000_000_000_000n) return null
98
+ return Number(minor)
99
+ }
100
+
101
+ /** Extract one explicit money amount from text: { amountMinor, currency } or null. */
102
+ export function extractMailAmount(text) {
103
+ const source = String(text == null ? '' : text)
104
+ let match = /(?:¥|¥|RMB|CNY|人民币)\s*([0-9][0-9,]*(?:\.[0-9]{1,2})?)\s*(万|千)?/i.exec(source)
105
+ if (match) {
106
+ const minor = toMinor(match[1], match[2] === '万' ? '万' : match[2] === '千' ? '千' : null)
107
+ if (minor) return { amountMinor: minor, currency: 'CNY' }
108
+ }
109
+ match = /([0-9][0-9,]*(?:\.[0-9]{1,2})?)\s*(万元|万|千元|元|块(?:钱)?)/.exec(source)
110
+ if (match) {
111
+ const unit = match[2].startsWith('万') ? '万' : match[2].startsWith('千') ? '千' : null
112
+ const minor = toMinor(match[1], unit)
113
+ if (minor) return { amountMinor: minor, currency: 'CNY' }
114
+ }
115
+ match = /(?:USD|US\$|\$)\s*([0-9][0-9,]*(?:\.[0-9]{1,2})?)/i.exec(source)
116
+ if (match) {
117
+ const minor = toMinor(match[1], null)
118
+ if (minor) return { amountMinor: minor, currency: 'USD' }
119
+ }
120
+ match = /([0-9][0-9,]*(?:\.[0-9]{1,2})?)\s*(?:美元|美金)/.exec(source)
121
+ if (match) {
122
+ const minor = toMinor(match[1], null)
123
+ if (minor) return { amountMinor: minor, currency: 'USD' }
124
+ }
125
+ return null
126
+ }
127
+
128
+ function normalizeKey(value) {
129
+ return String(value == null ? '' : value)
130
+ .normalize('NFKC')
131
+ .replace(/[\u200B-\u200D\u2060\uFEFF]/g, '')
132
+ .toLowerCase()
133
+ .replace(/\s+/g, ' ')
134
+ .trim()
135
+ }
136
+
137
+ /** Parse a From header into display name / address / domain. */
138
+ export function parseFromAddress(from) {
139
+ const text = String(from == null ? '' : from).trim()
140
+ const bracketed = /<([^<>\s]+@[^<>\s]+)>/.exec(text)
141
+ const emailMatch = bracketed || /([^\s<>]+@[^\s<>]+)/.exec(text)
142
+ const email = emailMatch ? emailMatch[1].trim() : ''
143
+ let display = ''
144
+ if (bracketed) display = text.slice(0, bracketed.index).replace(/["']/g, '').trim()
145
+ else if (!email) display = text
146
+ const domain = email.includes('@') ? email.split('@').pop().toLowerCase().replace(/[>),;]+$/, '') : ''
147
+ const local = email.includes('@') ? email.split('@')[0].toLowerCase() : ''
148
+ return { display, email, domain, local }
149
+ }
150
+
151
+ /**
152
+ * Client/project HINTS from the From header, subject and body.
153
+ * NEVER writes a binding: docs/CLIENTS.md forbids automatic customer
154
+ * identification, so the candidate only carries a suggestion.
155
+ */
156
+ export function matchMailHints({ from = '', subject = '', text = '' } = {}, { clients = [], projects = [] } = {}) {
157
+ const parsed = parseFromAddress(from)
158
+ const haystack = compact(normalizeKey([parsed.display, subject, text].filter(Boolean).join(' ')))
159
+ const domain = parsed.domain.replace(/\s+/g, '')
160
+ let clientHint
161
+ // Pass 1: address domain / exact From display name (stronger than a substring
162
+ // in the body). Pass 2: name or alias mentioned in From/subject/body.
163
+ for (const client of Array.isArray(clients) ? clients : []) {
164
+ if (!client || typeof client !== 'object' || !client.id) continue
165
+ const names = [client.name, ...(Array.isArray(client.aliases) ? client.aliases : [])].filter(Boolean)
166
+ for (const name of names) {
167
+ const key = normalizeKey(name)
168
+ const keyCompact = key.replace(/[^a-z0-9\u4e00-\u9fff]/g, '')
169
+ if (keyCompact.length >= 3 && domain.includes(keyCompact)) {
170
+ clientHint = { id: client.id, name: client.name, basis: 'address-domain', confidence: 0.75 }
171
+ break
172
+ }
173
+ if (parsed.display && compact(normalizeKey(parsed.display)) === compact(normalizeKey(client.name))) {
174
+ clientHint = { id: client.id, name: client.name, basis: 'from-name', confidence: 0.8 }
175
+ break
176
+ }
177
+ }
178
+ if (clientHint) break
179
+ }
180
+ if (!clientHint) {
181
+ for (const client of Array.isArray(clients) ? clients : []) {
182
+ if (!client || typeof client !== 'object' || !client.id) continue
183
+ const names = [client.name, ...(Array.isArray(client.aliases) ? client.aliases : [])].filter(Boolean)
184
+ for (const name of names) {
185
+ const keyCompact = normalizeKey(name).replace(/[^a-z0-9\u4e00-\u9fff]/g, '')
186
+ if (!keyCompact) continue
187
+ const latin = /^[a-z0-9]+$/.test(keyCompact)
188
+ if (haystack.includes(keyCompact) && (!latin || keyCompact.length >= 3)) {
189
+ clientHint = { id: client.id, name: client.name, basis: 'message', confidence: 0.6 }
190
+ break
191
+ }
192
+ }
193
+ if (clientHint) break
194
+ }
195
+ }
196
+ let projectHint
197
+ const projectHaystack = compact(normalizeKey([subject, text].filter(Boolean).join(' ')))
198
+ for (const project of Array.isArray(projects) ? projects : []) {
199
+ if (!project || typeof project !== 'object' || !project.id) continue
200
+ const key = normalizeKey(project.name).replace(/[^a-z0-9\u4e00-\u9fff]/g, '')
201
+ if (key.length < 2 || !projectHaystack.includes(key)) continue
202
+ projectHint = { id: project.id, name: project.name, ...(project.clientId ? { clientId: project.clientId } : {}), basis: 'message', confidence: 0.6 }
203
+ break
204
+ }
205
+ return { clientHint, projectHint }
206
+ }
207
+
208
+ function exceedsQuote(quote) {
209
+ return String(quote).length > MAX_QUOTE_CHARS
210
+ }
211
+
212
+ function analyzeSentence(sentence, { messageDate, hints, parsedFrom, receivedAt }) {
213
+ const source = String(sentence)
214
+ if (REQUEST_RE.test(source) && !FIRST_PERSON_RE.test(source)) return null
215
+ const strong = STRONG_RE.test(source)
216
+ if (RESCHEDULE_RE.test(source) && !strong) return null
217
+ let debtor = null
218
+ if (/(?:我|我们|本人)(?:会|将|一定|保证|承诺|答应|争取|尽量)/.test(source)) debtor = 'user'
219
+ if (debtor == null && /(?:我|我们|本人)[^。!?!?\n]{0,60}(?:前|之前|以前|内|截止)/.test(source) && ACTION_VERBS.some((verb) => source.includes(verb))) debtor = 'user'
220
+ if (debtor == null && /(?:我|我们|本人)(?:明天|后天|今天|本周|这周|下周|下个月|月底|下周一|周[一二三四五六日天]|[0-9]{1,2}月[0-9]{1,2}[日号]|[0-9]{1,2}号)/.test(source) && ACTION_VERBS.some((verb) => source.includes(verb))) debtor = 'user'
221
+ if (debtor == null && /\b(?:i|we)\b[^.!?\n]{0,40}\b(?:will|'ll|shall|promise to|am going to|are going to)\b/i.test(source)) debtor = 'user'
222
+ if (debtor == null && /\b(?:i|we)\b[^.!?\n]{0,60}\b(?:by|before|no later than)\b/i.test(source) && /\b(?:send|submit|deliver|reply|confirm|provide|finish|complete|pay|share|prepare|upload|review|fix)\b/i.test(source)) debtor = 'user'
223
+ if (debtor == null && THIRD_PERSON_RE.test(source) && /(?:会|将|答应|承诺|同意|保证)/.test(source)) debtor = 'third'
224
+ if (debtor == null && /\b(?:he|she|they|the client|the vendor|the supplier)\b[^.!?\n]{0,30}\b(?:will|promised to|agreed to)\b/i.test(source)) debtor = 'third'
225
+ if (debtor == null) return null
226
+ const quote = source.trim()
227
+ if (!quote || exceedsQuote(quote)) return null
228
+ const action = actionOf(source)
229
+ if (!action) return null
230
+ const due = normalizeDue({ quote, text: source, messageDate })
231
+ const money = extractMailAmount(source)
232
+ const uncertain = TENTATIVE_RE.test(source)
233
+ const confidence = strong ? 0.85 : uncertain ? 0.55 : 0.7
234
+ const uncertaintyParts = []
235
+ if (due.ambiguous) uncertaintyParts.push('相对日期有歧义,已按消息时间解析')
236
+ if (uncertain) uncertaintyParts.push('语气为“尽量/争取”,不保证完成')
237
+ if (!due.dueAt) uncertaintyParts.push('未识别到明确日期')
238
+ return {
239
+ action,
240
+ debtor,
241
+ creditor: debtor === 'third' ? (hints.thirdPartyName ?? parsedFrom.display ?? undefined) : (parsedFrom.display || undefined),
242
+ ...(due.dueAt ? { dueAt: due.dueAt, dueBasis: due.basis } : {}),
243
+ ...(due.ambiguous ? { dueAmbiguous: true } : {}),
244
+ ...(money ? { amountMinor: money.amountMinor, currency: money.currency } : {}),
245
+ quote,
246
+ modal: strong ? 'firm' : uncertain ? 'tentative' : 'firm',
247
+ confidence,
248
+ uncertainty: uncertaintyParts.join(';').slice(0, 160),
249
+ extractor: 'local',
250
+ receivedAt: receivedAt ?? undefined,
251
+ }
252
+ }
253
+
254
+ /**
255
+ * Deterministic offline extraction for one message.
256
+ * @returns {{ candidates: object[], hints: {clientHint?, projectHint?} }}
257
+ */
258
+ export function extractLocalCandidates({
259
+ text = '', subject = '', from = '', receivedAt, clients = [], projects = [], now,
260
+ } = {}) {
261
+ const parsedFrom = parseFromAddress(from)
262
+ const hints = matchMailHints({ from, subject, text }, { clients, projects })
263
+ const messageDate = receivedAt ? new Date(receivedAt) : now instanceof Date ? now : new Date(now ?? Date.now())
264
+ const anchor = Number.isFinite(messageDate.getTime()) ? messageDate : new Date()
265
+ const normalizedQuote = compact(text)
266
+ const candidates = []
267
+ for (const sentence of splitSentences(text)) {
268
+ if (candidates.length >= LOCAL_MAX_CANDIDATES) break
269
+ const candidate = analyzeSentence(sentence, { messageDate: anchor, hints, parsedFrom, receivedAt: anchor.toISOString() })
270
+ if (!candidate) continue
271
+ if (!normalizedQuote.includes(compact(candidate.quote))) continue
272
+ const duplicate = candidates.some((row) => row.quote === candidate.quote)
273
+ if (duplicate) continue
274
+ candidates.push({ ...candidate, ...(hints.clientHint ? { clientHint: hints.clientHint } : {}), ...(hints.projectHint ? { projectHint: hints.projectHint } : {}) })
275
+ }
276
+ return { candidates, hints }
277
+ }
278
+
279
+ /**
280
+ * Build the source-ref object stored on a mail candidate's evidence.
281
+ * IMAP rows use `imap:<account>:<uidvalidity>:<uid>`; .eml rows use
282
+ * `eml:<account>:<messageRowId>`. Quote-only evidence; never the body.
283
+ */
284
+ export function mailEvidenceSource(message, { now } = {}) {
285
+ const accountId = message?.accountId ?? 'unknown'
286
+ const localRow = message?.uidvalidity === 'local' || message?.mailbox === 'local'
287
+ const ref = message?.uid != null && !localRow
288
+ ? 'imap:' + accountId + ':' + (message.uidvalidity ?? 'unknown') + ':' + message.uid
289
+ : 'eml:' + accountId + ':' + (message.id ?? 'unknown')
290
+ const capturedAt = message?.receivedAt ?? (now instanceof Date ? now.toISOString() : new Date().toISOString())
291
+ return {
292
+ type: 'mail',
293
+ ref,
294
+ ...(message?.messageId ? { messageId: message.messageId } : {}),
295
+ ...(message?.subject ? { subject: String(message.subject).slice(0, 200) } : {}),
296
+ capturedAt,
297
+ }
298
+ }
299
+
300
+ /**
301
+ * Map one extractor candidate to the memory_candidates shape reused by
302
+ * `advisers memory accept` (kind 'commitment', payload + evidence).
303
+ */
304
+ export function toMemoryCandidate(candidate, { message, matterId, now } = {}) {
305
+ const payload = {
306
+ ...(matterId ? { matterId } : {}),
307
+ debtor: candidate.debtor === 'third' ? 'third' : 'user',
308
+ creditor: candidate.creditor || 'someone',
309
+ action: candidate.action,
310
+ ...(candidate.dueAt ? { dueAt: candidate.dueAt } : {}),
311
+ capability: 'none',
312
+ extractor: candidate.extractor ?? 'local',
313
+ ...(candidate.amountMinor ? { amountMinor: candidate.amountMinor, currency: candidate.currency ?? 'CNY' } : {}),
314
+ ...(candidate.clientHint ? { clientHint: candidate.clientHint } : {}),
315
+ ...(candidate.projectHint ? { projectHint: candidate.projectHint } : {}),
316
+ }
317
+ return { kind: 'commitment', payload, evidence: [{ quote: candidate.quote, source: mailEvidenceSource(message, { now }) }] }
318
+ }
319
+
320
+ /**
321
+ * OPT-IN model extraction. Never called by mailSync or by the local default.
322
+ * Requires an API key and reuses lib/capture.js (safety classify + verbatim
323
+ * quote validation) with the body inside the untrusted-data boundary.
324
+ */
325
+ export async function extractCandidatesWithModel({
326
+ text = '', subject = '', from = '', receivedAt, apiKey, baseUrl, model, fetchImpl, safetyKey,
327
+ maxChars = MODEL_MAX_INPUT_CHARS, now,
328
+ } = {}) {
329
+ if (!apiKey) {
330
+ throw mailError(MAIL_ERROR_CODES.MODEL_DISABLED, 'mail extract --model requires ADVISERS_API_KEY', 'model extraction is opt-in; the default --local path never calls a model')
331
+ }
332
+ const body = String(text == null ? '' : text).slice(0, Math.max(1, Number(maxChars) || MODEL_MAX_INPUT_CHARS))
333
+ if (!body.trim()) return { candidates: [], safetyWarnings: [] }
334
+ const [{ wrapUntrusted }, { captureCandidates }] = await Promise.all([import('./untrusted.js'), import('./capture.js')])
335
+ const wrapped = wrapUntrusted('mail:message', body)
336
+ let messageDate = receivedAt ? new Date(receivedAt) : now ? new Date(now) : new Date()
337
+ if (!Number.isFinite(messageDate.getTime())) messageDate = new Date()
338
+ const result = await captureCandidates({
339
+ text: wrapped, apiKey, baseUrl, model, fetchImpl,
340
+ date: messageDate, source: 'email', now: messageDate, safetyKey,
341
+ })
342
+ const candidates = (Array.isArray(result.candidates) ? result.candidates : []).map((candidate) => ({
343
+ ...candidate,
344
+ extractor: 'model',
345
+ receivedAt: messageDate.toISOString(),
346
+ }))
347
+ return {
348
+ candidates,
349
+ ...(Array.isArray(result.safetyWarnings) && result.safetyWarnings.length ? { safetyWarnings: result.safetyWarnings } : {}),
350
+ }
351
+ }