@ahggg/dsh-side-chat 0.7.3 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # dsh-side-chat
 
-Ask a focused follow-up about selected text without leaving your current DeepSeek Harness conversation.
+Ask a focused follow-up about selected text without leaving your current conversation in **DeepSeek Harness Desktop or Web**.
 
 [简体中文](README.zh-CN.md)
 
@@ -8,12 +8,28 @@ Ask a focused follow-up about selected text without leaving your current DeepSee
 
 ## Install
 
-Install DSH 0.1.2-rc.1 if it is not already available. Refresh only this package's registry metadata before adding it, so pnpm cannot reuse an older `latest` value immediately after a release:
+Use these exact versions together:
+
+- **Side Chat:** `@ahggg/dsh-side-chat@1.0.0`
+- **DeepSeek Harness runtime:** `0.2.0-rc.1`
+
+### DeepSeek Harness Desktop
+
+Side Chat supports the Desktop app. In its plugin installation dialog, enter the complete package spec:
+
+```text
+@ahggg/dsh-side-chat@1.0.0
+```
+
+Install it, then restart DeepSeek Harness Desktop. Use the Desktop app's plugin manager for Desktop installations; the CLI commands below target the Web profile.
+
+### Web (`dsh web`)
+
+Install the matching DSH CLI if needed, then install the pinned plugin version:
 
 ```powershell
-npm install --global @deepseek-ai/dsh@0.1.2-rc.1
-pnpm cache delete "@ahggg/dsh-side-chat"
-dsh plugin --profile web add @ahggg/dsh-side-chat@latest
+npm install --global @deepseek-ai/dsh@0.2.0-rc.1
+dsh plugin --profile web add @ahggg/dsh-side-chat@1.0.0 --save-exact
 ```
 
 Start DSH from the project you want the agent to work in:
@@ -43,48 +59,64 @@ On phones and tablets, long-press text in a completed message to select it. The
 3. Click `Add to chat` to add an optional comment before attaching the passage to the main composer, `More details` to send an explanation request immediately, or `Ask in side chat` to write a focused question.
 4. When writing your own message or question, press `Enter` to send it.
 5. After a Side Chat reply settles, click `Add to conversation` to attach that focused discussion to the main composer as one conversation reference.
-6. Press `Esc` or click `×` when you are done.
+6. Click `×`, or press `Esc` while focused inside the Side Chat panel, when you are done. Escape in another composer or menu does not close Side Chat.
 
 Useful details:
 
 - `Shift+Enter` inserts a newline.
-- Use the model control beside Send to choose a provider/model and its available reasoning effort. The choice belongs to Side Chat, does not change the main conversation, and becomes the global default for the next Side Chat.
+- Use the model control beside Send, then **Effort**, to choose the model's thinking level. You can change it while a reply runs: that reply keeps its original settings, while the accepted choice applies to the next reply and is remembered for future **Ask in side chat** and **More details** requests in this client. It does not change the main conversation.
 - After clicking `Add to chat`, press `Enter` or click `Save` to keep the annotation. Click outside the comment box or click `Cancel` to discard it.
 - `Add to chat` keeps any existing draft text and can collect multiple numbered passages, each with its own optional comment, in one annotation capsule.
 - `Add to conversation` captures the Side Chat's user/assistant history, preserves the main draft, and refreshes the existing reference instead of duplicating it when clicked again.
 - The input grows with its content and becomes scrollable at its maximum height.
-- While a reply is running, the send icon becomes a stop button.
+- The composer has one action button: **Send** when idle, **Stop** while generating. It returns to Send after the reply finishes or stops, keeping any follow-up draft. Text entered while a send is pending stays in the composer.
 - Assistant replies use DSH's native Markdown rendering.
 - Hover over `N annotations` to preview every selected passage and its comment.
 - Before sending, hover over the annotation capsule and click `×` to remove it; after sending, the same capsule appears above the user message.
-- The main conversation stays visible and is never switched to the child Session.
+- Your first Side Chat message displays the selected passage as one annotation and your question as plain text, not internal XML.
+- The main conversation stays visible. No child Session is created.
 
 ## What happens to the conversation
 
