@ahggg/dsh-side-chat 0.7.2 → 0.7.3

package/README.md

@@ -8,10 +8,10 @@ Ask a focused follow-up about selected text without leaving your current DeepSee
 
 ## Install
 
-Install DSH rc.7 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:
+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:
 
 ```powershell
-npm install --global @deepseek-ai/dsh@0.1.0-rc.7
+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
 ```
@@ -27,7 +27,7 @@ Open the URL printed by DSH. The plugin loads automatically in the Web client.
 
 ### Local linked development
 
-When `dsh plugin --profile web list` shows the plugin coming from a `link:` workspace, DSH loads the Git-ignored `lib/client.js`, not `src/`. Rebuild after switching branches or changing client source, then restart the `dsh web` process:
+When `dsh plugin --profile web list` shows the plugin coming from a `link:` workspace, DSH loads the committed `lib/client.js`, not `src/`. Rebuild after switching branches or changing client source, then restart the `dsh web` process:
 
 ```powershell
 pnpm install --frozen-lockfile

package/README.zh-CN.md

@@ -8,10 +8,10 @@
 
 ## 安装
 
-如果尚未安装 DSH rc.7，先安装它。添加插件前只刷新这个包的 registry metadata，避免刚发布新版本时 pnpm 仍复用旧的 `latest`：
+如果尚未安装 DSH 0.1.2-rc.1，先安装它。添加插件前只刷新这个包的 registry metadata，避免刚发布新版本时 pnpm 仍复用旧的 `latest`：
 
 ```powershell
-npm install --global @deepseek-ai/dsh@0.1.0-rc.7
+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
 ```
@@ -27,7 +27,7 @@ dsh web --port 3080
 
 ### 本地链接调试
 
-当 `dsh plugin --profile web list` 显示插件来自 `link:` 工作区时，DSH 加载的是被 Git 忽略的 `lib/client.js`，而不是 `src/`。切换分支或修改客户端源码后，需要重新构建并重启 `dsh web` 进程：
+当 `dsh plugin --profile web list` 显示插件来自 `link:` 工作区时，DSH 加载的是已提交的 `lib/client.js`，而不是 `src/`。切换分支或修改客户端源码后，需要重新构建并重启 `dsh web` 进程：
 
 ```powershell
 pnpm install --frozen-lockfile

package/lib/client/apply.d.ts

@@ -2,4 +2,3 @@ import type { Context } from '@deepseek-ai/cordis';
 export declare const name = "side-chat-client";
 export declare const inject: string[];
 export declare function apply(ctx: Context): Promise<void>;
-//# sourceMappingURL=apply.d.ts.map

package/lib/client/apply.js

@@ -41,4 +41,3 @@ export async function apply(ctx) {
         }
     }, 'dsh-side-chat.clientLifecycle');
 }
-//# sourceMappingURL=apply.js.map

package/lib/client/contracts.d.ts

@@ -75,4 +75,3 @@ export type SideChatActionResult<T = void> = {
     readonly ok: false;
     readonly error: SideChatWireError;
 };
-//# sourceMappingURL=contracts.d.ts.map

package/lib/client/contracts.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=contracts.js.map

package/lib/client/index.d.ts

@@ -8,4 +8,3 @@ export { captureDomConversationSelection, restoreDomConversationSelection, type
 export { selectionFitsLimit, summarizeSelection, utf8ByteLength } from './selection/selection-limits.js';
 export { assertSelectionCurrent, finalizeConversationSelection, normalizeSelectedText, SelectionValidationError, type ConversationSelectionInput, } from './selection/selection-normalizer.js';
 export type { ConversationSelection, SelectionFragment, SelectionRect, SideChatModelSelection, SideChatState, } from '../shared/contracts.js';
-//# sourceMappingURL=index.d.ts.map

package/lib/client/index.js

@@ -6,4 +6,3 @@ export { SelectionActions } from './selection/SelectionActions.js';
 export { captureDomConversationSelection, restoreDomConversationSelection, } from './selection/selection-controller.js';
 export { selectionFitsLimit, summarizeSelection, utf8ByteLength } from './selection/selection-limits.js';
 export { assertSelectionCurrent, finalizeConversationSelection, normalizeSelectedText, SelectionValidationError, } from './selection/selection-normalizer.js';
-//# sourceMappingURL=index.js.map

package/lib/client/model-preference.d.ts

@@ -11,4 +11,3 @@ export declare class SideChatModelPreferences {
     set(selection: SideChatModelSelection): void;
 }
 export {};
-//# sourceMappingURL=model-preference.d.ts.map

package/lib/client/model-preference.js

@@ -57,4 +57,3 @@ export class SideChatModelPreferences {
         }
     }
 }
