@restregular/dsh-memory 0.9.5 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -111,11 +111,23 @@ memory_save({
111
111
  - **服务**:「向量服务」:状态、地址、启停开关、**模型与硬件**(见下)、维护(卸载向量服务 / 清空记忆数据,两步确认)
112
112
  - **记录**(默认打开):顶部统计(记忆数 / 作用域数 / 待嵌入向量数)、搜索、按作用域筛选、**新建**(任意作用域 + 类型,类型里含 `rule`)、展开编辑 / 删除;列表放在独立的滚动容器里(记忆再多也不把面板撑长),滚动条是自定义的细圆头样式,从侧栏入口打开时容器还会跟着窗口长高;作用域下拉**动态枚举实际存在的作用域**(`global` 显示「全局」、project 显示 cwd、会话 scope 显示会话标题、自定义 scope 显示原名)
113
113
  - **记忆树**:所有作用域的记忆按 **作用域 → 类型 → 记录** 三层展开,根节点显示总数;记录卡按类型着色,`supersedes` / `supersededBy` 用金色虚线把「修正版」和「被修正的旧版」连起来。支持搜索(命中高亮、其余淡出)、按类型逐个开关、按作用域筛选、折叠作用域 / 类型、缩放与「适应」、以及点击记录打开的详情抽屉(全文、标签、重要度、时间、id 与双向修正链)。修正是**关系**而不是层级,所以不改变树结构,只叠在右侧;悬停或选中一条记录时,整条修正链一起点亮
114
- - **设置**:注入链路逐项开关 —— 每轮召回(topK / 预算)、印象形态(每条字数)、会话摘要(条数 / 预算)、记忆使用策略段、硬性规则段(条数 / 预算 / 变更提醒,并显示当前规则条数)、轮末提醒、侧栏入口;底部「数据」:导出全部 / 导入文件。改完**即保存**,不需要点按钮
114
+ - **设置**:注入链路逐项开关 —— 每轮召回(topK / 预算)、印象形态(每条字数)、会话摘要(条数 / 正文预算 / 截断标签预算 / 标签条数)、记忆使用策略段、硬性规则段(条数 / 预算 / 变更提醒,并显示当前规则条数)、轮末提醒、侧栏入口;底部「数据」:导出全部 / 导入文件。改完**即保存**,不需要点按钮
115
115
 
116
116
  > **导入 / 导出**:导出的是纯文本 —— 作用域、类型、内容、标签、重要度、时间戳,**没有向量**。导入时逐条走保存路径,按**当前模型重新嵌入**,并按「作用域 + 内容」去重(重复的计入「跳过」)。一次最多 5000 条。
117
117
 
118
- 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`POST /create`、`POST /update`、`POST /delete`、`GET /settings`、`POST /settings`、`GET /export`、`POST /import`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
118
+ 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`GET /settings`、`POST /settings`、`GET /audit`、`POST /create`、`POST /update`、`POST /delete`、`GET /export`、`POST /import`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
119
+
120
+ ## 注入可靠性(0.9.6)
121
+
122
+ 摘要和规则不再静默截断:
123
+
124
+ - **正文预算**:`digest.tokenBudget` 默认从 400 提到 800;`topK` 与预算仍是两个独立上限。
125
+ - **截断标签**:正文因 `topK` / 预算没注入时,附一条独立的「相关记忆索引」——每条只给 8 位 id、标签/主题、类型、作用域,以及 `memory_search` 检索指引;标签有 `digest.hintBudget` / `digest.hintMaxItems` 独立预算。标签也溢出时报告省略数量与原因。
126
+ - **退役规则**:被 `supersedes` 指向的旧记录不再进入摘要、规则段和自动召回;`memory_search` / `memory_get` 仍可查历史。
127
+ - **mandatory / pinned**:规则标签里写 `mandatory` / `pinned`(或 `必含` / `强制`)的条目排在规则段最前;超预算时输出明确警告,不静默丢弃。
128
+ - **行为感知召回**:监听 `session/event` 的 `tool/call` / `tool/result` / compaction。命中 `npm publish`、`git push`、部署等高风险操作,或工具失败(凭据/权限/超时/abort 分类)后,在下一个 `agent/pre-step` 用任务查询做一次增量召回;已注入正文按 **sessionId + 记忆 id/版本** 去重,只给过标签的会补正文,内容更新会重新评估。
129
+ - **审计**:每次摘要/召回/规则评估写入内存审计环,`GET /memory/api/audit?session=<id>` 可查候选、正文、标签、去重、省略原因与各通道预算;不记录凭据或令牌。
130
+ - **限制**:当前行为召回基于 `session/event` 的 `tool/call` / `tool/result`,召回发生在**下一个** `agent/pre-step`;宿主虽有 `tools/pre-execute`,本插件没有用它做操作前阻断,因此"发布/推送前强制检查"仍是告警 + 召回,不是硬阻断。工具失败若底层只返回 aborted,审计会保留 `ABORTED_UNKNOWN`,不会臆测成凭据问题。
119
131
 
120
132
  ## 数据与文件布局
121
133
 
@@ -331,6 +343,15 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
331
343
 
332
344
  ## 版本
333
345
 
346
+ - **0.9.6** —— 注入可靠性改造:
347
+ - 摘要默认正文预算 400 → 800;旧版 `settings.json` 里仍是 400 且没有 `hintBudget` 的配置会在加载时迁移到 800,显式带 `hintBudget` 的配置不动。新增候选/正文/`top_k`/预算/退役/过期互斥统计,任何截断都有原因。
348
+ - 被截断记录生成独立标签索引(id + 标签/主题 + 类型 + 作用域),标签有独立预算与条数上限;mandatory/pinned 与发布/部署/凭据类标签优先保留。
349
+ - `supersedes` 旧记录统一从摘要、规则段、自动召回中退役;`memory_search` / `memory_get` 仍保留历史。
350
+ - 规则段支持 `mandatory` / `pinned` 标签,超出预算时输出警告;规则溢出不再静默。
351
+ - 按会话 + 记忆 id/版本去重,区分 `hint_injected` 与 `content_injected`;只给过标签的记忆可在任务命中后补正文,内容更新会重新评估;compaction 后重置摘要与去重状态。
352
+ - 监听 `session/event` 的 `tool/call` / `tool/result`,对 `npm publish`、`git push`、部署和工具失败做定向增量召回;失败按 `MISSING_CREDENTIAL` / `PERMISSION_DENIED` / `TIMEOUT` / `ABORTED_UNKNOWN` 分类。
353
+ - 新增内存审计环与 `GET /memory/api/audit`;记录触发原因、阶段、候选、正文、标签、去重、省略原因和各通道预算,不记录凭据。
354
+ - 测试新增摘要截断/标签索引/退役/mandatory/会话级状态/审计/行为信号,以及一次完整的「摘要标签 → 高风险工具 → 正文召回 → 工具失败诊断」链路。
334
355
  - **0.9.5** —— 新增「记忆树」标签页:
335
356
  - 所有作用域的记忆按 **作用域 → 类型 → 记录** 分层展示,根节点是总数;记录卡按类型着色(事实 / 决策 / 偏好 / 流程 / 笔记 / 规则),修正/被修正各有徽标。
336
357
  - `supersedes` 是点对点关系、不是层级,所以不改树结构:金色虚线从修正版弯到旧版的右缘,悬停或选中任意一端时,两端与整条修正链一起点亮;关闭「修正连线」可只看结构。
package/lib/client.js CHANGED
@@ -1547,11 +1547,13 @@ window.__ModuleLoader__.load({
1547
1547
  },
1548
1548
  {
1549
1549
  key: 'digest', title: '会话摘要',
1550
- desc: '会话第一步给一次项目 / 全局的记忆概览。',
1550
+ desc: '会话第一步给一次项目 / 全局的记忆概览;正文被截断时附一条标签索引。',
1551
1551
  fields: [
1552
1552
  { k: 'enabled', label: '启用', type: 'bool' },
1553
1553
  { k: 'topK', label: '最多条数', type: 'num', min: 1, max: 30, step: 1 },
1554
1554
  { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
1555
+ { k: 'hintBudget', label: '标签预算', type: 'num', min: 30, max: 1000, step: 10 },
1556
+ { k: 'hintMaxItems', label: '标签条数', type: 'num', min: 1, max: 30, step: 1 },
1555
1557
  ],
1556
1558
  },
1557
1559
  {
@@ -3,12 +3,17 @@
3
3
  *
4
4
  * 注入分四层,全部可以在面板「记忆 → 设置」里单独开关:
5
5
  * 1. recall —— 每轮按查询召回(可有可无;内容没变就不重复注入)
6
- * 2. digest —— 会话第一步给一次"已有记忆"的摘要
6
+ * 2. digest —— 会话第一步给一次"已有记忆"的摘要 + 截断标签索引
7
7
  * 3. policy —— 系统提示里的「记忆使用策略」常驻段
8
8
  * 4. rules —— 系统提示里的「硬性规则」段(kind='rule' 的记忆)
9
9
  * 另有 rulesDelta —— 旧会话在下一轮补一条新增/变更的规则(0.9.0;随 rules 开关)
10
10
  * 另有 turnEnd —— 轮末提醒(下一轮开头提示"上一轮若有结论就记一条"),默认关。
11
11
  *
12
+ * 0.9.6 起多了两条可验证的路径:
13
+ * - digest 的正文/标签/省略统计会写进 `InjectAuditStore`;
14
+ * - `session/event` 的 tool/call、tool/result、compaction 事件会生成行为信号,
15
+ * 在下一个 pre-step 做一次增量自动召回(已注入正文按会话 + 记忆 id/版本去重)。
16
+ *
12
17
  * Message construction MUST go through createUserMessage: the loop reads
13
18
  * `decision.kind` and downstream consumers read `message.source.kind`, so a
14
19
  * hand-rolled `{ role, content }` object aborts the turn with
@@ -25,6 +30,7 @@ import {
25
30
  MemoryInjector,
26
31
  hasRecallMessage,
27
32
  normalizeExtraScopes,
33
+ pickQueryText,
28
34
  resolveInjectScopes,
29
35
  sessionIdOf,
30
36
 
@@ -32,10 +38,20 @@ import {
32
38
 
33
39
 
34
40
  } from './inject.js'
35
- import { renderDigestBlock } from './digest.js'
36
- import { renderRulesBlock } from './rules.js'
41
+ import { renderDigest, } from './digest.js'
42
+ import { renderRules, renderRulesBlock } from './rules.js'
37
43
  import { RulesDeltaInjector } from './rules-delta.js'
38
44
  import { POLICY_TEXT } from './policy.js'
45
+ import { InjectionState } from './state.js'
46
+ import { InjectAuditStore, auditBudget, auditQuery, } from './audit.js'
47
+ import {
48
+ BehaviorSignalStore,
49
+ detectPhase,
50
+ failureSignal,
51
+ highRiskSignal,
52
+ toolResultFailure,
53
+
54
+ } from './signals.js'
39
55
  import { normalizeInjectSettings, } from '../provider/inject-settings.js'
40
56
 
41
57
 
@@ -49,8 +65,9 @@ import { normalizeInjectSettings, } from '../provider/inject
49
65
 
50
66
  /** provider 在注入侧能提供的那部分能力(多余的方法都用可选判断)。 */
51
67
 
52
-
68
+
53
69
 
70
+
54
71
 
55
72
 
56
73
  /** 轮末提醒的文案:短、祈使句,不占预算。 */
@@ -87,6 +104,43 @@ export function apply(ctx , config = {}) {
87
104
  const readScopesFor = (memory , agent ) =>
88
105
  resolveInjectScopes(memory, agent, extraScopes, ctx.get?.('sessions') )
89
106
 
107
+ /** 会话级注入状态(正文/标签/版本)与审计。 */
108
+ const injectionState = new InjectionState()
109
+ const audit = new InjectAuditStore()
110
+ const signals = new BehaviorSignalStore()
111
+ const callNames = new Map ()
112
+ let attachedMemory = null
113
+
114
+ const attachAudit = (memory ) => {
115
+ const target = memory
116
+ if (!target || target === attachedMemory || typeof target.attachInjectAudit !== 'function') return
117
+ try {
118
+ target.attachInjectAudit(audit)
119
+ attachedMemory = target
120
+ } catch { /* 审计是可选增强 */ }
121
+ }
122
+
123
+ const recordAudit = (entry ) => {
124
+ audit.record({ at: Date.now(), ...entry })
125
+ }
126
+
127
+ const rememberCallName = (callId , name ) => {
128
+ if (typeof callId !== 'string' || callId === '') return
129
+ callNames.set(callId, name)
130
+ if (callNames.size > 500) {
131
+ const oldest = callNames.keys().next()
132
+ if (!oldest.done) callNames.delete(oldest.value)
133
+ }
134
+ }
135
+
136
+ const excludedIds = (memory , scopes ) => {
137
+ try {
138
+ return new Set(memory.supersededIds?.(scopes === undefined ? undefined : [...scopes]) ?? [])
139
+ } catch {
140
+ return new Set()
141
+ }
142
+ }
143
+
90
144
  // One injector per activation: its repeat-suppression state must live across
91
145
  // the steps of a turn (a per-step instance would re-inject every step).
92
146
  const injector = new MemoryInjector(
@@ -102,6 +156,7 @@ export function apply(ctx , config = {}) {
102
156
  },
103
157
  recallCfg,
104
158
  impressionCfg,
159
+ injectionState,
105
160
  )
106
161
 
107
162
  // 摘要:provider 没有 list(旧版/半边加载失败)时自动退化为"不发摘要"。
@@ -117,6 +172,63 @@ export function apply(ctx , config = {}) {
117
172
  // 规则增量:一个激活一个实例,跨轮记住每条规则上一轮的样子(编辑后才补提醒)。
118
173
  const rulesDelta = new RulesDeltaInjector()
119
174
 
175
+ /**
176
+ * 可观测行为信号 → 下一次 pre-step 的定向召回。
177
+ * 只消费宿主公开的 session/event;不读取隐藏思维链,不记录工具原始参数。
178
+ */
179
+ try {
180
+ ctx.on('session/event', (session , event ) => {
181
+ try {
182
+ const sessionId = (session )?.id
183
+ if (typeof sessionId !== 'string' || sessionId === '') return
184
+ const type = (event )?.type
185
+ const data = (event )?.data ?? {}
186
+ const memory = ctx.get('memory')
187
+ if (memory) attachAudit(memory)
188
+
189
+ if (type === 'compaction/start' || type === 'compaction/end') {
190
+ // 上下文重建:旧去重状态不再可信,允许摘要/正文重新进入。
191
+ injectionState.clear(sessionId)
192
+ signals.clear(sessionId)
193
+ digester.reset(sessionId)
194
+ callNames.clear()
195
+ return
196
+ }
197
+ if (type === 'tool/call') {
198
+ const tool = typeof data.name === 'string' ? data.name : 'tool'
199
+ const args = typeof data.arguments === 'string' ? data.arguments : ''
200
+ rememberCallName(data.callId, tool)
201
+ const signal = highRiskSignal(tool, args)
202
+ if (signal && signals.note(sessionId, signal)) {
203
+ recordAudit({
204
+ sessionId, trigger: signal.reason, phase: signal.phase, query: signal.query,
205
+ candidates: 0, contentIds: [], hintIds: [], omitted: [], dedupSkipped: 0, budgets: {},
206
+ retrieval: { ok: true, count: 0 }, signal: { reason: signal.reason, tool: signal.tool },
207
+ })
208
+ }
209
+ return
210
+ }
211
+ if (type === 'tool/result') {
212
+ const failure = toolResultFailure(event)
213
+ if (!failure.isError) return
214
+ const message = data.message
215
+ const callId = message?.source?.callId
216
+ const tool = typeof callId === 'string' ? callNames.get(callId) : undefined
217
+ const signal = failureSignal(tool, failure.code, failure.message)
218
+ if (signals.note(sessionId, signal)) {
219
+ recordAudit({
220
+ sessionId, trigger: signal.reason, phase: signal.phase, query: signal.query,
221
+ candidates: 0, contentIds: [], hintIds: [], omitted: [], dedupSkipped: 0, budgets: {},
222
+ retrieval: { ok: true, count: 0 },
223
+ signal: { reason: signal.reason, ...(signal.errorClass ? { errorClass: signal.errorClass } : {}), ...(signal.tool ? { tool: signal.tool } : {}) },
224
+ })
225
+ }
226
+ return
227
+ }
228
+ } catch { /* 观察者失败绝不影响会话事件发布 */ }
229
+ })
230
+ } catch { /* 老宿主没有 session/event:行为召回自动缺席 */ }
231
+
120
232
  // 系统提示:记忆使用策略(常驻) + 硬性规则(kind='rule')。
121
233
  // 两者都用函数形式,面板开关/规则改动下一步就生效;文本稳定时可随前缀缓存。
122
234
  ctx.inject(['systemPrompt'], (scoped ) => {
@@ -167,15 +279,18 @@ export function apply(ctx , config = {}) {
167
279
  // optional capability: absence (or partial load) → pass through untouched
168
280
  const memory = ctx.get('memory')
169
281
  if (!memory) return decision
282
+ attachAudit(memory)
170
283
 
171
284
  const agent = (input ).agent
172
285
  const step = (input ).step ?? 1
173
286
  if (step === 1) maxStep = 0
174
287
  maxStep = Math.max(maxStep, step)
175
288
 
176
- // 会话上下文只在 pre-step 里拿得到:交给 search 的 `scopes`,与 memory_search 的
177
- // 默认合并集合用同一套解析(provider 的 resolveReadScopes)。
289
+ const sessionId = sessionIdOf(agent)
178
290
  const scopes = readScopesFor(memory, agent)
291
+ const exclude = excludedIds(memory, scopes)
292
+ const signal = sessionId === undefined ? undefined : signals.take(sessionId)
293
+ const userQuery = pickQueryText(input.messages )
179
294
 
180
295
  // 摘要(每个会话一次)、召回(每轮有新内容时)、轮末提醒(下一轮首步)合成
181
296
  // 同一条消息:内容没变就什么都不加,避免一步两张卡片。
@@ -194,15 +309,96 @@ export function apply(ctx , config = {}) {
194
309
  }
195
310
  if (settings) {
196
311
  if (settings.digest.enabled) {
197
- const digest = await digester.maybeDigest(sessionIdOf(agent), scopes, (records) =>
198
- renderDigestBlock(records, settings.digest)?.text ?? null)
199
- if (digest) parts.push(digest)
312
+ let digestStats
313
+ const digest = await digester.maybeDigestDetailed(sessionId, scopes, (records) => {
314
+ const rendered = renderDigest(records, settings.digest)
315
+ digestStats = rendered?.stats
316
+ return rendered
317
+ })
318
+ if (digest) {
319
+ if (sessionId !== undefined && digestStats !== undefined) {
320
+ injectionState.markContent(sessionId, digestStats.bodyEntries)
321
+ injectionState.markHint(sessionId, digestStats.hintEntries)
322
+ }
323
+ parts.push(digest.text)
324
+ if (digestStats !== undefined) {
325
+ recordAudit({
326
+ ...(sessionId !== undefined ? { sessionId } : {}),
327
+ trigger: 'turn_start', phase: 'unknown',
328
+ candidates: digestStats.candidates,
329
+ contentIds: digestStats.bodyIds,
330
+ hintIds: digestStats.hintIds,
331
+ omitted: digestStats.omitted.map((entry) => ({ id: entry.id, reason: entry.reason })),
332
+ dedupSkipped: 0,
333
+ budgets: {
334
+ digest: auditBudget(settings.digest.tokenBudget, digest.tokens),
335
+ hints: auditBudget(settings.digest.hintBudget, digestStats.hint.tokens),
336
+ },
337
+ retrieval: { ok: true, count: digestStats.candidates },
338
+ })
339
+ }
340
+ }
341
+ }
342
+
343
+ // 规则段每步都会在系统提示里重渲染;只在第一步记录一次审计,避免 200 条缓冲被刷爆。
344
+ if (step === 1 && settings.rules.enabled) {
345
+ try {
346
+ const rendered = renderRules(memory.listSync?.({ scopes, kind: 'rule', limit: 100 }) ?? [], settings.rules)
347
+ if (rendered) {
348
+ recordAudit({
349
+ ...(sessionId !== undefined ? { sessionId } : {}),
350
+ trigger: 'rules', phase: 'unknown',
351
+ candidates: rendered.stats.candidates,
352
+ contentIds: [], hintIds: [], omitted: [], dedupSkipped: 0,
353
+ budgets: { rules: auditBudget(settings.rules.tokenBudget, rendered.tokens) },
354
+ retrieval: { ok: true, count: rendered.stats.candidates },
355
+ rules: {
356
+ injected: rendered.stats.injected,
357
+ omittedTopK: rendered.stats.omittedTopK,
358
+ omittedBudget: rendered.stats.omittedBudget,
359
+ omittedSuperseded: rendered.stats.omittedSuperseded,
360
+ mandatory: rendered.stats.mandatory,
361
+ mandatoryOmitted: rendered.stats.mandatoryOmitted,
362
+ },
363
+ })
364
+ }
365
+ } catch { /* 审计不是注入的前置条件 */ }
366
+ }
367
+
368
+ // 行为信号优先:发布/推送/失败事件触发定向查询;没有信号才走普通用户消息召回。
369
+ // 同一轮普通 query 已处理过时跳过重复检索(去重状态仍会兜底)。
370
+ const skipNormalRecall = signal === undefined && step > 1 && sessionId !== undefined
371
+ && userQuery !== '' && injectionState.lastQueryOf(sessionId) === userQuery
372
+ if (!skipNormalRecall) {
373
+ const recall = await injector.maybeInjectDetailed(
374
+ { messages: input.messages , signal: input.signal, ...(scopes !== undefined ? { scopes } : {}), ...(sessionId !== undefined ? { sessionId } : {}) },
375
+ { messages: decision.messages },
376
+ {
377
+ ...(sessionId !== undefined ? { sessionId } : {}),
378
+ ...(signal !== undefined ? { query: signal.query, trigger: signal.reason, force: true } : { trigger: 'turn_start' }),
379
+ excludeIds: exclude,
380
+ },
381
+ )
382
+ if (recall?.text) parts.push(recall.text)
383
+ if (recall) {
384
+ recordAudit({
385
+ ...(sessionId !== undefined ? { sessionId } : {}),
386
+ trigger: signal?.reason ?? 'turn_start',
387
+ phase: signal?.phase ?? detectPhase(userQuery),
388
+ ...(auditQuery(recall.query) !== undefined ? { query: auditQuery(recall.query) } : {}),
389
+ candidates: recall.candidates,
390
+ contentIds: recall.ids,
391
+ hintIds: [],
392
+ omitted: recall.omitted.map((entry) => ({ id: entry.id, reason: entry.reason })),
393
+ dedupSkipped: recall.dedupSkipped,
394
+ budgets: { recall: auditBudget(settings.recall.tokenBudget, recall.tokens) },
395
+ retrieval: recall.retrieval,
396
+ ...(signal !== undefined
397
+ ? { signal: { reason: signal.reason, ...(signal.errorClass ? { errorClass: signal.errorClass } : {}), ...(signal.tool ? { tool: signal.tool } : {}) } }
398
+ : {}),
399
+ })
400
+ }
200
401
  }
201
- const recall = await injector.maybeInject(
202
- { messages: input.messages , signal: input.signal, ...(scopes !== undefined ? { scopes } : {}) },
203
- { messages: decision.messages },
204
- )
205
- if (recall) parts.push(recall)
206
402
  }
207
403
 
208
404
  const text = parts.join('\n\n')
@@ -233,4 +429,5 @@ function isWellFormedMessage(message ) {
233
429
  return typeof source?.kind === 'string'
234
430
  }
235
431
 
432
+
236
433
  //# sourceURL=source/memory-inject/src/apply.ts
@@ -0,0 +1,87 @@
1
+ /**
2
+ * 注入审计:每次摘要/召回评估都留一条结构化记录。
3
+ *
4
+ * 第一版不要求复杂 UI:记录放在内存环形缓冲里,provider 通过
5
+ * `attachInjectAudit()` 挂上,面板 `GET /memory/api/audit?session=` 读取。
6
+ * 不记录任何凭据/令牌;检索查询会先过凭据脱敏,再最多截到 200 字。
7
+ */
8
+
9
+ import { redactSecrets } from '../provider/secrets.js'
10
+
11
+
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+
22
+
23
+
24
+
25
+
26
+
27
+
28
+
29
+                     
30
+
31
+
32
+
33
+
34
+
35
+
36
+
37
+
38
+
39
+         
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+                          
49
+
50
+
51
+
52
+
53
+ const MAX_ENTRIES = 200
54
+
55
+ export class InjectAuditStore {
56
+ entries = []
57
+
58
+ record(entry ) {
59
+ this.entries.push(entry)
60
+ if (this.entries.length > MAX_ENTRIES) this.entries.splice(0, this.entries.length - MAX_ENTRIES)
61
+ }
62
+
63
+ /** 最新在前;可按会话过滤。 */
64
+ list(sessionId ) {
65
+ const list = sessionId === undefined
66
+ ? this.entries
67
+ : this.entries.filter((entry) => entry.sessionId === sessionId)
68
+ return [...list].reverse()
69
+ }
70
+
71
+ clear() {
72
+ this.entries = []
73
+ }
74
+ }
75
+
76
+ /** 查询文本里可能带用户内容:截断并折叠空白,不写凭据。 */
77
+ export function auditQuery(text ) {
78
+ if (typeof text !== 'string' || text.trim() === '') return undefined
79
+ return redactSecrets(text).replace(/\s+/g, ' ').trim().slice(0, 200)
80
+ }
81
+
82
+ export function auditBudget(budget , used ) {
83
+ return { budget, used, remaining: Math.max(0, budget - used) }
84
+ }
85
+
86
+
87
+ //# sourceURL=source/memory-inject/src/audit.ts