dsh-tunetune 0.0.0-stage → 0.7.0

package/INSTALL.md

@@ -0,0 +1,39 @@
+# Install TuneTune and start a study
+
+Install the four skills, initialize the current conversation directory, open the panel and continue with the person's original request in their language. Do not silently create a child study directory.
+
+## Install the skills
+
+Use the user-supplied repository, normally https://github.com/nanshine/tunetune; do not substitute another publisher. Skip this step when `research-workspace`, `tunetune-init`, `build-evaluation` and `run-experiments` are already installed side by side.
+
+With Node.js available, install for the current application only, user-wide so later studies in other directories need nothing new. Use that application's skills CLI identifier, such as `codex`, `claude-code`, `cursor`, `opencode`, `trae`, `trae-cn`, `qoder` or `qoder-cn`:
+
+```sh
+npx skills add nanshine/tunetune --global --agent <application> -y
+```
+
+Do not use `--agent '*'` on the person's behalf, since it writes into every supported application. Without Node.js, or when the skills CLI does not know the application, clone into a temporary directory outside the project and copy the four folders under `plugins/tunetune/skills/` into the application's user skill directory: `~/.claude/skills/` for Claude Code, `~/.agents/skills/` for Codex, `~/.cursor/skills/` for Cursor, `~/.config/opencode/skills/` for OpenCode, `~/.trae/skills/` or `~/.trae-cn/skills/` for Trae, `~/.qoder/skills/` or `~/.qoder-cn/skills/` for Qoder. For any other application, use the user skill directory its documentation names, and say that TuneTune has not been tested there. Accept only ordinary files and directories. Refuse to replace existing skill folders that differ, and tell the person instead: their research may be pinned to those tools.
+
+Plugins work too and need no Node.js: in Claude Code, `/plugin marketplace add nanshine/tunetune` then `/plugin install tunetune@tunetune`; in Codex, `codex plugin marketplace add nanshine/tunetune` then `codex plugin add tunetune@tunetune`. Leave the choice of plugin to the person.
+
+In DeepSeek Harness, the `dsh-tunetune` plugin brings the skills and shows the panel beside the conversation. Installing plugin code is the person's decision: suggest **Plugins** in the app, or `dsh plugin --profile <profile> add dsh-tunetune` for the profile they run (the desktop app uses `desktop`), and continue once they confirm; restart DeepSeek Harness if TuneTune does not appear. Without the plugin, copy the four folders into `~/.dsh/skills/` as above. See the shared skill's `references/agent-adapters.md` for how it runs the panel.
+
+## Initialize the current directory
+
+Check Python 3.10+ on macOS/Linux. Read the installed shared skill's `references/agent-adapters.md`, then run its initializer with actual paths:
+
+```sh
+python3 <research-workspace skill>/scripts/init.py --project <current-directory>
+```
+
+It verifies the skill's manifest, adds only the missing project guide, minimal research files and pinned tools under `.workspace/app/`, and preserves existing compatible research and instructions. It refuses older research formats and projects pinned to other tools without migrating them; explain that plainly instead of working around it.
+
+## Open and continue
+
+Start the panel in a managed session and give the actual printed address once it responds:
+
+```sh
+python3 .workspace/app/workspace.py --project . --port 0 --open
+```
+
+Continue in this conversation by reading the installed skills; do not ask the person to inspect a skill picker. Mention a refresh only when the application documents one, such as `/reload-skills` in Claude Code for a new top-level skills directory, or when the person reports the skills missing, with a continuation sentence carrying the original request. Report installation in a sentence, then use `research-workspace` and `tunetune-init` to investigate the goal. An open panel is not a background research scheduler.

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,4 @@
+TuneTune
+Copyright 2026 nanshine
+
+Licensed under the Apache License, Version 2.0; see LICENSE.

package/README.md