-//# sourceMappingURL=model-preference.js.map

package/lib/client/panel/SelectionQuote.d.ts

@@ -9,4 +9,3 @@ export declare function SelectionQuote({ selections, messages, onRemove, }: {
     readonly messages: SideChatMessages;
     readonly onRemove?: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SelectionQuote.d.ts.map

package/lib/client/panel/SelectionQuote.js

@@ -70,4 +70,3 @@ export function SelectionQuote({ selections, messages, onRemove, }) {
                             setExpanded(value => !value);
                         }, children: [_jsxs("svg", { className: "dsh-side-chat-quote-icon", viewBox: "0 0 24 24", "aria-hidden": "true", children: [_jsx("path", { d: "M21 15a4 4 0 0 1-4 4H7l-4 4V7a4 4 0 0 1 4-4h10a4 4 0 0 1 4 4Z" }), _jsx("path", { d: "M8 8h8M8 12h5" })] }), _jsx("strong", { children: messages.selectionAttachments(selections.length) })] }), onRemove !== undefined && (_jsx("button", { type: "button", className: "dsh-side-chat-quote-remove", "aria-label": messages.removeSelection, onClick: onRemove, children: "\u00D7" }))] }), _jsx("div", { ref: detailsRef, className: "dsh-side-chat-quote-details", role: "tooltip", children: selections.map((selection, index) => (_jsxs("div", { className: "dsh-side-chat-quote-detail", children: [_jsx("div", { className: "dsh-side-chat-quote-details-header", children: _jsxs("strong", { children: [String(index + 1), ". ", messages.selectionPreviewLabel, ":"] }) }), _jsx("pre", { children: selection.text }), selection.comment !== undefined && (_jsxs("div", { className: "dsh-side-chat-quote-comment", children: [_jsxs("strong", { children: [messages.selectionCommentLabel, ":"] }), _jsx("pre", { children: selection.comment })] }))] }, `${String(index)}-${selection.text}`))) })] }));
 }
-//# sourceMappingURL=SelectionQuote.js.map

package/lib/client/panel/SendIcon.d.ts

@@ -1,3 +1,2 @@
 /** Arrow used by DSH's native 34px primary send button. */
 export declare function SendIcon(): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SendIcon.d.ts.map

package/lib/client/panel/SendIcon.js

@@ -3,4 +3,3 @@ import { jsx as _jsx } from "react/jsx-runtime";
 export function SendIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", width: "16", height: "16", "aria-hidden": "true", children: _jsx("path", { d: "M8.3125 0.980183C8.66767 1.0531 8.97902 1.20418 9.2627 1.43233C9.48724 1.61297 9.73029 1.85793 9.97949 2.10714L14.707 6.83468L13.293 8.24874L9 3.95577V15.0417H7V3.95577L2.70703 8.24874L1.29297 6.83468L6.02051 2.10714C6.26971 1.85793 6.51277 1.61297 6.7373 1.43233C6.97662 1.23986 7.28445 1.04402 7.6875 0.980183C7.8973 0.947006 8.1031 0.95516 8.3125 0.980183Z", fill: "currentColor" }) }));
 }
-//# sourceMappingURL=SendIcon.js.map

package/lib/client/panel/SideChatBody.d.ts

