@treeseed/dsh-chapters 0.2.9 → 0.2.12

package/lib/client.js

@@ -182,15 +182,29 @@ window.__ModuleLoader__.load({
 		* autorun and pausing it silently would be the loop dying with nobody told.
 		*/
 		const ACTIVE_POLL_MS = 1e4;
-		const QUIET_POLL_MS = 6e4;
+		/**
+		* #229: the quiet heartbeat is CONFIG-GATED (`promptQuietHeartbeatSec`) and defaults to ZERO.
+		* Measured on the maintainer's live log after 0.2.11 installed correctly (gaps exactly 60.0s): every
+		* pull is two durable nodes — a host `command/run` + `command/done` pair — and the user's rule is
+		* absolute: never repeated chapters-prompt executions. The sanctioned moments (mount discovery once
+		* per page load, the turn-end pulse, visibility return with an untrusted cache, forced confirms)
+		* remain; the ambient drumbeat does not exist unless configured. This module is client-safe (no node
+		* builtins), so the wiring injects the config value at boot via `configureQuietHeartbeat`.
+		*/
+		let QUIET_POLL_MS = 0;
+		function configureQuietHeartbeat(seconds) {
+			QUIET_POLL_MS = typeof seconds === "number" && Number.isFinite(seconds) && seconds > 0 ? Math.trunc(seconds * 1e3) : 0;
+		}
 		function pollSpacingFor(s) {
+			if (s.turnEndPulse === true) return ACTIVE_POLL_MS;
 			if (s.edges) {
 				if (s.status === "analyzing" || s.autorun === "armed") return ACTIVE_POLL_MS;
 				return null;
 			}
-			const active = s.status === "analyzing" || s.autorun === "armed" || s.running;
+			const active = s.status === "analyzing" || s.autorun === "armed";
 			if (!active && s.hidden) return null;
-			return active ? ACTIVE_POLL_MS : QUIET_POLL_MS;
+			if (!active) return QUIET_POLL_MS > 0 ? QUIET_POLL_MS : null;
+			return ACTIVE_POLL_MS;
 		}
 		/**
 		* #203: whether a freshly mounted bar pulls, or renders its cache and stays silent. The maintainer's
@@ -204,7 +218,7 @@ window.__ModuleLoader__.load({
 			if (!c.hasCache) return true;
 			if (c.status === "off") return false;
 			if (c.autorun === "armed" || c.status === "analyzing") return true;
-			return c.ageMs > QUIET_POLL_MS;
+			return QUIET_POLL_MS > 0 && c.ageMs > QUIET_POLL_MS;
 		}
 		/**
 		* #203: fold a cached wire event back into row state through the SAME reducer the live path uses —
@@ -271,6 +285,7 @@ window.__ModuleLoader__.load({
 				}
 				scalars[key] !== void 0 ? scalars[key] += ` ${value}` : scalars[key] = value;
 			}
+			configureQuietHeartbeat(Number.parseInt((scalars["heartbeat"] ?? "").trim(), 10) || 0);
 			const turnRaw = scalars["turn"] ?? "";
 			const turnSeq = /^\d+$/.test(turnRaw) ? Number(turnRaw) : null;
 			const errorRaw = scalars["error"] ?? "";
@@ -392,6 +407,26 @@ window.__ModuleLoader__.load({
 		function edgeKickDelayMs(msSinceLastPull) {
 			return Math.max(EDGE_DEBOUNCE_MS, EDGE_FLOOR_MS - msSinceLastPull);
 		}
+		/**
+		* #221: the turn-end pulse, derived from the host's own turn-boundary projection — no plugin
+		* record API needed, so it works on 0.2.0 hosts (where appendPluginRecord is absent) exactly as
+		* on newer ones. The host maintains a `turnBoundary` projection (the agent loop reads its
+		* lastTurn for its own bookkeeping); reading what the host already folds costs zero writes and
+		* delivers reactively through the same standard useProjection seat as any other projection.
+		* Returns true when a NEW turn ended since the last observation; the dock calls it once per
+		* render and stores the returned stamp back into `seen`.
+		*/
+		function turnEndPulse(lastTurn, seen) {
+			const cur = typeof lastTurn === "number" && Number.isFinite(lastTurn) ? lastTurn : 0;
+			if (cur > seen) return {
+				pulse: true,
+				seen: cur
+			};
+			return {
+				pulse: false,
+				seen
+			};
+		}
 		// src/client/prompt-dock.ts
 		/**
 		* The Suggested Next Step dock row (#113) — thin by design.
@@ -419,11 +454,12 @@ window.__ModuleLoader__.load({
 			".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_promptExpanded{height:auto;min-height:36px;padding-top:8px;padding-bottom:8px}",
 			".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_promptFull{white-space:pre-wrap;overflow-wrap:anywhere;line-height:20px;font-size:13px;color:var(--dsw-alias-label-primary);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}",
@@ -519,7 +555,9 @@ window.__ModuleLoader__.load({
 			const { sessionId, inputActions, exec } = props;
 			const sessionSnapshot = (props.useSession ?? (() => void 0))((snapshot) => snapshot);
 			const running = props.running ?? deriveRunning(sessionSnapshot);
-			const pushed = (props.useProjection ?? (() => void 0))(PROMPT_PROJECTION_KEY);
+			const useProjectionHook = props.useProjection ?? (() => void 0);
+			const pushed = useProjectionHook(PROMPT_PROJECTION_KEY);
+			const turnBoundary = useProjectionHook("turnBoundary");
 			const [state, dispatch] = (0, react.useReducer)(promptBarReducer, initialBarState(), (s) => {
 				const pushEvs = pushEventsOf(pushed);
 				if (pushEvs !== null) return {
@@ -544,6 +582,7 @@ window.__ModuleLoader__.load({
 			const lastPullAt = (0, react.useRef)(null);
 			const edgeTimer = (0, react.useRef)(void 0);
 			const pushLiveRef = (0, react.useRef)(false);
+			const seenTurnRef = (0, react.useRef)(0);
 			const lastPushAt = (0, react.useRef)(null);
 			const answered = (0, react.useRef)(false);
 			const replyStatus = (0, react.useRef)("unknown");
@@ -605,13 +644,19 @@ window.__ModuleLoader__.load({
 				pulled.current = true;
 				let timer;
 				const effectiveStatus = () => replyStatus.current === "unknown" ? stateRef.current.status : replyStatus.current;
-				const spacingNow = () => pollSpacingFor({
-					status: effectiveStatus(),
-					autorun: stateRef.current.autorun,
-					running: stateRef.current.running,
-					hidden: typeof document !== "undefined" && document.hidden === true,
-					edges: edgesRef.current
-				});
+				const spacingNow = () => {
+					if (stateRef.current.autorun === "armed") return ACTIVE_POLL_MS;
+					const pe = turnEndPulse(turnBoundary?.lastTurn, seenTurnRef.current);
+					if (pe.pulse) seenTurnRef.current = pe.seen;
+					return pollSpacingFor({
+						status: effectiveStatus(),
+						autorun: stateRef.current.autorun,
+						running: stateRef.current.running,
+						hidden: typeof document !== "undefined" && document.hidden === true,
+						edges: edgesRef.current,
+						turnEndPulse: pe.pulse
+					});
+				};
 				const duePull = () => {
 					const c = sessionId !== void 0 ? stateCache.get(sessionId) : void 0;
 					return mountPullDecision({
@@ -628,7 +673,8 @@ window.__ModuleLoader__.load({
 						if (!(opts?.mount === true && duePull())) return;
 					}
 					const spacing = spacingNow();
-					if (opts?.force === true || spacing !== null && !(opts?.mount === true && !duePull())) await refresh();
+					const mountDiscovery = opts?.mount === true && duePull();
+					if (opts?.force === true || mountDiscovery || spacing !== null && opts?.mount !== true) await refresh();
 					if (replyStatus.current === "off") return;
 					const next = spacingNow();
 					if (next !== null) timer = setTimeout(() => {
@@ -763,7 +809,10 @@ window.__ModuleLoader__.load({
 				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", {
+			}, state.expanded ? (0, react.createElement)("span", { className: "dsh-chapters_promptFull" }, state.text ?? "") : (0, react.createElement)("span", {
+				className: "dsh-chapters_promptEllipsis",
+				title: state.text ?? void 0
+			}, lineFor(state))), ...state.note === "" ? [] : [(0, react.createElement)("span", {
 				key: "note",
 				className: "dsh-chapters_promptNote",
 				role: "status"
@@ -997,13 +1046,14 @@ window.__ModuleLoader__.load({
 			return tryClick();
 		}
 		function makeDoorRunner(remote, sessions, door, verifySwitched, opts) {
-			return async function run(sessionId) {
+			return async function run(sessionId, anchorSeq) {
 				try {
 					if (remote.commands?.execute === void 0) return {
 						ok: false,
 						message: "commands remote unavailable"
 					};
-					const res = await remote.commands.execute(sessionId, door.command, []);
+					const line = typeof anchorSeq === "number" && Number.isFinite(anchorSeq) ? `${door.command} ${String(Math.trunc(anchorSeq))}` : door.command;
+					const res = await remote.commands.execute(sessionId, line, []);
 					if (res.ok !== true) return {
 						ok: false,
 						message: (res.error?.message ?? `the ${door.noun} call failed`).slice(0, 90)
@@ -1246,7 +1296,16 @@ window.__ModuleLoader__.load({
 					name: "conversation.chat.assistant-actions",
 					id: door.id,
 					label: door.label,
-					inject: (sessionId) => ({ run: () => run(sessionId) })
+					inject: (sessionId, owner) => ({ run: async () => {
+						let anchor = null;
+						const mid = typeof owner?.messageId === "string" ? owner.messageId : "";
+						if (mid !== "") try {
+							const out = await runCommandText(remote, sessionId, `/chapters-anchor ${mid}`);
+							const n = Number.parseInt(out.trim(), 10);
+							if (Number.isFinite(n) && n > 0) anchor = n;
+						} catch {}
+						return run(sessionId, anchor);
+					} })
 				}, component));
 				console.info(`[client:chapters] door factory ran: ${String(effects.length)} register effect(s), types: ${effects.map((e) => typeof e).join(",")}`);
 				return effects;