@langify-org/dsh-side-chat 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 langify-org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,42 @@
+# @langify-org/dsh-side-chat
+
+[English](README.md) | 日本語 | [中文](README.zh.md)
+
+DeepSeek Harness の会話を止めずに、その会話について横で質問できます。サイドチャットは会話を fork したもので、右サイドバーに DSH 自身のチャットと入力欄で開き、サイドチャットであることがモデルに伝えられます。
+
+## 必要なもの
+
+- Web UI のある DSH `>=0.2.1-rc.5 <0.3.0-0`。
+
+## 導入
+
+```sh
+dsh plugin --profile <profile> add @langify-org/dsh-side-chat
+```
+
+DSH の Web 版や Desktop 版では **Plugins** ページから追加できます。
+
+## 使い方
+
+assistant のメッセージの下にあるボタンの列でサイドチャットのボタンを押すか、右サイドバーのガイドで **サイドチャット** を押します。会話が fork されて `サイドチャット: <会話のタイトル>` という名前が付き、右サイドバーに開くので、普通の会話と同じように話せます。セッション一覧でサイドチャットを選ぶと、元の会話が開き、その横にサイドチャットが開きます。
+
+- サイドチャットは、どのメッセージで押しても、会話の最後に終わった turn から始まります。メインの会話のその後の turn は届かず、サイドチャットの内容もメインの会話には届きません。
+- モデルに、サイドチャットであること、メインの作業を再開せず質問に答えること、サイドチャットで頼まれない限り変更を加えないことを伝えます。この指示はチャットには表示されません。
+
+## 仕組み
+
+ホスト側のプラグインは、DSH の session controller でセッションを fork します（**Fork** の操作と同じ fork です）。そのすぐあとに、サイドチャットの指示を `agent.inject` で fork の inbox に入れます。指示は最初のメッセージと一緒にモデルに届きます。inbox は変わった時点でログに書かれるので、fork は作った瞬間からサイドチャットとして印が付き、再起動しても残ります。セッションの projection `langifySideChat` が、fork 自身のログからこの印を読み取り、セッション一覧を通してどのブラウザーにも届けます。ブラウザー側は、fork を自前の右サイドバーのタブで開きます。タブの中身は DSH 共通の `conversation.content` を Chat 表示で描いたもので、DSH の subagent のタブと同じ埋め込み方です。fork は普通のセッションなので、メッセージは普通の送信の経路で届きます。
+
+## 既知の制約
+
+- **サイドバーに並ぶ**：サイドチャットは普通のセッションなので、セッション一覧に出ます。使い終わったらアーカイブしてください。
+- **最新の turn からだけ**：サイドチャットは最後に終わった turn から始まります。前のメッセージから始めることは、まだできません。
+
+## ブラウザーでの確認
+
+リポジトリのルートで `pnpm dev` を実行し、終わった turn が 1 つ以上ある会話で次を確かめます。
+
+1. assistant のメッセージの下にあるサイドチャットのボタンを押す。右サイドバーに、空の入力欄のある **サイドチャット** のタブが開く。
+2. 会話についての質問を送る。会話の内容を踏まえて答える。
+3. メインの会話に何も増えていない。
+4. サイドチャットの指示がサイドチャットに表示されず、fork の Trajectory 表示には出ている。

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @langify-org/dsh-side-chat
 
