@treeseed/dsh-chapters 0.2.0 → 0.2.2-dev.2

package/lib/client.js

@@ -6,7 +6,524 @@ window.__ModuleLoader__.load({
 		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");
-		//#region src/client/doors.ts
+		// src/client/prompt-bar.ts
+		function initialBarState(autorun = "disarmed") {
+			return {
+				status: "off",
+				text: null,
+				turnSeq: null,
+				error: null,
+				note: "",
+				intent: "worker-step",
+				goalPhase: "none",
+				goal: null,
+				autorun,
+				expanded: false,
+				running: false,
+				hiddenTurnSeq: null
+			};
+		}
+		function promptBarReducer(state, ev) {
+			if (ev.t === "note") return {
+				...state,
+				note: ev.note
+			};
+			const next = baseBarReducer(state, ev);
+			return ev.t === "polled" && (next.turnSeq !== state.turnSeq || next.text !== state.text) ? {
+				...next,
+				note: ""
+			} : next;
+		}
+		function baseBarReducer(state, ev) {
+			switch (ev.t) {
+				case "polled":
+					if (ev.status === "off") return {
+						...state,
+						status: "off",
+						text: null,
+						turnSeq: null,
+						error: null,
+						expanded: false,
+						autorun: "disarmed"
+					};
+					if (ev.status === "analyzing") return {
+						...state,
+						status: "analyzing",
+						text: null,
+						error: null
+					};
+					return {
+						...state,
+						status: ev.status,
+						text: ev.status === "ready" ? ev.text ?? null : null,
+						intent: ev.status === "ready" ? ev.intent ?? "worker-step" : "worker-step",
+						turnSeq: ev.turnSeq ?? state.turnSeq,
+						error: ev.status === "failed" ? ev.error ?? "the suggestion call failed" : null
+					};
+				case "expand": return {
+					...state,
+					expanded: true
+				};
+				case "collapse": return {
+					...state,
+					expanded: false
+				};
+				case "autorun": return {
+					...state,
+					autorun: ev.on ? "armed" : "disarmed"
+				};
+				case "running": return {
+					...state,
+					running: ev.running
+				};
+				case "human/prompt": return {
+					...state,
+					autorun: "disarmed",
+					hiddenTurnSeq: state.turnSeq,
+					expanded: false
+				};
+				case "off": return {
+					...state,
+					status: "off",
+					text: null,
+					turnSeq: null,
+					error: null,
+					expanded: false,
+					autorun: "disarmed"
+				};
+				case "goal": return {
+					...state,
+					goalPhase: ev.phase,
+					autorun: ev.phase === "complete" ? "disarmed" : state.autorun
+				};
+			}
+			return state;
+		}
+		/** The status label. `failed` keeps the ready label so the error span is the delta, not a mystery row. */
+		function barLabel(s) {
+			if (s.status === "analyzing") return "Analyzing situation…";
+			if (s.status === "ready" || s.status === "failed") return "Recommended Next Step";
+			return null;
+		}
+		function barVisible(s) {
+			if (s.status === "off") return false;
+			if (s.status === "ready" && (s.text === null || s.text === "")) return false;
+			if (s.hiddenTurnSeq !== null && s.hiddenTurnSeq === s.turnSeq) return false;
+			return true;
+		}
+		/** May the bar submit its own offer? Armed, present, idle, not dismissed, and still serving a purpose. */
+		function shouldAutoFire(s) {
+			if (s.status !== "ready") return false;
+			if (s.text === null || s.text === "") return false;
+			if (s.intent === "goal-edit") return false;
+			if (s.goal !== null && s.goal.phase === "active" && s.goal.activation === "armed") return false;
+			if (s.autorun !== "armed") return false;
+			if (s.running) return false;
+			if (s.goalPhase === "complete") return false;
+			if (s.hiddenTurnSeq !== null && s.hiddenTurnSeq === s.turnSeq) return false;
+			return true;
+		}
+		/** The command the bar pulls. One string, so the client and the command plane cannot drift silently. */
+		const BAR_STATE_COMMAND = "/chapters-prompt state";
+		/** The bar's Run button: the server submits the on-screen offer as the human's own turn. */
+		const BAR_RUN_COMMAND = "/chapters-prompt run";
+		/**
+		* Parse the `state` verb's `k: v` lines into a pull event.
+		*
+		* One output serving the human and the component is the design (see `docs/contract.md`); this function is
+		* the cost of that choice, and it is kept honest: an unrecognised line is IGNORED, not guessed at, and a
+		* payload that yields no `status` is `null` so the caller keeps its last state rather than inventing `off`
+		* (which would hide a bar that is merely mid-reply). Indentation and the prompt's own lines are the reason
+		* the prompt is collected separately from the scalar fields — it is the only multi-line value.
+		*/
+		function parseBarState(text) {
+			const lines = text.split("\n");
+			const head = lines[0] ?? "";
+			const statusWord = head.startsWith("suggested next step:") ? head.slice(20).trim() : "";
+			const status = statusWord === "off" ? "off" : statusWord === "idle" ? "idle" : statusWord === "analyzing" ? "analyzing" : statusWord === "ready" ? "ready" : statusWord === "failed" ? "failed" : null;
+			if (status === null) return null;
+			const scalars = {};
+			const prompt = [];
+			let inPrompt = false;
+			for (const line of lines.slice(1)) {
+				if (inPrompt) {
+					prompt.push(line.replace(/^ {4}/, ""));
+					continue;
+				}
+				const m = /^ {2}([a-z]+): ?(.*)$/.exec(line);
+				if (m === null) continue;
+				const key = m[1], value = m[2].trim();
+				if (key === "prompt") {
+					inPrompt = true;
+					continue;
+				}
+				scalars[key] !== void 0 ? scalars[key] += ` ${value}` : scalars[key] = value;
+			}
+			const turnRaw = scalars["turn"] ?? "";
+			const turnSeq = /^\d+$/.test(turnRaw) ? Number(turnRaw) : null;
+			const errorRaw = scalars["error"] ?? "";
+			return {
+				t: "polled",
+				intent: ((scalars["intent"] ?? "").split(" ")[0] ?? "") === "goal-edit" ? "goal-edit" : "worker-step",
+				status,
+				...status === "ready" ? {
+					text: prompt.join("\n"),
+					turnSeq
+				} : {},
+				...status === "failed" ? {
+					error: errorRaw,
+					turnSeq
+				} : {}
+			};
+		}
+		/** The autorun flag, read from the same payload — the row is durable, the flag is not. */
+		function parseBarAutorun(text) {
+			const m = /^ {2}autorun: (armed|disarmed)\b/m.exec(text);
+			return m === null ? null : m[1];
+		}
+		/**
+		* Does the host say this session is busy right now?
+		*
+		* The dock's props are HOOKS (`useSessionStatus`, `useChat`, `useInput`, …) — documented in
+		* docs/contract.md § "What a dock component is handed" — so a component that waits for a scalar
+		* `props.running` waits forever, which is precisely why Autorun declared itself unavailable while the host
+		* was publishing the signal one field away. Shapes differ across hosts and versions, so every form is folded
+		* here, in one pure function, with `undefined` (unknown) kept distinct from `false` (idle): the loop refuses
+		* to start a turn on an unknown, and that distinction is the whole safety property.
+		*/
+		function deriveRunning(status) {
+			if (status === void 0 || status === null) return void 0;
+			if (typeof status === "boolean") return status;
+			if (typeof status === "string") {
+				if (/^(running|streaming|busy|active)$/i.test(status)) return true;
+				if (/^(idle|done|stopped|finished|ready|waiting)$/i.test(status)) return false;
+				return;
+			}
+			if (typeof status === "object") {
+				const s = status;
+				if (s.running !== void 0) return typeof s.running === "boolean" ? s.running : void 0;
+				return deriveRunning(s.status ?? s.state ?? s.phase);
+			}
+		}
+		// src/client/prompt-dock.ts
+		/**
+		* The Suggested Next Step dock row (#113) — thin by design.
+		*
+		* Every decision lives in `prompt-bar.ts` where a row can pin it; this file only moves pixels and bytes
+		* between the host slot and that reducer. That split is the reason it exists: the ghost was rejected for
+		* behaviour that had no home, and "one turn, one offer" cannot be tested in a component.
+		*
+		* Placement is measured, not styled: `conversation.input.dock` is the host's full-width stack rendered
+		* ABOVE the composer card (todo `order: 0`, goal `10`, queue `20`), so `order: 30` puts this row under every
+		* other dock entry and directly above the input — and because it is a docked row rather than an overlay, it
+		* can neither cover the placeholder nor collide with the send buttons. The ghost's ugliest defect was
+		* structural, and the structure fixes it.
+		*
+		* The bar is PUSH-SHAPED, PULL-FED. A registrant can own a reactive observable (`hooks: { x }` → prop
+		* `useX`) — that is how the goal bar gets its `activation` — but a plugin cannot publish a projection, and
+		* the only plugin-reachable call path is `remote.commands.execute`. So the component pulls the `state` verb
+		* on edges it can actually observe. Stated here because the alternative is a reader assuming a subscription
+		* that does not exist.
+		*
+		* @module dsh-chapters/src/client/prompt-dock
+		*/
+		const CSS$1 = [
+			".dsh-chapters_promptDock{box-sizing:border-box;width:calc(100% - 4 * var(--dsh-composer-dock-inset));max-width:calc(var(--dsh-composer-card-max-width) - 4 * var(--dsh-composer-dock-inset));margin:0 auto}",
+			".dsh-chapters_promptBar{isolation:isolate;box-sizing:border-box;width:100%;border-radius:var(--dsw-radius-md);height:36px;box-shadow:var(--dsw-elevation-panel);border:0;align-items:center;gap:10px;padding:4px 5px 4px 12px;display:flex;position:relative}",
+			".dsh-chapters_promptBar::before{z-index:-1;border-radius:inherit;background:var(--dsw-specific-menu);backdrop-filter:var(--dsw-menu-backdrop-filter);content:\"\";pointer-events:none;position:absolute;inset:0}",
+			".dsh-chapters_promptExpanded::before{align-items:flex-start;position:absolute;inset:0}",
+			".dsh-chapters_promptGlyph{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex}",
+			".dsh-chapters_promptLabel{color:var(--dsw-alias-label-primary);flex:none;font-size:13px;font-weight:500;line-height:24px}",
+			".dsh-chapters_promptText{min-width:0;color:var(--dsw-alias-label-primary-dimmed);font-size:13px;line-height:20px;cursor:pointer;border:0;background:0 0;padding:0;text-align:left;flex:1}",
+			".dsh-chapters_promptEllipsis{white-space:nowrap;text-overflow:ellipsis;overflow:hidden;display:block}",
+			".dsh-chapters_promptFull{white-space:pre-wrap;overflow:auto;max-height:9rem;display:block}",
+			".dsh-chapters_promptError{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:20px;flex:none;max-width:34%}",
+			".dsh-chapters_promptNote{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:20px;min-width:0}",
+			".dsh-chapters_promptIntent{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:20px}",
+			".dsh-chapters_promptActions{flex:none;align-items:center;gap:10px;display:flex}",
+			".dsh-chapters_promptBtn{corner-shape:round;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:999px;justify-content:center;align-items:center;padding:0;display:inline-flex;font-size:13px}",
+			".dsh-chapters_promptBtn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}",
+			".dsh-chapters_promptBtn:disabled{opacity:.4;cursor:default}"
+		].join("\n");
+		const CSS_ID = "dsh-chapters/prompt-dock.css";
+		const ensureCss = () => {
+			if (typeof document === "undefined") return;
+			if (document.getElementById(CSS_ID) !== null) return;
+			const style = document.createElement("style");
+			style.id = CSS_ID;
+			style.setAttribute("data-plugin-css", CSS_ID);
+			style.textContent = CSS$1;
+			document.head.appendChild(style);
+		};
+		/** The analysis glyph, drawn to the goal icon's metric (16 viewBox, stroke currentColor, width 1).
+		*  A prism-and-arrow: the feature reads the situation and points at the next move. */
+		const Glyph = () => (0, react.createElement)("svg", {
+			viewBox: "0 0 16 16",
+			width: 14,
+			height: 14,
+			fill: "none",
+			"aria-hidden": "true",
+			"stroke-width": "1"
+		}, (0, react.createElement)("path", {
+			d: "M2.5 3.5h11L8 9.5 2.5 3.5Z",
+			stroke: "currentColor"
+		}), (0, react.createElement)("path", {
+			d: "M8 9.5V14",
+			stroke: "currentColor"
+		}), (0, react.createElement)("path", {
+			d: "M6 12l2 2 2-2",
+			stroke: "currentColor"
+		}));
+		/** One action button, labelled through the host tooltip exactly as the goal bar labels its own. */
+		const Action = (props) => {
+			const button = (0, react.createElement)("button", {
+				type: "button",
+				className: "dsh-chapters_promptBtn",
+				"aria-label": props.label,
+				...props.disabled === true ? { disabled: true } : {},
+				...props.title !== void 0 ? { title: props.title } : {},
+				onClick: props.onClick
+			}, props.glyph);
+			return (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: props.label,
+				side: "bottom",
+				children: button
+			});
+		};
+		/** Run is allowed whenever there is an offer; AUTORUN is what the intent and the goal gate. Keeping the
+		* human's own button enabled is deliberate — the point of the protocol is to route a goal edit to a keystroke,
+		* never to disable the human's ability to send it. */
+		/**
+		* The words the collapsed row shows, per state. `idle` and `analyzing` must say something, because an empty
+		* row is indistinguishable from a broken one — the whole reason this feature took a day to read: the bar was
+		* live, enabled, and rendering nothing but whitespace.
+		*/
+		function lineFor(state) {
+			if (state.status === "ready") return state.text ?? "";
+			if (state.status === "analyzing") return "Analyzing the session…";
+			if (state.status === "failed") return state.error !== null && state.error !== "" ? `Cannot recommend: ${state.error}` : "Cannot recommend a next step right now";
+			return "No suggestion yet — I will recommend one after your next turn";
+		}
+		const canRunHere = (state) => state.text !== null && state.text !== "";
+		/** How long a state pull may take before we call it failed. Generous on purpose: this is a local RPC that
+		* answers in milliseconds when the session is attachable, and the failure it guards against is a hang. */
+		const PULL_TIMEOUT_MS = 15e3;
+		/** Retry ceiling for the FIRST pull only, in attempts and spacing. A mount-time race must not be able to
+		* starve the bar forever, and a real `off` answer stops the loop on the first reply either way. */
+		/** Cadence of the keep-poll. A local RPC that answers in milliseconds; the cost is one command per
+		* interval, and it ends the moment the state is `off`. */
+		const POLL_SPACING_MS = 1e4;
+		function execWithTimeout(exec, line, ms) {
+			return new Promise((resolve, reject) => {
+				const timer = setTimeout(() => {
+					reject(/* @__PURE__ */ new Error(`no answer within ${String(ms)}ms`));
+				}, ms);
+				exec(line).then((text) => {
+					clearTimeout(timer);
+					resolve(text);
+				}, (error) => {
+					clearTimeout(timer);
+					reject(error instanceof Error ? error : new Error(String(error)));
+				});
+			});
+		}
+		function PromptDock(props) {
+			const { sessionId, inputActions, exec } = props;
+			const [state, dispatch] = (0, react.useReducer)(promptBarReducer, initialBarState(), (s) => ({
+				...s,
+				running: props.running ?? true
+			}));
+			const pulling = (0, react.useRef)(false);
+			const probed = (0, react.useRef)(false);
+			const pulled = (0, react.useRef)(false);
+			const alive = (0, react.useRef)(true);
+			(0, react.useEffect)(() => () => {
+				alive.current = false;
+			}, []);
+			const [busy, setBusy] = (0, react.useState)(false);
+			const answered = (0, react.useRef)(false);
+			const replyStatus = (0, react.useRef)("unknown");
+			const stateRef = (0, react.useRef)(initialBarState());
+			stateRef.current = state;
+			if (!probed.current) {
+				probed.current = true;
+				console.info(`[client:prompt] inputActions keys: ${Object.keys(inputActions ?? {}).join(",") || "NONE"}`);
+			}
+			const refresh = (0, react.useCallback)(async () => {
+				if (exec === void 0 || pulling.current) return;
+				pulling.current = true;
+				try {
+					const text = await execWithTimeout(exec, BAR_STATE_COMMAND, PULL_TIMEOUT_MS);
+					try {
+						window.__dshPromptReply = text;
+					} catch {}
+					const ev = parseBarState(text);
+					if (ev !== null) {
+						answered.current = true;
+						replyStatus.current = ev.status ?? replyStatus.current;
+						dispatch(ev);
+					}
+					const autorun = parseBarAutorun(text);
+					if (autorun !== null) dispatch({
+						t: "autorun",
+						on: autorun === "armed"
+					});
+				} catch (error) {
+					console.warn(`[client:prompt] pull failed: ${String(error?.message ?? error).slice(0, 180)}`);
+				} finally {
+					pulling.current = false;
+				}
+			}, [exec]);
+			(0, react.useEffect)(() => {
+				ensureCss();
+				if (pulled.current) return;
+				pulled.current = true;
+				let timer;
+				const tick = async () => {
+					await refresh();
+					if (replyStatus.current === "off") return;
+					timer = setTimeout(() => {
+						tick();
+					}, POLL_SPACING_MS);
+				};
+				tick();
+				return () => {
+					if (timer !== void 0) clearTimeout(timer);
+				};
+			}, [refresh]);
+			(0, react.useEffect)(() => {
+				dispatch({
+					t: "running",
+					running: props.running ?? true
+				});
+			}, [props.running]);
+			const run = (0, react.useCallback)(() => {
+				if (state.text === null || state.text === "" || exec === void 0) return;
+				setBusy(true);
+				exec(BAR_RUN_COMMAND).then((out) => {
+					if (!alive.current) return;
+					if (/^cannot run:/i.test(out.trim())) dispatch({
+						t: "polled",
+						status: "failed",
+						text: state.text,
+						error: out.trim().slice(0, 200),
+						turnSeq: state.turnSeq
+					});
+					else dispatch({ t: "collapse" });
+				}).catch((error) => {
+					console.warn(`[client:prompt] run failed: ${String(error?.message ?? error).slice(0, 160)}`);
+				}).finally(() => {
+					if (alive.current) setBusy(false);
+				});
+			}, [
+				exec,
+				state.text,
+				state.turnSeq
+			]);
+			(0, react.useEffect)(() => {
+				if (!shouldAutoFire(state)) return;
+				run();
+			}, [state, run]);
+			const sessionSnapshot = (props.useSession ?? (() => void 0))((snapshot) => snapshot);
+			const autorunDisabled = (props.running ?? deriveRunning(sessionSnapshot)) === void 0;
+			if (sessionId === void 0 || !barVisible(state)) return null;
+			const populate = () => {
+				console.info(`[client:prompt] populate expanded=${String(state.expanded)} hasInsertText=${String(typeof inputActions?.insertText)} hasSetDraft=${String(typeof inputActions?.setDraft)} textLen=${String(state.text?.length ?? -1)}`);
+				if (!state.expanded) {
+					dispatch({ t: "expand" });
+					return;
+				}
+				if (state.text === null || state.text === "") return;
+				if (typeof inputActions?.insertText === "function") {
+					try {
+						document.querySelector("[contenteditable=\"true\"][role=\"textbox\"]")?.focus();
+					} catch {}
+					const refuse = (why) => {
+						console.warn(`[client:prompt] click-to-draft refused: ${why}`);
+						dispatch({
+							t: "note",
+							note: "This host does not let a plugin write the composer, so the prompt cannot be edited before sending — Run submits it as your turn"
+						});
+					};
+					try {
+						inputActions.insertText(state.text);
+						const box = document.querySelector("[contenteditable=\"true\"][role=\"textbox\"]");
+						const head = state.text.slice(0, 24);
+						if ((box?.innerText ?? "").indexOf(head) === -1) setTimeout(() => {
+							if ((document.querySelector("[contenteditable=\"true\"][role=\"textbox\"]")?.innerText ?? "").indexOf(head) === -1) refuse("insertText reported success and left the editor empty");
+						}, 400);
+					} catch (error) {
+						refuse(String(error?.message ?? error).slice(0, 160));
+					}
+					setTimeout(() => {
+						try {
+							const box = document.querySelector("[contenteditable=\"true\"][role=\"textbox\"]");
+							console.info(`[client:prompt] after insertText: editorText=${String(box?.innerText?.length ?? "NO-BOX")} focused=${String(document.activeElement === box)}`);
+						} catch {}
+					}, 250);
+					return;
+				}
+				if (typeof inputActions?.setDraft === "function") {
+					inputActions.setDraft(state.text);
+					return;
+				}
+				console.warn("[client:prompt] click-to-draft refused: this host exposes neither insertText nor setDraft");
+			};
+			return (0, react.createElement)("div", {
+				className: "dsh-chapters_promptDock",
+				"data-prompt-bar": "true"
+			}, (0, react.createElement)("div", { className: `dsh-chapters_promptBar${state.expanded ? " dsh-chapters_promptExpanded" : ""}` }, (0, react.createElement)("span", { className: "dsh-chapters_promptGlyph" }, (0, react.createElement)(Glyph)), (0, react.createElement)("span", { className: "dsh-chapters_promptLabel" }, barLabel(state) ?? ""), ...state.intent === "goal-edit" ? [(0, react.createElement)("span", {
+				key: "intent",
+				className: "dsh-chapters_promptIntent",
+				"aria-label": "This step edits the goal"
+			}, "edits the goal · run it yourself")] : [], (0, react.createElement)("button", {
+				type: "button",
+				className: "dsh-chapters_promptText",
+				"aria-label": state.expanded ? "Put this suggested prompt in the input box" : "Show the full suggested prompt",
+				onClick: populate
+			}, state.expanded ? (0, react.createElement)("span", { className: "dsh-chapters_promptFull" }, state.text ?? "") : (0, react.createElement)("span", { className: "dsh-chapters_promptEllipsis" }, lineFor(state))), ...state.note === "" ? [] : [(0, react.createElement)("span", {
+				key: "note",
+				className: "dsh-chapters_promptNote",
+				role: "status"
+			}, state.note)], ...state.error === "" ? [] : [(0, react.createElement)("span", {
+				key: "err",
+				className: "dsh-chapters_promptError",
+				role: "alert"
+			}, state.error)], (0, react.createElement)("div", { className: "dsh-chapters_promptActions" }, (0, react.createElement)(Action, {
+				label: "Run the suggested next step",
+				glyph: "▶",
+				onClick: run,
+				disabled: busy,
+				...state.text === null || state.text === "" || !canRunHere(state) ? { disabled: true } : {},
+				...state.intent === "goal-edit" ? { title: "Goal edits need a human turn. Run still works; autorun will never do this one." } : {}
+			}), (0, react.createElement)(Action, {
+				label: state.autorun === "armed" ? "Autorun off" : "Autorun",
+				glyph: state.autorun === "armed" ? "⟳" : "⟲",
+				disabled: autorunDisabled,
+				...autorunDisabled ? { title: "Autorun needs the host to publish an idle signal; this build does not, so nothing would fire safely." } : {},
+				onClick: () => {
+					(async () => {
+						const arm = state.autorun !== "armed";
+						if (exec !== void 0) await exec(`/chapters-prompt autorun ${arm ? "on" : "off"}`);
+						dispatch({
+							t: "autorun",
+							on: arm
+						});
+						await refresh();
+					})();
+				}
+			}), (0, react.createElement)(Action, {
+				label: "Turn prompt suggestions off for this session",
+				glyph: "✕",
+				onClick: () => {
+					(async () => {
+						if (exec !== void 0) await exec("/chapters-prompt off");
+						dispatch({ t: "off" });
+					})();
+				}
+			}))));
+		}
+		// src/client/doors.ts
 		const DOOR_ACTIONS = [{
 			id: "chapters-fork",
 			order: 30,
@@ -275,105 +792,21 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
-		//#endregion
-		//#region src/client/prompt-ghost.ts
-		/**
-		* The ONE visibility predicate, in the host's own terms: the shipped
-		* placeholder shows on `draft === '' && attachments.length === 0`
-		* (InputBar.tsx `showPlaceholder`) — whitespace-only is CONTENT, it hides the
-		* guidance. The ghost agrees exactly, so the two layers can never disagree
-		* about "empty", and a typed (or space-typed) draft hides ours instantly.
-		*/
-		function shouldShowGhost(phase, running, draft, hasAttachments, suggestion) {
-			return phase === "shown" && !running && !hasAttachments && draft === "" && suggestion !== null && suggestion.text !== "";
-		}
-		/**
-		* The gesture decision for a keydown while the ghost is visible:
-		* ArrowRight accepts, Escape dismisses, anything else is the host's business.
-		* Returns the action for the caller to apply (and whether to preventDefault).
-		*/
-		function ghostKeyAction(key) {
-			if (key === "ArrowRight") return "accept";
-			if (key === "Escape") return "dismiss";
-			return null;
-		}
-		/**
-		* Execute `/chapters-prompt suggest` for one session. Never throws: every arm
-		* answers. `refused: true` marks a refusal worth retrying at the next boundary;
-		* a wire/registry failure is also a refusal, so one bad network cannot loop.
-		*/
-		function makePromptFetcher(remote) {
-			return async (sessionId) => {
-				if (remote.commands?.execute === void 0) return {
-					ok: false,
-					text: "commands remote unavailable",
-					refused: true
-				};
-				try {
-					const result = (await remote.commands.execute(sessionId, "/chapters-prompt suggest", [])).value?.result;
-					const text = typeof result?.text === "string" ? result.text : "";
-					if (result?.kind === "success" && text !== "") return {
-						ok: true,
-						text
-					};
-					return {
-						ok: false,
-						text,
-						refused: true
-					};
-				} catch (error) {
-					return {
-						ok: false,
-						text: String(error?.message ?? error).slice(0, 90),
-						refused: true
-					};
-				}
-			};
-		}
 		/**
-		* Execute `/chapters-prompt model` once per mount and pull the spec out of the
-		* status sentence for the hover label. Absent/unparseable ⇒ no label (the chip
-		* still works) — a display fact is never a dependency.
+		* Execute a host command line for one session and return its text, or '' when the command plane is
+		* unavailable. The bar's `state` pull and `off` write ride this, because it is the ONE place the client
+		* talks to the wire: the guard row "there is no second runner body in the client chrome" exists to keep
+		* `index.ts` as registration chrome, and a duplicated `commands.execute` in two files is how a wire
+		* behaviour drifts from its own test (#59's one-predicate rule, applied to the transport).
 		*/
-		function makeModelLabelFetcher(remote) {
-			return async (sessionId) => {
-				if (remote.commands?.execute === void 0) return null;
-				try {
-					const res = await remote.commands.execute(sessionId, "/chapters-prompt model", []);
-					return (res.value?.result?.kind === "success" ? res.value.result.text ?? "" : "").match(/^prompt model: (\S+(?: \S+)*) \(.*\) — ON$/)?.[1] ?? null;
-				} catch {
-					return null;
-				}
-			};
+		async function runCommandText(remote, sessionId, line) {
+			const exec = remote?.commands?.execute;
+			if (exec === void 0) return "";
+			const res = await exec(sessionId, line, []);
+			if (res.ok !== true) return "";
+			return res.value?.result?.text ?? "";
 		}
-		/**
-		* The boundary bookkeeping as a pure reducer so the component holds no logic:
-		* `runningEdge` reports the true→false transition of the session.
-		*/
-		function ghostReducer(state, event) {
-			switch (event.type) {
-				case "idle-edge": return {
-					phase: "idle",
-					boundary: state.boundary + 1
-				};
-				case "fetched":
-					if (state.phase !== "idle") return state;
-					return {
-						...state,
-						phase: event.ok ? "shown" : "refused"
-					};
-				case "accept": return {
-					...state,
-					phase: "accepted"
-				};
-				case "dismiss": return {
-					...state,
-					phase: "dismissed"
-				};
-			}
-		}
-		//#endregion
-		//#region src/client/index.ts
+		// src/client/index.ts
 		/**
 		* dsh-chapters client entry: the per-message door buttons.
 		*
@@ -425,11 +858,6 @@ window.__ModuleLoader__.load({
 			".dsh-chapters_forkAction:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}",
 			".dsh-chapters_forkAction:disabled{cursor:default;opacity:.4}",
 			".dsh-chapters_forkNote{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}",
-			".dsh-chapters_ghostWrap{position:absolute;top:2px;left:14px;right:14px;display:flex;justify-content:flex-start;pointer-events:none;z-index:1}",
-			".dsh-chapters_ghost{pointer-events:auto;display:inline-flex;align-items:center;gap:6px;max-width:min(70%,560px);padding:2px 10px;border:none;border-radius:12px;cursor:pointer;background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-caption);font-size:12px;line-height:18px}",
-			".dsh-chapters_ghost:hover{color:var(--dsw-alias-label-secondary)}",
-			".dsh-chapters_ghostText{overflow:hidden;white-space:nowrap;text-overflow:ellipsis}",
-			".dsh-chapters_ghostGlyph{flex:none;font-weight:600}",
 			"button[class*=\"_action\"][aria-label=\"Branch into a new conversation\"],button[class*=\"_action\"][aria-label=\"在新对话中分支\"]{display:none !important}"
 		].join("\n");
 		const CSS_TAG_ID = "dsh-chapters/assistant-action.css";
@@ -489,118 +917,6 @@ window.__ModuleLoader__.load({
 				}), note !== null ? (0, react.createElement)("span", { className: "dsh-chapters_forkNote" }, note) : null);
 			};
 		}
-		function makeGhostView() {
-			return function ChaptersPromptGhost(props) {
-				const snap = props.useInput((s) => s);
-				const running = props.useSession((s) => s.running) ?? false;
-				const draft = snap?.draft ?? "";
-				const hasAttachments = (snap?.attachmentIds.length ?? 0) > 0;
-				const [state, setState] = (0, react.useState)({
-					phase: "idle",
-					boundary: 0
-				});
-				const [suggestion, setSuggestion] = (0, react.useState)(null);
-				const [model, setModel] = (0, react.useState)(null);
-				const [labelKnown, setLabelKnown] = (0, react.useState)(false);
-				const alive = (0, react.useRef)(true);
-				(0, react.useEffect)(() => () => {
-					alive.current = false;
-				}, []);
-				const dispatch = (0, react.useCallback)((ev) => {
-					setState((s) => ghostReducer(s, ev));
-				}, []);
-				const fetchLabelRef = (0, react.useRef)(props.fetchLabel);
-				fetchLabelRef.current = props.fetchLabel;
-				const labelFetched = (0, react.useRef)(false);
-				(0, react.useEffect)(() => {
-					if (labelFetched.current) return;
-					labelFetched.current = true;
-					fetchLabelRef.current().then((m) => {
-						if (!alive.current) return;
-						setModel(m);
-						setLabelKnown(true);
-					});
-				}, []);
-				const prevRunning = (0, react.useRef)(null);
-				(0, react.useEffect)(() => {
-					const first = prevRunning.current === null;
-					const edge = !running && (first || prevRunning.current === true);
-					prevRunning.current = running;
-					if (edge) dispatch({ type: "idle-edge" });
-				}, [running, dispatch]);
-				const fetchedFor = (0, react.useRef)(-1);
-				const { phase, boundary } = state;
-				(0, react.useEffect)(() => {
-					if (!labelKnown || model === null) return;
-					if (phase !== "idle" || fetchedFor.current === boundary) return;
-					fetchedFor.current = boundary;
-					props.fetchSuggestion().then((r) => {
-						if (!alive.current) return;
-						setSuggestion(r.ok ? {
-							text: r.text,
-							model: model !== null ? model : void 0
-						} : null);
-						dispatch({
-							type: "fetched",
-							ok: r.ok
-						});
-					});
-				}, [
-					phase,
-					boundary,
-					props,
-					dispatch,
-					labelKnown,
-					model
-				]);
-				const accept = (0, react.useCallback)(() => {
-					if (suggestion === null) return;
-					props.inputActions?.setDraft(suggestion.text);
-					dispatch({ type: "accept" });
-				}, [
-					suggestion,
-					props,
-					dispatch
-				]);
-				const visible = shouldShowGhost(state.phase, running, draft, hasAttachments, suggestion);
-				(0, react.useEffect)(() => {
-					if (!visible) return;
-					const onKey = (event) => {
-						const action = ghostKeyAction(event.key);
-						if (action === null) return;
-						const target = event.target;
-						if (target === null || typeof target.closest !== "function" || target.closest("[data-composer-input]") === null) return;
-						event.preventDefault();
-						event.stopPropagation();
-						if (action === "accept") accept();
-						else dispatch({ type: "dismiss" });
-					};
-					document.addEventListener("keydown", onKey, true);
-					return () => {
-						document.removeEventListener("keydown", onKey, true);
-					};
-				}, [
-					visible,
-					accept,
-					dispatch
-				]);
-				if (!visible || suggestion === null) return null;
-				const tip = `next step suggested${model !== null ? ` by ${model}` : ""} — → or click puts it in the draft, Esc dismisses`;
-				return (0, react.createElement)("span", { className: "dsh-chapters_ghostWrap" }, (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-					label: tip,
-					side: "top",
-					children: (0, react.createElement)("button", {
-						type: "button",
-						className: "dsh-chapters_ghost",
-						"aria-label": "Accept the suggested next prompt",
-						onClick: accept
-					}, (0, react.createElement)("span", {
-						className: "dsh-chapters_ghostGlyph",
-						"aria-hidden": "true"
-					}, "→"), (0, react.createElement)("span", { className: "dsh-chapters_ghostText" }, suggestion.text))
-				}));
-			};
-		}
 		function apply(ctx) {
 			injectStyles();
 			const slots = ctx.slots;
@@ -643,20 +959,13 @@ window.__ModuleLoader__.load({
 				order: door.order,
 				inject: (sessionId) => ({ run: () => run(sessionId) })
 			}, component)));
-			const ghostView = makeGhostView();
-			const fetchSuggestion = makePromptFetcher(remote);
-			const fetchLabel = makeModelLabelFetcher(remote);
-			slots.inject("conversation.input.overlay", () => slots.register({
-				name: "conversation.input.overlay",
-				id: "chapters-prompt-ghost",
-				order: 12,
-				inject: (sessionId) => ({
-					fetchSuggestion: () => fetchSuggestion(sessionId),
-					fetchLabel: () => fetchLabel(sessionId)
-				})
-			}, ghostView));
+			slots.inject("conversation.input.dock", () => slots.register({
+				name: "conversation.input.dock",
+				id: "chapters-prompt",
+				order: 30,
+				inject: (sessionId) => ({ exec: (line) => runCommandText(remote, sessionId, line) })
+			}, PromptDock));
 		}
-		//#endregion
 		exports.apply = apply;
 		exports.inject = inject;
 		return module.exports;