evolclaw 3.2.0 → 3.3.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 (83) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +1 -2
  3. package/dist/agents/{resolve.js → baseagent.js} +34 -5
  4. package/dist/agents/claude-runner.js +120 -27
  5. package/dist/agents/codex-app-server-client.js +364 -0
  6. package/dist/agents/codex-runner.js +1069 -141
  7. package/dist/agents/gemini-runner.js +2 -2
  8. package/dist/agents/runner-types.js +28 -0
  9. package/dist/aun/aid/store.js +1 -1
  10. package/dist/aun/storage/download.js +1 -1
  11. package/dist/aun/storage/upload.js +13 -1
  12. package/dist/channels/aun.js +406 -293
  13. package/dist/channels/dingtalk.js +77 -140
  14. package/dist/channels/feishu.js +97 -150
  15. package/dist/channels/qqbot.js +75 -138
  16. package/dist/channels/wechat.js +75 -136
  17. package/dist/channels/wecom.js +75 -138
  18. package/dist/cli/agent.js +8 -5
  19. package/dist/cli/index.js +177 -44
  20. package/dist/cli/init.js +33 -6
  21. package/dist/cli/model.js +1 -1
  22. package/dist/cli/stats.js +558 -0
  23. package/dist/cli/version.js +87 -0
  24. package/dist/cli/watch-msg.js +5 -2
  25. package/dist/config-store.js +12 -6
  26. package/dist/core/channel-loader.js +84 -82
  27. package/dist/core/command-handler.js +473 -114
  28. package/dist/core/evolagent-registry.js +1 -0
  29. package/dist/core/evolagent.js +1 -1
  30. package/dist/core/interaction-router.js +8 -0
  31. package/dist/core/message/command-handler-agent-control.js +63 -1
  32. package/dist/core/message/im-renderer.js +35 -13
  33. package/dist/core/message/items-formatter.js +9 -1
  34. package/dist/core/message/message-bridge.js +49 -21
  35. package/dist/core/message/message-log.js +1 -0
  36. package/dist/core/message/message-processor.js +295 -35
  37. package/dist/core/message/message-queue.js +2 -2
  38. package/dist/core/message/pending-hints.js +232 -0
  39. package/dist/core/message/response-depth.js +56 -0
  40. package/dist/core/model/model-catalog.js +1 -1
  41. package/dist/core/model/model-scope.js +2 -2
  42. package/dist/core/permission.js +9 -12
  43. package/dist/core/relation/peer-identity.js +16 -1
  44. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -2
  45. package/dist/core/session/session-manager.js +27 -13
  46. package/dist/core/session/session-title.js +26 -0
  47. package/dist/core/stats/billing.js +151 -0
  48. package/dist/core/stats/budget.js +93 -0
  49. package/dist/core/stats/db.js +314 -0
  50. package/dist/core/stats/eck-vars.js +84 -0
  51. package/dist/core/stats/index.js +10 -0
  52. package/dist/core/stats/normalizer.js +78 -0
  53. package/dist/core/stats/query.js +760 -0
  54. package/dist/core/stats/writer.js +115 -0
  55. package/dist/core/trigger/manager.js +34 -0
  56. package/dist/core/trigger/parser.js +9 -3
  57. package/dist/core/trigger/scheduler.js +20 -17
  58. package/dist/{agents → eck}/manifest-engine.js +20 -1
  59. package/dist/{agents → eck}/message-renderer.js +24 -1
  60. package/dist/index.js +130 -8
  61. package/dist/ipc.js +17 -1
  62. package/dist/utils/cross-platform.js +23 -5
  63. package/dist/utils/ecweb-pair.js +20 -0
  64. package/dist/utils/stats.js +14 -0
  65. package/kits/docs/evolclaw/INDEX.md +3 -1
  66. package/kits/docs/evolclaw/fs-architecture.md +1215 -0
  67. package/kits/docs/evolclaw/fs.md +131 -0
  68. package/kits/docs/evolclaw/group-fs.md +209 -0
  69. package/kits/docs/evolclaw/stats.md +70 -0
  70. package/kits/docs/venues/aun-group.md +29 -6
  71. package/kits/docs/venues/group.md +5 -4
  72. package/kits/eck_manifest.json +12 -0
  73. package/kits/eck_message_manifest.json +30 -3
  74. package/kits/rules/05-venue.md +1 -1
  75. package/kits/templates/message-fragments/inject-default.md +2 -0
  76. package/kits/templates/system-fragments/response-depth.md +16 -0
  77. package/package.json +4 -4
  78. package/dist/agents/baseagent-normalize.js +0 -19
  79. package/dist/core/relation/peer-key.js +0 -16
  80. package/dist/evolclaw-config.js +0 -11
  81. package/dist/utils/channel-helpers.js +0 -46
  82. /package/dist/core/{cache/file-cache.js → daemon-file-cache.js} +0 -0
  83. /package/dist/{agents → eck}/kit-renderer.js +0 -0