-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.
+English | [日本語](README.ja.md) | [中文](README.zh.md)
+
+Ask a side question about a DeepSeek Harness conversation without interrupting it. The side chat is a fork of the conversation, opened in the right sidebar with DSH's own chat and composer, and told that it is a side chat.
+
+## Requirements
+
+- DSH `>=0.2.1-rc.5 <0.3.0-0` with the Web UI.
+
+## Install
+
+```sh
+dsh plugin --profile <profile> add @langify-org/dsh-side-chat
+```
+
+In DSH Web and Desktop you can also add it from the **Plugins** page.
+
+## Usage
+
+Click the side-chat button in an assistant message's action row, or **Side chat** in the right sidebar's guide. The conversation is forked, titled `Side chat: <conversation title>`, and opens in the right sidebar, where you talk to it as in any conversation. Selecting a side chat in the session list opens its source conversation with the side chat beside it.
+
+- The side chat starts from the conversation's latest completed turn, whichever message you clicked. Later turns of the main conversation do not reach it, and nothing in the side chat reaches the main conversation.
+- The model is told it is in a side chat: to answer questions rather than resume the main task, and not to make changes unless you ask in the side chat. You do not see this instruction in the chat.
+
+## How it works
+
+The host plugin forks the session through DSH's session controller, the same fork as the **Fork** action, and puts the side-chat instruction into the fork's inbox at once with `agent.inject`; it reaches the model with the first message. The inbox is logged as soon as it changes, so the fork is marked as a side chat from its creation, across restarts. A session projection, `langifySideChat`, folds that mark from the fork's own log and reaches every browser with the session list. The browser half opens the fork in its own right-sidebar tab, which renders DSH's shared `conversation.content` with the Chat view, embedded as DSH's subagent tab embeds it. The fork is an ordinary session, so messages go through the ordinary prompt path.
+
+## Known limitations
+
+- **Listed in the sidebar**: a side chat is an ordinary session, so it appears in the session list. Archive it when you are done.
+- **Latest turn only**: the side chat starts from the latest completed turn; it cannot yet start from an earlier message.
+
+## Verifying in a browser
+
+`pnpm dev` from the repository root, then in a conversation with at least one completed turn:
+
+1. Click the side-chat button under an assistant message. A **Side chat** tab opens in the right sidebar with an empty composer.
+2. Send a question about the conversation. It answers with the conversation's context.
+3. Check that the main conversation shows nothing new.
+4. Check that the side-chat instruction is not shown in the side chat, and that it appears in the fork's Trajectory view.

package/README.zh.md

@@ -0,0 +1,42 @@
+# @langify-org/dsh-side-chat
+
+[English](README.md) | [日本語](README.ja.md) | 中文
+
+在不打断 DeepSeek Harness 对话的情况下，就该对话在旁边提问。旁路对话是对话的一个 fork，以 DSH 自带的对话界面和输入框在右侧边栏中打开，并告知模型它处于旁路对话中。
+
+## 环境要求
+
+- 带 Web UI 的 DSH `>=0.2.1-rc.5 <0.3.0-0`。
+
+## 安装
+
+```sh
+dsh plugin --profile <profile> add @langify-org/dsh-side-chat
+```
+
+在 DSH Web 版和 Desktop 版中也可以通过 **Plugins** 页面添加。
+
+## 使用
+
+点击 assistant 消息操作栏中的旁路对话按钮，或右侧边栏引导页中的 **旁路对话**。对话会被 fork，命名为 `旁路对话: <对话标题>`，并在右侧边栏中打开，可以像普通对话一样交谈。在会话列表中选择旁路对话时，会打开其来源对话，并在旁边打开该旁路对话。
+
+- 无论点击哪条消息，旁路对话都从对话最近一个已完成的轮次开始。主对话之后的轮次不会传入，旁路对话的内容也不会传到主对话。
+- 模型会被告知它处于旁路对话中：回答问题而不是继续主任务，除非在旁路对话中被要求，否则不做任何修改。这条指示不会显示在对话中。
+
+## 工作原理
+
+Host 端插件通过 DSH 的 session controller fork 会话（与 **Fork** 操作相同），随即用 `agent.inject` 把旁路对话的指示放入 fork 的 inbox，指示会随第一条消息到达模型。inbox 一变化就写入日志，因此 fork 从创建起就带有旁路对话的标记，重启后依然保留。会话 projection `langifySideChat` 从 fork 自身的日志中读取该标记，并随会话列表送达每个浏览器。浏览器端在自己的右侧边栏标签页中打开 fork，标签页以 Chat 视图渲染 DSH 共用的 `conversation.content`，嵌入方式与 DSH 的 subagent 标签页相同。fork 是普通会话，消息走普通的发送路径。
+
+## 已知限制
+
+- **出现在侧边栏中**：旁路对话是普通会话，会出现在会话列表中。用完后请归档。
+- **只能从最新轮次开始**：旁路对话从最近一个已完成的轮次开始，暂时不能从更早的消息开始。
+
+## 在浏览器中验证
+
+在仓库根目录运行 `pnpm dev`，然后在至少有一个已完成轮次的对话中确认：
+
+1. 点击 assistant 消息下方的旁路对话按钮，右侧边栏打开带有空输入框的 **旁路对话** 标签页。
+2. 发送一个关于该对话的问题，它会结合对话内容作答。
+3. 主对话中没有新增内容。
+4. 旁路对话中不显示旁路对话的指示，而 fork 的 Trajectory 视图中可以看到它。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Bundle layer: inserts the side-chat plugin when a profile enables this package.
+- insert:
+    - id: langify-side-chat
+      name: '@langify-org/dsh-side-chat'