@@ -1,3 +1,178 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src="docs/assets/hero.png" alt="TuneTune：喷漆小鬼比出手指枪，喷出两团蓝色涂鸦" width="100%">
+
+# TuneTune
+
+**说出你的需求，Agent 在你的电脑上帮你研究出一个能用的私有小模型。**
+
+你提需求、做审核，Agent 当研究负责人 —— 从一句话到本地模型，每一步都有证据。
+
+`本地运行` · `数据不出电脑` · `Codex / Claude Code / Cursor 等 Agent 通用`
+
+</div>
+
+---
+
+## 一句话开始
+
+把下面这句话交给能读写本地文件、运行命令的 Agent（Codex、Claude Code 等）：
+
+> 用 TuneTune（https://github.com/nanshine/tunetune）帮我做一个能认出我家几只猫分别是谁的模型，照片在 `./photos` 里，就在当前文件夹开始。
+
+换成你自己的需求就行。Agent 会安装 skills、初始化当前目录、打开研究工作台，然后开始调研。
+
+**Agent：按 [INSTALL.md](INSTALL.md) 安装四个 skills，初始化当前目录，启动研究空间，再用 `tunetune-init` 延续原始需求。不要自行创建独立子研究目录。**
+
+只需要 macOS / Linux 和 Python 3.10+。面板已随 skills 构建好，不用克隆源码，也不用 Node.js。
+
+## 它长什么样
+
+<!-- 占位：30 秒演示 GIF。流程：输入一句需求 → 提案窗口弹出 → 点确认 → 画布上长出几轮实验 → 拖入一张自己的照片看到结果。等待处用"⏩ 20 分钟后"字幕跳过。放到 docs/assets/demo.gif -->
+<img src="docs/assets/demo.gif" alt="TuneTune 演示" width="100%">
+
+<table>
+<tr>
+<td width="33%"><!-- 占位：提案窗口截图 docs/assets/proposal.png --><img src="docs/assets/proposal.png" alt="研究提案"><br><sub><b>研究提案</b>：方案、备选和资源上限，确认一次即可开始</sub></td>
+<td width="33%"><!-- 占位：逐条审阅参考答案截图 docs/assets/review.png --><img src="docs/assets/review.png" alt="审阅参考答案"><br><sub><b>你来定标准</b>：主观判断的答案由你逐条审阅</sub></td>
+<td width="33%"><!-- 占位：验收窗口截图 docs/assets/acceptance.png --><img src="docs/assets/acceptance.png" alt="模型对比"><br><sub><b>亲手试</b>：输入你自己的例子，对比各模型的真实输出</sub></td>
+</tr>
+</table>
+
+## 为什么不一样
+
+- **Agent 是研究负责人，你是审核人。** 它调查方法、准备资源、跑实验；你只在关键判断上拍板。
+- **先评测，再下结论。** 先建立校准过的评测并测出基线，之后每一轮实验都和它比，不靠感觉。
+- **你的数据、你的标准、你的模型。** 小模型在自己电脑上跑，同样的需求，不同的人会得到不同的结果。
+- **诚实交付。** 只交付实际验证过的本地模型；达不到目标会直说原因，并给出下一步建议。
+
+## 它怎样运作
+
+```mermaid
+flowchart LR
+  P["🧑 你<br/>说需求 · 审核 · 试用"] <-->|对话| A["🤖 Agent<br/>研究负责人"]
+  A -->|写入| F[("研究文件")]
+  F -->|展示| W["🖥️ 研究工作台<br/>无限画布 + 浮窗"]
+  W -->|你的确认与审阅| F
+
+  subgraph Skills["四个 skills"]
+    direction LR
+    S1["tunetune-init<br/>调研 · 提案 · 资源计划"] --> S2["build-evaluation<br/>评测 · 基线"] --> S3["run-experiments<br/>有界实验 · 交付"]
+  end
+  A -.按阶段使用.-> Skills
+```
+
+`research-workspace` 把整个研究串起来：管理文件、恢复进度，并把工作分派到上面三个阶段。
+
+1. **提案**：Agent 先问清用途，再查当下可用的模型和方法，给出推荐路线、备选和资源上限（下载多大、花不花钱、数据出不出电脑）。你确认一次。
+2. **评测**：搭建能真正打分的评测，同时测出最便宜可信的基线。答案取决于你的主观判断时，冻结前请你审阅。
+3. **实验**：在预算内一轮轮实验，每轮说明测什么、为什么、和谁比。
+4. **交付**：选出实际验证过的本地模型。你可以在工作台里用自己的输入亲手试。
+
+环境、下载、缓存都放在研究目录里，不想要了，删掉目录即可。
+
+## 可以拿它做什么
+
+> 帮我做一个认出我家几只猫分别是谁的模型，照片在 `./photos`。
+
+> 帮我按我自己的习惯给支付宝账单分类，账单不要传到网上。
+
+> 帮我做一个判断哪些消息需要马上回复的模型，标准按我的来。
+
+> 帮我做一个能整理客户留言、分出问题类型的模型。
+
+<!-- 占位：更多真实案例与成果截图 -->
+
+<details>
+<summary><b>其他安装方式</b></summary>
+
+用 skills CLI 一次安装，所有目录可用，把 `--agent` 换成你的应用：
+
+```sh
+npx skills add nanshine/tunetune --global --agent codex
+npx skills add nanshine/tunetune --global --agent claude-code
+npx skills add nanshine/tunetune --global --agent cursor
+npx skills add nanshine/tunetune --global --agent opencode
+npx skills add nanshine/tunetune --global --agent trae      # Trae 国内版用 trae-cn
+npx skills add nanshine/tunetune --global --agent qoder     # Qoder 国内版用 qoder-cn
+```
+
+`--agent '*'` 会装到所有支持的应用；之后用 `npx skills update` 更新。没有 Node.js 时，把 `plugins/tunetune/skills/` 下的四个文件夹复制到应用的用户 skills 目录：
+
+| 应用 | 用户 skills 目录 |
+|---|---|
+| Claude Code | `~/.claude/skills/` |
+| Codex | `~/.agents/skills/` |
+| Cursor | `~/.cursor/skills/` |
+| OpenCode | `~/.config/opencode/skills/` |
+| Trae / Trae CN | `~/.trae/skills/` / `~/.trae-cn/skills/` |
+| Qoder / Qoder CN | `~/.qoder/skills/` / `~/.qoder-cn/skills/` |
+| 其他应用 | 查阅其 skills 文档；不少应用也读取 `~/.agents/skills/` |
+
+除 Claude Code 和 Codex 外，其他应用尚未逐一实测。
+
+插件方式：
+
+```text
+# Claude Code
+/plugin marketplace add nanshine/tunetune
+/plugin install tunetune@tunetune
+```
+
+```sh
+# Codex
+codex plugin marketplace add nanshine/tunetune
+codex plugin add tunetune@tunetune
+```
+
+装好后在想做研究的目录里说出需求即可。初始化只补齐缺失的文件，并把研究工具固定在 `.workspace/app/`，之后更新 skills 不会改动已有研究所用的工具；用其他版本工具创建的研究会被明确拒绝，不会自动迁移或覆盖。
+
+</details>
+
+<details>
+<summary><b>仓库结构</b></summary>
+
+| 路径 | 内容 |
+|---|---|
+| `plugins/tunetune/skills/` | 四个 skills：研究工作流、技术参考、研究工具、模板和构建好的面板，这就是全部分发内容 |
+| `plugins/tunetune/` | 插件根目录，只含 skills 和插件清单 |
+| `.claude-plugin/`、`.agents/plugins/` | 指向插件根目录的插件市场 |
+| `workspace/` | 面板源码（React / TypeScript） |
+| `scripts/` | 清单构建和本地演示工具 |
+| `tests/` | 集成与安全测试 |
+| `docs/` | [设计原则](docs/principles.md)等文档 |
+
+</details>
+
+<details>
+<summary><b>开发与本地演示</b></summary>
+
+需要 Node.js 22.12+ 和 Python 3.10+：
+
+```sh
+npm --prefix workspace ci
+npm --prefix workspace run build
+npm --prefix workspace test
+python3 -B -m unittest discover -s tests -v
+python3 scripts/build-skills.py
+```
+
+面板构建输出到 `plugins/tunetune/skills/research-workspace/assets/panel/`，并且需要提交，因为 `npx skills`、插件和克隆都直接取仓库里的 skills。修改分发的脚本、模板或面板后，重新运行 `build-skills.py`。
+
+用合成数据看一个完整的研究状态：
+
+```sh
+python3 plugins/tunetune/skills/research-workspace/scripts/init.py --project /absolute/my-research
+python3 scripts/create-demo.py --project /absolute/my-research
+python3 /absolute/my-research/.workspace/app/workspace.py --project /absolute/my-research --port 0 --open
+```
+
+演示证明流程能跑通，不代表真实业务的效果。
+
+</details>
+
+---
+
+<div align="center">
+<sub>设计理念见 <a href="docs/principles.md">docs/principles.md</a> · <!-- 占位：许可证 --> License TBD</sub>
+</div>

