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

package/lib/types/client/TitleEditAction.js

@@ -0,0 +1,201 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * 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.
+ */
+import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import { Button, IconEditOutline16 } from '@deepseek-ai/dsh-client-ui-primitives';
+import { isRenameFailure } from './slots.js';
+import { MAX_TITLE_BYTES, normalizedTitleByteLength } from './title-length.js';
+import css from './TitleEditAction.module.css';
+/** Attribute hiding the official current-title crumb while editing in place. */
+const IN_PLACE_ATTR = 'data-ste-inplace';
+/** Horizontal padding of the in-place input (`padding: 4px 8px`). */
+const INPUT_H_PADDING = 8;
+/** Border width of the in-place input (`1px solid transparent`). */
+const INPUT_BORDER = 1;
+/** 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 + (INPUT_H_PADDING + INPUT_BORDER) * 2 + 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.
+ */
+export function TitleEditAction({ sessionId, useSessions, renameSession, t }) {
+    const displayTitle = useSessions(state => state.byId[sessionId]?.displayTitle);
+    const [editing, setEditing] = useState(false);
+    const [draft, setDraft] = useState('');
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    /** Placement when editing in place (over the hidden crumb); null = row editor. */
+    const [placement, setPlacement] = useState(null);
+    /** Outer width the in-place input is fitted to (draft text vs the crumb floor and 220px cap). */
+    const [inputWidth, setInputWidth] = useState(0);
+    const inputRef = useRef(null);
+    const crumbRef = useRef(null);
+    /** Hidden mirror of the draft, measured to fit the input to its text. */
+    const measureRef = useRef(null);
+    // Select the whole current title on open so typing replaces it outright.
+    useEffect(() => {
+        if (!editing)
+            return;
+        /* v8 ignore next -- the input is mounted while editing, so the ref is set */
+        inputRef.current?.select();
+    }, [editing]);
+    // Re-measure while editing in place so a window resize keeps the overlay on
+    // the (hidden) crumb's position.
+    const inPlaceActive = placement !== null;
+    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]);
+    // Never leave the official crumb hidden: restore it if this entry unmounts
+    // mid-edit (programmatic session switch, HMR reload, plugin disposal).
+    useEffect(() => () => {
+        if (crumbRef.current !== null)
+            crumbRef.current.removeAttribute(IN_PLACE_ATTR);
+    }, []);
+    // Fit the in-place input to its text: measure the mirror span (which carries
+    // the exact draft at the input's font) after every draft or placement
+    // change, then clamp between the crumb's original width and the 220px cap.
+    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) {
+            // Measure FIRST: the crumb is hidden via visibility (layout box kept),
+            // so its rect stays measurable both before and after hiding.
+            const rect = crumb.getBoundingClientRect();
+            crumb.setAttribute(IN_PLACE_ATTR, '');
+            setPlacement({ left: rect.left, top: rect.top, width: rect.width, height: rect.height });
+            // Floor the fitted width at the crumb's original width so the open box
+            // matches today's look; the fit effect widens it as the draft grows.
+            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();
+        // Never hand the host a draft it would silently truncate: block over-limit
+        // commits and surface the localized hint instead (Enter path; the row
+        // editor additionally disables save).
+        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')
+            void commit();
+        else if (event.key === 'Escape')
+            cancel();
+    };
+    const onBlur = () => {
+        if (busy)
+            return;
+        closeEditor();
+    };
+    const trimmed = draft.trim();
+    // Gate on the host-faithful cleaned byte length: the editor fires exactly
+    // when the host would truncate (see title-length.ts), never on whitespace.
+    const draftBytes = normalizedTitleByteLength(draft);
+    const overLimit = draftBytes > MAX_TITLE_BYTES;
+    const overLimitHint = t('hint.tooLong', {
+        max: MAX_TITLE_BYTES,
+        chars: Math.floor(MAX_TITLE_BYTES / 3),
+        bytes: draftBytes,
+    });
+    if (!editing) {
+        return (_jsx("button", { type: "button", className: css.renameButton, "aria-label": t('action.rename'), title: t('action.rename'), onClick: begin, children: _jsx(IconEditOutline16, { size: 14 }) }));
+    }
+    if (placement !== null) {
+        return (_jsxs(_Fragment, { children: [_jsx("span", { ref: measureRef, className: css.inPlaceMirror, "aria-hidden": "true", children: draft === '' ? ' ' : draft }), _jsx("input", { ref: inputRef, className: css.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: onKeyDown, onBlur: onBlur }), error !== null
+                    ? _jsx("span", { className: css.inPlaceError, role: "alert", children: error })
+                    : overLimit && _jsx("span", { className: css.inPlaceHint, role: "alert", children: overLimitHint })] }));
+    }
+    return (_jsxs("span", { className: css.editor, role: "group", "aria-label": t('editor.aria'), children: [_jsx("input", { ref: inputRef, className: css.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: onKeyDown }), error !== null
+                ? _jsx("span", { className: css.editorError, role: "alert", children: error })
+                : overLimit && _jsx("span", { className: css.editorHint, role: "alert", children: overLimitHint }), _jsx(Button, { variant: "outline", disabled: busy, onClick: cancel, children: t('cancel') }), _jsx(Button, { variant: "primary", disabled: busy || trimmed === '' || overLimit, onClick: () => { void commit(); }, children: t('editor.save') })] }));
+}

