@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.
- package/LICENSE +190 -0
- package/README.md +725 -0
- package/dist/adapter/AnthropicAdapter.d.ts +47 -0
- package/dist/adapter/AnthropicAdapter.d.ts.map +1 -0
- package/dist/adapter/AnthropicAdapter.js +341 -0
- package/dist/adapter/AnthropicAdapter.js.map +1 -0
- package/dist/adapter/GeminiAdapter.d.ts +47 -0
- package/dist/adapter/GeminiAdapter.d.ts.map +1 -0
- package/dist/adapter/GeminiAdapter.js +315 -0
- package/dist/adapter/GeminiAdapter.js.map +1 -0
- package/dist/adapter/MessageAdapter.d.ts +66 -0
- package/dist/adapter/MessageAdapter.d.ts.map +1 -0
- package/dist/adapter/MessageAdapter.js +66 -0
- package/dist/adapter/MessageAdapter.js.map +1 -0
- package/dist/adapter/OpenAIAdapter.d.ts +45 -0
- package/dist/adapter/OpenAIAdapter.d.ts.map +1 -0
- package/dist/adapter/OpenAIAdapter.js +305 -0
- package/dist/adapter/OpenAIAdapter.js.map +1 -0
- package/dist/adapter/index.d.ts +5 -0
- package/dist/adapter/index.d.ts.map +1 -0
- package/dist/adapter/index.js +10 -0
- package/dist/adapter/index.js.map +1 -0
- package/dist/agent/Agent.d.ts +319 -0
- package/dist/agent/Agent.d.ts.map +1 -0
- package/dist/agent/Agent.js +876 -0
- package/dist/agent/Agent.js.map +1 -0
- package/dist/agent/index.d.ts +2 -0
- package/dist/agent/index.d.ts.map +1 -0
- package/dist/agent/index.js +8 -0
- package/dist/agent/index.js.map +1 -0
- package/dist/config/RequestConfig.d.ts +119 -0
- package/dist/config/RequestConfig.d.ts.map +1 -0
- package/dist/config/RequestConfig.js +257 -0
- package/dist/config/RequestConfig.js.map +1 -0
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +6 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +29 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +69 -0
- package/dist/index.js.map +1 -0
- package/dist/media/DefaultMediaResolver.d.ts +17 -0
- package/dist/media/DefaultMediaResolver.d.ts.map +1 -0
- package/dist/media/DefaultMediaResolver.js +114 -0
- package/dist/media/DefaultMediaResolver.js.map +1 -0
- package/dist/media/MediaResolver.d.ts +20 -0
- package/dist/media/MediaResolver.d.ts.map +1 -0
- package/dist/media/MediaResolver.js +3 -0
- package/dist/media/MediaResolver.js.map +1 -0
- package/dist/media/index.d.ts +3 -0
- package/dist/media/index.d.ts.map +1 -0
- package/dist/media/index.js +6 -0
- package/dist/media/index.js.map +1 -0
- package/dist/message/Message.d.ts +121 -0
- package/dist/message/Message.d.ts.map +1 -0
- package/dist/message/Message.js +345 -0
- package/dist/message/Message.js.map +1 -0
- package/dist/message/MessagePart.d.ts +46 -0
- package/dist/message/MessagePart.d.ts.map +1 -0
- package/dist/message/MessagePart.js +6 -0
- package/dist/message/MessagePart.js.map +1 -0
- package/dist/message/Role.d.ts +10 -0
- package/dist/message/Role.d.ts.map +1 -0
- package/dist/message/Role.js +14 -0
- package/dist/message/Role.js.map +1 -0
- package/dist/message/Usage.d.ts +31 -0
- package/dist/message/Usage.d.ts.map +1 -0
- package/dist/message/Usage.js +58 -0
- package/dist/message/Usage.js.map +1 -0
- package/dist/message/index.d.ts +5 -0
- package/dist/message/index.d.ts.map +1 -0
- package/dist/message/index.js +10 -0
- package/dist/message/index.js.map +1 -0
- package/dist/prompt/Injection.d.ts +72 -0
- package/dist/prompt/Injection.d.ts.map +1 -0
- package/dist/prompt/Injection.js +123 -0
- package/dist/prompt/Injection.js.map +1 -0
- package/dist/prompt/PromptBuilder.d.ts +276 -0
- package/dist/prompt/PromptBuilder.d.ts.map +1 -0
- package/dist/prompt/PromptBuilder.js +465 -0
- package/dist/prompt/PromptBuilder.js.map +1 -0
- package/dist/prompt/Rule.d.ts +98 -0
- package/dist/prompt/Rule.d.ts.map +1 -0
- package/dist/prompt/Rule.js +275 -0
- package/dist/prompt/Rule.js.map +1 -0
- package/dist/prompt/index.d.ts +4 -0
- package/dist/prompt/index.d.ts.map +1 -0
- package/dist/prompt/index.js +10 -0
- package/dist/prompt/index.js.map +1 -0
- package/dist/session/Inserter.d.ts +76 -0
- package/dist/session/Inserter.d.ts.map +1 -0
- package/dist/session/Inserter.js +217 -0
- package/dist/session/Inserter.js.map +1 -0
- package/dist/session/Paginator.d.ts +52 -0
- package/dist/session/Paginator.d.ts.map +1 -0
- package/dist/session/Paginator.js +110 -0
- package/dist/session/Paginator.js.map +1 -0
- package/dist/session/Query.d.ts +54 -0
- package/dist/session/Query.d.ts.map +1 -0
- package/dist/session/Query.js +97 -0
- package/dist/session/Query.js.map +1 -0
- package/dist/session/SearchCriteria.d.ts +39 -0
- package/dist/session/SearchCriteria.d.ts.map +1 -0
- package/dist/session/SearchCriteria.js +28 -0
- package/dist/session/SearchCriteria.js.map +1 -0
- package/dist/session/Session.d.ts +139 -0
- package/dist/session/Session.d.ts.map +1 -0
- package/dist/session/Session.js +344 -0
- package/dist/session/Session.js.map +1 -0
- package/dist/session/index.d.ts +6 -0
- package/dist/session/index.d.ts.map +1 -0
- package/dist/session/index.js +15 -0
- package/dist/session/index.js.map +1 -0
- package/dist/session/matchUtils.d.ts +22 -0
- package/dist/session/matchUtils.d.ts.map +1 -0
- package/dist/session/matchUtils.js +138 -0
- package/dist/session/matchUtils.js.map +1 -0
- package/dist/stream/StreamEvent.d.ts +193 -0
- package/dist/stream/StreamEvent.d.ts.map +1 -0
- package/dist/stream/StreamEvent.js +44 -0
- package/dist/stream/StreamEvent.js.map +1 -0
- package/dist/stream/StreamParser.d.ts +47 -0
- package/dist/stream/StreamParser.d.ts.map +1 -0
- package/dist/stream/StreamParser.js +225 -0
- package/dist/stream/StreamParser.js.map +1 -0
- package/dist/stream/index.d.ts +3 -0
- package/dist/stream/index.d.ts.map +1 -0
- package/dist/stream/index.js +8 -0
- package/dist/stream/index.js.map +1 -0
- package/dist/tool/Context.d.ts +30 -0
- package/dist/tool/Context.d.ts.map +1 -0
- package/dist/tool/Context.js +50 -0
- package/dist/tool/Context.js.map +1 -0
- package/dist/tool/Hook.d.ts +23 -0
- package/dist/tool/Hook.d.ts.map +1 -0
- package/dist/tool/Hook.js +27 -0
- package/dist/tool/Hook.js.map +1 -0
- package/dist/tool/McpToolAdapter.d.ts +47 -0
- package/dist/tool/McpToolAdapter.d.ts.map +1 -0
- package/dist/tool/McpToolAdapter.js +88 -0
- package/dist/tool/McpToolAdapter.js.map +1 -0
- package/dist/tool/Param.d.ts +68 -0
- package/dist/tool/Param.d.ts.map +1 -0
- package/dist/tool/Param.js +161 -0
- package/dist/tool/Param.js.map +1 -0
- package/dist/tool/Tool.d.ts +92 -0
- package/dist/tool/Tool.d.ts.map +1 -0
- package/dist/tool/Tool.js +198 -0
- package/dist/tool/Tool.js.map +1 -0
- package/dist/tool/ToolCall.d.ts +37 -0
- package/dist/tool/ToolCall.d.ts.map +1 -0
- package/dist/tool/ToolCall.js +118 -0
- package/dist/tool/ToolCall.js.map +1 -0
- package/dist/tool/ToolKit.d.ts +87 -0
- package/dist/tool/ToolKit.d.ts.map +1 -0
- package/dist/tool/ToolKit.js +173 -0
- package/dist/tool/ToolKit.js.map +1 -0
- package/dist/tool/ValueType.d.ts +12 -0
- package/dist/tool/ValueType.d.ts.map +1 -0
- package/dist/tool/ValueType.js +16 -0
- package/dist/tool/ValueType.js.map +1 -0
- package/dist/tool/index.d.ts +9 -0
- package/dist/tool/index.d.ts.map +1 -0
- package/dist/tool/index.js +21 -0
- package/dist/tool/index.js.map +1 -0
- package/dist/utils/generateId.d.ts +10 -0
- package/dist/utils/generateId.d.ts.map +1 -0
- package/dist/utils/generateId.js +18 -0
- package/dist/utils/generateId.js.map +1 -0
- package/dist/utils/index.d.ts +2 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +6 -0
- package/dist/utils/index.js.map +1 -0
- package/package.json +72 -0
|
@@ -0,0 +1,465 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PromptBuilder = void 0;
|
|
4
|
+
const Message_1 = require("../message/Message");
|
|
5
|
+
const Role_1 = require("../message/Role");
|
|
6
|
+
const Injection_1 = require("./Injection");
|
|
7
|
+
/**
|
|
8
|
+
* 提示词构建器
|
|
9
|
+
*
|
|
10
|
+
* 管理一组 Injection(注入声明),在 build 时将它们按规则插入到
|
|
11
|
+
* 历史消息数组中,产出最终的上下文列表。
|
|
12
|
+
*
|
|
13
|
+
* 核心特性:
|
|
14
|
+
* - 不修改原始history 数组和 Message 对象
|
|
15
|
+
* - 声明式:Rule描述定位,build 时才执行
|
|
16
|
+
* - 生命周期:每次 build 自动消耗 life
|
|
17
|
+
* - 可复用:同一 Rule 可绑定多条不同 Message
|
|
18
|
+
*
|
|
19
|
+
* 用法:
|
|
20
|
+
* const builder = new PromptBuilder();
|
|
21
|
+
* builder.injectSystem(Rule.top().after(), "当前时间:2025年");
|
|
22
|
+
* builder.injectSystem(Rule.byRole(Role.User).last().before(), "请用英文",3);
|
|
23
|
+
*
|
|
24
|
+
* const context = builder.build(session.history());
|
|
25
|
+
* // context包含注入后的完整上下文,可直接传给Adapter
|
|
26
|
+
*/
|
|
27
|
+
class PromptBuilder {
|
|
28
|
+
_injections = [];
|
|
29
|
+
_sequenceCounter = 0;
|
|
30
|
+
// ========================
|
|
31
|
+
// 注册注入
|
|
32
|
+
// ========================
|
|
33
|
+
/**
|
|
34
|
+
* 注入一条消息
|
|
35
|
+
*
|
|
36
|
+
* @param rule 定位规则
|
|
37
|
+
* @param message 要注入的 Message
|
|
38
|
+
* @param options 注入配置(life / probability / priority)或直接传 life数字
|
|
39
|
+
* @returns 创建的 Injection 实例(可用于后续管理)
|
|
40
|
+
*/
|
|
41
|
+
inject(rule, message, options) {
|
|
42
|
+
const opts = this.normalizeOptions(options);
|
|
43
|
+
const injection = new Injection_1.Injection(rule, message, opts.life ?? -1);
|
|
44
|
+
if (opts.probability !== undefined) {
|
|
45
|
+
injection.probability = opts.probability;
|
|
46
|
+
}
|
|
47
|
+
if (opts.priority !== undefined) {
|
|
48
|
+
injection.priority = opts.priority;
|
|
49
|
+
}
|
|
50
|
+
injection.sequence = this._sequenceCounter++;
|
|
51
|
+
this._injections.push(injection);
|
|
52
|
+
return injection;
|
|
53
|
+
}
|
|
54
|
+
// ---- 便捷方法:自动创建指定角色的 Message ----
|
|
55
|
+
/**
|
|
56
|
+
* 注入一条 System 消息
|
|
57
|
+
*/
|
|
58
|
+
injectSystem(rule, content, options) {
|
|
59
|
+
return this.inject(rule, this.createSystemMessage(content), options);
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* 注入一条 User 消息
|
|
63
|
+
*/
|
|
64
|
+
injectUser(rule, content, options) {
|
|
65
|
+
return this.inject(rule, Message_1.Message.user(content), options);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* 注入一条 Assistant 消息
|
|
69
|
+
*/
|
|
70
|
+
injectAssistant(rule, content, options) {
|
|
71
|
+
return this.inject(rule, Message_1.Message.assistant(content), options);
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* 批量注入:同一规则,多条消息,各自独立生命周期
|
|
75
|
+
*/
|
|
76
|
+
injectAll(rule, messages, options) {
|
|
77
|
+
return messages.map((msg) => this.inject(rule, msg, options));
|
|
78
|
+
}
|
|
79
|
+
// ========================
|
|
80
|
+
// 管理
|
|
81
|
+
// ========================
|
|
82
|
+
/** 移除某个注入 */
|
|
83
|
+
remove(injection) {
|
|
84
|
+
const index = this._injections.indexOf(injection);
|
|
85
|
+
if (index !== -1) {
|
|
86
|
+
this._injections.splice(index, 1);
|
|
87
|
+
}
|
|
88
|
+
return this;
|
|
89
|
+
}
|
|
90
|
+
/** 按ID 移除 */
|
|
91
|
+
removeById(id) {
|
|
92
|
+
const index = this._injections.findIndex((inj) => inj.id === id);
|
|
93
|
+
if (index !== -1) {
|
|
94
|
+
this._injections.splice(index, 1);
|
|
95
|
+
}
|
|
96
|
+
return this;
|
|
97
|
+
}
|
|
98
|
+
/** 移除某规则关联的所有注入 */
|
|
99
|
+
removeByRule(rule) {
|
|
100
|
+
this._injections = this._injections.filter((inj) => inj.rule !== rule);
|
|
101
|
+
return this;
|
|
102
|
+
}
|
|
103
|
+
/** 启用某个注入 */
|
|
104
|
+
enable(injection) {
|
|
105
|
+
injection.enabled = true;
|
|
106
|
+
return this;
|
|
107
|
+
}
|
|
108
|
+
/** 禁用某个注入(不消耗 life) */
|
|
109
|
+
disable(injection) {
|
|
110
|
+
injection.enabled = false;
|
|
111
|
+
return this;
|
|
112
|
+
}
|
|
113
|
+
/** 清理所有 life === 0 的过期注入 */
|
|
114
|
+
prune() {
|
|
115
|
+
this._injections = this._injections.filter((inj) => inj.isAlive);
|
|
116
|
+
return this;
|
|
117
|
+
}
|
|
118
|
+
/** 清空所有注入 */
|
|
119
|
+
clearInjections() {
|
|
120
|
+
this._injections = [];
|
|
121
|
+
this._sequenceCounter = 0;
|
|
122
|
+
return this;
|
|
123
|
+
}
|
|
124
|
+
/** 清空所有注入(别名) */
|
|
125
|
+
clear() {
|
|
126
|
+
return this.clearInjections();
|
|
127
|
+
}
|
|
128
|
+
// ========================
|
|
129
|
+
// 数组操作
|
|
130
|
+
// ========================
|
|
131
|
+
/** 操作管线 */
|
|
132
|
+
_operations = [];
|
|
133
|
+
/**
|
|
134
|
+
* 注册一个数组操作
|
|
135
|
+
*
|
|
136
|
+
* 操作在 build 时按注册顺序执行(在注入之后)。
|
|
137
|
+
* 每个操作接收当前 Message[],返回新的 Message[]。
|
|
138
|
+
*
|
|
139
|
+
* @param op 操作函数
|
|
140
|
+
* @param label 可选标签,用于后续查找/移除
|
|
141
|
+
* @returns this(链式)
|
|
142
|
+
*
|
|
143
|
+
* 用法:
|
|
144
|
+
* builder.use(msgs => msgs.filter(m => !m.hasTag("debug")));
|
|
145
|
+
* builder.use(msgs => msgs.slice(-20), "keep_recent");
|
|
146
|
+
*/
|
|
147
|
+
use(op, label) {
|
|
148
|
+
this._operations.push({ op, label });
|
|
149
|
+
return this;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* 在指定位置插入消息
|
|
153
|
+
*
|
|
154
|
+
* @param index 插入位置(支持负索引,-1 表示末尾之前)
|
|
155
|
+
* @param message 要插入的消息
|
|
156
|
+
* @param label 可选标签
|
|
157
|
+
*
|
|
158
|
+
* 用法:
|
|
159
|
+
* builder.insertAt(1, Message.system("提示")); // 第二条之前插入
|
|
160
|
+
* builder.insertAt(-1, Message.user("补充")); // 倒数第一条之前
|
|
161
|
+
*/
|
|
162
|
+
insertAt(index, message, label) {
|
|
163
|
+
const msgs = Array.isArray(message) ? message : [message];
|
|
164
|
+
return this.use((arr) => {
|
|
165
|
+
const result = [...arr];
|
|
166
|
+
const resolvedIndex = index < 0 ? Math.max(0, result.length + index + 1) : Math.min(index, result.length);
|
|
167
|
+
result.splice(resolvedIndex, 0, ...msgs);
|
|
168
|
+
return result;
|
|
169
|
+
}, label);
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* 移除指定位置的消息
|
|
173
|
+
*
|
|
174
|
+
* @param index 位置(支持负索引)
|
|
175
|
+
* @param count 移除数量,默认 1
|
|
176
|
+
* @param label 可选标签
|
|
177
|
+
*/
|
|
178
|
+
removeAt(index, count = 1, label) {
|
|
179
|
+
return this.use((arr) => {
|
|
180
|
+
const result = [...arr];
|
|
181
|
+
const resolvedIndex = index < 0 ? result.length + index : index;
|
|
182
|
+
if (resolvedIndex >= 0 && resolvedIndex < result.length) {
|
|
183
|
+
result.splice(resolvedIndex, count);
|
|
184
|
+
}
|
|
185
|
+
return result;
|
|
186
|
+
}, label);
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* 按条件移除消息
|
|
190
|
+
*
|
|
191
|
+
* @param predicate 条件函数,返回 true 的消息将被移除
|
|
192
|
+
* @param label 可选标签
|
|
193
|
+
*
|
|
194
|
+
* 用法:
|
|
195
|
+
* builder.removeWhere(m => m.hasTag("debug"));
|
|
196
|
+
* builder.removeWhere((m, i) => i > 20);
|
|
197
|
+
*/
|
|
198
|
+
removeWhere(predicate, label) {
|
|
199
|
+
return this.use((arr) => arr.filter((msg, i) => !predicate(msg, i)), label);
|
|
200
|
+
}
|
|
201
|
+
/**
|
|
202
|
+
* 按条件替换消息
|
|
203
|
+
*
|
|
204
|
+
* @param predicate 条件函数
|
|
205
|
+
* @param replacer 替换函数,返回新消息(返回 null 则移除该消息)
|
|
206
|
+
* @param label 可选标签
|
|
207
|
+
*
|
|
208
|
+
* 用法:
|
|
209
|
+
* builder.replaceWhere(
|
|
210
|
+
* m => m.role === Role.System,
|
|
211
|
+
* m => Message.system(m.text + "\n附加指令")
|
|
212
|
+
* );
|
|
213
|
+
*/
|
|
214
|
+
replaceWhere(predicate, replacer, label) {
|
|
215
|
+
return this.use((arr) => {
|
|
216
|
+
const result = [];
|
|
217
|
+
for (let i = 0; i < arr.length; i++) {
|
|
218
|
+
if (predicate(arr[i], i)) {
|
|
219
|
+
const replacement = replacer(arr[i], i);
|
|
220
|
+
if (replacement !== null)
|
|
221
|
+
result.push(replacement);
|
|
222
|
+
}
|
|
223
|
+
else {
|
|
224
|
+
result.push(arr[i]);
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
return result;
|
|
228
|
+
}, label);
|
|
229
|
+
}
|
|
230
|
+
/**
|
|
231
|
+
* 保留满足条件的消息(过滤)
|
|
232
|
+
*
|
|
233
|
+
* @param predicate 条件函数,返回 true 的消息保留
|
|
234
|
+
* @param label 可选标签
|
|
235
|
+
*
|
|
236
|
+
* 用法:
|
|
237
|
+
* builder.filter(m => m.role !== Role.System || m.text.length > 0);
|
|
238
|
+
*/
|
|
239
|
+
filter(predicate, label) {
|
|
240
|
+
return this.use((arr) => arr.filter(predicate), label);
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* 截取消息数组的子集
|
|
244
|
+
*
|
|
245
|
+
* @param start 起始位置(支持负索引)
|
|
246
|
+
* @param end 结束位置(可选,支持负索引)
|
|
247
|
+
* @param label 可选标签
|
|
248
|
+
*
|
|
249
|
+
* 用法:
|
|
250
|
+
* builder.slice(-10);// 只保留最近 10 条
|
|
251
|
+
* builder.slice(0, 5); // 只保留前 5 条
|
|
252
|
+
*/
|
|
253
|
+
slice(start, end, label) {
|
|
254
|
+
return this.use((arr) => arr.slice(start, end), label);
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* 映射变换消息
|
|
258
|
+
*
|
|
259
|
+
* @param fn 映射函数
|
|
260
|
+
* @param label 可选标签
|
|
261
|
+
*/
|
|
262
|
+
map(fn, label) {
|
|
263
|
+
return this.use((arr) => arr.map(fn), label);
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* 自由变换 — 最灵活的操作
|
|
267
|
+
*
|
|
268
|
+
* @param fn 变换函数,接收完整数组返回新数组
|
|
269
|
+
* @param label 可选标签
|
|
270
|
+
*
|
|
271
|
+
* 用法:
|
|
272
|
+
* builder.transform(msgs => {
|
|
273
|
+
* // 自定义上下文窗口管理
|
|
274
|
+
* const system = msgs.filter(m => m.role === Role.System);
|
|
275
|
+
* const recent = msgs.filter(m => m.role !== Role.System).slice(-10);
|
|
276
|
+
*return [...system, ...recent];
|
|
277
|
+
* }, "window");
|
|
278
|
+
*/
|
|
279
|
+
transform(fn, label) {
|
|
280
|
+
return this.use(fn, label);
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* 按标签移除操作
|
|
284
|
+
*/
|
|
285
|
+
removeOperation(label) {
|
|
286
|
+
this._operations = this._operations.filter((o) => o.label !== label);
|
|
287
|
+
return this;
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* 清空所有操作
|
|
291
|
+
*/
|
|
292
|
+
clearOperations() {
|
|
293
|
+
this._operations = [];
|
|
294
|
+
return this;
|
|
295
|
+
}
|
|
296
|
+
/** 所有操作(只读视图) */
|
|
297
|
+
get operations() {
|
|
298
|
+
return this._operations;
|
|
299
|
+
}
|
|
300
|
+
// ========================
|
|
301
|
+
// 核心:构建
|
|
302
|
+
// ========================
|
|
303
|
+
/**
|
|
304
|
+
* 输入原始历史,输出注入后的最终上下文
|
|
305
|
+
*
|
|
306
|
+
* 流程(默认 batch 策略):
|
|
307
|
+
* 1. 浅拷贝 history 数组
|
|
308
|
+
* 2. 筛选所有 isActive 且通过概率判定的 Injection
|
|
309
|
+
* 3. 每个 Injection 的 Rule 都在同一份原始数组上 resolve 出插入索引
|
|
310
|
+
* 4. 收集所有 InsertOp,按索引降序排列(从后往前插入避免偏移)
|
|
311
|
+
* 5. 执行插入
|
|
312
|
+
* 6. 消耗 life
|
|
313
|
+
* 7. 执行数组操作管线
|
|
314
|
+
* 8. 返回新数组
|
|
315
|
+
*
|
|
316
|
+
* immediate 策略会按 Injection.priority 从小到大逐条执行 Injection;
|
|
317
|
+
* 相同 priority 时按注册顺序执行。
|
|
318
|
+
* 前一条 Injection 插入的消息,会进入后一条 Injection 的 Rule 定位范围。
|
|
319
|
+
* 同一个 Injection 内部只 resolve 一次,不会递归匹配自己刚插入的消息。
|
|
320
|
+
*
|
|
321
|
+
* @param history 原始消息数组(不会被修改)
|
|
322
|
+
* @param options 构建选项,strategy 默认为 "batch"
|
|
323
|
+
* @returns 注入 + 操作后的新消息数组
|
|
324
|
+
*/
|
|
325
|
+
build(history, options) {
|
|
326
|
+
const strategy = options?.strategy ?? "batch";
|
|
327
|
+
return strategy === "immediate"
|
|
328
|
+
? this.buildImmediateInternal(history)
|
|
329
|
+
: this.buildBatch(history);
|
|
330
|
+
}
|
|
331
|
+
/**
|
|
332
|
+
* 即时构建:后续 Injection 可以看到前序 Injection 的插入结果。
|
|
333
|
+
*
|
|
334
|
+
* 等价于:build(history, { strategy: "immediate" })
|
|
335
|
+
*/
|
|
336
|
+
buildImmediate(history) {
|
|
337
|
+
return this.buildImmediateInternal(history);
|
|
338
|
+
}
|
|
339
|
+
/**
|
|
340
|
+
* 批量构建:所有 Injection 都基于原始 history 定位。
|
|
341
|
+
*
|
|
342
|
+
* 等价于:build(history, { strategy: "batch" }),也是默认行为。
|
|
343
|
+
*/
|
|
344
|
+
buildBatch(history) {
|
|
345
|
+
let result = [...history];
|
|
346
|
+
// ---- 阶段 1:执行声明式注入(批量定位,统一插入) ----
|
|
347
|
+
const activeInjections = this.getTriggeredInjections();
|
|
348
|
+
if (activeInjections.length > 0) {
|
|
349
|
+
const ops = [];
|
|
350
|
+
for (const injection of activeInjections) {
|
|
351
|
+
ops.push(...this.createInsertOps(injection, result));
|
|
352
|
+
}
|
|
353
|
+
this.applyInsertOps(result, ops);
|
|
354
|
+
// 消耗生命:保持旧语义,只要本次通过概率判定,即使没有匹配到位置也消耗
|
|
355
|
+
for (const injection of activeInjections) {
|
|
356
|
+
injection.consume();
|
|
357
|
+
}
|
|
358
|
+
}
|
|
359
|
+
return this.applyOperations(result);
|
|
360
|
+
}
|
|
361
|
+
buildImmediateInternal(history) {
|
|
362
|
+
let result = [...history];
|
|
363
|
+
// ---- 阶段 1:执行声明式注入(逐条定位,立即插入) ----
|
|
364
|
+
const activeInjections = this.getTriggeredInjections();
|
|
365
|
+
for (const injection of activeInjections) {
|
|
366
|
+
const ops = this.createInsertOps(injection, result);
|
|
367
|
+
this.applyInsertOps(result, ops);
|
|
368
|
+
// 保持与 batch 一致:只要本次通过概率判定,即使没有匹配到位置也消耗
|
|
369
|
+
injection.consume();
|
|
370
|
+
}
|
|
371
|
+
return this.applyOperations(result);
|
|
372
|
+
}
|
|
373
|
+
getTriggeredInjections() {
|
|
374
|
+
return [...this._injections]
|
|
375
|
+
.filter((inj) => inj.isActive)
|
|
376
|
+
.sort((a, b) => {
|
|
377
|
+
if (a.priority !== b.priority)
|
|
378
|
+
return a.priority - b.priority;
|
|
379
|
+
return a.sequence - b.sequence;
|
|
380
|
+
})
|
|
381
|
+
.filter((inj) => inj.rollTrigger());
|
|
382
|
+
}
|
|
383
|
+
createInsertOps(injection, messages) {
|
|
384
|
+
const indices = injection.rule.resolve(messages);
|
|
385
|
+
return indices.map((index) => ({
|
|
386
|
+
index,
|
|
387
|
+
message: injection.message,
|
|
388
|
+
order: injection.rule.orderValue,
|
|
389
|
+
sequence: injection.sequence,
|
|
390
|
+
}));
|
|
391
|
+
}
|
|
392
|
+
applyInsertOps(result, ops) {
|
|
393
|
+
if (ops.length === 0)
|
|
394
|
+
return;
|
|
395
|
+
// 排序策略:
|
|
396
|
+
// 1. 按插入索引降序(从后往前插入,避免索引偏移)
|
|
397
|
+
// 2. 同索引时,按 order 降序 + sequence 降序
|
|
398
|
+
//
|
|
399
|
+
// 注意:splice(index, 0, item) 会把后插入的 item 放到同 index 更前面,
|
|
400
|
+
// 因此这里用降序,最终呈现效果是 order 小的在前、注册早的在前。
|
|
401
|
+
ops.sort((a, b) => {
|
|
402
|
+
if (a.index !== b.index)
|
|
403
|
+
return b.index - a.index;
|
|
404
|
+
if (a.order !== b.order)
|
|
405
|
+
return b.order - a.order;
|
|
406
|
+
return b.sequence - a.sequence;
|
|
407
|
+
});
|
|
408
|
+
for (const op of ops) {
|
|
409
|
+
result.splice(op.index, 0, op.message);
|
|
410
|
+
}
|
|
411
|
+
}
|
|
412
|
+
applyOperations(messages) {
|
|
413
|
+
let result = messages;
|
|
414
|
+
// ---- 阶段 2:执行数组操作管线 ----
|
|
415
|
+
for (const { op } of this._operations) {
|
|
416
|
+
result = op(result);
|
|
417
|
+
}
|
|
418
|
+
return result;
|
|
419
|
+
}
|
|
420
|
+
// ========================
|
|
421
|
+
// 查询
|
|
422
|
+
// ========================
|
|
423
|
+
/** 所有注入(只读视图) */
|
|
424
|
+
get injections() {
|
|
425
|
+
return this._injections;
|
|
426
|
+
}
|
|
427
|
+
/** 存活注入数*/
|
|
428
|
+
get aliveCount() {
|
|
429
|
+
return this._injections.filter((inj) => inj.isAlive).length;
|
|
430
|
+
}
|
|
431
|
+
/** 过期注入数 */
|
|
432
|
+
get expiredCount() {
|
|
433
|
+
return this._injections.filter((inj) => !inj.isAlive).length;
|
|
434
|
+
}
|
|
435
|
+
/** 当前活跃注入数(存活且启用) */
|
|
436
|
+
get activeCount() {
|
|
437
|
+
return this._injections.filter((inj) => inj.isActive).length;
|
|
438
|
+
}
|
|
439
|
+
/** 按规则查找注入 */
|
|
440
|
+
findByRule(rule) {
|
|
441
|
+
return this._injections.filter((inj) => inj.rule === rule);
|
|
442
|
+
}
|
|
443
|
+
/** 按 ID 查找注入 */
|
|
444
|
+
findById(id) {
|
|
445
|
+
return this._injections.find((inj) => inj.id === id);
|
|
446
|
+
}
|
|
447
|
+
// ========================
|
|
448
|
+
// 内部辅助
|
|
449
|
+
// ========================
|
|
450
|
+
normalizeOptions(options) {
|
|
451
|
+
if (options === undefined)
|
|
452
|
+
return {};
|
|
453
|
+
if (typeof options === "number")
|
|
454
|
+
return { life: options };
|
|
455
|
+
return options;
|
|
456
|
+
}
|
|
457
|
+
createSystemMessage(content) {
|
|
458
|
+
if (typeof content === "string") {
|
|
459
|
+
return Message_1.Message.system(content);
|
|
460
|
+
}
|
|
461
|
+
return new Message_1.Message(Role_1.Role.System, Array.isArray(content) ? content : [content]);
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
exports.PromptBuilder = PromptBuilder;
|
|
465
|
+
//# sourceMappingURL=PromptBuilder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PromptBuilder.js","sourceRoot":"","sources":["../../src/prompt/PromptBuilder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { Message } from "../message/Message";
|
|
2
|
+
import { Role } from "../message/Role";
|
|
3
|
+
import { MatchMode } from "../session/SearchCriteria";
|
|
4
|
+
/**
|
|
5
|
+
* 声明式插入规则
|
|
6
|
+
*
|
|
7
|
+
* 描述"在哪里插入",build 时才真正执行定位。
|
|
8
|
+
* 规则无状态、可复用 — 同一条 Rule 可以绑定多条不同的 Message。
|
|
9
|
+
*
|
|
10
|
+
* 用法:
|
|
11
|
+
* Rule.top().after() // 第一条消息之后
|
|
12
|
+
* Rule.byRole(Role.User).last().before() // 最后一条 User 之前
|
|
13
|
+
* Rule.byTags(["ctx"]).all().after() // 每条带ctx 标签的消息之后
|
|
14
|
+
* Rule.index(-1).before().order(5) // 倒数第1条之前,排序权重5
|
|
15
|
+
*/
|
|
16
|
+
export declare class Rule {
|
|
17
|
+
private _anchor;
|
|
18
|
+
private _select;
|
|
19
|
+
private _direction;
|
|
20
|
+
private _offset;
|
|
21
|
+
private _order;
|
|
22
|
+
private _scanDepth?;
|
|
23
|
+
private _scanDirection;
|
|
24
|
+
private constructor();
|
|
25
|
+
/** 定位到第一条消息 */
|
|
26
|
+
static top(): Rule;
|
|
27
|
+
/** 定位到最后一条消息 */
|
|
28
|
+
static bottom(): Rule;
|
|
29
|
+
/** 定位到第n 条(支持负索引,-1 为倒数第一) */
|
|
30
|
+
static index(n: number): Rule;
|
|
31
|
+
/** 按角色定位 */
|
|
32
|
+
static byRole(role: Role, options?: {
|
|
33
|
+
mode?: MatchMode;
|
|
34
|
+
}): Rule;
|
|
35
|
+
/** 按内容关键词/正则定位 */
|
|
36
|
+
static byContent(keywords: (string | RegExp)[], options?: {
|
|
37
|
+
mode?: MatchMode;
|
|
38
|
+
roles?: Role[];
|
|
39
|
+
}): Rule;
|
|
40
|
+
/** 按标签定位 */
|
|
41
|
+
static byTags(tags: (string | RegExp)[], options?: {
|
|
42
|
+
mode?: MatchMode;
|
|
43
|
+
roles?: Role[];
|
|
44
|
+
}): Rule;
|
|
45
|
+
/** 自定义谓词定位 */
|
|
46
|
+
static by(fn: (msg: Message, index: number) => boolean): Rule;
|
|
47
|
+
/** 取第一个匹配 */
|
|
48
|
+
first(): this;
|
|
49
|
+
/** 取最后一个匹配(默认) */
|
|
50
|
+
last(): this;
|
|
51
|
+
/** 所有匹配点都插入 */
|
|
52
|
+
all(): this;
|
|
53
|
+
/** 在定位结果上偏移 n 个位置(正数向后,负数向前) */
|
|
54
|
+
offset(n: number): this;
|
|
55
|
+
/** 在锚点之前插入 */
|
|
56
|
+
before(): this;
|
|
57
|
+
/** 在锚点之后插入(默认) */
|
|
58
|
+
after(): this;
|
|
59
|
+
/** 同位置多条注入时的排序,数字越小越靠前,默认 0 */
|
|
60
|
+
order(n: number): this;
|
|
61
|
+
/**
|
|
62
|
+
* 设置扫描深度(只扫描 N 条消息来匹配关键词/标签/谓词)
|
|
63
|
+
*
|
|
64
|
+
* 仅影响搜索型定位(byContent/byTags/byRole/by),
|
|
65
|
+
* 不影响位置型定位(top/bottom/index)。
|
|
66
|
+
* 默认不限制(扫描全部历史)。
|
|
67
|
+
*
|
|
68
|
+
* @param n 扫描条数
|
|
69
|
+
*/
|
|
70
|
+
scanDepth(n: number): this;
|
|
71
|
+
/** 正向扫描 — 从顶部开始扫描 scanDepth 条 */
|
|
72
|
+
scanForward(): this;
|
|
73
|
+
/** 反向扫描 — 从底部开始扫描 scanDepth 条(默认) */
|
|
74
|
+
scanReverse(): this;
|
|
75
|
+
/** 获取排序权重 */
|
|
76
|
+
get orderValue(): number;
|
|
77
|
+
/**
|
|
78
|
+
* 在给定的messages 数组中解析出所有插入索引
|
|
79
|
+
*
|
|
80
|
+
* 返回的索引可直接用于 splice(index, 0, msg) 插入。
|
|
81
|
+
* 找不到匹配时返回空数组(静默跳过)。
|
|
82
|
+
*
|
|
83
|
+
* @param messages 原始消息数组
|
|
84
|
+
* @returns 插入位置索引数组(已去重、升序)
|
|
85
|
+
*/
|
|
86
|
+
resolve(messages: Message[]): number[];
|
|
87
|
+
private findAnchors;
|
|
88
|
+
/**
|
|
89
|
+
* 计算扫描范围 [start, end)
|
|
90
|
+
*/
|
|
91
|
+
private getScanRange;
|
|
92
|
+
/**
|
|
93
|
+
* 在指定范围内匹配,返回绝对索引
|
|
94
|
+
*/
|
|
95
|
+
private matchInRange;
|
|
96
|
+
private applySelect;
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=Rule.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../src/prompt/Rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAkB,MAAM,2BAA2B,CAAC;AAmBtE;;;;;;;;;;;GAWG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAoC;IAE1D,OAAO;IAQP,eAAe;IACf,MAAM,CAAC,GAAG,IAAI,IAAI;IAIlB,gBAAgB;IAChB,MAAM,CAAC,MAAM,IAAI,IAAI;IAIrB,8BAA8B;IAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7B,YAAY;IACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI;IAQ/D,kBAAkB;IAClB,MAAM,CAAC,SAAS,CACd,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC7B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,GAC7C,IAAI;IAIP,YAAY;IACZ,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACzB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,GAC7C,IAAI;IAIP,cAAc;IACd,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IAQ7D,aAAa;IACb,KAAK,IAAI,IAAI;IAKb,kBAAkB;IAClB,IAAI,IAAI,IAAI;IAKZ,eAAe;IACf,GAAG,IAAI,IAAI;IASX,gCAAgC;IAChC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IASvB,cAAc;IACd,MAAM,IAAI,IAAI;IAKd,kBAAkB;IAClB,KAAK,IAAI,IAAI;IASb,+BAA+B;IAC/B,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAStB;;;;;;;;OAQG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B,iCAAiC;IACjC,WAAW,IAAI,IAAI;IAKnB,qCAAqC;IACrC,WAAW,IAAI,IAAI;IASnB,aAAa;IACb,IAAI,UAAU,IAAI,MAAM,CAEvB;IAMD;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE;IAkCtC,OAAO,CAAC,WAAW;IAmEnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,WAAW;CAUpB"}
|