package/dsh/client.js

@@ -0,0 +1,116 @@
+// TuneTune for DeepSeek Harness: the browser half.
+//   - a left-sidebar entry whose main area lists every study and opens its panel full size
+//   - a right-sidebar tab, offered on the guide page, showing the study of that conversation
+// Both frame the Host's /tunetune/ui/ page; the research panel is the study's own pinned panel.
+window.__ModuleLoader__.load({
+  id: 'dsh-tunetune',
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+    const React = require('react');
+    const h = React.createElement;
+    const ID = 'dsh-tunetune';
+    const UI = '/tunetune/ui/';
+    const LABEL = { zh: 'TuneTune', en: 'TuneTune' };
+    const GUIDE = {
+      zh: '在对话旁边查看这个目录的模型研究：方案、评估、实验和验收。',
+      en: 'See this directory’s model research beside the conversation: proposal, evaluation, experiments and acceptance.',
+    };
+
+    // A dial with a small tuning mark.
+    function TuneIcon(props) {
+      const s = (props && props.size) || 18;
+      return h('svg', { width: s, height: s, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.6, strokeLinecap: 'round' },
+        h('circle', { cx: 12, cy: 12, r: 8 }),
+        h('path', { d: 'M12 12l4-4' }),
+        h('path', { d: 'M12 4v2M20 12h-2M12 20v-2M4 12h2' }));
+    }
+
+    function apply(ctx) {
+      const frames = new Set();
+      let scheme = null;
+      let lang = /^en\b/i.test(navigator.language) ? 'en' : 'zh';
+      const post = (frame) => {
+        const target = frame.contentWindow;
+        if (!target) return;
+        if (scheme) target.postMessage({ type: 'tunetune:scheme', scheme }, location.origin);
+        target.postMessage({ type: 'tunetune:locale', lang }, location.origin);
+      };
+      // Follow the harness's color scheme and language when those services exist.
+      ctx.inject(['theme'], (c) => {
+        const push = (snap) => { scheme = snap.active.colorScheme; frames.forEach(post); };
+        push(c.theme.getTheme());
+        c.on('theme/change', push);
+      });
+      ctx.inject(['locale'], (c) => {
+        const push = (snap) => { lang = /^en\b/i.test(snap.active) ? 'en' : 'zh'; frames.forEach(post); };
+        push(c.locale.getSnapshot());
+        c.on('locale/change', push);
+      });
+
+      function Frame(props) {
+        const ref = React.useRef(null);
+        const query = props.sessionId ? `?session=${encodeURIComponent(props.sessionId)}&lang=${lang}` : `?lang=${lang}`;
+        const [src] = React.useState(() => UI + query);
+        React.useEffect(() => {
+          const self = ref.current;
+          if (self) frames.add(self);
+          function onMessage(event) {
+            const frame = ref.current;
+            if (!frame || event.source !== frame.contentWindow || event.origin !== location.origin) return;
+            const message = event.data;
+            if (message && message.type === 'tunetune:open-session' && typeof message.sessionId === 'string') {
+              try {
+                ctx.uiWorkspace.openSession(message.sessionId);
+              } catch (error) {
+                console.error('[tunetune] could not open the conversation', error);
+              }
+            }
+          }
+          addEventListener('message', onMessage);
+          return () => { removeEventListener('message', onMessage); frames.delete(self); };
+        }, []);
+        return h('iframe', {
+          ref, src, title: LABEL[lang],
+          onLoad: (event) => post(event.currentTarget),
+          style: { width: '100%', height: '100%', border: 0, display: 'block' },
+        });
+      }
+
+      function StudiesPanel() {
+        return h(Frame, {});
+      }
+
+      // The tab body receives the conversation it belongs to.
+      function StudyTab(props) {
+        return h(Frame, { sessionId: props.sessionId });
+      }
+
+      ctx.slots.inject('sidebar.panellist', () =>
+        ctx.slots.register({ name: 'sidebar.panellist', id: ID, order: 7, label: () => LABEL[lang] }, TuneIcon));
+      ctx.slots.inject('main', () => ctx.slots.register({ name: 'main', key: ID }, StudiesPanel));
+
+      // The right sidebar is optional in a composition; without it the main entry still works.
+      ctx.inject(['sidebarRightTabs'], (c) => {
+        const disposers = [];
+        disposers.push(c.sidebarRightTabs.register({
+          id: ID,
+          kind: ID,
+          title: () => LABEL[lang],
+          keepMounted: true,
+          guide: [{ id: ID, order: 30, title: () => LABEL[lang], description: () => GUIDE[lang], icon: TuneIcon }],
+        }));
+        disposers.push(c.slots.inject('sidebar.right.pane.tab', () =>
+          c.slots.register({ name: 'sidebar.right.pane.tab', key: ID }, StudyTab)));
+        return () => { for (const dispose of disposers) if (typeof dispose === 'function') dispose(); };
+      });
+    }
+
+    exports.isPlugin = true;
+    exports.inject = ['slots', 'uiWorkspace'];
+    exports.apply = apply;
+    return module.exports;
+  },
+});

package/dsh/cordis.patch.yml

@@ -0,0 +1,5 @@
+# TuneTune bundle layer: this row loads the package's main entry (dsh/host.js) as the Host half;
+# package.json's dsh.client declaration makes the Web client load ./client as the browser half.
+- insert:
+    - id: tunetune
+      name: 'dsh-tunetune'