-The first send creates a real DSH Session fork at the selected message. The child inherits the complete event prefix, presets, and workspace. Its initial model choice uses the last accepted Side Chat choice when one is saved, otherwise it snapshots the parent configuration; later model or reasoning-effort changes apply to subsequent child steps without changing or following the parent conversation. Keeping the prefix unchanged is friendly to provider prompt caching, although a cache hit is never guaranteed.
+`Ask in side chat` and `More details` use direct, streaming model calls through DSH's configured provider. On the first send, the plugin captures a **read-only text snapshot** of the parent conversation through the selected message's completed turn. Later parent prompts are excluded, and this context stays fixed for follow-ups. Opening the draft alone makes no model call.
 
-Closing Side Chat stops active work, archives the child Session, and releases its Agent. It does not delete the child's history from disk. The child and copied prefix therefore consume normal DSH Session storage.
+Side Chat keeps its own temporary message history in memory. It does **not** fork, copy, create, or archive a DSH Session, run an Agent, or write a Session event log. It has **no tools, command execution, or file-editing capability**. Parent reasoning and image/file attachment bytes are omitted; historical tool text is only reference material. The initial model uses the saved Side Chat choice, or the selected parent turn's configuration. Changing it affects only subsequent Side Chat replies.
 
-The parent and child share the same workspace. File changes, commands, and other tool side effects made in Side Chat are real and are not reverted when the panel closes.
+Closing the panel, reloading/disconnecting the client, or unloading the plugin cancels active work and discards the temporary discussion. Host records also expire after 30 minutes idle. To keep a discussion, use **Add to conversation**, then **send the parent draft** to store the reference in the parent history. Adding a reference alone does not send it. References already added to the parent draft are separate from the temporary panel and survive its closure.
+
+The text snapshot and Side Chat history are sent to the model on each request, so normal provider token usage still applies; avoiding Session copies does not eliminate context tokens or guarantee cache reuse. Archived Sessions created by older plugin versions are not automatically deleted.
 
 ## Current limitations
 
 - A selection must stay inside one completed message.
-- Attachments and `/side` are not supported yet.
-- Closed Side Chats cannot be reopened from the panel.
-- There is no automatic history cleanup or “keep as normal chat” action.
-- An archived child may briefly appear in normal Session lists.
+- This is a text-only, read-only discussion, not a second Agent. Attachments, tools, Steer, and `/side` are not supported.
+- Closed or expired discussions cannot be reopened. There is no “keep as normal Session” action.
+- Context is limited to 2,097,152 characters and rejected rather than silently truncated. Each question is limited to 65,536 characters; each reply (including reasoning) to 262,144 characters. A discussion permits at most 64 questions and 2,097,152 question/reply/reasoning characters. Output limits produce an explicit error and keep only the displayed partial reply.
+- Model requests time out after two minutes. Provider-specific context/output limits may be lower.
 
 ## Upgrade or remove
 
-Refresh this package's registry metadata, update to the latest stable version, and restart DSH:
+### Desktop
+
+In the Desktop app's plugin manager, update or reinstall using this exact package spec, then restart the app:
+
+```text
+@ahggg/dsh-side-chat@1.0.0
+```
+
+If Desktop still reports `@ahggg/dsh-side-chat@0.7.3`, it is loading the old plugin, which does not support DSH `0.2.0-rc.1`. A working `dsh web` installation does not mean Desktop has been updated. Update the Desktop installation rather than bypassing DSH's compatibility check.
+
+To uninstall, remove Side Chat through the Desktop app's plugin manager.
+
+### Web
+
+To upgrade an existing Web installation to `1.0.0`, re-add the exact version. `add --save-exact` replaces the installed package version and keeps the dependency pinned:
 
 ```powershell
-pnpm cache delete "@ahggg/dsh-side-chat"
-dsh plugin --profile web update @ahggg/dsh-side-chat --latest
+dsh plugin --profile web add @ahggg/dsh-side-chat@1.0.0 --save-exact
 ```
 
