@shuind/dsh-codex-harness 0.1.11 → 0.1.12

package/README.md

@@ -16,11 +16,17 @@ DSH 的通用 `@deepseek-ai/dsh-llm-pi-ai` 继续负责用户配置的 provider
 ## 安装
 
 ```sh
-dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.10
+dsh plugin --profile web add @shuind/dsh-codex-harness@0.1.12
 ```
 
 重启 Web，创建新会话，在模式菜单中选择 `Codex 模式`。
 
+## Fast 与上下文大小
+
+Codex 模式会在模型选择菜单中提供 `Fast` 控制。开启后，GPT Responses 请求会携带 `service_tier: "priority"`；它不是思考强度，也不会修改 `reasoning_effort`。该设置按 `codex` 设置命名空间保存，并作用于之后的请求。其他 preset 不会显示 Fast。
+
+点击上下文使用量指示器可以展开上下文设置。上下文大小使用整数 K tokens，可通过滑块或数字输入设置，范围为 `1K` 到 `1000K`；恢复模型默认值会删除覆盖。设置值用于下一次请求；上方的上下文 meter 显示当前请求实际使用的容量，因此修改设置后要发送下一次请求，上方的分母才会更新。这个值同时用于上下文容量投影、token meter、compaction 判断和适配器的响应 token 统计，而不只是修改显示文本。实际使用前请确认中转站和模型支持所选容量。
+
 ## 中转站配置
 
 请继续在 DSH 的 Models/`llm-pi-ai` 配置中填写你的 Responses 中转站地址、API key 和模型。例如 provider 下配置 `api: openai-responses`、`baseURL`、`apiKeyEnv`，并在 `models` 中填写中转站实际支持的 GPT 模型 id。Codex 模式不会替换这些配置。

package/lib/client.js