@@ -3,4 +3,3 @@ import type { ReactNode } from 'react';
 export declare function SideChatBody({ children }: {
     readonly children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SideChatBody.d.ts.map

package/lib/client/panel/SideChatBody.js

@@ -3,4 +3,3 @@ import { jsx as _jsx } from "react/jsx-runtime";
 export function SideChatBody({ children }) {
     return _jsx("div", { className: "dsh-side-chat-body", children: children });
 }
-//# sourceMappingURL=SideChatBody.js.map

package/lib/client/panel/SideChatErrorState.d.ts

@@ -6,4 +6,3 @@ export declare function SideChatErrorState({ error, messages, onRetry, }: {
     readonly messages: SideChatMessages;
     readonly onRetry: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SideChatErrorState.d.ts.map

package/lib/client/panel/SideChatErrorState.js

@@ -3,4 +3,3 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export function SideChatErrorState({ error, messages, onRetry, }) {
     return (_jsxs("section", { className: "dsh-side-chat-error", role: "alert", children: [_jsx("strong", { children: error.code === 'side_chat_destroy_failed' ? messages.closeError : messages.genericError }), _jsx("p", { children: error.message }), error.recoverable && _jsx("button", { type: "button", onClick: onRetry, children: messages.retry })] }));
 }
-//# sourceMappingURL=SideChatErrorState.js.map

package/lib/client/panel/SideChatHeader.d.ts

@@ -8,4 +8,3 @@ export declare function SideChatHeader({ phase, messages, addToConversationDisab
     readonly onFocusParent: () => void;
     readonly onClose: () => void;
 }): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SideChatHeader.d.ts.map

package/lib/client/panel/SideChatHeader.js

@@ -5,4 +5,3 @@ function AddToConversationIcon() {
 export function SideChatHeader({ phase, messages, addToConversationDisabled = false, onAddToConversation, onFocusParent, onClose, }) {
     return (_jsxs("header", { className: "dsh-side-chat-header", children: [_jsx("button", { type: "button", className: "dsh-side-chat-heading", onClick: onFocusParent, children: _jsx("strong", { children: messages.title }) }), _jsxs("div", { className: "dsh-side-chat-header-actions", children: [onAddToConversation !== undefined && (_jsxs("button", { type: "button", className: "dsh-side-chat-add-to-conversation", disabled: addToConversationDisabled, onClick: onAddToConversation, children: [_jsx(AddToConversationIcon, {}), _jsx("span", { children: messages.addToConversation })] })), _jsx("button", { type: "button", className: "dsh-side-chat-close", "aria-label": messages.close, disabled: phase === 'closing', onClick: onClose, children: "\u00D7" })] })] }));
 }
-//# sourceMappingURL=SideChatHeader.js.map

package/lib/client/panel/SideChatModelSelect.d.ts

@@ -14,4 +14,3 @@ export interface SideChatModelSelectProps {
 }
 /** Side Chat projection of DSH Web's native composer model selector. */
 export declare function SideChatModelSelect({ directory, selection, locked, validateInitialSelection, locale, onInitialize, onSelect, }: SideChatModelSelectProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SideChatModelSelect.d.ts.map

package/lib/client/panel/SideChatModelSelect.js

@@ -244,4 +244,3 @@ export function SideChatModelSelect({ directory, selection, locked, validateInit
                             return (_jsxs("button", { ref: itemRef(), type: "button", role: "menuitemradio", "aria-checked": selected, className: `dsh-side-chat-model-option${selected ? ' dsh-side-chat-model-selected' : ''}`, disabled: selecting, onClick: () => { chooseEffort(level.effort); }, children: [_jsxs("span", { className: "dsh-side-chat-model-option-copy", children: [_jsx("span", { className: "dsh-side-chat-model-name", children: level.label }), level.description !== undefined && (_jsx("span", { className: "dsh-side-chat-model-description", children: level.description }))] }), _jsx("span", { className: "dsh-side-chat-model-check", children: selected ? _jsx(IconCheckOutline16, {}) : null })] }, level.key));
                         }))] })), toast !== null && (_jsx(Toast, { text: toast.text, icon: _jsx(IconWarningOutline16, {}), anchor: rootRef.current?.closest('[data-composer-card]') ?? null, onDone: () => { setToast(null); } }, toast.seq))] }));
 }
-//# sourceMappingURL=SideChatModelSelect.js.map

package/lib/client/panel/SideChatPanel.d.ts

