@jxgame2020/dsh-token-quota 0.1.44 → 0.1.50

package/lib/index.js

@@ -290,6 +290,75 @@ function usageTokens(usage) {
 }
 /** DeepSeek's public API host; used to recognise DeepSeek-family providers. */
 const DEEPSEEK_BALANCE_HOST = "api.deepseek.com";
+/** TeamoRouter's host; its model and billing endpoints share this domain. */
+const TEAMOROUTER_HOST = "teamorouter.cn";
+/** Fallback currency per family, used before the first successful fetch. */
+const BALANCE_DEFAULT_CURRENCY = {
+	deepseek: "CNY",
+	teamorouter: "USD"
+};
+/**
+* Recognise which balance family a provider belongs to, from its endpoint, its
+* credential reference, or its route id. Returns undefined for providers whose
+* balance this plugin cannot query.
+* @param provider - registered provider route id.
+* @param keyEnv - the provider's declared `apiKeyEnv`, when it has one.
+* @param baseURL - the provider's endpoint base, when it declares one.
+* @returns the matching family, or undefined.
+*/
+function balanceKindOf(provider, keyEnv, baseURL) {
+	const host = (baseURL ?? "").toLowerCase();
+	const key = (keyEnv ?? "").toUpperCase();
+	const id = provider.toLowerCase();
+	if (host.includes(DEEPSEEK_BALANCE_HOST) || key.startsWith("DEEPSEEK") || id.startsWith("deepseek")) return "deepseek";
+	if (host.includes(TEAMOROUTER_HOST) || key.includes("TEAMO") || id.includes("teamo")) return "teamorouter";
+}
+/**
+* The balance endpoint for one family. TeamoRouter serves billing from the apex
+* host while its model endpoint lives on the `api.` subdomain, so the host is
+* rewritten rather than concatenated.
+* @param kind - balance family.
+* @param baseURL - the provider's model endpoint base.
+* @returns the absolute balance URL.
+*/
+function balanceURLOf(kind, baseURL) {
+	const base = baseURL.replace(/\/+$/, "");
+	if (kind === "teamorouter") return `${base.replace("//api.teamorouter.cn", "//teamorouter.cn")}/billing/balance`;
+	return `${base}/user/balance`;
+}
+/** Read a number out of a wire field that may be a string or a number. */
+function balanceNum(value, fallback = 0) {
+	const n = typeof value === "number" ? value : typeof value === "string" && value !== "" ? Number(value) : NaN;
+	return Number.isFinite(n) ? n : fallback;
+}
+/**
+* DeepSeek: `{ is_available, balance_infos: [{ currency, total_balance,
+* granted_balance, topped_up_balance }] }`.
+*/
+function parseDeepseekBalance(data) {
+	const record = data ?? {};
+	const first = Array.isArray(record.balance_infos) ? record.balance_infos[0] : void 0;
+	return {
+		currency: typeof first?.currency === "string" && first.currency !== "" ? first.currency : "CNY",
+		total: balanceNum(first?.total_balance),
+		granted: balanceNum(first?.granted_balance),
+		toppedUp: balanceNum(first?.topped_up_balance),
+		isAvailable: record.is_available !== false
+	};
+}
+/**
+* TeamoRouter: `{ balance: { value: "85.320000", currency: "USD" } }`. The
+* account is identified by the API key, so there is no availability flag.
+*/
+function parseTeamorouterBalance(data) {
+	const record = data ?? {};
+	const balance = record.balance !== null && typeof record.balance === "object" ? record.balance : void 0;
+	return {
+		currency: typeof balance?.currency === "string" && balance.currency !== "" ? balance.currency : "USD",
+		total: balanceNum(balance?.value),
+		isAvailable: true
+	};
+}
 var TokenQuotaService = class TokenQuotaService extends Service {
 	static Config = z.object({ storagePath: z.string().default("") });
 	storagePath;
@@ -651,7 +720,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return this.upgradeCheck;
 	}
 	async doRefreshUpgrade() {
-		const current = "0.1.44";
+		const current = "0.1.50";
 		let latest;
 		try {
 			const response = await fetch(REGISTRY_LATEST_URL, {
@@ -729,11 +798,11 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		return Promise.all([...this.discoverBalanceSources().values()].map((source) => this.refreshProviderBalance(source.provider, source))).then(() => void 0);
 	}
 	/**
-	* Discover every provider in the model directory that looks like DeepSeek,
-	* together with its own credential reference and endpoint base. This is what
-	* decides which providers are queried: a provider qualifies when its base URL
-	* points at DeepSeek's API host or its credential reference is named with the
-	* `DEEPSEEK` prefix, and it must declare an `apiKeyEnv`.
+	* Discover every provider in the model directory whose balance this plugin
+	* can query, together with its own credential reference and endpoint base.
+	* This is what decides which providers are queried: a provider qualifies when
+	* its base URL, credential reference, or route id matches a supported family
+	* (see {@link balanceKindOf}), and it must declare an `apiKeyEnv`.
 	*/
 	discoverBalanceSources() {
 		const found = /* @__PURE__ */ new Map();
@@ -742,7 +811,8 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 		const fallback = () => ({
 			provider: "deepseek",
 			keyEnv: "DEEPSEEK_API_KEY",
-			baseURL: process.env.DEEPSEEK_BASE_URL ?? `https://${DEEPSEEK_BALANCE_HOST}`
+			baseURL: process.env.DEEPSEEK_BASE_URL ?? `https://${DEEPSEEK_BALANCE_HOST}`,
+			kind: "deepseek"
 		});
 		if (llm?.listConfigurableProviders === void 0) {
 			found.set("deepseek", fallback());
@@ -755,11 +825,13 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 			const record = profile;
 			const keyEnv = typeof record.apiKeyEnv === "string" && record.apiKeyEnv !== "" ? record.apiKeyEnv : void 0;
 			const baseURL = typeof record.baseURL === "string" && record.baseURL !== "" ? record.baseURL : void 0;
-			if (!(baseURL !== void 0 && baseURL.includes(DEEPSEEK_BALANCE_HOST) || keyEnv !== void 0 && keyEnv.startsWith("DEEPSEEK") || entry.provider.startsWith("deepseek")) || keyEnv === void 0) continue;
+			const kind = balanceKindOf(entry.provider, keyEnv, baseURL);
+			if (kind === void 0 || keyEnv === void 0) continue;
 			found.set(entry.provider, {
 				provider: entry.provider,
 				keyEnv,
-				baseURL: baseURL ?? `https://${DEEPSEEK_BALANCE_HOST}`
+				baseURL: baseURL ?? (kind === "deepseek" ? `https://${DEEPSEEK_BALANCE_HOST}` : `https://${TEAMOROUTER_HOST}`),
+				kind
 			});
 		} catch {}
 		if (found.size === 0) found.set("deepseek", fallback());
@@ -787,7 +859,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 			if (key === void 0 || key === "") {
 				this.balances.set(provider, {
 					provider,
-					currency: "CNY",
+					currency: BALANCE_DEFAULT_CURRENCY[resolved.kind],
 					total: 0,
 					isAvailable: false,
 					fetchedAt: Date.now(),
@@ -795,7 +867,6 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				});
 				return;
 			}
-			const base = resolved.baseURL;
 			try {
 				const controller = new AbortController();
 				const timer = setTimeout(() => {
@@ -803,7 +874,7 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				}, 1e4);
 				let res;
 				try {
-					res = await fetch(`${base}/user/balance`, {
+					res = await fetch(balanceURLOf(resolved.kind, resolved.baseURL), {
 						headers: {
 							authorization: `Bearer ${key}`,
 							accept: "application/json"
@@ -815,26 +886,23 @@ var TokenQuotaService = class TokenQuotaService extends Service {
 				}
 				if (!res.ok) throw new Error(`HTTP ${res.status}`);
 				const data = await res.json();
-				const first = Array.isArray(data?.balance_infos) ? data.balance_infos[0] : void 0;
-				const num = (value) => {
-					const n = typeof value === "number" ? value : typeof value === "string" && value !== "" ? Number(value) : NaN;
-					return Number.isFinite(n) ? n : 0;
-				};
-				this.balances.set(provider, {
+				const parsed = resolved.kind === "teamorouter" ? parseTeamorouterBalance(data) : parseDeepseekBalance(data);
+				const next = {
 					provider,
-					currency: typeof first?.currency === "string" && first.currency !== "" ? first.currency : "CNY",
-					total: num(first?.total_balance),
-					granted: num(first?.granted_balance),
-					toppedUp: num(first?.topped_up_balance),
-					isAvailable: data?.is_available !== false,
+					currency: parsed.currency,
+					total: parsed.total,
+					isAvailable: parsed.isAvailable,
 					fetchedAt: Date.now(),
 					status: "ok"
-				});
+				};
+				if (parsed.granted !== void 0) next.granted = parsed.granted;
+				if (parsed.toppedUp !== void 0) next.toppedUp = parsed.toppedUp;
+				this.balances.set(provider, next);
 			} catch (error) {
 				const previous = this.balances.get(provider);
 				const next = {
 					provider,
-					currency: previous?.currency ?? "CNY",
+					currency: previous?.currency ?? BALANCE_DEFAULT_CURRENCY[resolved.kind],
 					total: previous?.total ?? 0,
 					isAvailable: false,
 					fetchedAt: previous?.fetchedAt ?? Date.now(),

package/lib/types/client/TokenQuotaPanel.js

@@ -431,15 +431,45 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
     };
     // Track whether any text input (composer, search, dialogs) currently has
     // focus, so the panel can dim while the user types elsewhere.
+    // Track whether the user is typing in a text field OUTSIDE this plugin's own
+    // surfaces, so the panel can dim while the chat behind it needs to stay
+    // readable.
+    //
+    // `focusout` matters as much as `focusin`: an earlier version observed only
+    // focusin, so once any field had ever received focus the flag stayed true for
+    // the rest of the session and the panel sat at 30% opacity — which reads as
+    // "the panel disappeared" until a reload reset the state. Recompute from
+    // document.activeElement rather than trusting the event, and also settle on
+    // pointer-down and window blur so a removed focused node cannot strand it.
     useEffect(() => {
-        const onFocusIn = (event) => {
-            const target = event.target;
-            const isInput = target !== null && (target.matches('input, textarea, [contenteditable="true"]')
-                || target.closest('input, textarea, [contenteditable="true"]') !== null);
-            setInputActive(isInput);
+        const isEditable = (el) => el !== null && (el.matches('input, textarea, [contenteditable="true"]')
+            || el.closest('input, textarea, [contenteditable="true"]') !== null);
+        const isOwnSurface = (el) => {
+            if (el === null)
+                return false;
+            for (const node of [panelRef.current, settingsRef.current, logRef.current]) {
+                if (node !== null && node.contains(el))
+                    return true;
+            }
+            return false;
+        };
+        const sync = () => {
+            const active = document.activeElement;
+            setInputActive(!isOwnSurface(active) && isEditable(active));
+        };
+        // focusout/pointerdown run before the next element gains focus: settle next tick.
+        const deferredSync = () => { window.setTimeout(sync, 0); };
+        document.addEventListener('focusin', sync);
+        document.addEventListener('focusout', deferredSync);
+        document.addEventListener('pointerdown', deferredSync, true);
+        window.addEventListener('blur', sync);
+        sync();
+        return () => {
+            document.removeEventListener('focusin', sync);
+            document.removeEventListener('focusout', deferredSync);
+            document.removeEventListener('pointerdown', deferredSync, true);
+            window.removeEventListener('blur', sync);
         };
-        window.addEventListener('focusin', onFocusIn);
-        return () => { window.removeEventListener('focusin', onFocusIn); };
     }, []);
     // When a NEW latest version appears (manual check or periodic poll):
     // expand the panel (it may be collapsed), force it opaque, and flash the
@@ -552,14 +582,6 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
         });
         return () => { cancelled = true; };
     }, [logOpen, actions]);
-    if (collapsed) {
-        return (_jsxs("div", { className: css.tab, role: "button", tabIndex: 0, title: t('expandHint'), "aria-label": t('expandHint'), onClick: () => { setCollapsed(false); }, onKeyDown: (event) => {
-                if (event.key === 'Enter' || event.key === ' ') {
-                    event.preventDefault();
-                    setCollapsed(false);
-                }
-            }, children: [_jsx("span", { className: css.tabIcon, "aria-hidden": "true", children: "\u25B8" }), _jsx("span", { className: css.tabLabel, children: t('expand') })] }));
-    }
     const openSettings = () => {
         actions.setDialogOpen(true);
     };
@@ -775,7 +797,20 @@ export function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored,
     const panelDimClass = dimWhenIdle
         ? (hovered || upgradeFlash ? '' : inputActive ? css.panelDimStrong : css.panelDim)
         : '';
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { ref: panelRef, className: `${css.panel}${panelDimClass !== '' ? ` ${panelDimClass}` : ''}`, style: panelPos !== null ? { left: panelPos.x, top: panelPos.y, right: 'auto' } : undefined, onPointerEnter: () => { setHovered(true); }, onPointerLeave: () => { setHovered(false); }, children: [_jsxs("div", { className: css.header, onPointerDown: (event) => { beginDrag(event, panelRef.current, applyPanelPos); }, children: [_jsx("div", { className: css.headerText, children: _jsxs("div", { className: css.title, children: [t('title'), __TOKEN_QUOTA_VERSION__ !== undefined && __TOKEN_QUOTA_VERSION__ !== '' && (upgrade !== null
+    // Collapsed tab. This early return MUST sit below every hook: React requires
+    // the hook count to be identical across renders, and returning above the
+    // balance/timestamp memos made it drop on collapse — React threw "Rendered
+    // fewer hooks than expected", the slot error boundary swallowed the entry,
+    // and the panel simply vanished until a page reload reset `collapsed`.
+    if (collapsed) {
+        return (_jsxs("div", { className: css.tab, role: "button", tabIndex: 0, title: t('expandHint'), "aria-label": t('expandHint'), onClick: () => { setCollapsed(false); }, onKeyDown: (event) => {
+                if (event.key === 'Enter' || event.key === ' ') {
+                    event.preventDefault();
+                    setCollapsed(false);
+                }
+            }, children: [_jsx("span", { className: css.tabIcon, "aria-hidden": "true", children: "\u25B8" }), _jsx("span", { className: css.tabLabel, children: t('expand') })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { ref: panelRef, "data-token-quota-panel": "", className: `${css.panel}${panelDimClass !== '' ? ` ${panelDimClass}` : ''}`, style: panelPos !== null ? { left: panelPos.x, top: panelPos.y, right: 'auto' } : undefined, onPointerEnter: () => { setHovered(true); }, onPointerLeave: () => { setHovered(false); }, children: [_jsxs("div", { className: css.header, onPointerDown: (event) => { beginDrag(event, panelRef.current, applyPanelPos); }, children: [_jsx("div", { className: css.headerText, children: _jsxs("div", { className: css.title, children: [t('title'), __TOKEN_QUOTA_VERSION__ !== undefined && __TOKEN_QUOTA_VERSION__ !== '' && (upgrade !== null
                                             ? (_jsxs("span", { className: `${css.version} ${css.versionNew}`, title: t('upgradeAvailableHint'), children: ["v", __TOKEN_QUOTA_VERSION__, " \u2192 v", upgrade.latestVersion] }))
                                             : (_jsxs("span", { className: css.version, children: ["v", __TOKEN_QUOTA_VERSION__] })))] }) }), _jsxs("div", { className: css.headerActions, onPointerDown: (event) => { event.stopPropagation(); }, children: [_jsx("button", { type: "button", "aria-pressed": musicEnabled, className: `${css.settingsBtn}${musicEnabled ? ` ${css.settingsBtnActive}` : ''}`, title: `${t('musicLabel')}：${musicEnabled ? t('musicOn') : t('musicOff')}`, onClick: () => { setMusicEnabled(!musicEnabled); }, children: "\u266A" }), _jsx("button", { type: "button", className: css.settingsBtn, onClick: () => { actions.setLogOpen(true); }, children: t('logs') }), _jsx("button", { type: "button", className: css.settingsBtn, onClick: openSettings, children: t('settings') }), _jsx("button", { type: "button", className: css.collapse, onClick: () => { setCollapsed(true); }, children: t('collapse') })] }), _jsxs("div", { className: css.notesBar, onPointerDown: (event) => { event.stopPropagation(); }, children: [notes.map((note) => {
                                         const open = note.visible && !note.collapsed;

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

@@ -0,0 +1,10 @@
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import { TOKEN_QUOTA_NAMESPACE } from '@jxgame2020/dsh-token-quota/types';
+import type { createTokenQuotaStashStore } from './stash.ts';
+/** Full component props: runtime + per-session stash store + locale. */
+export type TokenQuotaStashComponentProps = PropsRuntime<'conversation.input.overlay'> & PropsStore<ReturnType<typeof createTokenQuotaStashStore>> & PropsLocale<typeof TOKEN_QUOTA_NAMESPACE>;
+/**
+ * Numbered stash chips plus the capture popup, rendered inside the composer.
+ */
+export declare function TokenQuotaStash({ t, useStore, actions }: TokenQuotaStashComponentProps): JSX.Element;
+//# sourceMappingURL=TokenQuotaStash.d.ts.map

package/lib/types/client/TokenQuotaStash.js

@@ -0,0 +1,252 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Session-scoped stash UI, registered into `conversation.input.overlay` so it
+ * sits inside the composer card beside the mic.
+ *
+ * Capture (two ways, as requested):
+ *   1. select text — in a message OR in the composer draft — and use the small
+ *      popup that offers 复制 / 临存;
+ *   2. press Cmd/Ctrl+Shift+S on any selection.
+ *
+ * Retrieval: one numbered chip per snippet to the left of the mic. Hovering a
+ * chip shows the whole text; clicking drops it into the composer at the caret
+ * and retires the chip.
+ *
+ * The snippets themselves live in a per-session persisted store (see stash.ts),
+ * so they follow their session across reloads and never reach another session.
+ */
+import { useEffect, useRef, useState } from 'react';
+import css from './TokenQuotaStash.module.css';
+/** The harness composer's editable surface. */
+const COMPOSER_INPUT = '[data-composer-input]';
+/** Anything matching this is "not capturable text": this plugin's own layers
+    and form fields — selecting text inside an input is editing, not quoting.
+    The composer is deliberately NOT excluded: stashing part of a draft is a
+    supported flow. */
+const IGNORED_SELECTION = '[data-token-quota-stash], [data-token-quota-panel], input, textarea, select';
+/** The composer's contentEditable, when the composer is on screen. */
+function composerEditor() {
+    return document.querySelector(COMPOSER_INPUT);
+}
+/** Copy text, falling back to a hidden textarea when the clipboard API is denied. */
+function copyText(text) {
+    void navigator.clipboard?.writeText(text).catch(() => {
+        const scratch = document.createElement('textarea');
+        scratch.value = text;
+        scratch.style.position = 'fixed';
+        scratch.style.opacity = '0';
+        document.body.appendChild(scratch);
+        scratch.select();
+        try {
+            document.execCommand('copy');
+        }
+        catch { /* give up quietly */ }
+        document.body.removeChild(scratch);
+    });
+}
+/**
+ * Drop text into the composer at the caret the user last had there. Falls back
+ * to the end of the editor when no caret was recorded, and to the clipboard
+ * when the composer is not on screen at all.
+ */
+function insertIntoComposer(text, caret) {
+    const editor = composerEditor();
+    if (editor === null) {
+        copyText(text);
+        return;
+    }
+    editor.focus();
+    const selection = window.getSelection();
+    if (selection !== null) {
+        const restore = caret !== null && editor.contains(caret.startContainer);
+        if (restore) {
+            selection.removeAllRanges();
+            selection.addRange(caret);
+        }
+        else if (!editor.contains(selection.anchorNode)) {
+            // No usable caret: land at the end so the insertion is always visible.
+            const range = document.createRange();
+            range.selectNodeContents(editor);
+            range.collapse(false);
+            selection.removeAllRanges();
+            selection.addRange(range);
+        }
+    }
+    let inserted = false;
+    try {
+        inserted = document.execCommand('insertText', false, text);
+    }
+    catch {
+        // Some engines throw on execCommand; fall through to the manual path.
+    }
+    if (!inserted)
+        editor.appendChild(document.createTextNode(text));
+}
+/**
+ * Remove the live selection when it sits inside the composer: stashing part of
+ * a draft means MOVING it out of the way ("cut"), so the user does not have to
+ * delete it by hand and cannot accidentally send it. Selections anywhere else
+ * (a message) are left untouched.
+ */
+function cutComposerSelection() {
+    const editor = composerEditor();
+    const selection = window.getSelection();
+    if (editor === null || selection === null || selection.rangeCount === 0)
+        return;
+    const anchor = selection.anchorNode;
+    if (anchor === null || !editor.contains(anchor) || selection.isCollapsed)
+        return;
+    const before = editor.textContent ?? '';
+    // Route the removal through the editor's OWN input pipeline. The composer is
+    // a Lexical editor and only learns about changes it receives as input events;
+    // touching the DOM directly (Range.deleteContents) leaves Lexical's model
+    // holding the old text, so its next reconcile puts the text straight back —
+    // which is exactly why a full-selection cut used to come undone while a
+    // partial one appeared to work.
+    for (const attempt of ['cut', 'delete', 'insertText']) {
+        try {
+            if (attempt === 'insertText')
+                document.execCommand('insertText', false, '');
+            else
+                document.execCommand(attempt);
+        }
+        catch {
+            // Fall through to the next strategy.
+        }
+        if ((editor.textContent ?? '') !== before)
+            return;
+    }
+}
+/** Keycap emoji for the chip badges; index 0 renders as 1️⃣. */
+const STASH_BADGES = ['1️⃣', '2️⃣', '3️⃣', '4️⃣', '5️⃣', '6️⃣', '7️⃣', '8️⃣', '9️⃣'];
+/** The badge for the n-th (0-based) chip, falling back to a plain digit. */
+function stashBadge(index) {
+    return STASH_BADGES[index] ?? String(index + 1);
+}
+/**
+ * Numbered stash chips plus the capture popup, rendered inside the composer.
+ */
+export function TokenQuotaStash({ t, useStore, actions }) {
+    const items = useStore(s => s.items);
+    const [hovered, setHovered] = useState(null);
+    const [pending, setPending] = useState(null);
+    // The caret the user last had in the composer, restored on insertion so a
+    // snippet lands where they were typing rather than at the very end.
+    const caretRef = useRef(null);
+    const pendingRef = useRef(null);
+    pendingRef.current = pending;
+    // Capture: watch the document selection for the popup, and remember the
+    // composer caret while the user types.
+    useEffect(() => {
+        const sync = () => {
+            const selection = window.getSelection();
+            if (selection === null || selection.rangeCount === 0) {
+                setPending(null);
+                return;
+            }
+            const editor = composerEditor();
+            const anchor = selection.anchorNode;
+            if (editor !== null && anchor !== null && editor.contains(anchor)) {
+                // Selecting inside the composer is a first-class capture source too
+                // (write several thoughts, send one, stash the rest). Record the
+                // insertion point on the way through — but only for a collapsed caret,
+                // since a live selection would be replaced when a snippet lands.
+                if (selection.isCollapsed)
+                    caretRef.current = selection.getRangeAt(0).cloneRange();
+            }
+            if (selection.isCollapsed) {
+                setPending(null);
+                return;
+            }
+            const text = selection.toString().trim();
+            if (text === '') {
+                setPending(null);
+                return;
+            }
+            const range = selection.getRangeAt(0);
+            const container = range.commonAncestorContainer;
+            const element = container.nodeType === Node.ELEMENT_NODE
+                ? container
+                : container.parentElement;
+            if (element !== null && element.closest(IGNORED_SELECTION) !== null) {
+                setPending(null);
+                return;
+            }
+            const rects = range.getClientRects();
+            const rect = rects.length > 0 ? rects[rects.length - 1] : range.getBoundingClientRect();
+            if (rect === undefined) {
+                setPending(null);
+                return;
+            }
+            const half = 70;
+            // The composer sits at the bottom of the window, so a popup below the
+            // selection would fall off-screen: flip it above when there is no room.
+            const POPUP_HEIGHT = 34;
+            const below = rect.bottom + 6;
+            const y = below + POPUP_HEIGHT > window.innerHeight
+                ? Math.max(8, rect.top - POPUP_HEIGHT - 6)
+                : below;
+            setPending({
+                text,
+                x: Math.min(Math.max(rect.left + rect.width / 2, half + 8), window.innerWidth - half - 8),
+                y,
+            });
+        };
+        document.addEventListener('selectionchange', sync);
+        return () => { document.removeEventListener('selectionchange', sync); };
+    }, []);
+    // Capture by keyboard: Cmd/Ctrl+Shift+S on any selection — a message or the
+    // draft being written in the composer.
+    useEffect(() => {
+        const onKeyDown = (event) => {
+            if (!(event.metaKey || event.ctrlKey) || !event.shiftKey)
+                return;
+            if (event.key.toLowerCase() !== 's')
+                return;
+            const selection = window.getSelection();
+            if (selection === null || selection.isCollapsed)
+                return;
+            const text = selection.toString().trim();
+            if (text === '')
+                return;
+            event.preventDefault();
+            actions.add(text);
+            // Stashing a composer draft moves the text out of the way.
+            cutComposerSelection();
+            setPending(null);
+        };
+        window.addEventListener('keydown', onKeyDown);
+        return () => { window.removeEventListener('keydown', onKeyDown); };
+    }, [actions]);
+    const stash = () => {
+        const text = pendingRef.current?.text;
+        if (text === undefined)
+            return;
+        actions.add(text);
+        // In the composer this is a cut; in a message the text stays put.
+        cutComposerSelection();
+        setPending(null);
+        window.getSelection()?.removeAllRanges();
+    };
+    const hoveredItem = hovered === null ? undefined : items.find(item => item.id === hovered.id);
+    return (_jsxs(_Fragment, { children: [items.length > 0 && (_jsx("div", { className: css.stashRow, "data-token-quota-stash": "", children: items.map((item, index) => (_jsx("button", { type: "button", className: css.stashChip, 
+                    // Keeping focus (and the caret) in the composer is the whole point:
+                    // the snippet must land where the user was typing.
+                    onMouseDown: (event) => { event.preventDefault(); }, onMouseEnter: (event) => {
+                        const rect = event.currentTarget.getBoundingClientRect();
+                        setHovered({ id: item.id, left: rect.left, top: rect.top });
+                    }, onMouseLeave: () => { setHovered(null); }, onClick: () => {
+                        insertIntoComposer(item.text, caretRef.current);
+                        actions.remove(item.id);
+                        setHovered(null);
+                    }, "aria-label": t('stashChipHint').replace('{n}', String(index + 1)), children: stashBadge(index) }, item.id))) })), hovered !== null && hoveredItem !== undefined && (_jsx("div", { className: css.stashTip, "data-token-quota-stash": "", style: {
+                    left: Math.min(hovered.left, Math.max(8, window.innerWidth - 368)),
+                    bottom: window.innerHeight - hovered.top + 6,
+                }, children: hoveredItem.text })), pending !== null && (_jsxs("div", { className: css.selPopup, "data-token-quota-stash": "", style: { left: pending.x, top: pending.y }, 
+                // Keep the selection alive so the click can act on it.
+                onMouseDown: (event) => { event.preventDefault(); }, children: [_jsxs("button", { type: "button", className: css.selBtn, onClick: () => {
+                            copyText(pending.text);
+                            setPending(null);
+                        }, children: [_jsxs("svg", { viewBox: "0 0 16 16", width: "12", height: "12", "aria-hidden": "true", children: [_jsx("rect", { x: "5.6", y: "5.6", width: "7.8", height: "7.8", rx: "1.4", fill: "none", stroke: "currentColor", strokeWidth: "1.3" }), _jsx("path", { d: "M10.4 5.6V4a1.4 1.4 0 0 0-1.4-1.4H4A1.4 1.4 0 0 0 2.6 4v5A1.4 1.4 0 0 0 4 10.4h1.6", fill: "none", stroke: "currentColor", strokeWidth: "1.3", strokeLinecap: "round" })] }), t('stashCopy')] }), _jsx("span", { className: css.selDivider, "aria-hidden": "true" }), _jsxs("button", { type: "button", className: css.selBtn, onClick: stash, children: [_jsx("svg", { viewBox: "0 0 16 16", width: "12", height: "12", "aria-hidden": "true", children: _jsx("path", { d: "M9.3 1.5 3.8 8.7h3.4l-.9 5.8 5.5-7.3H8.4z", fill: "currentColor" }) }), t('stashSave')] })] }))] }));
+}
+//# sourceMappingURL=TokenQuotaStash.js.map

package/lib/types/client/index.js

@@ -3,6 +3,8 @@ import { createTokenQuotaPanelStore } from "./store.js";
 import { TokenQuotaPanel } from "./TokenQuotaPanel.js";
 import { TokenQuotaMusic } from "./music.js";
 import { TokenQuotaMic } from "./mic.js";
+import { createTokenQuotaStashStore } from "./stash.js";
+import { TokenQuotaStash } from "./TokenQuotaStash.js";
 import { en, zh } from "./locales.js";
 export { mergeModelRows } from "./store.js";
 /** Dictionary namespace owning the panel copy. */
@@ -635,5 +637,20 @@ export function apply(ctx) {
             t: t,
         }),
     }, TokenQuotaMic));
+    // Stash: numbered snippets picked out of the conversation, dropped back into
+    // the composer on click. This entry carries its OWN store handle (never the
+    // panel's): registered on a session-scoped slot, the renderer builds one
+    // instance per session and the engine suffixes the persist key with that
+    // session's id — so snippets follow their session across reloads and cannot
+    // leak into another one.
+    const stashStore = createTokenQuotaStashStore();
+    ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+        name: 'conversation.input.overlay',
+        id: 'token-quota-stash',
+        order: 90,
+        label: () => t('stashTitle'),
+        store: stashStore,
+        locale: NS,
+    }, TokenQuotaStash));
 }
 //# sourceMappingURL=index.js.map

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

@@ -49,6 +49,10 @@ export declare const zh: {
     transcribeKeyConfigured: string;
     transcribeKeyMissing: string;
     transcribeKeyFailed: string;
+    stashTitle: string;
+    stashCopy: string;
+    stashSave: string;
+    stashChipHint: string;
     transcribeModelLabel: string;
     transcribeModelHint: string;
     reorderHint: string;
@@ -190,6 +194,10 @@ export declare const en: {
     transcribeKeyConfigured: string;
     transcribeKeyMissing: string;
     transcribeKeyFailed: string;
+    stashTitle: string;
+    stashCopy: string;
+    stashSave: string;
+    stashChipHint: string;
     transcribeModelLabel: string;
     transcribeModelHint: string;
     reorderHint: string;

package/lib/types/client/locales.js

@@ -49,6 +49,10 @@ export const zh = {
     transcribeKeyConfigured: '已配置',
     transcribeKeyMissing: '未配置',
     transcribeKeyFailed: '保存失败',
+    stashTitle: '临存',
+    stashCopy: '复制',
+    stashSave: '临存',
+    stashChipHint: '点击把第 {n} 条插入输入框',
     transcribeModelLabel: '模型',
     transcribeModelHint: '语音转文本模型名',
     reorderHint: '拖动排序',
@@ -188,6 +192,10 @@ export const en = {
     transcribeKeyConfigured: 'Configured',
     transcribeKeyMissing: 'Not configured',
     transcribeKeyFailed: 'Save failed',
+    stashTitle: 'Stash',
+    stashCopy: 'Copy',
+    stashSave: 'Stash',
+    stashChipHint: 'Insert snippet {n} into the composer',
     transcribeModelLabel: 'Model',
     transcribeModelHint: 'Speech-to-text model name',
     reorderHint: 'Drag to reorder',

package/lib/types/client/mic.js

@@ -152,6 +152,6 @@ export function TokenQuotaMic({ t, transcribe, subscribeTranscribe, getTranscrib
     if (!settings.enabled)
         return null;
     const state = transcribing ? 'busy' : recording ? 'rec' : 'idle';
-    return (_jsxs("div", { className: css.micWrap, title: error ?? t('transcribeHint'), children: [_jsx("button", { type: "button", className: `${css.micBtn}${state === 'rec' ? ` ${css.micRec}` : ''}${state === 'busy' ? ` ${css.micBusy}` : ''}${error !== null ? ` ${css.micErr}` : ''}`, disabled: transcribing, onClick: (event) => { event.stopPropagation(); onToggle(); }, onPointerDown: (event) => { event.stopPropagation(); }, "aria-pressed": recording, "aria-label": error ?? t('transcribeTitle'), children: transcribing ? '…' : '🎤' }), error !== null && _jsx("span", { className: css.micErrTip, children: error })] }));
+    return (_jsxs("div", { className: css.micWrap, "data-token-quota-mic": "", title: error ?? t('transcribeHint'), children: [_jsx("button", { type: "button", className: `${css.micBtn}${state === 'rec' ? ` ${css.micRec}` : ''}${state === 'busy' ? ` ${css.micBusy}` : ''}${error !== null ? ` ${css.micErr}` : ''}`, disabled: transcribing, onClick: (event) => { event.stopPropagation(); onToggle(); }, onPointerDown: (event) => { event.stopPropagation(); }, "aria-pressed": recording, "aria-label": error ?? t('transcribeTitle'), children: transcribing ? '…' : '🎤' }), error !== null && _jsx("span", { className: css.micErrTip, children: error })] }));
 }
 //# sourceMappingURL=mic.js.map