@restregular/dsh-memory 0.25.13 → 0.25.14
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 +7 -0
- package/README.md +1 -1
- package/lib/client.js +102 -0
- package/lib/panel.js +7 -1
- package/lib/provider/apply.js +5 -0
- package/lib/provider/index.js +42 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.25.14 — 侧边栏给等待记忆审批的会话显示黄点 /「待审批」
|
|
6
|
+
|
|
7
|
+
- **问题**:范围外记忆审批以前只是插件自己画在 `conversation.input.dock` 的卡片;宿主的侧边栏会话列表并不认识它,所以工具在等审批时,那一行没有系统审批 / ask 工具那样的黄点,也不会被「待审批」水线自动顶出来。宿主这两类阻塞都来自 `ctx.uiSession` 的 pending-interaction 注册表(`dsh-client-ui-approval` 发 `kind:'approval'`,`dsh-client-ui-user-questions` 发 `kind:'question'`)。
|
|
8
|
+
- **做法**:客户端新增 `installApprovalPresence`,通过 `ctx.inject(['uiSession'], …)`(等 `uiSession` 就绪,不在 apply 里一次性取样)注册一个 pending-interaction domain;轮询轻量审批摘要,为每条待审批发布一个**合成 interaction** `{ sessionId, kind:'approval', key:'memory-approval:<id>', toolName }`,回答 / 超时后撤销。它**不是** `PendingApproval` 实例,所以宿主的审批卡不会抢着渲染,我们自己的审批卡仍是唯一 UI;但侧边栏黄点、紧凑文案「待审批」、悬停「等待审批」、会话水线提升、以及其它插件对 `uiSession.sessionStatus` 的读取,都和系统审批完全同构。按审批 id 增删,同一会话多条审批互不顶掉;点「拒绝 / 允许」后立即同步一次,不必等下一次轮询。
|
|
9
|
+
- **轻量接口**:`GET /memory/api/approvals?summary=1` 新增摘要口径,只回 `id / sessionId / tool / action / mode / createdAt / expiresAt`,不复制条目正文与查询语句;provider 新增 `pendingVisibilityApprovalPresence()`。旧 provider 没有该方法时回退完整列表,客户端只读 id + sessionId,兼容不破。
|
|
10
|
+
- **测试**:客户端新增「待审批发布成 approval 类型、空 sessionId 跳过、同一会话多条、回答一条只撤一条、卸载清空」用例;面板新增 `/approvals?summary=1` 的「无正文 / 按会话过滤 / grant mode / 旧 provider 回退」用例。
|
|
11
|
+
|
|
5
12
|
## 0.25.13 — 「绑定」点一下立即保存;绑定不再往上下文注入提示
|
|
6
13
|
|
|
7
14
|
- **绑定即存**:记忆权限浮窗里每个作用域的【绑定】按钮以前只是草稿,必须再点「保存」才落盘——用户点完绑定看不出任何反馈,很容易以为没生效。现在点一下就走新接口 `POST /memory/api/bindings` 立即保存(再点一次 = 解除绑定),按钮先乐观更新、失败回滚原状态并把错误显示在浮窗里;「绑定」按钮的 `title` 与浮窗提示行都写清「点一下就保存」。绑定是工作区级设置(本工作区新会话的默认可见范围),与浮窗里「勾选范围 / 可读 / 可写」那份会话级草稿无关,所以**不需要**先设草稿;点「保存」时仍会幂等带上一次绑定,旧客户端 / 老服务端按原逻辑照旧生效。
|
package/README.md
CHANGED
|
@@ -49,7 +49,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
49
49
|
| **硬性规则** | `kind: rule` 进系统提示常驻段;行首带 8 位 id,注入的是摘要,需要全文时用 `memory_get`;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
|
|
50
50
|
| **记忆权限** | 输入框旁的「记忆权限」按钮设置本会话可读的作用域 + 限制等级(绝对 / 普通 / 无限制);每个作用域一行就是一条设置:**勾选**表示本会话可访问,行内**【绑定】/【可读】/【可写】**控制工作区默认可见与读写权限——**【绑定】点一下立即保存**(0.25.13 起),绑定到当前工作区后新会话默认可见,可读 / 可写独立影响工具读写;Agent 通过 `memory_scopes request` 申请到的范围外授权**也用勾选呈现**(名称右边挂一个「AI」气泡,样式与你自己勾选的行区分开),取消勾选只是草稿,**点「保存」才真正撤销**(0.25.4 起),且按钮数字 / 「已选」都把 AI 授权算进去(0.25.5 起)并**实时轮询**——浮窗关着,Agent 刚拿到的授权也会让按钮数字自己变(0.25.6 起);**整张作用域卡片都能点选**,点名称 / 计数 / 留白等同点勾选框(0.25.7 起),本会话那一行直接叫「**session:当前会话**」(0.25.8 起,0.25.10 起带类型前缀);**所有作用域名都以 `global:` / `project:` / `session:` / `custom:` 开头**(0.25.10 起);浮窗挂在页面根层,不会被输入框上方的浮动按钮盖住(0.25.8 起);Agent 及其子 Agent 都按它检索、注入与 `memory_get` |
|
|
51
51
|
| **修正版编辑** | 面板里编辑一条记忆 = 新建一条修正版并通过 `supersedes` 指向旧记录,旧记录不原地修改;记录页「是否被修正」筛选默认隐藏旧版本,可切到全部 / 只看已修正 |
|
|
52
|
-
| **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、Agent 说明、查询关键词与范围外记忆摘要,支持逐条勾选 / 全选 / 取消全选(「允许选中的 N 条」或整单「允许一次」)或「拒绝」;点记忆 ID
|
|
52
|
+
| **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、Agent 说明、查询关键词与范围外记忆摘要,支持逐条勾选 / 全选 / 取消全选(「允许选中的 N 条」或整单「允许一次」)或「拒绝」;点记忆 ID 直接跳到面板「记录」页并展开该条。**0.25.14 起**审批等待期间还会像系统审批 / ask 工具一样,在该会话的侧边栏行显示黄色圆点与「待审批」(含后台会话;回答或超时后撤销),其它插件也能从宿主 `uiSession.sessionStatus` 读到这条阻塞 |
|
|
53
53
|
| **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID(`memory_search` 的裸 ID 与带摘要条目之间空一行),并提示用 `memory_get` 取全文(内容更新后重新给摘要) |
|
|
54
54
|
| **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
|
|
55
55
|
| **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
|
package/lib/client.js
CHANGED
|
@@ -5308,6 +5308,100 @@ window.__ModuleLoader__.load({
|
|
|
5308
5308
|
: (createPortal !== null && portalTarget !== null ? createPortal(popover, portalTarget) : popover),
|
|
5309
5309
|
)
|
|
5310
5310
|
}
|
|
5311
|
+
/** 0.25.14:全局待审批快照的轮询周期。与审批卡同频,避免黄点比卡片晚太多。 */
|
|
5312
|
+
const APPROVAL_PRESENCE_POLL_MS = 1500
|
|
5313
|
+
|
|
5314
|
+
/**
|
|
5315
|
+
* 0.25.14:把「本会话正在等待记忆审批」传播成宿主的 pending interaction。
|
|
5316
|
+
*
|
|
5317
|
+
* 为什么需要它:`MemoryApprovalDock` 只是我们自己画的卡片(conversation.input.dock),
|
|
5318
|
+
* 宿主的侧边栏会话列表并不认识它 —— 黄点 /「待审批」/ 自动把会话提到水线以上,
|
|
5319
|
+
* 全部来自 `ctx.uiSession` 的 pending interaction 注册表。宿主自己的
|
|
5320
|
+
* `dsh-client-ui-approval` 和 `dsh-client-ui-user-questions` 就是通过
|
|
5321
|
+
* `registerPendingInteraction` 发布 `kind: 'approval' | 'question'` 的;
|
|
5322
|
+
* 我们照抄同一条通道,发布一个**合成 interaction**(kind='approval'):
|
|
5323
|
+
* - 侧边栏拿到 warning 状态 → 左上角黄点、紧凑文案「待审批」、悬停「等待审批」;
|
|
5324
|
+
* - 其它插件(包括宿主会话本体)也能从 `uiSession.sessionStatus` 读到这个阻塞,
|
|
5325
|
+
* 和系统审批 / ask 工具完全同构;
|
|
5326
|
+
* - 它**不是** `PendingApproval` 实例,所以宿主的审批卡片不会抢着渲染它,
|
|
5327
|
+
* 我们自己的 dock 仍然是唯一可见的审批 UI。
|
|
5328
|
+
*
|
|
5329
|
+
* 发布按审批 id 增删(一个会话可能同时有多条),回答 / 超时后由下一次轮询移除。
|
|
5330
|
+
* `summary=1` 只拿 id + sessionId,不把正文搬来搬去。
|
|
5331
|
+
*/
|
|
5332
|
+
let approvalPresenceSync = null
|
|
5333
|
+
|
|
5334
|
+
function installApprovalPresence(ctx) {
|
|
5335
|
+
if (ctx === null || typeof ctx !== 'object' || typeof ctx.inject !== 'function') return
|
|
5336
|
+
try {
|
|
5337
|
+
// 不在 apply 里一次性 ctx.get('uiSession'):那会在服务尚未 provide 时拿到
|
|
5338
|
+
// undefined 且永不重试(插件冷启动丢注册的老坑)。inject 等就绪后再挂。
|
|
5339
|
+
ctx.inject(['uiSession'], (scope) => {
|
|
5340
|
+
const uiSession = scope.uiSession
|
|
5341
|
+
if (uiSession === null || typeof uiSession !== 'object'
|
|
5342
|
+
|| typeof uiSession.registerPendingInteraction !== 'function') return
|
|
5343
|
+
const publish = uiSession.registerPendingInteraction(() => 0)
|
|
5344
|
+
if (typeof publish !== 'function') return
|
|
5345
|
+
|
|
5346
|
+
// approval id → 撤销发布函数。按 id 增删,避免同一会话的多条审批互相顶掉。
|
|
5347
|
+
const live = new Map()
|
|
5348
|
+
let active = true
|
|
5349
|
+
|
|
5350
|
+
const sync = async () => {
|
|
5351
|
+
let value
|
|
5352
|
+
try { value = await api('approvals?summary=1') } catch { return }
|
|
5353
|
+
if (!active) return
|
|
5354
|
+
const list = value && Array.isArray(value.approvals) ? value.approvals : []
|
|
5355
|
+
const seen = new Set()
|
|
5356
|
+
for (const item of list) {
|
|
5357
|
+
if (item === null || typeof item !== 'object') continue
|
|
5358
|
+
const id = typeof item.id === 'string' ? item.id : ''
|
|
5359
|
+
const sessionId = typeof item.sessionId === 'string' ? item.sessionId : ''
|
|
5360
|
+
if (id === '' || sessionId === '' || seen.has(id)) continue
|
|
5361
|
+
seen.add(id)
|
|
5362
|
+
if (live.has(id)) continue
|
|
5363
|
+
try {
|
|
5364
|
+
const remove = publish({
|
|
5365
|
+
sessionId,
|
|
5366
|
+
kind: 'approval',
|
|
5367
|
+
key: `memory-approval:${id}`,
|
|
5368
|
+
toolName: typeof item.tool === 'string' && item.tool !== '' ? item.tool : 'memory',
|
|
5369
|
+
}, () => {})
|
|
5370
|
+
if (typeof remove === 'function') live.set(id, remove)
|
|
5371
|
+
} catch { /* 单条发布失败不影响其它会话的提醒 */ }
|
|
5372
|
+
}
|
|
5373
|
+
for (const [id, remove] of [...live]) {
|
|
5374
|
+
if (seen.has(id)) continue
|
|
5375
|
+
live.delete(id)
|
|
5376
|
+
try { remove() } catch { /* 组件/服务已释放 */ }
|
|
5377
|
+
}
|
|
5378
|
+
}
|
|
5379
|
+
|
|
5380
|
+
approvalPresenceSync = () => { void sync() }
|
|
5381
|
+
void sync()
|
|
5382
|
+
let timer
|
|
5383
|
+
if (typeof setInterval === 'function') {
|
|
5384
|
+
timer = setInterval(() => {
|
|
5385
|
+
if (typeof document !== 'undefined' && document.hidden) return
|
|
5386
|
+
void sync()
|
|
5387
|
+
}, APPROVAL_PRESENCE_POLL_MS)
|
|
5388
|
+
// Node 测试环境:不因为一个轮询句柄让进程永不退出;浏览器没有 unref。
|
|
5389
|
+
if (timer && typeof timer.unref === 'function') timer.unref()
|
|
5390
|
+
}
|
|
5391
|
+
const stop = () => {
|
|
5392
|
+
if (!active) return
|
|
5393
|
+
active = false
|
|
5394
|
+
if (timer !== undefined) clearInterval(timer)
|
|
5395
|
+
timer = undefined
|
|
5396
|
+
approvalPresenceSync = null
|
|
5397
|
+
for (const remove of live.values()) { try { remove() } catch { /* 已释放 */ } }
|
|
5398
|
+
live.clear()
|
|
5399
|
+
}
|
|
5400
|
+
try { scope.effect(() => stop, 'dsh-memory: approval presence') } catch { /* 旧宿主没有 effect 时随服务释放 */ }
|
|
5401
|
+
})
|
|
5402
|
+
} catch { /* 旧宿主没有 ctx.inject:少一个侧边栏提醒,绝不让 client apply 失败 */ }
|
|
5403
|
+
}
|
|
5404
|
+
|
|
5311
5405
|
/**
|
|
5312
5406
|
* 普通限制下的「范围外记忆访问审批」卡片(0.21.0)。
|
|
5313
5407
|
*
|
|
@@ -5439,6 +5533,8 @@ window.__ModuleLoader__.load({
|
|
|
5439
5533
|
delete next[pending.id]
|
|
5440
5534
|
return next
|
|
5441
5535
|
})
|
|
5536
|
+
// 立刻撤销侧边栏黄点,不必等下一次 1.5s 轮询。
|
|
5537
|
+
if (approvalPresenceSync !== null) approvalPresenceSync()
|
|
5442
5538
|
})
|
|
5443
5539
|
.catch((e) => setError(String((e && e.message) || e)))
|
|
5444
5540
|
.finally(() => setBusy(''))
|
|
@@ -5620,6 +5716,9 @@ window.__ModuleLoader__.load({
|
|
|
5620
5716
|
const stopNavWatch = wrapSettingsNav()
|
|
5621
5717
|
ctx.effect(() => () => { styleEl.remove(); stopNavWatch() }, 'dsh-memory: styles + nav icon')
|
|
5622
5718
|
|
|
5719
|
+
// 0.25.14:侧边栏黄点提示(独立于 slots;旧宿主没有 uiSession 时静默跳过)。
|
|
5720
|
+
installApprovalPresence(ctx)
|
|
5721
|
+
|
|
5623
5722
|
const slots = ctx.get('slots')
|
|
5624
5723
|
if (slots === undefined) return
|
|
5625
5724
|
clientCtx = ctx
|
|
@@ -5883,6 +5982,9 @@ window.__ModuleLoader__.load({
|
|
|
5883
5982
|
AuditTab: AuditTab,
|
|
5884
5983
|
MemoryVisibilityButton: MemoryVisibilityButton,
|
|
5885
5984
|
MemoryApprovalDock: MemoryApprovalDock,
|
|
5985
|
+
// 0.25.14:侧边栏阻塞提示的发布器(测试直接驱动,不等真实 1.5s 定时器)。
|
|
5986
|
+
installApprovalPresence: installApprovalPresence,
|
|
5987
|
+
approvalPresenceSync: () => approvalPresenceSync,
|
|
5886
5988
|
openMemoryRecordPanel: openMemoryRecordPanel,
|
|
5887
5989
|
requestRecordFocus: requestRecordFocus,
|
|
5888
5990
|
takeRecordFocus: takeRecordFocus,
|
package/lib/panel.js
CHANGED
|
@@ -816,12 +816,18 @@ async function handle(ctx, routePath, req, res) {
|
|
|
816
816
|
}
|
|
817
817
|
|
|
818
818
|
// 普通限制下的范围外访问审批:客户端浮层轮询待审批,用户点「拒绝 / 允许一次」后回写。
|
|
819
|
+
// `summary=1` 是 0.25.14 新增的轻量口径:侧边栏阻塞提醒只需要 id + sessionId,
|
|
820
|
+
// 不带条目正文,避免全局 1.5s 轮询把审批内容一遍遍传一遍。
|
|
819
821
|
if (method === 'GET' && path === '/approvals') {
|
|
820
822
|
if (typeof memory.pendingVisibilityApprovals !== 'function') {
|
|
821
823
|
throw new ApiError(501, 'NOT_SUPPORTED', 'provider 未提供可见域审批接口(请升级 @restregular/dsh-memory)')
|
|
822
824
|
}
|
|
823
825
|
const sessionId = (url.searchParams.get('session') ?? '').trim()
|
|
824
|
-
|
|
826
|
+
const summary = url.searchParams.get('summary') === '1'
|
|
827
|
+
const approvals = summary && typeof memory.pendingVisibilityApprovalPresence === 'function'
|
|
828
|
+
? memory.pendingVisibilityApprovalPresence(sessionId === '' ? undefined : sessionId)
|
|
829
|
+
: memory.pendingVisibilityApprovals(sessionId === '' ? undefined : sessionId)
|
|
830
|
+
writeJson(res, { ok: true, value: { approvals } })
|
|
825
831
|
return
|
|
826
832
|
}
|
|
827
833
|
if (method === 'POST' && path === '/approvals') {
|
package/lib/provider/apply.js
CHANGED
|
@@ -383,6 +383,11 @@ export class CordisMemoryService extends Service {
|
|
|
383
383
|
return this.impl.pendingVisibilityApprovals(sessionId)
|
|
384
384
|
}
|
|
385
385
|
|
|
386
|
+
/** 侧边栏阻塞提醒:待审批的轻量快照(不带条目正文)。 */
|
|
387
|
+
pendingVisibilityApprovalPresence(sessionId ) {
|
|
388
|
+
return this.impl.pendingVisibilityApprovalPresence(sessionId)
|
|
389
|
+
}
|
|
390
|
+
|
|
386
391
|
/** 面板:回答一条待审批(可带逐条勾选的 allowedIds)。 */
|
|
387
392
|
answerVisibilityApproval(id , outcome , allowedIds ) {
|
|
388
393
|
return this.impl.answerVisibilityApproval(id, outcome, allowedIds)
|
package/lib/provider/index.js
CHANGED
|
@@ -620,6 +620,24 @@ export function resolveConfig(config = {}) {
|
|
|
620
620
|
|
|
621
621
|
|
|
622
622
|
|
|
623
|
+
/**
|
|
624
|
+
* 侧边栏「阻塞提醒」用的轻量待审批快照(0.25.14)。
|
|
625
|
+
*
|
|
626
|
+
* 客户端要模仿宿主 approval / question 的传播方式:把「某会话正在等用户审批」
|
|
627
|
+
* 发布成宿主 `uiSession` 的 pending interaction,侧边栏才会显示黄点。这个轮询
|
|
628
|
+
* 只需要审批的身份与会话,**不需要条目正文** —— 正文仍由完整 `/approvals` 接口
|
|
629
|
+
* 按会话取,避免每 1.5 秒把几十 KB 的条目内容传到客户端。
|
|
630
|
+
*/
|
|
631
|
+
|
|
632
|
+
|
|
633
|
+
|
|
634
|
+
|
|
635
|
+
|
|
636
|
+
|
|
637
|
+
|
|
638
|
+
|
|
639
|
+
|
|
640
|
+
|
|
623
641
|
/** 一次审批的结局:允许(可只允许其中几条) / 拒绝 / 超时。 */
|
|
624
642
|
|
|
625
643
|
|
|
@@ -2035,6 +2053,30 @@ export class LocalMemoryService {
|
|
|
2035
2053
|
return out.sort((a, b) => a.createdAt - b.createdAt)
|
|
2036
2054
|
}
|
|
2037
2055
|
|
|
2056
|
+
/**
|
|
2057
|
+
* 侧边栏阻塞提醒用的轻量快照(0.25.14):只要审批身份 + 会话。
|
|
2058
|
+
*
|
|
2059
|
+
* 与 `pendingVisibilityApprovals` 同一份内存真值,但**不复制条目正文**:
|
|
2060
|
+
* 客户端全局轮询它来发布 `pendingInteraction`,让宿主侧边栏给等待审批的会话
|
|
2061
|
+
* 显示黄色圆点 /「待审批」;完整 payload 仍由 dock 按当前会话拉取。
|
|
2062
|
+
*/
|
|
2063
|
+
pendingVisibilityApprovalPresence(sessionId ) {
|
|
2064
|
+
const out = []
|
|
2065
|
+
for (const pending of this.pendingApprovals.values()) {
|
|
2066
|
+
if (sessionId !== undefined && sessionId !== '' && pending.sessionId !== sessionId) continue
|
|
2067
|
+
out.push({
|
|
2068
|
+
id: pending.id,
|
|
2069
|
+
sessionId: pending.sessionId,
|
|
2070
|
+
tool: pending.tool,
|
|
2071
|
+
action: pending.action,
|
|
2072
|
+
...(pending.mode !== undefined ? { mode: pending.mode } : {}),
|
|
2073
|
+
createdAt: pending.createdAt,
|
|
2074
|
+
expiresAt: pending.expiresAt,
|
|
2075
|
+
})
|
|
2076
|
+
}
|
|
2077
|
+
return out.sort((a, b) => a.createdAt - b.createdAt)
|
|
2078
|
+
}
|
|
2079
|
+
|
|
2038
2080
|
/** 面板:回答一条待审批。返回 false = 已经不存在/已超时。 */
|
|
2039
2081
|
answerVisibilityApproval(id , outcome , allowedIds ) {
|
|
2040
2082
|
const pending = this.pendingApprovals.get(id)
|