-Remove the plugin with:
+Restart `dsh web` and reload the browser after updating. Remove the Web-profile plugin with:
 
 ```powershell
 dsh plugin --profile web remove @ahggg/dsh-side-chat

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # dsh-side-chat
 
-在不离开当前 DeepSeek Harness 主会话的情况下，针对选中的文本发起一个独立的侧边对话。
+在不离开当前 DeepSeek Harness 主会话的情况下，针对选中的文本发起聚焦讨论。支持 **DeepSeek Harness 桌面端和 Web 端**。
 
 [English](README.md)
 
@@ -8,12 +8,28 @@
 
 ## 安装
 
-如果尚未安装 DSH 0.1.2-rc.1，先安装它。添加插件前只刷新这个包的 registry metadata，避免刚发布新版本时 pnpm 仍复用旧的 `latest`：
+请配合使用以下确切版本：
+
+- **Side Chat：** `@ahggg/dsh-side-chat@1.0.0`
+- **DeepSeek Harness 运行时：** `0.2.0-rc.1`
+
+### DeepSeek Harness 桌面端
+
+Side Chat 现已支持桌面应用。在桌面端的插件安装对话框中，输入完整的包名和版本：
+
+```text
+@ahggg/dsh-side-chat@1.0.0
+```
+
+安装后重启 DeepSeek Harness 桌面应用。桌面端请使用应用内的插件管理功能；下方 CLI 命令仅针对 Web profile。
+
+### Web 端（`dsh web`）
+
+如有需要，先安装匹配版本的 DSH CLI，再安装并固定插件版本：
 
 ```powershell
