@treeseed/dsh-chapters 0.1.24 → 0.2.1

package/lib/client.js

@@ -24,20 +24,132 @@ window.__ModuleLoader__.load({
 		}];
 		/** Pull the child id out of either door's durable success text — both end in
 		* `… is session ch-…` (src/tools.ts), so this regex is door-agnostic. */
+		/**
+		* Which build of THIS file produced a door note (#77). When the live probe reported a roster
+		* trace of `missing → missing → missing` — meaning adoption should have fired three times — while
+		* showing no adoption outcome at all, the first question stopped being "why did the client refuse"
+		* and became "did the browser run the code I am reading?". A note that names its own build makes
+		* that a glance instead of an archaeology session into symlinked plugin trees.
+		*/
+		const DOOR_BUILD = "2026-10-22T23:55 door-build-stamp";
 		const CHILD_ID = /is session (ch-[\w-]+)/;
 		/** The quoted title the door gave the child, matched by its OWN noun so a
 		* refusal or an unrelated quote cannot pass for it. */
 		const doorTitle = (noun) => new RegExp(`${noun} \\u201C([^\\u201D]+)\\u201D is session`);
-		function openByService(sessions, sessionId) {
+		/**
+		* A refusal reason that can never render as nothing. `String(err.message ?? err)` is `''` for a
+		* host error built with an empty message, and an empty reason disappears from the note — the
+		* reader then concludes "no refusal happened", which is the opposite of the truth (#77).
+		*/
+		function refusalReason(error) {
+			const trimmed = (error instanceof Error ? error.message : String(error)).trim();
+			const named = trimmed === "" ? error instanceof Error && error.name.trim() !== "" ? error.name : "" : trimmed;
+			return (named === "" ? error === null ? "null thrown" : typeof error : named).replace(/\s+/g, " ").slice(0, 90);
+		}
+		/**
+		* Is the child in the client's OWN roster? This is the question that separates two very
+		* different failures, and the door used to report the symptom without it:
+		*  - the client never learned the session exists (roster: missing) → the fix is server-side
+		*    publication, and no amount of clicking `open` will ever work;
+		*  - the client knows it and `open` still did nothing (roster: contains) → a navigation bug.
+		* Measured host 0.2.0-rc.2: the sessions service exposes `projectList`, `refresh`, `retain`,
+		* `handleSessionAdded` — the roster is a projection the client fills from control frames.
+		*/
+		/**
+		* The client's own session ids, or `null` when the store cannot be read. ONE reader for both
+		* the note and the adoption decision, so the door never acts on a verdict it did not report.
+		*/
+		function rosterIds(sessions) {
+			const store = sessions?.list;
+			if (typeof store?.getSnapshot !== "function") return null;
+			const snap = store.getSnapshot();
+			const ids = /* @__PURE__ */ new Set();
+			if (Array.isArray(snap?.ids)) for (const id of snap.ids) ids.add(String(id));
+			else if (snap?.byId !== void 0) for (const k of Object.keys(snap.byId)) ids.add(k);
+			else return null;
+			return ids;
+		}
+		function rosterNote(sessions, child) {
+			try {
+				const ids = rosterIds(sessions);
+				if (ids === null) return ` (roster: ${typeof (sessions?.list)?.getSnapshot !== "function" ? "no list store on the service" : "snapshot unreadable"} — presence of ${child.slice(0, 11)}… is UNKNOWN, not absent)`;
+				if (ids.size === 0) return ` (roster: empty — presence of ${child.slice(0, 11)}… is UNKNOWN, not absent)`;
+				const n = ids.size;
+				return ids.has(child) ? ` (roster: contains ${child.slice(0, 11)}…, ${String(n)} sessions — open() is the failure)` : ` (roster: MISSING, ${String(n)} sessions — the client never catalogued this session)`;
+			} catch {
+				return "";
+			}
+		}
+		/** The service's own method names, as a hint attached to a failure note (never a guess). */
+		function verbsNote(sessions) {
+			try {
+				const svc = sessions;
+				if (svc === null || svc === void 0 || typeof svc !== "object") return " (sessions service: absent)";
+				const found = /* @__PURE__ */ new Set();
+				let node = svc;
+				for (let depth = 0; depth < 6 && node !== null && node !== void 0 && node !== Object.prototype; depth++) {
+					for (const key of Object.getOwnPropertyNames(node)) {
+						if (key === "constructor") continue;
+						try {
+							if (typeof svc[key] === "function") found.add(key);
+						} catch {}
+					}
+					node = Object.getPrototypeOf(node);
+				}
+				const verbs = [...found].sort().slice(0, 24);
+				return verbs.length === 0 ? " (sessions service: no methods on the chain)" : ` (sessions verbs: ${verbs.join(", ")})`;
+			} catch {
+				return " (sessions service: unreadable)";
+			}
+		}
+		function openByService(sessions, sessionId, adopt, nav) {
 			return (async () => {
 				const svc = sessions;
-				if (typeof svc?.open !== "function") return false;
+				if (svc === void 0) return false;
+				const navigate = typeof nav?.openSession === "function" ? (id) => nav.openSession(id) : typeof svc?.open === "function" ? (id) => svc.open(id) : null;
+				if (navigate === null) {
+					adopt?.onStep?.("no-verb");
+					return false;
+				}
 				try {
 					await svc.refresh?.();
 				} catch {}
+				try {
+					svc.projectList?.();
+				} catch {}
+				if (adopt?.needed === true && typeof svc.create === "function") {
+					adopt.onStep?.("enter-create");
+					try {
+						await svc.create({ sessionId });
+						adopt.onStep?.("settle-create");
+						try {
+							svc.projectList?.();
+						} catch {}
+						const after = rosterIds(sessions);
+						adopt.onAfter?.(after === null ? null : after.has(sessionId));
+					} catch (error) {
+						adopt.onStep?.("refuse-create");
+						adopt.onRefused(refusalReason(error));
+					}
+				}
+				if (adopt?.needed === true && typeof svc.using === "function" && rosterIds(sessions)?.has(sessionId) === false) {
+					adopt.onStep?.("enter-using");
+					try {
+						await svc.using(sessionId, { source: "dsh-chapters-door" }, async () => void 0);
+						adopt.onStep?.("settle-using");
+						try {
+							svc.projectList?.();
+						} catch {}
+						const seen = rosterIds(sessions);
+						adopt.onAfter?.(seen === null ? null : seen.has(sessionId));
+					} catch (error) {
+						adopt.onStep?.("refuse-using");
+						adopt.onSubscribeRefused?.(refusalReason(error));
+					}
+				}
 				const started = Date.now();
 				for (;;) try {
-					svc.open(sessionId);
+					navigate(sessionId);
 					return true;
 				} catch {
 					if (Date.now() - started > 4e3) return false;
@@ -77,7 +189,7 @@ window.__ModuleLoader__.load({
 			}
 			return tryClick();
 		}
-		function makeDoorRunner(remote, sessions, door) {
+		function makeDoorRunner(remote, sessions, door, verifySwitched, opts) {
 			return async function run(sessionId) {
 				try {
 					if (remote.commands?.execute === void 0) return {
@@ -100,18 +212,60 @@ window.__ModuleLoader__.load({
 						ok: true,
 						message: `${door.noun} created — appearing in the sidebar`
 					};
-					if (await openByService(sessions, child)) return {
-						ok: true,
-						message: ""
+					const switchedOnce = async () => {
+						if (verifySwitched === void 0) return true;
+						try {
+							return await verifySwitched(child);
+						} catch {
+							return false;
+						}
 					};
+					const maxAttempts = typeof sessions?.refresh === "function" ? opts?.attempts ?? 3 : 1;
+					let tried = 0;
+					let adoptRefusal = "";
+					let subscribeRefusal = "";
+					const rosterTrace = [];
+					const steps = [];
+					let adoptSaw;
+					for (let i = 0; i < maxAttempts; i++) {
+						tried += 1;
+						const ids = rosterIds(sessions);
+						const needed = ids !== null && !ids.has(child);
+						const svcShape = sessions;
+						rosterTrace.push(`${ids === null ? "unknown" : ids.size === 0 ? "empty" : ids.has(child) ? "has" : "missing"}${typeof svcShape?.create === "function" ? "+c" : "-c"}${typeof svcShape?.using === "function" ? "+u" : "-u"}${typeof svcShape?.open === "function" ? "+o" : "-o"}${typeof opts?.navigator?.openSession === "function" ? "+w" : "-w"}`);
+						if (await openByService(sessions, child, {
+							needed,
+							onRefused: (reason) => {
+								adoptRefusal = reason;
+							},
+							onSubscribeRefused: (reason) => {
+								subscribeRefusal = reason;
+							},
+							onAfter: (seen) => {
+								adoptSaw = seen;
+							},
+							onStep: (step) => {
+								if (!steps.includes(step)) steps.push(step);
+							}
+						}, opts?.navigator) && await switchedOnce()) return {
+							ok: true,
+							message: ""
+						};
+						if (i + 1 < maxAttempts) await new Promise((r) => {
+							setTimeout(r, opts?.attemptPauseMs ?? 300).unref?.();
+						});
+					}
 					const title = doorTitle(door.noun).exec(text)?.[1];
-					if (title !== void 0 && await openBranchRow(title)) return {
+					if (title !== void 0 && await openBranchRow(title) && await switchedOnce()) return {
 						ok: true,
 						message: ""
 					};
-					return {
+					return verifySwitched === void 0 ? {
 						ok: true,
 						message: `${door.noun} created — open it in the sidebar`
+					} : {
+						ok: true,
+						message: `${door.noun} created — the app did not switch after ${String(tried)} attempt${tried === 1 ? "" : "s"}; open it from the sidebar [roster per attempt: ${rosterTrace.join(" → ")}] [tried: ${steps.length === 0 ? "none" : steps.includes("no-verb") ? "no open or openSession verb on any injected service" : steps.join(", ")}] (build: ${DOOR_BUILD})${adoptRefusal === "" ? "" : ` (adoption refused: ${adoptRefusal})`}${subscribeRefusal === "" ? "" : ` (subscribe refused: ${subscribeRefusal})`}${adoptSaw === void 0 ? "" : ` (right after adopt: ${adoptSaw ? "contains" : "missing"} ${child.slice(0, 15)})`}${rosterNote(sessions, child)}${verbsNote(sessions)}`
 					};
 				} catch (error) {
 					return {
@@ -122,6 +276,103 @@ 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.
+		*/
+		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;
+				}
+			};
+		}
+		/**
+		* 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
 		/**
 		* dsh-chapters client entry: the per-message door buttons.
@@ -152,7 +403,8 @@ window.__ModuleLoader__.load({
 			"slots",
 			"remote",
 			"remote.commands",
-			"sessions"
+			"sessions",
+			"uiWorkspace"
 		];
 		/**
 		* Style parity with the native IconActions row: rules copied verbatim from the
@@ -173,6 +425,11 @@ 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";
@@ -232,6 +489,118 @@ 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;
@@ -242,9 +611,30 @@ window.__ModuleLoader__.load({
 			} catch {
 				sessions = void 0;
 			}
+			let uiWorkspace;
+			try {
+				uiWorkspace = ctx.get("uiWorkspace");
+			} catch {
+				uiWorkspace = void 0;
+			}
+			const currentSessionId = () => {
+				try {
+					const raw = window.localStorage.getItem("dsh.sessions.current");
+					if (raw === null) return null;
+					return JSON.parse(raw)?.sessionId ?? null;
+				} catch {
+					return null;
+				}
+			};
 			const rows = DOOR_ACTIONS.map((door) => ({
 				door,
-				run: makeDoorRunner(remote, sessions, door),
+				run: makeDoorRunner(remote, sessions, door, async (child) => {
+					for (let i = 0; i < 8; i++) {
+						if (currentSessionId() === child) return true;
+						await new Promise((r) => setTimeout(r, 250));
+					}
+					return currentSessionId() === child;
+				}, { ...uiWorkspace !== void 0 ? { navigator: uiWorkspace } : {} }),
 				component: makeDoorAction(door)
 			}));
 			slots.inject("conversation.chat.assistant-actions", () => rows.map(({ door, run, component }) => slots.register({
@@ -253,6 +643,18 @@ 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));
 		}
 		//#endregion
 		exports.apply = apply;