dsh-plugin-om 0.0.21 → 0.0.23

package/dist/types.d.ts

@@ -1,31 +1,24 @@
 /**
- * 共享类型：全部来自 deepseek-ai 官方包（type-only 导入，编译期擦除，运行时零依赖）。
- *
- * 各 dsh-* 包通过 declare module '@deepseek-ai/cordis' 增强 Context/Events，
- * 使 ctx.tools / ctx.tokenMeter / ctx.sessions 等获得与真实宿主一致的类型；
- * ctx.on / ctx.get 等 mixin 方法由 cordis 自身声明，无需本地补充。
+ * 共享类型：宿主类型再导出（type-only，编译期擦除）+ 插件领域类型。
+ * 导出官方包宿主类型（Context/Agent/Session 等）、PluginConfig、
+ * MessageNode/MessageIndex/CompleteMessage（完整消息索引）与 compaction 载荷扩展。
+ * 各 dsh-* 包通过 declare module 增强 Context/Events，使 ctx.tools 等获得宿主一致类型。
  */
 import type { Context, EventOptions, Events } from '@deepseek-ai/cordis';
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { CompactionId } from '@deepseek-ai/dsh-compaction';
 import type { ToolResultPruner } from '@deepseek-ai/dsh-compaction-tool-result-pruner';
-import type { Message, TokenUsage, UserMessage } from '@deepseek-ai/dsh-llm';
+import type { ContentBlock, ImageBlock, Message, TokenUsage, UserMessage } from '@deepseek-ai/dsh-llm';
 import type { Session, SessionEvent, SessionEventMap } from '@deepseek-ai/dsh-session';
 import type { SubagentResult, SubagentRun, SubagentStartRequest } from '@deepseek-ai/dsh-subagent';
 import type { SystemPrompt } from '@deepseek-ai/dsh-system-prompt';
 import type { TokenMeter } from '@deepseek-ai/dsh-token-meter';
-import type { ToolDefinition, ToolRunContext } from '@deepseek-ai/dsh-tools';
-/** 插件配置类型（来自 config.ts，供外部 preset 与类型使用者引用）。 */
+import type { JsonSchemaNode, ToolDefinition, ToolRunContext } from '@deepseek-ai/dsh-tools';
+/** 插件配置类型（来自 config.ts）。 */
 export type { PluginConfig } from './config.ts';