-npm install --global @deepseek-ai/dsh@0.1.2-rc.1
-pnpm cache delete "@ahggg/dsh-side-chat"
-dsh plugin --profile web add @ahggg/dsh-side-chat@latest
+npm install --global @deepseek-ai/dsh@0.2.0-rc.1
+dsh plugin --profile web add @ahggg/dsh-side-chat@1.0.0 --save-exact
 ```
 
 从希望 Agent 操作的真实工程目录启动 DSH：
@@ -43,48 +59,64 @@ pnpm build
 3. 点击 `Add to chat` 可以先填写一条可选批注，再把引用加入主会话输入框；点击 `More details` 可以立即发送详细解释请求；点击 `Ask in side chat` 可以自己输入聚焦问题。
 4. 自己输入消息或问题时，按 `Enter` 发送。
 5. Side Chat 回复完成后，点击 `Add to conversation`，即可把这段聚焦讨论作为一个会话引用加入主会话输入框。
-6. 完成后按 `Esc`，或者点击 `×` 关闭。
+6. 完成后点击 `×` 关闭，或者在 Side Chat 面板内聚焦时按 `Esc`。在其他输入框或菜单中按 Escape 不会关闭 Side Chat。
 
 常用操作：
 
 - `Shift+Enter` 换行。
-- 使用发送按钮旁的模型控件可以选择 provider/model 及其可用的推理等级；该选择只属于 Side Chat，不会修改主会话，并会成为下次打开 Side Chat 时使用的全局默认值。
+- 点击发送按钮旁的模型控件，再选择 **Effort（推理等级）**，即可调整模型的思考等级。回复生成期间也可以修改：当前回复仍使用原设置，新选择会用于下一次回复，并记住为当前客户端之后 **Ask in side chat** 和 **More details** 请求的默认设置，不会修改主会话。
 - 点击 `Add to chat` 后，按 `Enter` 或点击 `Save` 保存 annotation；点击批注框外部或点击 `Cancel` 则直接取消。
 - `Add to chat` 会保留输入框中已有的草稿，并可把多段带序号的文本及各自的可选批注汇总到同一个 annotation 胶囊中。
 - `Add to conversation` 会捕获 Side Chat 中的用户/助手历史、保留主会话草稿；再次点击时会刷新已有引用，而不是重复添加。
 - 输入框会随内容自动增高，达到最大高度后在内部滚动。
-- 回复生成期间，发送图标会替换为停止按钮。
+- 输入框只保留一个操作按钮：空闲时为 **Send（发送）**，生成期间切换为 **Stop（停止）**。回复结束或停止后恢复为发送按钮，并保留追问草稿。等待发送结果时新输入的文字也会保留。
 - Assistant 回复使用 DSH 原生 Markdown 渲染。
 - hover `N annotations` 可以预览每一段所选文本及对应批注。
 - 发送前可以 hover annotation 胶囊并点击 `×` 移除；发送后，同一个胶囊会显示在用户消息上方。
-- 主会话会一直保留在页面中，不会自动切换到 child Session。
+- Side Chat 的首条消息会把选区显示为一个 annotation，问题正文保持纯文本，不显示内部 XML。
+- 主会话会一直保留在页面中，插件不会创建 child Session。
 
 ## 会话和数据如何处理
 
-第一次发送时，插件会在所选消息处创建一个真实的 DSH Session fork。child 会继承完整事件前缀、preset 和 workspace；初始模型优先使用最近一次被接受的 Side Chat 选择，没有已保存选择时才快照主会话配置。之后修改模型或推理等级只会作用于 child 的后续 step，既不会修改主会话，也不会继续跟随主会话切换。保持前缀不变有利于供应商的 prompt cache 复用，但不保证一定命中缓存。
+`Ask in side chat` 和 `More details` 直接通过 DSH 配置的 provider 发起流式模型调用。第一次发送时，插件读取主会话截至所选消息所在轮次结束的**只读文本快照**，不包含后续主会话问题。此后追问一直使用这份固定上下文。仅打开草稿不会调用模型。
 
-关闭 Side Chat 时，插件会停止正在运行的任务、归档 child Session，并释放其 Agent；不会删除 child 的磁盘历史。因此，child 和复制的完整前缀会占用正常的 DSH Session 存储空间。
+Side Chat 只在内存中保留独立的临时讨论历史，**不会 fork、复制、创建或归档 DSH Session，也不会启动 Agent 或写入 Session 事件日志**。它**没有工具调用、命令执行和文件修改能力**。主会话的推理内容以及图片、文件附件的字节不会传入；过去的工具文本仅作为参考资料。初始模型优先使用已保存的 Side Chat 选择，否则使用所选父会话轮次的配置；之后切换模型只影响 Side Chat 的后续回复。
 
-父会话与 child 共享同一个 workspace。Side Chat 中产生的文件修改、命令执行及其他工具副作用都是真实的，关闭面板不会撤销它们。
+关闭面板、刷新或断开客户端、卸载插件时，会取消正在运行的请求并丢弃临时讨论。Host 记录闲置 30 分钟后也会过期。如果希望保留讨论，请点击 **Add to conversation**，然后**发送主会话草稿**，将引用存入主会话历史。只添加引用不会自动发送；已经添加到主会话草稿的引用独立于临时面板，不会随面板关闭而删除。
+
+每次调用模型仍会发送文本快照和 Side Chat 历史，因此仍产生正常的 provider token 用量；不复制 Session 不代表不消耗上下文 token，也不保证缓存复用。旧版插件创建的归档 Session 不会自动删除。
 
 ## 当前限制
 
 - 选区必须位于同一条已完成消息内。
-- 暂不支持附件和 `/side`。
-- 关闭后不能从面板重新打开原 Side Chat。
-- 暂无自动历史清理或“保留为普通会话”操作。
-- 已归档的 child 可能短暂出现在普通会话列表中。
+- 这是纯文本只读讨论，不是另一个 Agent；不支持附件、工具、Steer 和 `/side`。
+- 关闭或过期后不能重新打开，也没有“保留为普通 Session”操作。
+- 父上下文上限为 2,097,152 个字符，超过时明确拒绝而不会静默截断。每条问题上限为 65,536 个字符，每次回复（含推理）上限为 262,144 个字符；每次讨论最多 64 条问题，问题、回复和推理合计最多 2,097,152 个字符。达到输出上限会明确报错，仅保留已经显示的部分回复。
+- 单次模型请求两分钟后超时；provider 自身的上下文或输出限制可能更低。
 
 ## 升级或卸载
 
-刷新这个包的 registry metadata，升级到最新稳定版，然后重启 DSH：
+### 桌面端
+
+在桌面应用的插件管理功能中，使用以下确切包版本进行更新或重新安装，然后重启应用：
+
+```text
+@ahggg/dsh-side-chat@1.0.0
+```
+
+如果桌面端仍提示 `@ahggg/dsh-side-chat@0.7.3`，说明它还在加载旧插件，该版本不支持 DSH `0.2.0-rc.1`。`dsh web` 可以正常使用，并不代表桌面端也已更新。请更新桌面端的插件安装，不要绕过 DSH 的兼容性检查。
+
+卸载时，在桌面应用的插件管理功能中移除 Side Chat 即可。
+
+### Web 端
+
+要将已有的 Web 安装升级到 `1.0.0`，请重新添加这个确切版本。`add --save-exact` 会替换已安装的包版本，并将依赖固定到该版本：
 
 ```powershell