package/dist/client.cjs

@@ -0,0 +1,363 @@
+window.__ModuleLoader__.load({
+	id: "@langify-org/dsh-side-chat",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let zod = require("zod");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		// ../../node_modules/.pnpm/@deepseek-ai+dsh-brand@0.2.1-rc.5_@deepseek-ai+cordis@4.0.5/node_modules/@deepseek-ai/dsh-brand/lib/index.js
+		/**
+		* Duplicate-install-safe nominal primitive helpers.
+		*
+		* A brand makes structurally identical strings or numbers non-interchangeable
+		* at the type level: a `SessionId` cannot be passed where a `ToolCallId` is
+		* expected, and an event sequence cannot be passed as a log offset. Comparison,
+		* logging, and serialization retain the underlying primitive behavior.
+		*
+		* This package owns no concrete domain value and keeps no runtime identity or mutable
+		* state, so independently installed copies produce interchangeable values.
+		*
+		* @module @deepseek-ai/dsh-brand
+		*/
+		/**
+		* Apply a compile-time string brand without changing the value.
+		* @param value - string admitted by the domain that owns the target brand.
+		* @returns the same string with the requested compile-time brand.
+		*/
+		function brandString(value) {
+			return value;
+		}
+		// ../../node_modules/.pnpm/@deepseek-ai+dsh-session@0.2.1-rc.5_@deepseek-ai+cordis@4.0.5_@deepseek-ai+dsh-scope@0._1afa55f8edfbf99388e776171daf732a/node_modules/@deepseek-ai/dsh-session/lib/types/types.js
+		/**
+		* Brand a string as a {@link SessionId}.
+		* @param id - the raw session id string.
+		* @returns the same string with the session-id brand.
+		*/
+		function SessionId(id) {
+			return brandString(id);
+		}
+		// src/rpc.ts
+		/** DSH's shared RPC channel, and the endpoint this plugin owns on it. */
+		const RPC_CHANNEL = "/api";
+		const RPC_METHOD = "langify-side-chat/create";
+		/** Failures the host reports; each one has a translated message. */
+		const ERROR_CODES = [
+			"invalid_request",
+			"fork_failed",
+			"internal_error"
+		];
+		const id = zod.z.string().min(1).max(256).refine((value) => !value.includes("\0"));
+		zod.z.strictObject({
+			sessionId: id,
+			title: zod.z.string().trim().min(1).max(200)
+		});
+		const createResponseSchema = zod.z.strictObject({ sessionId: id });
+		// src/client/chat-tab.tsx
+		/** Resource-address prefix of a side chat in the right sidebar. */
+		const ADDRESS_PREFIX = "dsh-resource://langify-side-chat/session/";
+		function chatAddress(sessionId) {
+			return `${ADDRESS_PREFIX}${encodeURIComponent(sessionId)}`;
+		}
+		/** The session id a side-chat address names, or undefined for any other address. */
+		function parseChatAddress(address) {
+			if (!address.startsWith("dsh-resource://langify-side-chat/session/")) return void 0;
+			const rest = address.slice(41);
+			if (rest === "" || rest.includes("/")) return void 0;
+			try {
+				return SessionId(decodeURIComponent(rest));
+			} catch {
+				return;
+			}
+		}
+		/** The Session-scoped child slot inside the tab; its one entry is ConversationPanel. */
+		const CONVERSATION_SLOT = "langify-side-chat.conversation";
+		/**
+		* The side chat's tab: binds the fork's Session around the conversation slot.
+		*/
+		function ChatTab({ retain, useTabInfo, SessionProvider, renderSlot }) {
+			const { tab } = useTabInfo();
+			const sessionId = parseChatAddress(tab.contentId);
+			const [reference, setReference] = (0, react.useState)();
+			(0, react.useEffect)(() => {
+				if (sessionId === void 0) return void 0;
+				const held = retain(sessionId);
+				setReference(held);
+				return () => {
+					setReference(void 0);
+					held.release();
+				};
+			}, [retain, sessionId]);
+			if (reference === void 0) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				style: {
+					height: "100%",
+					display: "flex",
+					flexDirection: "column",
+					minHeight: 0
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SessionProvider, {
+					session: reference,
+					children: renderSlot(CONVERSATION_SLOT, {})
+				})
+			});
+		}
+		/**
+		* DSH's shared conversation and composer for the surrounding Session, embedded
+		* as DSH's subagent tab embeds it: Chat view only, without the main header and
+		* width controls.
+		*/
+		function ConversationPanel({ renderFactorySlot }) {
+			return renderFactorySlot("conversation.content", {
+				variant: "embedded",
+				phase: "active",
+				hero: false
+			}, { slots: { views: ChatView } });
+		}
+		function ChatView({ renderSlot }) {
+			return renderSlot("conversation.session", { view: "chat" });
+		}
+		// src/client/messages.ts
+		/** DSH locale namespace of this plugin's messages. */
+		const NAMESPACE = "langify.sideChat";
+		const en = {
+			title: "Side chat",
+			action: "Ask in a side chat",
+			guide: "Ask about this conversation without interrupting it",
+			starting: "Starting a side chat…",
+			retry: "Retry",
+			"error.invalid_request": "The request was invalid: {message}",
+			"error.fork_failed": "The side chat could not start: {message}",
+			"error.internal_error": "Something went wrong: {message}",
+			"error.unexpected": "Something went wrong: {message}"
+		};
+		const zh = {
+			title: "旁路对话",
+			action: "在旁路对话中提问",
+			guide: "在不打断当前对话的情况下提问",
+			starting: "正在启动旁路对话…",
+			retry: "重试",
+			"error.invalid_request": "请求无效：{message}",
+			"error.fork_failed": "旁路对话启动失败：{message}",
+			"error.internal_error": "出现错误：{message}",
+			"error.unexpected": "出现错误：{message}"
+		};
+		const ja = {
+			title: "サイドチャット",
+			action: "サイドチャットで質問する",
+			guide: "今の会話を止めずに質問する",
+			starting: "サイドチャットを始めています…",
+			retry: "もう一度",
+			"error.invalid_request": "リクエストが正しくありません：{message}",
+			"error.fork_failed": "サイドチャットを始められませんでした：{message}",
+			"error.internal_error": "エラーが起きました：{message}",
+			"error.unexpected": "エラーが起きました：{message}"
+		};
+		// src/client/start-page.tsx
+		/** The guide card's page: starts a side chat at once and is replaced by it. */
+		function StartPage({ start, describe, t, useTabInfo }) {
+			const { tab } = useTabInfo();
+			const [attempt, setAttempt] = (0, react.useState)(0);
+			const [error, setError] = (0, react.useState)();
+			const started = (0, react.useRef)(-1);
+			(0, react.useEffect)(() => {
+				if (started.current === attempt) return;
+				started.current = attempt;
+				setError(void 0);
+				start(tab.id).catch((failure) => {
+					if (!tab.signal.aborted) setError(describe(failure));
+				});
+			}, [
+				attempt,
+				start,
+				describe,
+				tab.id,
+				tab.signal
+			]);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				role: error === void 0 ? "status" : "alert",
+				style: styles.page,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: error ?? t("starting") }), error !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					variant: "outline",
+					size: "sm",
+					onClick: () => setAttempt((n) => n + 1),
+					children: t("retry")
+				})]
+			});
+		}
+		const styles = { page: {
+			height: "100%",
+			display: "flex",
+			flexDirection: "column",
+			alignItems: "center",
+			justifyContent: "center",
+			gap: 12,
+			padding: 16,
+			textAlign: "center",
+			overflowWrap: "anywhere",
+			color: "var(--dsw-alias-label-secondary)"
+		} };
+		// src/client/index.tsx
+		const inject = [
+			"connection",
+			"locale",
+			"sessions",
+			"slots",
+			"sidebarRight",
+			"sidebarRightTabs",
+			"uiWorkspace"
+		];
+		const KIND = "langify-side-chat";
+		const TAB_ID = "langify-side-chat/chat";
+		const START_KIND = "langify-side-chat-new";
+		const START_ID = "langify-side-chat/new";
+		const RPC_TIMEOUT_MS = 6e4;
+		const ACTION_CLASS = "langify-side-chat-action";
+		const ACTION_CSS = `.${ACTION_CLASS}{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));border-radius:var(--dsw-radius-sm);color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;justify-content:center;align-items:center;padding:6px;display:inline-flex}.${ACTION_CLASS} svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}.${ACTION_CLASS}:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.${ACTION_CLASS}:disabled{cursor:default;opacity:.4}`;
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NAMESPACE, {
+				en,
+				zh
+			}), "side-chat: dictionaries");
+			ctx.effect(() => ctx.locale.register(NAMESPACE, "ja", ja), "side-chat: Japanese dictionary");
+			const t = ctx.locale.bind(NAMESPACE);
+			ctx.effect(() => {
+				const style = document.createElement("style");
+				style.textContent = ACTION_CSS;
+				document.head.append(style);
+				return () => style.remove();
+			}, "side-chat: styles");
+			const chatFace = { retain: (sessionId) => ctx.sessions.retain(sessionId, { source: "langifySideChat" }) };
+			ctx.effect(() => ctx.sidebarRightTabs.register({
+				id: TAB_ID,
+				kind: KIND,
+				patterns: [`${ADDRESS_PREFIX}**`],
+				canOpen: (address) => parseChatAddress(address) !== void 0,
+				title: (address) => {
+					const id = parseChatAddress(address);
+					return id && ctx.sessions.list.getSnapshot().byId[id]?.title || t("title");
+				},
+				keepMounted: true
+			}), "side-chat: chat tab type");
+			ctx.effect(() => ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({
+				name: "sidebar.right.pane.tab",
+				key: TAB_ID,
+				inject: () => chatFace,
+				children: { [CONVERSATION_SLOT]: {
+					kind: "single",
+					scope: "session"
+				} }
+			}, ChatTab)), "side-chat: chat tab");
+			ctx.effect(() => ctx.slots.inject(CONVERSATION_SLOT, () => ctx.slots.register({ name: CONVERSATION_SLOT }, ConversationPanel)), "side-chat: conversation");
+			const showChat = (fork, replaceTab) => ctx.sidebarRight.openResource(chatAddress(fork), {
+				kind: KIND,
+				...replaceTab === void 0 ? {} : { replaceTab }
+			});
+			/** Fork `sessionId` into a side chat and show it, in place of `replaceTab` when given. */
+			const open = async (sessionId, replaceTab) => {
+				const source = ctx.sessions.list.getSnapshot().byId[SessionId(sessionId)];
+				const title = `${t("title")}: ${source?.title ?? source?.displayTitle ?? sessionId}`;
+				const result = await ctx.connection.rpc.call(RPC_CHANNEL, RPC_METHOD, {
+					sessionId,
+					title
+				}, AbortSignal.timeout(RPC_TIMEOUT_MS));
+				if (!result.ok) throw new RpcFailure(result.error.code, result.error.message);
+				const fork = createResponseSchema.parse(result.value).sessionId;
+				showChat(fork, replaceTab);
+			};
+			ctx.effect(() => ctx.sidebarRightTabs.register({
+				id: START_ID,
+				kind: START_KIND,
+				title: () => t("title"),
+				guide: [{
+					id: "new-side-chat",
+					order: 30,
+					title: () => t("title"),
+					description: () => t("guide")
+				}]
+			}), "side-chat: start page type");
+			ctx.effect(() => ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({
+				name: "sidebar.right.pane.tab",
+				key: START_ID,
+				locale: NAMESPACE,
+				inject: (sessionId) => ({
+					start: (tab) => open(sessionId, tab),
+					describe: (error) => errorText(error, t)
+				})
+			}, StartPage)), "side-chat: start page");
+			let reopen;
+			ctx.effect(() => ctx.sidebarRight.mounted.subscribe(() => {
+				const shown = ctx.sidebarRight.mounted.getSnapshot();
+				if (shown === void 0) return;
+				if (reopen?.parent === shown) {
+					const { chat } = reopen;
+					reopen = void 0;
+					setTimeout(() => showChat(chat));
+					return;
+				}
+				const row = ctx.sessions.list.getSnapshot().byId[shown];
+				const parent = row?.parentId;
+				if (row?.projectionValues?.["langifySideChat"] !== true || parent === void 0) return;
+				reopen = {
+					parent,
+					chat: shown
+				};
+				setTimeout(() => ctx.uiWorkspace.openSession(parent));
+			}), "side-chat: open beside its conversation");
+			ctx.effect(() => ctx.slots.inject("conversation.chat.assistant-actions", () => ctx.slots.register({
+				name: "conversation.chat.assistant-actions",
+				id: "langify-side-chat",
+				order: 20,
+				locale: NAMESPACE,
+				inject: (sessionId) => ({ open: () => open(sessionId) })
+			}, SideChatAction)), "side-chat: message action");
+		}
+		/** A failed call; `code` is one of the host's error codes unless DSH's transport failed first. */
+		var RpcFailure = class extends Error {
+			code;
+			constructor(code, message) {
+				super(message);
+				this.code = code;
+			}
+		};
+		function SideChatAction({ open, t }) {
+			const [pending, setPending] = (0, react.useState)(false);
+			const [failure, setFailure] = (0, react.useState)();
+			const onClick = () => {
+				setPending(true);
+				setFailure(void 0);
+				open().catch((error) => setFailure(errorText(error, t))).finally(() => setPending(false));
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: t("action"),
+				side: "bottom",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: ACTION_CLASS,
+					"aria-label": t("action"),
+					disabled: pending,
+					onClick,
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconNewChatOutlineRegular, {})
+				})
+			}), failure !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				role: "status",
+				style: {
+					fontSize: 13,
+					color: "var(--dsw-alias-label-tertiary)"
+				},
+				children: failure
+			})] });
+		}
+		function errorText(error, t) {
+			const message = error instanceof Error ? error.message : String(error);
+			const code = error instanceof RpcFailure ? error.code : void 0;
+			const known = ERROR_CODES.find((value) => value === code);
+			return known === void 0 ? t("error.unexpected", { message }) : t(`error.${known}`, { message });
+		}
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/dist/index.mjs

@@ -0,0 +1,144 @@
+import { clientRequestSchema } from "@deepseek-ai/dsh-client-connection";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { SessionId } from "@deepseek-ai/dsh-session/types";
+import { z } from "zod";
+// src/rpc.ts
+/** DSH's shared RPC channel, and the endpoint this plugin owns on it. */
+const RPC_CHANNEL = "/api";
+const RPC_METHOD = "langify-side-chat/create";
+/** Session projection: `true` for a side chat, from its creation. */
+const PROJECTION_KEY = "langifySideChat";
+const id = z.string().min(1).max(256).refine((value) => !value.includes("\0"));
+const createRequestSchema = z.strictObject({
+	sessionId: id,
+	title: z.string().trim().min(1).max(200)
+});
+z.strictObject({ sessionId: id });
+// src/host/index.ts
+const name = "langify-side-chat";
+const SOURCE_KIND = "langify-side-chat";
+const inject = [
+	"connection",
+	"sessionController",
+	"sessionProjections"
+];
+/** Model-facing; the Chat view hides context messages, so the user never sees it. */
+const SIDE_CHAT_CONTEXT = `This is a side chat. The user opened it beside the conversation above to ask questions about it without interrupting it. The conversation above is a copy you share as background; your replies here never reach it.
+
+- Answer the user's questions in this side chat; do not resume or continue the main task.
+- Investigate as needed, but do not change files, run state-changing commands, or take other actions with side effects unless the user explicitly asks for them in this side chat.
+- Keep answers short and to the point.`;
+var SideChatError = class extends Error {
+	code;
+	constructor(code, message, options) {
+		super(message, options);
+		this.code = code;
+	}
+};
+function apply(ctx) {
+	ctx.effect(() => ctx.sessionProjections.register(sideChatProjection), "side-chat: projection");
+	async function create(request) {
+		let sessionId;
+		try {
+			({sessionId} = await ctx.sessionController.fork({ sessionId: SessionId(request.sessionId) }));
+		} catch (error) {
+			throw new SideChatError("fork_failed", messageOf(error), { cause: error });
+		}
+		const resolved = await ctx.sessionController.resolveAgent(sessionId);
+		if ("error" in resolved) throw new SideChatError("fork_failed", resolved.error.message);
+		resolved.agent.inject(sideChatContext());
+		await ctx.sessionController.rename({
+			sessionId: SessionId(sessionId),
+			title: request.title
+		}).catch((error) => ctx.logger.warn(`side-chat: rename failed: ${messageOf(error)}`));
+		return { sessionId };
+	}
+	const route = {
+		path: `${RPC_CHANNEL}/${RPC_METHOD}`,
+		methods: ["POST"],
+		requestBody: "buffered",
+		async fetch(request) {
+			if (request.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() !== "application/json") return new Response("JSON required", { status: 415 });
+			const body = await request.json().catch(() => void 0);
+			const envelope = clientRequestSchema.safeParse(body);
+			if (!envelope.success || envelope.data.method !== "langify-side-chat/create") return new Response("Invalid RPC envelope", { status: 400 });
+			const response = {
+				type: "server-response",
+				rpcId: envelope.data.rpcId,
+				result: await answer(envelope.data.payload)
+			};
+			return Response.json(response);
+		}
+	};
+	async function answer(payload) {
+		try {
+			const request = createRequestSchema.safeParse(payload);
+			if (!request.success) throw new SideChatError("invalid_request", z.prettifyError(request.error));
+			return {
+				ok: true,
+				value: await create(request.data)
+			};
+		} catch (error) {
+			const { code, message } = error instanceof SideChatError ? error : {
+				code: "internal_error",
+				message: messageOf(error)
+			};
+			return {
+				ok: false,
+				error: {
+					code,
+					message,
+					details: {}
+				}
+			};
+		}
+	}
+	ctx.effect(() => ctx.connection.fetch.register(route), `side-chat: ${route.path}`);
+}
+function sideChatContext() {
+	return createUserMessage({
+		content: [{
+			type: "text",
+			text: SIDE_CHAT_CONTEXT
+		}],
+		source: {
+			kind: SOURCE_KIND,
+			form: "instructions"
+		}
+	});
+}
+/**
+* `langifySideChat`: whether the session's own log holds the side-chat context,
+* from the moment it enters the inbox. A Fork of a side chat inherits the
+* context but is not one.
+*/
+const sideChatProjection = {
+	key: PROJECTION_KEY,
+	stateVersion: 1,
+	stateSchema: z.strictObject({
+		inherited: z.int().nonnegative(),
+		sideChat: z.boolean()
+	}),
+	init: (_header, inheritedEventCount) => ({
+		inherited: inheritedEventCount,
+		sideChat: false
+	}),
+	apply: (state, event) => state.sideChat || event.seq < state.inherited || !carriesContext(event) ? state : {
+		...state,
+		sideChat: true
+	},
+	wire: {
+		viewSchema: z.boolean(),
+		view: (state) => state.sideChat
+	}
+};
+const isContext = (message) => message.source.kind === SOURCE_KIND;
+function carriesContext(event) {
+	if (event.type === "user/message") return isContext(event.data);
+	if (event.type === "agent/inbox/spliced") return event.data.inserted.some(isContext);
+	return false;
+}
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+export { SIDE_CHAT_CONTEXT, apply, inject, name, sideChatProjection };

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@langify-org/dsh-side-chat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Ask a side question beside a DeepSeek Harness conversation, in a fork shown in the right sidebar",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "side-chat"
+  ],
+  "homepage": "https://github.com/langify-org/deepseek-harness-plugins/tree/main/packages/side-chat#readme",
+  "bugs": "https://github.com/langify-org/deepseek-harness-plugins/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/langify-org/deepseek-harness-plugins.git",
+    "directory": "packages/side-chat"
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml",
+    "README*.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./client": "./dist/client.cjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.5",
+    "@types/react": "18.3.31"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.1-rc.5 <0.3.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.2.1-rc.5 <0.3.0-0",
+    "@deepseek-ai/dsh-session": ">=0.2.1-rc.5 <0.3.0-0"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.5 <0.3.0-0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p src/client"
+  }
 }