@aalis/api-agent 0.8.0 → 0.9.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/README.md +3 -3
- package/dist/index.d.ts +18 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +8 -9
package/README.md
CHANGED
package/dist/index.d.ts
CHANGED
|
@@ -3,10 +3,9 @@ import type { ToolCallContext, ToolDefinition } from '@aalis/api-tools';
|
|
|
3
3
|
import type { ServiceRef } from '@aalis/core';
|
|
4
4
|
import type { IncomingMessage, Message } from '@aalis/schema-message';
|
|
5
5
|
/**
|
|
6
|
-
*
|
|
6
|
+
* 插件分组信息（按子系统聚合）
|
|
7
7
|
*
|
|
8
|
-
* Agent 服务通过 `getPluginGroups()`
|
|
9
|
-
* 由 dashboard 据此把插件归入对应的子系统面板。
|
|
8
|
+
* Agent 服务通过 `getPluginGroups()` 暴露当前活跃插件的分组结构。
|
|
10
9
|
*/
|
|
11
10
|
export interface PluginGroupInfo {
|
|
12
11
|
/** 分组显示名称 */
|
|
@@ -33,7 +32,7 @@ export interface PreprocessorInfo {
|
|
|
33
32
|
* 负责接收用户消息并编排完整的对话流程：
|
|
34
33
|
* 组装系统提示、加载历史、调用 LLM、执行工具调用循环、发出回复。
|
|
35
34
|
*
|
|
36
|
-
* 默认由 plugin-agent
|
|
35
|
+
* 默认由 @aalis/plugin-agent 提供。
|
|
37
36
|
* 外部插件可以注册自己的 AgentService 来完全接管或扩展对话编排逻辑。
|
|
38
37
|
*/
|
|
39
38
|
export interface AgentService {
|
|
@@ -53,12 +52,12 @@ export interface AgentService {
|
|
|
53
52
|
/**
|
|
54
53
|
* 获取 Agent 子系统的插件分组
|
|
55
54
|
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
55
|
+
* 按 Agent 域服务名（llm / memory / persona / message-archive，不含 platform）
|
|
56
|
+
* 找出提供这些服务的插件，返回分组信息。
|
|
58
57
|
*/
|
|
59
58
|
getPluginGroups?(): PluginGroupInfo[];
|
|
60
59
|
}
|
|
61
|
-
declare module '@aalis/
|
|
60
|
+
declare module '@aalis/api-hooks' {
|
|
62
61
|
interface HookContextMap {
|
|
63
62
|
'agent:input:before': {
|
|
64
63
|
message: IncomingMessage;
|
|
@@ -87,6 +86,13 @@ declare module '@aalis/core' {
|
|
|
87
86
|
'agent:reply:before': {
|
|
88
87
|
content: string;
|
|
89
88
|
archiveContent?: string;
|
|
89
|
+
/**
|
|
90
|
+
* 回复的可见正文（用户实际看到的文本）。缺省时 agent 以 `content` 为可见正文；`content` 不是
|
|
91
|
+
* 可见正文时中间件应填写，如 persona 的客户端渲染模式下 `content` 保留整串 JSON 交给前端解码。
|
|
92
|
+
* 与落库内容不同时，agent 把它写进 assistant 消息的 metadata（键为 schema-message 的
|
|
93
|
+
* `WellKnownMetadataKeys.VisibleContent`）。
|
|
94
|
+
*/
|
|
95
|
+
visibleContent?: string;
|
|
90
96
|
sessionId: string;
|
|
91
97
|
platform?: string;
|
|
92
98
|
userId?: string;
|
|
@@ -190,10 +196,11 @@ export interface PromptContributionView {
|
|
|
190
196
|
readonly messages: readonly Message[];
|
|
191
197
|
}
|
|
192
198
|
/**
|
|
193
|
-
* `agent:prompt` 贡献点的 spec——经 `
|
|
199
|
+
* `agent:prompt` 贡献点的 spec——经 `contributions.contribute('agent:prompt', spec)` 注册
|
|
200
|
+
* （描述符来自 @aalis/api-contributions）。
|
|
194
201
|
*
|
|
195
|
-
* - `id`：局部幂等键（如 'context'、`activation:${skillName}
|
|
196
|
-
*
|
|
202
|
+
* - `id`：局部幂等键（如 'context'、`activation:${skillName}`），登记时由贡献点绑定层
|
|
203
|
+
* 冠以本激活 id 前缀成全局键 `${激活 id}/${id}`；全局键即物化块的 `metadata.injector`
|
|
197
204
|
* （token 统计 / 裁剪 / 幂等识别的归属标识）。
|
|
198
205
|
* - `build`：每次 LLM 调用前被组装器调用（含工具循环各轮；已物化过的贡献
|
|
199
206
|
* 按全局键跳过，不会重复 build）。返回 null = 本轮不交料；返回数组 =
|
|
@@ -205,7 +212,7 @@ export interface PromptContribution {
|
|
|
205
212
|
anchor: PromptAnchor;
|
|
206
213
|
build(view: PromptContributionView): string | readonly string[] | null | Promise<string | readonly string[] | null>;
|
|
207
214
|
}
|
|
208
|
-
declare module '@aalis/
|
|
215
|
+
declare module '@aalis/api-contributions' {
|
|
209
216
|
interface ContributionPointMap {
|
|
210
217
|
'agent:prompt': PromptContribution;
|
|
211
218
|
}
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,uCAAuC;AACvC,gCAAgC;AAChC,EAAE;AACF,qDAAqD;AACrD,wDAAwD;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,uCAAuC;AACvC,gCAAgC;AAChC,EAAE;AACF,qDAAqD;AACrD,wDAAwD;AAOxD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAyRxD,MAAM,CAAC,MAAM,KAAK,GAAG,aAAa,CAA2B,OAAO,EAAE,IAAI,CAAC,EAAE;IAC3E,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAA4C;QAC9E,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI;QACtB,QAAQ,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;KACnG,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,IAAI,EAAE;QACtB,oBAAoB,EAAE,CAAC,IAAY,EAAE,OAAuB,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KACtG,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aalis/api-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -19,20 +19,19 @@
|
|
|
19
19
|
"dist"
|
|
20
20
|
],
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@aalis/api-llm": ">=0.
|
|
23
|
-
"@aalis/schema-message": ">=0.
|
|
24
|
-
"@aalis/api-tools": ">=0.
|
|
22
|
+
"@aalis/api-llm": ">=0.12.0 <1.0.0",
|
|
23
|
+
"@aalis/schema-message": ">=0.9.0 <1.0.0",
|
|
24
|
+
"@aalis/api-tools": ">=0.10.0 <1.0.0",
|
|
25
|
+
"@aalis/api-hooks": ">=0.1.0 <1.0.0",
|
|
26
|
+
"@aalis/api-contributions": ">=0.1.0 <1.0.0"
|
|
25
27
|
},
|
|
26
28
|
"devDependencies": {
|
|
27
29
|
"@types/node": "^22.0.0",
|
|
28
30
|
"typescript": "^5.7.0",
|
|
29
|
-
"@aalis/core": "0.
|
|
30
|
-
},
|
|
31
|
-
"aalis": {
|
|
32
|
-
"types": true
|
|
31
|
+
"@aalis/core": "0.18.0"
|
|
33
32
|
},
|
|
34
33
|
"peerDependencies": {
|
|
35
|
-
"@aalis/core": ">=0.
|
|
34
|
+
"@aalis/core": ">=0.18.0 <1.0.0"
|
|
36
35
|
},
|
|
37
36
|
"keywords": [
|
|
38
37
|
"aalis",
|