@khorsheed/dsh-context-guard 0.1.0

package/lib/client.js

@@ -0,0 +1,461 @@
+window.__ModuleLoader__.load({
+	id: "@khorsheed/dsh-context-guard",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region src/namespace.ts
+		/**
+		* The settings namespace owned by the context-guard plugin. Plain string so
+		* both the host half (settings registration) and the browser half
+		* (settingsScope binding and the settings.plugin.item card key) import it
+		* without dragging host-only dependencies into the client bundle.
+		*/
+		/** Settings namespace owned by the context-guard plugin. */
+		const CONTEXT_GUARD_NS = "context-guard";
+		//#endregion
+		//#region src/client/config.ts
+		/** Bounds of the deployment-tunable number (clamped in resolveConfig). */
+		const THRESHOLD_RATIO_MIN = .01;
+		const THRESHOLD_RATIO_MAX = 1;
+		function clamp(value, min, max) {
+			return Math.min(max, Math.max(min, value));
+		}
+		/**
+		* Normalize the entry config into the full {@link ContextGuardConfig}: every
+		* omitted field takes its documented default and every numeric field is
+		* clamped into its legal range.
+		* @param config - the unvalidated entry config, when the runner passes one.
+		* @returns the effective guard behavior.
+		*/
+		function resolveConfig(config) {
+			return { thresholdRatio: clamp(config?.thresholdRatio ?? .8, THRESHOLD_RATIO_MIN, THRESHOLD_RATIO_MAX) };
+		}
+		//#endregion
+		//#region src/client/locales.ts
+		/** `context-guard` namespace dictionaries. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"button.label": "压缩",
+			"button.aria": "上下文已用 {percent}%，点击压缩历史",
+			"button.error": "压缩未执行",
+			"settings.title": "压缩提醒时机",
+			"settings.description": "上下文占用达到设定比例时，输入框出现压缩按钮",
+			"settings.expand": "展开",
+			"settings.collapse": "收起",
+			"settings.field.threshold": "提醒比例",
+			"settings.field.threshold.hint": "上下文占用达到窗口的该比例时显示压缩按钮；可配置范围 0.01–1，按自己的偏好调整即可",
+			"settings.overridden": "已自定义",
+			"settings.reset": "重置",
+			"settings.save": "保存",
+			"settings.discard": "放弃",
+			"settings.saved": "已保存",
+			"settings.error": "保存失败，请重试"
+		};
+		/** The dictionary namespace owned by this plugin. */
+		const NS = "context-guard";
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"button.label": "compact",
+			"button.aria": "Context at {percent}%, click to compact history",
+			"button.error": "Compaction was not executed",
+			"settings.title": "Compaction reminder timing",
+			"settings.description": "Shows the compact button in the composer once context occupancy reaches the configured fraction",
+			"settings.expand": "Expand",
+			"settings.collapse": "Collapse",
+			"settings.field.threshold": "Reminder ratio",
+			"settings.field.threshold.hint": "Show the compact button once context occupancy reaches this fraction of the window; configurable from 0.01 to 1 — tune it to your preference",
+			"settings.overridden": "Overridden",
+			"settings.reset": "Reset",
+			"settings.save": "Save",
+			"settings.discard": "Discard",
+			"settings.saved": "Saved",
+			"settings.error": "Save failed, please retry"
+		};
+		//#endregion
+		//#region src/client/guard.ts
+		/**
+		* Decide the guard level for one request budget.
+		*
+		* `overdue` means the occupancy already reached the whole window — the
+		* provider will have rejected requests before this point, so it is a
+		* defensive floor rather than a reachable state.
+		*
+		* @param input - the projection figures plus config.
+		* @returns the reading, or null when either the window or the context is unknown.
+		*/
+		function guardReading(input) {
+			const { contextWindow, projectedTokens, thresholdRatio } = input;
+			if (contextWindow === void 0 || !Number.isFinite(contextWindow) || contextWindow <= 0) return null;
+			if (!Number.isFinite(projectedTokens) || projectedTokens < 0) return null;
+			const ratio = projectedTokens / contextWindow;
+			return {
+				level: ratio >= 1 ? "overdue" : ratio >= thresholdRatio ? "warning" : "ok",
+				percent: Math.min(100, Math.round(ratio * 100)),
+				contextWindow
+			};
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/zhuyudan/code/dsh-plugins/packages/context-guard/src/client/CompactGuardButton.module.css.mjs
+		const css$1 = ".BFFw2a_wrap{align-items:center;gap:6px;display:inline-flex}.BFFw2a_button{cursor:pointer;border:none;border-radius:999px;align-items:center;gap:4px;padding:2px 8px;font-size:13px;font-weight:500;line-height:20px;display:inline-flex}.BFFw2a_button:focus-visible{outline-offset:2px;outline:2px solid}.BFFw2a_button:disabled{opacity:.6;cursor:default}.BFFw2a_icon{color:currentColor;align-items:center;display:inline-flex}.BFFw2a_warning{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label)}.BFFw2a_warning:hover:not(:disabled){color:var(--dsw-alias-state-warn-primary)}.BFFw2a_error{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px}";
+		const tagId$1 = "@khorsheed/dsh-context-guard/CompactGuardButton.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 = "@khorsheed/dsh-context-guard";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var CompactGuardButton_module_css_default = {
+			"wrap": "BFFw2a_wrap",
+			"button": "BFFw2a_button",
+			"warning": "BFFw2a_warning",
+			"error": "BFFw2a_error",
+			"icon": "BFFw2a_icon"
+		};
+		//#endregion
+		//#region src/client/CompactGuardButton.tsx
+		/**
+		* Composer-tool-row compact button. Renders nothing until the context
+		* occupancy (`projectedTokens / contextWindow` — the same number the
+		* composer's context ring shows) crosses the threshold; then it appears
+		* automatically in the amber warning tint. The threshold comes from the
+		* shared `context-guard` settings section (live), falling back to the
+		* composition-time value while the settings surface is absent. Clicking
+		* executes the official `/compact` command through the injected face.
+		*/
+		function CompactGuardButton({ useProjection, useConfig, t, thresholdRatio, compactNow }) {
+			const pressure = useProjection("contextPressure");
+			const config = useConfig((value) => value);
+			const effective = config.status === "ready" && config.value !== void 0 ? config.value : { thresholdRatio };
+			const reading = (0, react.useMemo)(() => guardReading({
+				projectedTokens: pressure?.projectedTokens ?? pressure?.pressureTokens ?? NaN,
+				contextWindow: pressure?.contextWindow,
+				thresholdRatio: effective.thresholdRatio
+			}), [pressure, effective.thresholdRatio]);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(null);
+			const aliveRef = (0, react.useRef)(true);
+			(0, react.useEffect)(() => {
+				aliveRef.current = true;
+				return () => {
+					aliveRef.current = false;
+				};
+			}, []);
+			if (reading === null || reading.level === "ok") return null;
+			const run = () => {
+				setBusy(true);
+				setError(null);
+				compactNow().then((failure) => {
+					if (!aliveRef.current) return;
+					setBusy(false);
+					setError(failure);
+				}, (reason) => {
+					if (!aliveRef.current) return;
+					setBusy(false);
+					setError(reason instanceof Error ? reason.message : String(reason));
+				});
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				className: CompactGuardButton_module_css_default.wrap,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: `${CompactGuardButton_module_css_default.button} ${CompactGuardButton_module_css_default.warning}`,
+					"aria-label": t("button.aria", { percent: String(reading.percent) }),
+					disabled: busy,
+					onClick: run,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: CompactGuardButton_module_css_default.icon,
+						"aria-hidden": true,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, { size: 14 })
+					}), t("button.label")]
+				}), error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: CompactGuardButton_module_css_default.error,
+					role: "status",
+					title: error,
+					children: t("button.error")
+				})]
+			});
+		}
+		//#endregion
+		//#region \0dsh-css:/Users/zhuyudan/code/dsh-plugins/packages/context-guard/src/client/SettingsCard.module.css.mjs
+		const css = ".DKjZXq_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}.DKjZXq_card:hover{border-color:var(--dsw-alias-label-dimmed)}.DKjZXq_cardOpen{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}.DKjZXq_header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}.DKjZXq_header:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-2px}.DKjZXq_headText{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}.DKjZXq_name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}.DKjZXq_description{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}.DKjZXq_chevron{color:var(--dsw-alias-label-tertiary);flex:none;transition:transform .16s}.DKjZXq_chevronOpen{transform:rotate(180deg)}.DKjZXq_body{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:12px;margin:0 16px;padding:12px 0 8px;display:flex}.DKjZXq_field{flex-direction:column;gap:6px;display:flex}.DKjZXq_fieldHead{align-items:center;gap:8px;display:flex}.DKjZXq_fieldName{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:500;line-height:1.4}.DKjZXq_badge{background:var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label);border-radius:999px;padding:2px 6px;font-size:11px;line-height:1}.DKjZXq_inputRow{align-items:center;gap:8px;display:flex}.DKjZXq_input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);width:140px;color:var(--dsw-alias-label-primary);border-radius:8px;padding:4px 8px;font-size:13px;line-height:1.4}.DKjZXq_input:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:-1px}.DKjZXq_inputInvalid{border-color:var(--dsw-alias-state-error-primary)}.DKjZXq_reset{appearance:none;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;padding:2px 6px;font-size:12px;line-height:1.4}.DKjZXq_reset:hover{color:var(--dsw-alias-label-primary)}.DKjZXq_hint{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.5}.DKjZXq_footer{justify-content:flex-end;align-items:center;gap:8px;margin-top:4px;display:flex}.DKjZXq_status{flex:1;min-width:0}.DKjZXq_saved{color:var(--dsw-alias-state-success-primary);font-size:12px}.DKjZXq_errorText{color:var(--dsw-alias-state-error-primary);font-size:12px}.DKjZXq_secondary,.DKjZXq_save{appearance:none;border:1px solid var(--dsw-alias-border-l2);cursor:pointer;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:8px;padding:4px 12px;font-size:13px;line-height:1.4}.DKjZXq_secondary:disabled,.DKjZXq_save:disabled{opacity:.5;cursor:default}.DKjZXq_save{background:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-primary-foreground);border-color:#0000}.DKjZXq_save:hover:not(:disabled){filter:brightness(.95)}";
+		const tagId = "@khorsheed/dsh-context-guard/SettingsCard.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@khorsheed/dsh-context-guard";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var SettingsCard_module_css_default = {
+			"hint": "DKjZXq_hint",
+			"cardOpen": "DKjZXq_cardOpen",
+			"save": "DKjZXq_save",
+			"secondary": "DKjZXq_secondary",
+			"description": "DKjZXq_description",
+			"fieldName": "DKjZXq_fieldName",
+			"header": "DKjZXq_header",
+			"fieldHead": "DKjZXq_fieldHead",
+			"inputInvalid": "DKjZXq_inputInvalid",
+			"name": "DKjZXq_name",
+			"chevron": "DKjZXq_chevron",
+			"chevronOpen": "DKjZXq_chevronOpen",
+			"status": "DKjZXq_status",
+			"card": "DKjZXq_card",
+			"saved": "DKjZXq_saved",
+			"body": "DKjZXq_body",
+			"headText": "DKjZXq_headText",
+			"inputRow": "DKjZXq_inputRow",
+			"input": "DKjZXq_input",
+			"reset": "DKjZXq_reset",
+			"badge": "DKjZXq_badge",
+			"footer": "DKjZXq_footer",
+			"errorText": "DKjZXq_errorText",
+			"field": "DKjZXq_field"
+		};
+		//#endregion
+		//#region src/client/SettingsCard.tsx
+		/** Parse a draft into a number, or NaN when it is not one. */
+		function parseNumber(text) {
+			const value = Number(text.trim());
+			return Number.isFinite(value) ? value : NaN;
+		}
+		/** Whether the user layer carries a field (presence marks an override). */
+		function overridden(snapshot, field) {
+			return snapshot.user !== void 0 && typeof snapshot.user === "object" && snapshot.user !== null && field in snapshot.user;
+		}
+		/**
+		* The context-guard settings card in the plugin configuration tab: the same
+		* collapsible chrome the official plugin cards use (a header naming the
+		* plugin and what its settings govern, disclosing the controls in place),
+		* re-implemented here because the client bundle-purity gate forbids
+		* value-importing the official card chrome. Two staged number fields write
+		* through the shared settingsScope on save; per-field reset reverts a field
+		* to the composition layer.
+		*/
+		function ContextGuardSettingsCard({ useConfig, scope, t }) {
+			const snapshot = useConfig((value) => value);
+			const value = snapshot.status === "ready" ? snapshot.value : void 0;
+			const [open, setOpen] = (0, react.useState)(false);
+			const [threshold, setThreshold] = (0, react.useState)({
+				text: "",
+				invalid: false
+			});
+			const [saved, setSaved] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(false);
+			const aliveRef = (0, react.useRef)(true);
+			/** The section revision the drafts were last seeded from; re-seed only on a committed change. */
+			const seededRevision = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				aliveRef.current = true;
+				if (value === void 0) return;
+				if (seededRevision.current === snapshot.revision) return;
+				seededRevision.current = snapshot.revision ?? null;
+				setThreshold({
+					text: String(value.thresholdRatio),
+					invalid: false
+				});
+				setSaved(false);
+				setError(false);
+				return () => {
+					aliveRef.current = false;
+				};
+			}, [value, snapshot.revision]);
+			if (snapshot.status === "unavailable") return null;
+			const write = (draft, min, max) => {
+				const parsed = parseNumber(draft.text);
+				setThreshold({
+					text: draft.text,
+					invalid: !Number.isFinite(parsed) || parsed < min || parsed > max
+				});
+			};
+			const save = () => {
+				if (threshold.invalid || snapshot.writable !== true) return;
+				const ratio = parseNumber(threshold.text);
+				if (!Number.isFinite(ratio)) return;
+				setError(false);
+				setSaved(false);
+				scope.set("thresholdRatio", ratio).then(() => {
+					if (!aliveRef.current) return;
+					setSaved(true);
+				}, () => {
+					if (!aliveRef.current) return;
+					setError(true);
+				});
+			};
+			const reset = () => {
+				setError(false);
+				setSaved(false);
+				scope.unset("thresholdRatio").catch(() => {
+					if (aliveRef.current) setError(true);
+				});
+			};
+			const title = t("settings.title");
+			const dirty = threshold.text !== String(value?.thresholdRatio ?? "");
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+				className: open ? `${SettingsCard_module_css_default.card} ${SettingsCard_module_css_default.cardOpen}` : SettingsCard_module_css_default.card,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: SettingsCard_module_css_default.header,
+					"aria-expanded": open,
+					"aria-label": `${t(open ? "settings.collapse" : "settings.expand")}: ${title}`,
+					onClick: () => {
+						setOpen(!open);
+					},
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: SettingsCard_module_css_default.headText,
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: SettingsCard_module_css_default.name,
+							children: title
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							className: SettingsCard_module_css_default.description,
+							children: t("settings.description")
+						})]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: open ? `${SettingsCard_module_css_default.chevron} ${SettingsCard_module_css_default.chevronOpen}` : SettingsCard_module_css_default.chevron })]
+				}), open && value !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: SettingsCard_module_css_default.body,
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+						className: SettingsCard_module_css_default.field,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: SettingsCard_module_css_default.fieldHead,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsCard_module_css_default.fieldName,
+									children: t("settings.field.threshold")
+								}), overridden(snapshot, "thresholdRatio") && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsCard_module_css_default.badge,
+									children: t("settings.overridden")
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: SettingsCard_module_css_default.inputRow,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									className: threshold.invalid ? `${SettingsCard_module_css_default.input} ${SettingsCard_module_css_default.inputInvalid}` : SettingsCard_module_css_default.input,
+									type: "number",
+									step: "0.01",
+									min: "0.01",
+									max: "1",
+									value: threshold.text,
+									"aria-label": t("settings.field.threshold"),
+									onChange: (event) => {
+										write({
+											text: event.target.value,
+											invalid: false
+										}, .01, 1);
+									}
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: SettingsCard_module_css_default.reset,
+									onClick: reset,
+									children: t("settings.reset")
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: SettingsCard_module_css_default.hint,
+								children: t("settings.field.threshold.hint")
+							})
+						]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+						className: SettingsCard_module_css_default.footer,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: SettingsCard_module_css_default.status,
+								children: [saved ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsCard_module_css_default.saved,
+									children: t("settings.saved")
+								}) : null, error ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SettingsCard_module_css_default.errorText,
+									children: t("settings.error")
+								}) : null]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: SettingsCard_module_css_default.secondary,
+								disabled: !dirty,
+								onClick: () => {
+									if (value === void 0) return;
+									setThreshold({
+										text: String(value.thresholdRatio),
+										invalid: false
+									});
+									setSaved(false);
+									setError(false);
+								},
+								children: t("settings.discard")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: SettingsCard_module_css_default.save,
+								disabled: !dirty || threshold.invalid || snapshot.writable !== true,
+								onClick: save,
+								children: t("settings.save")
+							})
+						]
+					})]
+				})]
+			});
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required services: the slot ledger, the command Remote, the settings scope, and the copy. */
+		const inject = [
+			"slots",
+			"remote",
+			"remote.commands",
+			"locale",
+			"settingsScope"
+		];
+		/**
+		* Client plugin body: register the composer-tool-row compact button and the
+		* settings card over the shared `context-guard` section.
+		* @param ctx - client root context.
+		* @param config - entry config (the section's composition base layer); defaults apply when the runner passes none.
+		*/
+		function apply(ctx, config) {
+			const fallback = resolveConfig(config);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "context-guard: dictionaries");
+			const scope = ctx.settingsScope.bind({ namespace: CONTEXT_GUARD_NS });
+			ctx.slots.inject("conversation.input.right", () => ctx.slots.register({
+				name: "conversation.input.right",
+				id: "context-guard",
+				order: -10,
+				locale: NS,
+				inject: (sessionId) => ({
+					thresholdRatio: fallback.thresholdRatio,
+					compactNow: async () => {
+						const result = await ctx.remote.commands.execute(sessionId, "/compact", []);
+						if (!result.ok) return `${result.error.message} (${result.error.code})`;
+						if (result.value === void 0) return "unknown command: /compact";
+						return null;
+					},
+					hooks: { config: scope }
+				})
+			}, CompactGuardButton));
+			ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
+				name: "settings.plugin.item",
+				key: CONTEXT_GUARD_NS,
+				locale: NS,
+				inject: () => ({
+					scope,
+					hooks: { config: scope }
+				})
+			}, ContextGuardSettingsCard));
+		}
+		//#endregion
+		exports.NS = NS;
+		exports.apply = apply;
+		exports.guardReading = guardReading;
+		exports.inject = inject;
+		exports.resolveConfig = resolveConfig;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useMemo","useState","useRef","css","IconWarningOutline16","useState","useRef","css","IconChevronDownOutline14"],"sources":["../src/namespace.ts","../src/client/config.ts","../src/client/locales.ts","../src/client/guard.ts","../src/client/CompactGuardButton.tsx","../src/client/SettingsCard.tsx","../src/client/index.ts"],"sourcesContent":["/**\n * The settings namespace owned by the context-guard plugin. Plain string so\n * both the host half (settings registration) and the browser half\n * (settingsScope binding and the settings.plugin.item card key) import it\n * without dragging host-only dependencies into the client bundle.\n */\n\n/** Settings namespace owned by the context-guard plugin. */\nexport const CONTEXT_GUARD_NS = 'context-guard'\n","/**\n * Browser-half configuration of the context-guard plugin. The runner hands\n * the plugin its validated entry config through the apply second parameter;\n * this module supplies the defaults and clamps, so a composition that does\n * not pass config still renders with the documented values and out-of-range\n * input lands inside the legal bounds.\n *\n * Once the settings surface is composed, these values arrive through the\n * `context-guard` settings section instead: the composition entry becomes the\n * section's base layer, and the settings card overrides it per field. The\n * fallback path here only serves deployments without the settings surface.\n */\n\n/**\n * Deployment-tunable guard behavior.\n *\n * The guard is a reminder: when the context OCCUPANCY (the same\n * `projectedTokens / contextWindow` number the composer's context ring shows)\n * crosses `thresholdRatio`, the compact button appears. The official\n * compaction engine auto-compacts at 80% of the window on its own; the real\n * provider rejection wall is `window − maxTokens` (the request reserves\n * output), so a request can fail before occupancy alone reaches 80% — set a\n * lower threshold for an earlier reminder. The field tunes ONLY when the\n * button appears; real compaction timing (compaction-basic's own config) is\n * never affected.\n */\nexport interface ContextGuardConfig {\n  /**\n   * Context occupancy fraction at which the button appears (clamped to\n   * (0, 1]; default 0.8, matching compaction-basic's default pressure\n   * threshold).\n   */\n  thresholdRatio: number\n}\n\n/** Bounds of the deployment-tunable number (clamped in resolveConfig). */\nconst THRESHOLD_RATIO_MIN = 0.01\nconst THRESHOLD_RATIO_MAX = 1\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value))\n}\n\n/**\n * Normalize the entry config into the full {@link ContextGuardConfig}: every\n * omitted field takes its documented default and every numeric field is\n * clamped into its legal range.\n * @param config - the unvalidated entry config, when the runner passes one.\n * @returns the effective guard behavior.\n */\nexport function resolveConfig(config: Partial<ContextGuardConfig> | undefined): ContextGuardConfig {\n  return {\n    thresholdRatio: clamp(\n      config?.thresholdRatio ?? 0.8,\n      THRESHOLD_RATIO_MIN,\n      THRESHOLD_RATIO_MAX,\n    ),\n  }\n}\n","/** `context-guard` namespace dictionaries. */\n\n/** Simplified Chinese dictionary (the key-set source of truth). */\nexport const zh = {\n  'button.label': '压缩',\n  'button.aria': '上下文已用 {percent}%，点击压缩历史',\n  'button.error': '压缩未执行',\n  'settings.title': '压缩提醒时机',\n  'settings.description': '上下文占用达到设定比例时，输入框出现压缩按钮',\n  'settings.expand': '展开',\n  'settings.collapse': '收起',\n  'settings.field.threshold': '提醒比例',\n  'settings.field.threshold.hint': '上下文占用达到窗口的该比例时显示压缩按钮；可配置范围 0.01–1，按自己的偏好调整即可',\n  'settings.overridden': '已自定义',\n  'settings.reset': '重置',\n  'settings.save': '保存',\n  'settings.discard': '放弃',\n  'settings.saved': '已保存',\n  'settings.error': '保存失败，请重试',\n} satisfies Record<string, string>\n\n/** The context-guard namespace key union. */\nexport type ContextGuardKey = keyof typeof zh\n\n/** The dictionary namespace owned by this plugin. */\nexport const NS = 'context-guard'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** The context-guard compact button's copy. */\n    'context-guard': ContextGuardKey\n  }\n}\n\n/** English dictionary, checked complete against the zh key set. */\nexport const en = {\n  'button.label': 'compact',\n  'button.aria': 'Context at {percent}%, click to compact history',\n  'button.error': 'Compaction was not executed',\n  'settings.title': 'Compaction reminder timing',\n  'settings.description': 'Shows the compact button in the composer once context occupancy reaches the configured fraction',\n  'settings.expand': 'Expand',\n  'settings.collapse': 'Collapse',\n  'settings.field.threshold': 'Reminder ratio',\n  'settings.field.threshold.hint': 'Show the compact button once context occupancy reaches this fraction of the window; configurable from 0.01 to 1 — tune it to your preference',\n  'settings.overridden': 'Overridden',\n  'settings.reset': 'Reset',\n  'settings.save': 'Save',\n  'settings.discard': 'Discard',\n  'settings.saved': 'Saved',\n  'settings.error': 'Save failed, please retry',\n} satisfies Record<string, string>\n","/**\n * Pure guard decision math: whether the next request's prompt-plus-output\n * budget is about to overflow the model's context window, mirroring the\n * provider-side rejection rule (`prompt + max_tokens > context_length`).\n *\n * The numerator rides the official `contextPressure` projection so it answers\n * for the NEXT request rather than the last one: `projectedTokens` is the\n * provider-reported prompt sample carried forward over the surface's signed\n * movement since (compaction included), with the bare sample as the fallback\n * for logs whose projection predates that field. The occupancy is the SAME\n * number the composer's context ring shows — the guard is a reminder on top\n * of that ring, not a second figure.\n */\n\n/** The three guard states: nothing to show, about to overflow, already over. */\nexport type GuardLevel = 'ok' | 'warning' | 'overdue'\n\n/** Inputs to the guard decision; both come from the session's contextPressure projection plus config. */\nexport interface GuardInput {\n  /** Current projected context tokens (projectedTokens ?? pressureTokens). */\n  projectedTokens: number\n  /** The routed model's advertised context window; absent until a route reports one. */\n  contextWindow: number | undefined\n  /** The occupancy fraction at which the guard turns on (clamped (0, 1] by config). */\n  thresholdRatio: number\n}\n\n/** One guard reading: the level plus the occupancy figure behind it. */\nexport interface GuardReading {\n  level: GuardLevel\n  /** `projectedTokens / contextWindow`, rounded, clamped to 0–100 — the same occupancy the context ring shows. */\n  percent: number\n  /** The routed model's advertised context window. */\n  contextWindow: number\n}\n\n/**\n * Decide the guard level for one request budget.\n *\n * `overdue` means the occupancy already reached the whole window — the\n * provider will have rejected requests before this point, so it is a\n * defensive floor rather than a reachable state.\n *\n * @param input - the projection figures plus config.\n * @returns the reading, or null when either the window or the context is unknown.\n */\nexport function guardReading(input: GuardInput): GuardReading | null {\n  const { contextWindow, projectedTokens, thresholdRatio } = input\n  if (contextWindow === undefined || !Number.isFinite(contextWindow) || contextWindow <= 0) {\n    return null\n  }\n  if (!Number.isFinite(projectedTokens) || projectedTokens < 0) return null\n  const ratio = projectedTokens / contextWindow\n  const level: GuardLevel = ratio >= 1\n    ? 'overdue'\n    : ratio >= thresholdRatio\n      ? 'warning'\n      : 'ok'\n  return {\n    level,\n    percent: Math.min(100, Math.round(ratio * 100)),\n    contextWindow,\n  }\n}\n","import { useEffect, useMemo, useRef, useState } from 'react'\nimport { IconWarningOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'\n// Type-only: pulls ui-conversation's SlotMap merge (the input.right seat and\n// its InputZone owner share).\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client'\n// Type-only: pulls the `contextPressure` SessionProjectionMap merge for\n// useProjection.\nimport type {} from '@deepseek-ai/dsh-token-meter/client'\nimport { guardReading } from './guard.ts'\nimport type { CompactGuardButtonProps } from './slots.ts'\nimport css from './CompactGuardButton.module.css'\n\nexport type { CompactGuardButtonProps } from './slots.ts'\n\n/**\n * Composer-tool-row compact button. Renders nothing until the context\n * occupancy (`projectedTokens / contextWindow` — the same number the\n * composer's context ring shows) crosses the threshold; then it appears\n * automatically in the amber warning tint. The threshold comes from the\n * shared `context-guard` settings section (live), falling back to the\n * composition-time value while the settings surface is absent. Clicking\n * executes the official `/compact` command through the injected face.\n */\nexport function CompactGuardButton({\n  useProjection,\n  useConfig,\n  t,\n  thresholdRatio,\n  compactNow,\n}: CompactGuardButtonProps) {\n  const pressure = useProjection('contextPressure')\n  const config = useConfig(value => value)\n  const effective = config.status === 'ready' && config.value !== undefined\n    ? config.value\n    : { thresholdRatio }\n  const reading = useMemo(() => guardReading({\n    projectedTokens: pressure?.projectedTokens ?? pressure?.pressureTokens ?? Number.NaN,\n    contextWindow: pressure?.contextWindow,\n    thresholdRatio: effective.thresholdRatio,\n  }), [pressure, effective.thresholdRatio])\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n  const aliveRef = useRef(true)\n\n  useEffect(() => {\n    aliveRef.current = true\n    return () => {\n      aliveRef.current = false\n    }\n  }, [])\n\n  if (reading === null || reading.level === 'ok') return null\n\n  const run = (): void => {\n    setBusy(true)\n    setError(null)\n    void compactNow().then((failure) => {\n      if (!aliveRef.current) return\n      setBusy(false)\n      setError(failure)\n    }, (reason: unknown) => {\n      if (!aliveRef.current) return\n      setBusy(false)\n      setError(reason instanceof Error ? reason.message : String(reason))\n    })\n  }\n\n  return (\n    <span className={css.wrap}>\n      <button\n        type=\"button\"\n        className={`${css.button} ${css.warning}`}\n        aria-label={t('button.aria', { percent: String(reading.percent) })}\n        disabled={busy}\n        onClick={run}\n      >\n        <span className={css.icon} aria-hidden>\n          <IconWarningOutline16 size={14} />\n        </span>\n        {t('button.label')}\n      </button>\n      {/* Failure copy stays English (error-surface policy: not localized). */}\n      {error !== null && (\n        <span className={css.error} role=\"status\" title={error}>\n          {t('button.error')}\n        </span>\n      )}\n    </span>\n  )\n}\n","import { useEffect, useRef, useState } from 'react'\nimport { IconChevronDownOutline14 } from '@deepseek-ai/dsh-client-ui-primitives'\nimport type { SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-runtime/client'\nimport type { ContextGuardConfig } from './config.ts'\nimport type { ContextGuardSettingsCardProps } from './slots.ts'\nimport css from './SettingsCard.module.css'\n\n/** One number field's staged draft, its validity, and the reset/save actions. */\ninterface FieldDraft {\n  text: string\n  invalid: boolean\n}\n\n/** Parse a draft into a number, or NaN when it is not one. */\nfunction parseNumber(text: string): number {\n  const value = Number(text.trim())\n  return Number.isFinite(value) ? value : Number.NaN\n}\n\n/** Whether the user layer carries a field (presence marks an override). */\nfunction overridden(snapshot: SettingsScopeSnapshot<ContextGuardConfig>, field: keyof ContextGuardConfig): boolean {\n  return snapshot.user !== undefined\n    && typeof snapshot.user === 'object'\n    && snapshot.user !== null\n    && field in snapshot.user\n}\n\n/**\n * The context-guard settings card in the plugin configuration tab: the same\n * collapsible chrome the official plugin cards use (a header naming the\n * plugin and what its settings govern, disclosing the controls in place),\n * re-implemented here because the client bundle-purity gate forbids\n * value-importing the official card chrome. Two staged number fields write\n * through the shared settingsScope on save; per-field reset reverts a field\n * to the composition layer.\n */\nexport function ContextGuardSettingsCard({ useConfig, scope, t }: ContextGuardSettingsCardProps) {\n  const snapshot = useConfig(value => value)\n  const value = snapshot.status === 'ready' ? snapshot.value : undefined\n  const [open, setOpen] = useState(false)\n  const [threshold, setThreshold] = useState<FieldDraft>({ text: '', invalid: false })\n  const [saved, setSaved] = useState(false)\n  const [error, setError] = useState(false)\n  const aliveRef = useRef(true)\n  /** The section revision the drafts were last seeded from; re-seed only on a committed change. */\n  const seededRevision = useRef<number | null>(null)\n\n  // Re-seed the drafts whenever the section VALUE changes (first load, a save\n  // settling, an external reset). Keyed on the snapshot revision rather than\n  // the value's object identity: a save settling publishes a new snapshot\n  // (revision bump), while an unrelated re-render must not discard a draft in\n  // flight — the staged model promises the screen shows exactly what a save\n  // would store.\n  useEffect(() => {\n    aliveRef.current = true\n    if (value === undefined) return\n    if (seededRevision.current === snapshot.revision) return\n    seededRevision.current = snapshot.revision ?? null\n    setThreshold({ text: String(value.thresholdRatio), invalid: false })\n    setSaved(false)\n    setError(false)\n    return () => {\n      aliveRef.current = false\n    }\n  }, [value, snapshot.revision])\n\n  if (snapshot.status === 'unavailable') return null\n\n  const write = (draft: FieldDraft, min: number, max: number): void => {\n    const parsed = parseNumber(draft.text)\n    setThreshold({ text: draft.text, invalid: !Number.isFinite(parsed) || parsed < min || parsed > max })\n  }\n\n  const save = (): void => {\n    if (threshold.invalid || snapshot.writable !== true) return\n    const ratio = parseNumber(threshold.text)\n    if (!Number.isFinite(ratio)) return\n    setError(false)\n    setSaved(false)\n    void scope.set('thresholdRatio', ratio).then(() => {\n      if (!aliveRef.current) return\n      setSaved(true)\n    }, () => {\n      if (!aliveRef.current) return\n      setError(true)\n    })\n  }\n\n  const reset = (): void => {\n    setError(false)\n    setSaved(false)\n    void scope.unset('thresholdRatio').catch(() => {\n      if (aliveRef.current) setError(true)\n    })\n  }\n\n  const title = t('settings.title')\n  const dirty = threshold.text !== String(value?.thresholdRatio ?? '')\n\n  return (\n    <li className={open ? `${css.card} ${css.cardOpen}` : css.card}>\n      <button\n        type=\"button\"\n        className={css.header}\n        aria-expanded={open}\n        aria-label={`${t(open ? 'settings.collapse' : 'settings.expand')}: ${title}`}\n        onClick={() => { setOpen(!open) }}\n      >\n        <span className={css.headText}>\n          <span className={css.name}>{title}</span>\n          <span className={css.description}>{t('settings.description')}</span>\n        </span>\n        <IconChevronDownOutline14 className={open ? `${css.chevron} ${css.chevronOpen}` : css.chevron} />\n      </button>\n      {open && value !== undefined && (\n        <div className={css.body}>\n          <label className={css.field}>\n            <span className={css.fieldHead}>\n              <span className={css.fieldName}>{t('settings.field.threshold')}</span>\n              {overridden(snapshot, 'thresholdRatio') && <span className={css.badge}>{t('settings.overridden')}</span>}\n            </span>\n            <span className={css.inputRow}>\n              <input\n                className={threshold.invalid ? `${css.input} ${css.inputInvalid}` : css.input}\n                type=\"number\"\n                step=\"0.01\"\n                min=\"0.01\"\n                max=\"1\"\n                value={threshold.text}\n                aria-label={t('settings.field.threshold')}\n                onChange={(event) => { write({ text: event.target.value, invalid: false }, 0.01, 1) }}\n              />\n              <button type=\"button\" className={css.reset} onClick={reset}>\n                {t('settings.reset')}\n              </button>\n            </span>\n            <span className={css.hint}>{t('settings.field.threshold.hint')}</span>\n          </label>\n          <span className={css.footer}>\n            <span className={css.status}>\n              {saved ? <span className={css.saved}>{t('settings.saved')}</span> : null}\n              {error ? <span className={css.errorText}>{t('settings.error')}</span> : null}\n            </span>\n            <button\n              type=\"button\"\n              className={css.secondary}\n              disabled={!dirty}\n              onClick={() => {\n                if (value === undefined) return\n                setThreshold({ text: String(value.thresholdRatio), invalid: false })\n                setSaved(false)\n                setError(false)\n              }}\n            >\n              {t('settings.discard')}\n            </button>\n            <button\n              type=\"button\"\n              className={css.save}\n              disabled={!dirty || threshold.invalid || snapshot.writable !== true}\n              onClick={save}\n            >\n              {t('settings.save')}\n            </button>\n          </span>\n        </div>\n      )}\n    </li>\n  )\n}\n","/**\n * Context-guard plugin, browser half: contributes one\n * `conversation.input.right` entry — a compact button inside the composer's\n * tool row that appears automatically when the next request's budget\n * (`contextPressure.projectedTokens` + the output budget) crosses\n * `thresholdRatio` of the routed model's context window — plus one\n * `settings.plugin.item` card in the plugin configuration tab that edits the\n * same two numbers live. The action rides the official `/compact` command\n * channel (`remote.commands.execute` → host `ctx.commands` →\n * `ctx.compaction.compactNow`); the config rides the official settings\n * surface (host half registers the namespace, this half binds its\n * `settingsScope`), so neither needs a new RPC or any edit to core packages;\n * composing this plugin out of cordis.yml removes every surface it adds.\n *\n * Why this exists: the official auto-compaction fires at `agent/pre-step`\n * when the meter's context estimate crosses 80% of the window — a check that\n * excludes the request's own output budget and rides a heuristic that\n * deliberately underprices CJK/JSON. A long request can therefore push\n * context + maxTokens past the window while the estimate still sits below\n * 80%, so the provider rejects the request (CONTEXT_WINDOW_EXCEEDED). The\n * guard surfaces the danger while a manual compaction still fits — the\n * summarization call reserves only its own small output cap, so it keeps\n * running after the main request is rejected.\n * @module @khorsheed/dsh-context-guard/client\n */\nimport type { ClientContext, SessionId } from '@deepseek-ai/dsh-client-runtime/client'\n// Type-only: pulls the typed `ctx.remote` (commands namespace) merge.\nimport type {} from '@deepseek-ai/dsh-api-remotes/client'\n// Type-only: pulls the ctx.locale service merge.\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\n// Type-only: pulls ui-conversation's SlotMap merge\n// ('conversation.input.right').\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client'\n// Type-only: pulls the ctx.settingsScope service merge.\nimport type {} from '@deepseek-ai/dsh-client-ui-settings/client'\n// Type-only: pulls ui-settings-plugins' SlotMap merge\n// ('settings.plugin.item').\nimport type {} from '@deepseek-ai/dsh-client-ui-settings-plugins/client'\n// Type-only: pulls the `contextPressure` SessionProjectionMap merge for\n// useProjection.\nimport type {} from '@deepseek-ai/dsh-token-meter/client'\nimport { CONTEXT_GUARD_NS } from '../namespace.ts'\nimport { resolveConfig, type ContextGuardConfig } from './config.ts'\nimport { en, NS, zh } from './locales.ts'\nimport type { ContextGuardInjected, ContextGuardSettingsCardInjected } from './slots.ts'\nimport { CompactGuardButton } from './CompactGuardButton.tsx'\nimport { ContextGuardSettingsCard } from './SettingsCard.tsx'\n\nexport type { ContextGuardConfig } from './config.ts'\nexport { resolveConfig } from './config.ts'\nexport type { ContextGuardKey } from './locales.ts'\nexport { guardReading } from './guard.ts'\nexport type { GuardInput, GuardLevel, GuardReading } from './guard.ts'\nexport type {\n  CompactGuardButtonProps, ContextGuardInjected, ContextGuardSettingsCardInjected, ContextGuardSettingsCardProps,\n} from './slots.ts'\n\n/** Dictionary namespace owned by this plugin. */\nexport { NS }\n\n/** Required services: the slot ledger, the command Remote, the settings scope, and the copy. */\nexport const inject = ['slots', 'remote', 'remote.commands', 'locale', 'settingsScope']\n\n/**\n * Client plugin body: register the composer-tool-row compact button and the\n * settings card over the shared `context-guard` section.\n * @param ctx - client root context.\n * @param config - entry config (the section's composition base layer); defaults apply when the runner passes none.\n */\nexport function apply(ctx: ClientContext, config?: Partial<ContextGuardConfig>): void {\n  const fallback = resolveConfig(config)\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'context-guard: dictionaries')\n\n  // One shared live section: the settings card writes it, the button reads\n  // it. While the settings surface is absent, the button falls back to the\n  // composition-time values above.\n  const scope = ctx.settingsScope.bind<ContextGuardConfig>({ namespace: CONTEXT_GUARD_NS })\n\n  // The slot is declared by ui-conversation, whose apply order relative to\n  // this plugin is unconstrained: register through slots.inject so the entry\n  // waits for the declaration instead of crashing the loader at boot.\n  ctx.slots.inject('conversation.input.right', () => ctx.slots.register({\n    name: 'conversation.input.right',\n    id: 'context-guard',\n    // Sit before the primary send button; the seat currently has no other\n    // occupants, and a leading position keeps the danger visible.\n    order: -10,\n    locale: NS,\n    inject: (sessionId: SessionId): ContextGuardInjected => ({\n      thresholdRatio: fallback.thresholdRatio,\n      // Failure strings stay English (error-surface policy: not localized).\n      compactNow: async () => {\n        const result = await ctx.remote.commands.execute(sessionId, '/compact', [])\n        if (!result.ok) return `${result.error.message} (${result.error.code})`\n        if (result.value === undefined) return 'unknown command: /compact'\n        return null\n      },\n      hooks: { config: scope },\n    }),\n  }, CompactGuardButton))\n\n  // The plugin configuration tab keys its cards on the settings namespace, so\n  // the compact-timing card registers under CONTEXT_GUARD_NS and renders\n  // wherever the tab dispatches that key.\n  ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({\n    name: 'settings.plugin.item',\n    key: CONTEXT_GUARD_NS,\n    locale: NS,\n    inject: (): ContextGuardSettingsCardInjected => ({\n      scope,\n      hooks: { config: scope },\n    }),\n  }, ContextGuardSettingsCard))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;EAQA,MAAa,mBAAmB;;;;EC4BhC,MAAM,sBAAsB;EAC5B,MAAM,sBAAsB;EAE5B,SAAS,MAAM,OAAe,KAAa,KAAqB;GAC9D,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;EAC3C;;;;;;;;EASA,SAAgB,cAAc,QAAqE;GACjG,OAAO,EACL,gBAAgB,MACd,QAAQ,kBAAkB,IAC1B,qBACA,mBACF,EACF;EACF;;;;;ECvDA,MAAa,KAAK;GAChB,gBAAgB;GAChB,eAAe;GACf,gBAAgB;GAChB,kBAAkB;GAClB,wBAAwB;GACxB,mBAAmB;GACnB,qBAAqB;GACrB,4BAA4B;GAC5B,iCAAiC;GACjC,uBAAuB;GACvB,kBAAkB;GAClB,iBAAiB;GACjB,oBAAoB;GACpB,kBAAkB;GAClB,kBAAkB;EACpB;;EAMA,MAAa,KAAK;;EAUlB,MAAa,KAAK;GAChB,gBAAgB;GAChB,eAAe;GACf,gBAAgB;GAChB,kBAAkB;GAClB,wBAAwB;GACxB,mBAAmB;GACnB,qBAAqB;GACrB,4BAA4B;GAC5B,iCAAiC;GACjC,uBAAuB;GACvB,kBAAkB;GAClB,iBAAiB;GACjB,oBAAoB;GACpB,kBAAkB;GAClB,kBAAkB;EACpB;;;;;;;;;;;;;ECLA,SAAgB,aAAa,OAAwC;GACnE,MAAM,EAAE,eAAe,iBAAiB,mBAAmB;GAC3D,IAAI,kBAAkB,KAAA,KAAa,CAAC,OAAO,SAAS,aAAa,KAAK,iBAAiB,GACrF,OAAO;GAET,IAAI,CAAC,OAAO,SAAS,eAAe,KAAK,kBAAkB,GAAG,OAAO;GACrE,MAAM,QAAQ,kBAAkB;GAMhC,OAAO;IACL,OANwB,SAAS,IAC/B,YACA,SAAS,iBACP,YACA;IAGJ,SAAS,KAAK,IAAI,KAAK,KAAK,MAAM,QAAQ,GAAG,CAAC;IAC9C;GACF;EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ECxCA,SAAgB,mBAAmB,EACjC,eACA,WACA,GACA,gBACA,cAC0B;GAC1B,MAAM,WAAW,cAAc,iBAAiB;GAChD,MAAM,SAAS,WAAU,UAAS,KAAK;GACvC,MAAM,YAAY,OAAO,WAAW,WAAW,OAAO,UAAU,KAAA,IAC5D,OAAO,QACP,EAAE,eAAe;GACrB,MAAM,WAAA,GAAUA,MAAAA,QAAAA,OAAc,aAAa;IACzC,iBAAiB,UAAU,mBAAmB,UAAU,kBAAkB;IAC1E,eAAe,UAAU;IACzB,gBAAgB,UAAU;GAC5B,CAAC,GAAG,CAAC,UAAU,UAAU,cAAc,CAAC;GACxC,MAAM,CAAC,MAAM,YAAA,GAAWC,MAAAA,SAAAA,CAAS,KAAK;GACtC,MAAM,CAAC,OAAO,aAAA,GAAYA,MAAAA,SAAAA,CAAwB,IAAI;GACtD,MAAM,YAAA,GAAWC,MAAAA,OAAAA,CAAO,IAAI;GAE5B,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,SAAS,UAAU;IACnB,aAAa;KACX,SAAS,UAAU;IACrB;GACF,GAAG,CAAC,CAAC;GAEL,IAAI,YAAY,QAAQ,QAAQ,UAAU,MAAM,OAAO;GAEvD,MAAM,YAAkB;IACtB,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,WAAgB,CAAC,CAAC,MAAM,YAAY;KAClC,IAAI,CAAC,SAAS,SAAS;KACvB,QAAQ,KAAK;KACb,SAAS,OAAO;IAClB,IAAI,WAAoB;KACtB,IAAI,CAAC,SAAS,SAAS;KACvB,QAAQ,KAAK;KACb,SAAS,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM,CAAC;IACpE,CAAC;GACH;GAEA,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;IAAM,WAAWC,sCAAI;IAArB,UAAA,CACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,UAAD;KACE,MAAK;KACL,WAAW,GAAGA,sCAAI,OAAO,GAAGA,sCAAI;KAChC,cAAY,EAAE,eAAe,EAAE,SAAS,OAAO,QAAQ,OAAO,EAAE,CAAC;KACjE,UAAU;KACV,SAAS;KALX,UAAA,CAOE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,sCAAI;MAAM,eAAA;MACzB,UAAA,iBAAA,GAAA,kBAAA,IAAA,CAACC,sCAAAA,sBAAD,EAAsB,MAAM,GAAK,CAAA;KAC7B,CAAA,GACL,EAAE,cAAc,CACX;IAEP,CAAA,GAAA,UAAU,QACT,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;KAAM,WAAWD,sCAAI;KAAO,MAAK;KAAS,OAAO;KAC9C,UAAA,EAAE,cAAc;IACb,CAAA,CAEJ;;EAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EC3EA,SAAS,YAAY,MAAsB;GACzC,MAAM,QAAQ,OAAO,KAAK,KAAK,CAAC;GAChC,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;EAC1C;;EAGA,SAAS,WAAW,UAAqD,OAA0C;GACjH,OAAO,SAAS,SAAS,KAAA,KACpB,OAAO,SAAS,SAAS,YACzB,SAAS,SAAS,QAClB,SAAS,SAAS;EACzB;;;;;;;;;;EAWA,SAAgB,yBAAyB,EAAE,WAAW,OAAO,KAAoC;GAC/F,MAAM,WAAW,WAAU,UAAS,KAAK;GACzC,MAAM,QAAQ,SAAS,WAAW,UAAU,SAAS,QAAQ,KAAA;GAC7D,MAAM,CAAC,MAAM,YAAA,GAAWE,MAAAA,SAAAA,CAAS,KAAK;GACtC,MAAM,CAAC,WAAW,iBAAA,GAAgBA,MAAAA,SAAAA,CAAqB;IAAE,MAAM;IAAI,SAAS;GAAM,CAAC;GACnF,MAAM,CAAC,OAAO,aAAA,GAAYA,MAAAA,SAAAA,CAAS,KAAK;GACxC,MAAM,CAAC,OAAO,aAAA,GAAYA,MAAAA,SAAAA,CAAS,KAAK;GACxC,MAAM,YAAA,GAAWC,MAAAA,OAAAA,CAAO,IAAI;;GAE5B,MAAM,kBAAA,GAAiBA,MAAAA,OAAAA,CAAsB,IAAI;GAQjD,CAAA,GAAA,MAAA,UAAA,OAAgB;IACd,SAAS,UAAU;IACnB,IAAI,UAAU,KAAA,GAAW;IACzB,IAAI,eAAe,YAAY,SAAS,UAAU;IAClD,eAAe,UAAU,SAAS,YAAY;IAC9C,aAAa;KAAE,MAAM,OAAO,MAAM,cAAc;KAAG,SAAS;IAAM,CAAC;IACnE,SAAS,KAAK;IACd,SAAS,KAAK;IACd,aAAa;KACX,SAAS,UAAU;IACrB;GACF,GAAG,CAAC,OAAO,SAAS,QAAQ,CAAC;GAE7B,IAAI,SAAS,WAAW,eAAe,OAAO;GAE9C,MAAM,SAAS,OAAmB,KAAa,QAAsB;IACnE,MAAM,SAAS,YAAY,MAAM,IAAI;IACrC,aAAa;KAAE,MAAM,MAAM;KAAM,SAAS,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,OAAO,SAAS;IAAI,CAAC;GACtG;GAEA,MAAM,aAAmB;IACvB,IAAI,UAAU,WAAW,SAAS,aAAa,MAAM;IACrD,MAAM,QAAQ,YAAY,UAAU,IAAI;IACxC,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG;IAC7B,SAAS,KAAK;IACd,SAAS,KAAK;IACd,MAAW,IAAI,kBAAkB,KAAK,CAAC,CAAC,WAAW;KACjD,IAAI,CAAC,SAAS,SAAS;KACvB,SAAS,IAAI;IACf,SAAS;KACP,IAAI,CAAC,SAAS,SAAS;KACvB,SAAS,IAAI;IACf,CAAC;GACH;GAEA,MAAM,cAAoB;IACxB,SAAS,KAAK;IACd,SAAS,KAAK;IACd,MAAW,MAAM,gBAAgB,CAAC,CAAC,YAAY;KAC7C,IAAI,SAAS,SAAS,SAAS,IAAI;IACrC,CAAC;GACH;GAEA,MAAM,QAAQ,EAAE,gBAAgB;GAChC,MAAM,QAAQ,UAAU,SAAS,OAAO,OAAO,kBAAkB,EAAE;GAEnE,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,MAAD;IAAI,WAAW,OAAO,GAAGC,gCAAI,KAAK,GAAGA,gCAAI,aAAaA,gCAAI;IAA1D,UAAA,CACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,UAAD;KACE,MAAK;KACL,WAAWA,gCAAI;KACf,iBAAe;KACf,cAAY,GAAG,EAAE,OAAO,sBAAsB,iBAAiB,EAAE,IAAI;KACrE,eAAe;MAAE,QAAQ,CAAC,IAAI;KAAE;KALlC,UAAA,CAOE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;MAAM,WAAWA,gCAAI;MAArB,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;OAAM,WAAWA,gCAAI;OAAO,UAAA;MAAY,CAAA,GACxC,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;OAAM,WAAWA,gCAAI;OAAc,UAAA,EAAE,sBAAsB;MAAQ,CAAA,CAC/D;KACN,CAAA,GAAA,iBAAA,GAAA,kBAAA,IAAA,CAACC,sCAAAA,0BAAD,EAA0B,WAAW,OAAO,GAAGD,gCAAI,QAAQ,GAAGA,gCAAI,gBAAgBA,gCAAI,QAAU,CAAA,CAC1F;IACP,CAAA,GAAA,QAAQ,UAAU,KAAA,KACjB,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;KAAK,WAAWA,gCAAI;KAApB,UAAA,CACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,SAAD;MAAO,WAAWA,gCAAI;MAAtB,UAAA;OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;QAAM,WAAWA,gCAAI;QAArB,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;SAAM,WAAWA,gCAAI;SAAY,UAAA,EAAE,0BAA0B;QAAQ,CAAA,GACpE,WAAW,UAAU,gBAAgB,KAAK,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;SAAM,WAAWA,gCAAI;SAAQ,UAAA,EAAE,qBAAqB;QAAQ,CAAA,CACnG;;OACN,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;QAAM,WAAWA,gCAAI;QAArB,UAAA,CACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,SAAD;SACE,WAAW,UAAU,UAAU,GAAGA,gCAAI,MAAM,GAAGA,gCAAI,iBAAiBA,gCAAI;SACxE,MAAK;SACL,MAAK;SACL,KAAI;SACJ,KAAI;SACJ,OAAO,UAAU;SACjB,cAAY,EAAE,0BAA0B;SACxC,WAAW,UAAU;UAAE,MAAM;WAAE,MAAM,MAAM,OAAO;WAAO,SAAS;UAAM,GAAG,KAAM,CAAC;SAAE;QACrF,CAAA,GACD,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;SAAQ,MAAK;SAAS,WAAWA,gCAAI;SAAO,SAAS;SAClD,UAAA,EAAE,gBAAgB;QACb,CAAA,CACJ;;OACN,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;QAAM,WAAWA,gCAAI;QAAO,UAAA,EAAE,+BAA+B;OAAQ,CAAA;MAChE;KACP,CAAA,GAAA,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;MAAM,WAAWA,gCAAI;MAArB,UAAA;OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,QAAD;QAAM,WAAWA,gCAAI;QAArB,UAAA,CACG,QAAQ,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;SAAM,WAAWA,gCAAI;SAAQ,UAAA,EAAE,gBAAgB;QAAQ,CAAA,IAAI,MACnE,QAAQ,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;SAAM,WAAWA,gCAAI;SAAY,UAAA,EAAE,gBAAgB;QAAQ,CAAA,IAAI,IACpE;;OACN,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;QACE,MAAK;QACL,WAAWA,gCAAI;QACf,UAAU,CAAC;QACX,eAAe;SACb,IAAI,UAAU,KAAA,GAAW;SACzB,aAAa;UAAE,MAAM,OAAO,MAAM,cAAc;UAAG,SAAS;SAAM,CAAC;SACnE,SAAS,KAAK;SACd,SAAS,KAAK;QAChB;QAEC,UAAA,EAAE,kBAAkB;OACf,CAAA;OACR,iBAAA,GAAA,kBAAA,IAAA,CAAC,UAAD;QACE,MAAK;QACL,WAAWA,gCAAI;QACf,UAAU,CAAC,SAAS,UAAU,WAAW,SAAS,aAAa;QAC/D,SAAS;QAER,UAAA,EAAE,eAAe;OACZ,CAAA;MACJ;KACH,CAAA,CAAA;IAEL,CAAA,CAAA;;EAER;;;;EC5GA,MAAa,SAAS;GAAC;GAAS;GAAU;GAAmB;GAAU;EAAe;;;;;;;EAQtF,SAAgB,MAAM,KAAoB,QAA4C;GACpF,MAAM,WAAW,cAAc,MAAM;GACrC,IAAI,aAAa,IAAI,OAAO,SAAS,IAAI;IAAE;IAAI;GAAG,CAAC,GAAG,6BAA6B;GAKnF,MAAM,QAAQ,IAAI,cAAc,KAAyB,EAAE,WAAW,iBAAiB,CAAC;GAKxF,IAAI,MAAM,OAAO,kCAAkC,IAAI,MAAM,SAAS;IACpE,MAAM;IACN,IAAI;IAGJ,OAAO;IACP,QAAQ;IACR,SAAS,eAAgD;KACvD,gBAAgB,SAAS;KAEzB,YAAY,YAAY;MACtB,MAAM,SAAS,MAAM,IAAI,OAAO,SAAS,QAAQ,WAAW,YAAY,CAAC,CAAC;MAC1E,IAAI,CAAC,OAAO,IAAI,OAAO,GAAG,OAAO,MAAM,QAAQ,IAAI,OAAO,MAAM,KAAK;MACrE,IAAI,OAAO,UAAU,KAAA,GAAW,OAAO;MACvC,OAAO;KACT;KACA,OAAO,EAAE,QAAQ,MAAM;IACzB;GACF,GAAG,kBAAkB,CAAC;GAKtB,IAAI,MAAM,OAAO,8BAA8B,IAAI,MAAM,SAAS;IAChE,MAAM;IACN,KAAK;IACL,QAAQ;IACR,eAAiD;KAC/C;KACA,OAAO,EAAE,QAAQ,MAAM;IACzB;GACF,GAAG,wBAAwB,CAAC;EAC9B"}

package/lib/index.js

@@ -0,0 +1,50 @@
+import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import z from "@deepseek-ai/schemastery";
+//#region lib/types/namespace.js
+/**
+* The settings namespace owned by the context-guard plugin. Plain string so
+* both the host half (settings registration) and the browser half
+* (settingsScope binding and the settings.plugin.item card key) import it
+* without dragging host-only dependencies into the client bundle.
+*/
+/** Settings namespace owned by the context-guard plugin. */
+const CONTEXT_GUARD_NS = "context-guard";
+//#endregion
+//#region lib/types/settings.js
+/**
+* Host-side settings section of the context-guard plugin: the schemastery
+* schema that validates the `context-guard` settings namespace. The browser
+* half reads the resolved section through `ctx.settingsScope` and the
+* settings page renders it as a plugin card; the composition entry (the
+* cordis.yml row) becomes the section's `base` layer, so YAML values keep
+* working as the defaults the card can override.
+*
+* These two fields tune ONLY when the compact button appears — the official
+* compaction engine (compaction-basic) reads its own `thresholdRatio` /
+* `maxTokens` config and never touches this section.
+*/
+/** Section shape: the context-occupancy fraction at which the button appears. */
+const ContextGuardSettingsSchema = z.object({ thresholdRatio: z.number().min(.01).max(1).default(.8) });
+//#endregion
+//#region lib/types/index.js
+/**
+* Context-guard plugin, node half. Registers the `context-guard` settings
+* namespace so the web settings page can render the compact-timing card and
+* the browser half can bind its `settingsScope` to the same section. The
+* plugin's own runtime behavior is purely client-side (the composer compact
+* button); this registration only exists to make the two tunables
+* (`thresholdRatio`, `maxTokens`) editable from the GUI instead of YAML.
+* @module @khorsheed/dsh-context-guard
+*/
+/**
+* Register the compact-timing section when a settings provider exists.
+* @param ctx - Host context whose optional settings service owns the section.
+* @param config - the plugin's composition entry, used as the section's base layer.
+*/
+function apply(ctx, config = {}) {
+	ctx.inject(["settings"], (settingsCtx) => {
+		settingsCtx.settings.register(settingsNamespace(CONTEXT_GUARD_NS), ContextGuardSettingsSchema, { base: config });
+	});
+}
+//#endregion
+export { CONTEXT_GUARD_NS, ContextGuardSettingsSchema, apply };

package/lib/invariant.js

@@ -0,0 +1,26 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@khorsheed/dsh-context-guard`.
+* @module @khorsheed/dsh-context-guard/invariant
+*/
+const PACKAGE_NAME = "@khorsheed/dsh-context-guard";
+/** Cordis companion plugin name. */
+const name = "context-guard-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: every compact action is executed through the official
+* `/compact` command channel, whose command-log invariant companion audits the
+* command lifecycle, and the plugin's one composer-tool-row entry proves
+* disposal through the browser-plugin spec. No second authority exists to
+* check at runtime.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };