@khorsheed/dsh-client-session-title-edit 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# 变更记录
+
+## 0.1.0（2026-08-22）
+
+首个公开发布。
+
+- 聊天头部标题旁的铅笔入口，点击后标题本身变成内联编辑器，预填当前标题并全选
+- Enter 提交、Escape 取消、空草稿禁用保存，宿主拒绝时内联提示
+- 输入框宽度随草稿自适应，上限为官方 220px
+- 超过宿主 80 UTF-8 字节标题预算的草稿被本地化警告拦下，绝不静默截断
+- 走官方 `session.rename` RPC，标题永不进入模型上下文

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-plugins contributors
+
+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.en.md

@@ -0,0 +1,70 @@
+# @khorsheed/dsh-client-session-title-edit
+
+English | [中文](README.md)
+
+Rename a session right in the dsh web GUI chat header: click the pencil next to the title and the title itself becomes an inline editor. Enter commits, Escape cancels, over-long drafts are blocked with a localized warning — and the model never sees any of it.
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/session-title-edit1.png" width="480" alt="inline session title editor in the chat header">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/session-title-edit2.png" width="480" alt="click the pencil and the title becomes an input — Enter saves">
+
+## Features
+
+- **Pencil in the header** — an entry right of the session title swaps in an inline editor, prefilled and fully selected.
+- **Predictable keys** — Enter commits, Escape cancels, empty drafts disable save, host rejections show inline.
+- **Auto-fitting input** — the field widens with the draft up to the official 220px cap.
+- **Budget-aware** — drafts past the host's 80-UTF-8-byte title budget are blocked with a warning, never silently truncated.
+- **Zero footprint** — rides the official `session.rename` RPC; the title never enters model context (no token or KV-cache effect).
+
+## Install
+
+```sh
+dsh plugin --profile web add @khorsheed/dsh-client-session-title-edit
+```
+
+Restart the web instance after install; uninstall removes every surface the plugin adds.
+
+```sh
+dsh plugin --profile web remove @khorsheed/dsh-client-session-title-edit
+```
+
+## Compatibility
+
+- npm release line (`@deepseek-ai/dsh@0.1.1-rc.2`): ✅ full — the rc.8→0.1.1-rc.1 API audit (2026-08-21) confirms every surface this plugin consumes is unchanged or additive (the ProjectionDefinition restructure, cacheHitPercent return-type change, and the credentials/updated event rename do not touch this package); no source change was needed; re-audited for rc.2 (2026-08-22): consumed surface unchanged, full build+test green.
+- source line (deepseek-harness master): ✅
+
+## Known Limitations
+
+- **In-place editing is a DOM-layer stopgap** — the official header exposes no title seat, so the editor overlays the hidden title crumb; if the official DOM changes, it degrades to an inline editor in the actions row.
+- **No optimistic update** — the header title refreshes only when the host projection settles the rename.
+- **Byte budget is host-owned, client-gated** — the client mirrors the host's 80-byte cap; a host that raises it widens the editor only once the constant follows.
+
+## How it works
+
+<details>
+<summary>Internals (click to expand)</summary>
+
+```
+src/index.ts            exports (apply/inject + TitleEditActionProps)
+src/client/index.ts     plugin body; contributes the header-actions entry
+src/client/TitleEditAction.tsx  pencil entry, inline editor, overlay + width fitting
+src/client/title-length.ts      MAX_TITLE_BYTES mirror + host normalization
+src/client/locales.ts   localized warnings/errors
+src/client/slots.ts     slot declaration
+```
+
+Pure browser-side plugin: the rename rides the official `session.rename` RPC (`session.rename` → `sessions.rename` → `ctx.sessionTitle.rename`), so it needs no host half, no new RPC, and no edits to core packages.
+
+Editing is in place: clicking the pencil hides the official title crumb (`data-ste-inplace`) and overlays the plugin's input at the crumb's measured rect. The input width is fitted to the draft via a hidden mirror span at the input's font, between the crumb's original width and its 220px cap.
+
+Nothing changes for the model: the title is a projection-only property, never in model context, and renaming appends only a user-sourced `session/title` event — no token or KV-cache effect. The header title flips when the host projection lands. Separately, `@deepseek-ai/dsh-session-title` caps accepted titles (`maxTitleBytes`, production default 80 UTF-8 bytes); the editor mirrors that cap plus the host's pre-cap normalization (escape/control/directional stripping, whitespace collapsing, trimming), so gating fires exactly when the host would truncate.
+
+</details>
+
+## Development
+
+Part of the [dsh-plugins](https://github.com/Khorsheed/dsh-plugins) monorepo (`packages/session-title-edit`). Issues and contributions welcome there.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record: the git blob hash of each side as of the
+# last confirmed-consistent state. Both languages carry equal authority; after
+# editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/session-title-edit/README.en.md
+packages/session-title-edit/README.en.md: 9b0bc61b534c9b2221996afbb1f0da10f011526d
+packages/session-title-edit/README.md: 1117e60c88c6ca7ec99dfb659d59ae98e1287865

package/README.md

@@ -0,0 +1,70 @@
+# @khorsheed/dsh-client-session-title-edit
+
+[English](README.en.md) | 中文
+
+在 dsh web GUI 聊天区头部直接重命名会话:点击标题旁的铅笔,标题本身变成内联编辑器。Enter 提交、Escape 取消,超长草稿会被本地化警告拦下——模型对此完全无感。
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/session-title-edit1.png" width="480" alt="聊天头部的内联会话标题编辑器">
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/session-title-edit2.png" width="480" alt="点击铅笔后标题变成输入框,回车即保存">
+
+## 特性
+
+- **头部铅笔**——会话标题右侧的条目切换出内联编辑器,预填当前标题并全选。
+- **可预期的按键**——Enter 提交、Escape 取消、空草稿禁用保存、宿主拒绝时内联提示。
+- **宽度自适应**——输入框随草稿变宽,上限为官方 220px。
+- **预算把关**——超过宿主 80 UTF-8 字节标题预算的草稿被警告拦下,绝不静默截断。
+- **零足迹**——走官方 `session.rename` RPC;标题永远不会进入模型上下文(无 token 或 KV 缓存影响)。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @khorsheed/dsh-client-session-title-edit
+```
+
+安装后重启 web 实例;卸载即移除本插件添加的全部界面。
+
+```sh
+dsh plugin --profile web remove @khorsheed/dsh-client-session-title-edit
+```
+
+## Compatibility
+
+- npm 发布线(`@deepseek-ai/dsh@0.1.1-rc.2`):✅ 完整——rc.8→0.1.1-rc.1 API 审计(2026-08-21)确认本插件消费的所有面无变化或纯增量(ProjectionDefinition 重构、cacheHitPercent 返回值变更、credentials/updated 事件改名均不涉及本包),无需改动源码；rc.1→rc.2 复核(2026-08-22):消费面无变化,全量构建测试通过。
+- 源码线(deepseek-harness master):✅
+
+## 已知限制
+
+- **原位编辑是 DOM 层过渡方案**——官方 header 没有暴露标题槽位,编辑器通过隐藏官方标题 crumb 并原位覆盖实现;官方 DOM 变化时退回 actions 行内编辑器。
+- **无乐观更新**——header 标题只在宿主投影结算重命名后刷新。
+- **字节预算归宿主所有,由客户端把关**——客户端镜像宿主的 80 字节上限;宿主提高上限后,需常量同步跟进编辑器才会放宽。
+
+## 实现原理
+
+<details>
+<summary>内部结构(点击展开)</summary>
+
+```
+src/index.ts            导出(apply/inject + TitleEditActionProps)
+src/client/index.ts     插件主体;贡献 header-actions 条目
+src/client/TitleEditAction.tsx  铅笔条目、内联编辑器、覆盖与宽度适配
+src/client/title-length.ts      MAX_TITLE_BYTES 镜像 + 宿主归一化
+src/client/locales.ts   本地化警告与错误
+src/client/slots.ts     槽位声明
+```
+
+纯浏览器侧插件:重命名走官方 `session.rename` RPC(`session.rename` → `sessions.rename` → `ctx.sessionTitle.rename`),因此无需宿主半边、无需新增 RPC、无需改动任何官方包。
+
+编辑是原位的:点击铅笔后,通过 `data-ste-inplace` 隐藏官方标题 crumb,并在其测量矩形上覆盖本插件的输入框。输入框宽度借助隐藏的、与输入框同字体的镜像 span 按草稿适配,下限为 crumb 原宽度、上限为 crumb 的 220px 上限。
+
+对模型没有任何变化:标题是仅投影的会话属性,永不进入模型上下文;重命名只是追加一条带用户来源的 `session/title` 事件——无 token 或 KV 缓存影响,投影落地后 header 标题随之刷新。另外,`@deepseek-ai/dsh-session-title` 限制接受的标题长度(`maxTitleBytes`,生产默认 80 UTF-8 字节);编辑器镜像该上限以及宿主截断前的归一化(剥离转义/控制/方向序列、折叠空白、去首尾空白),把关恰好在宿主会截断时触发。
+
+</details>
+
+## 开发
+
+隶属 [dsh-plugins](https://github.com/Khorsheed/dsh-plugins) monorepo(`packages/session-title-edit`)。问题与贡献请移步该仓库。
+
+## 变更记录
+
+见 [CHANGELOG.md](CHANGELOG.md)。

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# session-title-edit bundle patch: inserts the plugin row into the composing
+# profile. The client half is discovered through the package.json dsh.client
+# block; there is no host half, so this row only activates the browser entry.
+- insert:
+    - id: session-title-edit
+      name: '@khorsheed/dsh-client-session-title-edit'

package/lib/client.js

@@ -0,0 +1,413 @@
+window.__ModuleLoader__.load({
+	id: "@khorsheed/dsh-client-session-title-edit",
+	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 react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/client/locales.ts
+		/** `session-title-edit` namespace dictionaries. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"action.rename": "重命名会话",
+			"editor.aria": "会话标题",
+			"editor.placeholder": "输入新标题…",
+			"editor.save": "保存",
+			"cancel": "取消",
+			"error.invalid": "标题不能为空",
+			"error.rename": "重命名失败，请重试",
+			"hint.tooLong": "标题过长：最多 {max} 字节（约 {chars} 个汉字），当前 {bytes} 字节"
+		};
+		/** The dictionary namespace owned by this plugin. */
+		const NS = "session-title-edit";
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"action.rename": "Rename session",
+			"editor.aria": "Session title",
+			"editor.placeholder": "Enter a new title…",
+			"editor.save": "Save",
+			"cancel": "Cancel",
+			"error.invalid": "The title cannot be empty",
+			"error.rename": "Rename failed, please try again",
+			"hint.tooLong": "Title too long: max {max} bytes (about {chars} CJK characters), currently {bytes}"
+		};
+		//#endregion
+		//#region src/client/slots.ts
+		/**
+		* Narrow an unknown thrown value to a {@link RenameFailure}.
+		* @param error - the value caught from a rename attempt.
+		* @returns true when the value is an Error carrying a string `code`.
+		*/
+		function isRenameFailure(error) {
+			return error instanceof Error && typeof error.code === "string";
+		}
+		//#endregion
+		//#region src/client/title-length.ts
+		/**
+		* Client-side mirror of the host session-title byte budget and the
+		* normalization the host applies before capping, so the editor can gate
+		* against the exact title the host would accept instead of discovering a
+		* silent truncation after commit.
+		*
+		* The host contract: `@deepseek-ai/dsh-session-title`'s
+		* `normalizeSessionTitle(input, maxTitleBytes)` cleans the text (ESC/CSI/
+		* control/directional sequences stripped, whitespace collapsed to one space,
+		* trimmed) and truncates to a UTF-8 byte budget. The production default is
+		* `maxTitleBytes: 80` (deepseek-harness `packages/bundle/base/cordis.patch.yml`).
+		* The clean step and the constant below mirror that behavior; update them
+		* together if the host changes either.
+		*/
+		/** Strip operating-system-command escape sequences, including unterminated tails. */
+		const OSC_SEQUENCE = /(?:\u001B\]|\u009D)(?:(?!\u0007|\u001B\\)[\s\S])*(?:\u0007|\u001B\\|$)/gu;
+		/** Strip control-sequence-introducer escapes such as SGR color codes. */
+		const CSI_SEQUENCE = /(?:\u001B\[|\u009B)[0-?]*[ -/]*[@-~]/gu;
+		/** Strip remaining two-byte ESC control sequences. */
+		const ESC_SEQUENCE = /\u001B[@-_]/gu;
+		/** Strip non-whitespace C0/C1 control characters. */
+		const CONTROL_CHARACTER = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/gu;
+		/** Strip directional and invisible controls that can make a displayed title deceptive. */
+		const DIRECTIONAL_CONTROL = /[\u200B\u200E\u200F\u202A-\u202E\u2060-\u2064\u2066-\u206F\uFEFF]/gu;
+		/**
+		* UTF-8 byte length of a string (the host caps titles by encoded size, not
+		* character count).
+		* @param input - arbitrary text.
+		* @returns the number of UTF-8 bytes `input` encodes to.
+		*/
+		function utf8ByteLength(input) {
+			return new TextEncoder().encode(input).length;
+		}
+		/**
+		* Byte length of a draft after the same cleaning the host applies before
+		* capping: escape/control/directional sequences stripped, whitespace
+		* collapsed to single spaces, trimmed. Gating on this value means the editor
+		* fires exactly when the host would truncate — whitespace-heavy or control-
+		* laced drafts are not falsely flagged, and drafts at the boundary pass
+		* through unchanged.
+		* @param input - raw editor draft.
+		* @returns UTF-8 bytes of the cleaned text (0 when nothing visible remains).
+		*/
+		function normalizedTitleByteLength(input) {
+			return utf8ByteLength(input.replace(OSC_SEQUENCE, "").replace(CSI_SEQUENCE, "").replace(ESC_SEQUENCE, "").replace(CONTROL_CHARACTER, "").replace(DIRECTIONAL_CONTROL, "").replace(/\s+/gu, " ").trim());
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/zhuyudan/code/dsh-plugins/packages/session-title-edit/src/client/TitleEditAction.module.css.mjs
+		const css = ".okd51a_renameButton{width:22px;height:22px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;justify-content:center;align-items:center;margin-left:-8px;padding:0;display:inline-flex}.okd51a_renameButton:hover,.okd51a_renameButton:focus-visible{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}.okd51a_editor{align-items:center;gap:6px;display:inline-flex}.okd51a_editorInput{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);width:220px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border-radius:6px;outline:none;padding:3px 8px;font-size:12px;line-height:18px}.okd51a_editorInput:focus{border-color:var(--dsw-alias-brand-primary)}.okd51a_editorInput:disabled{color:var(--dsw-alias-label-dimmed)}.okd51a_editorError{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px}.okd51a_editorHint{color:var(--dsw-alias-state-warn-primary);font-size:12px;line-height:18px}.okd51a_inPlaceInput{box-sizing:border-box;z-index:40;color:var(--dsw-alias-label-primary);background:0 0;border:1px solid #0000;border-radius:12px;outline:none;padding:4px 8px;font-size:14px;font-weight:500;line-height:20px;position:fixed}.okd51a_inPlaceInput:focus{border-color:var(--dsw-alias-brand-primary);background:var(--dsw-alias-bg-base)}.okd51a_inPlaceInput:disabled{color:var(--dsw-alias-label-dimmed)}.okd51a_inPlaceMirror{visibility:hidden;white-space:pre;pointer-events:none;font-family:inherit;font-size:14px;font-weight:500;position:absolute;top:-9999px;left:-9999px}.okd51a_inPlaceError{color:var(--dsw-alias-state-error-primary);margin-left:6px;font-size:12px;line-height:18px}.okd51a_inPlaceHint{color:var(--dsw-alias-state-warn-primary);margin-left:6px;font-size:12px;line-height:18px}header nav button[data-ste-inplace]{visibility:hidden!important}";
+		const tagId = "@khorsheed/dsh-client-session-title-edit/TitleEditAction.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@khorsheed/dsh-client-session-title-edit";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var TitleEditAction_module_css_default = {
+			"editorInput": "okd51a_editorInput",
+			"renameButton": "okd51a_renameButton",
+			"inPlaceError": "okd51a_inPlaceError",
+			"editor": "okd51a_editor",
+			"editorError": "okd51a_editorError",
+			"editorHint": "okd51a_editorHint",
+			"inPlaceMirror": "okd51a_inPlaceMirror",
+			"inPlaceHint": "okd51a_inPlaceHint",
+			"inPlaceInput": "okd51a_inPlaceInput"
+		};
+		//#endregion
+		//#region src/client/TitleEditAction.tsx
+		/**
+		* Session-header title-edit entry (`conversation.session.header.actions`): a
+		* pencil control immediately right of the title. Editing is IN PLACE: the
+		* official current-title crumb is hidden via a `data-ste-inplace` attribute
+		* (DOM layer — the official header renders the title and exposes no title
+		* seat) and this entry overlays its own input at the crumb's measured rect,
+		* so the title itself reads as the input. When the crumb cannot be located
+		* (the official DOM changed), the entry degrades to an inline editor in the
+		* actions row. Enter commits, Escape cancels, a blurred in-place input
+		* cancels, and a trimmed-empty draft never commits; host rejection keeps the
+		* editor open with a localized error.
+		*
+		* TODO(session-title-edit): deprecate the DOM-layer overlay when the official
+		* header opens a title slot (or makes the crumb editable) — this entry then
+		* becomes a pure slot consumer and the probe/overlay logic is removed.
+		*/
+		/** Attribute hiding the official current-title crumb while editing in place. */
+		const IN_PLACE_ATTR = "data-ste-inplace";
+		/** Extra room so the caret and a trailing glyph are never clipped. */
+		const INPUT_CARET_BUFFER = 4;
+		/** Outer width cap of the fitted input, matching the official crumb's `max-width: 220px`. */
+		const MAX_INPUT_WIDTH = 220;
+		/**
+		* Fit the in-place input to its text between the original crumb width (the
+		* floor, so the box never collapses while deleting) and the official 220px
+		* crumb cap (the ceiling, so a long draft clips exactly where the crumb's
+		* ellipsis would).
+		* @param textWidth - measured rendered width of the draft text.
+		* @param minWidth - the crumb's measured width at open.
+		* @returns the outer input width in px.
+		*/
+		function fitInputWidth(textWidth, minWidth) {
+			const target = textWidth + 18 + INPUT_CARET_BUFFER;
+			return Math.round(Math.min(Math.max(target, minWidth), MAX_INPUT_WIDTH));
+		}
+		/**
+		* Locate the official current-title crumb: the header's only disabled crumb
+		* button (the current session's crumb is `disabled`, ancestors navigate).
+		* @returns the crumb element, or null when the official DOM is unrecognizable.
+		*/
+		function locateCrumb() {
+			return document.querySelector("header nav button:disabled");
+		}
+		/**
+		* Render the title-edit control.
+		* @param props - session kit, rename verb, and locale seat.
+		* @returns the pencil button, or the in-place / inline editor while editing.
+		*/
+		function TitleEditAction({ sessionId, useSessions, renameSession, t }) {
+			const displayTitle = useSessions((state) => state.byId[sessionId]?.displayTitle);
+			const [editing, setEditing] = (0, react.useState)(false);
+			const [draft, setDraft] = (0, react.useState)("");
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			/** Placement when editing in place (over the hidden crumb); null = row editor. */
+			const [placement, setPlacement] = (0, react.useState)(null);
+			/** Outer width the in-place input is fitted to (draft text vs the crumb floor and 220px cap). */
+			const [inputWidth, setInputWidth] = (0, react.useState)(0);
+			const inputRef = (0, react.useRef)(null);
+			const crumbRef = (0, react.useRef)(null);
+			/** Hidden mirror of the draft, measured to fit the input to its text. */
+			const measureRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				if (!editing) return;
+				/* v8 ignore next -- the input is mounted while editing, so the ref is set */
+				inputRef.current?.select();
+			}, [editing]);
+			const inPlaceActive = placement !== null;
+			(0, react.useEffect)(() => {
+				if (!inPlaceActive) return;
+				const remeasure = () => {
+					const crumb = crumbRef.current;
+					/* v8 ignore next -- closeEditor nulls the ref and the placement in the same batch, so a resize cannot fire between them */
+					if (crumb === null) return;
+					const rect = crumb.getBoundingClientRect();
+					setPlacement({
+						left: rect.left,
+						top: rect.top,
+						width: rect.width,
+						height: rect.height
+					});
+				};
+				window.addEventListener("resize", remeasure);
+				return () => {
+					window.removeEventListener("resize", remeasure);
+				};
+			}, [inPlaceActive]);
+			(0, react.useEffect)(() => () => {
+				if (crumbRef.current !== null) crumbRef.current.removeAttribute(IN_PLACE_ATTR);
+			}, []);
+			(0, react.useLayoutEffect)(() => {
+				if (!inPlaceActive) return;
+				const textWidth = measureRef.current?.offsetWidth ?? 0;
+				setInputWidth(fitInputWidth(textWidth, placement.width));
+			}, [
+				draft,
+				placement,
+				inPlaceActive
+			]);
+			const closeEditor = () => {
+				setEditing(false);
+				setError(null);
+				if (crumbRef.current !== null) {
+					crumbRef.current.removeAttribute(IN_PLACE_ATTR);
+					crumbRef.current = null;
+				}
+				setPlacement(null);
+			};
+			const begin = () => {
+				setDraft(displayTitle ?? "");
+				setError(null);
+				const crumb = locateCrumb();
+				crumbRef.current = crumb;
+				if (crumb !== null) {
+					const rect = crumb.getBoundingClientRect();
+					crumb.setAttribute(IN_PLACE_ATTR, "");
+					setPlacement({
+						left: rect.left,
+						top: rect.top,
+						width: rect.width,
+						height: rect.height
+					});
+					setInputWidth(rect.width);
+				}
+				setEditing(true);
+			};
+			const cancel = () => {
+				/* v8 ignore next -- the cancel button and the input are disabled while busy, so this arm is unreachable through the UI */
+				if (busy) return;
+				closeEditor();
+			};
+			const commit = async () => {
+				/* v8 ignore next -- the save button and the input are disabled while busy, so this arm is unreachable through the UI */
+				if (busy) return;
+				const title = draft.trim();
+				if (title === "" || overLimit) return;
+				setBusy(true);
+				setError(null);
+				try {
+					await renameSession(title);
+					closeEditor();
+				} catch (cause) {
+					setError(isRenameFailure(cause) && cause.code === "title-invalid" ? t("error.invalid") : t("error.rename"));
+				} finally {
+					setBusy(false);
+				}
+			};
+			const onKeyDown = (event) => {
+				if (event.key === "Enter") commit();
+				else if (event.key === "Escape") cancel();
+			};
+			const onBlur = () => {
+				if (busy) return;
+				closeEditor();
+			};
+			const trimmed = draft.trim();
+			const draftBytes = normalizedTitleByteLength(draft);
+			const overLimit = draftBytes > 80;
+			const overLimitHint = t("hint.tooLong", {
+				max: 80,
+				chars: Math.floor(80 / 3),
+				bytes: draftBytes
+			});
+			if (!editing) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: TitleEditAction_module_css_default.renameButton,
+				"aria-label": t("action.rename"),
+				title: t("action.rename"),
+				onClick: begin,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 })
+			});
+			if (placement !== null) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					ref: measureRef,
+					className: TitleEditAction_module_css_default.inPlaceMirror,
+					"aria-hidden": "true",
+					children: draft === "" ? " " : draft
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					ref: inputRef,
+					className: TitleEditAction_module_css_default.inPlaceInput,
+					type: "text",
+					value: draft,
+					"aria-label": t("editor.aria"),
+					placeholder: t("editor.placeholder"),
+					disabled: busy,
+					autoFocus: true,
+					style: {
+						left: placement.left,
+						top: placement.top,
+						width: inputWidth,
+						height: placement.height
+					},
+					onChange: (event) => {
+						setDraft(event.currentTarget.value);
+					},
+					onKeyDown,
+					onBlur
+				}),
+				error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: TitleEditAction_module_css_default.inPlaceError,
+					role: "alert",
+					children: error
+				}) : overLimit && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: TitleEditAction_module_css_default.inPlaceHint,
+					role: "alert",
+					children: overLimitHint
+				})
+			] });
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				className: TitleEditAction_module_css_default.editor,
+				role: "group",
+				"aria-label": t("editor.aria"),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						ref: inputRef,
+						className: TitleEditAction_module_css_default.editorInput,
+						type: "text",
+						value: draft,
+						"aria-label": t("editor.aria"),
+						placeholder: t("editor.placeholder"),
+						disabled: busy,
+						autoFocus: true,
+						onChange: (event) => {
+							setDraft(event.currentTarget.value);
+						},
+						onKeyDown
+					}),
+					error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: TitleEditAction_module_css_default.editorError,
+						role: "alert",
+						children: error
+					}) : overLimit && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: TitleEditAction_module_css_default.editorHint,
+						role: "alert",
+						children: overLimitHint
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "outline",
+						disabled: busy,
+						onClick: cancel,
+						children: t("cancel")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "primary",
+						disabled: busy || trimmed === "" || overLimit,
+						onClick: () => {
+							commit();
+						},
+						children: t("editor.save")
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required services: slot contribution, session binding, and the copy. */
+		const inject = [
+			"slots",
+			"sessions",
+			"locale"
+		];
+		/**
+		* Client plugin body: register the dictionaries and the header action.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "session-title-edit: dictionaries");
+			ctx.slots.inject("conversation.session.header.actions", () => ctx.slots.register({
+				name: "conversation.session.header.actions",
+				id: "session-title-edit",
+				order: -20,
+				locale: NS,
+				inject: (sessionId) => ({ renameSession: async (title) => {
+					const session = ctx.sessions.binding(sessionId)?.session;
+					if (session === void 0) throw new Error(`session-title-edit: unknown session "${sessionId}"`);
+					const result = await session.rename(title);
+					if (!result.ok) {
+						const failure = new Error(result.error.message);
+						failure.code = result.error.code;
+						throw failure;
+					}
+				} })
+			}, TitleEditAction));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map