-pnpm cache delete "@ahggg/dsh-side-chat"
-dsh plugin --profile web update @ahggg/dsh-side-chat --latest
+dsh plugin --profile web add @ahggg/dsh-side-chat@1.0.0 --save-exact
 ```
 
-卸载插件：
+更新后重启 `dsh web` 并刷新浏览器。卸载 Web profile 中的插件：
 
 ```powershell
 dsh plugin --profile web remove @ahggg/dsh-side-chat

package/lib/client/apply.js

@@ -4,40 +4,56 @@ import { selectionReferenceSource } from './parent-composer/add-to-conversation.
 import { mountParentConversationAnnotations } from './parent-composer/ParentConversationAnnotations.js';
 import { sideChatConversationReferenceSource } from './parent-composer/referenced-conversation.js';
 import { SideChatController } from './side-chat-controller.js';
-import { mountArchivedRemote } from './rc6/remote-adapter.js';
-import { Rc6SideChatOverlay } from './rc6/Rc6SideChatOverlay.js';
-import { Rc6SideChatSessions } from './rc6/sessions-adapter.js';
+import { mountSideChatRemote } from './dsh/remote-adapter.js';
+import { SideChatOverlay } from './dsh/SideChatOverlay.js';
+import { DshSideChatSessions } from './dsh/sessions-adapter.js';
 export const name = 'side-chat-client';