package/lib/types/client/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Session-title-edit plugin, browser half: contributes one
+ * `conversation.session.header.actions` entry — a pencil control beside the
+ * session title that swaps in an inline editor. The rename verb rides the
+ * official session.rename RPC (`session.rename` → `sessions.rename` →
+ * `ctx.sessionTitle.rename`), so the plugin needs no host half, no new RPC,
+ * and no edits to core packages; the accepted user-sourced `session/title`
+ * event pins the title against automatic regeneration. Composing this plugin
+ * out of cordis.yml removes every surface it adds.
+ * @module @khorsheed/dsh-client-session-title-edit/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+export type { TitleEditActionProps } from './slots.ts';
+/** Required services: slot contribution, session binding, and the copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries and the header action.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,wCAAwC,CAAA;AAUtF,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAkC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA8B9C"}

package/lib/types/client/index.js

@@ -0,0 +1,36 @@
+import { en, NS, zh } from './locales.js';
+import { TitleEditAction } from './TitleEditAction.js';
+/** Required services: slot contribution, session binding, and the copy. */
+export const inject = ['slots', 'sessions', 'locale'];
+/**
+ * Client plugin body: register the dictionaries and the header action.
+ * @param ctx - client root context.
+ */
+export 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',
+        // Lead the actions row: this control is the title's own affordance, so
+        // it sits immediately right of the title text, ahead of the static
+        // agent-preset context (order -10). The slot convention reserves the
+        // negative band for static context, but the user-visible requirement is
+        // "edit beside the title, not after the preset label".
+        order: -20,
+        locale: NS,
+        inject: (sessionId) => ({
+            renameSession: async (title) => {
+                const session = ctx.sessions.binding(sessionId)?.session;
+                if (session === undefined) {
+                    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));
+}

package/lib/types/client/locales.d.ts

@@ -0,0 +1,34 @@
+/** `session-title-edit` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'action.rename': string;
+    'editor.aria': string;
+    'editor.placeholder': string;
+    'editor.save': string;
+    cancel: string;
+    'error.invalid': string;
+    'error.rename': string;
+    'hint.tooLong': string;
+};
+/** The session-title-edit namespace key union. */
+export type SessionTitleEditKey = keyof typeof zh;
+/** The dictionary namespace owned by this plugin. */
+export declare const NS = "session-title-edit";
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The session-title editing control's copy. */
+        'session-title-edit': SessionTitleEditKey;
+    }
+}
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'action.rename': string;
+    'editor.aria': string;
+    'editor.placeholder': string;
+    'editor.save': string;
+    cancel: string;
+    'error.invalid': string;
+    'error.rename': string;
+    'hint.tooLong': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;CASmB,CAAA;AAElC,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,EAAE,CAAA;AAEjD,qDAAqD;AACrD,eAAO,MAAM,EAAE,uBAAuB,CAAA;AAEtC,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,gDAAgD;QAChD,oBAAoB,EAAE,mBAAmB,CAAA;KAC1C;CACF;AAED,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;CASmB,CAAA"}

package/lib/types/client/locales.js

@@ -0,0 +1,25 @@
+/** `session-title-edit` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export 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. */
+export const NS = 'session-title-edit';
+/** English dictionary, checked complete against the zh key set. */
+export 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}',
+};