@@ -16,4 +16,3 @@ export interface SideChatPanelProps {
     readonly onRemoveSelection?: () => void;
 }
 export declare function SideChatPanel({ state, locale, embeddedConversation, modelControl, onDraftChange, onFirstSend, onClose, onRetry, onFocusParent, onAddToConversation, addToConversationDisabled, onRemoveSelection, }: SideChatPanelProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=SideChatPanel.d.ts.map

package/lib/client/panel/SideChatPanel.js

@@ -32,4 +32,3 @@ export function SideChatPanel({ state, locale = 'en', embeddedConversation, mode
                                 }
                             } }), _jsxs("div", { className: "dsh-side-chat-draft-actions", children: [modelControl, _jsx("button", { type: "submit", className: "dsh-side-chat-send-button", "aria-label": messages.send, disabled: submitting || state.draft.trim().length === 0, children: _jsx(SendIcon, {}) })] })] })), _jsxs("footer", { className: "dsh-side-chat-footer", children: [_jsx("span", { children: messages.temporary }), _jsx("span", { children: messages.referenceOnly }), _jsx("span", { children: messages.cannotReopen }), _jsx("span", { children: messages.sharedWorkspace })] }), _jsx("div", { className: "dsh-side-chat-announcer", "aria-live": "polite", children: state.phase === 'running' ? 'Side Chat running' : `Side Chat ${state.phase}` })] }));
 }
-//# sourceMappingURL=SideChatPanel.js.map

package/lib/client/panel/StopIcon.d.ts

@@ -1,3 +1,2 @@
 /** Rounded-square stop glyph used by DSH's native primary action button. */
 export declare function StopIcon(): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=StopIcon.d.ts.map

package/lib/client/panel/StopIcon.js

@@ -3,4 +3,3 @@ import { jsx as _jsx } from "react/jsx-runtime";
 export function StopIcon() {
     return (_jsx("svg", { viewBox: "0 0 16 16", width: "16", height: "16", "aria-hidden": "true", children: _jsx("rect", { x: "3", y: "3", width: "10", height: "10", rx: "3", fill: "currentColor" }) }));
 }
-//# sourceMappingURL=StopIcon.js.map

package/lib/client/panel/messages.d.ts

@@ -20,4 +20,3 @@ export interface SideChatMessages {
     readonly closeError: string;
 }
 export declare const SIDE_CHAT_MESSAGES: Readonly<Record<'en' | 'zh-CN', SideChatMessages>>;
-//# sourceMappingURL=messages.d.ts.map

package/lib/client/panel/messages.js

@@ -42,4 +42,3 @@ export const SIDE_CHAT_MESSAGES = Object.freeze({
         closeError: '无法关闭侧边对话',
     }),
 });
-//# sourceMappingURL=messages.js.map

package/lib/client/panel/use-auto-growing-textarea.d.ts

@@ -1,3 +1,2 @@
 /** Keep a textarea one line tall until its content reaches the CSS max-height. */
 export declare function useAutoGrowingTextarea(value: string): import("react").RefObject<HTMLTextAreaElement>;
-//# sourceMappingURL=use-auto-growing-textarea.d.ts.map

package/lib/client/panel/use-auto-growing-textarea.js

@@ -18,4 +18,3 @@ export function useAutoGrowingTextarea(value) {
     }, [value]);
     return ref;
 }
-//# sourceMappingURL=use-auto-growing-textarea.js.map

package/lib/client/parent-composer/ParentConversationAnnotations.d.ts

@@ -26,4 +26,3 @@ export declare function annotatedUserMessageRenderer(Original: UserNodeRenderer)
 /** Mount the composer capsule and a thin wrapper around DSH's user renderers. */
 export declare function mountParentConversationAnnotations(ctx: Rc6ClientContext, removeAnnotations: () => void): () => void;
 export {};
-//# sourceMappingURL=ParentConversationAnnotations.d.ts.map

package/lib/client/parent-composer/ParentConversationAnnotations.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { createElement } from 'react';
+import { createElement, useLayoutEffect, useRef } from 'react';
 import { SIDE_CHAT_MESSAGES } from '../panel/messages.js';
 import { SelectionQuote } from '../panel/SelectionQuote.js';
 import { conversationAnnotations, parseAnnotatedConversationPrompt, } from './add-to-conversation.js';
@@ -7,12 +7,36 @@ import { parseReferencedConversationPrompt, } from './referenced-conversation.js
 function currentLocale() {
     return navigator.language.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en';
 }
