@feng0531/dsh-execution-bus 0.5.1 → 0.6.0

package/dist/protocol.d.ts

@@ -0,0 +1,49 @@
+export type State = "queued" | "running" | "succeeded" | "failed" | "cancelled" | "unknown";
+export type Owner = {
+    sessionId: string;
+    callId: string;
+};
+export type Message = {
+    protocolVersion: 1;
+    messageId: string;
+    requestId: string;
+    type: "request" | "status" | "result" | "cancel";
+    payload: Record<string, unknown>;
+};
+export type Event = {
+    protocolVersion: 1;
+    messageId: string;
+    requestId: string;
+    correlationId: string;
+    sequence: number;
+    type: string;
+    payload: Record<string, unknown>;
+};
+export type Capability = (input: Record<string, unknown>, signal: AbortSignal) => Promise<unknown>;
+export interface Handler {
+    /** 是否可安全复用终态结果。省略默认 true（可复用，向后兼容）；
+     *  显式 false = 有副作用，终态结果复用将被拒绝（运行中等待仍放行）。 */
+    readonly idempotent?: boolean;
+    validate(input: Record<string, unknown>): void;
+    run(input: Record<string, unknown>, ctx: {
+        signal: AbortSignal;
+        progress: (sequence: number, percent: number) => void;
+        requestId: string;
+        invoke?: Capability;
+    }): Promise<unknown>;
+}
+export interface RecordView {
+    requestId: string;
+    state: State;
+    sequence: number;
+    cancelRequested: boolean;
+    delivery: "pending" | "returned";
+    result?: unknown;
+    error?: string;
+    progress?: number;
+}
+export declare function object(v: unknown): Record<string, unknown>;
+/** 规范排序后的稳定摘要，只用于同 requestId 的冲突比较，不用于跨请求去重。 */
+export declare function canonical(v: unknown): string;
+export declare function parse(raw: unknown): Message;
+export declare function freezeJson<T>(value: T): T;

package/dist/protocol.js

@@ -0,0 +1,54 @@
+import { assertJson } from "./json.js";
+import { ERRORS } from "./error-codes.js";
+import { LIMITS } from "./limits.js";
+export function object(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        throw Error(ERRORS.INVALID_OBJECT);
+    return v;
+}
+/** 规范排序后的稳定摘要，只用于同 requestId 的冲突比较，不用于跨请求去重。 */
+export function canonical(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canonical).join(",") + "]";
+    return ("{" +
+        Object.keys(v)
+            .sort()
+            .map((k) => JSON.stringify(k) +
+            ":" +
+            canonical(v[k]))
+            .join(",") +
+        "}");
+}
+export function parse(raw) {
+    assertJson(raw);
+    const m = object(raw);
+    if (Object.keys(m).some((k) => ![
+        "protocolVersion",
+        "messageId",
+        "requestId",
+        "type",
+        "payload",
+    ].includes(k)))
+        throw Error(ERRORS.UNKNOWN_FIELD);
+    if (m.protocolVersion !== 1)
+        throw Error(ERRORS.UNSUPPORTED_VERSION);
+    for (const k of ["messageId", "requestId"])
+        if (typeof m[k] !== "string" || !LIMITS.idPattern.test(m[k]))
+            throw Error(ERRORS.INVALID_ID);
+    if (!["request", "status", "result", "cancel"].includes(m.type))
+        throw Error(ERRORS.UNSUPPORTED_TYPE);
+    object(m.payload);
+    if (Buffer.byteLength(JSON.stringify(m)) > LIMITS.messageMaxBytes)
+        throw Error(ERRORS.MESSAGE_TOO_LARGE);
+    return structuredClone(m);
+}
+export function freezeJson(value) {
+    if (value && typeof value === "object") {
+        for (const child of Object.values(value))
+            freezeJson(child);
+        Object.freeze(value);
+    }
+    return value;
+}

package/docs/PRODUCT.md

@@ -4,7 +4,7 @@
 
 萧何是 DSH 内的可选执行协调插件，提供独立可选择的 PTC 派生预设，不是 PTC 替代传输层，也不全局接管终端、编辑或其他工具。实际业务 Handler 为 host.read；test 是兼容保留的诊断 Handler，只有明确诊断需求时使用。测试能力存在不代表其他命令已接入总线。
 
-0.5.1 按正式产品梳理入口和共享策略，不以更名宣称完成生产环境认证。当前真实模型、桌面 UI 和实际沙箱尚未完整验收；同进程内存状态不支持跨重启恢复。
+0.6.0 对齐 DSH 0.2.1-rc.2 并在 core 层为扩展 Handler 增加幂等声明，不以更名宣称完成生产环境认证。当前真实模型、桌面 UI 和实际沙箱尚未完整验收；同进程内存状态不支持跨重启恢复。
 
 ## 入口及配置层次
 

package/docs/releases/0.6.0.md

@@ -0,0 +1,20 @@
+# 萧何 / Xiao He 0.6.0
+
+## DSH 0.2.1-rc.2 兼容与 Handler 幂等约束
+
+本版把兼容目标对齐到 DSH 0.2.1-rc.2，并在 core 层为扩展 Handler 增加可声明的幂等约束。
+
+- 兼容目标升级为 DSH 0.2.1-rc.2：五个宿主 peer 依赖由 0.2.0-rc.2 升至 0.2.1-rc.2，锁文件重建。0.2.0-rc.2 宿主应继续使用 0.5.x。
+- 新增 Handler.idempotent 声明。显式 idempotent:false 时，终态结果复用被拒绝并返回 MUTATING_REUSE_DENIED；运行中的重复 attach 仍只等待同一个执行，不会二次执行。省略该字段默认幂等，保持既有 handler 与调用方行为。
+- 内置 test 与 host.read 显式声明 idempotent:true。
+- 适配 0.2.1-rc.2 新增的 workingDirectory 服务：真实宿主组件测试为 read/run_code 路径注入最小 stub，不改变插件运行逻辑。
+
+## 升级说明
+
+需要 DSH 0.2.1-rc.2。升级前先停止新请求，等待已有任务完成或请求合作取消。本版不自动安装、重写日常配置或重启 DSH。
+
+历史预设 execution-bus-test、配置行 preset-execution-bus-test、工具名、协议字段和既有错误码均不变；错误词汇仅新增 MUTATING_REUSE_DENIED。
+
+## 验证与限制
+
+本地全量 76 项测试通过（含新增幂等回归、真实宿主组件与 Node PTC 组件测试），包白名单校验通过。真实模型、桌面 UI 与实际沙箱仍未完整验收；状态仍为进程内存，不支持跨重启恢复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng0531/dsh-execution-bus",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "type": "module",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",
@@ -52,25 +52,25 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-include": "~1.0.9",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-jobs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2"
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-jobs": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent-loop": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent-preset": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent-preset-registry": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent-tool-presentation": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-jobs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-jobs-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-persona": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-ptc-runtime-node": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tool-fs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tool-jobs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-preset": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-tool-presentation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-jobs": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-jobs-local": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-persona": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-ptc-runtime-node": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tool-fs": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tool-jobs": "0.2.1-rc.2",
     "@types/js-yaml": "4.0.9",
     "@types/node": "^22",
     "prettier": "3.6.2",