@dabuliu_wsy/dsh-im 0.0.0-stage → 0.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 (145) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +204 -3
  3. package/cordis.patch.yml +4 -0
  4. package/dist/core/agent-state.d.ts +38 -0
  5. package/dist/core/agent-state.js +59 -0
  6. package/dist/core/arbiter-bridge.d.ts +25 -0
  7. package/dist/core/arbiter-bridge.js +20 -0
  8. package/dist/core/arbiter.d.ts +29 -0
  9. package/dist/core/arbiter.js +59 -0
  10. package/dist/core/avatar-brands.d.ts +23 -0
  11. package/dist/core/avatar-brands.js +75 -0
  12. package/dist/core/avatar-presets.d.ts +21 -0
  13. package/dist/core/avatar-presets.js +38 -0
  14. package/dist/core/avatar.d.ts +1 -0
  15. package/dist/core/avatar.js +18 -0
  16. package/dist/core/blocked.d.ts +12 -0
  17. package/dist/core/blocked.js +23 -0
  18. package/dist/core/budget-plan.d.ts +41 -0
  19. package/dist/core/budget-plan.js +69 -0
  20. package/dist/core/calibration-samples.d.ts +77 -0
  21. package/dist/core/calibration-samples.js +168 -0
  22. package/dist/core/calibrator.d.ts +57 -0
  23. package/dist/core/calibrator.js +125 -0
  24. package/dist/core/chapter-tree.d.ts +128 -0
  25. package/dist/core/chapter-tree.js +400 -0
  26. package/dist/core/consensus.d.ts +135 -0
  27. package/dist/core/consensus.js +394 -0
  28. package/dist/core/context-budget.d.ts +153 -0
  29. package/dist/core/context-budget.js +183 -0
  30. package/dist/core/curator.d.ts +28 -0
  31. package/dist/core/curator.js +190 -0
  32. package/dist/core/dual-window.d.ts +86 -0
  33. package/dist/core/dual-window.js +175 -0
  34. package/dist/core/events.d.ts +110 -0
  35. package/dist/core/events.js +117 -0
  36. package/dist/core/facts.d.ts +114 -0
  37. package/dist/core/facts.js +400 -0
  38. package/dist/core/fence.d.ts +34 -0
  39. package/dist/core/fence.js +129 -0
  40. package/dist/core/floor.d.ts +18 -0
  41. package/dist/core/floor.js +80 -0
  42. package/dist/core/ids.d.ts +11 -0
  43. package/dist/core/ids.js +29 -0
  44. package/dist/core/im.d.ts +213 -0
  45. package/dist/core/im.js +1640 -0
  46. package/dist/core/index.d.ts +34 -0
  47. package/dist/core/index.js +34 -0
  48. package/dist/core/log.d.ts +21 -0
  49. package/dist/core/log.js +63 -0
  50. package/dist/core/memory-claims.d.ts +67 -0
  51. package/dist/core/memory-claims.js +164 -0
  52. package/dist/core/memory-context.d.ts +121 -0
  53. package/dist/core/memory-context.js +303 -0
  54. package/dist/core/memory-visibility.d.ts +58 -0
  55. package/dist/core/memory-visibility.js +36 -0
  56. package/dist/core/memory.d.ts +12 -0
  57. package/dist/core/memory.js +73 -0
  58. package/dist/core/metrics.d.ts +49 -0
  59. package/dist/core/metrics.js +89 -0
  60. package/dist/core/multi-hop.d.ts +116 -0
  61. package/dist/core/multi-hop.js +278 -0
  62. package/dist/core/persist.d.ts +21 -0
  63. package/dist/core/persist.js +94 -0
  64. package/dist/core/proactive.d.ts +54 -0
  65. package/dist/core/proactive.js +108 -0
  66. package/dist/core/prompt.d.ts +82 -0
  67. package/dist/core/prompt.js +164 -0
  68. package/dist/core/receipt.d.ts +107 -0
  69. package/dist/core/receipt.js +86 -0
  70. package/dist/core/retrieval.d.ts +69 -0
  71. package/dist/core/retrieval.js +260 -0
  72. package/dist/core/role-state.d.ts +16 -0
  73. package/dist/core/role-state.js +65 -0
  74. package/dist/core/runtime.d.ts +137 -0
  75. package/dist/core/runtime.js +574 -0
  76. package/dist/core/summary.d.ts +19 -0
  77. package/dist/core/summary.js +96 -0
  78. package/dist/core/text.d.ts +10 -0
  79. package/dist/core/text.js +45 -0
  80. package/dist/core/time.d.ts +22 -0
  81. package/dist/core/time.js +84 -0
  82. package/dist/core/tool-schema.d.ts +12 -0
  83. package/dist/core/tool-schema.js +92 -0
  84. package/dist/core/tools.d.ts +137 -0
  85. package/dist/core/tools.js +348 -0
  86. package/dist/core/trash.d.ts +110 -0
  87. package/dist/core/trash.js +56 -0
  88. package/dist/core/types.d.ts +400 -0
  89. package/dist/core/types.js +1 -0
  90. package/dist/core/window.d.ts +6 -0
  91. package/dist/core/window.js +7 -0
  92. package/dist/core/workspace-node.d.ts +28 -0
  93. package/dist/core/workspace-node.js +232 -0
  94. package/dist/core/workspace.d.ts +9 -0
  95. package/dist/core/workspace.js +45 -0
  96. package/dist/host/agent-session.d.ts +296 -0
  97. package/dist/host/agent-session.js +964 -0
  98. package/dist/host/attachment-gc.d.ts +37 -0
  99. package/dist/host/attachment-gc.js +97 -0
  100. package/dist/host/calibration-samples-store.d.ts +5 -0
  101. package/dist/host/calibration-samples-store.js +67 -0
  102. package/dist/host/capabilities.d.ts +45 -0
  103. package/dist/host/capabilities.js +67 -0
  104. package/dist/host/derived-store.d.ts +36 -0
  105. package/dist/host/derived-store.js +199 -0
  106. package/dist/host/dsh-llm.d.ts +143 -0
  107. package/dist/host/dsh-llm.js +395 -0
  108. package/dist/host/event-store.d.ts +47 -0
  109. package/dist/host/event-store.js +154 -0
  110. package/dist/host/fs-atomic.d.ts +1 -0
  111. package/dist/host/fs-atomic.js +26 -0
  112. package/dist/host/group-files.d.ts +26 -0
  113. package/dist/host/group-files.js +142 -0
  114. package/dist/host/im-api.d.ts +408 -0
  115. package/dist/host/im-api.js +1188 -0
  116. package/dist/host/index.d.ts +103 -0
  117. package/dist/host/index.js +509 -0
  118. package/dist/host/media-type.d.ts +10 -0
  119. package/dist/host/media-type.js +39 -0
  120. package/dist/host/memory-index.d.ts +65 -0
  121. package/dist/host/memory-index.js +181 -0
  122. package/dist/host/metrics-store.d.ts +7 -0
  123. package/dist/host/metrics-store.js +104 -0
  124. package/dist/host/models.d.ts +39 -0
  125. package/dist/host/models.js +67 -0
  126. package/dist/host/persona-tools.d.ts +57 -0
  127. package/dist/host/persona-tools.js +226 -0
  128. package/dist/host/preflight.d.ts +31 -0
  129. package/dist/host/preflight.js +29 -0
  130. package/dist/host/receipt-store.d.ts +26 -0
  131. package/dist/host/receipt-store.js +68 -0
  132. package/dist/host/run-check.d.ts +51 -0
  133. package/dist/host/run-check.js +190 -0
  134. package/dist/host/state-roots.d.ts +50 -0
  135. package/dist/host/state-roots.js +163 -0
  136. package/dist/host/tool-cache.d.ts +25 -0
  137. package/dist/host/tool-cache.js +90 -0
  138. package/dist/host/tool-call-budget.d.ts +29 -0
  139. package/dist/host/tool-call-budget.js +38 -0
  140. package/dist/host/trash-store.d.ts +32 -0
  141. package/dist/host/trash-store.js +316 -0
  142. package/dsh-plugin.json +25 -0
  143. package/lib/client.inner.cjs +3933 -0
  144. package/lib/client.js +3941 -0
  145. package/package.json +86 -6