@@ -0,0 +1,633 @@
+window.__ModuleLoader__.load({
+	id: "@shuind/dsh-codex-harness",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperties(exports, {
+			__esModule: { value: true },
+			[Symbol.toStringTag]: { value: "Module" }
+		});
+		//#region \0rolldown/runtime.js
+		var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+		//#endregion
+		//#region node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react.production.min.js
+		/**
+		* @license React
+		* react.production.min.js
+		*
+		* Copyright (c) Facebook, Inc. and its affiliates.
+		*
+		* This source code is licensed under the MIT license found in the
+		* LICENSE file in the root directory of this source tree.
+		*/
+		var require_react_production_min = /* @__PURE__ */ __commonJSMin(((exports) => {
+			var l = Symbol.for("react.element");
+			var n = Symbol.for("react.portal");
+			var p = Symbol.for("react.fragment");
+			var q = Symbol.for("react.strict_mode");
+			var r = Symbol.for("react.profiler");
+			var t = Symbol.for("react.provider");
+			var u = Symbol.for("react.context");
+			var v = Symbol.for("react.forward_ref");
+			var w = Symbol.for("react.suspense");
+			var x = Symbol.for("react.memo");
+			var y = Symbol.for("react.lazy");
+			var z = Symbol.iterator;
+			function A(a) {
+				if (null === a || "object" !== typeof a) return null;
+				a = z && a[z] || a["@@iterator"];
+				return "function" === typeof a ? a : null;
+			}
+			var B = {
+				isMounted: function() {
+					return !1;
+				},
+				enqueueForceUpdate: function() {},
+				enqueueReplaceState: function() {},
+				enqueueSetState: function() {}
+			};
+			var C = Object.assign;
+			var D = {};
+			function E(a, b, e) {
+				this.props = a;
+				this.context = b;
+				this.refs = D;
+				this.updater = e || B;
+			}
+			E.prototype.isReactComponent = {};
+			E.prototype.setState = function(a, b) {
+				if ("object" !== typeof a && "function" !== typeof a && null != a) throw Error("setState(...): takes an object of state variables to update or a function which returns an object of state variables.");
+				this.updater.enqueueSetState(this, a, b, "setState");
+			};
+			E.prototype.forceUpdate = function(a) {
+				this.updater.enqueueForceUpdate(this, a, "forceUpdate");
+			};
+			function F() {}
+			F.prototype = E.prototype;
+			function G(a, b, e) {
+				this.props = a;
+				this.context = b;
+				this.refs = D;
+				this.updater = e || B;
+			}
+			var H = G.prototype = new F();
+			H.constructor = G;
+			C(H, E.prototype);
+			H.isPureReactComponent = !0;
+			var I = Array.isArray;
+			var J = Object.prototype.hasOwnProperty;
+			var K = { current: null };
+			var L = {
+				key: !0,
+				ref: !0,
+				__self: !0,
+				__source: !0
+			};
+			function M(a, b, e) {
+				var d, c = {}, k = null, h = null;
+				if (null != b) for (d in void 0 !== b.ref && (h = b.ref), void 0 !== b.key && (k = "" + b.key), b) J.call(b, d) && !L.hasOwnProperty(d) && (c[d] = b[d]);
+				var g = arguments.length - 2;
+				if (1 === g) c.children = e;
+				else if (1 < g) {
+					for (var f = Array(g), m = 0; m < g; m++) f[m] = arguments[m + 2];
+					c.children = f;
+				}
+				if (a && a.defaultProps) for (d in g = a.defaultProps, g) void 0 === c[d] && (c[d] = g[d]);
+				return {
+					$$typeof: l,
+					type: a,
+					key: k,
+					ref: h,
+					props: c,
+					_owner: K.current
+				};
+			}
+			function N(a, b) {
+				return {
+					$$typeof: l,
+					type: a.type,
+					key: b,
+					ref: a.ref,
+					props: a.props,
+					_owner: a._owner
+				};
+			}
+			function O(a) {
+				return "object" === typeof a && null !== a && a.$$typeof === l;
+			}
+			function escape(a) {
+				var b = {
+					"=": "=0",
+					":": "=2"
+				};
+				return "$" + a.replace(/[=:]/g, function(a) {
+					return b[a];
+				});
+			}
+			var P = /\/+/g;
+			function Q(a, b) {
+				return "object" === typeof a && null !== a && null != a.key ? escape("" + a.key) : b.toString(36);
+			}
+			function R(a, b, e, d, c) {
+				var k = typeof a;
+				if ("undefined" === k || "boolean" === k) a = null;
+				var h = !1;
+				if (null === a) h = !0;
+				else switch (k) {
+					case "string":
+					case "number":
+						h = !0;
+						break;
+					case "object": switch (a.$$typeof) {
+						case l:
+						case n: h = !0;
+					}
+				}
+				if (h) return h = a, c = c(h), a = "" === d ? "." + Q(h, 0) : d, I(c) ? (e = "", null != a && (e = a.replace(P, "$&/") + "/"), R(c, b, e, "", function(a) {
+					return a;
+				})) : null != c && (O(c) && (c = N(c, e + (!c.key || h && h.key === c.key ? "" : ("" + c.key).replace(P, "$&/") + "/") + a)), b.push(c)), 1;
+				h = 0;
+				d = "" === d ? "." : d + ":";
+				if (I(a)) for (var g = 0; g < a.length; g++) {
+					k = a[g];
+					var f = d + Q(k, g);
+					h += R(k, b, e, f, c);
+				}
+				else if (f = A(a), "function" === typeof f) for (a = f.call(a), g = 0; !(k = a.next()).done;) k = k.value, f = d + Q(k, g++), h += R(k, b, e, f, c);
+				else if ("object" === k) throw b = String(a), Error("Objects are not valid as a React child (found: " + ("[object Object]" === b ? "object with keys {" + Object.keys(a).join(", ") + "}" : b) + "). If you meant to render a collection of children, use an array instead.");
+				return h;
+			}
+			function S(a, b, e) {
+				if (null == a) return a;
+				var d = [], c = 0;
+				R(a, d, "", "", function(a) {
+					return b.call(e, a, c++);
+				});
+				return d;
+			}
+			function T(a) {
+				if (-1 === a._status) {
+					var b = a._result;
+					b = b();
+					b.then(function(b) {
+						if (0 === a._status || -1 === a._status) a._status = 1, a._result = b;
+					}, function(b) {
+						if (0 === a._status || -1 === a._status) a._status = 2, a._result = b;
+					});
+					-1 === a._status && (a._status = 0, a._result = b);
+				}
+				if (1 === a._status) return a._result.default;
+				throw a._result;
+			}
+			var U = { current: null };
+			var V = { transition: null };
+			var W = {
+				ReactCurrentDispatcher: U,
+				ReactCurrentBatchConfig: V,
+				ReactCurrentOwner: K
+			};
+			function X() {
+				throw Error("act(...) is not supported in production builds of React.");
+			}
+			exports.Children = {
+				map: S,
+				forEach: function(a, b, e) {
+					S(a, function() {
+						b.apply(this, arguments);
+					}, e);
+				},
+				count: function(a) {
+					var b = 0;
+					S(a, function() {
+						b++;
+					});
+					return b;
+				},
+				toArray: function(a) {
+					return S(a, function(a) {
+						return a;
+					}) || [];
+				},
+				only: function(a) {
+					if (!O(a)) throw Error("React.Children.only expected to receive a single React element child.");
+					return a;
+				}
+			};
+			exports.Component = E;
+			exports.Fragment = p;
+			exports.Profiler = r;
+			exports.PureComponent = G;
+			exports.StrictMode = q;
+			exports.Suspense = w;
+			exports.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED = W;
+			exports.act = X;
+			exports.cloneElement = function(a, b, e) {
+				if (null === a || void 0 === a) throw Error("React.cloneElement(...): The argument must be a React element, but you passed " + a + ".");
+				var d = C({}, a.props), c = a.key, k = a.ref, h = a._owner;
+				if (null != b) {
+					void 0 !== b.ref && (k = b.ref, h = K.current);
+					void 0 !== b.key && (c = "" + b.key);
+					if (a.type && a.type.defaultProps) var g = a.type.defaultProps;
+					for (f in b) J.call(b, f) && !L.hasOwnProperty(f) && (d[f] = void 0 === b[f] && void 0 !== g ? g[f] : b[f]);
+				}
+				var f = arguments.length - 2;
+				if (1 === f) d.children = e;
+				else if (1 < f) {
+					g = Array(f);
+					for (var m = 0; m < f; m++) g[m] = arguments[m + 2];
+					d.children = g;
+				}
+				return {
+					$$typeof: l,
+					type: a.type,
+					key: c,
+					ref: k,
+					props: d,
+					_owner: h
+				};
+			};
+			exports.createContext = function(a) {
+				a = {
+					$$typeof: u,
+					_currentValue: a,
+					_currentValue2: a,
+					_threadCount: 0,
+					Provider: null,
+					Consumer: null,
+					_defaultValue: null,
+					_globalName: null
+				};
+				a.Provider = {
+					$$typeof: t,
+					_context: a
+				};
+				return a.Consumer = a;
+			};
+			exports.createElement = M;
+			exports.createFactory = function(a) {
+				var b = M.bind(null, a);
+				b.type = a;
+				return b;
+			};
+			exports.createRef = function() {
+				return { current: null };
+			};
+			exports.forwardRef = function(a) {
+				return {
+					$$typeof: v,
+					render: a
+				};
+			};
+			exports.isValidElement = O;
+			exports.lazy = function(a) {
+				return {
+					$$typeof: y,
+					_payload: {
+						_status: -1,
+						_result: a
+					},
+					_init: T
+				};
+			};
+			exports.memo = function(a, b) {
+				return {
+					$$typeof: x,
+					type: a,
+					compare: void 0 === b ? null : b
+				};
+			};
+			exports.startTransition = function(a) {
+				var b = V.transition;
+				V.transition = {};
+				try {
+					a();
+				} finally {
+					V.transition = b;
+				}
+			};
+			exports.unstable_act = X;
+			exports.useCallback = function(a, b) {
+				return U.current.useCallback(a, b);
+			};
+			exports.useContext = function(a) {
+				return U.current.useContext(a);
+			};
+			exports.useDebugValue = function() {};
+			exports.useDeferredValue = function(a) {
+				return U.current.useDeferredValue(a);
+			};
+			exports.useEffect = function(a, b) {
+				return U.current.useEffect(a, b);
+			};
+			exports.useId = function() {
+				return U.current.useId();
+			};
+			exports.useImperativeHandle = function(a, b, e) {
+				return U.current.useImperativeHandle(a, b, e);
+			};
+			exports.useInsertionEffect = function(a, b) {
+				return U.current.useInsertionEffect(a, b);
+			};
+			exports.useLayoutEffect = function(a, b) {
+				return U.current.useLayoutEffect(a, b);
+			};
+			exports.useMemo = function(a, b) {
+				return U.current.useMemo(a, b);
+			};
+			exports.useReducer = function(a, b, e) {
+				return U.current.useReducer(a, b, e);
+			};
+			exports.useRef = function(a) {
+				return U.current.useRef(a);
+			};
+			exports.useState = function(a) {
+				return U.current.useState(a);
+			};
+			exports.useSyncExternalStore = function(a, b, e) {
+				return U.current.useSyncExternalStore(a, b, e);
+			};
+			exports.useTransition = function() {
+				return U.current.useTransition();
+			};
+			exports.version = "18.3.1";
+		}));
+		//#endregion
+		//#region node_modules/.pnpm/react@18.3.1/node_modules/react/index.js
+		var require_react = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+			module.exports = require_react_production_min();
+		}));
+		//#endregion
+		//#region node_modules/.pnpm/react@18.3.1/node_modules/react/cjs/react-jsx-runtime.production.min.js
+		/**
+		* @license React
+		* react-jsx-runtime.production.min.js
+		*
+		* Copyright (c) Facebook, Inc. and its affiliates.
+		*
+		* This source code is licensed under the MIT license found in the
+		* LICENSE file in the root directory of this source tree.
+		*/
+		var require_react_jsx_runtime_production_min = /* @__PURE__ */ __commonJSMin(((exports) => {
+			var f = require_react();
+			var k = Symbol.for("react.element");
+			var m = Object.prototype.hasOwnProperty;
+			var n = f.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner;
+			var p = {
+				key: !0,
+				ref: !0,
+				__self: !0,
+				__source: !0
+			};
+			function q(c, a, g) {
+				var b, d = {}, e = null, h = null;
+				void 0 !== g && (e = "" + g);
+				void 0 !== a.key && (e = "" + a.key);
+				void 0 !== a.ref && (h = a.ref);
+				for (b in a) m.call(a, b) && !p.hasOwnProperty(b) && (d[b] = a[b]);
+				if (c && c.defaultProps) for (b in a = c.defaultProps, a) void 0 === d[b] && (d[b] = a[b]);
+				return {
+					$$typeof: k,
+					type: c,
+					key: e,
+					ref: h,
+					props: d,
+					_owner: n.current
+				};
+			}
+			exports.jsx = q;
+			exports.jsxs = q;
+		}));
+		//#endregion
+		//#region lib/types/context.js
+		var import_jsx_runtime = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
+			module.exports = require_react_jsx_runtime_production_min();
+		})))();
+		/** User-selectable Codex context controls use whole K-token units. */
+		const CODEX_CONTEXT_UNIT = 1e3;
+		const CODEX_CONTEXT_MAX = 1e6;
+		//#endregion
+		//#region lib/types/client/index.js
+		const NS = "codex";
+		const SETTINGS_NAMESPACE = "codex";
+		const en = {
+			fast: "Fast mode",
+			fastOn: "Fast mode on (priority tier)",
+			fastOff: "Fast mode off",
+			fastStateOn: "On",
+			fastStateOff: "Off",
+			contextSize: "Context size",
+			contextSizeDescription: "Next request capacity in K tokens. The meter above is current.",
+			contextRestore: "Restore model default"
+		};
+		const zh = {
+			fast: "Fast",
+			fastOn: "Fast mode on (priority tier)",
+			fastOff: "Fast mode off",
+			fastStateOn: "开",
+			fastStateOff: "关",
+			contextSize: "上下文大小",
+			contextSizeDescription: "设置下次请求的上下文容量，单位为 K tokens；上方是当前请求。",
+			contextRestore: "恢复模型默认值"
+		};
+		function FastModeButton({ sessionId, useSessions, useSettings, setSetting, t }) {
+			const agentPreset = useSessions((state) => state.byId[sessionId]?.agentPreset);
+			const snapshot = useSettings((state) => state);
+			const fast = snapshot.value?.fast ?? false;
+			if (agentPreset !== "codex") return null;
+			return (0, import_jsx_runtime.jsxs)("button", {
+				type: "button",
+				role: "menuitemcheckbox",
+				disabled: snapshot.writable === false,
+				"aria-pressed": fast,
+				"aria-label": fast ? t("fastOn") : t("fastOff"),
+				title: fast ? t("fastOn") : t("fastOff"),
+				onClick: () => {
+					setSetting("fast", !fast);
+				},
+				style: {
+					boxSizing: "border-box",
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "space-between",
+					width: "100%",
+					height: 40,
+					border: 0,
+					borderRadius: 10,
+					padding: "0 10px",
+					color: fast ? "var(--dsw-static-blue-500)" : "var(--dsw-alias-label-secondary)",
+					background: fast ? "var(--dsw-alias-interactive-bg-selected)" : "transparent",
+					cursor: snapshot.writable === false ? "default" : "pointer",
+					font: "inherit",
+					fontSize: 14,
+					lineHeight: "22px",
+					fontWeight: fast ? 600 : 400,
+					textAlign: "left"
+				},
+				children: [(0, import_jsx_runtime.jsx)("span", { children: t("fast") }), (0, import_jsx_runtime.jsx)("span", {
+					style: {
+						color: "var(--dsw-alias-label-tertiary)",
+						fontSize: 12
+					},
+					children: fast ? t("fastStateOn") : t("fastStateOff")
+				})]
+			});
+		}
+		function ContextSizeControl({ contextWindow, useSettings, setSetting, unsetSetting, t }) {
+			const snapshot = useSettings((state) => state);
+			const configured = snapshot.value?.contextWindow;
+			const maxK = CODEX_CONTEXT_MAX / CODEX_CONTEXT_UNIT;
+			const valueK = Math.min(maxK, Math.max(1, Math.round((configured ?? contextWindow) / CODEX_CONTEXT_UNIT)));
+			const setValueK = (nextK) => {
+				if (!Number.isFinite(nextK)) return;
+				const normalized = Math.min(maxK, Math.max(1, Math.trunc(nextK))) * CODEX_CONTEXT_UNIT;
+				if (normalized === contextWindow) unsetSetting("contextWindow");
+				else setSetting("contextWindow", normalized);
+			};
+			return (0, import_jsx_runtime.jsxs)("div", {
+				style: {
+					marginTop: 10,
+					display: "grid",
+					gap: 5
+				},
+				children: [
+					(0, import_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							alignItems: "baseline",
+							justifyContent: "space-between",
+							gap: 12
+						},
+						children: [(0, import_jsx_runtime.jsx)("strong", {
+							style: {
+								color: "var(--dsw-alias-label-primary)",
+								fontSize: 12
+							},
+							children: t("contextSize")
+						}), (0, import_jsx_runtime.jsxs)("span", {
+							style: {
+								color: "var(--dsw-alias-label-secondary)",
+								fontSize: 11
+							},
+							children: [valueK, "K"]
+						})]
+					}),
+					(0, import_jsx_runtime.jsx)("input", {
+						type: "range",
+						min: 1,
+						max: maxK,
+						step: 1,
+						value: valueK,
+						disabled: snapshot.writable === false,
+						"aria-label": t("contextSize"),
+						onChange: (event) => {
+							setValueK(Number(event.target.value));
+						}
+					}),
+					(0, import_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							alignItems: "center",
+							gap: 7
+						},
+						children: [
+							(0, import_jsx_runtime.jsx)("input", {
+								type: "number",
+								min: 1,
+								max: maxK,
+								step: 1,
+								value: valueK,
+								disabled: snapshot.writable === false,
+								"aria-label": t("contextSize"),
+								onChange: (event) => {
+									setValueK(Number(event.target.value));
+								},
+								style: {
+									width: 76,
+									border: "1px solid var(--dsw-alias-border-primary)",
+									borderRadius: 5,
+									padding: "3px 5px",
+									color: "var(--dsw-alias-label-primary)",
+									background: "var(--dsw-alias-fill-primary)",
+									font: "inherit",
+									fontSize: 11
+								}
+							}),
+							(0, import_jsx_runtime.jsx)("span", {
+								style: {
+									color: "var(--dsw-alias-label-secondary)",
+									fontSize: 11
+								},
+								children: "K"
+							}),
+							(0, import_jsx_runtime.jsx)("span", {
+								style: {
+									color: "var(--dsw-alias-label-secondary)",
+									fontSize: 11
+								},
+								children: t("contextSizeDescription")
+							})
+						]
+					}),
+					configured !== void 0 && (0, import_jsx_runtime.jsx)("button", {
+						type: "button",
+						onClick: () => {
+							unsetSetting("contextWindow");
+						},
+						style: {
+							justifySelf: "start",
+							border: 0,
+							padding: 0,
+							color: "var(--dsw-static-blue-500)",
+							background: "transparent",
+							cursor: "pointer",
+							font: "inherit",
+							fontSize: 11
+						},
+						children: t("contextRestore")
+					})
+				]
+			});
+		}
+		const inject = [
+			"slots",
+			"locale",
+			"settingsScope"
+		];
+		/** Mount Fast inside the model selector and context size inside the meter panel. */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				en,
+				zh
+			}), "codex client: dictionaries");
+			const settings = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+			const injected = () => ({
+				hooks: { settings },
+				setSetting: (field, value) => settings.set(field, value),
+				unsetSetting: (field) => settings.unset(field)
+			});
+			ctx.slots.inject("conversation.input.model.settings", () => ctx.slots.register({
+				name: "conversation.input.model.settings",
+				id: "codex-fast",
+				order: 0,
+				locale: NS,
+				inject: injected
+			}, FastModeButton));
+			ctx.slots.inject("conversation.input.context.settings", () => ctx.slots.register({
+				name: "conversation.input.context.settings",
+				id: "codex-context-size",
+				order: 0,
+				locale: NS,
+				inject: injected
+			}, ContextSizeControl));
+		}
+		var client_default = {
+			inject,
+			apply
+		};
+		//#endregion
+		exports.apply = apply;
+		exports.default = client_default;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -1,10 +1,12 @@
 import z from "@deepseek-ai/schemastery";