@@ -0,0 +1,232 @@
1
+ // 观察者插话:待用提示(pending-hints)存储。
2
+ //
3
+ // owner 经 observer.inject 给「agent↔对端」会话预埋的提示,落盘为 append-only jsonl,
4
+ // 在下一条对端消息到达、渲染该轮 prompt 时一次性消费、注入渲染层。
5
+ // 详见 docs/observer-insert-design.md 第一部分(§1.3 文件生命周期 / §1.4 thread 作用域)。
6
+ //
7
+ // 文件:sessions/<channelType>/<selfAID>/<对端>/pending-hints.jsonl(与 messages.jsonl 同级)
8
+ // 每行一个事件:
9
+ // { action:'add', id, text, threadId, ownerAid, ts }
10
+ // { action:'remove', targetId?, threadId, ts } // 无 targetId = 撤该 thread 全部
11
+ //
12
+ // 生命周期 = 一个消费周期(按 (对端,thread) 维度):
13
+ // - add/remove 追加行(append-only,处理「加了又撤」的竞态:按时间序回放抵消)
14
+ // - consume(对端消息到达触发):回放算「该 thread」有效集 → 返回 → 清掉该 thread 的事件。
15
+ // · 若文件里其它 thread 仍有未消费提示 → 重写文件只留它们(不误删别的 thread)。
16
+ // · 否则(无其它 thread 残留)→ 删整个文件。
17
+ // - 因为 consume 一次性用掉该 thread 的全部有效提示,消费后该 thread 有效集必然归零,
18
+ // 未来状态不依赖消费前历史,故消费即清安全,无需 consume 事件行。
19
+ // - 任何让「整文件」有效集归零的操作都删文件:consume 后无残留即删;remove 把提示全撤光也删。
20
+ import fs from 'fs';
21
+ import path from 'path';
22
+ import { chatDirPath, appendJsonl, readAllJsonlLines } from '../session/session-fs-store.js';
23
+ import { logger } from '../../utils/logger.js';
24
+ const PENDING_HINTS_FILE = 'pending-hints.jsonl';
25
+ function hintsPath(sessionsDir, channelType, channelId, selfAID) {
26
+ return path.join(chatDirPath(sessionsDir, channelType, channelId, selfAID), PENDING_HINTS_FILE);
27
+ }
28
+ /** 归一 threadId:undefined/null → ''(主线程)。 */
29
+ function normThread(threadId) {
30
+ return threadId || '';
31
+ }
32
+ /**
33
+ * 追加一条 add 事件。返回是否写盘成功(供 ack 判定)。
34
+ * 写盘成功后才回 ack(accepted)——accepted 真正代表"已持久保存"。
35
+ */
36
+ export function appendHintAdd(sessionsDir, channelType, channelId, selfAID, hint) {
37
+ try {
38
+ const fp = hintsPath(sessionsDir, channelType, channelId, selfAID);
39
+ fs.mkdirSync(path.dirname(fp), { recursive: true });
40
+ const ev = {
41
+ action: 'add', id: hint.id, text: hint.text,
42
+ threadId: normThread(hint.threadId), ownerAid: hint.ownerAid, ts: hint.ts,
43
+ };
44
+ appendJsonl(fp, ev);
45
+ return true;
46
+ }
47
+ catch (e) {
48
+ logger.warn(`[PendingHints] appendHintAdd failed: ${e instanceof Error ? e.message : String(e)}`);
49
+ return false;
50
+ }
51
+ }
52
+ /**
53
+ * 追加一条 remove 事件。若该操作使 (对端,thread) 有效集归零,则删除整个文件。
54
+ * 返回是否写盘成功(供 ack 判定)。
55
+ */
56
+ export function appendHintRemove(sessionsDir, channelType, channelId, selfAID, rm) {
57
+ try {
58
+ const fp = hintsPath(sessionsDir, channelType, channelId, selfAID);
59
+ if (!fs.existsSync(fp))
60
+ return true; // 无文件 = 无可撤,幂等成功
61
+ fs.mkdirSync(path.dirname(fp), { recursive: true });
62
+ const ev = {
63
+ action: 'remove', threadId: normThread(rm.threadId), ts: rm.ts,
64
+ ...(rm.targetId ? { targetId: rm.targetId } : {}),
65
+ };
66
+ appendJsonl(fp, ev);
67
+ // 撤销后:若全部 thread 的有效集都归零,删文件(不堆死文件)。
68
+ if (!hasAnyEffective(fp))
69
+ deleteFile(fp);
70
+ return true;
71
+ }
72
+ catch (e) {
73
+ logger.warn(`[PendingHints] appendHintRemove failed: ${e instanceof Error ? e.message : String(e)}`);
74
+ return false;
75
+ }
76
+ }
77
+ /** 回放整个文件,返回是否还存在任意 thread 的有效提示。 */
78
+ function hasAnyEffective(fp) {
79
+ const events = readAllJsonlLines(fp);
80
+ // 按 thread 分组回放
81
+ const byThread = new Map();
82
+ for (const ev of events) {
83
+ const t = normThread(ev.threadId);
84
+ (byThread.get(t) ?? byThread.set(t, []).get(t)).push(ev);
85
+ }
86
+ for (const [, evs] of byThread) {
87
+ if (replayEffective(evs).length > 0)
88
+ return true;
89
+ }
90
+ return false;
91
+ }
92
+ /** 对单个 thread 的事件序列回放,算出有效提示集(已 add、未被 remove,按 ts 升序)。 */
93
+ function replayEffective(events) {
94
+ const sorted = events.slice().sort((a, b) => a.ts - b.ts);
95
+ const active = new Map(); // id → hint,保插入序
96
+ for (const ev of sorted) {
97
+ if (ev.action === 'add') {
98
+ active.set(ev.id, { id: ev.id, text: ev.text, ownerAid: ev.ownerAid, ts: ev.ts });
99
+ }
100
+ else {
101
+ if (ev.targetId)
102
+ active.delete(ev.targetId);
103
+ else
104
+ active.clear(); // 无 targetId = 撤该 thread 全部
105
+ }
106
+ }
107
+ return [...active.values()].sort((a, b) => a.ts - b.ts);
108
+ }
109
+ /**
110
+ * 消费 (对端, thread) 的有效提示:回放算「该 thread」有效集 → 返回 → 清掉该 thread。
111
+ *
112
+ * thread 隔离:只消费传入 threadId(归一后)的提示。若文件里其它 thread 仍有未消费提示,
113
+ * 重写文件保留它们;只有当整文件再无任何有效提示时才删除文件。
114
+ * 返回空数组表示该 thread 无有效提示(调用方据此决定是否注入)。
115
+ */
116
+ export function consumeHints(sessionsDir, channelType, channelId, selfAID, threadId) {
117
+ const fp = hintsPath(sessionsDir, channelType, channelId, selfAID);
118
+ if (!fs.existsSync(fp))
119
+ return [];
120
+ let all;
121
+ try {
122
+ all = readAllJsonlLines(fp);
123
+ }
124
+ catch (e) {
125
+ logger.warn(`[PendingHints] consume read failed: ${e instanceof Error ? e.message : String(e)}`);
126
+ return [];
127
+ }
128
+ const wantThread = normThread(threadId);
129
+ const sameThread = all.filter(ev => normThread(ev.threadId) === wantThread);
130
+ const effective = replayEffective(sameThread);
131
+ // 其它 thread 仍有未消费提示?若有,重写文件只留它们;否则删整个文件。
132
+ const otherThreadEvents = all.filter(ev => normThread(ev.threadId) !== wantThread);
133
+ if (otherThreadEvents.length > 0 && hasEffectiveInEvents(otherThreadEvents)) {
134
+ rewriteFile(fp, otherThreadEvents);
135
+ }
136
+ else {
137
+ deleteFile(fp);
138
+ }
139
+ return effective;
140
+ }
141
+ /** events(可能跨多 thread)中是否存在任意有效提示。 */
142
+ function hasEffectiveInEvents(events) {
143
+ const byThread = new Map();
144
+ for (const ev of events) {
145
+ const t = normThread(ev.threadId);
146
+ (byThread.get(t) ?? byThread.set(t, []).get(t)).push(ev);
147
+ }
148
+ for (const [, evs] of byThread) {
149
+ if (replayEffective(evs).length > 0)
150
+ return true;
151
+ }
152
+ return false;
153
+ }
154
+ function rewriteFile(fp, events) {
155
+ try {
156
+ const body = events.map(e => JSON.stringify(e)).join('\n') + '\n';
157
+ fs.writeFileSync(fp, body);
158
+ }
159
+ catch (e) {
160
+ logger.warn(`[PendingHints] rewriteFile failed: ${e instanceof Error ? e.message : String(e)}`);
161
+ }
162
+ }
163
+ function deleteFile(fp) {
164
+ try {
165
+ if (fs.existsSync(fp))
166
+ fs.unlinkSync(fp);
167
+ }
168
+ catch (e) {
169
+ logger.warn(`[PendingHints] deleteFile failed: ${e instanceof Error ? e.message : String(e)}`);
170
+ }
171
+ }
172
+ /** 仅供 watch / 调试:读出当前 (对端,thread) 有效提示,不消费、不删文件。 */
173
+ export function peekHints(sessionsDir, channelType, channelId, selfAID, threadId) {
174
+ const fp = hintsPath(sessionsDir, channelType, channelId, selfAID);
175
+ if (!fs.existsSync(fp))
176
+ return [];
177
+ try {
178
+ const all = readAllJsonlLines(fp);
179
+ const wantThread = normThread(threadId);
180
+ return replayEffective(all.filter(ev => normThread(ev.threadId) === wantThread));
181
+ }
182
+ catch {
183
+ return [];
184
+ }
185
+ }
186
+ // ── 渲染接线纯函数(无 IO,便于单测) ──────────────────────────
187
+ /** 把有效提示转成 owner-hint SubMessage(排在对端真实 item 之前,走 inject 渲染模式)。 */
188
+ export function hintsToSubMessages(hints) {
189
+ return hints.map(h => ({
190
+ kind: 'owner-hint',
191
+ content: h.text,
192
+ ownerAid: h.ownerAid,
193
+ injectTime: h.ts,
194
+ timestamp: h.ts,
195
+ }));
196
+ }
197
+ /**
198
+ * 渲染失败兜底:把已消费的 owner-hint(提示已从 pending 删除、不可恢复)以纯文本前缀
199
+ * 拼到对端原文之前,避免提示被静默丢弃。仅在 renderMessageBody 抛错或产出空时使用。
200
+ */
201
+ export function composeHintFallback(hintItems, content) {
202
+ if (!hintItems || hintItems.length === 0)
203
+ return content;
204
+ const lines = hintItems.map(h => `‹owner 提示·已验证›(仅你可见,对端无感)\n${h.content}`);
205
+ return [...lines, content].join('\n\n');
206
+ }
207
+ /**
208
+ * 解析 observer.inject payload:鉴权(from∈owners)+ 校验(add 需 channel_id+text;remove 需 channel_id)
209
+ * + 归一字段。纯函数,无副作用——落盘 / ack / watch 由调用方按结果执行。
210
+ * @param ts 用于 add 缺省 id(`inj-<ts>`);由调用方传入便于测试确定性。
211
+ */
212
+ export function parseInjectRequest(payload, fromAid, owners, ts) {
213
+ const p = (payload && typeof payload === 'object') ? payload : {};
214
+ const injectId = typeof p.id === 'string' ? p.id : undefined;
215
+ const action = p.action === 'remove' ? 'remove' : 'add';
216
+ if (!owners.includes(fromAid)) {
217
+ return { kind: 'reject', code: 'NOT_OWNER', message: '仅 owner 可插话', action, injectId };
218
+ }
219
+ const target = (p.target && typeof p.target === 'object') ? p.target : undefined;
220
+ const channelId = target && typeof target.channel_id === 'string' ? target.channel_id : undefined;
221
+ const text = typeof p.text === 'string' ? p.text : '';
222
+ if (!channelId || (action === 'add' && !text.trim())) {
223
+ return { kind: 'reject', code: 'INVALID_TARGET', message: 'target.channel_id 必填;add 还需 text', action, injectId };
224
+ }
225
+ const chatType = target?.chat_type === 'group' ? 'group' : 'private';
226
+ const threadId = typeof target?.thread_id === 'string' ? target.thread_id : undefined;
227
+ const targetId = typeof p.target_id === 'string' ? p.target_id : undefined;
228
+ if (action === 'remove') {
229
+ return { kind: 'remove', injectId, channelId, chatType, threadId, targetId };
230
+ }
231
+ return { kind: 'add', injectId, id: injectId || `inj-${ts}`, text, channelId, chatType, threadId, ownerAid: fromAid };
232
+ }
@@ -0,0 +1,56 @@
1
+ import crypto from 'crypto';
2
+ /**
3
+ * 计算消息内容的话题指纹(前 20 字符的 md5 前 8 位)。
4
+ */
5
+ export function computeTopicHash(content) {
6
+ const slice = content.trim().slice(0, 20);
7
+ return crypto.createHash('md5').update(slice).digest('hex').slice(0, 8);
8
+ }
9
+ /**
10
+ * 群聊响应深度决策(纯函数,无 I/O)。
11
+ *
12
+ * 根据 dispatch 模式、消息特征(长度/是否问句/是否被@)、话题轮次综合判断。
13
+ * 返回 depth 枚举 + 更新后的话题追踪状态(调用方负责持久化)。
14
+ */
15
+ export function resolveResponseDepth(input) {
16
+ const { chatType, content, selfAid, mentionAids, dispatch, topicRounds: prevRounds, lastTopicHash } = input;
17
+ // 仅群聊走深度决策;私聊一律 standard
18
+ if (chatType !== 'group') {
19
+ return { depth: 'standard', topicRounds: prevRounds, topicHash: lastTopicHash || '' };
20
+ }
21
+ const trimmed = content.trim();
22
+ // ── 话题追踪:更新 topicRounds ──
23
+ const topicHash = computeTopicHash(trimmed);
24
+ let topicRounds;
25
+ if (lastTopicHash && lastTopicHash === topicHash) {
26
+ topicRounds = prevRounds + 1;
27
+ }
28
+ else {
29
+ topicRounds = 1;
30
+ }
31
+ // ── 判断因子 ──
32
+ const isMentioned = !!(selfAid && mentionAids?.includes(selfAid));
33
+ const isQuestion = /[??]\s*$/.test(trimmed) || /^(what|how|why|when|where|who|which|请问|怎么|为什么|什么|如何|能不能|可以)/i.test(trimmed);
34
+ const isShort = trimmed.length <= 30;
35
+ // ── 决策逻辑 ──
36
+ // 被@:至少 standard;话题深入则升 deep
37
+ if (isMentioned) {
38
+ const depth = topicRounds >= 3 ? 'deep' : 'standard';
39
+ return { depth, topicRounds, topicHash };
40
+ }
41
+ // broadcast 模式:短消息 + 非问句 → lightweight
42
+ if (dispatch === 'broadcast') {
43
+ let depth;
44
+ if (topicRounds >= 3)
45
+ depth = 'deep';
46
+ else if (isShort && !isQuestion)
47
+ depth = 'lightweight';
48
+ else
49
+ depth = 'standard';
50
+ return { depth, topicRounds, topicHash };
51
+ }
52
+ // mention 模式下到达这里说明已通过 dispatch 过滤(被@才入队),
53
+ // 等同于 isMentioned === true 的分支。兜底 standard。
54
+ const depth = topicRounds >= 3 ? 'deep' : 'standard';
55
+ return { depth, topicRounds, topicHash };
56
+ }
@@ -10,7 +10,7 @@
10
10
  * 详见 docs/model-command-design.md。
