@restregular/dsh-memory 0.23.1 → 0.24.1

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/CHANGELOG.md CHANGED
@@ -2,6 +2,31 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.24.1 — 修复 memory_scopes 注册失败导致 memory_get 一起消失
6
+
7
+ - **现象**:升级到 0.24.0 后,模型侧看不到 `memory_scopes`,连原本正常的 `memory_get` 也变成 `unknown tool`;`memory_search` / `memory_list` / `memory_save` / `memory_forget` 仍在。
8
+ - **根因**:`memory_scopes` 的 `requests` 参数用了嵌套对象 schema。DSH `defineTool` 的 authoring DSL 要求对象类型必须显式写 `additionalProperties`(嵌套对象的 `required` 也不在允许关键字里),注册期抛错 → 整个 tool-memory apply 中断,排在 `memory_scopes` 后面的 `memory_get` 没有注册。
9
+ - **修复**:`action="request"` 改为扁平参数 `scopes: string[]` + `permissions: ["read"|"write"][]`(作用于本次所有 scopes),不再使用 `object` / `properties` 参数;provider 的内部请求结构不变。
10
+ - **回归守卫**:新增测试,禁止任何 `memory_*` 工具参数出现 `type:"object"` / `properties`,避免同类 schema 再次把后续工具注册带崩。
11
+ - 验证:484 tests / 483 pass / 1 skipped;`npm run verify` BUILD OK。
12
+
13
+ ## 0.24.0 — 作用域目录与用途元数据;自定义作用域原子初始化
14
+
15
+ - **作用域元数据(`<storeDir>/scope-meta/<sha1(scope)>.json`)**:每个作用域可以带一句话用途,独立于记忆记录——删光记录、记录被 supersede / 过期都不会丢。旧作用域没有元数据时按「未填写用途」处理,不做迁移、不要求补齐。项目别名仍以 `scopes.json` 为准。
16
+ - **自定义作用域创建(Agent 路径)必须说明用途**:`memory_save` 新增可选 `scopeDescription` / `scopeRule`。Agent 首次写入一个不存在的自定义作用域时缺 `scopeDescription` → `SCOPE_DESCRIPTION_REQUIRED`;提供后在同一次调用里原子完成:元数据先写 `pending`、写入初始事实(带 `initial: true`)、可选写一条初始规则(`kind: rule`,也带 `initial`)、最后转 `ready`。中途失败保留 `pending`,下次保存继续完成。面板 / 导入等没有 agent 上下文的路径不受强制。
17
+ - **新工具 `memory_scopes`(本版仅 `action="list"`)**:返回作用域名字 / 用途 / 来源 / 当前可读可写状态;范围外条目不返回记录数、不返回任何正文。`includeOutOfScope: false` 只看范围内,`limit` 默认 50。
18
+ - **统一授权判定(D2)**:新增纯函数 `authorize(request, context)`(`source/memory-local/src/authorize.ts`),`discover / read / write / delete` 共用一套规则;provider 的 `visibilityFilterFor`、`isRecordVisible`、`isScopeReadable`、`isScopeWritable`、`assertOperable` 与目录工具全部改为走它,工具层通过 `accessEvaluator(agent)` 一次解析、逐条判定,不再自己解释 `absolute / normal / none`。工具层只在 `requestable=true` 时发起审批;`absolute`、显式 `read:false` / `write:false`、作用域类型关闭都不产生审批卡,并给模型真实原因(新增 `withheld.reason='scope-disabled'`)。
19
+ - **会话授权 + 主动申请(D3)**:
20
+ - 新增独立存储 `grants/<session>.json`(每个会话一个文件、原子写),与 `visibility/<session>.json` 的策略分开:只读 / 可写独立、可撤销、带 `scopeGeneration`(作用域删除重建后旧授权自动失效)、子 Agent 沿 `parentSession` 链继承。
21
+ - `memory_scopes` 新增 `action="request"`:按统一授权判定逐条筛,已允许 / 已有授权 / 不可申请(`absolute`、显式 read/write 关闭、作用域关闭)都不弹卡;只有普通限制下的范围外条目进入审批。
22
+ - 审批卡新增 `mode="grant"`:按 scope + 权限逐条勾选,**默认只勾只读**,写权限必须用户主动勾选;批准后写入本会话 grants,工具返回 `granted / already-allowed / already-granted / not-requestable / denied / timeout` 等逐项状态。
23
+ - 一次性访问仍走 `memory_*` 的隐式 `allowed-once` 审批,不塞进申请工具;`workspace` / `global` 长期授权留给后续版本。
24
+ - **绝对限制语义写死**:`absolute` 下范围外作用域**目录可见**(名字 / 用途),但正文永不可读、不可写、`canRequestRead/Write` 恒为 false——**没有任何审批放行路径**;普通限制下范围外条目才标记「可申请」。
25
+ - **initial 正文(D5)**:`normal / none` 下 `memory_scopes list` 会带上每个作用域的初始化记录正文(`initial: true`,最多 3 条、每条截到 800 字),Agent 不必先申请就能读到“这个作用域主要放什么”;`absolute` 下连初始正文也不返回(用途仍可见)。
26
+ - **审批审计(D6)**:新增 `<storeDir>/approvals.jsonl`,记录 `requested / approved / denied / timeout / granted / revoked`,只写 scope、权限、工具、会话与理由,**不写记忆正文**;provider 暴露 `approvalAuditList()` 与 `revokeGrant()`,面板与诊断可直接消费。作用域显式删除的生命周期留到后续版本(当前没有“删除作用域”操作,grant 已用 `scopeGeneration` 防止同名重建复活)。
27
+ - **`initial` 来源标记全链路**:`memory_get` 的 `fields` 新增 `initial`,导出 / 导入、`reviseRecord` 修正版都会保留;旧记录缺省 = 非初始,绝不当作公开或授权凭据。
28
+ - **测试**:作用域元数据生命周期、目录在 normal / absolute / `customEnabled=false` 下的行为、缺失用途拒绝、原子初始化的初始事实与规则、`initial` 的 get / 导出 / 导入、目录工具契约与渲染。全套通过。
29
+
5
30
  ## 0.23.1 — 默认作用域显示为已绑定;绑定保存后可恢复