-export const inject = ['conversation', 'inputTriggers', 'modelDirectories', 'remote', 'sessions', 'slots'];
+export const inject = ['conversation', 'inputTriggers', 'modelDirectories', 'remote', 'sessions', 'slots', 'uiConversation', 'uiWorkspace'];
 export async function apply(ctx) {
-    const stylesheet = document.createElement('style');
-    stylesheet.textContent = sideChatCss;
-    stylesheet.dataset.plugin = 'dsh-side-chat';
-    stylesheet.dataset['dshSideChat'] = 'styles';
-    document.head.append(stylesheet);
-    const clientCtx = ctx;
-    const mounted = await mountArchivedRemote(clientCtx);
-    const removeSelectionReferenceSource = clientCtx.inputTriggers.registerSource(selectionReferenceSource);
-    const removeConversationReferenceSource = clientCtx.inputTriggers.registerSource(sideChatConversationReferenceSource);
-    const sessions = new Rc6SideChatSessions(clientCtx);
-    const removeParentAnnotations = mountParentConversationAnnotations(clientCtx, () => { sessions.removeConversationAnnotations(); });
-    const controller = new SideChatController(mounted.remote, sessions);
-    const removeOverlay = clientCtx.slots.inject('shell.overlay', () => clientCtx.slots.register({
-        name: 'shell.overlay',
-        id: 'dsh-side-chat',
-        order: 90,
-    }, () => createElement(Rc6SideChatOverlay, { controller, sessions })));
-    ctx.effect(() => async () => {
-        try {
-            await controller.dispose();
-        }
-        finally {
-            removeParentAnnotations();
-            removeConversationReferenceSource();
-            removeSelectionReferenceSource();
-            removeOverlay();
+    const cleanups = [];
+    let disposed = false;
+    let cleanupOperation;
+    const cleanup = () => {
+        disposed = true;
+        cleanupOperation ??= (async () => {
+            for (const dispose of cleanups.splice(0).reverse()) {
+                try {
+                    await dispose();
+                }
+                catch (error) {
+                    console.warn('[dsh-side-chat] Cleanup failed', error);
+                }
+            }
+        })();
+        return cleanupOperation;
+    };
+    ctx.effect(() => cleanup, 'dsh-side-chat.clientLifecycle');
+    try {
+        const stylesheet = document.createElement('style');
+        stylesheet.textContent = sideChatCss;
+        stylesheet.dataset.plugin = 'dsh-side-chat';
+        stylesheet.dataset['dshSideChat'] = 'styles';
+        document.head.append(stylesheet);
+        cleanups.push(() => { stylesheet.remove(); });
+        const clientCtx = ctx;
+        const mounted = await mountSideChatRemote(clientCtx);
+        if (disposed) {
             await mounted.dispose();
-            stylesheet.remove();
+            return;
         }
-    }, 'dsh-side-chat.clientLifecycle');
+        cleanups.push(mounted.dispose);
+        cleanups.push(clientCtx.inputTriggers.registerSource(selectionReferenceSource));
+        cleanups.push(clientCtx.inputTriggers.registerSource(sideChatConversationReferenceSource));
+        const sessions = new DshSideChatSessions(clientCtx);
+        cleanups.push(mountParentConversationAnnotations(clientCtx, sessionId => { sessions.removeConversationAnnotations(sessionId); }));
+        const controller = new SideChatController(mounted.remote, sessions);
+        cleanups.push(() => controller.dispose());
+        cleanups.push(clientCtx.slots.inject('shell.overlay', () => clientCtx.slots.register({
+            name: 'shell.overlay', id: 'dsh-side-chat', order: 90,
+        }, () => createElement(SideChatOverlay, { controller, sessions }))));
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
 }

package/lib/client/contracts.d.ts

@@ -1,67 +1,12 @@
-import type { ConversationSelection, SessionId, SideChatModelSelection, SideChatPromptPart, SideChatWireError } from '../shared/contracts.js';
-import type { HostObservable } from '../shared/observable.js';
-export interface SideChatSessionSnapshot {
-    readonly status: 'idle' | 'running' | 'needs-input' | 'needs-approval' | 'failed' | 'interrupted';
-}
-export interface SideChatQuestionAnswer {
-    readonly answers: readonly {
-        readonly id: string;
-        readonly selected: readonly string[];
-        readonly custom?: string;
-    }[];
-}
-export interface SideChatSessionBinding extends HostObservable<SideChatSessionSnapshot> {
-    readonly sessionId: SessionId;
-    prompt(content: readonly SideChatPromptPart[], mode: 'queue' | 'steer'): Promise<{
-        readonly ok: true;
-    } | {
-        readonly ok: false;
-        readonly error: SideChatWireError;
-    }>;
-    updateQueue(itemId: string, action: {
-        readonly kind: 'edit';
-        readonly content: readonly SideChatPromptPart[];
-    } | {
-        readonly kind: 'remove';
-    } | {
-        readonly kind: 'steer';
-    }): Promise<{
-        readonly ok: true;
-    } | {
-        readonly ok: false;
-        readonly error: SideChatWireError;
-    }>;
-    cancel(): Promise<{
-        readonly ok: true;
-    } | {
-        readonly ok: false;
-        readonly error: SideChatWireError;
-    }>;
-    respondApproval(interactionId: string, decision: 'approve' | 'decline'): Promise<{
-        readonly ok: true;
-    } | {
-        readonly ok: false;
-        readonly error: SideChatWireError;
-    }>;
-    respondQuestion(interactionId: string, answer: SideChatQuestionAnswer | null): Promise<{
-        readonly ok: true;
-    } | {
-        readonly ok: false;
-        readonly error: SideChatWireError;
-    }>;
-}
-export interface SideChatSessionLease {
-    readonly sessionId: SessionId;
-    readonly binding: SideChatSessionBinding;
-    release(): void;
-}
+import type { ConversationSelection, SessionId, SideChatModelSelection, SideChatWireError } from '../shared/contracts.js';
+/** Parent-only DSH integration. Side discussions never retain a child Session. */
 export interface SideChatClientSessions {
     currentSessionId(): SessionId | undefined;
     lastCompletedSeq(parentSessionId: SessionId): number | undefined;
     selectionIsCurrent(selection: ConversationSelection): boolean;
     sideChatModelPreference(): SideChatModelSelection | undefined;
     rememberSideChatModelPreference(selection: SideChatModelSelection): void;
-    retain(sessionId: SessionId): Promise<SideChatSessionLease>;
+    retainParent(sessionId: SessionId): () => void;
     openSession(sessionId: SessionId): Promise<void>;
     notify(message: {
         readonly kind: 'status' | 'warning';

package/lib/client/dsh/ReadOnlyConversation.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+import type { SideChatState } from '../../shared/contracts.js';
+import type { SideChatController } from '../side-chat-controller.js';
+/** The UI renders structured plugin messages, never model-facing prompt serialization. */
+export declare function ReadOnlyConversation({ state, controller, modelControl, locale }: {
+    readonly state: SideChatState;
+    readonly controller: SideChatController;
+    readonly modelControl?: ReactNode;
+    readonly locale?: 'en' | 'zh-CN';
+}): import("react/jsx-runtime").JSX.Element;

package/lib/client/dsh/ReadOnlyConversation.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { DisclosureRow, IconThinkOutlineRegular, MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives';
+import { SelectionQuote } from '../panel/SelectionQuote.js';
+import { SIDE_CHAT_MESSAGES } from '../panel/messages.js';
+import { SendIcon } from '../panel/SendIcon.js';
+import { StopIcon } from '../panel/StopIcon.js';
+import { useAutoGrowingTextarea } from '../panel/use-auto-growing-textarea.js';
+import { MARKDOWN_LABELS } from './primitive-labels.js';
+function Reasoning({ text, running }) {
+    const [expanded, setExpanded] = useState(false);
+    const lines = text.trimEnd().split('\n');
+    return _jsx("div", { className: "dsh-side-chat-reasoning", "data-variant": "think", "data-state": running ? 'running' : 'ok', children: _jsx(DisclosureRow, { rowClassName: "dsh-side-chat-reasoning-row", leadingClassName: "dsh-side-chat-reasoning-leading", titleClassName: "dsh-side-chat-reasoning-title", chevronClassName: "dsh-side-chat-reasoning-chevron", icon: _jsx(IconThinkOutlineRegular, { size: 14 }), title: "Think", open: expanded, expandable: true, expandOnRowClick: true, onToggle: () => { setExpanded(value => !value); }, collapsedContent: _jsx("span", { className: "dsh-side-chat-reasoning-summary", children: running ? lines.at(-1) : lines[0] }), children: _jsx("div", { className: "dsh-side-chat-reasoning-body", children: text }) }) });
+}
+function Message({ message, locale }) {
+    const bubble = _jsxs("article", { className: "dsh-side-chat-message", "data-role": message.role, children: [_jsx("span", { className: "dsh-side-chat-message-role", children: message.role === 'user' ? 'You' : 'Assistant' }), message.role === 'user'
+                ? _jsx("div", { className: "dsh-side-chat-message-text", children: message.text })
+                : _jsxs(_Fragment, { children: [message.reasoning && _jsx(Reasoning, { text: message.reasoning, running: message.status === 'streaming' }), _jsx(MarkdownText, { text: message.text, streaming: message.status === 'streaming', labels: MARKDOWN_LABELS }), message.status === 'streaming' && message.text === '' && !message.reasoning && _jsx("span", { children: "Thinking\u2026" }), message.status === 'stopped' && _jsx("span", { className: "dsh-side-chat-message-note", children: "Stopped" }), message.status === 'error' && _jsx("span", { className: "dsh-side-chat-message-note", children: "Reply failed" })] })] });
+    return message.selectedText === undefined ? bubble : _jsxs("div", { className: "dsh-side-chat-annotated-user-message", children: [_jsx(SelectionQuote, { selections: [{ text: message.selectedText }], messages: SIDE_CHAT_MESSAGES[locale] }), bubble] });
+}
+/** The UI renders structured plugin messages, never model-facing prompt serialization. */
+export function ReadOnlyConversation({ state, controller, modelControl, locale = 'en' }) {
+    const [draft, setDraft] = useState('');
+    const [sending, setSending] = useState(false);
+    const [stopping, setStopping] = useState(false);
+    const [actionError, setActionError] = useState();
+    const sendingRef = useRef(false);
+    const stoppingRef = useRef(false);
+    const revision = useRef(0);
+    const follow = useRef(true);
+    const scrollRef = useRef(null);
+    const inputRef = useAutoGrowingTextarea(draft);
+    const running = state.phase === 'running';
+    const showStop = running || stopping;
+    const interactive = ['ready', 'running'].includes(state.phase);
+    useEffect(() => {
+        const element = scrollRef.current;
+        if (element !== null && follow.current)
+            element.scrollTop = element.scrollHeight;
+    }, [state.messages]);
+    const submit = async (event) => {
+        event.preventDefault();
+        if (draft.trim().length === 0 || !interactive || running || sendingRef.current || stoppingRef.current)
+            return;
+        const before = revision.current;
+        sendingRef.current = true;
+        setSending(true);
+        setActionError(undefined);
+        try {
+            const result = await controller.send(draft);
+            if (result.ok && before === revision.current)
+                setDraft('');
+            else if (!result.ok && controller.getSnapshot().error?.message !== result.error.message)
+                setActionError(result.error.message);
+        }
+        catch {
+            setActionError('The message could not be sent. Your draft has been kept.');
+        }
+        finally {
+            sendingRef.current = false;
+            setSending(false);
+        }
+    };
+    const stop = async () => {
+        if (stoppingRef.current)
+            return;
+        stoppingRef.current = true;
+        setStopping(true);
+        setActionError(undefined);
+        try {
+            const result = await controller.cancel();
+            if (!result.ok)
+                setActionError(result.error.message);
+        }
+        catch {
+            setActionError('The request could not be stopped. Try closing Side Chat.');
+        }
+        finally {
+            stoppingRef.current = false;
+            setStopping(false);
+        }
+    };
+    return _jsxs("div", { className: "dsh-side-chat-conversation", children: [_jsxs("div", { ref: scrollRef, className: "dsh-side-chat-transcript", "aria-live": "polite", onScroll: event => {
+                    const element = event.currentTarget;
+                    follow.current = element.scrollHeight - element.scrollTop - element.clientHeight < 48;
+                }, children: [state.messages.map(message => _jsx(Message, { message: message, locale: locale }, message.id)), actionError !== undefined && _jsx("div", { className: "dsh-side-chat-turn-notice", role: "alert", children: actionError })] }), _jsxs("form", { className: "dsh-side-chat-composer", "data-composer-card": "", onSubmit: event => { void submit(event); }, children: [_jsx("textarea", { ref: inputRef, rows: 1, value: draft, disabled: !interactive, placeholder: "Reply in Side Chat", onChange: event => { ++revision.current; setDraft(event.target.value); }, onKeyDown: event => {
+                            if (event.key === 'Enter' && !event.shiftKey && !event.nativeEvent.isComposing && event.keyCode !== 229) {
+                                event.preventDefault();
+                                event.currentTarget.form?.requestSubmit();
+                            }
+                        } }), _jsxs("div", { className: "dsh-side-chat-composer-actions", children: [modelControl, _jsx("button", { type: showStop ? 'button' : 'submit', className: showStop ? 'dsh-side-chat-stop-button' : 'dsh-side-chat-send-button', "aria-label": showStop ? 'Stop generating' : 'Send', "aria-busy": stopping || sending || undefined, disabled: !interactive || (showStop ? stopping : sending || draft.trim().length === 0), onClick: event => {
+                                    if (!showStop)
+                                        return;
+                                    // Do not submit a retained draft if cancellation changes the button
+                                    // back to Send before this click's default action completes.
+                                    event.preventDefault();
+                                    void stop();
+                                }, children: showStop ? _jsx(StopIcon, {}) : _jsx(SendIcon, {}) })] })] })] });
+}

package/lib/client/dsh/SideChatOverlay.d.ts

@@ -0,0 +1,7 @@
+import type { SideChatController } from '../side-chat-controller.js';
+import { DshSideChatSessions } from './sessions-adapter.js';
+/** Selection toolbar and plugin-owned read-only discussion panel. */
+export declare function SideChatOverlay({ controller, sessions, }: {
+    readonly controller: SideChatController;
+    readonly sessions: DshSideChatSessions;
+}): import("react/jsx-runtime").JSX.Element;