dsh-context-fold 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 niechao136
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 niechao136
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cordis.patch.yml

@@ -1,6 +1,6 @@
-# dsh-context-fold bundle layer: the plugin needs no configuration to start, so this patch only
-# inserts the row. Per-session tuning lives in the profile's own cordis.patch.yml, under this entry's
-# `config` (see README §Configuration).
-- insert:
-    - id: context-fold
-      name: dsh-context-fold
+# dsh-context-fold bundle layer: the plugin needs no configuration to start, so this patch only
+# inserts the row. Per-session tuning lives in the profile's own cordis.patch.yml, under this entry's
+# `config` (see README §Configuration).
+- insert:
+    - id: context-fold
+      name: dsh-context-fold

package/icon.svg

@@ -1,6 +1,6 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
-  <path d="M4 6h16" />
-  <path d="M4 12h16" />
-  <path d="M4 18h7" />
-  <path d="M15 16l2 2 4-4" />
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M4 6h16" />
+  <path d="M4 12h16" />
+  <path d="M4 18h7" />
+  <path d="M15 16l2 2 4-4" />
+</svg>

package/lib/client.d.ts

@@ -1,3 +1,8 @@
+window.__ModuleLoader__.load({
+  id: "dsh-context-fold",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
 /**
  * `conversation.view` tab: what this plugin folded, what it saved, and the full
  * text behind each fold.
@@ -20,6 +25,14 @@
  * The original text of every fold is shown on demand, fetched by its recovery
  * path, so the tab doubles as the answer to "what exactly did it remove".
  *
+ * ## How this file is shipped
+ *
+ * `tsdown` wraps the output in the shell's module-factory form
+ * (`window.__ModuleLoader__.load({id, factory(require){…}})`), which is the only
+ * shape the client module system executes. Imports are therefore converted into
+ * `require` calls resolved against the shared platform module table, and the
+ * plugin's exports (`name`/`inject`/`apply`) are what the factory returns.
+ *
  * @module dsh-context-fold/client
  */
 /** One fold row as the server reports it. */
@@ -78,8 +91,10 @@ interface ClientContext {
     register(descriptor: Record<string, unknown>, render: (props: unknown) => unknown): unknown;
   };
   locale: {
-    get(key: string): string;
+    register(namespace: string, dictionaries: Record<string, Record<string, string>>): unknown;
+    bind(namespace: string): (key: string) => string;
   };
+  effect?(run: () => unknown, label?: string): unknown;
 }
 /** Client plugin name. */
 declare const name = "context-fold-client";
@@ -88,7 +103,13 @@ declare const inject: string[];
 /**
  * Mount the conversation tab.
  *
+ * Dictionaries are registered from inside this bundle: the locale service reads
+ * them from the plugin registry, not from `locale/*.json` on disk.
+ *
  * @param ctx - client plugin context.
  */
 declare function apply(ctx: ClientContext): void;
-export { FoldReportPayload, FoldRow, apply, inject, name };
+export { FoldReportPayload, FoldRow, apply, inject, name };
+    return module.exports;
+  },
+});

package/lib/client.js