+const ANNOTATION_CHIP_WIDTH_PROPERTY = '--dsh-side-chat-parent-annotation-width';
 /** The interactive annotation capsule occupying the reserved first composer row. */
 export function ParentComposerAnnotations({ input, onRemove, locale = currentLocale(), }) {
     const annotations = conversationAnnotations(input);
+    const dockRef = useRef(null);
+    useLayoutEffect(() => {
+        const dock = dockRef.current;
+        const seat = dock?.closest('[data-composer-seat]');
+        const chip = dock?.querySelector('.dsh-side-chat-quote-chip');
+        if (seat === undefined || chip === undefined || seat === null || chip === null)
+            return;
+        // The durable host reference stays in Lexical's document flow. Match its
+        // occupied width to this visible overlay so the caret starts at the edge
+        // users see instead of after the longer internal serialization label.
+        const syncWidth = () => {
+            const width = chip.getBoundingClientRect().width;
+            if (width > 0)
+                seat.style.setProperty(ANNOTATION_CHIP_WIDTH_PROPERTY, `${String(width)}px`);
+        };
+        syncWidth();
+        const observer = typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(syncWidth);
+        observer?.observe(chip);
+        return () => {
+            observer?.disconnect();
+            seat.style.removeProperty(ANNOTATION_CHIP_WIDTH_PROPERTY);
+        };
+    }, [annotations.length, locale]);
     if (annotations.length === 0)
         return null;
-    return (_jsx("div", { className: "dsh-side-chat-parent-annotation-dock", children: _jsx(SelectionQuote, { selections: annotations, messages: SIDE_CHAT_MESSAGES[locale], onRemove: onRemove }) }));
+    return (_jsx("div", { ref: dockRef, className: "dsh-side-chat-parent-annotation-dock", children: _jsx(SelectionQuote, { selections: annotations, messages: SIDE_CHAT_MESSAGES[locale], onRemove: onRemove }) }));
 }
 function contentText(content) {
     return content.map((block) => {
@@ -135,4 +159,3 @@ export function mountParentConversationAnnotations(ctx, removeAnnotations) {
         removeDock();
     };
 }
-//# sourceMappingURL=ParentConversationAnnotations.js.map

package/lib/client/parent-composer/add-to-conversation.d.ts

@@ -48,4 +48,3 @@ export interface AnnotatedConversationPrompt {
 export declare function parseAnnotatedConversationPrompt(text: string): AnnotatedConversationPrompt | undefined;
 /** Add the selected quote to the first child prompt. */
 export declare function buildSideChatPrompt(selection: ConversationSelection | undefined, question: string): readonly SideChatPromptPart[];
-//# sourceMappingURL=add-to-conversation.d.ts.map

package/lib/client/parent-composer/add-to-conversation.js

@@ -1,4 +1,4 @@
-import { draftWithoutOccurrence, LEGACY_REFERENCE_PLACEHOLDER, newlyInsertedOccurrence, occurrenceMatchesDraft, occurrenceRange, referenceDisplayText, } from './composer-reference.js';
+import { draftWithoutOccurrence, LEGACY_REFERENCE_PLACEHOLDER, newlyInsertedOccurrence, occurrenceEditSpan, occurrenceMatchesDraft, occurrenceRange, referenceDisplayText, } from './composer-reference.js';
 const SELECTION_REFERENCE_SOURCE = 'dsh-side-chat-selection';
 export const SELECTION_REFERENCE_LABEL = '__dsh_side_chat_annotations__';
 function escapeXmlText(value) {
@@ -163,8 +163,23 @@ function draftWithoutSelectionOccurrences(snapshot) {
 /** Remove every unsent plugin annotation while preserving the user's draft. */
 export function removeConversationAnnotations(input) {
     const snapshot = input.state.getSnapshot();
-    if (selectionOccurrences(snapshot).length === 0)
+    const occurrences = selectionOccurrences(snapshot);
+    if (occurrences.length === 0)
         return false;
+    if (input.referenceMode === 'lexical' && input.replaceText !== undefined) {
+        for (const occurrenceId of occurrences.map(occurrence => occurrence.occurrenceId).reverse()) {
+            const current = input.state.getSnapshot();
+            const occurrence = current.occurrences.find(candidate => candidate.occurrenceId === occurrenceId);
+            if (occurrence === undefined)
+                continue;
+            const span = occurrenceEditSpan(input, current, occurrence, {
+                consumeFollowingSeparator: true,
+            });
+            if (span === undefined || !input.replaceText('', span))
+                return false;
+        }
+        return selectionOccurrences(input.state.getSnapshot()).length === 0;
+    }
     input.setDraft(draftWithoutSelectionOccurrences(snapshot));
     return true;
 }
@@ -184,7 +199,7 @@ export const selectionReferenceSource = {
         },
     },
 };
-function writeConversationAnnotations(input, before, annotations) {
+function writeTextConversationAnnotations(input, before, annotations) {
     const draft = draftWithoutSelectionOccurrences(before);
     const insertionState = input.state.getSnapshot();
     if (insertionState.draftRev !== before.draftRev || insertionState.draft !== before.draft)
@@ -269,6 +284,85 @@ function writeConversationAnnotations(input, before, annotations) {
         && retained.offset === 0
         && occurrenceMatchesDraft(normalized, retained, SELECTION_REFERENCE_LABEL);
 }
+function writeLexicalConversationAnnotations(input, before, annotations) {
+    if (input.replaceText === undefined)
+        return false;
+    const existing = selectionOccurrences(before);
+    if (existing.length > 1)
+        return false;
+    const previous = existing[0];
+    if (previous !== undefined && previous.length === undefined)
+        return false;
+    let insertionState = before;
+    let preparedGap = false;
+    if (previous === undefined) {
+        // A gap inserted before the chip is unambiguously plugin-owned. DSH's
+        // automatic gap cannot otherwise be distinguished from a user's leading
+        // space when the reference is later removed.
+        if (!input.replaceText(' ', { start: 0, end: 0, draftRev: before.draftRev }))
+            return false;
+        insertionState = input.state.getSnapshot();
+        if (insertionState.draft !== ` ${before.draft}`)
+            return false;
+        preparedGap = true;
+    }
+    const span = previous === undefined
+        ? { start: 0, end: 0, draftRev: insertionState.draftRev }
+        : occurrenceEditSpan(input, insertionState, previous);
+    if (span === undefined)
+        return false;
+    const ref = encodeSelectionReference(annotations);
+    const clipboardText = annotations.map(annotation => annotation.text).join('\n\n');
+    const inserted = input.insertReference({
+        source: SELECTION_REFERENCE_SOURCE,
+        ref,
+        label: SELECTION_REFERENCE_LABEL,
+        clipboardText,
+    }, span);
+    if (!inserted) {
+        if (preparedGap) {
+            const current = input.state.getSnapshot();
+            if (current.draft === ` ${before.draft}`) {
+                input.replaceText('', { start: 0, end: 1, draftRev: current.draftRev });
+            }
+        }
+        return false;
+    }
+    const afterInsert = input.state.getSnapshot();
+    const occurrence = newlyInsertedOccurrence(insertionState, afterInsert, SELECTION_REFERENCE_SOURCE, ref);
+    const previousEnd = previous === undefined ? 0 : previous.offset + (previous.length ?? 0);
+    const previousTail = previous === undefined
+        ? insertionState.draft
+        : insertionState.draft.slice(previousEnd);
+    const automaticGap = previousTail.startsWith(' ') ? '' : ' ';
+    const expectedDraft = previous === undefined
+        ? `${clipboardText}${insertionState.draft}`
+        : insertionState.draft.slice(0, previous.offset) + clipboardText + automaticGap + previousTail;
+    const valid = occurrence !== undefined
+        && selectionOccurrences(afterInsert).length === 1
+        && occurrence.offset === (previous?.offset ?? 0)
+        && occurrence.label === SELECTION_REFERENCE_LABEL
+        && occurrence.clipboardText === clipboardText
+        && occurrenceMatchesDraft(afterInsert, occurrence, SELECTION_REFERENCE_LABEL)
+        && afterInsert.draft === expectedDraft;
+    if (valid)
+        return true;
+    // Best-effort rollback for a first insertion. Replacing an existing chip is
+    // atomic and should never reach this path on a conforming DSH input facade.
+    if (previous === undefined && occurrence !== undefined) {
+        const rollback = occurrenceEditSpan(input, afterInsert, occurrence, {
+            consumeFollowingSeparator: true,
+        });
+        if (rollback !== undefined)
+            input.replaceText('', rollback);
+    }
+    return false;
+}
+function writeConversationAnnotations(input, before, annotations) {
+    return input.referenceMode === 'lexical'
+        ? writeLexicalConversationAnnotations(input, before, annotations)
+        : writeTextConversationAnnotations(input, before, annotations);
+}
 /** Add one passage to the parent composer's aggregated annotation occurrence. */
 export function addSelectionToConversation(input, selection, comment) {
     const before = input.state.getSnapshot();
@@ -282,10 +376,8 @@ export function removeConversationAnnotation(input, annotationIndex) {
     if (!Number.isSafeInteger(annotationIndex) || annotations[annotationIndex] === undefined)
         return false;
     annotations.splice(annotationIndex, 1);
-    if (annotations.length === 0) {
-        input.setDraft(draftWithoutSelectionOccurrences(before));
-        return selectionOccurrences(input.state.getSnapshot()).length === 0;
-    }
+    if (annotations.length === 0)
+        return removeConversationAnnotations(input);
     return writeConversationAnnotations(input, before, annotations);
 }
 /** Replace the optional comment on one unsent selected-passage annotation. */
@@ -525,4 +617,3 @@ export function buildSideChatPrompt(selection, question) {
             ].join('\n'),
         }];
 }
-//# sourceMappingURL=add-to-conversation.js.map

package/lib/client/parent-composer/annotation-persistence.d.ts

@@ -16,4 +16,3 @@ export declare class ConversationAnnotationPersistence {
     private remove;
 }
 export {};
-//# sourceMappingURL=annotation-persistence.d.ts.map

package/lib/client/parent-composer/annotation-persistence.js

@@ -132,4 +132,3 @@ export class ConversationAnnotationPersistence {
         }
     }
 }
-//# sourceMappingURL=annotation-persistence.js.map

package/lib/client/parent-composer/composer-reference.d.ts

@@ -5,35 +5,41 @@ export interface ParentComposerOccurrence {
     readonly source: string;
     readonly ref: string;
     readonly offset: number;
-    /** Complete inline display-text length in current DSH input snapshots. */
+    /** Occupied projection length (display text through 0.1.1, clipboard text in 0.1.2). */
     readonly length?: number;
     /** Insert-time display label, present in current DSH input snapshots. */
     readonly label?: string;
     /** Draft-persistence projection cached by current DSH input snapshots. */
     readonly clipboardText?: string;
+    readonly appearance?: 'session' | 'file' | 'folder';
 }
 export interface ParentComposerInputSnapshot {
     readonly draft: string;
     readonly draftRev: number;
     readonly occurrences: readonly ParentComposerOccurrence[];
 }
+export interface ParentComposerSpan {
+    readonly start: number;
+    readonly end: number;
+    readonly draftRev: number;
+}
 export interface ParentComposerInput {
     readonly state: {
         getSnapshot(): ParentComposerInputSnapshot;
         subscribe?(listener: () => void): () => void;
     };
+    /** DSH 0.1.2's Lexical editor projects each reference as one mutation coordinate. */
+    readonly referenceMode?: 'text' | 'lexical';
     setDraft(text: string): void;
+    /** Atomic plain-text replacement supplied by Side Chat's scoped input-event adapter. */
+    replaceText?(text: string, span: ParentComposerSpan): boolean;
     insertReference(reference: {
         readonly source: string;
         readonly ref: string;
         readonly label: string;
         readonly appearance?: 'session' | 'file' | 'folder';
         readonly clipboardText: string;
-    }, span: {
-        readonly start: number;
-        readonly end: number;
-        readonly draftRev: number;
-    }): boolean;
+    }, span: ParentComposerSpan): boolean;
 }
 export interface ParentConversationService {
     readonly input: {
@@ -63,10 +69,13 @@ export declare function referenceDisplayText(label: string): string;
  */
 export declare function occurrenceRange(snapshot: ParentComposerInputSnapshot, occurrence: ParentComposerOccurrence, expectedLabel: string): OccurrenceRange | undefined;
 export declare function occurrenceMatchesDraft(snapshot: ParentComposerInputSnapshot, occurrence: ParentComposerOccurrence, expectedLabel: string): boolean;
+/** Convert one published occurrence range to the host input machine's mutation coordinates. */
+export declare function occurrenceEditSpan(input: ParentComposerInput, snapshot: ParentComposerInputSnapshot, occurrence: ParentComposerOccurrence, options?: {
+    readonly consumeFollowingSeparator?: boolean;
+}): ParentComposerSpan | undefined;
 /** Find the exact occurrence minted by one synchronous insertReference call. */
 export declare function newlyInsertedOccurrence(before: ParentComposerInputSnapshot, after: ParentComposerInputSnapshot, source: string, ref: string): ParentComposerOccurrence | undefined;
 /** Remove one occurrence's display range and, optionally, its separating ASCII gap. */
 export declare function draftWithoutOccurrence(snapshot: ParentComposerInputSnapshot, occurrence: ParentComposerOccurrence, expectedLabel: string, options?: {
     readonly consumeAdjacentSpace?: boolean;
 }): string | undefined;
-//# sourceMappingURL=composer-reference.d.ts.map

package/lib/client/parent-composer/composer-reference.js

@@ -30,7 +30,40 @@ export function occurrenceMatchesDraft(snapshot, occurrence, expectedLabel) {
     if (range === undefined)
         return false;
     const text = snapshot.draft.slice(range.start, range.end);
-    return text === LEGACY_REFERENCE_PLACEHOLDER || text === referenceDisplayText(expectedLabel);
+    if (text === LEGACY_REFERENCE_PLACEHOLDER || text === referenceDisplayText(expectedLabel))
+        return true;
+    return occurrence.label === expectedLabel
+        && occurrence.clipboardText !== undefined
+        && text === occurrence.clipboardText;
+}
+/** Convert one published occurrence range to the host input machine's mutation coordinates. */
+export function occurrenceEditSpan(input, snapshot, occurrence, options = {}) {
+    const range = occurrenceRange(snapshot, occurrence, occurrence.label ?? '');
+    if (range === undefined)
+        return;
+    let start = range.start;
+    let end = range.end;
+    if (input.referenceMode === 'lexical') {
+        if (occurrence.length === undefined)
+            return;
+        start = occurrence.offset;
+        for (const candidate of [...snapshot.occurrences].sort((left, right) => left.offset - right.offset)) {
+            if (candidate.occurrenceId === occurrence.occurrenceId)
+                break;
+            if (candidate.offset > occurrence.offset || candidate.length === undefined)
+                return;
+            start -= candidate.length - 1;
+        }
+        end = start + 1;
+    }
+    if (options.consumeFollowingSeparator === true) {
+        const tail = snapshot.draft.slice(range.end);
+        if (tail.startsWith('\n\n'))
+            end += 2;
+        else if (tail.startsWith('\n') || tail.startsWith(' '))
+            end += 1;
+    }
+    return { start, end, draftRev: snapshot.draftRev };
 }
 /** Find the exact occurrence minted by one synchronous insertReference call. */
 export function newlyInsertedOccurrence(before, after, source, ref) {
@@ -54,4 +87,3 @@ export function draftWithoutOccurrence(snapshot, occurrence, expectedLabel, opti
     }
     return snapshot.draft.slice(0, start) + snapshot.draft.slice(end);
 }
-//# sourceMappingURL=composer-reference.js.map

package/lib/client/parent-composer/referenced-conversation.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ConversationNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import type { SessionId } from '../../shared/contracts.js';
 import type { ParentComposerInput, SelectionReferenceSource } from './composer-reference.js';
 export declare const SIDE_CHAT_CONVERSATION_REFERENCE_SOURCE = "dsh-side-chat-conversation";
@@ -32,4 +32,3 @@ export declare function parseReferencedConversationPrompt(text: string): ParsedR
 export declare function addReferencedSideChatToConversation(input: ParentComposerInput, reference: ReferencedSideChatConversation): boolean;
 /** Reference codec used by the native composer chip and submit pipeline. */
 export declare const sideChatConversationReferenceSource: SelectionReferenceSource;
-//# sourceMappingURL=referenced-conversation.d.ts.map