dsh-plugin-om 0.0.0

package/dist/log-index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 会话日志索引：消息索引（message_id → 消息事件，recall 按 message_id 定位区间），
+ * 以及表层节点定位辅助。事件日志仅追加（被遮蔽的事件仍可读，recall 依赖此性质）。
+ */
+import type { MessageIndex, Session, SessionEvent } from './types.ts';
+/**
+ * 查找 seq 在表层节点序列中的下标（不在则返回 -1）。
+ * 表层节点按日志顺序排列，用于压缩边界定位与遮蔽范围计算。
+ */
+export declare function surfaceIndexOf(nodes: readonly number[], seq: number): number;
+/** 提取一条消息事件的 message_id（user/assistant/tool-result 消息均有稳定 id；其余事件无）。 */
+export declare function messageIdOfEvent(event: SessionEvent | undefined): string | undefined;
+/** 消息索引：按日志顺序列出全部消息事件，并按 message_id 定位其在消息序列中的下标。 */
+export declare function indexMessages(session: Session): MessageIndex;
+//# sourceMappingURL=log-index.d.ts.map

package/dist/log-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-index.d.ts","sourceRoot":"","sources":["../src/log-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAe,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA0B5D"}

package/dist/recall.d.ts

@@ -0,0 +1,32 @@
+/**
+ * recall 工具：按 message_id 回看原始会话（start_id/end_id 为消息 id，offset 为相对
+ * start_id 的消息步数）。recall 自身不设输出上限：超大的工具结果由 tool-result-pruner
+ * 裁剪（pruneContent），输出 token 由 pruner 配置控制。
+ *
+ * 参数由 zod schema（recallArgsSchema）在 execute 入口校验：start_id 必填且非空，
+ * end_id/offset 至少提供一个；非法参数抛出可读错误。
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from './types.ts';
+/**
+ * recall 工具参数 schema：start_id 必填且非空；end_id 与 offset 至少提供一个
+ * （二者同时给出时 end_id 优先，与 execute 语义一致）；未知键自动剥离。
+ */
+export declare const recallArgsSchema: z.ZodObject<{
+    start_id: z.ZodString;
+    end_id: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** recall 工具调用参数（由 recallArgsSchema 推断）。 */
+export type RecallArgs = z.infer<typeof recallArgsSchema>;
+/**
+ * 解析并校验 recall 调用参数：校验失败时抛出首个校验问题的可读消息
+ * （普通 Error 而非 ZodError，兼容 SDK 展示）。
+ */
+export declare function parseRecallArgs(raw: unknown): RecallArgs;
+/**
+ * 构建 recall 工具定义：按 start_id/end_id/offset 定位消息区间并渲染原始内容。
+ * getPruner 返回 tool-result-pruner（可选），用于裁剪超大工具结果。
+ */
+export declare function buildRecallTool(getPruner?: () => unknown): ToolDefinition;
+//# sourceMappingURL=recall.d.ts.map

package/dist/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAW,cAAc,EAAkB,MAAM,YAAY,CAAC;AAG1E;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAQzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAiGzE"}

package/dist/summarize.d.ts

@@ -0,0 +1,28 @@
+import type { Agent, Context } from './types.ts';
+/** 观察者 persona：只针对未压缩消息产出观察日志，不用工具、不展示思考。 */
+export declare const OBSERVER_PERSONA = "\u4F60\u662F dsh-plugin-om \u7684\u4E0A\u4E0B\u6587\u89C2\u5BDF\u8005\uFF08Observer\uFF0C\u673A\u5236\u53C2\u8003 Mastra Observational Memory\uFF09\uFF1A\u628A\u4F1A\u8BDD\u4E2D\u5C1A\u672A\u538B\u7F29\u7684\u6D88\u606F\u538B\u7F29\u4E3A\u4E00\u4EFD\u89C2\u5BDF\u65E5\u5FD7\u3002\u4E0D\u7528\u5DE5\u5177\u3001\u4E0D\u5C55\u793A\u601D\u8003\u3001\u4E0D\u8BC4\u4EF7\u4EE3\u7801\u3001\u4E0D\u8F93\u51FA\u591A\u4F59\u6587\u5B57\u3002";
+/** 反思者 persona：只精简合并当前摘要，不用工具、不展示思考。 */
+export declare const REFLECTOR_PERSONA = "\u4F60\u662F dsh-plugin-om \u7684\u4E0A\u4E0B\u6587\u53CD\u601D\u8005\uFF08Reflector\uFF0C\u673A\u5236\u53C2\u8003 Mastra Observational Memory\uFF09\uFF1A\u628A\u5F53\u524D <om-history> \u538B\u7F29\u65E5\u5FD7\u7CBE\u7B80\u5408\u5E76\u4E3A\u4E00\u4EFD\u66F4\u7D27\u51D1\u7684\u65E5\u5FD7\u3002\u4E0D\u7528\u5DE5\u5177\u3001\u4E0D\u5C55\u793A\u601D\u8003\u3001\u4E0D\u8F93\u51FA\u591A\u4F59\u6587\u5B57\u3002";
+/** 观察提示词参数（对照表/中断标记由 compress.ts 从日志计算后传入）。 */
+export type ObservePromptOptions = {
+    /** message_id 对照表行（按序对应上下文中未压缩消息）。 */
+    table: string[];
+    /** 中断标记行（aborted/interrupted 轮次）。 */
+    interruptions: string[];
+    /** 是否存在旧摘要（决定「追加到上次产物末尾」的表述）。 */
+    hasOldHistory: boolean;
+};
+/**
+ * 构建观察提示词：规则（消息概括为要点 / 工具调用按目的聚合——不限于 run_code /
+ * 仅关键消息保留 message_id / 中断标注 / 未完成写进度与下一步）+ message_id 对照表 +
+ * 中断标记 + 追加说明。全文由继承上下文提供。
+ */
+export declare function buildObservePrompt(options: ObservePromptOptions): string;
+/** 构建反思提示词：精简合并当前 <om-history>；全文由继承上下文提供。 */
+export declare function buildReflectPrompt(): string;
+/**
+ * Fork 子会话执行一次摘要（观察或反思），返回文本；失败或无法 fork 返回 null。
+ * 工具被 toolFilter 禁用，输出长度受 maxTokens 限制。
+ */
+export declare function runSummarySubagent(ctx: Context, agent: Agent, persona: string, prompt: string, maxTokens: number, signal?: AbortSignal): Promise<string | null>;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAqC,MAAM,YAAY,CAAC;AAGpF,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,kbACyF,CAAC;AAEvH,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,6ZACiG,CAAC;AAEhI,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG;IACjC,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CA4BxE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,MAAM,CAc3C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuDxB"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 共享类型：全部来自 deepseek-ai 官方包（type-only 导入，编译期擦除，运行时零依赖）。
+ *
+ * 各 dsh-* 包通过 declare module '@deepseek-ai/cordis' 增强 Context/Events，
+ * 使 ctx.tools / ctx.tokenMeter / ctx.sessions 等获得与真实宿主一致的类型；
+ * ctx.on / ctx.get 等 mixin 方法由 cordis 自身声明，无需本地补充。
+ */
+import type { Context, EventOptions, Events } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { ToolResultPruner } from '@deepseek-ai/dsh-compaction-tool-result-pruner';
+import type { Message, UserMessage } from '@deepseek-ai/dsh-llm';
+import type { Session, SessionEvent } 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 与类型使用者引用）。 */
+export type { PluginConfig } from './config.ts';
+/**
+ * 官方包宿主类型再导出：插件 API 与工具签名统一从这里取型，
+ * 避免各模块直接依赖不同版本的 dsh-* 包类型面。
+ */
+export type { Agent, Context, EventOptions, Events, Message, Session, SessionEvent, SubagentResult, SubagentRun, SubagentStartRequest, SystemPrompt, TokenMeter, ToolDefinition, ToolResultPruner, ToolRunContext, UserMessage, };
+/**
+ * 一条消息事件（user/assistant/tool-result），带稳定 message_id；
+ * 供 recall 按 message_id 定位消息序列下标。
+ */
+export type MessageNode = {
+    /** 事件在日志中的 seq。 */
+    seq: number;
+    /** 消息的稳定 message_id。 */
+    id: string;
+    /** 事件类型（仅三类消息事件参与消息索引）。 */
+    type: 'user/message' | 'assistant/message' | 'tool/result';
+};
+/** indexMessages 的返回值：按日志顺序的消息序列 + message_id → 序列下标。 */
+export type MessageIndex = {
+    /** 按日志顺序排列的消息事件。 */
+    messages: MessageNode[];
+    /** message_id → messages 数组下标。 */
+    byId: Map<string, number>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,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,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACtE,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,OAAO,EACP,YAAY,EACZ,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,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"}

package/dist/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 零依赖工具函数：不 import 任何运行时包，保证单文件打包与任意位置挂载。
+ * 主要服务于配置校验、文本呈现与主会话判定。
+ */
+import type { Message } from '@deepseek-ai/dsh-llm';
+import type { Session } from './types.ts';
+/** 判断值是否为普通对象：typeof object 且非 null 且非数组（类型收窄用）。 */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** 抛出带插件前缀的错误（never 返回：调用后控制流终止）。 */
+export declare function fail(message: string): never;
+/** 数值配置项的取值约束（assertNumber 的可选参数）。 */
+export type NumberConstraints = {
+    /** 允许的最小值（含），默认 0。 */
+    min?: number;
+    /** 允许的最大值（含），默认 Infinity。 */
+    max?: number;
+    /** 是否必须为整数，默认 false。 */
+    integer?: boolean;
+};
+/**
+ * 校验配置数值：必须是有限数且在 [min, max] 内（可选整数约束），
+ * 不满足时抛出带插件前缀的错误。
+ */
+export declare function assertNumber(name: string, value: unknown, { min, max, integer }?: NumberConstraints): void;
+/** 生成 uuid：优先 crypto.randomUUID，回退为时间戳+随机串拼接（保证唯一性）。 */
+export declare function uuid(): string;
+/** 提取 content 数组中的纯文本块（type === 'text' 的 block.text 拼接）。 */
+export declare function blocksToText(blocks: unknown): string;
+/** 面向 recall 的完整消息呈现：text 原样；tool-call 展开（参数=代码）；tool-result 取文本。 */
+export declare function renderMessageText(message: Message | null | undefined): string;
+/** 安全 JSON 序列化：序列化失败时退回 String 呈现（避免渲染异常）。 */
+export declare function safeJson(value: unknown): string;
+/** 主会话判定：subagent 会话 header.origin === 'subagent'（压缩/recall 仅主会话生效）。 */
+export declare function isMainSession(session: Session): boolean;
+/** 会话路由目标：provider + model（压缩合并调用与容量查询使用）。 */
+export type RoutedTarget = {
+    provider: string;
+    model: string;
+};
+/** 解析会话路由目标（provider/model），未路由时返回 undefined。 */
+export declare function routedTarget(session: Session): RoutedTarget | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +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,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE3C;AAED,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,EAAE,GAAO,EAAE,GAAc,EAAE,OAAe,EAAE,GAAE,iBAAsB,GACnE,IAAI,CAKN;AAED,wDAAwD;AACxD,wBAAgB,IAAI,IAAI,MAAM,CAK7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CASpD;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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "dsh-plugin-om",
+  "version": "0.0.0",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "dsh",
+    "deepseek",
+    "harness",
+    "plugin"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "packageManager": "pnpm@11.7.0",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "check": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run build",
+    "release": "pnpm format && npm version patch && node scripts/release-archive.mjs && git push && git push --tags",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build:types": "tsc -p tsconfig.build.json",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write ."
+  },
+  "devDependencies": {
+    "zod": "4.4.3",
+    "@biomejs/biome": "^2.5.8",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-code-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-compaction-tool-result-pruner": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-scope": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-subagent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-token-meter": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-approval": "^0.1.0-rc.6",
+    "@types/node": "^22.20.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  }
+}