-import { settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import { randomBytes } from "node:crypto";
 import { resolve } from "node:path";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { AsyncLocalStorage } from "node:async_hooks";
+//#region lib/types/context.js
+const CODEX_CONTEXT_MAX = 1e6;
 String.raw`start: begin_patch hunk+ end_patch
 begin_patch: "*** Begin Patch" LF
 end_patch: "*** End Patch" LF?
@@ -714,7 +716,8 @@ const inject = [
 	"shell",
 	"fs",
 	"llm",
-	"credentials"
+	"credentials",
+	"settings"
 ];
 /** Runtime configuration schema for the Codex tool bridge. */
 const Config = z.object({
@@ -726,6 +729,13 @@ const Config = z.object({
 	remoteCompact: z.boolean().default(true)
 });
 const LLM_PI_AI_SETTINGS = settingsNamespace("llm-pi-ai");
+/** Live Codex-only request controls shared by the Web controls and agent layer. */
+const CODEX_SETTINGS_NAMESPACE = settingsNamespace("codex");
+const CODEX_SETTINGS_SCHEMA = z.object({
+	fast: z.boolean().default(false),
+	contextWindow: z.number().step(1).min(1).max(CODEX_CONTEXT_MAX)
+});
+const CODEX_SETTINGS_ENTRY = { fast: false };
 const GPT_REASONING_EFFORTS = {
 	low: "low",
 	medium: "medium",
@@ -809,6 +819,27 @@ function watchConfiguredGptModels(ctx) {
 	});
 	schedule();
 }
+/** Install the optional settings source used by the request waterfall. */
+function installCodexSettings(ctx) {
+	let source = () => CODEX_SETTINGS_ENTRY;
+	installSettingsSection(ctx, CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, CODEX_SETTINGS_ENTRY, {
+		setSource: (current) => {
+			source = current;
+		},
+		onChange: () => {}
+	});
+	return { current: () => source() };
+}
+/** Apply the live Codex controls to one agent request without leaking them to other routes. */
+function applyCodexRequestSettings(request, settings) {
+	const { contextWindow: _inheritedContextWindow, serviceTier: _inheritedServiceTier, ...withoutCodexControls } = request;
+	if (!isGptModel(request.model)) return withoutCodexControls;
+	return {
+		...withoutCodexControls,
+		...settings.contextWindow === void 0 ? {} : { contextWindow: settings.contextWindow },
+		...settings.fast ? { serviceTier: "priority" } : {}
+	};
+}
 const CODEX_BASE_PROMPT = String.raw`You are Codex, based on {{model}}. You are running as a coding agent in dsh Web on a user's computer.
 
 ## General
@@ -1221,15 +1252,19 @@ function apply(ctx, config = {}) {
 	};
 	if (ctx.fs.sandboxMode !== void 0 && ctx.get("sandboxPolicy") === void 0) throw new Error("codex: a sandboxing filesystem requires ctx.sandboxPolicy");
 	watchConfiguredGptModels(ctx);
+	const codexSettings = installCodexSettings(ctx);
+	ctx.on("agent/request", async (_payload, next) => {
+		return applyCodexRequestSettings(await next(), codexSettings.current());
+	});
 	if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === "function") {
 		const disposeHostedWebSearch = installHostedWebSearch();
 		ctx.effect(() => disposeHostedWebSearch, "codex: Responses transport wrapper");
 	}
