relay-dsh-plugin-claude 0.1.4 → 0.2.0-rc.1

package/README.md

@@ -1,12 +1,19 @@
 # Claude Code Conversations for DeepSeek Harness
 
+> **Now supports the latest DSH `0.1.2-alpha.2`.** The same plugin release is verified on DSH `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.2.md).
+
+```bash
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add relay-dsh-plugin-claude@0.2.0-rc.1
+npx @deepseek-ai/dsh@0.1.2-alpha.2 web
+```
+
 [![npm version](https://img.shields.io/npm/v/relay-dsh-plugin-claude?label=npm)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
 [![CI](https://github.com/yangbobo2021/relay-dsh-plugin-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/yangbobo2021/relay-dsh-plugin-claude/actions/workflows/ci.yml)
 [![npm downloads](https://img.shields.io/npm/dm/relay-dsh-plugin-claude?label=downloads)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
 [![GitHub stars](https://img.shields.io/github/stars/yangbobo2021/relay-dsh-plugin-claude?style=flat)](https://github.com/yangbobo2021/relay-dsh-plugin-claude/stargazers)
 [![MIT license](https://img.shields.io/github/license/yangbobo2021/relay-dsh-plugin-claude)](LICENSE)
-[![DSH compatibility](https://img.shields.io/badge/DSH-0.1.1--rc.2-2f7d68)](https://github.com/deepseek-ai/deepseek-harness)
-[![npm provenance](https://img.shields.io/badge/npm_provenance-verified-2f9e44)](https://www.npmjs.com/package/relay-dsh-plugin-claude/v/0.1.4)
+[![DSH compatibility](https://img.shields.io/badge/DSH-0.1.1--rc.2%20%7C%200.1.2--alpha.2-2f7d68)](https://github.com/deepseek-ai/deepseek-harness)
+[![npm provenance](https://img.shields.io/badge/npm_provenance-verified-2f9e44)](https://www.npmjs.com/package/relay-dsh-plugin-claude/v/0.1.5)
 
 English | [中文](README.zh.md)
 
@@ -109,7 +116,7 @@ Use `@latest` to install the current stable release:
 npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add relay-dsh-plugin-claude@latest
 ```
 
-At the time of writing, `latest` resolves to stable version `0.1.4`. The linked
+At the time of writing, `latest` resolves to stable version `0.1.5`. The linked
 npm page is the source of truth for the current version.
 
 #### npm prerelease (recommended during DSH preview)
@@ -122,7 +129,7 @@ contains the latest model-selection synchronization fix:
 npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add relay-dsh-plugin-claude@next
 ```
 
-At the time of writing, `next` resolves to `0.1.4`.
+At the time of writing, `next` resolves to `0.1.5`.
 
 #### GitHub development build
 
@@ -136,7 +143,7 @@ npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/rel
 full Commit SHA instead. For example:
 
 ```bash
-npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.1.4
+npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.1.5
 ```
 
 The official DSH CLI initializes the `web` Profile if it does not exist, asks
@@ -173,8 +180,11 @@ activates the bundle and registers the managed **Claude Code** mode automaticall
 
 ### 5. Import an existing Claude terminal Session
 
-1. Open the target Workspace or one of its Sessions in DSH.
-2. Select **Import Claude Sessions** below the Workspace list.
+1. Select **Import sessions...** below the Workspace list, then choose **Import
+   from Claude**.
+2. In the dialog, confirm or change the visible **Target Workspace**, then select
+   **Scan Sessions**. The current Session owner or recent Workspace is only the
+   initial selection; scanning never starts before this confirmation.
 3. Review the full Session IDs, titles, source paths, activity times, and import
    status. Select one, several, or all Sessions.
 4. Select **Import selected**, then open the imported DSH Session.
@@ -183,7 +193,7 @@ activates the bundle and registers the managed **Claude Code** mode automaticall
 
 The selector uses the Claude Agent SDK's public Session APIs and matches the
 terminal `/resume` scope. It excludes worktrees, SDK/headless Sessions,
-already-bound Sessions, and Sessions outside the exact registered Workspace.
+already-bound Sessions, and Sessions outside the explicitly selected Workspace.
 The imported history is a one-time presentation snapshot of user text, visible
 assistant text and thinking, and completed textual tool activity. Unknown or
 private blocks are skipped; Claude's source transcript is never modified.
@@ -271,12 +281,13 @@ This repository was designed and compatibility-tested in
 long-running agent work, external-event delivery, reusable DSH workbench views,
 and multiple conversation backends.
 
-The plugin is independently installable. It has no runtime dependency on the
-Relay application, Relay Events, or another Relay plugin. It does not replace the
-official DSH layout or install Files and Terminal views. This separation lets a
-user install only Claude while the broader Relay project can compose Codex,
-Claude, events, waits, monitors, and workbench extensions when those capabilities
-are needed.
+The plugin is independently installable. Its only Relay package dependency is
+the provider-neutral session import hub, which the package manager installs
+automatically. It has no runtime dependency on the Relay application, Relay
+Events, or another feature plugin. It does not replace the official DSH layout
+or install Files and Terminal views. This separation lets a user install only
+Claude while the broader Relay project can compose Codex, Claude, events, waits,
+monitors, and workbench extensions when those capabilities are needed.
 
 Explore or star Relay to follow that broader work:
 <https://github.com/yangbobo2021/Relay>.
@@ -345,3 +356,13 @@ tests reject accidental runtime dependencies on Relay or another feature plugin.
 
 Report bugs and feature requests in this repository's
 [issue tracker](https://github.com/yangbobo2021/relay-dsh-plugin-claude/issues).
+
+### New candidate installation (available only after publication)
+
+The same candidate targets DSH `0.1.1-rc.2` and `0.1.2-alpha.2`; this version and Git tag are not published yet.
+
+```sh
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add relay-dsh-plugin-claude@next
+# Git tag alternative, after publication:
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.0-rc.1
+```

package/README.zh.md

@@ -1,12 +1,19 @@
 # 在 DeepSeek Harness 中使用 Claude Code 对话
 
+> **现已支持最新 DSH `0.1.2-alpha.2`。** 同一插件版本已在 DSH `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.2.md)。
+
+```bash
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add relay-dsh-plugin-claude@0.2.0-rc.1
+npx @deepseek-ai/dsh@0.1.2-alpha.2 web
+```
+
 [![npm 版本](https://img.shields.io/npm/v/relay-dsh-plugin-claude?label=npm)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
 [![CI](https://github.com/yangbobo2021/relay-dsh-plugin-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/yangbobo2021/relay-dsh-plugin-claude/actions/workflows/ci.yml)
 [![npm 月下载量](https://img.shields.io/npm/dm/relay-dsh-plugin-claude?label=downloads)](https://www.npmjs.com/package/relay-dsh-plugin-claude)
 [![GitHub Stars](https://img.shields.io/github/stars/yangbobo2021/relay-dsh-plugin-claude?style=flat)](https://github.com/yangbobo2021/relay-dsh-plugin-claude/stargazers)
 [![MIT 许可证](https://img.shields.io/github/license/yangbobo2021/relay-dsh-plugin-claude)](LICENSE)
-[![DSH 兼容版本](https://img.shields.io/badge/DSH-0.1.1--rc.2-2f7d68)](https://github.com/deepseek-ai/deepseek-harness)
-[![npm 来源证明](https://img.shields.io/badge/npm_provenance-verified-2f9e44)](https://www.npmjs.com/package/relay-dsh-plugin-claude/v/0.1.4)
+[![DSH 兼容版本](https://img.shields.io/badge/DSH-0.1.1--rc.2%20%7C%200.1.2--alpha.2-2f7d68)](https://github.com/deepseek-ai/deepseek-harness)
+[![npm 来源证明](https://img.shields.io/badge/npm_provenance-verified-2f9e44)](https://www.npmjs.com/package/relay-dsh-plugin-claude/v/0.1.5)
 
 [English](README.md) | 中文
 
@@ -104,7 +111,7 @@ claude
 npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add relay-dsh-plugin-claude@latest
 ```
 
-本文更新时，`latest` 指向稳定版 `0.1.4`。最新版本请以链接中的 npm 页面
+本文更新时，`latest` 指向稳定版 `0.1.5`。最新版本请以链接中的 npm 页面
 为准。
 
 #### npm 预发布版（DSH 预览阶段推荐）
@@ -116,7 +123,7 @@ npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add relay-dsh-plugin-claude
 npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add relay-dsh-plugin-claude@next
 ```
 
-本文更新时，`next` 指向 `0.1.4`。
+本文更新时，`next` 指向 `0.1.5`。
 
 #### GitHub 开发版
 
@@ -130,7 +137,7 @@ npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/rel
 SHA。例如：
 
 ```bash
-npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.1.4
+npx @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.1.5
 ```
 
 官方 DSH CLI 会在需要时初始化 `web` Profile，通过 `pnpm` 安装所选软件包和
@@ -164,15 +171,16 @@ npx @deepseek-ai/dsh@0.1.1-rc.2 web
 
 ### 5. 导入已有的 Claude 终端会话
 
-1. 在 DSH 中打开目标工作区或其中一个 Session。
-2. 点击工作区列表下方的 **导入 Claude 会话**。
+1. 点击工作区列表下方的 **导入会话...**，然后选择 **从 Claude 导入**。
+2. 在弹窗中确认或切换可见的 **目标 Workspace**，然后点击 **扫描会话**。
+   当前 Session 所属 Workspace 或最近 Workspace 只作为初始选项；确认前不会开始扫描。
 3. 检查完整 Session ID、标题、源路径、活动时间和导入状态，然后选择一个、
    多个或全部会话。
 4. 点击 **导入所选会话**，再打开导入后的 DSH Session。
 5. 发送下一条消息，确认它继续的是同一个原生 Claude Session。
 
 选择器只使用 Claude Agent SDK 的公开 Session API，其范围与终端 `/resume`
-一致。它会排除 worktree、SDK/headless、已经绑定以及不属于当前精确注册工作区
+一致。它会排除 worktree、SDK/headless、已经绑定以及不属于用户所选精确工作区
 的 Session。导入历史是一次性的展示快照，包含用户文本、可见的助手文本与
 thinking，以及已有结果的文本工具活动。未知或私有块会被跳过，Claude 源转录
 不会被修改。
@@ -244,10 +252,11 @@ PNG；工作区中不会产生同名 PNG，也不会加载外部资源或执行
 兼容性验证。Relay 是面向长时间运行 Agent、外部事件投递、可复用 DSH
 工作台视图和多种对话后端的开源项目。
 
-本插件可以独立安装。运行时不依赖 Relay 应用、Relay Events 或其他 Relay
-插件，也不会替换 DSH 官方布局或安装 Files、Terminal 视图。用户可以只安装
-Claude；需要时，Relay 项目则可以进一步组合 Codex、Claude、事件、Wait、
-Monitor 和工作台扩展。
+本插件可以独立安装。唯一依赖的 Relay 包是由包管理器自动安装的中立“会话
+导入中心”；运行时不依赖 Relay 应用、Relay Events 或其他功能插件，也不会
+替换 DSH 官方布局或安装 Files、Terminal 视图。用户可以只安装 Claude；需要
+时，Relay 项目则可以进一步组合 Codex、Claude、事件、Wait、Monitor 和工作台
+扩展。
 
 可以访问或 Star Relay 仓库，关注这些更完整的工作：
 <https://github.com/yangbobo2021/Relay>。
@@ -309,11 +318,21 @@ DSH_ROOT=/path/to/deepseek-harness npm run verify
 npm pack
 ```
 
-`npm run verify` 会执行类型检查、测试和生产构建。边界测试会阻止插件意外
-增加对 Relay 或其他功能插件的运行时依赖。
+`npm run verify` 会执行类型检查、测试和生产构建。边界测试仅允许中立的会话
+导入中心依赖，并会阻止插件意外增加对 Relay 应用或其他功能插件的运行时依赖。
 
 ## 反馈
 
 请通过本仓库的
 [Issue Tracker](https://github.com/yangbobo2021/relay-dsh-plugin-claude/issues)
 报告错误或提出功能建议。
+
+### 新候选版安装（发布后才可用）
+
+同一候选面向 DSH `0.1.1-rc.2` 和 `0.1.2-alpha.2`；此版本和 Git Tag 目前尚未发布。
+
+```sh
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add relay-dsh-plugin-claude@next
+# Git tag alternative, after publication:
+npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-claude#v0.2.0-rc.1
+```

package/cordis.patch.yml

@@ -1,3 +1,5 @@
 - insert:
+    - id: relay-session-import-for-claude
+      name: 'relay-dsh-plugin-session-import'
     - id: relay-claude-host
       name: 'relay-dsh-plugin-claude'

package/docs/dsh-0.1.2-alpha.2.md

@@ -0,0 +1,34 @@
+# DSH 双版本兼容候选（未发布）
+
+同一个 `0.2.0-rc.1` 候选包的兼容目标：
+
+| DSH | 官方提交 |
+| --- | --- |
+| `0.1.1-rc.2` | `b150a551b8d465e31e418e1b2eaf5e79bbb7d28e` |
+| `0.1.2-alpha.2` | `0a53fb55bea101816fa226bb964ae2bed71c343b` |
+
+不按 DSH 版本分别发包；不要求旧用户先升级管理器。没有自定义精确版本白名单。
+DSH 可选 peer 使用版本范围表达声明，不把它当成旧宿主必然执行的安装拦截。
+当前没有发布、创建远端标签或改变 npm `latest` / `next`。预发布沿用普通 `next` 通道。
+
+## 本插件变更
+
+导入历史的工具调用 ID 兼容两种 Host 导出；前端事件服务及会话预设读取兼容两种接口；模型切换保持取消和过期结果隔离。真实 Claude 图片识别与 fork 上下文继承按用户要求暂缓，没有标为通过。
+
+## 验收方式与边界
+
+开发类型检查及构建使用准备好的官方 `0.1.2-alpha.2` 源码。构建一次后，将相同 tarball
+分别安装到两版官方 DSH 的独立临时 profile，检查 Host 启动、浏览器装配、功能注册及
+适用的受控功能；不修改官方源码或日常运行环境。
+跨插件结果在 Relay 的 `dsh-lab/dual-compatibility-20260831/` 中记录；插件独立测试命令：
+
+```sh
+npm ci --ignore-scripts
+# 非管理器插件需要准备好的官方 DSH 源码；管理器使用锁定的 npm 开发依赖。
+export DSH_ROOT=/path/to/prepared/official/deepseek-harness
+npm run verify
+```
+
+两版核心回归不等于所有外部服务、平台或未来 DSH 版本均已验证。
+Claude 真实识图/fork 仍暂缓；Codex Default 模式原生提问限制、Workbench 刷新后尺寸不保留
+均不在本次兼容修复中关闭。所有公开 npm/GitHub 发布后的完整升级路径也需要发布后再验收。

package/docs/spec/claude-native-session-import.md

@@ -26,6 +26,14 @@ promise that another Claude client is no longer writing it.
 
 ## Inventory and selection
 
+The provider-neutral session import hub owns one sidebar footer action. Claude
+registers one renderless provider descriptor with the localized label **Import
+from Claude**, the Claude mark, order `20`, and an `open` callback. Selecting
+that menu row closes the hub menu and presents Claude's visible Workspace
+selector. The current Session owner, then the recent Workspace, is only an
+initial choice. The user may change it, and the plugin must not scan until the
+user invokes **Scan Sessions**.
+
 Each candidate exposes the full native Session ID, deterministic title, source
 path, source `lastModified`, and either `ready` or `recoverable` status. The
 ordering is descending source activity time with Session ID as a deterministic
@@ -104,11 +112,16 @@ Delivery requires all of the following evidence:
    Workspace isolation, deterministic ordering, selection atomicity, source
    revalidation, projection, one-to-one durability, concurrency, retry, and the
    no-replacement resume rule.
-3. Client tests cover Workspace choice, selection, request payloads, chunked
-   NDJSON progress, error handling, disabled empty submission, and refresh order.
+3. Client tests cover provider registration and disposal, explicit menu-driven
+   opening, visible Workspace choice, no automatic scan, exact selected path,
+   candidate selection, request payloads, chunked NDJSON progress, error
+   handling, disabled empty submission, and refresh order.
 4. A real installed SDK lists and reads a native terminal Session using only the
    public APIs.
 5. Official DSH imports that Session, displays the projected history and title,
    and sends the next turn to the same complete native Session ID.
-6. Typecheck, the full repository test suite, build, package-content inspection,
+6. A combined Claude + Codex browser check and screenshots prove one hub action
+   presents both explicit provider rows in expanded and collapsed sidebars and
+   that the selector dialog is readable.
+7. Typecheck, the full repository test suite, build, package-content inspection,
    and remote CI all pass.

package/dsh-client-compat.d.mts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis'
+import type {} from '@deepseek-ai/dsh-client-ui-model-selection/client'
+export function sessionPreset(session: { agentPreset?: string | null; projectionValues?: { agentPreset?: string | null } } | undefined): string | null | undefined
+export function modelDirectory(ctx: unknown, sessionId: string): Pick<ReturnType<Context['modelDirectories']['directoryFor']>, 'load' | 'select'>

package/dsh-client-compat.mjs

@@ -0,0 +1,26 @@
+// Public interface adapters shared by both supported DSH generations.
+export function sessionPreset(session) {
+  if (session?.projectionValues && Object.hasOwn(session.projectionValues, 'agentPreset')) {
+    return session.projectionValues.agentPreset;
+  }
+  return session?.agentPreset;
+}
+
+const service = (ctx, name) => typeof ctx.get === 'function' ? ctx.get(name) : ctx[name];
+export function modelDirectory(ctx, sessionId) {
+  const directories = service(ctx, 'modelDirectories');
+  if (directories) return directories.directoryFor(sessionId);
+  const sessions = service(ctx, 'connection')?.api?.sessions;
+  if (!sessions) throw new Error('DSH model selection interface is unavailable');
+  return {
+    async load() {
+      const response = await sessions.models({ sessionId });
+      if (!response.result.ok) throw new Error('DSH model discovery failed');
+      return response.result.value;
+    },
+    async select(selection) {
+      const response = await sessions.selectModel({ sessionId, ...selection });
+      if (!response.result.ok) throw new Error('DSH model selection failed');
+    },
+  };
+}

package/dsh-compat.mjs

@@ -0,0 +1,9 @@
+import * as llm from '@deepseek-ai/dsh-llm';
+
+// Keep namespace access: a named import fails before this adapter can run on
+// the other official DSH generation. Both constructors have the same contract.
+export 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);
+}