11
11
  */
12
12
  import { loadDefaults, loadAgent } from '../../config-store.js';
13
- import { resolveAnthropicConfig, resolveOpenaiConfig } from '../../agents/resolve.js';
13
+ import { resolveAnthropicConfig, resolveOpenaiConfig } from '../../agents/baseagent.js';
14
14
  import { activeBaseagent } from './model-scope.js';
15
15
  /** 取指定 baseagent 的 baseUrl + apiKey(复用现有解析链)。 */
16
16
  function resolveCreds(self, ba) {
@@ -18,8 +18,8 @@ import fs from 'fs';
18
18
  import path from 'path';
19
19
  import { agentRelationsDir, agentConfig as agentConfigPath, resolvePaths } from '../../paths.js';
20
20
  import { loadDefaults, saveDefaultsSafe, loadAgent, saveAgent } from '../../config-store.js';
21
- import { formatPeerKey, parsePeerKey } from '../relation/peer-key.js';
22
- import { fileCache } from '../cache/file-cache.js';
21
+ import { formatPeerKey, parsePeerKey } from '../relation/peer-identity.js';
22
+ import { fileCache } from '../daemon-file-cache.js';
23
23
  // ── mtime 门控缓存(统一走 FileCache)─────────────────────────────────────
24
24
  //
25
25
  // resolveEffectiveModel 每条消息按 关系>agent>全局 解析,原本每次都
@@ -217,7 +217,6 @@ function formatEditSummary(input) {
217
217
  }
218
218
  export class PermissionGateway {
219
219
  pending = new Map();
220
- timeout = 5 * 60 * 1000;
221
220
  eventBus;
222
221
  /** 始终允许的工具缓存:toolName → Set<pattern> */
223
222
  alwaysAllow = new Map();
@@ -283,6 +282,14 @@ export class PermissionGateway {
283
282
  };
284
283
  // 尝试富交互(走统一 adapter.send 入口)
285
284
  let interactionSent = false;
285
+ if (context?.flushPending) {
286
+ try {
287
+ await context.flushPending();
288
+ }
289
+ catch {
290
+ // flush 失败不应阻断权限请求发送
291
+ }
292
+ }
286
293
  if (context?.adapter && context.channelId) {
287
294
  try {
288
295
  const envelope = buildEnvelope({
@@ -306,15 +313,7 @@ export class PermissionGateway {
306
313
  await sendPrompt(renderActionAsText(interaction));
307
314
  }
308
315
  return new Promise((resolve) => {
309
- const timer = setTimeout(() => {
310
- const pending = this.pending.get(requestId);
311
- if (!pending)
312
- return;
313
- this.pending.delete(requestId);
314
- this.eventBus?.publish({ type: 'permission:timeout', sessionId, requestId, toolName });
315
- pending.resolve('deny');
316
- }, this.timeout);
317
- this.pending.set(requestId, { sessionId, toolName, resolve, timer });
316
+ this.pending.set(requestId, { sessionId, toolName, resolve });
318
317
  // 注册到 InteractionRouter(卡片和文本降级都注册,统一路由)
319
318
  if (context?.interactionRouter) {
320
319
  context.interactionRouter.register(requestId, sessionId, (action) => {
@@ -327,7 +326,6 @@ export class PermissionGateway {
327
326
  const pending = this.pending.get(requestId);
328
327
  if (!pending || pending.sessionId !== sessionId)
329
328
  return false;
330
- clearTimeout(pending.timer);
331
329
  // 如果是 always,缓存该工具
332
330
  if (decision === 'always') {
333
331
  this.addAlwaysAllow(pending.toolName);
@@ -341,7 +339,6 @@ export class PermissionGateway {
341
339
  cancelAll(sessionId) {
342
340
  for (const [requestId, pending] of this.pending.entries()) {
343
341
  if (pending.sessionId === sessionId) {
344
- clearTimeout(pending.timer);
345
342
  pending.resolve('deny');
346
343
  this.pending.delete(requestId);
347
344
  }
@@ -15,7 +15,22 @@ import * as path from 'path';
15
15
  import * as crypto from 'crypto';
16
16
  import { logger } from '../../utils/logger.js';
17
17
  import { agentMdPath } from '../../paths.js';
18
- import { formatPeerKey } from './peer-key.js';
18
+ /**
19
+ * peerKey: 关系层路由键,格式 `<channelType>#<urlEncode(channelId)>`。
20
+ * 群聊场景下 channelId = groupId,所有发言者共用同一个 peerKey。
21
+ */
22
+ export function formatPeerKey(channelType, channelId) {
23
+ return `${channelType}#${encodeURIComponent(channelId)}`;
24
+ }
25
+ export function parsePeerKey(key) {
26
+ const idx = key.indexOf('#');
27
+ if (idx <= 0)
28
+ throw new Error(`Invalid peer key: ${key}`);
29
+ return {
30
+ channelType: key.slice(0, idx),
31
+ channelId: decodeURIComponent(key.slice(idx + 1)),
32
+ };
33
+ }
19
34
  /**
20
35
  * 对端身份缓存管理器
21
36
  */
@@ -10,12 +10,14 @@
10
10
  * 会返回空数组。
11
11
  */
12
12
  import { createRequire } from 'module';
13
+ import { sanitizeSessionTitle } from '../session-title.js';
13
14
  import { logger } from '../../../utils/logger.js';
14
15
  import path from 'path';
15
16
  import fs from 'fs';
16
17
  import os from 'os';
17
18
  const requireFromHere = createRequire(import.meta.url);
18
19
  let sqliteModule; // undefined = not tried, null = unavailable
20
+ export const sanitizeCodexThreadTitle = sanitizeSessionTitle;
19
21
  function loadSqlite() {
20
22
  if (sqliteModule !== undefined)
21
23
  return sqliteModule;
@@ -127,7 +129,7 @@ export class CodexSessionFileAdapter {
127
129
  if (row) {
128
130
  return {
129
131
  turns: this.countTurnsFromRollout(row.rollout_path),
130
- title: row.title || undefined,
132
+ title: sanitizeCodexThreadTitle(row.title),
131
133
  };
132
134
  }
133
135
  }
@@ -210,7 +212,7 @@ export class CodexSessionFileAdapter {
210
212
  const rows = db.prepare('SELECT id, title FROM threads WHERE cwd = ? AND archived = 0 ORDER BY updated_at DESC').all(projectPath);
211
213
  return rows.map(r => ({
212
214
  sessionId: r.id,
213
- title: r.title || undefined,
215
+ title: sanitizeCodexThreadTitle(r.title),
214
216
  }));
215
217
  }
216
218
  catch (error) {
@@ -69,6 +69,9 @@ export class SessionManager {
69
69
  return { role: 'admin', mode: 'interactive' };
70
70
  return { role: 'guest', mode: 'interactive' };
71
71
  }
72
+ resolvePermissionMode(role) {
73
+ return (role === 'owner' || role === 'admin') ? 'bypass' : 'readonly';
74
+ }
72
75
  async updateIdentity(sessionId, identity) {
73
76
  logger.debug(`[SessionManager] updateIdentity: sessionId=${sessionId}, role=${identity.role}`);
74
77
  }
@@ -479,10 +482,10 @@ export class SessionManager {
479
482
  throw new Error(`[SessionManager] getOrCreateSession requires channelType. channel="${channel}" channelId="${channelId}"`);
480
483
  }
481
484
  if (threadId) {
482
- const session = this.getOrCreateThreadSession(channel, channelId, threadId, defaultProjectPath, metadata, name, agentId, selfAID, channelType, peerType);
485
+ const session = this.getOrCreateThreadSession(channel, channelId, threadId, defaultProjectPath, metadata, name, agentId, selfAID, channelType, peerType, chatType);
483
486
  session.identity = this.resolveIdentity(channel, userId);
484
487
  if (session.metadata && !session.metadata.permissionMode) {
485
- session.metadata.permissionMode = DEFAULT_PERMISSION_MODE;
488
+ session.metadata.permissionMode = this.resolvePermissionMode(session.identity.role);
486
489
  this.persistSession(session, 'none');
487
490
  }
488
491
  return session;
@@ -564,8 +567,9 @@ export class SessionManager {
564
567
  }
565
568
  // Create new session
566
569
  const sessionMetadata = { ...(metadata || {}) };
570
+ const newIdentity = this.resolveIdentity(channel, userId);
567
571
  if (!sessionMetadata.permissionMode)
568
- sessionMetadata.permissionMode = DEFAULT_PERMISSION_MODE;
572
+ sessionMetadata.permissionMode = this.resolvePermissionMode(newIdentity.role);
569
573
  const session = {
570
574
  id: generateSessionId(),
571
575
  channel,
@@ -583,7 +587,7 @@ export class SessionManager {
583
587
  createdAt: Date.now(),
584
588
  updatedAt: Date.now(),
585
589
  };
586
- session.identity = this.resolveIdentity(channel, userId);
590
+ session.identity = newIdentity;
587
591
  this.persistSession(session, 'set');
588
592
  this.eventBus.publish({
589
593
  type: 'session:created',
@@ -614,7 +618,7 @@ export class SessionManager {
614
618
  current.agentSessionId = updates.agentSessionId ?? undefined;
615
619
  this.persistSession(current, 'sync');
616
620
  }
617
- getOrCreateThreadSession(channel, channelId, threadId, defaultProjectPath, metadata, name, agentId, selfAID, channelType, peerType) {
621
+ getOrCreateThreadSession(channel, channelId, threadId, defaultProjectPath, metadata, name, agentId, selfAID, channelType, peerType, chatType) {
618
622
  // 使用精确路径(channelType + selfAID)
619
623
  const chatDir = (channelType && selfAID)
620
624
  ? (() => { const d = chatDirPath(this.sessionsDir, channelType, channelId, selfAID); fs.mkdirSync(d, { recursive: true }); fs.mkdirSync(path.join(d, '_threads'), { recursive: true }); return d; })()
@@ -627,18 +631,22 @@ export class SessionManager {
627
631
  if (existing) {
628
632
  const validSessionId = this.validateSessionFile(existing);
629
633
  if (metadata) {
634
+ const creatorPeerId = existing.metadata?.peerId;
630
635
  existing.metadata = { ...(existing.metadata || {}), ...metadata };
636
+ if (creatorPeerId && existing.metadata)
637
+ existing.metadata.peerId = creatorPeerId;
631
638
  this.persistSession(existing, 'none');
632
639
  }
633
640
  return { ...existing, agentSessionId: validSessionId };
634
641
  }
635
642
  }
636
- // Inherit project path & chatType from active main session
637
- const activeMain = this.readActive(channel, channelId, channelType, selfAID);
638
- const projectPath = (activeMain && !activeMain.threadId ? activeMain.projectPath : undefined) || defaultProjectPath;
639
- const inheritedChatType = (activeMain && !activeMain.threadId ? activeMain.chatType : undefined) || 'private';
643
+ const projectPath = defaultProjectPath;
644
+ const effectiveChatType = chatType || 'private';
640
645
  const effectiveChannelType = channelType || channel;
641
646
  const sessionKey = formatSessionKey(effectiveChannelType, channelId, threadId);
647
+ // 继承主会话的 agentId(话题会话从属于主会话,应沿用相同 backend)
648
+ const mainActive = readJsonFile(path.join(chatDir, 'active.json'));
649
+ const inheritedAgentId = agentId || mainActive?.agentType || 'claude';
642
650
  const session = {
643
651
  id: generateSessionId(),
644
652
  channel,
@@ -647,10 +655,10 @@ export class SessionManager {
647
655
  selfAID: selfAID || '',
648
656
  projectPath,
649
657
  threadId,
650
- agentId: agentId || 'claude',
658
+ agentId: inheritedAgentId,
651
659
  sessionKey,
652
- chatType: inheritedChatType,
653
- sessionMode: this.resolveDefaultSessionMode(channel, inheritedChatType, peerType),
660
+ chatType: effectiveChatType,
661
+ sessionMode: this.resolveDefaultSessionMode(channel, effectiveChatType, peerType),
654
662
  metadata,
655
663
  name: name || '话题会话',
656
664
  createdAt: Date.now(),
@@ -1024,11 +1032,17 @@ export class SessionManager {
1024
1032
  const existingDir = this.findExistingChatDir(channel, channelId);
1025
1033
  let channelType = channel;
1026
1034
  let selfAID = '';
1035
+ let inheritedRole = 'guest';
1027
1036
  if (existingDir) {
1028
1037
  const active = readJsonFile(path.join(existingDir, 'active.json'));
1029
1038
  if (active) {
1030
1039
  channelType = active.channelType || channel;
1031
1040
  selfAID = active.selfAID || '';
1041
+ // 从现有 session 的 permissionMode 反推 role,bypass→owner,其余→guest
1042
+ if (active.permissionMode === 'bypass')
1043
+ inheritedRole = 'owner';
1044
+ if (!agentId && active.agentType)
1045
+ agentId = active.agentType;
1032
1046
  }
1033
1047
  }
1034
1048
  const session = {
@@ -1043,7 +1057,7 @@ export class SessionManager {
1043
1057
  sessionKey: formatSessionKey(channelType, channelId, DEFAULT_THREAD_ID),
1044
1058
  chatType: inheritedChatType,
1045
1059
  sessionMode: this.resolveDefaultSessionMode(channel, inheritedChatType),
1046
- metadata: { permissionMode: DEFAULT_PERMISSION_MODE },
1060
+ metadata: { permissionMode: this.resolvePermissionMode(inheritedRole) },
1047
1061
  name: name || '默认会话',
1048
1062
  createdAt: Date.now(),
1049
1063
  updatedAt: Date.now(),
@@ -0,0 +1,26 @@
1
+ const SYSTEM_PROMPT_MARKERS = [
2
+ '--- [SYSTEM_PROMPT_END] ---',
3
+ '<system-reminder>',
4
+ 'EvolClaw Context Kit documents are shown below.',
5
+ ];
6
+ const MESSAGE_ROUTE_PREFIX_RE = /^‹[^›]*·\s*from:[^›]*→\s*self:[^›]*›\s*/;
7
+ export function sanitizeSessionTitle(title) {
8
+ if (typeof title !== 'string')
9
+ return undefined;
10
+ let cleanTitle = title;
11
+ for (const marker of SYSTEM_PROMPT_MARKERS) {
12
+ const markerIndex = cleanTitle.indexOf(marker);
13
+ if (markerIndex >= 0) {
14
+ cleanTitle = cleanTitle.slice(0, markerIndex);
15
+ }
16
+ }
17
+ cleanTitle = cleanTitle.trim().replace(MESSAGE_ROUTE_PREFIX_RE, '').replace(/\s+/g, ' ');
18
+ if (!cleanTitle)
19
+ return undefined;
20
+ if (/^\.+$/.test(cleanTitle))
21
+ return undefined;
22
+ return cleanTitle.length > 80 ? `${cleanTitle.slice(0, 80)}...` : cleanTitle;
23
+ }
24
+ export function displaySessionTitle(title, fallback = '默认会话') {
25
+ return sanitizeSessionTitle(title) || sanitizeSessionTitle(fallback) || fallback;
26
+ }