dsh-plugin-om 0.0.58 → 0.0.60
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 +40 -23
- package/dist/client/OmConfigCard.d.ts.map +1 -1
- package/dist/client/OmWarningCard.d.ts +1 -2
- package/dist/client/OmWarningCard.d.ts.map +1 -1
- package/dist/client/definition.d.ts +3 -3
- package/dist/client/locales.d.ts +3 -5
- package/dist/client/locales.d.ts.map +1 -1
- package/dist/client/om-config-controller.d.ts +13 -16
- package/dist/client/om-config-controller.d.ts.map +1 -1
- package/dist/client.js +41 -50
- package/dist/client.js.map +1 -1
- package/dist/compress-loop.d.ts +12 -8
- package/dist/compress-loop.d.ts.map +1 -1
- package/dist/compress-tools.d.ts +18 -2
- package/dist/compress-tools.d.ts.map +1 -1
- package/dist/compress-view.d.ts +37 -4
- package/dist/compress-view.d.ts.map +1 -1
- package/dist/compress.d.ts +46 -27
- package/dist/compress.d.ts.map +1 -1
- package/dist/config.d.ts +2 -6
- package/dist/config.d.ts.map +1 -1
- package/dist/constants.d.ts +16 -2
- package/dist/constants.d.ts.map +1 -1
- package/dist/degrade.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +1369 -876
- package/dist/om-event-append.d.ts +5 -0
- package/dist/om-event-append.d.ts.map +1 -0
- package/dist/om-event.d.ts +16 -17
- package/dist/om-event.d.ts.map +1 -1
- package/dist/precompress.d.ts +1 -1
- package/dist/precompress.d.ts.map +1 -1
- package/dist/recall.d.ts +12 -20
- package/dist/recall.d.ts.map +1 -1
- package/dist/recompress.d.ts +1 -1
- package/dist/reflect.d.ts +89 -0
- package/dist/reflect.d.ts.map +1 -0
- package/dist/semantic-recall.d.ts +11 -4
- package/dist/semantic-recall.d.ts.map +1 -1
- package/dist/skill/compaction-eval/scripts/compress.mjs +170 -37
- package/dist/skill/compaction-eval/scripts/prepare.mjs +8 -0
- package/dist/skill/compaction-eval/scripts/view.mjs +321 -101
- package/dist/types.d.ts +13 -12
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { type OmEventKind, type OmEventPayloadMap } from './om-event.ts';
|
|
2
|
+
import type { Session } from './types.ts';
|
|
3
|
+
/** 追加一条 om 私有事件(ignorable,不进 surface),返回事件 seq。 */
|
|
4
|
+
export declare function appendOmEvent<K extends OmEventKind>(session: Session, kind: K, data: OmEventPayloadMap[K]): number;
|
|
5
|
+
//# sourceMappingURL=om-event-append.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"om-event-append.d.ts","sourceRoot":"","sources":["../src/om-event-append.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EACjD,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACzB,MAAM,CAIR"}
|
package/dist/om-event.d.ts
CHANGED
|
@@ -1,19 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* om
|
|
3
|
-
* 导出
|
|
4
|
-
*
|
|
2
|
+
* om 私有事件的读取通道:插件私有事件以宿主实验性 plugin record 持久化。
|
|
3
|
+
* 导出 OmEventKind / OmEventPayloadMap / OmEvent / OM_RECORD_TYPES /
|
|
4
|
+
* readOmEvent / findOmEvents;写入见 om-event-append.ts。
|
|
5
5
|
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
* feedback/record(dsh-command-feedback 声明)是目录内 log-only 审计事件,所有者
|
|
10
|
-
* invariant 声明其无跨事件关系、无运行时不变量、永不进入模型上下文,故选为承载
|
|
11
|
-
* 类型:插件数据以 `om:1:` 前缀 + JSON 信封写入其 text 字段,解码失败按非 om
|
|
12
|
-
* 记录处理(含用户自写的真实反馈记录)。
|
|
6
|
+
* plugin record 是带 ignorable 标记、类型名以 `plugin:` 开头的日志事件:不进
|
|
7
|
+
* surface,宿主读取路径遇到不认识的类型时保留并跳过,会话仍可加载。本文件不引入
|
|
8
|
+
* 宿主运行时模块,客户端 bundle 可直接使用。
|
|
13
9
|
*/
|
|
14
10
|
import type { Session, SessionEvent, TokenUsage } from './types.ts';
|
|
15
|
-
/** om 信封 text 前缀:标识该 feedback/record 记录由本插件写入。 */
|
|
16
|
-
export declare const OM_EVENT_PREFIX = "om:1:";
|
|
17
11
|
/** om 私有事件类别(信封 kind 字段)。 */
|
|
18
12
|
export type OmEventKind =
|
|
19
13
|
/** 功能降级警告(degrade.ts 报告,客户端渲染「功能降级」警告行)。 */
|
|
@@ -24,7 +18,14 @@ export type OmEventKind =
|
|
|
24
18
|
| 'om/observe-invalidate'
|
|
25
19
|
/** 观察预压缩结果(后台压缩任务成功时写入,注入前崩溃可恢复:按 pendingSeq 匹配活跃标记采纳)。 */
|
|
26
20
|
| 'om/observe-summary';
|
|
27
|
-
/**
|
|
21
|
+
/** 各类别对应的 plugin record 类型名(grammar:`plugin:` 后以 `/` 分段)。 */
|
|
22
|
+
export declare const OM_RECORD_TYPES: {
|
|
23
|
+
readonly 'om/warning': "plugin:dsh-plugin-om/warning";
|
|
24
|
+
readonly 'om/observe-pending': "plugin:dsh-plugin-om/observe-pending";
|
|
25
|
+
readonly 'om/observe-invalidate': "plugin:dsh-plugin-om/observe-invalidate";
|
|
26
|
+
readonly 'om/observe-summary': "plugin:dsh-plugin-om/observe-summary";
|
|
27
|
+
};
|
|
28
|
+
/** 各类别记录载荷。 */
|
|
28
29
|
export type OmEventPayloadMap = {
|
|
29
30
|
'om/warning': {
|
|
30
31
|
/** 降级问题标识(会话内去重键,取值见 degrade.ts)。 */
|
|
@@ -72,12 +73,10 @@ export type OmEvent = {
|
|
|
72
73
|
};
|
|
73
74
|
}[OmEventKind];
|
|
74
75
|
/**
|
|
75
|
-
* 解码一条会话事件为 om
|
|
76
|
-
*
|
|
76
|
+
* 解码一条会话事件为 om 私有事件:仅识别带 ignorable 标记且类型名属于本插件的
|
|
77
|
+
* plugin record;类型不符、载荷非对象或字段缺失时返回 undefined。
|
|
77
78
|
*/
|
|
78
79
|
export declare function readOmEvent(event: SessionEvent | undefined | null): OmEvent | undefined;
|
|
79
|
-
/** 追加一条 om 私有事件(借用 feedback/record,log-only,不进 surface),返回事件 seq。 */
|
|
80
|
-
export declare function appendOmEvent<K extends OmEventKind>(session: Session, kind: K, data: OmEventPayloadMap[K]): number;
|
|
81
80
|
/** 读取日志中全部 om 私有事件(按日志顺序)。 */
|
|
82
81
|
export declare function findOmEvents(session: Session): OmEvent[];
|
|
83
82
|
/** 读取日志中指定类别的 om 私有事件(按日志顺序,载荷类型按类别收窄)。 */
|
package/dist/om-event.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"om-event.d.ts","sourceRoot":"","sources":["../src/om-event.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"om-event.d.ts","sourceRoot":"","sources":["../src/om-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpE,6BAA6B;AAC7B,MAAM,MAAM,WAAW;AACrB,4CAA4C;AAC1C,YAAY;AACd,qCAAqC;GACnC,oBAAoB;AACtB,uCAAuC;GACrC,uBAAuB;AACzB,2DAA2D;GACzD,oBAAoB,CAAC;AAEzB,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;CAKgC,CAAC;AAE7D,eAAe;AACf,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE;QACZ,qCAAqC;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,oBAAoB,EAAE;QACpB,8BAA8B;QAC9B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,uBAAuB,EAAE;QACvB,sCAAsC;QACtC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,oBAAoB,EAAE;QACpB,iDAAiD;QACjD,UAAU,EAAE,MAAM,CAAC;QACnB,8BAA8B;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,0BAA0B;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,uBAAuB;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,0BAA0B;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,0BAA0B;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,6BAA6B;QAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,0CAA0C;QAC1C,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB,6CAA6C;QAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,OAAO,GAAG;KACnB,CAAC,IAAI,WAAW,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CACzE,CAAC,WAAW,CAAC,CAAC;AAUf;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CA+DvF;AA6BD,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;AAC1D,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAChD,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,CAAC,GACN,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}
|
package/dist/precompress.d.ts
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
import type { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
|
|
16
16
|
import { type ObservePrepared } from './compress.ts';
|
|
17
17
|
import { type CompressionSuccess } from './compress-loop.ts';
|
|
18
|
-
import {
|
|
18
|
+
import type { OmEventPayloadMap } from './om-event.ts';
|
|
19
19
|
import type { Context, PluginConfig, Session } from './types.ts';
|
|
20
20
|
import type { RoutedTarget } from './utils.ts';
|
|
21
21
|
/** 任务状态:运行中 / 成功(结果已持久化)/ 失败。 */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"precompress.d.ts","sourceRoot":"","sources":["../src/precompress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,KAAK,eAAe,EAA6B,MAAM,eAAe,CAAC;AAChF,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,
|
|
1
|
+
{"version":3,"file":"precompress.d.ts","sourceRoot":"","sources":["../src/precompress.ts"],"names":[],"mappings":"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"}
|
package/dist/recall.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* recall
|
|
3
|
-
* 导出 recallArgsSchema /
|
|
2
|
+
* recall 工具:回看原始会话(含被压缩内容)。
|
|
3
|
+
* 导出 recallArgsSchema / RecallArgs / parseRecallArgs / buildRecallTool。
|
|
4
4
|
* - 区间模式:按完整消息 index 的 start/end/offset 精确返回区间内全部完整消息。
|
|
5
|
-
* -
|
|
5
|
+
* - 检索模式(带 query):语义增强启用时按含义检索,否则按字符串匹配,见 semantic-recall.ts。
|
|
6
6
|
* 输出值为 { text, images }(契约见 recall-output.ts),text 为 XML 条目序列
|
|
7
7
|
* (形态见 recall-xml.ts);recall 自身不设输出上限,超大工具结果由 tool-result-pruner 裁剪。
|
|
8
8
|
*/
|
|
@@ -10,39 +10,31 @@ import { z } from 'zod';
|
|
|
10
10
|
import { type SemanticOptions } from './semantic-recall.ts';
|
|
11
11
|
import type { ToolDefinition } from './types.ts';
|
|
12
12
|
/**
|
|
13
|
-
*
|
|
13
|
+
* recall 参数 schema:带 query 走检索模式(区间可选,用于限定检索范围);
|
|
14
|
+
* 不带 query 时 start 必填,end 与 offset 至少提供一个(同时给出时 end 优先)。
|
|
14
15
|
* 各字段描述经 .describe() 透传到 wire JSON Schema。
|
|
15
16
|
*/
|
|
16
17
|
export declare const recallArgsSchema: z.ZodObject<{
|
|
17
|
-
start: z.ZodNumber;
|
|
18
|
-
end: z.ZodOptional<z.ZodNumber>;
|
|
19
|
-
offset: z.ZodOptional<z.ZodNumber>;
|
|
20
|
-
}, z.core.$strip>;
|
|
21
|
-
/**
|
|
22
|
-
* 语义增强 recall 参数 schema:带 query 走语义模式(区间可选,用于限定检索范围),
|
|
23
|
-
* 不带 query 时与基础 schema 的校验一致。
|
|
24
|
-
*/
|
|
25
|
-
export declare const enhancedRecallArgsSchema: z.ZodObject<{
|
|
26
18
|
query: z.ZodOptional<z.ZodString>;
|
|
27
19
|
top_k: z.ZodOptional<z.ZodNumber>;
|
|
28
20
|
start: z.ZodOptional<z.ZodNumber>;
|
|
29
21
|
end: z.ZodOptional<z.ZodNumber>;
|
|
30
22
|
offset: z.ZodOptional<z.ZodNumber>;
|
|
31
23
|
}, z.core.$strip>;
|
|
32
|
-
/** recall
|
|
33
|
-
export type RecallArgs = z.infer<typeof
|
|
34
|
-
/** 解析并校验 recall
|
|
35
|
-
export declare function parseRecallArgs(raw: unknown
|
|
24
|
+
/** recall 工具调用参数。 */
|
|
25
|
+
export type RecallArgs = z.infer<typeof recallArgsSchema>;
|
|
26
|
+
/** 解析并校验 recall 调用参数:失败时抛出首个校验问题的可读消息。 */
|
|
27
|
+
export declare function parseRecallArgs(raw: unknown): RecallArgs;
|
|
36
28
|
/** recall 构建选项。 */
|
|
37
29
|
export type RecallToolOptions = {
|
|
38
30
|
/** 返回 tool-result-pruner(可选),用于裁剪超大工具结果。 */
|
|
39
31
|
getPruner?: () => unknown;
|
|
40
|
-
/**
|
|
32
|
+
/** 提供时 query 走语义检索(内容为可注入的嵌入依赖,测试传替身),否则走字符串匹配。 */
|
|
41
33
|
semantic?: SemanticOptions;
|
|
42
34
|
};
|
|
43
35
|
/**
|
|
44
|
-
* 构建 recall 工具定义:按 start/end/offset 定位完整消息区间并渲染原始内容(标 index
|
|
45
|
-
*
|
|
36
|
+
* 构建 recall 工具定义:按 start/end/offset 定位完整消息区间并渲染原始内容(标 index),
|
|
37
|
+
* 或按 query 检索(传入 semantic 选项时语义检索,否则字符串匹配)。
|
|
46
38
|
*/
|
|
47
39
|
export declare function buildRecallTool(options?: RecallToolOptions): ToolDefinition;
|
|
48
40
|
//# sourceMappingURL=recall.d.ts.map
|
package/dist/recall.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,
|
|
1
|
+
{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,EAAiB,KAAK,eAAe,EAAkB,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;iBAoCzB,CAAC;AAEL,qBAAqB;AACrB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAUxD;AAUD,mBAAmB;AACnB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,cAAc,CA4E3E"}
|
package/dist/recompress.d.ts
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* RECOMPRESS_COMMAND_NAME。
|
|
6
6
|
*
|
|
7
7
|
* - 视图重放:compaction/summary 载荷的 shadowedSeqs 加 compaction/start 的 phase 足以
|
|
8
|
-
*
|
|
8
|
+
* 重建当时的压缩视图(观察取被遮蔽的原消息,反思取被归档的 <history> 块),二者都只
|
|
9
9
|
* 读日志,与当前表层无关
|
|
10
10
|
* - 不改会话:不写 compaction/* 事件、不替换表层、不动观察待定标记;唯一副作用是压缩
|
|
11
11
|
* 会话记录子会话及其在父会话的 subagent/catalog,标题带「重压缩 provider/model」
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 异步反思:进程内任务注册表、任务主体与归档块选择。
|
|
3
|
+
* 导出 startReflection / peekReflectJob / takeReflectJob / reflectFailedKey /
|
|
4
|
+
* disposeReflection / disposeAllReflections / selectArchiveBlocks / historyBlocksKey
|
|
5
|
+
* 与类型 ReflectJob / ReflectStartOptions。
|
|
6
|
+
*
|
|
7
|
+
* - 同一会话最多一个任务;任务以自有 AbortController 在后台运行压缩循环,不阻塞 pre-step
|
|
8
|
+
* - 任务结果只存内存:提交由完成后的首个 pre-step 在开放 turn 内完成(compress.ts)
|
|
9
|
+
* - 非中止失败记录当时的 history 块集合键;集合不变时不再重试
|
|
10
|
+
* - session/disposed 与插件卸载经 disposeReflection / disposeAllReflections 中止任务
|
|
11
|
+
*/
|
|
12
|
+
import type { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
|
|
13
|
+
import { type CompressionSuccess } from './compress-loop.ts';
|
|
14
|
+
import type { ArchivedSkill, CompressionView } from './compress-view.ts';
|
|
15
|
+
import type { Context, PluginConfig, Session } from './types.ts';
|
|
16
|
+
import type { RoutedTarget } from './utils.ts';
|
|
17
|
+
/** 压缩块:块文本与表层 seq。 */
|
|
18
|
+
export type HistoryBlock = {
|
|
19
|
+
text: string;
|
|
20
|
+
seq: number;
|
|
21
|
+
};
|
|
22
|
+
/** 任务状态:运行中 / 成功(结果待提交)/ 失败。 */
|
|
23
|
+
export type ReflectJobState = 'running' | 'done' | 'failed';
|
|
24
|
+
/** 一个后台反思任务(注册表条目)。 */
|
|
25
|
+
export type ReflectJob = {
|
|
26
|
+
/** 启动时的会话对象(重载后对象不同即过期)。 */
|
|
27
|
+
readonly session: Session;
|
|
28
|
+
/** 触发时全部 history 块的集合键(失败后据此判断是否重试)。 */
|
|
29
|
+
readonly key: string;
|
|
30
|
+
/** 被归档的 history 块(表层顺序)。 */
|
|
31
|
+
readonly archived: readonly HistoryBlock[];
|
|
32
|
+
/** 归档视图。 */
|
|
33
|
+
readonly view: CompressionView;
|
|
34
|
+
/** 从被归档块提取的 skill(同名保留最新)。 */
|
|
35
|
+
readonly skills: readonly ArchivedSkill[];
|
|
36
|
+
/** 被归档块的估算 token(字符/4,影子价格单位)。 */
|
|
37
|
+
readonly estimatedTokens: number;
|
|
38
|
+
/** 被归档块的内文字符数。 */
|
|
39
|
+
readonly shadowedCharCount: number;
|
|
40
|
+
readonly target: RoutedTarget;
|
|
41
|
+
readonly reasoningEffort?: ReasoningEffortId;
|
|
42
|
+
readonly controller: AbortController;
|
|
43
|
+
/** 任务到达终态时 resolve;不 reject。 */
|
|
44
|
+
readonly promise: Promise<void>;
|
|
45
|
+
state: ReflectJobState;
|
|
46
|
+
result?: CompressionSuccess;
|
|
47
|
+
failure?: {
|
|
48
|
+
error: string;
|
|
49
|
+
aborted: boolean;
|
|
50
|
+
diagnosticSessionId?: string;
|
|
51
|
+
};
|
|
52
|
+
};
|
|
53
|
+
/** 启动选项。 */
|
|
54
|
+
export type ReflectStartOptions = {
|
|
55
|
+
ctx: Context;
|
|
56
|
+
session: Session;
|
|
57
|
+
config: Readonly<PluginConfig>;
|
|
58
|
+
target: RoutedTarget;
|
|
59
|
+
reasoningEffort?: ReasoningEffortId;
|
|
60
|
+
key: string;
|
|
61
|
+
archived: readonly HistoryBlock[];
|
|
62
|
+
view: CompressionView;
|
|
63
|
+
skills: readonly ArchivedSkill[];
|
|
64
|
+
estimatedTokens: number;
|
|
65
|
+
shadowedCharCount: number;
|
|
66
|
+
};
|
|
67
|
+
/** history 块集合键:按 seq 拼接。 */
|
|
68
|
+
export declare function historyBlocksKey(blocks: readonly HistoryBlock[]): string;
|
|
69
|
+
/**
|
|
70
|
+
* 选择归档块:从最后一个块往前累加 token,合计不超过 keepBudget 的尾部块保留,
|
|
71
|
+
* 至少保留 1 个;其余全部归档。tokensOf 返回单块 token。
|
|
72
|
+
*/
|
|
73
|
+
export declare function selectArchiveBlocks<T>(blocks: readonly T[], tokensOf: (block: T) => number, keepBudget: number): {
|
|
74
|
+
archived: T[];
|
|
75
|
+
kept: T[];
|
|
76
|
+
};
|
|
77
|
+
/** 查询会话当前任务。 */
|
|
78
|
+
export declare function peekReflectJob(sessionId: string): ReflectJob | undefined;
|
|
79
|
+
/** 取出会话当前任务并从注册表移除(提交或丢弃前调用)。 */
|
|
80
|
+
export declare function takeReflectJob(sessionId: string): ReflectJob | undefined;
|
|
81
|
+
/** 最近一次非中止失败时的 history 块集合键。 */
|
|
82
|
+
export declare function reflectFailedKey(sessionId: string): string | undefined;
|
|
83
|
+
/** 启动后台反思;调用方保证同会话无运行中任务。 */
|
|
84
|
+
export declare function startReflection(options: ReflectStartOptions): ReflectJob;
|
|
85
|
+
/** 中止并移除会话的反思任务,清除失败记录。 */
|
|
86
|
+
export declare function disposeReflection(sessionId: string): void;
|
|
87
|
+
/** 中止并移除全部反思任务(插件卸载)。 */
|
|
88
|
+
export declare function disposeAllReflections(): void;
|
|
89
|
+
//# sourceMappingURL=reflect.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../src/reflect.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* recall
|
|
3
|
-
*
|
|
2
|
+
* recall 的 query 检索实现:对会话全部完整消息(含被压缩/遮蔽的)检索,返回最匹配的
|
|
3
|
+
* 完整消息与匹配说明。
|
|
4
4
|
* 导出 SemanticOptions / RangeArgs / resolveSemanticRange / tokenize / matchExplanation /
|
|
5
|
-
* SEMANTIC_MODEL_NOT_READY_MESSAGE / semanticSearch。
|
|
6
|
-
*
|
|
5
|
+
* keywordTerms / SEMANTIC_MODEL_NOT_READY_MESSAGE / semanticSearch / keywordSearch。
|
|
6
|
+
* - 语义检索:本地 ONNX 嵌入(cosine 相似度)
|
|
7
|
+
* - 字符串匹配(语义增强关闭时):query 按空白拆词,不区分大小写计命中词数,同分时
|
|
8
|
+
* index 大的优先,零命中不返回
|
|
9
|
+
* 只匹配文本,纯图片消息不进候选池;
|
|
7
10
|
* 区间缺省检索全部、区间不合法回退全量并在输出中告知;输出契约同 recall
|
|
8
11
|
* ({ text, images },条目为 XML 形态见 recall-xml.ts,超大结果由 tool-result-pruner
|
|
9
12
|
* 裁剪);候选池排除本次调用自身的 toolcall 完整消息(其渲染文本含 query 原文,
|
|
@@ -55,4 +58,8 @@ export type SemanticSearchInput = RangeArgs & {
|
|
|
55
58
|
};
|
|
56
59
|
/** 在会话完整消息中做语义检索,返回 TOP-K 命中条目。 */
|
|
57
60
|
export declare function semanticSearch(input: SemanticSearchInput): Promise<RecallOutputValue>;
|
|
61
|
+
/** 字符串匹配的检索词:query 按空白拆分、转小写、去重。 */
|
|
62
|
+
export declare function keywordTerms(query: string): string[];
|
|
63
|
+
/** 在会话完整消息中按字符串匹配检索(语义增强关闭时),返回 TOP-K 命中条目。 */
|
|
64
|
+
export declare function keywordSearch(input: SemanticSearchInput): RecallOutputValue;
|
|
58
65
|
//# sourceMappingURL=semantic-recall.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO,EAAsB,KAAK,iBAAiB,EAAY,MAAM,oBAAoB,CAAC;AAE1F,OAAO,KAAK,EAAmB,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD,CAAC;AAEF,0BAA0B;AAC1B,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAqBhF;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAMlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnF;AAED,qCAAqC;AACrC,eAAO,MAAM,gCAAgC,6HAAyB,CAAC;AAEvE,sCAAsC;AACtC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACvC,CAAC;AA+BF,mCAAmC;AACnC,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsB3F;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASpD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,CAsB3E"}
|