-	if (resolved.hostedWebSearch || resolved.remoteCompact) ctx.on("llm/stream", (options, next) => {
+	if (resolved.hostedWebSearch || resolved.remoteCompact) ctx.on("llm/stream", ((options, next) => {
 		if (resolved.remoteCompact && options.purpose === "compaction" && isGptModel(options.model)) return remoteCompactStream(ctx, options, next);
 		if ((resolved.hostedWebSearch || resolved.remoteCompact) && options.purpose === void 0 && isGptModel(options.model)) return hostedWebSearchStream(next);
 		return next();
-	});
+	}));
 	ctx.systemPrompt.section({
 		name: "codex:base",
 		order: 10,
@@ -1246,4 +1281,4 @@ var types_default = {
 	apply
 };
 //#endregion
-export { Config, apply, types_default as default, enrichCodexModel, inject, name };
+export { CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, Config, apply, applyCodexRequestSettings, types_default as default, enrichCodexModel, inject, name };

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

@@ -0,0 +1,40 @@
+/** Browser controls for the Codex request settings mounted by the Host plugin. */
+import type { Context } from '@deepseek-ai/cordis';
+declare const en: {
+    readonly fast: "Fast mode";
+    readonly fastOn: "Fast mode on (priority tier)";
+    readonly fastOff: "Fast mode off";
+    readonly fastStateOn: "On";
+    readonly fastStateOff: "Off";
+    readonly contextSize: "Context size";
+    readonly contextSizeDescription: "Next request capacity in K tokens. The meter above is current.";
+    readonly contextRestore: "Restore model default";
+};
+type CodexKey = keyof typeof en;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        codex: CodexKey;
+    }
+    interface SlotMap {
+        'conversation.input.model.settings': {
+            kind: 'list';
+            scope: 'session';
+        };
+        'conversation.input.context.settings': {
+            kind: 'list';
+            scope: 'session';
+            owner: {
+                contextWindow: number;
+            };
+        };
+    }
+}
+export declare const inject: string[];
+/** Mount Fast inside the model selector and context size inside the meter panel. */
+export declare function apply(ctx: Context): void;
+declare const _default: {
+    inject: string[];
+    apply: typeof apply;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,112 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CODEX_CONTEXT_MAX, CODEX_CONTEXT_UNIT, CODEX_PRESET_ID } from "../context.js";
+const NS = 'codex';
+const SETTINGS_NAMESPACE = 'codex';
+const en = {
+    fast: 'Fast mode',
+    fastOn: 'Fast mode on (priority tier)',
+    fastOff: 'Fast mode off',
+    fastStateOn: 'On',
+    fastStateOff: 'Off',
+    contextSize: 'Context size',
+    contextSizeDescription: 'Next request capacity in K tokens. The meter above is current.',
+    contextRestore: 'Restore model default',
+};
+const zh = {
+    fast: 'Fast',
+    fastOn: 'Fast mode on (priority tier)',
+    fastOff: 'Fast mode off',
+    fastStateOn: '开',
+    fastStateOff: '关',
+    contextSize: '上下文大小',
+    contextSizeDescription: '设置下次请求的上下文容量，单位为 K tokens；上方是当前请求。',
+    contextRestore: '恢复模型默认值',
+};
+function FastModeButton({ sessionId, useSessions, useSettings, setSetting, t }) {
+    const agentPreset = useSessions(state => state.byId[sessionId]?.agentPreset);
+    const snapshot = useSettings(state => state);
+    const fast = snapshot.value?.fast ?? false;
+    if (agentPreset !== CODEX_PRESET_ID)
+        return null;
+    return (_jsxs("button", { type: "button", role: "menuitemcheckbox", disabled: snapshot.writable === false, "aria-pressed": fast, "aria-label": fast ? t('fastOn') : t('fastOff'), title: fast ? t('fastOn') : t('fastOff'), onClick: () => { void setSetting('fast', !fast); }, style: {
+            boxSizing: 'border-box',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'space-between',
+            width: '100%',
+            height: 40,
+            border: 0,
+            borderRadius: 10,
+            padding: '0 10px',
+            color: fast ? 'var(--dsw-static-blue-500)' : 'var(--dsw-alias-label-secondary)',
+            background: fast ? 'var(--dsw-alias-interactive-bg-selected)' : 'transparent',
+            cursor: snapshot.writable === false ? 'default' : 'pointer',
+            font: 'inherit',
+            fontSize: 14,
+            lineHeight: '22px',
+            fontWeight: fast ? 600 : 400,
+            textAlign: 'left',
+        }, children: [_jsx("span", { children: t('fast') }), _jsx("span", { style: { color: 'var(--dsw-alias-label-tertiary)', fontSize: 12 }, children: fast ? t('fastStateOn') : t('fastStateOff') })] }));
+}
+function ContextSizeControl({ contextWindow, useSettings, setSetting, unsetSetting, t }) {
+    const snapshot = useSettings(state => state);
+    const configured = snapshot.value?.contextWindow;
+    const maxK = CODEX_CONTEXT_MAX / CODEX_CONTEXT_UNIT;
+    const valueK = Math.min(maxK, Math.max(1, Math.round((configured ?? contextWindow) / CODEX_CONTEXT_UNIT)));
+    const setValueK = (nextK) => {
+        if (!Number.isFinite(nextK))
+            return;
+        const normalizedK = Math.min(maxK, Math.max(1, Math.trunc(nextK)));
+        const normalized = normalizedK * CODEX_CONTEXT_UNIT;
+        if (normalized === contextWindow)
+            void unsetSetting('contextWindow');
+        else
+            void setSetting('contextWindow', normalized);
+    };
+    return (_jsxs("div", { style: { marginTop: 10, display: 'grid', gap: 5 }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'baseline', justifyContent: 'space-between', gap: 12 }, children: [_jsx("strong", { style: { color: 'var(--dsw-alias-label-primary)', fontSize: 12 }, children: t('contextSize') }), _jsxs("span", { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 11 }, children: [valueK, "K"] })] }), _jsx("input", { type: "range", min: 1, max: maxK, step: 1, value: valueK, disabled: snapshot.writable === false, "aria-label": t('contextSize'), onChange: event => { setValueK(Number(event.target.value)); } }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 7 }, children: [_jsx("input", { type: "number", min: 1, max: maxK, step: 1, value: valueK, disabled: snapshot.writable === false, "aria-label": t('contextSize'), onChange: event => { setValueK(Number(event.target.value)); }, style: {
+                            width: 76,
+                            border: '1px solid var(--dsw-alias-border-primary)',
+                            borderRadius: 5,
+                            padding: '3px 5px',
+                            color: 'var(--dsw-alias-label-primary)',
+                            background: 'var(--dsw-alias-fill-primary)',
+                            font: 'inherit',
+                            fontSize: 11,
+                        } }), _jsx("span", { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 11 }, children: "K" }), _jsx("span", { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 11 }, children: t('contextSizeDescription') })] }), configured !== undefined && (_jsx("button", { type: "button", onClick: () => { void unsetSetting('contextWindow'); }, style: {
+                    justifySelf: 'start',
+                    border: 0,
+                    padding: 0,
+                    color: 'var(--dsw-static-blue-500)',
+                    background: 'transparent',
+                    cursor: 'pointer',
+                    font: 'inherit',
+                    fontSize: 11,
+                }, children: t('contextRestore') }))] }));
+}
+export const inject = ['slots', 'locale', 'settingsScope'];
+/** Mount Fast inside the model selector and context size inside the meter panel. */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'codex client: dictionaries');
+    const settings = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+    const injected = () => ({
+        hooks: { settings },
+        setSetting: (field, value) => settings.set(field, value),
+        unsetSetting: (field) => settings.unset(field),
+    });
+    ctx.slots.inject('conversation.input.model.settings', () => ctx.slots.register({
+        name: 'conversation.input.model.settings',
+        id: 'codex-fast',
+        order: 0,
+        locale: NS,
+        inject: injected,
+    }, FastModeButton));
+    ctx.slots.inject('conversation.input.context.settings', () => ctx.slots.register({
+        name: 'conversation.input.context.settings',
+        id: 'codex-context-size',
+        order: 0,
+        locale: NS,
+        inject: injected,
+    }, ContextSizeControl));
+}
+export default { inject, apply };
+//# sourceMappingURL=index.js.map

