@njuptlzf/agent-chat-protocol 0.5.1 → 0.7.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 +27 -0
- package/package.json +1 -1
- package/src/memory-provider.ts +28 -0
|
@@ -73,10 +73,26 @@ export interface MemoryProviderSession<P = unknown> {
|
|
|
73
73
|
/** 释放句柄(数据库连接、锁)。幂等。 */
|
|
74
74
|
dispose(): Promise<void>;
|
|
75
75
|
}
|
|
76
|
+
/**
|
|
77
|
+
* 提供方**声明**的能力(C6)。
|
|
78
|
+
*
|
|
79
|
+
* 这是事实声明,不是配置:宿主传入 `sharedRoot` 不等于 provider 真的用它。
|
|
80
|
+
* 声明为 `true` 的提供方必须把用户画像写进共享根、按 `erase({includeShared:true})`
|
|
81
|
+
* 单独删除,并通过 conformance 的跨 scope 用例;宿主据此在"产品依赖该能力但
|
|
82
|
+
* 选中的 provider 不支持"时告警,而不是静默丢失。
|
|
83
|
+
*
|
|
84
|
+
* 全部字段可选:老提供方不带 `capabilities` 时视为全 false,装载与会话不受影响。
|
|
85
|
+
*/
|
|
86
|
+
export interface MemoryProviderCapabilities {
|
|
87
|
+
/** 是否支持跨会话用户画像(`sharedRoot` / `target:"user"`)。缺省 false。 */
|
|
88
|
+
readonly sharedProfile?: boolean;
|
|
89
|
+
}
|
|
76
90
|
export interface MemoryProvider<P = unknown> {
|
|
77
91
|
/** 稳定标识,写进 manifest 的 `agent.memory.provider`。 */
|
|
78
92
|
readonly id: string;
|
|
79
93
|
readonly version: string;
|
|
94
|
+
/** 可选能力声明;缺省视为全部不支持(向后兼容老实现)。 */
|
|
95
|
+
readonly capabilities?: MemoryProviderCapabilities;
|
|
80
96
|
open(ctx: MemoryProviderContext): Promise<MemoryProviderSession<P>>;
|
|
81
97
|
}
|
|
82
98
|
/**
|
|
@@ -89,6 +105,17 @@ export interface MemoryProvider<P = unknown> {
|
|
|
89
105
|
export interface MemorySettings {
|
|
90
106
|
/** 注册表里的 provider id;省略 = 平台默认。 */
|
|
91
107
|
provider?: string;
|
|
108
|
+
/**
|
|
109
|
+
* 产品是否依赖跨会话用户画像(C6 的产品侧声明)。
|
|
110
|
+
*
|
|
111
|
+
* `true` = 该产品的语义要求用户偏好在所有 scope 间生效;若选中的 provider
|
|
112
|
+
* 没有声明 `capabilities.sharedProfile: true`,宿主在会话创建时告警,而不是
|
|
113
|
+
* 让能力静默丢失。默认 false(不依赖),因此老产品行为不变。
|
|
114
|
+
*
|
|
115
|
+
* 这是**依赖声明**,不是开关:宿主不会因为这里写了 true 就替 provider 造出
|
|
116
|
+
* 共享根;真正的读写仍由支持该能力的 provider 完成。
|
|
117
|
+
*/
|
|
118
|
+
requiresSharedProfile?: boolean;
|
|
92
119
|
}
|
|
93
120
|
/**
|
|
94
121
|
* 外部提供方模块的形状。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@njuptlzf/agent-chat-protocol",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.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
|
@@ -75,10 +75,27 @@ export interface MemoryProviderSession<P = unknown> {
|
|
|
75
75
|
dispose(): Promise<void>;
|
|
76
76
|
}
|
|
77
77
|
|
|
78
|
+
/**
|
|
79
|
+
* 提供方**声明**的能力(C6)。
|
|
80
|
+
*
|
|
81
|
+
* 这是事实声明,不是配置:宿主传入 `sharedRoot` 不等于 provider 真的用它。
|
|
82
|
+
* 声明为 `true` 的提供方必须把用户画像写进共享根、按 `erase({includeShared:true})`
|
|
83
|
+
* 单独删除,并通过 conformance 的跨 scope 用例;宿主据此在"产品依赖该能力但
|
|
84
|
+
* 选中的 provider 不支持"时告警,而不是静默丢失。
|
|
85
|
+
*
|
|
86
|
+
* 全部字段可选:老提供方不带 `capabilities` 时视为全 false,装载与会话不受影响。
|
|
87
|
+
*/
|
|
88
|
+
export interface MemoryProviderCapabilities {
|
|
89
|
+
/** 是否支持跨会话用户画像(`sharedRoot` / `target:"user"`)。缺省 false。 */
|
|
90
|
+
readonly sharedProfile?: boolean;
|
|
91
|
+
}
|
|
92
|
+
|
|
78
93
|
export interface MemoryProvider<P = unknown> {
|
|
79
94
|
/** 稳定标识,写进 manifest 的 `agent.memory.provider`。 */
|
|
80
95
|
readonly id: string;
|
|
81
96
|
readonly version: string;
|
|
97
|
+
/** 可选能力声明;缺省视为全部不支持(向后兼容老实现)。 */
|
|
98
|
+
readonly capabilities?: MemoryProviderCapabilities;
|
|
82
99
|
open(ctx: MemoryProviderContext): Promise<MemoryProviderSession<P>>;
|
|
83
100
|
}
|
|
84
101
|
|
|
@@ -92,6 +109,17 @@ export interface MemoryProvider<P = unknown> {
|
|
|
92
109
|
export interface MemorySettings {
|
|
93
110
|
/** 注册表里的 provider id;省略 = 平台默认。 */
|
|
94
111
|
provider?: string;
|
|
112
|
+
/**
|
|
113
|
+
* 产品是否依赖跨会话用户画像(C6 的产品侧声明)。
|
|
114
|
+
*
|
|
115
|
+
* `true` = 该产品的语义要求用户偏好在所有 scope 间生效;若选中的 provider
|
|
116
|
+
* 没有声明 `capabilities.sharedProfile: true`,宿主在会话创建时告警,而不是
|
|
117
|
+
* 让能力静默丢失。默认 false(不依赖),因此老产品行为不变。
|
|
118
|
+
*
|
|
119
|
+
* 这是**依赖声明**,不是开关:宿主不会因为这里写了 true 就替 provider 造出
|
|
120
|
+
* 共享根;真正的读写仍由支持该能力的 provider 完成。
|
|
121
|
+
*/
|
|
122
|
+
requiresSharedProfile?: boolean;
|
|
95
123
|
}
|
|
96
124
|
|
|
97
125
|
/**
|