6
31
 
7
32
  - **修复「绑定后重开又变成未绑定」的观感与保存范围**:
package/README.md CHANGED
@@ -39,8 +39,10 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
39
39
 
40
40
  | 能力 | 说明 |
41
41
  | --- | --- |
42
- | **五个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取;同一会话里已出现过的条目只回 id。`description` 字段在普通限制下必填,审批卡会展示它 |
43
- | **四种作用域** | 会话 / 项目 / `global` / 自定义名。默认写进当前会话,读默认合并会话 + 项目 + global;项目作用域可起别名 |
42
+ | **六个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget` / `memory_scopes`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取;同一会话里已出现过的条目只回 id。`description` 字段在普通限制下必填,审批卡会展示它。`memory_scopes` 只读目录:给作用域名字 / 用途 / 当前可读可写状态,不返回任何正文 |
43
+ | **四种作用域** | 会话 / 项目 / `global` / 自定义名。默认写进当前会话,读默认合并会话 + 项目 + global;项目作用域可起别名。自定义作用域**首次由 Agent 创建时必须带 `scopeDescription`**(一句话用途),可选带 `scopeRule` 写一条初始规则;元数据存在 `<storeDir>/scope-meta/`,删光记录也不会丢 |
44
+ | **作用域目录与绝对隔离** | `memory_scopes` 列出范围内 / 范围外的名字与用途;normal / none 下还带**初始化记录正文**(每个作用域最多 3 条,方便 Agent 直接读到“这个作用域主要放什么”)。绝对限制下范围外作用域**仍可发现**,但正文(含初始记录)永不可读、不可写、不可申请(没有任何审批放行路径);普通限制下范围外条目可申请,`memory_scopes request` 走审批后写入**本会话**授权(默认只读,写权限必须单独申请),子 Agent 沿父会话继承 |
45
+ | **会话授权(grants)** | Agent 申请、用户批准的例外单独存在 `<storeDir>/grants/<session>.json`,不并入可见域策略;只读 / 可写独立、可撤销、只在本会话(及子 Agent)生效;`absolute` 下授权不生效,作用域被删除重建后按创建代次自动失效 |
44
46
  | **双通道检索** | 词法(IDF + 中文 bigram)**+** 向量(本机 llama-server 的 OpenAI 兼容 `/v1/embeddings`)。向量缺席自动降级,不报错、不阻塞 |
45
47
  | **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
46
48
  | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
@@ -214,7 +216,7 @@ memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }
214
216
  后会重新返回摘要。`memory_search` 里这些裸 ID 单独成块,与带摘要的条目之间**空一行**,不会看起来像
215
217
  上一条的续行。状态与召回/摘要共用同一份会话去重记录(`summary_injected` / `content_injected`)。
216
218
 
217
- **`description`(0.22.0)**:五个工具都新增 `description` 参数 —— 一句话说明这次调用要做什么。
219
+ **`description`(0.22.0)**:六个工具都新增 `description` 参数 —— 一句话说明这次调用要做什么。
218
220
  本会话「记忆范围」为**普通限制**(默认)时**必填**,漏了会被 `DESCRIPTION_REQUIRED` 拒绝;
219
221
  绝对限制 / 无限制下可省略。它只用于范围外访问的审批卡(展示给用户判断是否放行),不写进记忆。
220
222
 
@@ -226,7 +228,7 @@ memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }
226
228
  | `project` | 当前工作区(键是 `project:<cwd>`) |
227
229
  | `path` + 可选 `scope` | 指定工作区目录;`scope` 成为这个项目作用域的显示名(别名) |
228
230
  | `global` | 所有项目共享 |
229
- | `handbook`、`项目笔记` … | 自定义作用域,首次 `memory_save` 自动创建 |
231
+ | `handbook`、`项目笔记` … | 自定义作用域,首次 `memory_save` 自动创建(Agent 创建时必须带 `scopeDescription`) |
230
232
  | `session:<id>` / `project:<path>` | 显式钉住某个会话 / 工作区 |
231
233
  | `all` / `*` | **只在读取时可用**:跨所有已发现作用域 |
232
234
 
@@ -234,6 +236,47 @@ memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }
234
236
  同一路径重复用同一个名字是幂等的;换名字会覆盖原别名;另一个路径抢同一个名字会被拒绝
235
237
  (`SCOPE_NAME_TAKEN`)。
236
238
 
239
+ **新建自定义作用域(0.24.0)**:Agent 必须说明用途,可选写一条初始规则;两者在同一次
240
+ `memory_save` 里原子写入(元数据先落 `pending`,记录与规则写完后转 `ready`,中途失败下次保存会续上):
241
+
242
+ ```js
243
+ memory_save({
244
+ scope: "handbook",
245
+ content: "本作用域用于收集团队约定、流程与踩坑记录。",
246
+ kind: "fact",
247
+ scopeDescription: "团队约定与流程;只放可复用的结论,不放一次性排错日志。",
248
+ scopeRule: "只记录与团队协作 / 发布 / 工具链有关的内容;一次性排错过程不进这里。",
249
+ description: "初始化团队约定作用域"
250
+ })
251
+ ```
252
+
253
+ 用途会出现在 `memory_scopes` 的目录里:
254
+
255
+ ```js
256
+ memory_scopes({ action: "list", description: "看看有哪些作用域、各自干什么" })
257
+ ```
258
+
259
+ 绝对限制下**目录可见但正文不可读**:范围外作用域仍显示名字与用途(方便判断要不要让用户
260
+ 调整范围),但记录数、正文、申请入口都不会返回。
261
+
262
+ **申请本会话权限(0.24.0 / D3)**:普通限制下,Agent 可以对**范围外**作用域发申请;
263
+ 默认只申请只读,写权限必须显式列出:
264
+
265
+ ```js
266
+ memory_scopes({
267
+ action: "request",
268
+ scopes: ["handbook"],
269
+ permissions: ["read"],
270
+ reason: "需要团队约定与发布流程",
271
+ description: "申请读取 handbook"
272
+ })
273
+ ```
274
+
275
+ 审批卡默认只勾只读;用户勾上写权限才会授予写。批准后写入
276
+ `<storeDir>/grants/<session>.json`(本会话 + 子 Agent 继承),不会改可见域策略;
277
+ `absolute` 下所有申请都返回 `not-requestable`,不会弹卡。一次性访问仍走 `memory_*`
278
+ 自己的隐式审批,不需要先申请。
279
+
237
280
  ### 5. 导入 / 导出
238
281
 
239
282
  导出是纯文本 JSON:作用域、类型、内容、标签、重要度、时间戳,**不含向量**。
@@ -386,6 +429,9 @@ retrieval:
386
429
  | `<storeDir>/projects/<sha1(scope)>.vec` | 向量边车;首行 `#<model>\t<dims>\t<pooling>`,后面每行 `id\t<base64 向量>` |