package/lib/types/client/slots.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Slot-facing types of the session-title-edit client half: the injected
+ * rename action face and the composed props of its one
+ * `conversation.session.header.actions` entry.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Rename failure carrying the wire error code for localized surfacing. */
+export interface RenameFailure extends Error {
+    /** Wire error code (e.g. `title-invalid`); transport failures keep the code the runtime reported. */
+    code: string;
+}
+/**
+ * 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`.
+ */
+export declare function isRenameFailure(error: unknown): error is RenameFailure;
+/** Injected action face of the header entry. */
+export interface SessionTitleEditInjected {
+    /**
+     * Rename the current session through the official session.rename RPC. The
+     * accepted user title pins the session against automatic regeneration.
+     * @param title - raw user input; the host normalizes and caps it.
+     * @returns when the host accepted the title.
+     * @throws {RenameFailure} carrying the wire error code on host rejection.
+     */
+    renameSession: (title: string) => Promise<void>;
+}
+/** Full props of the session-header title-edit entry. */
+export type TitleEditActionProps = PropsRuntime<'conversation.session.header.actions'> & InjectFace<SessionTitleEditInjected> & PropsLocale<'session-title-edit'>;
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/client/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAO7F,2EAA2E;AAC3E,MAAM,WAAW,aAAc,SAAQ,KAAK;IAC1C,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAC9B,YAAY,CAAC,qCAAqC,CAAC,GACjD,UAAU,CAAC,wBAAwB,CAAC,GACpC,WAAW,CAAC,oBAAoB,CAAC,CAAA"}

package/lib/types/client/slots.js

@@ -0,0 +1,8 @@
+/**
+ * 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`.
+ */
+export function isRenameFailure(error) {
+    return error instanceof Error && typeof error.code === 'string';
+}

package/lib/types/client/title-length.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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.
+ */
+/**
+ * Host cap on any accepted session title, in UTF-8 bytes. Mirrors the
+ * production default `maxTitleBytes: 80`; keep in sync with the host config.
+ * 80 bytes ≈ 80 ASCII characters or ≈ 26 CJK characters (3 bytes each).
+ */
+export declare const MAX_TITLE_BYTES = 80;
+/**
+ * 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.
+ */
+export declare function utf8ByteLength(input: string): number;
+/**
+ * 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).
+ */
+export declare function normalizedTitleByteLength(input: string): number;
+//# sourceMappingURL=title-length.d.ts.map

package/lib/types/client/title-length.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-length.d.ts","sourceRoot":"","sources":["../../../src/client/title-length.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH;;;;GAIG;AACH,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU/D"}

package/lib/types/client/title-length.js

@@ -0,0 +1,60 @@
+/**
+ * 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;
+/**
+ * Host cap on any accepted session title, in UTF-8 bytes. Mirrors the
+ * production default `maxTitleBytes: 80`; keep in sync with the host config.
+ * 80 bytes ≈ 80 ASCII characters or ≈ 26 CJK characters (3 bytes each).
+ */
+export const MAX_TITLE_BYTES = 80;
+/**
+ * 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.
+ */
+export 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).
+ */
+export function normalizedTitleByteLength(input) {
+    const cleaned = input
+        .replace(OSC_SEQUENCE, '')
+        .replace(CSI_SEQUENCE, '')
+        .replace(ESC_SEQUENCE, '')
+        .replace(CONTROL_CHARACTER, '')
+        .replace(DIRECTIONAL_CONTROL, '')
+        .replace(/\s+/gu, ' ')
+        .trim();
+    return utf8ByteLength(cleaned);
+}

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Session-title-edit plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this UI plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,wBAAgB,KAAK,IAAI,IAAI,CAAG"}

package/lib/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Session-title-edit plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this UI plugin. */
+export function apply() { }

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@khorsheed/dsh-client-session-title-edit`.
+ * @module @khorsheed/dsh-client-session-title-edit/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-session-title-edit-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,wCAAwC,CAAA;AACzD,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AAWpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAS,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/types/invariant.js

@@ -0,0 +1,24 @@
+/**
+ * Package-owned invariant companion for `@khorsheed/dsh-client-session-title-edit`.
+ * @module @khorsheed/dsh-client-session-title-edit/invariant
+ */
+const PACKAGE_NAME = '@khorsheed/dsh-client-session-title-edit';
+/** Cordis companion plugin name. */
+export const name = 'client-session-title-edit-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: every accepted rename is appended through the official
+ * session service, whose session-title invariant companion audits the
+ * `session/title` source relationship (a user rename must carry no message
+ * citations), and the plugin's one header-slot entry proves disposal through
+ * the browser-plugin spec. No second authority exists to check at runtime.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@khorsheed/dsh-client-session-title-edit",
+  "description": "Session title editing in the web GUI chat header: an edit control beside the title that renames the current session through the official session.rename RPC (the user-sourced title pins against automatic regeneration)",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "session",
+    "title"
+  ],
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-primitives"
+      ],
+      "platform": "web"
+    },
+    "compat": {
+      "minHost": "0.1.0-rc.6",
+      "verifiedHost": "0.1.1-rc.2"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.1",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
+}