package/lib/types/context.d.ts

@@ -0,0 +1,5 @@
+/** User-selectable Codex context controls use whole K-token units. */
+export declare const CODEX_CONTEXT_UNIT = 1000;
+export declare const CODEX_CONTEXT_MAX = 1000000;
+export declare const CODEX_PRESET_ID = "codex";
+//# sourceMappingURL=context.d.ts.map

package/lib/types/context.js

@@ -0,0 +1,5 @@
+/** User-selectable Codex context controls use whole K-token units. */
+export const CODEX_CONTEXT_UNIT = 1_000;
+export const CODEX_CONTEXT_MAX = 1_000_000;
+export const CODEX_PRESET_ID = 'codex';
+//# sourceMappingURL=context.js.map

package/lib/types/index.d.ts

@@ -1,6 +1,15 @@
 /** Codex-compatible prompt overlay and core tools for a dsh agent preset. */
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
+import type { LlmCallConfig } from '@deepseek-ai/dsh-llm';
+declare module '@deepseek-ai/dsh-llm' {
+    interface LlmCallConfig {
+        /** Codex request context capacity override, in tokens. */
+        contextWindow?: number;
+        /** Provider-facing service tier, for example Responses `priority`. */
+        serviceTier?: string;
+    }
+}
 export declare const name = "codex";
 export declare const inject: string[];
 /** Configuration for the Codex shell result bridge. */
