relay-dsh-plugin-claude 0.2.1 → 0.2.2

package/README.md

@@ -1,10 +1,12 @@
 # Claude Code Conversations for DeepSeek Harness
 
-> **Now supports the latest DSH `0.1.2-alpha.3`.** Plugin `0.2.1` is verified on DSH `0.1.2-alpha.3`, `0.1.2-alpha.2`, and `0.1.1-rc.2`. [Install it and try the latest DSH](https://www.npmjs.com/package/relay-dsh-plugin-claude) · [Compatibility details](docs/dsh-0.1.2-alpha.3.md).
+> **Now supports DSH `0.1.2-rc.1` while retaining `0.1.2-alpha.3` compatibility.** Plugin `0.2.2` is verified on both releases. [Install it from npm](https://www.npmjs.com/package/relay-dsh-plugin-claude) · [Compatibility evidence](https://github.com/yangbobo2021/Relay/tree/codex/relay-foundation/dsh-lab/dsh-0.1.2-rc.1-20260903).
+
+> **Release channels:** `latest` → `0.2.2`; `next` → `0.2.1-rc.1`.
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@0.2.1
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@0.2.2
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 [![npm version](https://img.shields.io/npm/v/relay-dsh-plugin-claude?label=npm)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
@@ -37,8 +39,8 @@ Session. The install requires Node.js 22.13 or newer and `pnpm` on `PATH`. Then
 stop DSH Web, install the tested stable release, and restart DSH:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 Open **New Session**, select a workspace, choose **Claude Code** from the mode
@@ -113,7 +115,7 @@ The published npm package name is
 Use `@latest` to install the current stable release:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
 ```
 
 At the time of writing, `latest` resolves to stable version `0.2.1`. The linked
@@ -126,24 +128,24 @@ CI publishing and official DSH compatibility checks. The current candidate also
 contains the latest model-selection synchronization fix:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@next
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@next
 ```
 
-At the time of writing, `next` resolves to `0.2.0-rc.1`.
+At the time of writing, `next` resolves to `0.2.1-rc.1`.
 
 #### GitHub development build
 
 Install the current `main` branch when testing an unreleased change:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#main
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#main
 ```
 
 `main` can change at any time. For a reproducible GitHub install, pin a Tag or
 full Commit SHA instead. For example:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.1
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.2
 ```
 
 The official DSH CLI initializes the `web` Profile if it does not exist, asks
@@ -152,12 +154,12 @@ adds the plugin's bundle layer. No Relay checkout is required. The first
 installation can take longer while platform-specific Claude Agent SDK packages
 are downloaded; wait for pnpm's final `Done` message or an explicit error. If
 you already installed the `dsh` command, replace the
-`npx @deepseek-ai/dsh@0.1.2-alpha.3` prefix with `dsh` in any command above.
+`npx @deepseek-ai/dsh@0.1.2-rc.1` prefix with `dsh` in any command above.
 
 ### 3. Start or restart DSH Web
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 If you use an installed command, run `dsh web` instead. Bundle membership is read
@@ -307,7 +309,7 @@ dsh plugin --profile web update relay-dsh-plugin-claude
 dsh plugin --profile web remove relay-dsh-plugin-claude
 ```
 
-Use the `npx @deepseek-ai/dsh@0.1.2-alpha.3` prefix instead of `dsh` when you do not
+Use the `npx @deepseek-ai/dsh@0.1.2-rc.1` prefix instead of `dsh` when you do not
 have a persistent DSH command.
 
 ## Troubleshooting
@@ -362,7 +364,7 @@ Report bugs and feature requests in this repository's
 Stable `0.2.1` targets DSH `0.1.1-rc.2`, `0.1.2-alpha.2`, and `0.1.2-alpha.3`; install it from npm `latest` or Git tag `v0.2.1`.
 
 ```sh
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
 # Git tag alternative, after publication:
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.1
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.2
 ```

package/README.zh.md

@@ -1,10 +1,12 @@
 # 在 DeepSeek Harness 中使用 Claude Code 对话
 
-> **现已支持最新 DSH `0.1.2-alpha.3`。** 插件 `0.2.1` 已在 DSH `0.1.2-alpha.3`、`0.1.2-alpha.2` 与 `0.1.1-rc.2` 上完成兼容验证。[安装插件，立即体验最新版 DSH](https://www.npmjs.com/package/relay-dsh-plugin-claude) · [兼容性详情](docs/dsh-0.1.2-alpha.3.md)。
+> **现已支持 DSH `0.1.2-rc.1`，并保留对 `0.1.2-alpha.3` 的兼容。** 插件 `0.2.2` 已在两个版本上完成验证。[从 npm 安装](https://www.npmjs.com/package/relay-dsh-plugin-claude) · [兼容性证据](https://github.com/yangbobo2021/Relay/tree/codex/relay-foundation/dsh-lab/dsh-0.1.2-rc.1-20260903)。
+
+> **发布通道：** `latest` → `0.2.2`；`next` → `0.2.1-rc.1`。
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@0.2.1
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@0.2.2
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 [![npm 版本](https://img.shields.io/npm/v/relay-dsh-plugin-claude?label=npm)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
@@ -36,8 +38,8 @@ Agent SDK Session。本插件可独立安装，不需要下载 Relay 仓库。
 安装经过测试的稳定版本并重新启动：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 打开 **New Session**，选择工作区，再从模式菜单中选择 **Claude Code** 并发送
@@ -108,7 +110,7 @@ claude
 使用 `@latest` 安装当前稳定版本：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
 ```
 
 本文更新时，`latest` 指向稳定版 `0.2.1`。最新版本请以链接中的 npm 页面
@@ -120,24 +122,24 @@ npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-cla
 候选版本。当前候选版本还包含最新的模型选择同步修复：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@next
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@next
 ```
 
-本文更新时，`next` 指向 `0.2.0-rc.1`。
+本文更新时，`next` 指向 `0.2.1-rc.1`。
 
 #### GitHub 开发版
 
 如需测试尚未发布的修改，可以直接安装当前 `main` 分支：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#main
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#main
 ```
 
 `main` 会持续变化。如需可复现的 GitHub 安装，请固定 Tag 或完整 Commit
 SHA。例如：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.1
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.2
 ```
 
 官方 DSH CLI 会在需要时初始化 `web` Profile，通过 `pnpm` 安装所选软件包和
@@ -145,12 +147,12 @@ Claude Agent SDK 依赖，并将插件加入 Bundle 配置。用户不需要下
 仓库。首次安装还会下载 Claude Agent SDK 的平台相关软件包，可能需要更长
 时间；请等待 pnpm 最终显示 `Done` 或明确错误。如果已经安装了持久可用的
 `dsh` 命令，可以将上述任一命令开头的
-`npx @deepseek-ai/dsh@0.1.2-alpha.3` 替换为 `dsh`。
+`npx @deepseek-ai/dsh@0.1.2-rc.1` 替换为 `dsh`。
 
 ### 3. 启动或重启 DSH Web
 
 ```bash
-npx @deepseek-ai/dsh@0.1.2-alpha.3 web
+npx @deepseek-ai/dsh@0.1.2-rc.1 web
 ```
 
 如果使用已经安装的命令，则执行 `dsh web`。DSH 只在启动时读取 Bundle
@@ -277,7 +279,7 @@ dsh plugin --profile web remove relay-dsh-plugin-claude
 ```
 
 如果没有持久安装 `dsh` 命令，请将命令开头的 `dsh` 替换为
-`npx @deepseek-ai/dsh@0.1.2-alpha.3`。
+`npx @deepseek-ai/dsh@0.1.2-rc.1`。
 
 ## 常见问题
 
@@ -332,7 +334,7 @@ npm pack
 稳定版 `0.2.1` 面向 DSH `0.1.1-rc.2`、`0.1.2-alpha.2` 和 `0.1.2-alpha.3`；可通过 npm `latest` 或 Git Tag `v0.2.1` 安装。
 
 ```sh
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add relay-dsh-plugin-claude@latest
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-claude@latest
 # Git tag alternative, after publication:
-npx @deepseek-ai/dsh@0.1.2-alpha.3 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.1
+npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.2
 ```

package/dsh-compat.mjs

@@ -7,3 +7,14 @@ export function toolCallId(value) {
   if (typeof create !== 'function') throw new Error('DSH does not provide a tool call ID constructor');
   return create(value);
 }
+
+export function sessionEvents(session, from = 0) {
+  if (!Number.isSafeInteger(from) || from < 0) throw new RangeError('session event offset must be a non-negative integer');
+  const snapshot = Reflect.get(session, 'snapshotEvents');
+  if (typeof snapshot === 'function') {
+    return from === 0 ? Reflect.apply(snapshot, session, []) : Reflect.apply(snapshot, session, [from]);
+  }
+  const events = Reflect.get(session, 'events');
+  if (!Array.isArray(events)) throw new TypeError('DSH Session exposes neither snapshotEvents() nor events');
+  return from === 0 ? events : events.slice(from);
+}

package/lib/host-plugin.js

@@ -1677,6 +1677,21 @@ function positiveInteger(value, fallback) {
 	return Number.isSafeInteger(value) && value > 0 ? value : fallback;
 }
 //#endregion
+//#region dsh-compat.mjs
+function toolCallId(value) {
+	const create = Reflect.get(llm, "ToolCallId") ?? Reflect.get(llm, "CallId");
+	if (typeof create !== "function") throw new Error("DSH does not provide a tool call ID constructor");
+	return create(value);
+}
+function sessionEvents(session, from = 0) {
+	if (!Number.isSafeInteger(from) || from < 0) throw new RangeError("session event offset must be a non-negative integer");
+	const snapshot = Reflect.get(session, "snapshotEvents");
+	if (typeof snapshot === "function") return from === 0 ? Reflect.apply(snapshot, session, []) : Reflect.apply(snapshot, session, [from]);
+	const events = Reflect.get(session, "events");
+	if (!Array.isArray(events)) throw new TypeError("DSH Session exposes neither snapshotEvents() nor events");
+	return from === 0 ? events : events.slice(from);
+}
+//#endregion
 //#region claude-image-output.js
 const MEDIA_TYPES = /* @__PURE__ */ new Map([
 	[".gif", "image/gif"],
@@ -2199,7 +2214,7 @@ var ClaudeDshAdapter = class extends LlmAdapter {
 		const text = content.filter((block) => block.type === "text").map((block) => block.text).join("\n").trim();
 		const agent = this.agents.get(sessionId);
 		if (!agent) throw new Error(`Relay Claude adapter has no attached agent for ${sessionId}`);
-		const nativePermissions = permissionConfiguration(agent.session.events);
+		const nativePermissions = permissionConfiguration(sessionEvents(agent.session));
 		const config = this.configure(sessionId, {
 			...options.provider === "relay-claude" ? { model: options.model } : {},
 			...options.provider === "relay-claude" ? { effort: options.reasoningEffort } : {},
@@ -2773,8 +2788,9 @@ function subscribeRuntimeActivity(runtime, listener) {
 	return () => runtime.off("activity", listener);
 }
 function effectivePreset(session) {
-	for (let index = session.events.length - 1; index >= 0; index -= 1) {
-		const event = session.events[index];
+	const events = sessionEvents(session);
+	for (let index = events.length - 1; index >= 0; index -= 1) {
+		const event = events[index];
 		if (event.type === "agent-preset/selected") return event.data.agentPreset;
 	}
 	return session.header.agentPreset;
@@ -3288,13 +3304,6 @@ function plainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
 }
 //#endregion
-//#region dsh-compat.mjs
-function toolCallId(value) {
-	const create = Reflect.get(llm, "ToolCallId") ?? Reflect.get(llm, "CallId");
-	if (typeof create !== "function") throw new Error("DSH does not provide a tool call ID constructor");
-	return create(value);
-}
-//#endregion
 //#region dsh-import-target.js
 var DshClaudeImportTarget = class {
 	constructor({ ctx, logger = console }) {