@@ -1,4 +1,17 @@
+window.__ModuleLoader__.load({
+  id: "dsh-context-fold",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 // src/client.ts
+/** Locale namespace owned by this plugin's client half. */
+const NS = "contextFold";
+/** Dictionary: keep keys aligned with `locale/*.json`. */
+const zh = { "tab.contextFold": "上下文折叠" };
+/** Dictionary: keep keys aligned with `locale/*.json`. */
+const en = { "tab.contextFold": "Context fold" };
+const react = require("react");
 /** Fetch the report for one session. */
 async function fetchReport(sessionId) {
 	const response = await fetch("/api/context-fold/report", {
@@ -33,48 +46,93 @@ function signed(value) {
 	const rounded = Math.round(value * 10) / 10;
 	return `${rounded > 0 ? "+" : ""}${num(rounded)}`;
 }
-/**
-* Render the tab body.
-*
-* Deliberately plain DOM (no framework import): the plugin's render prop may be
-* called from any client runtime, and depending on a specific React bundle would
-* couple this package to one shell version.
-*
-* @param props - slot props carrying the active session id.
-* @returns an element or a node tree.
-*/
-function renderTab(props) {
-	const sessionId = props?.sessionId;
-	const root = document.createElement("div");
-	root.className = "context-fold-tab";
-	root.style.cssText = "padding:12px;font:13px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;overflow:auto;height:100%";
-	const title = document.createElement("div");
-	title.textContent = "Context fold";
-	title.style.cssText = "font-weight:600;margin-bottom:8px";
-	root.append(title);
-	const status = document.createElement("div");
-	status.style.cssText = "color:#888";
-	status.textContent = sessionId === void 0 ? "No active session." : "Loading…";
-	root.append(status);
-	if (sessionId !== void 0) fetchReport(sessionId).then((report) => {
-		root.replaceChildren(title);
-		if (report === void 0) {
-			status.textContent = "No report available for this session.";
-			root.append(status);
-			return;
-		}
-		root.append(renderSummary(report), renderFolds(sessionId, report));
-	});
-	return root;
+/** Read the active session id out of the slot props. */
+function sessionIdOf(props) {
+	const value = props?.sessionId;
+	return typeof value === "string" && value !== "" ? value : void 0;
 }
+/** Inline styles, kept as plain objects because no CSS module ships here. */
+const styles = {
+	root: {
+		padding: "12px",
+		font: "13px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace",
+		overflow: "auto",
+		height: "100%"
+	},
+	title: {
+		fontWeight: 600,
+		marginBottom: "8px"
+	},
+	muted: { color: "#888" },
+	box: {
+		marginBottom: "12px",
+		padding: "8px",
+		border: "1px solid #333",
+		borderRadius: "6px"
+	},
+	heading: {
+		fontWeight: 600,
+		marginBottom: "6px"
+	},
+	table: { borderCollapse: "collapse" },
+	labelCell: {
+		padding: "1px 12px 1px 0",
+		color: "#aaa"
+	},
+	warning: {
+		marginTop: "6px",
+		color: "#facc15"
+	},
+	reread: {
+		marginTop: "6px",
+		color: "#f87171"
+	},
+	fold: {
+		marginBottom: "6px",
+		padding: "6px",
+		border: "1px solid #2a2a2a",
+		borderRadius: "6px"
+	},
+	foldSummary: { cursor: "pointer" },
+	inlinePre: {
+		whiteSpace: "pre-wrap",
+		margin: "6px 0",
+		color: "#bbb",
+		maxHeight: "12em",
+		overflow: "auto"
+	},
+	originalPre: {
+		whiteSpace: "pre-wrap",
+		margin: "6px 0",
+		color: "#ddd",
+		maxHeight: "24em",
+		overflow: "auto",
+		borderTop: "1px dashed #333",
+		paddingTop: "6px"
+	},
+	locator: {
+		color: "#666",
+		fontSize: "11px",
+		wordBreak: "break-all"
+	},
+	notRecoverable: {
+		color: "#f87171",
+		fontSize: "11px"
+	},
+	detailsToggle: {
+		cursor: "pointer",
+		color: "#888",
+		marginTop: "6px"
+	},
+	assumptionList: {
+		margin: "4px 0 0 16px",
+		padding: 0,
+		color: "#999"
+	}
+};
 /** The counterfactual summary block. */
-function renderSummary(report) {
-	const cf = report.counterfactual;
-	const box = document.createElement("section");
-	box.style.cssText = "margin-bottom:12px;padding:8px;border:1px solid #333;border-radius:6px";
-	const heading = document.createElement("div");
-	heading.textContent = "Token comparison (estimate)";
-	heading.style.cssText = "font-weight:600;margin-bottom:6px";
+function Summary(props) {
+	const cf = props.report.counterfactual;
 	const rows = [
 		["Folded content, now", `${num(cf.tokensNow)} tokens`],
 		["If it had stayed unfolded", `${num(cf.tokensIfUnfolded)} tokens`],
@@ -84,93 +142,137 @@ function renderSummary(report) {
 		["Prefix invalidation cost", signed(-cf.invalidationCost)],
 		["Net", signed(cf.netSaving)]
 	];
-	const table = document.createElement("table");
-	table.style.cssText = "border-collapse:collapse";
-	for (const [label, value] of rows) {
-		const tr = document.createElement("tr");
-		const th = document.createElement("td");
-		th.textContent = label;
-		th.style.cssText = "padding:1px 12px 1px 0;color:#aaa";
-		const td = document.createElement("td");
-		td.textContent = value;
-		if (label === "Net") td.style.cssText = `font-weight:600;color:${cf.netSaving >= 0 ? "#4ade80" : "#f87171"}`;
-		tr.append(th, td);
-		table.append(tr);
-	}
-	const freshness = document.createElement("div");
-	freshness.style.cssText = "margin-top:6px;color:#facc15";
-	freshness.textContent = cf.hasRealUsage ? `Priced against this session's real usage${cf.cacheReadShare === void 0 ? "" : ` (cache-read share ${(cf.cacheReadShare * 100).toFixed(1)}%)`}.` : "This session reported NO provider usage — every figure here is heuristic token counts, not a bill.";
-	const assumptions = document.createElement("details");
-	const summary = document.createElement("summary");
-	summary.textContent = "Assumptions";
-	summary.style.cssText = "cursor:pointer;color:#888;margin-top:6px";
-	assumptions.append(summary);
-	const list = document.createElement("ul");
-	list.style.cssText = "margin:4px 0 0 16px;padding:0;color:#999";
-	for (const assumption of cf.assumptions) {
-		const item = document.createElement("li");
-		item.textContent = assumption;
-		list.append(item);
-	}
-	assumptions.append(list);
-	box.append(heading, table, freshness, assumptions);
-	if (report.reReads > 0) {
-		const reread = document.createElement("div");
-		reread.style.cssText = "margin-top:6px;color:#f87171";
-		reread.textContent = `Re-read signals: ${String(report.reReads)} — folded content was fetched again after being folded.`;
-		box.append(reread);
-	}
-	return box;
+	return react.createElement("section", { style: styles.box }, react.createElement("div", {
+		style: styles.heading,
+		key: "h"
+	}, "Token comparison (estimate)"), react.createElement("table", {
+		style: styles.table,
+		key: "t"
+	}, ...rows.map(([label, value]) => react.createElement("tr", { key: label }, react.createElement("td", { style: styles.labelCell }, label), react.createElement("td", label === "Net" ? { style: {
+		fontWeight: 600,
+		color: cf.netSaving >= 0 ? "#4ade80" : "#f87171"
+	} } : null, value)))), react.createElement("div", {
+		style: styles.warning,
+		key: "f"
+	}, cf.hasRealUsage ? `Priced against this session's real usage${cf.cacheReadShare === void 0 ? "" : ` (cache-read share ${(cf.cacheReadShare * 100).toFixed(1)}%)`}.` : "This session reported NO provider usage — every figure here is heuristic token counts, not a bill."), react.createElement("details", { key: "a" }, react.createElement("summary", { style: styles.detailsToggle }, "Assumptions"), react.createElement("ul", { style: styles.assumptionList }, ...cf.assumptions.map((assumption, index) => react.createElement("li", { key: String(index) }, assumption)))), props.report.reReads > 0 ? react.createElement("div", {
+		style: styles.reread,
+		key: "r"
+	}, `Re-read signals: ${String(props.report.reReads)} — folded content was fetched again after being folded.`) : null);
 }
-/** The per-fold list, with the original text expandable. */
-function renderFolds(sessionId, report) {
-	const section = document.createElement("section");
-	const heading = document.createElement("div");
-	heading.textContent = `Folded content (${String(report.folds.length)})`;
-	heading.style.cssText = "font-weight:600;margin-bottom:6px";
-	section.append(heading);
-	if (report.folds.length === 0) {
-		const empty = document.createElement("div");
-		empty.style.cssText = "color:#888";
-		empty.textContent = "Nothing has been folded in this session yet.";
-		section.append(empty);
-		return section;
-	}
-	for (const fold of report.folds) {
-		const item = document.createElement("details");
-		item.style.cssText = "margin-bottom:6px;padding:6px;border:1px solid #2a2a2a;border-radius:6px";
-		const summary = document.createElement("summary");
-		summary.style.cssText = "cursor:pointer";
-		summary.textContent = `${fold.kind === "reasoning" ? "reasoning" : fold.toolName ?? "tool"} · turn ${String(fold.turn)}.${String(fold.step)} · ${num(fold.charsBefore)} → ${num(fold.charsAfter)} chars · ${fold.recoverable ? "recoverable" : "NOT recoverable"}`;
-		item.append(summary);
-		const inline = document.createElement("pre");
-		inline.textContent = fold.inline;
-		inline.style.cssText = "white-space:pre-wrap;margin:6px 0;color:#bbb;max-height:12em;overflow:auto";
-		item.append(inline);
-		if (fold.locator !== void 0) {
-			const path = document.createElement("div");
-			path.textContent = fold.locator;
-			path.style.cssText = "color:#666;font-size:11px;word-break:break-all";
-			item.append(path);
-			item.addEventListener("toggle", () => {
-				if (!item.open || item.dataset["loaded"] === "1") return;
-				item.dataset["loaded"] = "1";
-				fetchOriginal(sessionId, fold.locator).then((text) => {
-					const pre = document.createElement("pre");
-					pre.textContent = text ?? "(could not read the stored original)";
-					pre.style.cssText = "white-space:pre-wrap;margin:6px 0;color:#ddd;max-height:24em;overflow:auto;border-top:1px dashed #333;padding-top:6px";
-					item.append(pre);
-				});
-			});
-		} else if (!fold.recoverable) {
-			const warning = document.createElement("div");
-			warning.textContent = "No recovery path: the original is in the session log but no tool exposes it.";
-			warning.style.cssText = "color:#f87171;font-size:11px";
-			item.append(warning);
+/** One fold row; the original text loads when the row is opened. */
+function FoldItem(props) {
+	const { fold, sessionId } = props;
+	const [original, setOriginal] = react.useState(null);
+	const onToggle = (event) => {
+		if (event.currentTarget?.open !== true || original !== null) return;
+		const locator = fold.locator;
+		if (locator === void 0) return;
+		setOriginal("");
+		fetchOriginal(sessionId, locator).then((text) => {
+			setOriginal(text ?? "(could not read the stored original)");
+		});
+	};
+	const summary = `${fold.kind === "reasoning" ? "reasoning" : fold.toolName ?? "tool"} · turn ${String(fold.turn)}.${String(fold.step)} · ${num(fold.charsBefore)} → ${num(fold.charsAfter)} chars · ${fold.recoverable ? "recoverable" : "NOT recoverable"}`;
+	const children = [react.createElement("summary", {
+		style: styles.foldSummary,
+		key: "s"
+	}, summary), react.createElement("pre", {
+		style: styles.inlinePre,
+		key: "i"
+	}, fold.inline)];
+	if (fold.locator !== void 0) {
+		children.push(react.createElement("div", {
+			style: styles.locator,
+			key: "l"
+		}, fold.locator));
+		if (original !== null) children.push(react.createElement("pre", {
+			style: styles.originalPre,
+			key: "o"
+		}, original));
+	} else if (!fold.recoverable) children.push(react.createElement("div", {
+		style: styles.notRecoverable,
+		key: "w"
+	}, "No recovery path: the original is in the session log but no tool exposes it."));
+	return react.createElement("details", {
+		style: styles.fold,
+		onToggle
+	}, ...children);
+}
+/** The per-fold list. */
+function FoldList(props) {
+	const { report, sessionId } = props;
+	const heading = react.createElement("div", {
+		style: styles.heading,
+		key: "h"
+	}, `Folded content (${String(report.folds.length)})`);
+	if (report.folds.length === 0) return react.createElement("section", null, heading, react.createElement("div", {
+		style: styles.muted,
+		key: "e"
+	}, "Nothing has been folded in this session yet."));
+	return react.createElement("section", null, heading, ...report.folds.map((fold) => react.createElement(FoldItem, {
+		key: String(fold.seq),
+		sessionId,
+		fold
+	})));
+}
+/**
+* The tab body.
+*
+* The active session id arrives through the standard slot props, and the report
+* is refetched whenever that id changes because the tab outlives navigation.
+*/
+function ContextFoldTab(props) {
+	const sessionId = sessionIdOf(props);
+	const [state, setState] = react.useState({ status: "loading" });
+	react.useEffect(() => {
+		if (sessionId === void 0) {
+			setState({ status: "empty" });
+			return;
 		}
-		section.append(item);
+		let cancelled = false;
+		setState({ status: "loading" });
+		fetchReport(sessionId).then((report) => {
+			if (cancelled) return;
+			setState(report === void 0 ? { status: "empty" } : {
+				status: "ready",
+				report
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [sessionId]);
+	const children = [react.createElement("div", {
+		style: styles.title,
+		key: "title"
+	}, "Context fold")];
+	if (sessionId === void 0) children.push(react.createElement("div", {
+		style: styles.muted,
+		key: "m"
+	}, "No active session."));
+	else if (state.status === "loading") children.push(react.createElement("div", {
+		style: styles.muted,
+		key: "m"
+	}, "Loading…"));
+	else if (state.status !== "ready" || state.report === void 0) children.push(react.createElement("div", {
+		style: styles.muted,
+		key: "m"
+	}, "No report available for this session."));
+	else {
+		children.push(react.createElement(Summary, {
+			key: "summary",
+			report: state.report
+		}));
+		children.push(react.createElement(FoldList, {
+			key: "folds",
+			sessionId,
+			report: state.report
+		}));
 	}
-	return section;
+	return react.createElement("div", {
+		className: "context-fold-tab",
+		style: styles.root
+	}, ...children);
 }
 /** Client plugin name. */
 const name = "context-fold-client";
@@ -179,14 +281,39 @@ const inject = ["slots", "locale"];
 /**
 * Mount the conversation tab.
 *
+* Dictionaries are registered from inside this bundle: the locale service reads
+* them from the plugin registry, not from `locale/*.json` on disk.
+*
 * @param ctx - client plugin context.
 */
 function apply(ctx) {
+	const registerDictionaries = () => {
+		ctx.locale.register(NS, {
+			zh,
+			en
+		});
+	};
+	if (typeof ctx.effect === "function") ctx.effect(registerDictionaries, "context-fold: dictionaries");
+	else registerDictionaries();
+	const t = (key) => {
+		try {
+			return ctx.locale.bind(NS)(key) || (en[key] ?? key);
+		} catch {
+			return en[key] ?? key;
+		}
+	};
 	ctx.slots.inject("conversation.view", () => ctx.slots.register({
 		name: "conversation.view",
 		id: "context-fold",
 		order: 40,
-		label: () => ctx.locale.get("tab.contextFold")
-	}, renderTab));
+		locale: NS,
+		label: () => t("tab.contextFold")
+	}, ContextFoldTab));
 }
-export { apply, inject, name };
+exports.apply = apply;
+exports.inject = inject;
+exports.name = name;
+
+    return module.exports;
+  },
+});

package/locale/en.json

@@ -1,9 +1,9 @@
-{
-  "meta": {
-    "title": "Context Fold (dsh-context-fold)",
-    "description": "Stage-boundary folding of completed tool results and historical reasoning: conclusions stay in the window, full text moves to a spill file, and /context-fold reports savings and re-reads."
-  },
-  "tab": {
-    "contextFold": "Context fold"
-  }
-}
+{
+  "meta": {
+    "title": "Context Fold (dsh-context-fold)",
+    "description": "Stage-boundary folding of completed tool results and historical reasoning: conclusions stay in the window, full text moves to a spill file, and /context-fold reports savings and re-reads."
+  },
+  "tab": {
+    "contextFold": "Context fold"
+  }
+}

package/locale/zh.json

@@ -1,9 +1,9 @@
-{
-  "meta": {
-    "title": "上下文折叠 (dsh-context-fold)",
-    "description": "阶段边界的 tool 结果与历史 reasoning 折叠：结论留在窗口里，正文落到 spill 文件，用 /context-fold 报告折叠量与被重读次数。"
-  },
-  "tab": {
-    "contextFold": "上下文折叠"
-  }
-}
+{
+  "meta": {
+    "title": "上下文折叠 (dsh-context-fold)",
+    "description": "阶段边界的 tool 结果与历史 reasoning 折叠：结论留在窗口里，正文落到 spill 文件，用 /context-fold 报告折叠量与被重读次数。"
+  },
+  "tab": {
+    "contextFold": "上下文折叠"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-context-fold",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "dsh-context-fold: stage-boundary folding of completed tool results into a conclusion plus a spill path, deterministic and replay-safe.",
   "type": "module",
   "main": "lib/index.js",
@@ -35,6 +35,13 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ]
     }
   },
   "peerDependencies": {