@notic/agent-engine 1.0.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 (175) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +725 -0
  3. package/dist/adapter/AnthropicAdapter.d.ts +47 -0
  4. package/dist/adapter/AnthropicAdapter.d.ts.map +1 -0
  5. package/dist/adapter/AnthropicAdapter.js +341 -0
  6. package/dist/adapter/AnthropicAdapter.js.map +1 -0
  7. package/dist/adapter/GeminiAdapter.d.ts +47 -0
  8. package/dist/adapter/GeminiAdapter.d.ts.map +1 -0
  9. package/dist/adapter/GeminiAdapter.js +315 -0
  10. package/dist/adapter/GeminiAdapter.js.map +1 -0
  11. package/dist/adapter/MessageAdapter.d.ts +66 -0
  12. package/dist/adapter/MessageAdapter.d.ts.map +1 -0
  13. package/dist/adapter/MessageAdapter.js +66 -0
  14. package/dist/adapter/MessageAdapter.js.map +1 -0
  15. package/dist/adapter/OpenAIAdapter.d.ts +45 -0
  16. package/dist/adapter/OpenAIAdapter.d.ts.map +1 -0
  17. package/dist/adapter/OpenAIAdapter.js +305 -0
  18. package/dist/adapter/OpenAIAdapter.js.map +1 -0
  19. package/dist/adapter/index.d.ts +5 -0
  20. package/dist/adapter/index.d.ts.map +1 -0
  21. package/dist/adapter/index.js +10 -0
  22. package/dist/adapter/index.js.map +1 -0
  23. package/dist/agent/Agent.d.ts +319 -0
  24. package/dist/agent/Agent.d.ts.map +1 -0
  25. package/dist/agent/Agent.js +876 -0
  26. package/dist/agent/Agent.js.map +1 -0
  27. package/dist/agent/index.d.ts +2 -0
  28. package/dist/agent/index.d.ts.map +1 -0
  29. package/dist/agent/index.js +8 -0
  30. package/dist/agent/index.js.map +1 -0
  31. package/dist/config/RequestConfig.d.ts +119 -0
  32. package/dist/config/RequestConfig.d.ts.map +1 -0
  33. package/dist/config/RequestConfig.js +257 -0
  34. package/dist/config/RequestConfig.js.map +1 -0
  35. package/dist/config/index.d.ts +2 -0
  36. package/dist/config/index.d.ts.map +1 -0
  37. package/dist/config/index.js +6 -0
  38. package/dist/config/index.js.map +1 -0
  39. package/dist/index.d.ts +29 -0
  40. package/dist/index.d.ts.map +1 -0
  41. package/dist/index.js +69 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/media/DefaultMediaResolver.d.ts +17 -0
  44. package/dist/media/DefaultMediaResolver.d.ts.map +1 -0
  45. package/dist/media/DefaultMediaResolver.js +114 -0
  46. package/dist/media/DefaultMediaResolver.js.map +1 -0
  47. package/dist/media/MediaResolver.d.ts +20 -0
  48. package/dist/media/MediaResolver.d.ts.map +1 -0
  49. package/dist/media/MediaResolver.js +3 -0
  50. package/dist/media/MediaResolver.js.map +1 -0
  51. package/dist/media/index.d.ts +3 -0
  52. package/dist/media/index.d.ts.map +1 -0
  53. package/dist/media/index.js +6 -0
  54. package/dist/media/index.js.map +1 -0
  55. package/dist/message/Message.d.ts +121 -0
  56. package/dist/message/Message.d.ts.map +1 -0
  57. package/dist/message/Message.js +345 -0
  58. package/dist/message/Message.js.map +1 -0
  59. package/dist/message/MessagePart.d.ts +46 -0
  60. package/dist/message/MessagePart.d.ts.map +1 -0
  61. package/dist/message/MessagePart.js +6 -0
  62. package/dist/message/MessagePart.js.map +1 -0
  63. package/dist/message/Role.d.ts +10 -0
  64. package/dist/message/Role.d.ts.map +1 -0
  65. package/dist/message/Role.js +14 -0
  66. package/dist/message/Role.js.map +1 -0
  67. package/dist/message/Usage.d.ts +31 -0
  68. package/dist/message/Usage.d.ts.map +1 -0
  69. package/dist/message/Usage.js +58 -0
  70. package/dist/message/Usage.js.map +1 -0
  71. package/dist/message/index.d.ts +5 -0
  72. package/dist/message/index.d.ts.map +1 -0
  73. package/dist/message/index.js +10 -0
  74. package/dist/message/index.js.map +1 -0
  75. package/dist/prompt/Injection.d.ts +72 -0
  76. package/dist/prompt/Injection.d.ts.map +1 -0
  77. package/dist/prompt/Injection.js +123 -0
  78. package/dist/prompt/Injection.js.map +1 -0
  79. package/dist/prompt/PromptBuilder.d.ts +276 -0
  80. package/dist/prompt/PromptBuilder.d.ts.map +1 -0
  81. package/dist/prompt/PromptBuilder.js +465 -0
  82. package/dist/prompt/PromptBuilder.js.map +1 -0
  83. package/dist/prompt/Rule.d.ts +98 -0
  84. package/dist/prompt/Rule.d.ts.map +1 -0
  85. package/dist/prompt/Rule.js +275 -0
  86. package/dist/prompt/Rule.js.map +1 -0
  87. package/dist/prompt/index.d.ts +4 -0
  88. package/dist/prompt/index.d.ts.map +1 -0
  89. package/dist/prompt/index.js +10 -0
  90. package/dist/prompt/index.js.map +1 -0
  91. package/dist/session/Inserter.d.ts +76 -0
  92. package/dist/session/Inserter.d.ts.map +1 -0
  93. package/dist/session/Inserter.js +217 -0
  94. package/dist/session/Inserter.js.map +1 -0
  95. package/dist/session/Paginator.d.ts +52 -0
  96. package/dist/session/Paginator.d.ts.map +1 -0
  97. package/dist/session/Paginator.js +110 -0
  98. package/dist/session/Paginator.js.map +1 -0
  99. package/dist/session/Query.d.ts +54 -0
  100. package/dist/session/Query.d.ts.map +1 -0
  101. package/dist/session/Query.js +97 -0
  102. package/dist/session/Query.js.map +1 -0
  103. package/dist/session/SearchCriteria.d.ts +39 -0
  104. package/dist/session/SearchCriteria.d.ts.map +1 -0
  105. package/dist/session/SearchCriteria.js +28 -0
  106. package/dist/session/SearchCriteria.js.map +1 -0
  107. package/dist/session/Session.d.ts +139 -0
  108. package/dist/session/Session.d.ts.map +1 -0
  109. package/dist/session/Session.js +344 -0
  110. package/dist/session/Session.js.map +1 -0
  111. package/dist/session/index.d.ts +6 -0
  112. package/dist/session/index.d.ts.map +1 -0
  113. package/dist/session/index.js +15 -0
  114. package/dist/session/index.js.map +1 -0
  115. package/dist/session/matchUtils.d.ts +22 -0
  116. package/dist/session/matchUtils.d.ts.map +1 -0
  117. package/dist/session/matchUtils.js +138 -0
  118. package/dist/session/matchUtils.js.map +1 -0
  119. package/dist/stream/StreamEvent.d.ts +193 -0
  120. package/dist/stream/StreamEvent.d.ts.map +1 -0
  121. package/dist/stream/StreamEvent.js +44 -0
  122. package/dist/stream/StreamEvent.js.map +1 -0
  123. package/dist/stream/StreamParser.d.ts +47 -0
  124. package/dist/stream/StreamParser.d.ts.map +1 -0
  125. package/dist/stream/StreamParser.js +225 -0
  126. package/dist/stream/StreamParser.js.map +1 -0
  127. package/dist/stream/index.d.ts +3 -0
  128. package/dist/stream/index.d.ts.map +1 -0
  129. package/dist/stream/index.js +8 -0
  130. package/dist/stream/index.js.map +1 -0
  131. package/dist/tool/Context.d.ts +30 -0
  132. package/dist/tool/Context.d.ts.map +1 -0
  133. package/dist/tool/Context.js +50 -0
  134. package/dist/tool/Context.js.map +1 -0
  135. package/dist/tool/Hook.d.ts +23 -0
  136. package/dist/tool/Hook.d.ts.map +1 -0
  137. package/dist/tool/Hook.js +27 -0
  138. package/dist/tool/Hook.js.map +1 -0
  139. package/dist/tool/McpToolAdapter.d.ts +47 -0
  140. package/dist/tool/McpToolAdapter.d.ts.map +1 -0
  141. package/dist/tool/McpToolAdapter.js +88 -0
  142. package/dist/tool/McpToolAdapter.js.map +1 -0
  143. package/dist/tool/Param.d.ts +68 -0
  144. package/dist/tool/Param.d.ts.map +1 -0
  145. package/dist/tool/Param.js +161 -0
  146. package/dist/tool/Param.js.map +1 -0
  147. package/dist/tool/Tool.d.ts +92 -0
  148. package/dist/tool/Tool.d.ts.map +1 -0
  149. package/dist/tool/Tool.js +198 -0
  150. package/dist/tool/Tool.js.map +1 -0
  151. package/dist/tool/ToolCall.d.ts +37 -0
  152. package/dist/tool/ToolCall.d.ts.map +1 -0
  153. package/dist/tool/ToolCall.js +118 -0
  154. package/dist/tool/ToolCall.js.map +1 -0
  155. package/dist/tool/ToolKit.d.ts +87 -0
  156. package/dist/tool/ToolKit.d.ts.map +1 -0
  157. package/dist/tool/ToolKit.js +173 -0
  158. package/dist/tool/ToolKit.js.map +1 -0
  159. package/dist/tool/ValueType.d.ts +12 -0
  160. package/dist/tool/ValueType.d.ts.map +1 -0
  161. package/dist/tool/ValueType.js +16 -0
  162. package/dist/tool/ValueType.js.map +1 -0
  163. package/dist/tool/index.d.ts +9 -0
  164. package/dist/tool/index.d.ts.map +1 -0
  165. package/dist/tool/index.js +21 -0
  166. package/dist/tool/index.js.map +1 -0
  167. package/dist/utils/generateId.d.ts +10 -0
  168. package/dist/utils/generateId.d.ts.map +1 -0
  169. package/dist/utils/generateId.js +18 -0
  170. package/dist/utils/generateId.js.map +1 -0
  171. package/dist/utils/index.d.ts +2 -0
  172. package/dist/utils/index.d.ts.map +1 -0
  173. package/dist/utils/index.js +6 -0
  174. package/dist/utils/index.js.map +1 -0
  175. package/package.json +72 -0
@@ -0,0 +1,275 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Rule = void 0;
4
+ const matchUtils_1 = require("../session/matchUtils");
5
+ /**
6
+ * 声明式插入规则
7
+ *
8
+ * 描述"在哪里插入",build 时才真正执行定位。
9
+ * 规则无状态、可复用 — 同一条 Rule 可以绑定多条不同的 Message。
10
+ *
11
+ * 用法:
12
+ * Rule.top().after() // 第一条消息之后
13
+ * Rule.byRole(Role.User).last().before() // 最后一条 User 之前
14
+ * Rule.byTags(["ctx"]).all().after() // 每条带ctx 标签的消息之后
15
+ * Rule.index(-1).before().order(5) // 倒数第1条之前,排序权重5
16
+ */
17
+ class Rule {
18
+ _anchor;
19
+ _select = "last";
20
+ _direction = "after";
21
+ _offset = 0;
22
+ _order = 0;
23
+ _scanDepth;
24
+ _scanDirection = "reverse";
25
+ constructor(anchor) {
26
+ this._anchor = anchor;
27
+ }
28
+ //========================
29
+ // 静态工厂
30
+ // ========================
31
+ /** 定位到第一条消息 */
32
+ static top() {
33
+ return new Rule({ type: "position", value: "top" });
34
+ }
35
+ /** 定位到最后一条消息 */
36
+ static bottom() {
37
+ return new Rule({ type: "position", value: "bottom" });
38
+ }
39
+ /** 定位到第n 条(支持负索引,-1 为倒数第一) */
40
+ static index(n) {
41
+ return new Rule({ type: "index", value: n });
42
+ }
43
+ /** 按角色定位 */
44
+ static byRole(role, options) {
45
+ return new Rule({
46
+ type: "role",
47
+ role,
48
+ criteria: options ? { mode: options.mode } : undefined,
49
+ });
50
+ }
51
+ /** 按内容关键词/正则定位 */
52
+ static byContent(keywords, options) {
53
+ return new Rule({ type: "content", keywords, options });
54
+ }
55
+ /** 按标签定位 */
56
+ static byTags(tags, options) {
57
+ return new Rule({ type: "tags", tags, options });
58
+ }
59
+ /** 自定义谓词定位 */
60
+ static by(fn) {
61
+ return new Rule({ type: "predicate", fn });
62
+ }
63
+ // ========================
64
+ // 选择策略
65
+ // ========================
66
+ /** 取第一个匹配 */
67
+ first() {
68
+ this._select = "first";
69
+ return this;
70
+ }
71
+ /** 取最后一个匹配(默认) */
72
+ last() {
73
+ this._select = "last";
74
+ return this;
75
+ }
76
+ /** 所有匹配点都插入 */
77
+ all() {
78
+ this._select = "all";
79
+ return this;
80
+ }
81
+ // ========================
82
+ // 偏移
83
+ // ========================
84
+ /** 在定位结果上偏移 n 个位置(正数向后,负数向前) */
85
+ offset(n) {
86
+ this._offset = n;
87
+ return this;
88
+ }
89
+ // ========================
90
+ // 插入方向
91
+ // ========================
92
+ /** 在锚点之前插入 */
93
+ before() {
94
+ this._direction = "before";
95
+ return this;
96
+ }
97
+ /** 在锚点之后插入(默认) */
98
+ after() {
99
+ this._direction = "after";
100
+ return this;
101
+ }
102
+ // ========================
103
+ // 排序优先级
104
+ // ========================
105
+ /** 同位置多条注入时的排序,数字越小越靠前,默认 0 */
106
+ order(n) {
107
+ this._order = n;
108
+ return this;
109
+ }
110
+ // ========================
111
+ // 扫描范围
112
+ // ========================
113
+ /**
114
+ * 设置扫描深度(只扫描 N 条消息来匹配关键词/标签/谓词)
115
+ *
116
+ * 仅影响搜索型定位(byContent/byTags/byRole/by),
117
+ * 不影响位置型定位(top/bottom/index)。
118
+ * 默认不限制(扫描全部历史)。
119
+ *
120
+ * @param n 扫描条数
121
+ */
122
+ scanDepth(n) {
123
+ this._scanDepth = n;
124
+ return this;
125
+ }
126
+ /** 正向扫描 — 从顶部开始扫描 scanDepth 条 */
127
+ scanForward() {
128
+ this._scanDirection = "forward";
129
+ return this;
130
+ }
131
+ /** 反向扫描 — 从底部开始扫描 scanDepth 条(默认) */
132
+ scanReverse() {
133
+ this._scanDirection = "reverse";
134
+ return this;
135
+ }
136
+ // ========================
137
+ // 查询(供PromptBuilder 使用)
138
+ // ========================
139
+ /** 获取排序权重 */
140
+ get orderValue() {
141
+ return this._order;
142
+ }
143
+ // ========================
144
+ // 解析(核心)
145
+ // ========================
146
+ /**
147
+ * 在给定的messages 数组中解析出所有插入索引
148
+ *
149
+ * 返回的索引可直接用于 splice(index, 0, msg) 插入。
150
+ * 找不到匹配时返回空数组(静默跳过)。
151
+ *
152
+ * @param messages 原始消息数组
153
+ * @returns 插入位置索引数组(已去重、升序)
154
+ */
155
+ resolve(messages) {
156
+ if (messages.length === 0)
157
+ return [];
158
+ // 第一步:找出所有匹配的锚点索引
159
+ const anchorIndices = this.findAnchors(messages);
160
+ if (anchorIndices.length === 0)
161
+ return [];
162
+ // 第二步:应用选择策略
163
+ const selected = this.applySelect(anchorIndices);
164
+ // 第三步:应用偏移 + 方向,转换为插入索引
165
+ const insertIndices = [];
166
+ for (const anchorIdx of selected) {
167
+ const offsetIdx = anchorIdx + this._offset;
168
+ // 边界检查(偏移后超出范围则跳过)
169
+ if (offsetIdx < 0 || offsetIdx >= messages.length)
170
+ continue;
171
+ const insertIdx = this._direction === "after" ? offsetIdx + 1 : offsetIdx;
172
+ // 限制在[0, messages.length] 范围内
173
+ const clamped = Math.max(0, Math.min(messages.length, insertIdx));
174
+ insertIndices.push(clamped);
175
+ }
176
+ // 去重 + 升序
177
+ return [...new Set(insertIndices)].sort((a, b) => a - b);
178
+ }
179
+ // ========================
180
+ // 内部:锚点查找
181
+ // ========================
182
+ findAnchors(messages) {
183
+ const anchor = this._anchor;
184
+ switch (anchor.type) {
185
+ // 位置型定位 — 不受扫描范围影响
186
+ case "position":
187
+ if (anchor.value === "top")
188
+ return [0];
189
+ return [messages.length - 1];
190
+ case "index": {
191
+ const idx = anchor.value < 0
192
+ ? messages.length + anchor.value
193
+ : anchor.value;
194
+ if (idx < 0 || idx >= messages.length)
195
+ return [];
196
+ return [idx];
197
+ }
198
+ // 搜索型定位 — 受扫描范围影响
199
+ case "role": {
200
+ const criteria = {
201
+ roles: [anchor.role],
202
+ ...anchor.criteria,
203
+ };
204
+ const [start, end] = this.getScanRange(messages.length);
205
+ return this.matchInRange(messages, start, end, (msg) => (0, matchUtils_1.matchesCriteria)(msg, criteria));
206
+ }
207
+ case "content": {
208
+ const criteria = {
209
+ content: anchor.keywords,
210
+ mode: anchor.options?.mode,
211
+ roles: anchor.options?.roles,
212
+ };
213
+ const [start, end] = this.getScanRange(messages.length);
214
+ return this.matchInRange(messages, start, end, (msg) => (0, matchUtils_1.matchesCriteria)(msg, criteria));
215
+ }
216
+ case "tags": {
217
+ const criteria = {
218
+ tags: anchor.tags,
219
+ mode: anchor.options?.mode,
220
+ roles: anchor.options?.roles,
221
+ };
222
+ const [start, end] = this.getScanRange(messages.length);
223
+ return this.matchInRange(messages, start, end, (msg) => (0, matchUtils_1.matchesCriteria)(msg, criteria));
224
+ }
225
+ case "predicate": {
226
+ const [start, end] = this.getScanRange(messages.length);
227
+ return this.matchInRange(messages, start, end, (msg, i) => anchor.fn(msg, i));
228
+ }
229
+ }
230
+ }
231
+ // ========================
232
+ // 内部:扫描范围
233
+ // ========================
234
+ /**
235
+ * 计算扫描范围 [start, end)
236
+ */
237
+ getScanRange(totalLength) {
238
+ if (this._scanDepth === undefined) {
239
+ return [0, totalLength];
240
+ }
241
+ if (this._scanDirection === "forward") {
242
+ return [0, Math.min(this._scanDepth, totalLength)];
243
+ }
244
+ else {
245
+ return [Math.max(0, totalLength - this._scanDepth), totalLength];
246
+ }
247
+ }
248
+ /**
249
+ * 在指定范围内匹配,返回绝对索引
250
+ */
251
+ matchInRange(messages, start, end, predicate) {
252
+ const results = [];
253
+ for (let i = start; i < end; i++) {
254
+ if (predicate(messages[i], i)) {
255
+ results.push(i);
256
+ }
257
+ }
258
+ return results;
259
+ }
260
+ // ========================
261
+ // 内部:选择策略
262
+ // ========================
263
+ applySelect(indices) {
264
+ switch (this._select) {
265
+ case "first":
266
+ return [indices[0]];
267
+ case "last":
268
+ return [indices[indices.length - 1]];
269
+ case "all":
270
+ return indices;
271
+ }
272
+ }
273
+ }
274
+ exports.Rule = Rule;
275
+ //# sourceMappingURL=Rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../src/prompt/Rule.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export { Rule } from "./Rule";
2
+ export { Injection } from "./Injection";
3
+ export { PromptBuilder, InjectOptions, BuildOptions, BuildStrategy, Operation, } from "./PromptBuilder";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACH,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,GACZ,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PromptBuilder = exports.Injection = exports.Rule = void 0;
4
+ var Rule_1 = require("./Rule");
5
+ Object.defineProperty(exports, "Rule", { enumerable: true, get: function () { return Rule_1.Rule; } });
6
+ var Injection_1 = require("./Injection");
7
+ Object.defineProperty(exports, "Injection", { enumerable: true, get: function () { return Injection_1.Injection; } });
8
+ var PromptBuilder_1 = require("./PromptBuilder");
9
+ Object.defineProperty(exports, "PromptBuilder", { enumerable: true, get: function () { return PromptBuilder_1.PromptBuilder; } });
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":";;;AAAA,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,iDAMyB;AALrB,8GAAA,aAAa,OAAA"}
@@ -0,0 +1,76 @@
1
+ import { Message } from "../message/Message";
2
+ import { MessagePart } from "../message/MessagePart";
3
+ import { Role } from "../message/Role";
4
+ import { MatchMode, Priority } from "./SearchCriteria";
5
+ /**
6
+ * 游标式插入器
7
+ *
8
+ * 通过移动光标定位插入点,支持光标前/后插入。
9
+ * 所有插入操作先进入命令队列,调用 execute() 才会真正执行。
10
+ * 执行后插入器报废,需要从Session 重新获取。
11
+ *
12
+ * 注意:插入器只能操作当前分支(root→cursor路径)。
13
+ */
14
+ export declare class Inserter {
15
+ private _branch;
16
+ private _cursor;
17
+ private _commands;
18
+ private _expired;
19
+ constructor(branch: Message[]);
20
+ /** 移动到顶部 */
21
+ top(): this;
22
+ /** 移动到底部 */
23
+ bottom(): this;
24
+ /**
25
+ * 偏移移动
26
+ * @param offset 正数向下(向后),负数向上(向前)
27
+ */
28
+ move(offset: number): this;
29
+ /**
30
+ * 直接锁定到某条消息(必须在当前分支上)
31
+ */
32
+ moveTo(message: Message): this;
33
+ /**
34
+ * 通过内容查找并移动光标
35
+ */
36
+ moveByContent(keywords: (string | RegExp)[], options?: {
37
+ mode?: MatchMode;
38
+ priority?: Priority;
39
+ roles?: Role[];
40
+ }): this;
41
+ /**
42
+ * 通过标签查找并移动光标
43
+ */
44
+ moveByTags(tags: (string | RegExp)[], options?: {
45
+ mode?: MatchMode;
46
+ priority?: Priority;
47
+ roles?: Role[];
48
+ }): this;
49
+ /** 在光标后插入消息 */
50
+ insertAfter(message: Message): this;
51
+ /** 在光标前插入消息 */
52
+ insertBefore(message: Message): this;
53
+ insertUserAfter(content: string | MessagePart | MessagePart[]): this;
54
+ insertUserBefore(content: string | MessagePart | MessagePart[]): this;
55
+ insertAssistantAfter(content: string | MessagePart | MessagePart[]): this;
56
+ insertAssistantBefore(content: string | MessagePart | MessagePart[]): this;
57
+ insertToolAfter(toolCallId: string, result: string): this;
58
+ insertToolBefore(toolCallId: string, result: string): this;
59
+ /**
60
+ * 执行所有排队的插入操作,之后插入器报废。
61
+ * 返回最后一个插入的消息(方便作为新cursor)。
62
+ */
63
+ execute(): Message | undefined;
64
+ /** 光标当前指向的消息 */
65
+ get current(): Message;
66
+ /** 光标在分支中的位置索引 */
67
+ get position(): number;
68
+ /** 当前分支长度 */
69
+ get length(): number;
70
+ /** 是否已执行(报废) */
71
+ get isExpired(): boolean;
72
+ /** 排队中的命令数量 */
73
+ get pendingCount(): number;
74
+ private guardExpired;
75
+ }
76
+ //# sourceMappingURL=Inserter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Inserter.d.ts","sourceRoot":"","sources":["../../src/session/Inserter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAiB,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAYtE;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,MAAM,EAAE,OAAO,EAAE;IAa7B,YAAY;IACZ,GAAG,IAAI,IAAI;IAMX,YAAY;IACZ,MAAM,IAAI,IAAI;IAMd;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY1B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAU9B;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC7B,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;KAChB,GACA,IAAI;IAmBP;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACzB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;KAChB,GACA,IAAI;IAuBP,eAAe;IACf,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAUnC,eAAe;IACf,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAYpC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,GAAG,IAAI;IAIpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,GAAG,IAAI;IAIrE,oBAAoB,CAClB,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,GAC5C,IAAI;IAIP,qBAAqB,CACnB,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,GAC5C,IAAI;IAIP,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ1D;;;OAGG;IACH,OAAO,IAAI,OAAO,GAAG,SAAS;IAsC9B,gBAAgB;IAChB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,kBAAkB;IAClB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,aAAa;IACb,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,gBAAgB;IAChB,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,eAAe;IACf,IAAI,YAAY,IAAI,MAAM,CAEzB;IAMD,OAAO,CAAC,YAAY;CAKrB"}
@@ -0,0 +1,217 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Inserter = void 0;
4
+ const Message_1 = require("../message/Message");
5
+ const matchUtils_1 = require("./matchUtils");
6
+ /**
7
+ * 游标式插入器
8
+ *
9
+ * 通过移动光标定位插入点,支持光标前/后插入。
10
+ * 所有插入操作先进入命令队列,调用 execute() 才会真正执行。
11
+ * 执行后插入器报废,需要从Session 重新获取。
12
+ *
13
+ * 注意:插入器只能操作当前分支(root→cursor路径)。
14
+ */
15
+ class Inserter {
16
+ _branch; // 当前分支路径
17
+ _cursor; // 光标在分支中的索引
18
+ _commands = [];
19
+ _expired = false;
20
+ constructor(branch) {
21
+ if (branch.length === 0) {
22
+ throw new Error("分支不能为空");
23
+ }
24
+ this._branch = [...branch];
25
+ // 默认光标在最底部(最后一条消息)
26
+ this._cursor = this._branch.length - 1;
27
+ }
28
+ // ========================
29
+ // 光标移动
30
+ // ========================
31
+ /** 移动到顶部 */
32
+ top() {
33
+ this.guardExpired();
34
+ this._cursor = 0;
35
+ return this;
36
+ }
37
+ /** 移动到底部 */
38
+ bottom() {
39
+ this.guardExpired();
40
+ this._cursor = this._branch.length - 1;
41
+ return this;
42
+ }
43
+ /**
44
+ * 偏移移动
45
+ * @param offset 正数向下(向后),负数向上(向前)
46
+ */
47
+ move(offset) {
48
+ this.guardExpired();
49
+ const next = this._cursor + offset;
50
+ if (next < 0 || next >= this._branch.length) {
51
+ throw new Error(`光标移动越界:当前=${this._cursor}, 偏移=${offset}, 范围=[0, ${this._branch.length - 1}]`);
52
+ }
53
+ this._cursor = next;
54
+ return this;
55
+ }
56
+ /**
57
+ * 直接锁定到某条消息(必须在当前分支上)
58
+ */
59
+ moveTo(message) {
60
+ this.guardExpired();
61
+ const index = this._branch.indexOf(message);
62
+ if (index === -1) {
63
+ throw new Error("目标消息不在当前分支上");
64
+ }
65
+ this._cursor = index;
66
+ return this;
67
+ }
68
+ /**
69
+ * 通过内容查找并移动光标
70
+ */
71
+ moveByContent(keywords, options) {
72
+ this.guardExpired();
73
+ const criteria = {
74
+ content: keywords,
75
+ mode: options?.mode,
76
+ priority: options?.priority,
77
+ roles: options?.roles,
78
+ };
79
+ const matches = this._branch.filter((msg) => (0, matchUtils_1.matchesCriteria)(msg, criteria));
80
+ const target = (0, matchUtils_1.selectByPriority)(matches, criteria);
81
+ if (!target) {
82
+ throw new Error(`未找到匹配内容的消息: ${keywords}`);
83
+ }
84
+ this._cursor = this._branch.indexOf(target);
85
+ return this;
86
+ }
87
+ /**
88
+ * 通过标签查找并移动光标
89
+ */
90
+ moveByTags(tags, options) {
91
+ this.guardExpired();
92
+ const criteria = {
93
+ tags,
94
+ mode: options?.mode,
95
+ priority: options?.priority,
96
+ roles: options?.roles,
97
+ };
98
+ const matches = this._branch.filter((msg) => (0, matchUtils_1.matchesCriteria)(msg, criteria));
99
+ const target = (0, matchUtils_1.selectByPriority)(matches, criteria);
100
+ if (!target) {
101
+ throw new Error(`未找到匹配标签的消息: ${tags}`);
102
+ }
103
+ this._cursor = this._branch.indexOf(target);
104
+ return this;
105
+ }
106
+ // ========================
107
+ // 插入操作(命令队列)
108
+ // ========================
109
+ /** 在光标后插入消息 */
110
+ insertAfter(message) {
111
+ this.guardExpired();
112
+ this._commands.push({
113
+ position: "after",
114
+ anchor: this._branch[this._cursor],
115
+ message,
116
+ });
117
+ return this;
118
+ }
119
+ /** 在光标前插入消息 */
120
+ insertBefore(message) {
121
+ this.guardExpired();
122
+ this._commands.push({
123
+ position: "before",
124
+ anchor: this._branch[this._cursor],
125
+ message,
126
+ });
127
+ return this;
128
+ }
129
+ // ---- 便捷插入方法 ----
130
+ insertUserAfter(content) {
131
+ return this.insertAfter(Message_1.Message.user(content));
132
+ }
133
+ insertUserBefore(content) {
134
+ return this.insertBefore(Message_1.Message.user(content));
135
+ }
136
+ insertAssistantAfter(content) {
137
+ return this.insertAfter(Message_1.Message.assistant(content));
138
+ }
139
+ insertAssistantBefore(content) {
140
+ return this.insertBefore(Message_1.Message.assistant(content));
141
+ }
142
+ insertToolAfter(toolCallId, result) {
143
+ return this.insertAfter(Message_1.Message.tool(toolCallId, result));
144
+ }
145
+ insertToolBefore(toolCallId, result) {
146
+ return this.insertBefore(Message_1.Message.tool(toolCallId, result));
147
+ }
148
+ // ========================
149
+ // 执行(事务提交)
150
+ // ========================
151
+ /**
152
+ * 执行所有排队的插入操作,之后插入器报废。
153
+ * 返回最后一个插入的消息(方便作为新cursor)。
154
+ */
155
+ execute() {
156
+ this.guardExpired();
157
+ let lastInserted;
158
+ for (const cmd of this._commands) {
159
+ if (cmd.position === "after") {
160
+ // anchor 成为 message 的父节点(分支插入)
161
+ cmd.anchor.append(cmd.message);
162
+ }
163
+ else {
164
+ // before:在 anchor 和 anchor.parent 之间插入(嫁接式)
165
+ const parent = cmd.anchor.parent;
166
+ if (!parent) {
167
+ throw new Error("不能在根节点之前插入");
168
+ }
169
+ const index = parent.children.indexOf(cmd.anchor);
170
+ // 从parent断开 anchor
171
+ parent.children.splice(index, 1);
172
+ // parent → message
173
+ cmd.message.parent = parent;
174
+ parent.children.splice(index, 0, cmd.message);
175
+ // message → anchor
176
+ cmd.message.append(cmd.anchor);
177
+ }
178
+ lastInserted = cmd.message;
179
+ }
180
+ this._expired = true;
181
+ this._commands = [];
182
+ return lastInserted;
183
+ }
184
+ // ========================
185
+ // 状态查询
186
+ // ========================
187
+ /** 光标当前指向的消息 */
188
+ get current() {
189
+ return this._branch[this._cursor];
190
+ }
191
+ /** 光标在分支中的位置索引 */
192
+ get position() {
193
+ return this._cursor;
194
+ }
195
+ /** 当前分支长度 */
196
+ get length() {
197
+ return this._branch.length;
198
+ }
199
+ /** 是否已执行(报废) */
200
+ get isExpired() {
201
+ return this._expired;
202
+ }
203
+ /** 排队中的命令数量 */
204
+ get pendingCount() {
205
+ return this._commands.length;
206
+ }
207
+ // ========================
208
+ // 防护
209
+ // ========================
210
+ guardExpired() {
211
+ if (this._expired) {
212
+ throw new Error("插入器已执行过,请从Session重新获取");
213
+ }
214
+ }
215
+ }
216
+ exports.Inserter = Inserter;
217
+ //# sourceMappingURL=Inserter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Inserter.js","sourceRoot":"","sources":["../../src/session/Inserter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,52 @@
1
+ import { Message } from "../message/Message";
2
+ /**
3
+ * 分页器 — 在一组兄弟节点(分支)之间导航
4
+ *
5
+ * 分页器对应一个父节点的 children 列表(仅 children.length > 1 时有意义)。
6
+ * 切换页面时自动沿"最左原则"将 Session 的 cursor 下沉到目标分支的最深处叶子。
7
+ *
8
+ * 用法:
9
+ * const pags = session.paginators;
10
+ * pags[0].next();// B1→ B2, cursor自动到B2最深处
11
+ * pags[0].goTo(2); // 跳转到第3页
12
+ */
13
+ export declare class Paginator {
14
+ /** 这组兄弟节点的父节点 */
15
+ readonly parent: Message;
16
+ /** cursor 更新回调(由 Session 注入) */
17
+ private _onSwitch;
18
+ /** 当前选中的页码索引 */
19
+ private _currentIndex;
20
+ constructor(parent: Message, currentIndex: number, onSwitch: (target: Message) => void);
21
+ /** 所有页(即 parent.children,实时引用) */
22
+ get pages(): Message[];
23
+ /** 总页数 */
24
+ get total(): number;
25
+ /** 当前页码(0-based) */
26
+ get currentIndex(): number;
27
+ /** 当前选中的页节点 */
28
+ get current(): Message;
29
+ /** 是否有下一页 */
30
+ get hasNext(): boolean;
31
+ /** 是否有上一页 */
32
+ get hasPrev(): boolean;
33
+ /** 下一页 */
34
+ next(): this;
35
+ /** 上一页 */
36
+ prev(): this;
37
+ /** 跳转到第一页 */
38
+ first(): this;
39
+ /** 跳转到最后一页 */
40
+ last(): this;
41
+ /**
42
+ * 跳转到指定页码(0-based)
43
+ *
44
+ * 切换后沿"最左原则"将 cursor 下沉到目标分支的最深叶子节点。
45
+ */
46
+ goTo(index: number): this;
47
+ /**
48
+ * 最左原则:从指定节点出发,不断取 children[0] 直到叶子
49
+ */
50
+ static leftmostLeaf(node: Message): Message;
51
+ }
52
+ //# sourceMappingURL=Paginator.d.ts.map