@@ -20,6 +29,15 @@ export interface Config {
 }
 /** Runtime configuration schema for the Codex tool bridge. */
 export declare const Config: z<Config>;
+/** Live Codex-only request controls shared by the Web controls and agent layer. */
+export declare const CODEX_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+export interface CodexSettings {
+    /** Use the Responses priority service tier for GPT requests. */
+    fast: boolean;
+    /** Optional context capacity override, in tokens. */
+    contextWindow?: number;
+}
+export declare const CODEX_SETTINGS_SCHEMA: z<CodexSettings>;
 export interface CodexModelProfile {
     id: string;
     input?: string[];
@@ -28,6 +46,8 @@ export interface CodexModelProfile {
 }
 /** Add Codex defaults without overwriting explicit user capabilities. */
 export declare function enrichCodexModel(model: CodexModelProfile): CodexModelProfile;
+/** Apply the live Codex controls to one agent request without leaking them to other routes. */
+export declare function applyCodexRequestSettings(request: LlmCallConfig, settings: CodexSettings): LlmCallConfig;
 /** Mount the Codex prompt/tool layer inside one fixed agent preset. */
 export declare function apply(ctx: Context, config?: Config): void;
 declare const _default: {

package/lib/types/index.js

@@ -1,12 +1,13 @@
 /** Codex-compatible prompt overlay and core tools for a dsh agent preset. */
 import z from '@deepseek-ai/schemastery';
-import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings';
 import { defineTool } from '@deepseek-ai/dsh-tools';
+import { CODEX_CONTEXT_MAX } from "./context.js";
 import { applyPatchHunks, parsePatch } from "./patch.js";
 import { renderExecResult, runExecCommand, runWriteStdin } from "./exec.js";
 import { hostedWebSearchStream, installHostedWebSearch, remoteCompactStream } from "./remote.js";
 export const name = 'codex';
-export const inject = ['tools', 'systemPrompt', 'shell', 'fs', 'llm', 'credentials'];
+export const inject = ['tools', 'systemPrompt', 'shell', 'fs', 'llm', 'credentials', 'settings'];
 /** Runtime configuration schema for the Codex tool bridge. */
 export const Config = z.object({
     defaultYieldTimeMs: z.number().step(1).min(0).default(10_000),
@@ -17,6 +18,13 @@ export const Config = z.object({
     remoteCompact: z.boolean().default(true),
 });
 const LLM_PI_AI_SETTINGS = settingsNamespace('llm-pi-ai');
+/** Live Codex-only request controls shared by the Web controls and agent layer. */
+export const CODEX_SETTINGS_NAMESPACE = settingsNamespace('codex');
+export const CODEX_SETTINGS_SCHEMA = z.object({
+    fast: z.boolean().default(false),
+    contextWindow: z.number().step(1).min(1).max(CODEX_CONTEXT_MAX),
+});
+const CODEX_SETTINGS_ENTRY = { fast: false };
 const GPT_REASONING_EFFORTS = {
     low: 'low',
     medium: 'medium',
@@ -108,6 +116,26 @@ function watchConfiguredGptModels(ctx) {
     });
     schedule();
 }
+/** Install the optional settings source used by the request waterfall. */
+function installCodexSettings(ctx) {
+    let source = () => CODEX_SETTINGS_ENTRY;
+    installSettingsSection(ctx, CODEX_SETTINGS_NAMESPACE, CODEX_SETTINGS_SCHEMA, CODEX_SETTINGS_ENTRY, {
+        setSource: (current) => { source = current; },
+        onChange: () => { },
+    });
+    return { current: () => source() };
+}
+/** Apply the live Codex controls to one agent request without leaking them to other routes. */
+export function applyCodexRequestSettings(request, settings) {
+    const { contextWindow: _inheritedContextWindow, serviceTier: _inheritedServiceTier, ...withoutCodexControls } = request;
+    if (!isGptModel(request.model))
+        return withoutCodexControls;
+    return {
+        ...withoutCodexControls,
+        ...settings.contextWindow === undefined ? {} : { contextWindow: settings.contextWindow },
+        ...settings.fast ? { serviceTier: 'priority' } : {},
+    };
+}
 const CODEX_BASE_PROMPT = String.raw `You are Codex, based on {{model}}. You are running as a coding agent in dsh Web on a user's computer.
 
 ## General
@@ -414,12 +442,20 @@ export function apply(ctx, config = {}) {
     // provider routes. Codex adds only scoped transport behavior and capability
     // metadata; failed remote operations continue through the generic path.
     watchConfiguredGptModels(ctx);
+    const codexSettings = installCodexSettings(ctx);
+    // Keep these controls in the request config rather than mutating provider
+    // settings. That makes a change apply to the next step without rebuilding
+    // the user's model catalog, while the LLM service still freezes it per call.
+    ctx.on('agent/request', async (_payload, next) => {
+        const request = await next();
+        return applyCodexRequestSettings(request, codexSettings.current());
+    });
     if ((resolved.hostedWebSearch || resolved.remoteCompact) && typeof ctx.effect === 'function') {
         const disposeHostedWebSearch = installHostedWebSearch();
         ctx.effect(() => disposeHostedWebSearch, 'codex: Responses transport wrapper');
     }
     if (resolved.hostedWebSearch || resolved.remoteCompact) {
-        ctx.on('llm/stream', (options, next) => {
+        ctx.on('llm/stream', ((options, next) => {
             if (resolved.remoteCompact && options.purpose === 'compaction' && isGptModel(options.model)) {
                 return remoteCompactStream(ctx, options, next);
             }
@@ -429,7 +465,7 @@ export function apply(ctx, config = {}) {
                 return hostedWebSearchStream(next);
             }
             return next();
-        });
+        }));
     }
     ctx.systemPrompt.section({ name: 'codex:base', order: 10, text: CODEX_BASE_PROMPT });
     registerExecTools(ctx, resolved);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuind/dsh-codex-harness",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "A minimal Codex harness for GPT models that do not fit DSH's native interface, while remaining compatible with the DSH plugin ecosystem.",
   "type": "module",
   "main": "lib/index.js",
@@ -18,6 +18,10 @@
       "types": "./lib/types/installer.d.ts",
       "default": "./lib/installer.js"
     },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./src/*": "./src/*",
     "./package.json": "./package.json"
@@ -28,6 +32,7 @@
     "lib/installer.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts",
+    "lib/client.js",
     "cordis.patch.yml",
     "presets/codex",
     "README.md",
@@ -58,6 +63,16 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
     }
   },
   "dependencies": {
@@ -67,6 +82,11 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-credentials": ">=0.1.0-rc.8",
     "@deepseek-ai/dsh-fs": ">=0.0.1-rc.1",
     "@deepseek-ai/dsh-invariants": ">=0.0.1-rc.1",
@@ -89,6 +109,21 @@
     "@deepseek-ai/dsh-agent": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-credentials": {
       "optional": true
     },
@@ -135,6 +170,11 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.8",
     "@deepseek-ai/dsh-credentials": "0.1.0-rc.8",
     "@deepseek-ai/dsh-fs": "0.1.0-rc.6",
     "@deepseek-ai/dsh-invariants": "0.1.0-rc.6",
@@ -150,6 +190,8 @@
     "@deepseek-ai/dsh-terminal": "0.1.0-rc.6",
     "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
     "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.3.1",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "unrun": "^0.3.1",