387
430
  | `<storeDir>/settings.json` | 面板设置(覆盖配置文件里的默认值) |
388
431
  | `<storeDir>/scopes.json` | 项目作用域别名(显示名 → `project:<路径>`) |
432
+ | `<storeDir>/scope-meta/<sha1(scope)>.json` | 作用域用途 / 来源 / 创建者 / 创建代次 / 初始化状态;每个作用域一个文件,删光记录也不删元数据 |
433
+ | `<storeDir>/grants/<session>.json` | 会话级作用域授权(Agent 申请、用户批准);只读 / 可写分开、可撤销、带作用域创建代次 |
434
+ | `<storeDir>/approvals.jsonl` | 审批与授权生命周期审计(requested / approved / denied / timeout / granted / revoked);只记 scope 与权限,不记记忆正文 |
389
435
  | `<storeDir>/visibility/<session>.json` | 会话「记忆可见域」覆盖(作用域 + 限制等级);没有文件 = 使用默认三路集合 |
390
436
  | `<storeDir>/*.lock` | 跨进程写锁;陈旧锁(持有者已死或 10s 未动)会被接管 |
391
437
  | `<installRoot>/llamacpp/` | llama-server 运行时、依赖 dll、`llama-server.log` |
@@ -394,6 +440,7 @@ retrieval:
394
440
 
395
441
  `storeDir` 默认 `.dsh-memory`(相对启动目录),**建议显式配一个绝对路径**。文件首次写入才创建;
396
442
  作用域被删空后,它的 `.jsonl` 与 `.vec` 会在下一次落盘时一起移除(`global.jsonl` 例外:只清内容、留文件)。
443
+ 作用域元数据(`scope-meta/`)独立于记录:删光某个作用域的最后一条记忆,不会删除它的用途说明。
397
444
 
398
445
  scope 键有三种形态:`global`、`project:<cwd>`、`session:<会话 id>`,其余是自定义名
399
446
  (小写折叠、内部空白折成一个空格、最长 64 字符,禁止 `:`、路径分隔符、控制字符、`..`
@@ -414,6 +461,7 @@ scope 键有三种形态:`global`、`project:<cwd>`、`session:<会话 id>`,
414
461
  「只认 loopback 权威 + 同源」。原因是注册在裸 `webServer` 上的路由不在宿主 `/api` 围栏之后,
415
462
  而这里的接口能读、改、删、清空全部记忆。
416
463
  - 记忆内容写入前过凭据扫描(`secrets.mode: refuse | redact`),默认拒绝。
464
+ - **统一授权判定(0.24.0)**:`discover / read / write / delete` 都走 provider 的同一个纯函数 `authorize()`;工具层只决定“要不要发起审批”,不再各自解释绝对 / 普通 / 无限制。`absolute` 下不存在任何审批放行路径;显式关掉「可读 / 可写」的作用域也不通过审批放行。
417
465
  - 清空记忆是两步确认 + 接口要求显式 `confirm: "delete"`。
418
466
  - 数据默认只在本机:JSONL 不加密,向量端点默认 loopback;请自行保护 store 目录,导出文件也是明文。
419
467
 
package/lib/client.js CHANGED
@@ -5005,26 +5005,34 @@ window.__ModuleLoader__.load({
5005
5005
 
5006
5006
  // 0.20 起写/删也会触发审批,文案按 action 走。
5007
5007
  const action = pending.action === 'write' || pending.action === 'delete' ? pending.action : 'read'
5008
- const actionLabel = action === 'write' ? '写入' : action === 'delete' ? '删除' : '读取'
5009
- const actionHint = action === 'write'
5010
- ? 'Agent 想把一条记忆写入可见域外的作用域。允许只对本次调用生效;拒绝则不写入。'
5011
- : action === 'delete'
5012
- ? 'Agent 想删除可见域外的记忆。允许只对本次调用生效;拒绝则不删除。'
5013
- : '以下记忆不在本会话的可见域内。勾选要允许的条目(默认全选);允许只对本次调用生效,其余条目不会返回。'
5008
+ // 0.24.0:grant 模式 = 作用域权限申请,不是记忆条目审批。
5009
+ const grantMode = pending.mode === 'grant'
5010
+ const actionLabel = grantMode ? '访问' : action === 'write' ? '写入' : action === 'delete' ? '删除' : '读取'
5011
+ const actionHint = grantMode
5012
+ ? 'Agent 申请访问可见域外的作用域。勾选要授予的权限(默认只读);授权仅在本会话有效,子 Agent 会继承。'
5013
+ : action === 'write'
5014
+ ? 'Agent 想把一条记忆写入可见域外的作用域。允许只对本次调用生效;拒绝则不写入。'
5015
+ : action === 'delete'
5016
+ ? 'Agent 想删除可见域外的记忆。允许只对本次调用生效;拒绝则不删除。'
5017
+ : '以下记忆不在本会话的可见域内。勾选要允许的条目(默认全选);允许只对本次调用生效,其余条目不会返回。'
5014
5018
  const items = Array.isArray(pending.items) ? pending.items : []
5015
5019
  // 模型写的用途说明(0.22.0;普通限制下工具层强制提供)。
5016
5020
  const description = typeof pending.description === 'string' ? pending.description.trim() : ''
5017
5021
  const allIds = items.map((item) => item.id)
5018
- // 只有"读 + 多条"才有逐条勾选的意义:写/删是单条,允许就是允许。
5019
- const selectable = action === 'read' && allIds.length > 1
5022
+ // grant 模式默认只勾只读项(写权限必须用户主动勾);普通读审批默认全选。
5023
+ const defaultIds = grantMode
5024
+ ? items.filter((item) => item.grantPermission !== 'write').map((item) => item.id)
5025
+ : allIds
5026
+ // 多条目才有逐条勾选的意义;grant 模式下 even 1 条也走勾选以明确权限。
5027
+ const selectable = grantMode ? allIds.length > 0 : action === 'read' && allIds.length > 1
5020
5028
  const stored = Array.isArray(picked[pending.id]) ? picked[pending.id].filter((id) => allIds.includes(id)) : null
5021
- const selectedIds = stored === null ? allIds : stored
5029
+ const selectedIds = stored === null ? defaultIds : stored
5022
5030
  const selectedSet = new Set(selectedIds)
5023
5031
  const selectedCount = selectedIds.length
5024
5032
 
5025
5033
  const toggle = (itemId) => {
5026
5034
  setPicked((prev) => {
5027
- const current = Array.isArray(prev[pending.id]) ? prev[pending.id].filter((id) => allIds.includes(id)) : [...allIds]
5035
+ const current = Array.isArray(prev[pending.id]) ? prev[pending.id].filter((id) => allIds.includes(id)) : [...defaultIds]
5028
5036
  const next = current.includes(itemId) ? current.filter((id) => id !== itemId) : [...current, itemId]
5029
5037
  return { ...prev, [pending.id]: next }
5030
5038
  })
@@ -5085,16 +5093,20 @@ window.__ModuleLoader__.load({
5085
5093
 
5086
5094
  const allowLabel = busy === pending.id
5087
5095
  ? '处理中…'
5088
- : selectable && selectedCount !== allIds.length
5089
- ? `允许选中的 ${selectedCount} 条`
5090
- : '允许一次'
5096
+ : grantMode && selectable && selectedCount !== allIds.length
5097
+ ? `允许选中的 ${selectedCount} 项(本会话)`
5098
+ : grantMode
5099
+ ? '允许授权(本会话)'
5100
+ : selectable && selectedCount !== allIds.length
5101
+ ? `允许选中的 ${selectedCount} 条`
5102
+ : '允许一次'
5091
5103
 
5092
5104
  return h('div', {
5093
5105
  className: 'mem-approval',
5094
5106
  'data-approval-id': pending.id,
5095
5107
  onKeyDown: keydown,
5096
5108
  },
5097
- h('div', { className: 'mem-approval-card', role: 'dialog', 'aria-label': `记忆${actionLabel}审批`, 'aria-busy': busy === pending.id },
5109
+ h('div', { className: 'mem-approval-card', role: 'dialog', 'aria-label': grantMode ? '记忆访问授权审批' : `记忆${actionLabel}审批`, 'aria-busy': busy === pending.id },
5098
5110
  h('div', { className: 'mem-approval-strip' },
5099
5111
  h('span', { className: 'mem-approval-dot' }),
5100
5112
  h('span', null, busy === pending.id ? '处理中…' : '等待审批'),
@@ -5114,9 +5126,13 @@ window.__ModuleLoader__.load({
5114
5126
  isCollapsed
5115
5127
  ? null
5116
5128
  : h('div', { className: 'mem-approval-body' },
5117
- h('div', { className: 'mem-approval-headline' }, `工具 ${pending.tool || 'memory'} 请求${actionLabel}可见域外的记忆`),
5129
+ h('div', { className: 'mem-approval-headline' }, grantMode
5130
+ ? `工具 ${pending.tool || 'memory'} 申请访问可见域外的作用域`
5131
+ : `工具 ${pending.tool || 'memory'} 请求${actionLabel}可见域外的记忆`),
5118
5132
  h('div', { className: 'mem-approval-hint' }, actionHint),
5119
- h('div', { className: 'mem-approval-command' }, `Agent 查询:${pending.query || '(未提供)'}`),
5133
+ h('div', { className: 'mem-approval-command' }, grantMode
5134
+ ? `申请理由:${pending.query || '(未提供)'}`
5135
+ : `Agent 查询:${pending.query || '(未提供)'}`),
5120
5136
  description !== ''
5121
5137
  ? h('div', { className: 'mem-approval-desc', title: description }, `Agent 说明:${description}`)
5122
5138
  : null,
@@ -5158,7 +5174,7 @@ window.__ModuleLoader__.load({
5158
5174
  className: 'mem-approval-check' + (checked ? ' on' : ''),
5159
5175
  role: 'checkbox',
5160
5176
  'aria-checked': checked,
5161
- 'aria-label': `允许这条记忆 ${item.id}`,
5177
+ 'aria-label': grantMode ? `允许这项权限 ${item.id}` : `允许这条记忆 ${item.id}`,
5162
5178
  onClick: (event) => {
5163
5179
  if (event && typeof event.stopPropagation === 'function') event.stopPropagation()
5164
5180
  toggle(item.id)
@@ -5167,7 +5183,7 @@ window.__ModuleLoader__.load({
5167
5183
  : null,
5168
5184
  h('div', { className: 'mem-approval-item-body' },
5169
5185
  h('div', { className: 'mem-approval-row' },
5170
- action === 'read'
5186
+ !grantMode && action === 'read'
5171
5187
  ? h('button', {
5172
5188
  type: 'button',
5173
5189
  className: 'mem-approval-id',
@@ -5179,14 +5195,22 @@ window.__ModuleLoader__.load({
5179
5195
  openMemoryRecordPanel(item.id, item.scope, item)
5180
5196
  },
5181
5197
  }, String(item.id).length > 12 ? `${item.id.slice(0, 8)}…${item.id.slice(-4)}` : String(item.id))
5182
- : h('span', { className: 'mem-approval-id', title: item.id }, String(item.id).length > 12 ? `${item.id.slice(0, 8)}…${item.id.slice(-4)}` : String(item.id)),
5198
+ : h('span', { className: 'mem-approval-id', title: item.id }, grantMode
5199
+ ? (item.grantPermission === 'write' ? '可写' : '只读')
5200
+ : (String(item.id).length > 12 ? `${item.id.slice(0, 8)}…${item.id.slice(-4)}` : String(item.id))),
5183
5201
  h('span', { className: 'audit-pill mute' }, item.scope),
5184
- h('span', { className: 'audit-pill mute' }, item.kind ? kindMeta(item.kind).label : '未知'),
5185
- item.reason === 'kind'
5186
- ? h('span', { className: 'audit-pill warn' }, '类型受限')
5187
- : h('span', { className: 'audit-pill warn' }, '范围外'),
5202
+ grantMode
5203
+ ? h('span', { className: 'audit-pill mute' }, item.grantPermission === 'write' ? '写入 / 删除' : '只读访问')
5204
+ : h('span', { className: 'audit-pill mute' }, item.kind ? kindMeta(item.kind).label : '未知'),
5205
+ grantMode
5206
+ ? h('span', { className: 'audit-pill warn' }, '本会话授权')
5207
+ : item.reason === 'kind'
5208
+ ? h('span', { className: 'audit-pill warn' }, '类型受限')
5209
+ : h('span', { className: 'audit-pill warn' }, '范围外'),
5188
5210
  ),
5189
- h('div', { className: 'mem-approval-summary' }, String(item.content || '').replace(/\s+/g, ' ').slice(0, 180)),
5211
+ h('div', { className: 'mem-approval-summary' }, grantMode
5212
+ ? (item.grantPermission === 'write' ? '允许新增、修改与删除该作用域的记录' : '允许查询与读取该作用域的正文')
5213
+ : String(item.content || '').replace(/\s+/g, ' ').slice(0, 180)),
5190
5214
  ),
5191
5215
  )
5192
5216
  }),
@@ -553,7 +553,7 @@ export function apply(ctx , config = {}) {
553
553
  }
554
554
 
555
555
  /** 记忆工具自身的调用:不属于注入评估,但它是审计里最有用的轨迹锚点。 */
556
- const MEMORY_TOOL_NAMES = new Set(['memory_save', 'memory_search', 'memory_forget', 'memory_list', 'memory_get'])
556
+ const MEMORY_TOOL_NAMES = new Set(['memory_save', 'memory_search', 'memory_forget', 'memory_list', 'memory_get', 'memory_scopes'])
557
557
  const rememberMemoryToolCall = (
558
558
  sessionId ,
559
559
  data ,
@@ -4,10 +4,16 @@
4
4
  */
5
5
  export const POLICY_TEXT = `## 记忆系统
6
6
 
7
- 本会话挂着一个本地记忆库,工具:memory_search / memory_list / memory_get / memory_save / memory_forget(可按会话、项目、全局等作用域读写)。
7
+ 本会话挂着一个本地记忆库,工具:memory_search / memory_list / memory_get / memory_save / memory_forget / memory_scopes(可按会话、项目、全局等作用域读写)。
8
8
 
9
9
  memory_search 只返回印象(ID、作用域、类型、标签和少量摘要);判断相关后再用 memory_get(ids, fields) 取正文。fields 省略 = content + scope + kind + tags;只要摘要用 ["summary"],只要正文用 ["content"],需要重要度 / 时间 / 触发词等再显式加上对应字段。
10
10
 
11
+ 需要知道有哪些作用域、各自用来做什么、当前能不能读/写时,用 memory_scopes(action="list")。它只返回目录元信息(名字 / 用途 / 访问状态)与初始化记录正文,不返回普通记忆正文;范围外作用域在绝对限制下仍可发现,但正文(含初始化记录)永不可读、不可申请。
12
+
13
+ 需要长期使用范围外作用域时,用 memory_scopes 的 action="request" 申请本会话权限:默认只读,写权限必须在 permissions 里显式列出;审批卡默认只勾只读。批准后本会话(及子 Agent)可直接读写该作用域,不必每次审批;一次性访问仍直接调用 memory_search / memory_get。
14
+
15
+ 新建自定义作用域时,memory_save 必须带 scopeDescription(一句话用途);可选带 scopeRule 写一条初始规则。已有作用域带上 scopeDescription 表示更新用途,不会写初始记忆。
16
+
11
17
  同一会话里已经出现过的记忆,memory_search / memory_list 只回 ID 并注明“摘要因上下文去重被省略”;那不是没找到,需要正文时直接用 memory_get 取。
12
18
 
13
19
  本会话「记忆范围」为普通限制时(默认),调用任一 memory_* 工具都必须带 description 字段:用一句话说明这次调用要做什么(例如「查发布流程的坑」)。它只用于范围外访问的审批弹窗,不写进记忆;漏了会被工具直接拒绝。绝对限制 / 无限制下可省略。
@@ -196,6 +196,21 @@ export class CordisMemoryService extends Service {
196
196
  return this.impl.scopeName(scope)
197
197
  }
198
198
 
199
+ /** 作用域用途等元数据(没有则 undefined)。 */
200
+ scopeMeta(scope ) {
201
+ return this.impl.scopeMeta(scope)
202
+ }
203
+
204
+ /** 写入 / 更新作用域用途(不创建记录)。 */
205
+ describeScope(scope , description , by ) {
206
+ return this.impl.describeScope(scope, description, by)
207
+ }
208
+
209
+ /** 作用域目录:名字 / 用途 / 当前可读可写状态(工具 memory_scopes 与面板共用)。 */
210
+ scopeCatalog(agent ) {
211
+ return this.impl.scopeCatalog(agent)
212
+ }
213
+
199
214
  /** 注入设置(面板「设置」标签页读它)。 */
200
215
  injectSettings() {
201
216
  return this.impl.injectSettings()
@@ -268,6 +283,16 @@ export class CordisMemoryService extends Service {
268
283
  return this.impl.isScopeWritable(agent, scope)
269
284
  }
270
285
 
286
+ /** 统一授权判定(0.24.0):read/write/delete/discover 的唯一规则出口。 */
287
+ authorize(agent , request ) {
288
+ return this.impl.authorize(agent, request)
289
+ }
290
+
291
+ /** 一次解析、多次判定(检索逐条过滤用)。 */
292
+ accessEvaluator(agent ) {
293
+ return this.impl.accessEvaluator(agent)
294
+ }
295
+
271
296
  /** 当前工作区 key(= 会话 cwd 解析出的 project scope)。 */
272
297
  workspaceKeyFor(agent ) {
273
298
  return this.impl.workspaceKeyFor(agent)
@@ -323,6 +348,26 @@ export class CordisMemoryService extends Service {
323
348
  return this.impl.requestOutOfScope(agent, input)
324
349
  }
325
350
 
351
+ /** Agent 主动申请范围外作用域的会话权限(0.24.0 / D3)。 */
352
+ requestScopeGrants(agent , input ) {
353
+ return this.impl.requestScopeGrants(agent, input)
354
+ }
355
+
356
+ /** 当前会话(含父链)的有效授权。 */
357
+ grantList(agent ) {
358
+ return this.impl.grantList(agent)
359
+ }
360
+
361
+ /** 面板:撤销一条会话授权。 */
362
+ revokeGrant(sessionId , id ) {
363
+ return this.impl.revokeGrant(sessionId, id)
364
+ }
365
+
366
+ /** 最近的审批 / 授权生命周期事件(不含正文)。 */
367
+ approvalAuditList(limit ) {
368
+ return this.impl.approvalAuditList(limit)
369
+ }
370
+
326
371
  /** 面板:当前待审批列表。 */
327
372
  pendingVisibilityApprovals(sessionId ) {
328
373
  return this.impl.pendingVisibilityApprovals(sessionId)
@@ -0,0 +1,77 @@
1
+ /**
2
+ * 审批审计(approvals.jsonl)。
3
+ *
4
+ * 只记“谁在什么时候申请了什么、用户怎么决定”,**不记记忆正文**——审计不能变成
5
+ * 第二份敏感记忆库。与注入审计(inject audit)分开:那份记注入评估,这份记
6
+ * 权限申请与授权生命周期。
7
+ *
8
+ * 每行一个不可变事件,追加写(O_APPEND),跨进程写小行不会互相撕裂。
9
+ */
10
+ import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'
11
+ import { dirname, join } from 'node:path'
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
+ export class ApprovalAuditStore {
40
+ file
41
+
42
+ constructor(options ) {
43
+ this.file = join(options.root, 'approvals.jsonl')
44
+ }
45
+
46
+ append(event ) {
47
+ try {
48
+ if (!existsSync(this.file)) mkdirSync(dirname(this.file), { recursive: true })
49
+ appendFileSync(this.file, `${JSON.stringify(event)}\n`, 'utf8')
50
+ } catch {
51
+ // 审计写失败不能影响审批本身
52
+ }
53
+ }
54
+
55
+ /** 最近 N 条(面板 / 诊断用),坏行跳过。 */
56
+ list(limit = 200) {
57
+ let text
58
+ try {
59
+ text = readFileSync(this.file, 'utf8')
60
+ } catch {
61
+ return []
62
+ }
63
+ const out = []
64
+ for (const line of text.split('\n')) {
65
+ const trimmed = line.trim()
66
+ if (!trimmed) continue
67
+ try {
68
+ const value = JSON.parse(trimmed)
69
+ if (value !== null && typeof value === 'object' && typeof value.event === 'string') out.push(value)
70
+ } catch { /* 坏行跳过 */ }
71
+ }
72
+ return out.slice(-Math.max(1, Math.min(2000, limit))).reverse()
73
+ }
74
+ }
75
+
76
+
77
+ //# sourceURL=source/memory-local/src/approval-audit.ts
@@ -0,0 +1,114 @@
1
+ /**
2
+ * 统一的访问判定(0.24.0 / D2)。
3
+ *
4
+ * 目标:**所有入口只解释一套规则**。此前可见域判定散落在工具层(`recordAllowed` /
5
+ * `scopeWritable`)、provider(`visibilityFilterFor` / `isScopeReadable` /
6
+ * `isScopeWritable` / `assertOperable`)和注入层(`autoRecallScopes` /
7
+ * `visibleKinds`),同一份策略在不同入口可能给出不同答案。
8
+ *
9
+ * 这里的语义是产品决策,不是实现细节:
10
+ * - `absolute`:**没有审批放行路径**。范围外一律拒绝,`requestable` 恒为 false;
11
+ * - `normal`:范围外可被拒绝但可审批(`requestable=true`);用户显式关掉
12
+ * `read` / `write` 的作用域不可审批,必须先由用户打开开关;
13
+ * - `none`:不限制(策略里的 scopes 只是偏好);
14
+ * - `discover` 只受作用域类型开关约束:`absolute` 下名字/用途仍可发现,
15
+ * 这正是“目录可见、正文不可读”的边界;
16
+ * - 作用域类型被配置关闭(如 `customEnabled=false`)时,连 discover 都拒绝。
17
+ *
18
+ * 纯函数、无 I/O;provider 负责把 agent 上下文解析成 `AccessContext`。
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
+ /** 会话授权(0.24.0 / D3);只有 normal 等级、且作用域在范围外时才参与判定。 */
52
+
53
+
54
+
55
+
56
+
57
+
58
+
59
+                   
60
+
61
+            
62
+
63
+                
64
+
65
+                       
66
+
67
+
68
+
69
+ function outsideDecision(level ) {
70
+ return level === 'absolute'
71
+ ? { allowed: false, reason: 'ABSOLUTE_ISOLATION', requestable: false }
72
+ : { allowed: false, reason: 'SCOPE_NOT_IN_RANGE', requestable: level === 'normal' }
73
+ }
74
+
75
+ export function authorize(request , context ) {
76
+ if (!context.enabled[context.originOf(request.scope)]) {
77
+ return { allowed: false, reason: 'SCOPE_DISABLED', requestable: false }
78
+ }
79
+ if (request.action === 'discover') {
80
+ return { allowed: true, source: 'directory' }
81
+ }
82
+ if (context.level === 'none') {
83
+ return { allowed: true, source: 'unrestricted' }
84
+ }
85
+ const rule = context.scopes.find((item) => item.scope === request.scope)
86
+ /** 范围外时先看会话 grant;**只在 normal 下**,absolute 没有任何例外。 */
87
+ const granted = (permission ) =>
88
+ context.level === 'normal' && context.grants?.some((grant) =>
89
+ grant.scope === request.scope && grant.permissions.includes(permission)) === true
90
+ if (request.action === 'read') {
91
+ if (rule === undefined) {
92
+ return granted('read')
93
+ ? { allowed: true, source: 'grant' }
94
+ : outsideDecision(context.level)
95
+ }
96
+ if (rule.read === false) return { allowed: false, reason: 'READ_DISABLED', requestable: false, rule }
97
+ if (rule.kinds !== undefined && rule.kinds.length > 0
98
+ && (request.kind === undefined || !rule.kinds.includes(request.kind))) {
99
+ return { allowed: false, reason: 'KIND_NOT_ALLOWED', requestable: false, rule }
100
+ }
101
+ return { allowed: true, source: 'in-range', rule }
102
+ }
103
+ // write / delete:0.24 起删除仍归在 write;独立 delete 权限留给后续版本。
104
+ if (rule === undefined) {
105
+ return granted('write')
106
+ ? { allowed: true, source: 'grant' }
107
+ : outsideDecision(context.level)
108
+ }
109
+ if (rule.write === false) return { allowed: false, reason: 'WRITE_DISABLED', requestable: false, rule }
110
+ return { allowed: true, source: 'in-range', rule }
111
+ }
112
+
113
+
114
+ //# sourceURL=source/memory-local/src/authorize.ts