dsh-plugin-bridge 0.2.10

package/lib/rpc.js

@@ -0,0 +1,76 @@
+/**
+ * dsh 网关 RPC 的最小客户端。
+ *
+ * 线协议见上游 `packages/host/apiproxy/src/fetch/handler.ts`：
+ * `POST /api/<method>`，`Content-Type: application/json`（非 JSON 会被 415 挡掉，
+ * 这是跨站写入围栏），请求体是 `client-request` 信封，响应体是 `server-response`。
+ * 回环无鉴权。
+ */
+/** 一次 RPC 的业务错误（网关返回 `result.ok === false`）。 */
+export class RpcError extends Error {
+    method;
+    code;
+    details;
+    constructor(method, code, message, details) {
+        super(`${method} 失败（${code}）：${message}`);
+        this.name = 'RpcError';
+        this.method = method;
+        this.code = code;
+        this.details = details;
+    }
+}
+/**
+ * 解析 API 根。优先级：显式参数 > `DSH_API` > `DSH_WEB_URL`（模型 shell 环境里
+ * 由 web bundle 注入的本机 GUI 地址）> 回环默认值。
+ */
+export function resolveApiBase(explicit, env = process.env) {
+    // 环境变量被设成空串是常态（脚本里 `DSH_API=` 之类），空串要当作没设。
+    const nonEmpty = (value) => {
+        const trimmed = value?.trim();
+        return trimmed ? trimmed : undefined;
+    };
+    const webUrl = nonEmpty(env.DSH_WEB_URL);
+    const raw = nonEmpty(explicit)
+        ?? nonEmpty(env.DSH_API)
+        ?? (webUrl ? `${webUrl.replace(/\/$/, '')}/api` : undefined)
+        ?? 'http://127.0.0.1:3080/api';
+    return raw.replace(/\/$/, '');
+}
+/** 建一个 RPC 调用器。 */
+export function createRpc(options) {
+    const api = options.api.replace(/\/$/, '');
+    const defaultTimeout = options.timeoutMs ?? 30_000;
+    const prefix = options.prefix ?? 'bridge';
+    const doFetch = options.fetchImpl ?? fetch;
+    let seq = 0;
+    return async function rpc(method, payload = {}, timeoutMs) {
+        seq += 1;
+        const rpcId = `${prefix}-${seq}`;
+        let res;
+        try {
+            res = await doFetch(`${api}/${method}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ type: 'client-request', rpcId, method, payload }),
+                signal: AbortSignal.timeout(timeoutMs ?? defaultTimeout),
+            });
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            throw new RpcError(method, 'unreachable', `连不上 dsh 网关 ${api}（${reason}）。dsh web 在跑吗？可用 --api 指定地址。`);
+        }
+        if (!res.ok) {
+            throw new RpcError(method, `http-${res.status}`, `${api}/${method} 返回 HTTP ${res.status}`);
+        }
+        const envelope = await res.json();
+        if (envelope.rpcId !== rpcId) {
+            throw new RpcError(method, 'rpc-id-mismatch', `响应 rpcId 与请求不匹配（${String(envelope.rpcId)}）`);
+        }
+        if (!envelope.result?.ok) {
+            const err = envelope.result?.error;
+            throw new RpcError(method, err?.code ?? 'unknown', err?.message ?? '（网关未给出说明）', err?.details);
+        }
+        return envelope.result.value;
+    };
+}
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

package/lib/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 消息与事件的最小结构契约。
+ *
+ * 这份形状同时被三方消费：`fold.ts`（把 session.history 事件折叠成消息）、
+ * `compression.ts`（取材）、以及复用同一语义的客户端（WebUI / 桌面 GUI）。
+ * 此前 eval 侧另存了一份同名副本并使用了更宽的字段，导致 `eval/` 无法通过
+ * 类型检查；现在只保留这一份，字段以折叠器实际写入的为准。
+ */
+/** 一次工具调用在折叠结果里的痕迹。 */
+export interface ToolNode {
+    /** 展示分类，折叠器统一写 'bash'（保留字段以兼容客户端渲染）。 */
+    type?: string;
+    /** 工具名。 */
+    title: string;
+    /** 运行状态；`tool/result` 到达后转为 done。 */
+    status?: 'running' | 'done';
+    /** 与 `tool/result` 配对用的调用 id。 */
+    callId?: string;
+    /** 产生该节点的事件 seq。 */
+    eventSeq?: number;
+    /** 调用入参摘要（命令 / 路径 / 查询串），不含 stdout。 */
+    detail?: string;
+    /** 工具输出（取材阶段一律不使用）。 */
+    output?: string;
+}
+/** rc.8 持久化图片附件的最小引用；字节仍由 host 保存，不进入折叠结果。 */
+export interface ImageAttachmentRef {
+    attachmentId: string;
+    mediaType: 'image/jpeg' | 'image/png' | 'image/webp' | 'image/gif';
+    bytes: number;
+    width: number;
+    height: number;
+    name?: string;
+}
+/** 折叠后的一条会话消息。 */
+export interface ChatMessage {
+    /** 稳定 id，形如 `e-<seq>`。 */
+    id?: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    /** 'compaction' 表示这是一次上下文压缩检查点。 */
+    kind?: string;
+    toolNodes?: ToolNode[];
+    /** 推理内容（取材阶段一律不使用）。 */
+    thinking?: string;
+    thinkingMs?: number;
+    thinkingStartedAt?: number;
+    /** 该消息携带的图片数量。 */
+    imageCount?: number;
+    /** 能从 rc.8 history 恢复出的持久化图片引用；旧 host / 非法块可能只有 imageCount。 */
+    imageAttachments?: ImageAttachmentRef[];
+    /** 该消息已合并的最新事件 seq。 */
+    latestEventSeq?: number;
+    /** 本地化时刻，仅用于展示。 */
+    timestamp?: string;
+}
+/** session.history 的一条原始事件（宽松，运行时再判 type）。 */
+export interface SessionEvent {
+    type?: string;
+    seq?: number;
+    time?: number;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+}

package/lib/types.js

@@ -0,0 +1,9 @@
+/**
+ * 消息与事件的最小结构契约。
+ *
+ * 这份形状同时被三方消费：`fold.ts`（把 session.history 事件折叠成消息）、
+ * `compression.ts`（取材）、以及复用同一语义的客户端（WebUI / 桌面 GUI）。
+ * 此前 eval 侧另存了一份同名副本并使用了更宽的字段，导致 `eval/` 无法通过
+ * 类型检查；现在只保留这一份，字段以折叠器实际写入的为准。
+ */
+export {};

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "dsh-plugin-bridge",
+  "version": "0.2.10",
+  "description": "Previewable cross-preset session migration for DeepSeek Harness with bounded, fixed-schema handoffs",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "docs",
+    "reports/v0.2.3-e2e-2026-08-20T13-19-13-924Z.raw.json",
+    "reports/v0.2.3-e2e-report.md",
+    "reports/v0.2.6-rc11-vision-report.md",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:check": "npm run build && git diff --exit-code -- lib",
+    "typecheck": "tsc -p tsconfig.check.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run verify",
+    "test": "npm run build && npm run typecheck && node --experimental-strip-types --test test/*.test.mjs",
+    "eval": "node eval/run.mjs",
+    "datasets:check": "node scripts/check-datasets.mjs",
+    "pack:check": "npm pack --dry-run",
+    "package:smoke": "node scripts/package-smoke.mjs",
+    "release:check": "node scripts/check-release-version.mjs",
+    "verify": "npm test && npm run build:check && npm run datasets:check && npm run package:smoke"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "bridge",
+    "context-migration",
+    "agent-preset",
+    "session-migration"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Totoro-qaq/dsh-plugin-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Totoro-qaq/dsh-plugin-bridge/issues"
+  },
+  "homepage": "https://github.com/Totoro-qaq/dsh-plugin-bridge#readme",
+  "bin": {
+    "dsh-bridge": "lib/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./compression": {
+      "types": "./lib/compression.d.ts",
+      "default": "./lib/compression.js"
+    },
+    "./fold": {
+      "types": "./lib/fold.d.ts",
+      "default": "./lib/fold.js"
+    },
+    "./migrate": {
+      "types": "./lib/migrate.d.ts",
+      "default": "./lib/migrate.js"
+    },
+    "./rpc": {
+      "types": "./lib/rpc.d.ts",
+      "default": "./lib/rpc.js"
+    },
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "default": "./lib/types.js"
+    },
+    "./command": {
+      "types": "./lib/command.d.ts",
+      "default": "./lib/command.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  }
+}