-/**
- * 官方包宿主类型再导出：插件 API 与工具签名统一从这里取型，
- * 避免各模块直接依赖不同版本的 dsh-* 包类型面。
- */
-export type { Agent, CompactionId, Context, EventOptions, Events, Message, Session, SessionEvent, SessionEventMap, SubagentResult, SubagentRun, SubagentStartRequest, SystemPrompt, TokenMeter, TokenUsage, ToolDefinition, ToolResultPruner, ToolRunContext, UserMessage, };
-/**
- * 一条消息事件（user/assistant/tool-result），带稳定 message_id；
- * 消息级索引（indexMessages）的节点，按 message_id 定位消息序列下标。
- */
+/** 官方包宿主类型再导出：插件 API 与工具签名统一从这里取型。 */
+export type { Agent, CompactionId, ContentBlock, Context, EventOptions, Events, ImageBlock, JsonSchemaNode, Message, Session, SessionEvent, SessionEventMap, SubagentResult, SubagentRun, SubagentStartRequest, SystemPrompt, TokenMeter, TokenUsage, ToolDefinition, ToolResultPruner, ToolRunContext, UserMessage, };
+/** 一条消息事件（user/assistant/tool-result），带稳定 message_id；消息级索引的节点。 */
 export type MessageNode = {
     /** 事件在日志中的 seq。 */
     seq: number;
@@ -43,43 +36,37 @@ export type MessageIndex = {
 };
 /**
  * 一条完整消息：摘要日志与 recall 共用的定位单位，分四类——
- * user（用户消息，user_message 中 source.kind === 'user'）、
- * sys（系统消息，user_message 中其余 source.kind 的部分，如宿主注入的上下文）、
+ * user（用户消息）、sys（系统消息，user_message 中非 user 来源的部分）、
  * assistant（模型输出文本）、toolcall（单个工具调用及其结果）。
- * index 从 0 起、按日志顺序递增、只追加不重排 → 会话内全局稳定
- * （压缩后旧摘要条目引用的 index 仍然有效）；本插件自产的压缩日志消息不占位。
+ * index 从 0 起、按日志顺序递增、只追加不重排（会话内全局稳定）；
+ * 本插件自产的压缩日志消息不占位。
  */
 export type CompleteMessage = {
     /** 完整消息序号（0 起，全局稳定）。 */
     index: number;
-    /**
-     * 类别：user=用户消息；sys=系统消息（压缩日志中以 <sys type="KIND" index="N"> 空块
-     * 表示）；assistant=模型输出文本；toolcall=单个工具调用及其结果。
-     */
+    /** 类别：user=用户消息；sys=系统消息；assistant=模型输出文本；toolcall=工具调用及其结果。 */
     type: 'user' | 'sys' | 'assistant' | 'toolcall';
-    /** 系统消息的 source.kind（仅 sys 类；如 agent-instructions / skill-catalog）。 */
+    /** 系统消息的 source.kind（仅 sys 类）。 */
     kind?: string;
     /** 关联的消息事件 seq（user/sys/assistant=1 个；toolcall=assistant 消息 + 结果）。 */
     seqs: number[];
-    /** 工具调用 id（仅 toolcall 类；关联 tool/result 用）。 */
+    /** 工具调用 id（仅 toolcall 类）。 */
     callId?: string;
 };
 /**
- * 插件扩展的 compaction/summary 载荷：宿主类型 + shadowedCharCount（压缩前字符数）。
- * 宿主 append 不做 schema 剥离，扩展字段原样持久化；旧会话载荷可能缺失该字段，
- * 客户端读取时按可选处理。宿主类型是 union（rawOutput 分支），无法直接声明合并，
- * 故用交叉类型 + 读取处收窄。
+ * 插件扩展的 compaction/summary 载荷：宿主类型 + shadowedCharCount/attemptCount。
+ * 宿主 append 不做 schema 剥离，扩展字段原样持久化；旧会话载荷可能缺失，
+ * 客户端读取时按可选处理。宿主类型是 union，无法声明合并，故用交叉类型 + 读取处收窄。
  */
 export type CompactionSummaryPayload = SessionEventMap['compaction/summary'] & {
-    /** 被压缩内容的字符数（压缩前文本长度合计；UI 标题统计用），旧载荷可能缺失。 */
+    /** 被压缩内容的字符数（压缩前文本长度合计；UI 标题统计用）。 */
     shadowedCharCount?: number;
-    /** 摘要重试次数（0 起；观察分块为各块重试之和，反思为尝试次数 - 1），旧载荷可能缺失。 */
+    /** 摘要重试次数（观察分块为各块重试之和，反思为尝试次数 - 1）。 */
     attemptCount?: number;
 };
 /**
  * 插件扩展的 compaction/start 载荷：宿主类型 + phase（压缩 pass）。
- * 宿主 append 不做 schema 剥离，扩展字段原样持久化；客户端读取时按可选处理，
- * 缺失（旧版本会话）回落通用压缩中文案。
+ * 客户端读取时按可选处理，缺失回落通用压缩中文案。
  */
 export type CompactionStartPayload = SessionEventMap['compaction/start'] & {
     /** 压缩 pass（观察/反思；UI 压缩中提示行区分文案）。 */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7E,gDAAgD;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,YAAY,EACV,KAAK,EACL,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,aAAa,CAAC;CAC5D,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG;IACzB,oBAAoB;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kCAAkC;IAClC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC,oBAAoB,CAAC,GAAG;IAC7E,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC,kBAAkB,CAAC,GAAG;IACzE,oCAAoC;IACpC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7F,4BAA4B;AAC5B,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,sCAAsC;AACtC,YAAY,EACV,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,MAAM,EACN,UAAU,EACV,cAAc,EACd,OAAO,EACP,OAAO,EACP,YAAY,EACZ,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,aAAa,CAAC;CAC5D,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG;IACzB,oBAAoB;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,kCAAkC;IAClC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC,oBAAoB,CAAC,GAAG;IAC7E,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC,kBAAkB,CAAC,GAAG;IACzE,oCAAoC;IACpC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B,CAAC"}

package/dist/utils.d.ts

@@ -1,24 +1,25 @@
 /**
- * 零依赖工具函数：不 import 任何运行时包，保证单文件打包与任意位置挂载。
- * 主要服务于文本呈现、主会话判定与路由解析。
+ * 零依赖工具函数：文本呈现、主会话判定、路由解析等通用辅助（不 import 运行时包）。
+ * 导出 isRecord / uuid / blocksToText / textCharCount / renderMessageText / safeJson /
+ * isMainSession / routedTarget。
  */
 import type { Message } from '@deepseek-ai/dsh-llm';
 import type { Session } from './types.ts';
-/** 判断值是否为普通对象：typeof object 且非 null 且非数组（类型收窄用）。 */
+/** 判断值是否为普通对象（非 null、非数组）。 */
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
-/** 生成 uuid：优先 crypto.randomUUID，回退为时间戳+随机串拼接（保证唯一性）。 */
+/** 生成 uuid：优先 crypto.randomUUID，回退为时间戳+随机串拼接。 */
 export declare function uuid(): string;
 /** 提取 content 数组中的纯文本块（type === 'text' 的 block.text 拼接）。 */
 export declare function blocksToText(blocks: unknown): string;
-/** 消息内容的字符数：递归计入 text 块与 tool-result 内嵌文本（与宿主 token 估算口径一致）。 */
+/** 消息内容的字符数：递归计入 text 块与 tool-result 内嵌文本。 */
 export declare function textCharCount(message: Message | null | undefined): number;
 /** 面向 recall 的完整消息呈现：text 原样；tool-call 展开（参数=代码）；tool-result 取文本。 */
 export declare function renderMessageText(message: Message | null | undefined): string;
-/** 安全 JSON 序列化：序列化失败时退回 String 呈现（避免渲染异常）。 */
+/** 安全 JSON 序列化：序列化失败时退回 String 呈现。 */
 export declare function safeJson(value: unknown): string;
-/** 主会话判定：subagent 会话 header.origin === 'subagent'（压缩/recall 仅主会话生效）。 */
+/** 主会话判定：subagent 会话 header.origin === 'subagent'。 */
 export declare function isMainSession(session: Session): boolean;
-/** 会话路由目标：provider + model（压缩合并调用与容量查询使用）。 */
+/** 会话路由目标：provider + model。 */
 export type RoutedTarget = {
     provider: string;
     model: string;

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,oDAAoD;AACpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wDAAwD;AACxD,wBAAgB,IAAI,IAAI,MAAM,CAK7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CASpD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAYzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAe7E;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CASvE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,iDAAiD;AACjD,wBAAgB,IAAI,IAAI,MAAM,CAI7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc7E;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAQvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-om",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",