better-dsh 0.2.3 → 0.2.4-b

package/lib/client/index.js

@@ -27,6 +27,8 @@ let react = require("react");
 react = __toESM(react);
 let react_jsx_runtime = require("react/jsx-runtime");
 react_jsx_runtime = __toESM(react_jsx_runtime);
+let __deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+__deepseek_ai_dsh_client_ui_primitives = __toESM(__deepseek_ai_dsh_client_ui_primitives);
 
 //#region src/failover/config.ts
 /**
@@ -69,22 +71,21 @@ const zh = {
 };
 
 //#endregion
-//#region \0dsh-css:/home/u1/workspaces/dashr/dashr/src/failover/client/FailoverRow.module.css.mjs
-const css = "._440e1d7b_row {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px 0;\n}\n\n._9865b509_title {\n  font-weight: 600;\n  font-size: 14px;\n}\n\n._3cfec826_slots {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n._70954771_slot {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n\n._ba1fd839_slotLabel {\n  min-width: 88px;\n  flex-shrink: 0;\n  font-size: 13px;\n  color: var(--dsw-alias-text-secondary, #666);\n}\n\n._11c2662d_select {\n  flex: 1;\n  max-width: 280px;\n  min-width: 0;\n}\n\n._b7c358f9_alert {\n  color: var(--dsw-alias-danger, #c0392b);\n  font-size: 12px;\n}\n";
-const tagId = "better-dsh/FailoverRow.module.css";
-if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+//#region \0dsh-css:/home/u1/workspaces/dashr/.worktrees/remote-framework/better-dsh/src/failover/client/FailoverRow.module.css.mjs
+const css$1 = "\n._440e1d7b_row {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 12px 0;\n}\n\n._a4f2ceec_rowText {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n\n._9865b509_title {\n  font-weight: 600;\n  font-size: 14px;\n}\n\n\n._3cfec826_slots {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n  gap: 6px;\n}\n\n._11c2662d_select {\n  width: 280px;\n  max-width: 100%;\n  min-width: 0;\n}\n\n._b7c358f9_alert {\n  color: var(--dsw-alias-danger, #c0392b);\n  font-size: 12px;\n}\n";
+const tagId$1 = "better-dsh/FailoverRow.module.css";
+if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 	const tag = document.createElement("style");
 	tag.dataset.plugin = "better-dsh";
-	tag.dataset.pluginCss = tagId;
-	tag.textContent = css;
+	tag.dataset.pluginCss = tagId$1;
+	tag.textContent = css$1;
 	document.head.appendChild(tag);
 }
 var FailoverRow_module_css_default = {
 	"row": "_440e1d7b_row",
+	"rowText": "_a4f2ceec_rowText",
 	"title": "_9865b509_title",
 	"slots": "_3cfec826_slots",
-	"slot": "_70954771_slot",
-	"slotLabel": "_ba1fd839_slotLabel",
 	"select": "_11c2662d_select",
 	"alert": "_b7c358f9_alert"
 };
@@ -139,60 +140,51 @@ function FailoverRow({ catalog, loadConfig, save, t }) {
 		}
 	};
 	const routes = loaded?.routes ?? [];
-	const renderSelect = (slot, label) => {
+	const renderSelect = (slot) => {
 		const value = loaded?.config[slot] ?? "";
-		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: FailoverRow_module_css_default.slot,
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				className: FailoverRow_module_css_default.slotLabel,
-				children: label
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
-				className: FailoverRow_module_css_default.select,
-				value,
-				disabled: saving || loaded === null,
-				onChange: (event) => {
-					select(slot, event.target.value);
-				},
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-					value: "",
-					children: t("not-set")
-				}), routes.map((route) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-					value: route,
-					children: route
-				}, route))]
-			})]
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+			className: FailoverRow_module_css_default.select,
+			value,
+			disabled: saving || loaded === null,
+			onChange: (event) => {
+				select(slot, event.target.value);
+			},
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+				value: "",
+				children: t("not-set")
+			}), routes.map((route) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+				value: route,
+				children: route
+			}, route))]
 		});
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: FailoverRow_module_css_default.row,
-		children: [
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: FailoverRow_module_css_default.rowText,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: FailoverRow_module_css_default.title,
 				children: t("title")
-			}),
-			error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			}), error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: FailoverRow_module_css_default.alert,
 				role: "alert",
 				children: t("error", { message: error })
-			}) : null,
-			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: FailoverRow_module_css_default.slots,
-				children: [renderSelect("fallback1", t("fallback1")), renderSelect("fallback2", t("fallback2"))]
-			})
-		]
+			}) : null]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: FailoverRow_module_css_default.slots,
+			children: [renderSelect("fallback1"), renderSelect("fallback2")]
+		})]
 	});
 }
 
 //#endregion
 //#region src/mobile/gesture.ts
-/**
-* Resolved defaults — the `1706b81` constants (120 / viewport÷4 / 40 / 1.3 /
-* 768) plus the one addition, the velocity gate. A slow text-selection drag
-* runs ~0.13 px/ms; 0.15 px/ms filters those while any comfortable sweep
-* (0.4 px/ms and up) passes.
+/** Resolved defaults — the `1706b81` constants (120 / viewport÷4 / 40 / 1.3)
+* plus the one addition, the velocity gate. A slow text-selection drag runs
+* ~0.13 px/ms; 0.15 px/ms filters those while any comfortable sweep (0.4
+* px/ms and up) passes.
 */
 const DEFAULT_SWIPE_THRESHOLDS = {
-	breakpoint: 768,
 	swipeDistancePx: 40,
 	dominanceRatio: 1.3,
 	leftEdgeBandPx: 120,
@@ -200,16 +192,6 @@ const DEFAULT_SWIPE_THRESHOLDS = {
 	swipeVelocityPxPerMs: .15
 };
 /**
-* Whether one completed gesture's viewport is in the gesture band.
-*
-* @param viewportWidth - viewport width at gesture time (px).
-* @param thresholds - resolved recognition thresholds (`.breakpoint`).
-* @returns `true` when `viewportWidth` is strictly below the breakpoint.
-*/
-function isNarrowViewport(viewportWidth, thresholds) {
-	return viewportWidth < thresholds.breakpoint;
-}
-/**
 * Whether a pointerdown may START a gesture — the source's pointerdown
 * gate, verbatim: with both panels closed, only the left band (X120) or
 * the right three quarters of the screen admit; with a panel open, any
@@ -275,7 +257,6 @@ function resolveMobileConfig(pageConfig) {
 	const v = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
 	return {
 		enabled: true,
-		breakpoint: n(pageConfig.breakpoint, DEFAULT_SWIPE_THRESHOLDS.breakpoint),
 		swipeDistancePx: n(pageConfig.swipeDistancePx, DEFAULT_SWIPE_THRESHOLDS.swipeDistancePx),
 		dominanceRatio: n(pageConfig.dominanceRatio, DEFAULT_SWIPE_THRESHOLDS.dominanceRatio),
 		leftEdgeBandPx: n(pageConfig.leftEdgeBandPx, DEFAULT_SWIPE_THRESHOLDS.leftEdgeBandPx),
@@ -291,19 +272,32 @@ function readLeftCollapsed() {
 	return document.querySelector("[data-sidebar-collapsed]") !== null;
 }
 /**
-* Better Sidebar's right-panel state, live off the body attribute the
-* plugin itself publishes (collapsed = closed). Read SYNCHRONOUSLY in the
-* handlers — a cached mirror lags the panel's own DOM write by a render,
-* and a close-swipe issued right after an open-swipe would misroute.
+* The OFFICIAL right sidebar's state (0.1.5 ui-sidebar-right), read from
+* AppFrame's TWO presentation facets, synchronously (a cached mirror lags
+* the panel's own DOM write by a render, and a close-swipe issued right
+* after an open-swipe would misroute):
+*
+* - `[data-rightbar-collapsed]` — the reserved GRID TRACK facet (present =
+*   zero-width right column). On phones (<768) the panel presents FULLSCREEN
+*   WITHOUT a track (`autoFullscreen` in SidebarRight), so this attribute
+*   alone misreads a panel that covers the whole frame as "closed" — the
+*   2026-09-11 field bug: every close-swipe misrouted to open-left.
+* - `[data-rightbar-fullscreen]` — the overlay facet (present = fullscreen
+*   presentation active, open by definition).
+*
+* Open = track reserved OR fullscreen overlay. On hosts before 0.1.5 both
+* attributes never appear: closed, permanently — left gestures unaffected.
 */
 function readRightOpen() {
-	return !document.body.hasAttribute("data-dsh-sidebar-collapsed");
+	const fullscreen = document.querySelector("[data-rightbar-fullscreen]") !== null;
+	const trackless = document.querySelector("[data-rightbar-collapsed]") !== null;
+	return fullscreen || !trackless;
 }
 /**
 * Whether a session is current — the plugin-side stand-in for the source's
-* `detailsSession !== undefined` guard (the right panel opens in a session
-* only). Better Sidebar's own shipped CSS keys off the same slot selector,
-* so it is load-bearing beyond this feature.
+* `detailsSession !== undefined` guard (the right panel is a
+* session-scoped surface; without a session its expand button is not
+* rendered, so opening would be a no-op anyway).
 */
 function readSessionLive() {
 	return document.querySelector("[data-slot=\"conversation.session.header\"]") !== null;
@@ -316,32 +310,38 @@ function readPanelState() {
 	};
 }
 /**
-* Toggle Better Sidebar's right panel through its persistent DOM: the
-* plugin exposes no JS toggle on its client service (its open/close
-* reducer is store-internal), so the swipe reaches it the same way the
-* source did — clicking the LAST button of its always-rendered
-* `[data-dsh-toggle-cluster]` (the bottom-panel button precedes it and is
-* absent below the plugin's 768px narrow breakpoint). Absent cluster or
-* buttons: a no-op, never a crash.
+* Drive the OFFICIAL right sidebar through its own controls (0.1.5
+* ui-sidebar-right): opening clicks `[data-sidebar-right-expand]` (the
+* conversation header corner button — the panel's own documented "way
+* into a hidden panel", rendered exactly while collapsed with a session);
+* closing clicks `[data-sidebar-right-toggle]` (the dock chrome toggle).
+* The store action behind them (`setExpanded`/`toggleExpanded`) is
+* slot-store-internal — cross-plugin imports are the hard boundary, so
+* the native buttons ARE the sanctioned entry. Absent button (pre-0.1.5
+* host, no session, or already in the target state): a no-op, never a
+* crash.
 */
-function toggleBetterSidebar() {
-	const buttons = document.querySelector("[data-dsh-toggle-cluster]")?.querySelectorAll("button");
-	(buttons?.[buttons.length - 1])?.click();
+function openRightPanel() {
+	document.querySelector("[data-sidebar-right-expand]")?.click();
+}
+function closeRightPanel() {
+	document.querySelector("[data-sidebar-right-toggle]")?.click();
 }
 /**
-* The narrow-viewport CSS: zero-width sidebar track under the breakpoint,
-* keyed to AppFrame's semantic attribute (survives class-hash churn).
-* Rendered with the breakpoint baked in (media queries cannot read JS
-* config); the tag carries the plugin-owned dataset so the loader's
-* style-claim machinery removes it on unload, like module CSS.
+* The responsive CSS: zero-width sidebar track whenever upstream's layout
+* has collapsed the sidebar, keyed PURELY to AppFrame's semantic
+* attribute (survives class-hash churn). No width media query of our own
+* (2026-09-11 ruling): upstream owns the auto-collapse threshold (1024
+* today), and this rule simply takes the 56px rail they leave behind to
+* zero. If upstream renames the attribute the rule stops matching and
+* their native rail renders (benign degradation). The tag carries the
+* plugin-owned dataset so the loader's style-claim machinery removes it
+* on unload, like module CSS.
 */
-function mobileCss(breakpointPx) {
-	const wide = Math.max(1, Math.floor(breakpointPx) - .02);
+function mobileCss() {
 	return [
-		`@media (max-width: ${String(wide)}px) {`,
-		`  [data-sidebar-collapsed] {`,
-		`    grid-template-columns: 0px minmax(0, 1fr) 0px !important;`,
-		`  }`,
+		`[data-sidebar-collapsed] {`,
+		`  grid-template-columns: 0px minmax(0, 1fr) 0px !important;`,
 		`}`
 	].join("\n");
 }
@@ -361,7 +361,7 @@ function setupMobileLayout(ctx) {
 		const tag = document.createElement("style");
 		tag.dataset.plugin = "better-dsh";
 		tag.dataset.pluginCss = styleTagId;
-		tag.textContent = mobileCss(config.breakpoint);
+		tag.textContent = mobileCss();
 		document.head.append(tag);
 		const offLayout = ctx.inject(["layout"], (layoutCtx) => {
 			const layout = layoutCtx.get("layout");
@@ -370,8 +370,10 @@ function setupMobileLayout(ctx) {
 			const onPointerDown = (event) => {
 				start = void 0;
 				const viewport = window.innerWidth;
-				if (!isNarrowViewport(viewport, config)) return;
-				if (!admitsSwipeStart(event.clientX, viewport, readPanelState(), config)) return;
+				const coarsePointer = window.matchMedia?.("(pointer: coarse)").matches === true;
+				const panels = readPanelState();
+				if (!coarsePointer && !panels.leftCollapsed && !panels.rightOpen) return;
+				if (!admitsSwipeStart(event.clientX, viewport, panels, config)) return;
 				start = {
 					x: event.clientX,
 					y: event.clientY,
@@ -389,7 +391,8 @@ function setupMobileLayout(ctx) {
 				if (action === null) return;
 				start = void 0;
 				if (action === "open-left" || action === "close-left") layout.toggleSidebar();
-				else toggleBetterSidebar();
+				else if (action === "open-right") openRightPanel();
+				else closeRightPanel();
 			};
 			const onPointerEnd = () => {
 				start = void 0;
@@ -412,6 +415,241 @@ function setupMobileLayout(ctx) {
 	}, "dashr: mobile layout");
 }
 
+//#endregion
+//#region src/compaction/config.ts
+/**
+* The `compaction-tuning` General-row config: the share of the routed context
+* window at which automatic condensation starts.
+*
+* Pure module — no `@deepseek-ai/*` value imports — so the host half and the
+* client half may both import it without dragging either runtime into the
+* browser bundle: the host takes the namespace and the schema defaults, the
+* client takes the namespace literal plus the stepper bounds.
+*
+* @module dashr/compaction/config
+*/
+/** The settings namespace the General row reads and writes. */
+const COMPACTION_SETTINGS_NS = "compaction-tuning";
+/** Upstream `compaction-basic`'s own default: condense at 80% of the window. */
+const DEFAULT_THRESHOLD_RATIO = .8;
+/** Whole-percent bounds for the General row's stepper. */
+const THRESHOLD_MIN_PERCENT = 10;
+/** @see THRESHOLD_MIN_PERCENT */
+const THRESHOLD_MAX_PERCENT = 95;
+/** Percent moved per arrow click (a stepper cannot express an arbitrary value). */
+const THRESHOLD_STEP_PERCENT = 5;
+
+//#endregion
+//#region src/compaction/client/locales.ts
+/**
+* Client locale dictionary for the compaction General row.
+* @module dashr/compaction/client/locales
+*/
+const en$1 = {
+	"title": "Auto-compact threshold",
+	"description": "Only affects automatic condensation",
+	"unit": "%",
+	"increase": "Increase auto-compact threshold",
+	"decrease": "Decrease auto-compact threshold",
+	"error": "Save failed: {{message}}"
+};
+const zh$1 = {
+	"title": "自动压缩阈值",
+	"description": "仅影响自动压缩",
+	"unit": "%",
+	"increase": "提高自动压缩阈值",
+	"decrease": "降低自动压缩阈值",
+	"error": "保存失败：{{message}}"
+};
+
+//#endregion
+//#region \0dsh-css:/home/u1/workspaces/dashr/.worktrees/remote-framework/better-dsh/src/compaction/client/CompactionRow.module.css.mjs
+const css = "\n\n\n._13e3747c_thresholdRow {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 16px 0;\n  border-bottom: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n._8ad3ff3f_thresholdText {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding-right: 48px;\n}\n\n._9ffb627e_thresholdTitle {\n  font-size: 14px;\n  font-weight: 400;\n  line-height: 22px;\n  color: var(--dsw-alias-label-primary);\n}\n\n._01bea389_thresholdDesc {\n  font-size: 12px;\n  font-weight: 400;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n._7f9578de_thresholdError {\n  font-size: 12px;\n  font-weight: 400;\n  line-height: 18px;\n  color: var(--dsw-alias-danger, #c0392b);\n}\n\n\n._cddd78cd_thresholdControl {\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n}\n\n._6058fea9_thresholdStepper {\n  position: relative; \n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  min-width: 72px;\n  height: 36px;\n  border-radius: 18px;\n  background: var(--dsw-alias-bg-module-platform);\n}\n\n._39d30469_thresholdValue {\n  min-width: 18px;\n  text-align: center;\n  font-size: 14px;\n  line-height: 22px;\n  font-variant-numeric: tabular-nums;\n  color: var(--dsw-alias-label-primary);\n}\n\n._68bd35c6_thresholdUnit {\n  font-size: 14px;\n  line-height: 22px;\n  color: var(--dsw-alias-label-secondary);\n}\n\n\n._904da366_thresholdArrows {\n  position: absolute;\n  right: 8px;\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  opacity: 0;\n}\n\n._6058fea9_thresholdStepper:hover ._904da366_thresholdArrows,\n._6058fea9_thresholdStepper:focus-within ._904da366_thresholdArrows {\n  opacity: 1;\n}\n\n\n._ae9106b1_thresholdArrow {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 17px;\n  height: 12px;\n  padding: 0;\n  border: none;\n  border-radius: 3px;\n  background: color-mix(in srgb, var(--dsw-alias-bg-layer-1) 75%, transparent);\n  color: var(--dsw-alias-label-primary);\n  cursor: pointer;\n}\n\n._ae9106b1_thresholdArrow:hover:not(:disabled) {\n  background: var(--dsw-alias-bg-layer-1);\n}\n\n._ae9106b1_thresholdArrow:disabled {\n  color: var(--dsw-alias-label-caption);\n  cursor: default;\n}\n";
+const tagId = "better-dsh/CompactionRow.module.css";
+if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+	const tag = document.createElement("style");
+	tag.dataset.plugin = "better-dsh";
+	tag.dataset.pluginCss = tagId;
+	tag.textContent = css;
+	document.head.appendChild(tag);
+}
+var CompactionRow_module_css_default = {
+	"thresholdRow": "_13e3747c_thresholdRow",
+	"thresholdText": "_8ad3ff3f_thresholdText",
+	"thresholdTitle": "_9ffb627e_thresholdTitle",
+	"thresholdDesc": "_01bea389_thresholdDesc",
+	"thresholdError": "_7f9578de_thresholdError",
+	"thresholdControl": "_cddd78cd_thresholdControl",
+	"thresholdStepper": "_6058fea9_thresholdStepper",
+	"thresholdValue": "_39d30469_thresholdValue",
+	"thresholdUnit": "_68bd35c6_thresholdUnit",
+	"thresholdArrows": "_904da366_thresholdArrows",
+	"thresholdArrow": "_ae9106b1_thresholdArrow"
+};
+
+//#endregion
+//#region src/compaction/client/CompactionRow.tsx
+/** Render the compaction-threshold row. */
+function CompactionRow({ t, loadConfig, save }) {
+	const [percent, setPercent] = (0, react.useState)(null);
+	const [absent, setAbsent] = (0, react.useState)(false);
+	const [error, setError] = (0, react.useState)(null);
+	const revisionRef = (0, react.useRef)(void 0);
+	const pendingRef = (0, react.useRef)(null);
+	const inFlightRef = (0, react.useRef)(false);
+	(0, react.useEffect)(() => {
+		let alive = true;
+		(async () => {
+			try {
+				const current = await loadConfig();
+				if (!alive) return;
+				if (current === null) {
+					setAbsent(true);
+					return;
+				}
+				revisionRef.current = current.revision;
+				setPercent(Math.round(current.thresholdRatio * 100));
+			} catch (err) {
+				if (alive) setError(err instanceof Error ? err.message : String(err));
+			}
+		})();
+		return () => {
+			alive = false;
+		};
+	}, [loadConfig]);
+	/** Write the newest pending step; the revision always comes from the last commit. */
+	const flush = () => {
+		if (inFlightRef.current || pendingRef.current === null) return;
+		const next = pendingRef.current;
+		pendingRef.current = null;
+		inFlightRef.current = true;
+		save({ thresholdRatio: next / 100 }, revisionRef.current).then((revision) => {
+			revisionRef.current = revision;
+			inFlightRef.current = false;
+			setError(null);
+			flush();
+		}, (err) => {
+			inFlightRef.current = false;
+			pendingRef.current = null;
+			setError(err instanceof Error ? err.message : String(err));
+			(async () => {
+				try {
+					const current = await loadConfig();
+					if (current === null) return;
+					revisionRef.current = current.revision;
+					setPercent(Math.round(current.thresholdRatio * 100));
+				} catch {}
+			})();
+		});
+	};
+	const step = (delta) => {
+		if (percent === null) return;
+		const next = Math.min(THRESHOLD_MAX_PERCENT, Math.max(THRESHOLD_MIN_PERCENT, percent + delta));
+		if (next === percent) return;
+		setPercent(next);
+		setError(null);
+		pendingRef.current = next;
+		flush();
+	};
+	if (absent) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: CompactionRow_module_css_default.thresholdRow,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: CompactionRow_module_css_default.thresholdText,
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: CompactionRow_module_css_default.thresholdTitle,
+					children: t("title")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: CompactionRow_module_css_default.thresholdDesc,
+					children: t("description")
+				}),
+				error !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: CompactionRow_module_css_default.thresholdError,
+					children: t("error", { message: error })
+				}) : null
+			]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: CompactionRow_module_css_default.thresholdControl,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: CompactionRow_module_css_default.thresholdStepper,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: CompactionRow_module_css_default.thresholdValue,
+					children: percent === null ? "–" : String(percent)
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: CompactionRow_module_css_default.thresholdArrows,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: CompactionRow_module_css_default.thresholdArrow,
+						"aria-label": t("increase"),
+						disabled: percent === null || percent >= THRESHOLD_MAX_PERCENT,
+						onClick: () => {
+							step(THRESHOLD_STEP_PERCENT);
+						},
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.IconChevronUpOutline14, { size: 9 })
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: CompactionRow_module_css_default.thresholdArrow,
+						"aria-label": t("decrease"),
+						disabled: percent === null || percent <= THRESHOLD_MIN_PERCENT,
+						onClick: () => {
+							step(-THRESHOLD_STEP_PERCENT);
+						},
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { size: 9 })
+					})]
+				})]
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: CompactionRow_module_css_default.thresholdUnit,
+				children: t("unit")
+			})]
+		})]
+	});
+}
+
+//#endregion
+//#region src/compaction/client/index.ts
+/**
+* Register the dictionaries and the General settings row.
+*
+* Called from the plugin's client entry, which already injects `locale`,
+* `slots` and `remote.settings`.
+*
+* @param ctx - client root context.
+*/
+function setupCompactionRow(ctx) {
+	ctx.effect(() => ctx.locale.register(COMPACTION_SETTINGS_NS, {
+		zh: zh$1,
+		en: en$1
+	}), "compaction-tuning: dictionaries");
+	ctx.slots.inject("settings.general.item", function* () {
+		yield ctx.slots.register({
+			name: "settings.general.item",
+			id: COMPACTION_SETTINGS_NS,
+			order: 110,
+			locale: COMPACTION_SETTINGS_NS,
+			inject: () => ({
+				loadConfig: async () => {
+					const response = await ctx.remote.settings.describe();
+					if (!response.ok) throw new Error(`${response.error.code}: ${response.error.message}`);
+					const view = response.value.namespaces.find((entry) => entry.ns === COMPACTION_SETTINGS_NS);
+					if (view === void 0) return null;
+					const value = view.value;
+					return {
+						thresholdRatio: typeof value.thresholdRatio === "number" ? value.thresholdRatio : DEFAULT_THRESHOLD_RATIO,
+						revision: view.revision
+					};
+				},
+				save: async (patch, revision) => {
+					const response = await ctx.remote.settings.update(COMPACTION_SETTINGS_NS, patch, revision);
+					if (!response.ok) throw new Error(`${response.error.code}: ${response.error.message}`);
+					return response.value.revision;
+				}
+			})
+		}, CompactionRow);
+	});
+}
+
 //#endregion
 //#region src/failover/client/index.ts
 /** Required services (cordis fiber inject). */