@@ -0,0 +1,65 @@
1
+ import { type MemoryClaimState } from '../core/memory-claims.ts';
2
+ import type { ConsensusState } from '../core/consensus.ts';
3
+ import { type ChatEvent } from '../core/events.ts';
4
+ export declare const MEMORY_INDEX_SCHEMA = 1;
5
+ /** 单群索引条目上限:超过就拒绝构建(不静默截断,避免"可寻址"变成"部分可寻址")。 */
6
+ export declare const INDEX_MAX_ENTRIES = 50000;
7
+ /** 增量条目超过已有条目的这个比例时改为全量重建。 */
8
+ export declare const INDEX_REBUILD_DELTA_RATIO = 0.5;
9
+ /** 兼容旧引用:指令性语句正则现在定义在 core(客户端也要用)。 */
10
+ export declare const INDEX_IMPERATIVE: RegExp;
11
+ export interface MemoryIndexEntry {
12
+ seq: number;
13
+ at: number;
14
+ actorName: string;
15
+ actorId?: string;
16
+ /** 话题段号 = 该段首条用户消息的 seq(0 = 尚无用户消息)。 */
17
+ topicId: number;
18
+ claim: MemoryClaimState;
19
+ successorSeq?: number;
20
+ /** 正文指纹(正文不复制;展开时回 events.jsonl 取)。 */
21
+ textHash: string;
22
+ textLen: number;
23
+ untrusted: boolean;
24
+ imperative: boolean;
25
+ }
26
+ export interface MemoryIndexCursor {
27
+ lastSeq: number;
28
+ lastTopicId: number;
29
+ sourceSize: number;
30
+ builtAt: number;
31
+ rebuilds: number;
32
+ dirtySeqs: number[];
33
+ }
34
+ export interface MemoryIndex {
35
+ schema: number;
36
+ threadId: string;
37
+ entries: MemoryIndexEntry[];
38
+ cursor: MemoryIndexCursor;
39
+ stats: {
40
+ messages: number;
41
+ topics: number;
42
+ active: number;
43
+ superseded: number;
44
+ raw: number;
45
+ untrusted: number;
46
+ imperative: number;
47
+ };
48
+ }
49
+ export declare function memoryIndexPath(root: string, threadId: string): string;
50
+ export declare function loadMemoryIndex(root: string, threadId: string): Promise<MemoryIndex | null>;
51
+ export interface BuildIndexOptions {
52
+ force?: boolean;
53
+ consensus?: ConsensusState;
54
+ now?: number;
55
+ /** 是否落盘(默认 true;诊断预览传 false)。 */
56
+ persist?: boolean;
57
+ }
58
+ export interface BuildIndexResult {
59
+ index: MemoryIndex;
60
+ rebuilt: boolean;
61
+ reason: string;
62
+ }
63
+ export declare function buildMemoryIndex(root: string, threadId: string, options?: BuildIndexOptions): Promise<BuildIndexResult>;
64
+ /** 按 seq 取回原文(expand 路径)。正文只从 events.jsonl 取,索引不复制正文。 */
65
+ export declare function resolveMemoryMessages(root: string, threadId: string, seqs: readonly number[]): Promise<Map<number, ChatEvent>>;
@@ -0,0 +1,181 @@
1
+ /**
2
+ * 可寻址记忆层 · 消息索引投影(Phase 0)。
3
+ *
4
+ * 定位:`events.jsonl` 是唯一事实源,本索引是它的**派生投影**,回答
5
+ * 「某条消息在哪个话题段、有没有 claim 状态、要不要按不可信输入处理」,
6
+ * 让"冷区可寻址"成立:prompt 里放目录/句柄,正文需要时再按 seq 取回。
7
+ *
8
+ * 三条设计约束:
9
+ * 1. **不复制正文**:只存 `textHash + textLen`,展开时从 events.jsonl 取——索引丢了随时可重建,
10
+ * 不会变成第二份真相;
11
+ * 2. **增量游标**:`lastSeq + lastTopicId + sourceSize`;文件变小/条目对不上/增量过大 → 全量重建;
12
+ * 3. **弱状态预计算 + 脏区重算**:claim 状态(active/superseded/raw)来自 fact/consensus,
13
+ * 每次构建只重写「本次有 claim 或上次有 claim」的条目(`dirtySeqs`)。
14
+ *
15
+ * Phase 0 只建索引并写入回执/诊断,**不接 prompt**(零行为变更)。
16
+ */
17
+ import { readFile, stat } from 'node:fs/promises';
18
+ import { join } from 'node:path';
19
+ import { stableHash } from '../core/receipt.js';
20
+ import { assertSafeThreadId } from '../core/workspace.js';
21
+ import { applyClaimStatuses, deriveClaimStatuses, MEMORY_IMPERATIVE } from '../core/memory-claims.js';
22
+ import { isChatEvent } from '../core/events.js';
23
+ import { eventsPath, groupDir, readEvents } from './event-store.js';
24
+ import { writeFileAtomic } from './fs-atomic.js';
25
+ import { logWarn } from '../core/log.js';
26
+ export const MEMORY_INDEX_SCHEMA = 1;
27
+ /** 单群索引条目上限:超过就拒绝构建(不静默截断,避免"可寻址"变成"部分可寻址")。 */
28
+ export const INDEX_MAX_ENTRIES = 50_000;
29
+ /** 增量条目超过已有条目的这个比例时改为全量重建。 */
30
+ export const INDEX_REBUILD_DELTA_RATIO = 0.5;
31
+ /** 兼容旧引用:指令性语句正则现在定义在 core(客户端也要用)。 */
32
+ export const INDEX_IMPERATIVE = MEMORY_IMPERATIVE;
33
+ export function memoryIndexPath(root, threadId) {
34
+ return join(groupDir(root, threadId), 'index.json');
35
+ }
36
+ function toEntry(event, topicId) {
37
+ return {
38
+ seq: event.seq,
39
+ at: event.at,
40
+ actorName: event.actorName,
41
+ ...(event.actorId === undefined ? {} : { actorId: event.actorId }),
42
+ topicId,
43
+ claim: 'raw',
44
+ textHash: stableHash(event.text ?? '').split(':').at(-1) ?? '',
45
+ textLen: (event.text ?? '').length,
46
+ untrusted: event.untrusted ?? true,
47
+ imperative: MEMORY_IMPERATIVE.test(event.text ?? ''),
48
+ };
49
+ }
50
+ function deriveEntries(events) {
51
+ let topicId = 0;
52
+ const entries = [];
53
+ for (const event of events) {
54
+ if (!isChatEvent(event))
55
+ continue;
56
+ if (event.kind === 'user')
57
+ topicId = event.seq;
58
+ entries.push(toEntry(event, topicId));
59
+ }
60
+ return { entries, lastTopicId: topicId };
61
+ }
62
+ export async function loadMemoryIndex(root, threadId) {
63
+ let raw;
64
+ try {
65
+ raw = await readFile(memoryIndexPath(root, threadId), 'utf8');
66
+ }
67
+ catch (error) {
68
+ if (error.code === 'ENOENT')
69
+ return null;
70
+ throw error;
71
+ }
72
+ try {
73
+ const parsed = JSON.parse(raw);
74
+ if (parsed?.schema !== MEMORY_INDEX_SCHEMA)
75
+ return null;
76
+ if (!Array.isArray(parsed.entries) || typeof parsed.cursor?.lastSeq !== 'number')
77
+ return null;
78
+ return parsed;
79
+ }
80
+ catch {
81
+ logWarn('[dsh-im] 记忆索引损坏,将重建', { threadId });
82
+ return null;
83
+ }
84
+ }
85
+ export async function buildMemoryIndex(root, threadId, options = {}) {
86
+ assertSafeThreadId(threadId);
87
+ const events = await readEvents(root, threadId);
88
+ const chatEvents = events.filter(isChatEvent);
89
+ if (chatEvents.length > INDEX_MAX_ENTRIES) {
90
+ throw Object.assign(new Error(`会话 ${threadId} 消息数 ${chatEvents.length} 超过索引上限 ${INDEX_MAX_ENTRIES},需要先做分片`), { code: 'INDEX_TOO_LARGE' });
91
+ }
92
+ let sourceSize = 0;
93
+ try {
94
+ sourceSize = (await stat(eventsPath(root, threadId))).size;
95
+ }
96
+ catch {
97
+ sourceSize = 0;
98
+ }
99
+ const previous = await loadMemoryIndex(root, threadId);
100
+ const reasons = [];
101
+ if (!previous)
102
+ reasons.push('no-index');
103
+ else if (previous.threadId !== threadId)
104
+ reasons.push('thread-changed');
105
+ else {
106
+ if (sourceSize < previous.cursor.sourceSize)
107
+ reasons.push('source-shrank');
108
+ const lastIndexed = previous.cursor.lastSeq;
109
+ if (chatEvents.length && chatEvents[chatEvents.length - 1].seq < lastIndexed)
110
+ reasons.push('seq-rewind');
111
+ if (previous.entries.length && chatEvents.length < previous.entries.length)
112
+ reasons.push('entries-shrunk');
113
+ const freshCount = chatEvents.filter((event) => event.seq > lastIndexed).length;
114
+ if (freshCount > Math.max(1, previous.entries.length) * INDEX_REBUILD_DELTA_RATIO)
115
+ reasons.push('delta-too-large');
116
+ }
117
+ if (options.force)
118
+ reasons.push('forced');
119
+ const rebuilt = reasons.length > 0;
120
+ let entries;
121
+ let lastTopicId;
122
+ if (rebuilt || !previous) {
123
+ const derived = deriveEntries(chatEvents);
124
+ entries = derived.entries;
125
+ lastTopicId = derived.lastTopicId;
126
+ }
127
+ else {
128
+ entries = [...previous.entries];
129
+ lastTopicId = previous.cursor.lastTopicId;
130
+ for (const event of chatEvents) {
131
+ if (event.seq <= previous.cursor.lastSeq)
132
+ continue;
133
+ if (event.kind === 'user')
134
+ lastTopicId = event.seq;
135
+ entries.push(toEntry(event, lastTopicId));
136
+ }
137
+ }
138
+ const claims = deriveClaimStatuses({ events, ...(options.consensus ? { consensus: options.consensus } : {}) });
139
+ const applied = applyClaimStatuses(entries, claims.bySeq);
140
+ entries = applied.entries;
141
+ const now = options.now ?? Date.now();
142
+ const index = {
143
+ schema: MEMORY_INDEX_SCHEMA,
144
+ threadId,
145
+ entries,
146
+ cursor: {
147
+ lastSeq: entries.length ? entries[entries.length - 1].seq : 0,
148
+ lastTopicId,
149
+ sourceSize,
150
+ builtAt: now,
151
+ rebuilds: (previous?.cursor.rebuilds ?? 0) + (rebuilt ? 1 : 0),
152
+ dirtySeqs: applied.dirtySeqs,
153
+ },
154
+ stats: {
155
+ messages: entries.length,
156
+ topics: new Set(entries.map((entry) => entry.topicId).filter((topic) => topic > 0)).size,
157
+ active: entries.filter((entry) => entry.claim === 'active').length,
158
+ superseded: entries.filter((entry) => entry.claim === 'superseded').length,
159
+ raw: entries.filter((entry) => entry.claim === 'raw').length,
160
+ untrusted: entries.filter((entry) => entry.untrusted).length,
161
+ imperative: entries.filter((entry) => entry.imperative).length,
162
+ },
163
+ };
164
+ if (options.persist !== false) {
165
+ await writeFileAtomic(memoryIndexPath(root, threadId), JSON.stringify(index));
166
+ }
167
+ return { index, rebuilt, reason: rebuilt ? reasons.join('+') : 'incremental' };
168
+ }
169
+ /** 按 seq 取回原文(expand 路径)。正文只从 events.jsonl 取,索引不复制正文。 */
170
+ export async function resolveMemoryMessages(root, threadId, seqs) {
171
+ const wanted = new Set(seqs.filter((seq) => Number.isFinite(seq) && seq > 0));
172
+ const out = new Map();
173
+ if (wanted.size === 0)
174
+ return out;
175
+ const events = await readEvents(root, threadId);
176
+ for (const event of events) {
177
+ if (wanted.has(event.seq))
178
+ out.set(event.seq, event);
179
+ }
180
+ return out;
181
+ }
@@ -0,0 +1,7 @@
1
+ import type { MetricEntry } from '../core/types.ts';
2
+ export declare function metricsPath(root: string, threadId: string): string;
3
+ export declare function appendMetrics(root: string, threadId: string, entries: readonly MetricEntry[]): Promise<number>;
4
+ export declare function readMetrics(root: string, threadId: string, options?: {
5
+ limit?: number;
6
+ kind?: string;
7
+ }): Promise<MetricEntry[]>;
@@ -0,0 +1,104 @@
1
+ /**
2
+ * 指标落盘:`.dsh-im/groups/<threadId>/metrics.jsonl`,只追加、坏行跳过。
3
+ *
4
+ * 客户端攒的指标(stale/floor/extraction/summary)先放 `thread.pendingMetrics`,
5
+ * 由 saveState 批量写入;模型调用指标由 host 的 `/complete` 直接写。
6
+ *
7
+ * 2026-11-02 修复(并发重复追加):
8
+ * 1. **写串行**:同一文件的 append 走一条链,避免两个 appendFile 交错出半行;
9
+ * 2. **写幂等**:进程内记住已写过的指标 id,同一批 pendingMetrics 被并发 saveState
10
+ * 重复提交时只落一次(重启后靠读侧去重兜底);
11
+ * 3. **读去重**:`readMetrics` 按 id 去重,老数据按内容指纹补算。
12
+ */
13
+ import { appendFile, mkdir, readFile } from 'node:fs/promises';
14
+ import { dirname, join } from 'node:path';
15
+ import { dedupeMetrics, withMetricId } from '../core/metrics.js';
16
+ import { groupDir } from './event-store.js';
17
+ export function metricsPath(root, threadId) {
18
+ return join(groupDir(root, threadId), 'metrics.jsonl');
19
+ }
20
+ /** 队列键:Windows 大小写不敏感、路径分隔符混用,归一化后才能命中同一把锁。 */
21
+ function queueKey(path) {
22
+ const normalized = path.replaceAll('\\', '/');
23
+ return process.platform === 'win32' ? normalized.toLowerCase() : normalized;
24
+ }
25
+ /** 追加写队列:一个文件一条链,前一步失败也要继续(否则一次坏写入会永久卡死后续指标)。 */
26
+ const writeChains = new Map();
27
+ function enqueueWrite(key, task) {
28
+ const previous = writeChains.get(key) ?? Promise.resolve();
29
+ const next = previous.then(task, task);
30
+ writeChains.set(key, next.then(() => undefined, () => undefined));
31
+ return next;
32
+ }
33
+ /** 进程内已落盘的指标 id(按文件分桶);上限只防内存无界,裁剪只可能让极旧条目被重写一次。 */
34
+ const MAX_TRACKED_IDS = 4000;
35
+ const writtenIds = new Map();
36
+ function idsFor(key) {
37
+ let set = writtenIds.get(key);
38
+ if (!set) {
39
+ set = new Set();
40
+ writtenIds.set(key, set);
41
+ }
42
+ return set;
43
+ }
44
+ function rememberIds(set, ids) {
45
+ for (const id of ids)
46
+ set.add(id);
47
+ if (set.size <= MAX_TRACKED_IDS)
48
+ return;
49
+ // 重建:保留靠后的一半(Set 保留插入顺序,靠后的是最近的)。
50
+ const keep = [...set].slice(-Math.floor(MAX_TRACKED_IDS / 2));
51
+ set.clear();
52
+ for (const id of keep)
53
+ set.add(id);
54
+ }
55
+ export async function appendMetrics(root, threadId, entries) {
56
+ if (entries.length === 0)
57
+ return 0;
58
+ const path = metricsPath(root, threadId);
59
+ const key = queueKey(path);
60
+ // 先补 id(同步、纯函数),再排队——入参对象不被改写,调用方状态不受影响。
61
+ const normalized = entries.map(withMetricId);
62
+ return enqueueWrite(key, async () => {
63
+ const seen = idsFor(key);
64
+ const fresh = normalized.filter((entry) => !seen.has(entry.id));
65
+ if (fresh.length === 0)
66
+ return 0;
67
+ await mkdir(dirname(path), { recursive: true });
68
+ await appendFile(path, fresh.map((entry) => JSON.stringify(entry)).join('\n') + '\n', 'utf8');
69
+ rememberIds(seen, fresh.map((entry) => entry.id));
70
+ return fresh.length;
71
+ });
72
+ }
73
+ export async function readMetrics(root, threadId, options = {}) {
74
+ let raw;
75
+ try {
76
+ raw = await readFile(metricsPath(root, threadId), 'utf8');
77
+ }
78
+ catch (error) {
79
+ if (error.code === 'ENOENT')
80
+ return [];
81
+ throw error;
82
+ }
83
+ const parsed = [];
84
+ for (const line of raw.split(/\r?\n/)) {
85
+ const trimmed = line.trim();
86
+ if (!trimmed)
87
+ continue;
88
+ try {
89
+ const entry = JSON.parse(trimmed);
90
+ if (typeof entry?.kind !== 'string' || typeof entry?.at !== 'number')
91
+ continue;
92
+ if (options.kind && entry.kind !== options.kind)
93
+ continue;
94
+ parsed.push(entry);
95
+ }
96
+ catch {
97
+ continue;
98
+ }
99
+ }
100
+ // 去重后再截尾:先 limit 会把重复行算进窗口,导致最近 N 条里掺着重复。
101
+ const unique = dedupeMetrics(parsed);
102
+ const limit = options.limit ?? 500;
103
+ return limit > 0 ? unique.slice(-limit) : unique;
104
+ }
@@ -0,0 +1,39 @@
1
+ /** 接入 DSH 后模型目录来自宿主 `ctx.llm`,不要写死 Harness 版本,也不要直连网关。 */
2
+ export interface ModelOption {
3
+ /** 选择器值:`provider::model`。 */
4
+ id: string;
5
+ label: string;
6
+ /** 展示用提供方名(与 DSH 模型选择器的分组一致)。 */
7
+ provider: string;
8
+ /** DSH provider 路由,发给 ctx.llm.stream。 */
9
+ route?: string;
10
+ /** 发给 ctx.llm.stream 的模型 id;目录读不出来的分组为空。 */
11
+ modelId?: string;
12
+ /** 当前能否真正发起调用。提供方目录读取失败时为 false。 */
13
+ ready: boolean;
14
+ /** 模型上下文窗口(token);宿主查得到才有,用来按 60/20/20 分配 prompt 预算。 */
15
+ contextWindow?: number;
16
+ /** 不可调用时的原因(来自宿主目录错误)。 */
17
+ note?: string;
18
+ }
19
+ export interface ModelCatalog {
20
+ list(): ModelOption[];
21
+ }
22
+ export declare function catalogModelId(route: string, modelId: string): string;
23
+ export declare function parseCatalogModelId(id: string, fallbackRoute?: string): {
24
+ route: string;
25
+ model: string;
26
+ } | null;
27
+ export declare function previewModelCatalog(): ModelCatalog;
28
+ /**
29
+ * 把保存的模型值解析成可调用的 `provider::model`。
30
+ * 老数据可能只存了模型 id,而同一个 id 会出现在多个提供方分组里
31
+ * (例如 deepseek-flash 同时在「DeepSeek 账号」和「DeepSeek」),
32
+ * 只在角色记录的那个提供方里找(route 或显示名都认);找不到直接返回空,
33
+ * 由调用方提示重选——绝不静默换到别的提供方。
34
+ */
35
+ export declare function resolveModelBinding(options: ModelOption[], model: string | undefined, storedProvider?: string): {
36
+ route: string;
37
+ model: string;
38
+ } | null;
39
+ export declare function findModel(catalog: ModelCatalog, id: string | undefined): ModelOption | undefined;
@@ -0,0 +1,67 @@
1
+ export function catalogModelId(route, modelId) {
2
+ return `${route}::${modelId}`;
3
+ }
4
+ export function parseCatalogModelId(id, fallbackRoute) {
5
+ const trimmed = id.trim();
6
+ if (!trimmed)
7
+ return null;
8
+ const sep = trimmed.indexOf('::');
9
+ if (sep > 0) {
10
+ return { route: trimmed.slice(0, sep), model: trimmed.slice(sep + 2) };
11
+ }
12
+ if (fallbackRoute?.trim())
13
+ return { route: fallbackRoute.trim(), model: trimmed };
14
+ return { route: '', model: trimmed };
15
+ }
16
+ export function previewModelCatalog() {
17
+ return {
18
+ list() {
19
+ return [
20
+ { id: 'deepseek-chat', label: 'DeepSeek-V3', provider: 'DeepSeek', ready: true, contextWindow: 64_000 },
21
+ { id: 'deepseek-reasoner', label: 'DeepSeek-R1', provider: 'DeepSeek', ready: true, contextWindow: 64_000 },
22
+ { id: 'deepseek-v3-0324', label: 'DeepSeek-V3-0324', provider: 'DeepSeek', ready: true, contextWindow: 64_000 },
23
+ ];
24
+ },
25
+ };
26
+ }
27
+ /**
28
+ * 把保存的模型值解析成可调用的 `provider::model`。
29
+ * 老数据可能只存了模型 id,而同一个 id 会出现在多个提供方分组里
30
+ * (例如 deepseek-flash 同时在「DeepSeek 账号」和「DeepSeek」),
31
+ * 只在角色记录的那个提供方里找(route 或显示名都认);找不到直接返回空,
32
+ * 由调用方提示重选——绝不静默换到别的提供方。
33
+ */
34
+ export function resolveModelBinding(options, model, storedProvider) {
35
+ const wanted = model?.trim();
36
+ if (!wanted)
37
+ return null;
38
+ const stored = storedProvider?.trim();
39
+ // 已经是 provider::model:必须精确存在且可用,否则报错,不猜别的组。
40
+ const sep = wanted.indexOf('::');
41
+ if (sep > 0) {
42
+ const route = wanted.slice(0, sep);
43
+ const modelId = wanted.slice(sep + 2);
44
+ if (!modelId)
45
+ return null;
46
+ const exact = options.find((option) => option.ready && option.route === route && option.modelId === modelId);
47
+ return exact ? { route, model: modelId } : null;
48
+ }
49
+ // 老数据只存了模型 id:只在“角色记录的那个提供方”里找;找不到就报错。
50
+ const candidates = options.filter((option) => (option.ready && option.modelId !== undefined && option.modelId !== '' && option.modelId === wanted));
51
+ if (!stored) {
52
+ // 没有记录提供方时,只有唯一候选才能确定;多个候选视为歧义,交给用户重选。
53
+ return candidates.length === 1 && candidates[0].route
54
+ ? { route: candidates[0].route, model: wanted }
55
+ : null;
56
+ }
57
+ const hit = candidates.find((option) => option.route === stored) ?? candidates.find((option) => option.provider === stored);
58
+ return hit?.route ? { route: hit.route, model: wanted } : null;
59
+ }
60
+ export function findModel(catalog, id) {
61
+ if (!id)
62
+ return undefined;
63
+ const list = catalog.list();
64
+ return list.find((m) => m.id === id)
65
+ ?? list.find((m) => m.modelId === id)
66
+ ?? list.find((m) => m.route && id === catalogModelId(m.route, m.modelId ?? m.id));
67
+ }
@@ -0,0 +1,57 @@
1
+ import type { TurnStepTrace } from '../core/types.ts';
2
+ import type { TurnToolCache } from './tool-cache.ts';
3
+ export interface PersonaToolCall {
4
+ name: string;
5
+ args: Record<string, unknown>;
6
+ projectRoot: string;
7
+ threadId: string;
8
+ /** 谁在调用(记忆可见性用;ctx.llm 与原生会话都会传)。 */
9
+ personaId?: string;
10
+ /** 本轮群级预算(热区 windowChars);多跳展开按它的 15% 限总字数。缺失时多跳标 fallback。 */
11
+ budgetChars?: number;
12
+ cache: TurnToolCache;
13
+ }
14
+ /** 角色工具的真实执行。ctx.llm 和原生 agent 共用,路径护栏、去重、run_check 都在这里。 */
15
+ export declare function executePersonaTool(input: PersonaToolCall): Promise<string>;
16
+ /**
17
+ * 记忆工具(memory_search / memory_expand)。
18
+ *
19
+ * 两条传输(ctx.llm 工具循环 / 原生会话工具)共用这一个执行器,所以可见性、状态过滤、
20
+ * 不可信包裹都只在这里做一次:非成员拒绝、禁言拒绝、系统消息不返回、
21
+ * 展开时 superseded 标注、正文一律按不可信输入包裹。
22
+ *
23
+ * `memory_expand` 向后兼容:传 `seqs` 走原来的按句柄展开;传 `question` 走同轮多跳展开
24
+ * (问题 → 章节目录 → 代表句柄 → hop2),两种形态同一个可见性入口。
25
+ */
26
+ export declare function runMemoryTool(input: PersonaToolCall): Promise<string>;
27
+ export declare function previewForTrace(value: unknown): string;
28
+ export declare function traceToolStep(step: number, name: string, args: unknown, result: string, ok: boolean, startedAt: number): TurnStepTrace;
29
+ declare const OUTPUT_SCHEMA: {
30
+ type: string;
31
+ additionalProperties: boolean;
32
+ properties: {
33
+ text: {
34
+ type: string;
35
+ };
36
+ };
37
+ required: string[];
38
+ };
39
+ /** 交给 ctx.tools.register 的定义。参数和文案与 ctx.llm 的工具清单相同。 */
40
+ export declare function personaToolDefinition(name: string, run: (args: Record<string, unknown>) => Promise<string>): {
41
+ name: string;
42
+ description: string;
43
+ parameters: Record<string, unknown>;
44
+ output: {
45
+ schema: typeof OUTPUT_SCHEMA;
46
+ render: (args: unknown, value: {
47
+ text?: string;
48
+ }) => {
49
+ type: 'text';
50
+ text: string;
51
+ }[];
52
+ };
53
+ execute: (args: Record<string, unknown>) => Promise<{
54
+ text: string;
55
+ }>;
56
+ };
57
+ export {};