@njuptlzf/agent-chat-protocol 0.6.0 → 0.8.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/dist/memory-provider.d.ts +34 -0
- package/package.json +1 -1
- package/src/memory-provider.ts +37 -0
|
@@ -20,6 +20,35 @@
|
|
|
20
20
|
/** 资格/子作用域;无资格的产物传 `""`,不要传 undefined 让下游自己猜。 */
|
|
21
21
|
readonly qual: string;
|
|
22
22
|
}
|
|
23
|
+
/**
|
|
24
|
+
* 一次后台 LLM 补全的请求。
|
|
25
|
+
*
|
|
26
|
+
* 刻意只暴露"给一段 system + 一段 user,拿回文本",不暴露 model / 凭据 /
|
|
27
|
+
* modelRegistry:提供方拿不到模型细节,宿主统一控超时与预算(最小权限)。
|
|
28
|
+
* 用途是记忆巩固这类后台整理——不进用户会话、不污染对话历史。
|
|
29
|
+
*/
|
|
30
|
+
export interface MemoryCompletionRequest {
|
|
31
|
+
readonly systemPrompt: string;
|
|
32
|
+
readonly userPrompt: string;
|
|
33
|
+
/** 输出 token 上限;宿主可再收紧。缺省由宿主决定。 */
|
|
34
|
+
readonly maxTokens?: number;
|
|
35
|
+
/** 宿主中止信号;提供方应透传给实现,但超时由宿主兜底。 */
|
|
36
|
+
readonly signal?: AbortSignal;
|
|
37
|
+
}
|
|
38
|
+
/** 补全结果。失败用 `ok:false` 结构化返回,不向提供方抛异常。 */
|
|
39
|
+
export interface MemoryCompletionResult {
|
|
40
|
+
readonly text: string;
|
|
41
|
+
readonly ok: boolean;
|
|
42
|
+
readonly error?: string;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* 宿主注入的后台补全能力。
|
|
46
|
+
*
|
|
47
|
+
* 提供方不得自己 spawn 进程或读 env 去实现 LLM 调用(见 extension-admission);
|
|
48
|
+
* 一律走这个回调。回调缺失(老宿主 / 未配置)= 提供方降级为不做后台整理,
|
|
49
|
+
* 记忆的读写主路径不受影响。
|
|
50
|
+
*/
|
|
51
|
+
export type MemoryCompletion = (req: MemoryCompletionRequest) => Promise<MemoryCompletionResult>;
|
|
23
52
|
/**
|
|
24
53
|
* open 的输入。
|
|
25
54
|
*
|
|
@@ -39,6 +68,11 @@ export interface MemoryProviderContext {
|
|
|
39
68
|
/** 本会话的 pi agent 目录(宿主按产品/用户分的 dataDir),提供方只读不写。 */
|
|
40
69
|
readonly agentDir: string;
|
|
41
70
|
readonly scope: MemoryScope;
|
|
71
|
+
/**
|
|
72
|
+
* 后台补全能力,由宿主实现并注入。可选:未提供时提供方必须降级为"不做后台整理"。
|
|
73
|
+
* 复用当前会话解析出的模型,失败不参与聊天主链的 failover。
|
|
74
|
+
*/
|
|
75
|
+
readonly complete?: MemoryCompletion;
|
|
42
76
|
}
|
|
43
77
|
/**
|
|
44
78
|
* 一次 open 的产物。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@njuptlzf/agent-chat-protocol",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "Wire protocol between the agentChat server and any chat UI: event, request/response and config types. Shapes only — no business semantics.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "Apache-2.0",
|
package/src/memory-provider.ts
CHANGED
|
@@ -22,6 +22,38 @@
|
|
|
22
22
|
readonly qual: string;
|
|
23
23
|
}
|
|
24
24
|
|
|
25
|
+
/**
|
|
26
|
+
* 一次后台 LLM 补全的请求。
|
|
27
|
+
*
|
|
28
|
+
* 刻意只暴露"给一段 system + 一段 user,拿回文本",不暴露 model / 凭据 /
|
|
29
|
+
* modelRegistry:提供方拿不到模型细节,宿主统一控超时与预算(最小权限)。
|
|
30
|
+
* 用途是记忆巩固这类后台整理——不进用户会话、不污染对话历史。
|
|
31
|
+
*/
|
|
32
|
+
export interface MemoryCompletionRequest {
|
|
33
|
+
readonly systemPrompt: string;
|
|
34
|
+
readonly userPrompt: string;
|
|
35
|
+
/** 输出 token 上限;宿主可再收紧。缺省由宿主决定。 */
|
|
36
|
+
readonly maxTokens?: number;
|
|
37
|
+
/** 宿主中止信号;提供方应透传给实现,但超时由宿主兜底。 */
|
|
38
|
+
readonly signal?: AbortSignal;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** 补全结果。失败用 `ok:false` 结构化返回,不向提供方抛异常。 */
|
|
42
|
+
export interface MemoryCompletionResult {
|
|
43
|
+
readonly text: string;
|
|
44
|
+
readonly ok: boolean;
|
|
45
|
+
readonly error?: string;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* 宿主注入的后台补全能力。
|
|
50
|
+
*
|
|
51
|
+
* 提供方不得自己 spawn 进程或读 env 去实现 LLM 调用(见 extension-admission);
|
|
52
|
+
* 一律走这个回调。回调缺失(老宿主 / 未配置)= 提供方降级为不做后台整理,
|
|
53
|
+
* 记忆的读写主路径不受影响。
|
|
54
|
+
*/
|
|
55
|
+
export type MemoryCompletion = (req: MemoryCompletionRequest) => Promise<MemoryCompletionResult>;
|
|
56
|
+
|
|
25
57
|
/**
|
|
26
58
|
* open 的输入。
|
|
27
59
|
*
|
|
@@ -41,6 +73,11 @@ export interface MemoryProviderContext {
|
|
|
41
73
|
/** 本会话的 pi agent 目录(宿主按产品/用户分的 dataDir),提供方只读不写。 */
|
|
42
74
|
readonly agentDir: string;
|
|
43
75
|
readonly scope: MemoryScope;
|
|
76
|
+
/**
|
|
77
|
+
* 后台补全能力,由宿主实现并注入。可选:未提供时提供方必须降级为"不做后台整理"。
|
|
78
|
+
* 复用当前会话解析出的模型,失败不参与聊天主链的 failover。
|
|
79
|
+
*/
|
|
80
|
+
readonly complete?: MemoryCompletion;
|
|
44
81
|
}
|
|
45
82
|
|
|
46
83
|
/**
|