@@ -432,6 +670,7 @@ function apply(ctx) {
 		en
 	}), "llm-failover: dictionaries");
 	setupMobileLayout(ctx);
+	setupCompactionRow(ctx);
 	ctx.slots.inject("settings.general.item", function* () {
 		yield ctx.slots.register({
 			name: "settings.general.item",

package/lib/compaction/index.d.ts

@@ -0,0 +1,47 @@
+import { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+
+//#region src/compaction/config.d.ts
+
+/** The `compaction-tuning` settings value. */
+interface CompactionTuningConfig {
+  /** Condense at `floor(routedContextWindow x thresholdRatio)`. */
+  thresholdRatio: number;
+  /** Verbatim recent tail, in estimated tokens. */
+  retainTokens: number;
+}
+//#endregion
+//#region src/compaction/index.d.ts
+
+/** Cordis plugin name. */
+declare const name = "dashr-compaction-tuning";
+/**
+ * No static injects: both `settings` and `compaction` are composed
+ * conditionally inside {@link installCompactionTuning}, so the row loads
+ * (dormant) in compositions without them.
+ */
+declare const inject: string[];
+/**
+ * The `compaction-tuning` settings schema.
+ *
+ * `thresholdRatio` is the field the General row drives; `retainTokens` is
+ * composition-only (see {@link DEFAULT_RETAIN_TOKENS}) but still validated and
+ * applied, so the recency window keeps one source of truth.
+ */
+declare const Config: z<CompactionTuningConfig>;
+/**
+ * Install the settings namespace and keep the live compaction engine in sync.
+ * @param ctx - host context of the row that owns this capability.
+ * @param config - composition base layer; schema defaults fill the rest.
+ */
+declare function installCompactionTuning(ctx: Context, config?: CompactionTuningConfig): void;
+/** Mount the tuning as the row's whole apply (the row config is the settings base). */
+declare function apply(ctx: Context, config: CompactionTuningConfig | undefined): void;
+declare const _default: {
+  name: string;
+  inject: string[];
+  Config: z<CompactionTuningConfig>;
+  apply: typeof apply;
+};
+//#endregion
+export { Config, apply, _default as default, inject, installCompactionTuning, name };