dsh-smooth-stream 0.4.1 → 0.4.2

package/lib/client.js

@@ -8,10 +8,9 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let _deepseek_ai_dsh_client_ui_attachment = require("@deepseek-ai/dsh-client-ui-attachment");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
 		let react_dom = require("react-dom");
 		//#region \0dsh-css:/Users/dzlin/work/project/dsh-smooth-stream/src/client/TypewriterAssistantNodeView.module.css.mjs
-		const css$2 = ".I17U7q_root{min-width:0;color:var(--dsw-alias-label-primary);flex-direction:column;font-size:16px;line-height:28px;display:flex}.I17U7q_body{flex-direction:column;gap:16px;min-width:0;display:flex}.I17U7q_think{flex-direction:column;display:flex}.I17U7q_thinkRow{position:relative;overflow:hidden}.I17U7q_think[data-state=running] .I17U7q_thinkRow:after{content:\"\";inset-block:0;background:linear-gradient(90deg, transparent 0%, color-mix(in srgb, var(--dsw-alias-bg-base) 60%, transparent) 55%, transparent 100%);pointer-events:none;width:300px;animation:2.6s ease-out infinite I17U7q_dsh-smooth-stream-think-sweep;position:absolute;left:0}@keyframes I17U7q_dsh-smooth-stream-think-sweep{0%{left:-300px}90%,to{left:100%}}.I17U7q_thinkLeading{flex-shrink:0}.I17U7q_thinkChevron{color:var(--dsw-alias-label-secondary)}.I17U7q_thinkTitle{font-weight:400}.I17U7q_thinkSeparator{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}.I17U7q_thinkSummary{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:auto;font-size:14px;line-height:24px;overflow:hidden}.I17U7q_thinkSummary[data-follow-end]{text-overflow:clip}.I17U7q_thinkBody{color:var(--dsw-alias-label-tertiary);white-space:pre-wrap;word-break:break-word;padding:4px 0 4px 22px;font-size:14px;line-height:24px}.I17U7q_disclosureRoot{flex-direction:column;width:100%;min-width:0;display:flex}.I17U7q_disclosureRow{cursor:pointer;align-items:center;min-width:0;height:24px;display:flex;position:relative;overflow:hidden}.I17U7q_disclosureLeading{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:6px;display:inline-flex;position:relative}.I17U7q_disclosureIconIdle{opacity:1;transition:opacity .1s;display:inline-flex}.I17U7q_disclosureChevronHover{opacity:0;margin:auto;transition:opacity .1s;position:absolute;inset:0}.I17U7q_disclosureRow:hover .I17U7q_disclosureIconIdle{opacity:0}.I17U7q_disclosureRow:hover .I17U7q_disclosureChevronHover{opacity:1}.I17U7q_disclosureTitle{color:var(--dsw-alias-label-secondary);flex:none;font-size:14px;line-height:24px}.I17U7q_disclosureContent{visibility:visible;transition:grid-template-rows var(--ds-transition-duration,.2s) var(--ds-ease-in-out,cubic-bezier(.4, 0, .2, 1)), visibility 0s;grid-template-rows:1fr;display:grid}.I17U7q_disclosureContent[data-collapsed]{visibility:hidden;transition:grid-template-rows var(--ds-transition-duration,.2s) var(--ds-ease-in-out,cubic-bezier(.4, 0, .2, 1)), visibility 0s var(--ds-transition-duration,.2s);grid-template-rows:0fr}.I17U7q_disclosureContent>*{min-height:0;overflow:hidden}@media (prefers-reduced-motion:reduce){.I17U7q_think[data-state=running] .I17U7q_thinkRow:after{animation:none}.I17U7q_disclosureContent,.I17U7q_disclosureContent[data-collapsed]{transition:none}}.I17U7q_stopped{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary);border-radius:6px;align-self:flex-start;padding:0 6px;font-size:11px;line-height:18px}.I17U7q_visuallyHidden{clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.I17U7q_follow{contain:layout style;min-width:0}@supports (text-box-trim:trim-both){.I17U7q_root :is(p,h1,h2,h3,h4,h5,h6,li,blockquote){text-box-trim:trim-both;text-box-edge:text}}";
+		const css$2 = ".I17U7q_root{min-width:0;color:var(--dsw-alias-label-primary);flex-direction:column;font-size:16px;line-height:28px;display:flex}.I17U7q_body{flex-direction:column;gap:16px;min-width:0;display:flex}.I17U7q_think{flex-direction:column;display:flex}.I17U7q_thinkRow{position:relative;overflow:hidden}.I17U7q_think[data-state=running] .I17U7q_thinkRow:after{content:\"\";inset-block:0;background:linear-gradient(90deg, transparent 0%, color-mix(in srgb, var(--dsw-alias-bg-base) 60%, transparent) 55%, transparent 100%);pointer-events:none;width:300px;animation:2.6s ease-out infinite I17U7q_dsh-smooth-stream-think-sweep;position:absolute;left:0}@keyframes I17U7q_dsh-smooth-stream-think-sweep{0%{left:-300px}90%,to{left:100%}}.I17U7q_thinkLeading{flex-shrink:0}.I17U7q_thinkChevron{color:var(--dsw-alias-label-secondary)}.I17U7q_thinkTitle{font-weight:400}.I17U7q_thinkSeparator{background:var(--dsw-alias-label-caption);border-radius:1px;flex:none;width:2px;height:2px;margin:0 8px}.I17U7q_thinkSummary{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:auto;font-size:14px;line-height:24px;overflow:hidden}.I17U7q_thinkSummary[data-follow-end]{text-overflow:clip}.I17U7q_thinkBody{color:var(--dsw-alias-label-tertiary);white-space:pre-wrap;word-break:break-word;padding:4px 0 4px 22px;font-size:14px;line-height:24px}.I17U7q_disclosureRoot{flex-direction:column;width:100%;min-width:0;display:flex}.I17U7q_disclosureRow{cursor:pointer;align-items:center;min-width:0;height:24px;display:flex;position:relative;overflow:hidden}.I17U7q_disclosureLeading{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:6px;display:inline-flex;position:relative}.I17U7q_disclosureIconIdle{opacity:1;transition:opacity .1s;display:inline-flex}.I17U7q_disclosureChevronHover{opacity:0;margin:auto;transition:opacity .1s;position:absolute;inset:0}.I17U7q_disclosureRow:hover .I17U7q_disclosureIconIdle{opacity:0}.I17U7q_disclosureRow:hover .I17U7q_disclosureChevronHover{opacity:1}.I17U7q_disclosureTitle{color:var(--dsw-alias-label-secondary);flex:none;font-size:14px;line-height:24px}.I17U7q_disclosureContent{visibility:visible;transition:grid-template-rows var(--ds-transition-duration,.2s) var(--ds-ease-in-out,cubic-bezier(.4, 0, .2, 1)), visibility 0s;grid-template-rows:1fr;display:grid}.I17U7q_disclosureContent[data-collapsed]{visibility:hidden;transition:grid-template-rows var(--ds-transition-duration,.2s) var(--ds-ease-in-out,cubic-bezier(.4, 0, .2, 1)), visibility 0s var(--ds-transition-duration,.2s);grid-template-rows:0fr}.I17U7q_disclosureContent[data-no-transition]{transition:none}.I17U7q_disclosureContent>*{min-height:0;overflow:hidden}@media (prefers-reduced-motion:reduce){.I17U7q_think[data-state=running] .I17U7q_thinkRow:after{animation:none}.I17U7q_disclosureContent,.I17U7q_disclosureContent[data-collapsed]{transition:none}}.I17U7q_stopped{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary);border-radius:6px;align-self:flex-start;padding:0 6px;font-size:11px;line-height:18px}.I17U7q_visuallyHidden{clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.I17U7q_follow{contain:layout style;min-width:0}.I17U7q_root :not(pre)>code{line-height:inherit;white-space:normal;overflow-wrap:anywhere;vertical-align:baseline;display:inline}@supports (text-box-trim:trim-both){.I17U7q_root :is(p,h1,h2,h3,h4,h5,h6,blockquote){text-box-trim:trim-both;text-box-edge:text}}";
 		const tagId$2 = "dsh-smooth-stream/TypewriterAssistantNodeView.module.css";
 		if (typeof document !== "undefined") {
 			let tag = document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]");
@@ -24,27 +23,27 @@ window.__ModuleLoader__.load({
 			tag.textContent = css$2;
 		}
 		var TypewriterAssistantNodeView_module_css_default = {
-			"thinkSeparator": "I17U7q_thinkSeparator",
-			"body": "I17U7q_body",
-			"disclosureIconIdle": "I17U7q_disclosureIconIdle",
-			"disclosureTitle": "I17U7q_disclosureTitle",
-			"think": "I17U7q_think",
-			"disclosureContent": "I17U7q_disclosureContent",
-			"thinkLeading": "I17U7q_thinkLeading",
-			"disclosureRow": "I17U7q_disclosureRow",
-			"stopped": "I17U7q_stopped",
-			"thinkChevron": "I17U7q_thinkChevron",
 			"thinkSummary": "I17U7q_thinkSummary",
-			"dsh-smooth-stream-think-sweep": "I17U7q_dsh-smooth-stream-think-sweep",
-			"visuallyHidden": "I17U7q_visuallyHidden",
+			"thinkChevron": "I17U7q_thinkChevron",
 			"root": "I17U7q_root",
-			"disclosureRoot": "I17U7q_disclosureRoot",
+			"disclosureIconIdle": "I17U7q_disclosureIconIdle",
+			"disclosureChevronHover": "I17U7q_disclosureChevronHover",
+			"visuallyHidden": "I17U7q_visuallyHidden",
+			"thinkSeparator": "I17U7q_thinkSeparator",
 			"disclosureLeading": "I17U7q_disclosureLeading",
 			"thinkRow": "I17U7q_thinkRow",
-			"follow": "I17U7q_follow",
-			"disclosureChevronHover": "I17U7q_disclosureChevronHover",
+			"disclosureContent": "I17U7q_disclosureContent",
+			"disclosureRoot": "I17U7q_disclosureRoot",
+			"thinkTitle": "I17U7q_thinkTitle",
+			"think": "I17U7q_think",
+			"stopped": "I17U7q_stopped",
 			"thinkBody": "I17U7q_thinkBody",
-			"thinkTitle": "I17U7q_thinkTitle"
+			"body": "I17U7q_body",
+			"disclosureRow": "I17U7q_disclosureRow",
+			"dsh-smooth-stream-think-sweep": "I17U7q_dsh-smooth-stream-think-sweep",
+			"thinkLeading": "I17U7q_thinkLeading",
+			"disclosureTitle": "I17U7q_disclosureTitle",
+			"follow": "I17U7q_follow"
 		};
 		//#endregion
 		//#region src/client/AnimatedDisclosure.tsx
@@ -58,7 +57,7 @@ window.__ModuleLoader__.load({
 		* callback fired by row click and Enter/Space.
 		* @returns the animated disclosure row.
 		*/
-		function AnimatedDisclosure({ icon, title, open, onToggle, collapsedContent, children, rowClassName, leadingClassName, titleClassName, chevronClassName }) {
+		function AnimatedDisclosure({ icon, title, open, onToggle, collapsedContent, children, rowClassName, leadingClassName, titleClassName, chevronClassName, bodyTransition = true }) {
 			const toggleFromKeyboard = (event) => {
 				if (event.key !== "Enter" && event.key !== " ") return;
 				event.preventDefault();
@@ -94,6 +93,7 @@ window.__ModuleLoader__.load({
 					className: TypewriterAssistantNodeView_module_css_default.disclosureContent,
 					"data-disclosure-content": true,
 					"data-collapsed": open ? void 0 : "",
+					"data-no-transition": bodyTransition ? void 0 : "",
 					children
 				})]
 			});
@@ -118,7 +118,7 @@ window.__ModuleLoader__.load({
 			springStiffness: 130,
 			springDamping: 24,
 			springMass: 1,
-			runwayPx: 48,
+			runwayPx: 72,
 			reserveResponseMs: 180,
 			backpressureMinScale: .55
 		};
@@ -131,6 +131,28 @@ window.__ModuleLoader__.load({
 			debugTuning: DEFAULT_STREAM_DEBUG_TUNING
 		};
 		//#endregion
+		//#region src/client/clientStore.ts
+		/**
+		* Runtime require: the module-loader factory scopes its own resolver over the
+		* booting kernel's table; under Node (vitest) there is no global require, so
+		* fall back to `createRequire`.
+		*/
+		function pickRequire() {
+			if (typeof require === "function") return require;
+			if (typeof process !== "undefined" && typeof process.getBuiltinModule === "function") {
+				const { createRequire } = process.getBuiltinModule("node:module");
+				return createRequire(process.cwd() + "/package.json");
+			}
+			throw new TypeError("dsh-smooth-stream: no client module resolver available");
+		}
+		let clientStore;
+		try {
+			clientStore = pickRequire()("@deepseek-ai/dsh-client-store");
+		} catch {
+			clientStore = pickRequire()("@deepseek-ai/dsh-client-runtime/client");
+		}
+		const createSnapshotStore = clientStore.createSnapshotStore;
+		//#endregion
 		//#region src/client/debugRuntime.ts
 		/**
 		* Shared browser-side diagnostics state.
@@ -170,7 +192,7 @@ window.__ModuleLoader__.load({
 			tuning: { ...DEFAULT_STREAM_DEBUG_TUNING },
 			metrics: EMPTY_METRICS
 		};
-		const store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)(INITIAL_STATE);
+		const store = createSnapshotStore(INITIAL_STATE);
 		const streamMetrics = /* @__PURE__ */ new Map();
 		const followMetrics = /* @__PURE__ */ new Map();
 		let actions;
@@ -378,556 +400,195 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region src/client/useSmoothStreamContent.ts
+		//#region src/client/teleprompterGlide.ts
 		/**
-		* Stream-smoothing reveal hook.
+		* Conversation-port follow while an assistant reply streams.
 		*
-		* Buffers the model's chunked text and reveals it at a cadence that tracks
-		* the observed arrival rate, so a long reply never dumps whole paragraphs at
-		* once and a fast stream never stutters. Port of lobe-ui's smoother: EMA
-		* arrival cps + chunk size, backlog pressure, commit-interval widening with
-		* tail length, and a flush-speed settle drain once the input idles. The
-		* reveal decision is the pure {@link computeRevealStep} for unit tests.
+		* A sub-stepped spring physics engine drives a float `animatedH`, rather
+		* than restarting native smooth-scroll animations as every glyph lands.
+		* Remaining lag rides a small compositor transform while the real scrollport
+		* stays at its floor. The transform is bounded by the measured paint gap
+		* before conversation chrome. This follower:
 		*
-		* `shouldHoldBack` is the performance guard's veto: while it returns true the
-		* loop keeps measuring but skips the DOM commit, so an offscreen reply never
-		* competes with visible frames when the frame rate is degraded.
+		* - marks programmatic writes via `data-follow-owned` for compatible hosts;
+		* - sets `overflow-anchor: none` so CSS scroll-anchoring does not snap;
+		* - restores `animatedH` in a ResizeObserver (before paint) so a layout
+		*   pass cannot flash a snapped frame;
+		* - expresses safe lag as a compositor transform on message rows;
+		* - opens a speed-adaptive layout runway before fast output wraps, preserving
+		*   the reference spring constants at every reveal speed;
+		* - catches up any lag that cannot fit before turn status / composer chrome,
+		*   so fixed chrome never has to counter-shift and the host stays at-bottom;
+		* - never clips or overlays streamed text.
+		*
+		* A real reader gesture receives the effective visual position before the
+		* transform clears. Lifecycle completion instead settles at the floor.
+		*
+		* Directional wheel/touch intent unpins immediately; pointer/key input falls
+		* back to an upward scroll delta from the engine's own written position. A
+		* reader release re-acquires only after returning to the real floor.
 		*/
-		const PRESET_CONFIG = {
-			balanced: {
-				activeInputWindowMs: 220,
-				defaultCps: 80,
-				emaAlpha: .35,
-				flushCps: 180,
-				largeAppendChars: 120,
-				maxActiveCps: 360,
-				maxCps: 240,
-				maxFlushCps: 480,
-				minCps: 24,
-				settleAfterMs: 280,
-				settleDrainMaxMs: 420,
-				settleDrainMinMs: 120,
-				targetBufferMs: 40
-			},
-			realtime: {
-				activeInputWindowMs: 140,
-				defaultCps: 120,
-				emaAlpha: .45,
-				flushCps: 240,
-				largeAppendChars: 180,
-				maxActiveCps: 480,
-				maxCps: 320,
-				maxFlushCps: 640,
-				minCps: 32,
-				settleAfterMs: 200,
-				settleDrainMaxMs: 280,
-				settleDrainMinMs: 100,
-				targetBufferMs: 24
-			},
-			silky: {
-				activeInputWindowMs: 280,
-				defaultCps: 64,
-				emaAlpha: .28,
-				flushCps: 140,
-				largeAppendChars: 100,
-				maxActiveCps: 280,
-				maxCps: 180,
-				maxFlushCps: 400,
-				minCps: 20,
-				settleAfterMs: 360,
-				settleDrainMaxMs: 520,
-				settleDrainMinMs: 160,
-				targetBufferMs: 56
+		/**
+		* Programmatic follow marker retained for hosts that recognize external
+		* scroll ownership. Current Harness also sees the write land at the floor.
+		*/
+		const FOLLOW_OWNED_ATTR = "data-follow-owned";
+		/** Sub-pixel settle threshold; clearing below this cannot produce a visible rebound. */
+		const FOLLOW_SETTLE_EPSILON_PX = .25;
+		/** Runway size emitted by bundles before the 72px predictive runway. */
+		const LEGACY_RUNWAY_PX = 48;
+		/** Safe-lag occupancy band over which reveal pressure is progressively reduced. */
+		const FOLLOW_BACKPRESSURE_START_RATIO = .1;
+		/** Effective-scroll acceleration budget, in px/ms². */
+		const FOLLOW_TRAJECTORY_ACCELERATION = 22e-5;
+		const GESTURE_EVENTS = [
+			"wheel",
+			"touchstart",
+			"touchmove",
+			"touchend",
+			"touchcancel",
+			"pointerdown",
+			"keydown"
+		];
+		/** Visible runway needed for the current reveal pressure. */
+		function computeFollowReserve(speedCps, runwayPx = 72) {
+			const available = Math.max(0, runwayPx);
+			if (available <= 0) return 0;
+			if (speedCps <= 20) return 0;
+			const normalized = Math.min(1, Math.max(0, (speedCps - 20) / 580));
+			const minimum = Math.min(available, 31);
+			return minimum + normalized * (available - minimum);
+		}
+		/**
+		* Character-domain feed-forward for the stepped layout floor. Callers only
+		* provide committed reveal progress and the measured floor; wrap capacity and
+		* line height stay local to this module and adapt when a real wrap lands.
+		*/
+		var FollowRevealPhaseTracker = class {
+			charsPerLine;
+			lineHeightPx;
+			floorPx = null;
+			wrapRevealCount = 0;
+			lastRevealCount = 0;
+			constructor({ seedCharsPerLine = 50, seedLineHeightPx = 26 } = {}) {
+				this.charsPerLine = Math.max(1, seedCharsPerLine);
+				this.lineHeightPx = Math.max(1, seedLineHeightPx);
+			}
+			advance(floorPx, revealedChars) {
+				const nextFloor = Math.max(0, floorPx);
+				const nextRevealCount = Math.max(0, revealedChars);
+				if (this.floorPx === null || nextRevealCount < this.lastRevealCount) {
+					this.floorPx = nextFloor;
+					this.wrapRevealCount = nextRevealCount;
+					this.lastRevealCount = nextRevealCount;
+					return this.snapshot(nextFloor, 0);
+				}
+				const floorDelta = nextFloor - this.floorPx;
+				const lineStepThreshold = Math.max(4, this.lineHeightPx * .5);
+				if (floorDelta >= lineStepThreshold) {
+					const wrappedLines = Math.max(1, Math.round(floorDelta / this.lineHeightPx));
+					const sampledLineHeight = floorDelta / wrappedLines;
+					const revealedSinceWrap = nextRevealCount - this.wrapRevealCount;
+					if (revealedSinceWrap >= this.charsPerLine * .5) {
+						const sampledCharsPerLine = revealedSinceWrap / wrappedLines;
+						const alpha = .25;
+						this.charsPerLine += (sampledCharsPerLine - this.charsPerLine) * alpha;
+						this.lineHeightPx += (sampledLineHeight - this.lineHeightPx) * alpha;
+						this.wrapRevealCount = nextRevealCount;
+					} else this.wrapRevealCount = nextRevealCount;
+				} else if (floorDelta <= -lineStepThreshold) this.wrapRevealCount = nextRevealCount;
+				this.floorPx = nextFloor;
+				this.lastRevealCount = nextRevealCount;
+				const phase = Math.min(1, Math.max(0, (nextRevealCount - this.wrapRevealCount) / this.charsPerLine));
+				return this.snapshot(nextFloor, phase);
+			}
+			snapshot(floorPx, phase) {
+				return {
+					targetPx: floorPx + this.lineHeightPx * phase,
+					phase,
+					charsPerLine: this.charsPerLine,
+					lineHeightPx: this.lineHeightPx
+				};
 			}
 		};
-		const QUEUE_ACCEL_EXPONENT = 1.25;
-		const CATCHUP_SECONDS = .15;
-		const clamp = (value, min, max) => {
-			return Math.min(max, Math.max(min, value));
-		};
-		/** Float-debt queue integration from `ultimate_stream_physics_scroller.html`. */
-		function computeAdaptiveQueueStep(backlog, dtMs, debt, revealScale = 1, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
-			if (backlog <= 0 || dtMs <= 0) return {
-				revealChars: 0,
-				debt: 0,
-				speedCps: 0
+		/** Advance a continuous effective scroll position behind a stepped floor. */
+		function computeFollowTrajectoryStep(dtMs, input) {
+			if (dtMs <= 0) return {
+				positionPx: input.positionPx,
+				shiftPx: Math.max(0, (input.paintFloorPx ?? input.targetPx) - input.positionPx),
+				velocityPxPerMs: input.velocityPxPerMs
 			};
-			const speedCps = Math.min(tuning.maxRevealCps, 90 + Math.pow(backlog, QUEUE_ACCEL_EXPONENT) * tuning.queuePressure);
-			const effectiveScale = clamp(revealScale * tuning.revealScale, .05, 2);
-			const accumulated = Math.max(0, debt) + speedCps * effectiveScale * (dtMs / 1e3);
-			const revealChars = Math.min(backlog, Math.floor(accumulated));
+			const elapsedMs = Math.min(32, dtMs);
+			const currentLagPx = input.targetPx - input.positionPx;
+			const maxLagPx = Math.max(0, input.maxLagPx);
+			const minLagPx = Math.min(Math.max(0, input.minLagPx), maxLagPx);
+			const centerLagPx = (minLagPx + maxLagPx) / 2;
+			const desiredVelocity = Math.max(0, input.targetVelocityPxPerMs + (currentLagPx - centerLagPx) / 120);
+			const maxVelocityChange = FOLLOW_TRAJECTORY_ACCELERATION * elapsedMs;
+			const velocityPxPerMs = desiredVelocity >= input.velocityPxPerMs ? Math.min(desiredVelocity, input.velocityPxPerMs + maxVelocityChange) : Math.max(desiredVelocity, input.velocityPxPerMs - maxVelocityChange);
+			const minPosition = input.targetPx - maxLagPx;
+			const maxPosition = input.targetPx - minLagPx;
+			const frameAdvancePx = velocityPxPerMs * elapsedMs;
+			const boundedPositionPx = Math.min(maxPosition, Math.max(minPosition, input.positionPx + frameAdvancePx));
+			const positionPx = Math.max(input.positionPx, boundedPositionPx);
 			return {
-				revealChars,
-				debt: revealChars >= backlog ? 0 : accumulated - revealChars,
-				speedCps
+				positionPx,
+				shiftPx: Math.max(0, (input.paintFloorPx ?? input.targetPx) - positionPx),
+				velocityPxPerMs
 			};
 		}
-		/** Counts user-perceived characters (code points), not UTF-16 units. */
-		const countChars = (text) => {
-			let count = 0;
-			for (const char of text) count += 1;
-			return count;
-		};
-		/** Pure settle-drain decision shared by the frame loop and its tests. */
-		function computeSettleDrain(config, input) {
-			if (input.inputActive || !input.settling) return 0;
-			const overflowCps = Math.max(0, input.backlog - 300) * 1e3 / 2;
-			const drainTargetMs = clamp(input.backlog * 8, config.settleDrainMinMs, config.settleDrainMaxMs);
-			const settleCps = input.backlog * 1e3 / drainTargetMs;
-			return clamp(Math.max(settleCps, overflowCps), config.flushCps, config.maxFlushCps);
-		}
-		/** Fixed velocity that closes a producer-complete queue within its deadline. */
-		function computeCompletionDrain(config, backlog) {
-			if (backlog <= 0) return 0;
-			const drainTargetMs = clamp(backlog * 8, config.settleDrainMinMs, config.settleDrainMaxMs);
-			const deadlineCps = backlog * 1e3 / drainTargetMs;
-			return Math.max(deadlineCps, computeSettleDrain(config, {
-				backlog,
-				inputActive: false,
-				settling: true
-			}));
-		}
 		/**
-		* Drain rate multiplier once the input ends: leftover backlog reveals at
-		* this multiple of the steady rate, so the end never drags.
+		* Reveal-rate multiplier needed to retain one-wrap headroom for the spring.
+		* Throttling starts only after a quarter of the safe transform is occupied;
+		* a constrained paint lands at the minimum immediately so the next reveal
+		* commit cannot keep feeding an already-full visual buffer.
 		*/
-		const SETTLE_DRAIN_MULTIPLIER = 1.8;
-		/** Pure per-frame reveal decision shared by the loop and its tests. */
-		function computeRevealStep(config, input, dtSeconds) {
-			const trackedCps = Math.max(input.emaCps, input.arrivalCpsEma);
-			const baseCps = clamp(trackedCps, config.minCps, config.maxFlushCps);
-			const targetLagChars = input.inputActive ? Math.max(2, Math.round(baseCps * config.targetBufferMs / 1e3)) : 0;
-			let currentCps;
-			if (input.steadyCps !== void 0) currentCps = input.inputActive || input.settling ? clamp(input.steadyCps * (input.inputActive ? 1 : SETTLE_DRAIN_MULTIPLIER), config.minCps, config.maxFlushCps) : 0;
-			else if (input.inputActive) {
-				const overflow = Math.max(0, input.backlog - 32);
-				const catchup = overflow > 0 ? overflow / CATCHUP_SECONDS : 0;
-				currentCps = clamp(baseCps * 1.08 + catchup, config.minCps, config.maxFlushCps);
-			} else if (input.settling) currentCps = computeSettleDrain(config, input);
-			else {
-				const idleFlushCps = Math.max(config.flushCps, baseCps * 1.8, input.arrivalCpsEma * .8);
-				currentCps = clamp(idleFlushCps, config.flushCps, config.maxFlushCps);
+		function computeFollowRevealScale(lagPx, capacityPx, constrained = false, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
+			if (constrained) return tuning.backpressureMinScale;
+			if (!Number.isFinite(capacityPx)) return 1;
+			if (capacityPx <= 0) return lagPx > 0 ? tuning.backpressureMinScale : 1;
+			const ratio = Math.min(1, Math.max(0, lagPx / capacityPx));
+			if (ratio >= .75) return tuning.backpressureMinScale;
+			const progress = Math.min(1, Math.max(0, (ratio - FOLLOW_BACKPRESSURE_START_RATIO) / .65));
+			const eased = progress * progress * (3 - 2 * progress);
+			return 1 - (1 - tuning.backpressureMinScale) * eased;
+		}
+		/** Semi-implicit spring integration with four substeps per <=32ms slice. */
+		function computeFollowStep(dtMs, input, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
+			if (input.lag <= .1 || dtMs <= 0) return {
+				advancePx: 0,
+				lerpStep: 0,
+				velocityPxPerSec: 0
+			};
+			let lag = input.lag;
+			let velocity = Math.max(0, input.velocityPxPerSec ?? 0);
+			const elapsedMs = Math.min(32, dtMs);
+			const slices = Math.max(1, Math.ceil(elapsedMs / 32));
+			const subDt = elapsedMs / 1e3 / slices / 4;
+			for (let slice = 0; slice < slices; slice += 1) for (let substep = 0; substep < 4; substep += 1) {
+				const acceleration = (tuning.springStiffness * lag - tuning.springDamping * velocity) / tuning.springMass;
+				velocity = Math.max(0, velocity + acceleration * subDt);
+				const advance = velocity * subDt;
+				if (advance >= lag) return {
+					advancePx: input.lag,
+					lerpStep: 1,
+					velocityPxPerSec: 0
+				};
+				lag -= advance;
 			}
-			const minRevealChars = input.inputActive ? 1 : 2;
+			const advancePx = input.lag - lag;
 			return {
-				revealChars: Math.max(minRevealChars, Math.round(currentCps * dtSeconds)),
-				targetLagChars
+				advancePx,
+				lerpStep: advancePx / input.lag,
+				velocityPxPerSec: velocity
 			};
 		}
+		/** Element whose resize signals flow growth for the before-paint restore. */
+		function resizeProxyOf(port) {
+			return port.querySelector("[data-chat-transcript]") ?? port.querySelector("[data-chat-flow]");
+		}
 		/**
-		* Smooth a chunked content stream into a reveal-paced display string.
-		*
-		* @param content - The full accumulated input so far.
-		* @param options - Preset, guard, and steady-rate wiring.
-		* @returns The displayed content, revealed at the smoothed cadence.
-		*/
-		function useSmoothStreamContent(content, { enabled = true, inputComplete = false, preset = "balanced", shouldHoldBack, steadyCps, defaultCps, speedCpsRef, revealScaleRef } = {}) {
-			const config = PRESET_CONFIG[preset];
-			const seedCps = defaultCps ?? config.defaultCps;
-			const initialContent = enabled ? "" : content;
-			const [displayedContent, setDisplayedContent] = (0, react.useState)(initialContent);
-			const displayedContentRef = (0, react.useRef)(initialContent);
-			const displayedCountRef = (0, react.useRef)(countChars(initialContent));
-			const targetContentRef = (0, react.useRef)(initialContent);
-			const targetCharsRef = (0, react.useRef)([...initialContent]);
-			const targetCountRef = (0, react.useRef)(countChars(initialContent));
-			const emaCpsRef = (0, react.useRef)(seedCps);
-			const lastInputTsRef = (0, react.useRef)(0);
-			const lastInputCountRef = (0, react.useRef)(countChars(initialContent));
-			const chunkSizeEmaRef = (0, react.useRef)(1);
-			const arrivalCpsEmaRef = (0, react.useRef)(seedCps);
-			const rafRef = (0, react.useRef)(null);
-			const lastFrameTsRef = (0, react.useRef)(null);
-			const queueDebtRef = (0, react.useRef)(0);
-			const settleCpsRef = (0, react.useRef)(null);
-			const holdBackRef = (0, react.useRef)(shouldHoldBack);
-			const speedOutRef = (0, react.useRef)(speedCpsRef);
-			speedOutRef.current = speedCpsRef;
-			const revealScaleOutRef = (0, react.useRef)(revealScaleRef);
-			revealScaleOutRef.current = revealScaleRef;
-			const inputCompleteRef = (0, react.useRef)(inputComplete);
-			inputCompleteRef.current = inputComplete;
-			const streamIdRef = (0, react.useRef)(`stream-${Math.random().toString(36).slice(2)}`);
-			(0, react.useEffect)(() => {
-				holdBackRef.current = shouldHoldBack;
-			}, [shouldHoldBack]);
-			const stopFrameLoop = (0, react.useCallback)(() => {
-				if (rafRef.current !== null) {
-					cancelAnimationFrame(rafRef.current);
-					rafRef.current = null;
-				}
-				lastFrameTsRef.current = null;
-			}, []);
-			const startFrameLoopRef = (0, react.useRef)(() => {});
-			const syncImmediate = (0, react.useCallback)((nextContent) => {
-				stopFrameLoop();
-				const chars = [...nextContent];
-				const now = performance.now();
-				targetContentRef.current = nextContent;
-				targetCharsRef.current = chars;
-				targetCountRef.current = chars.length;
-				displayedContentRef.current = nextContent;
-				displayedCountRef.current = chars.length;
-				queueDebtRef.current = 0;
-				settleCpsRef.current = null;
-				const speedOut = speedOutRef.current;
-				if (speedOut !== void 0) speedOut.current = seedCps;
-				setDisplayedContent(nextContent);
-				emaCpsRef.current = seedCps;
-				chunkSizeEmaRef.current = 1;
-				arrivalCpsEmaRef.current = seedCps;
-				lastInputTsRef.current = now;
-				lastInputCountRef.current = chars.length;
-			}, [seedCps, stopFrameLoop]);
-			(0, react.useLayoutEffect)(() => {
-				if (!enabled || !inputComplete || displayedContentRef.current === content) return;
-				syncImmediate(content);
-			}, [
-				content,
-				enabled,
-				inputComplete,
-				syncImmediate
-			]);
-			const startFrameLoop = (0, react.useCallback)(() => {
-				if (rafRef.current !== null) return;
-				const tick = (now) => {
-					const targetCount = targetCountRef.current;
-					const displayedCount = displayedCountRef.current;
-					const backlog = targetCount - displayedCount;
-					if (backlog <= 0) {
-						queueDebtRef.current = 0;
-						settleCpsRef.current = null;
-						const speedOut = speedOutRef.current;
-						if (speedOut !== void 0) speedOut.current = seedCps;
-						debugRuntime.reportStream(streamIdRef.current, null);
-						stopFrameLoop();
-						return;
-					}
-					if (lastFrameTsRef.current === null) {
-						lastFrameTsRef.current = now;
-						rafRef.current = requestAnimationFrame(tick);
-						return;
-					}
-					const frameIntervalMs = Math.max(0, now - lastFrameTsRef.current);
-					const dtSeconds = Math.max(.001, Math.min(frameIntervalMs / 1e3, .12));
-					lastFrameTsRef.current = now;
-					const idleMs = now - lastInputTsRef.current;
-					const producerComplete = inputCompleteRef.current;
-					const debugTuning = debugRuntime.activeTuning();
-					const inputActive = !producerComplete && idleMs <= config.activeInputWindowMs;
-					const settling = producerComplete || !inputActive && idleMs >= config.settleAfterMs;
-					if (!producerComplete) settleCpsRef.current = null;
-					let revealChars;
-					let revealSpeedCps;
-					let nextQueueDebt = 0;
-					if (producerComplete) {
-						const settleCps = settleCpsRef.current ?? computeCompletionDrain(config, backlog);
-						settleCpsRef.current = settleCps;
-						const accumulated = Math.max(0, queueDebtRef.current) + settleCps * dtSeconds;
-						revealChars = Math.min(backlog, Math.floor(accumulated));
-						revealSpeedCps = settleCps;
-						nextQueueDebt = revealChars >= backlog ? 0 : accumulated - revealChars;
-					} else if (steadyCps !== void 0) {
-						const step = computeRevealStep(config, {
-							backlog,
-							chunkSizeEma: chunkSizeEmaRef.current,
-							arrivalCpsEma: arrivalCpsEmaRef.current,
-							emaCps: emaCpsRef.current,
-							inputActive,
-							settling,
-							steadyCps
-						}, dtSeconds);
-						revealChars = Math.min(Math.round(step.revealChars * debugTuning.revealScale), backlog);
-						revealSpeedCps = frameIntervalMs > 0 ? revealChars * 1e3 / frameIntervalMs : 0;
-					} else {
-						const step = computeAdaptiveQueueStep(backlog, frameIntervalMs, queueDebtRef.current, revealScaleOutRef.current?.current ?? 1, debugTuning);
-						revealChars = step.revealChars;
-						revealSpeedCps = step.speedCps;
-						nextQueueDebt = step.debt;
-					}
-					debugRuntime.reportStream(streamIdRef.current, {
-						backlog,
-						speedCps: revealSpeedCps,
-						targetChars: targetCount,
-						displayedChars: displayedCount,
-						active: !producerComplete
-					});
-					if (holdBackRef.current?.() === true) {
-						rafRef.current = requestAnimationFrame(tick);
-						return;
-					}
-					queueDebtRef.current = nextQueueDebt;
-					const speedOut = speedOutRef.current;
-					if (speedOut !== void 0) speedOut.current = revealSpeedCps;
-					if (revealChars <= 0) {
-						rafRef.current = requestAnimationFrame(tick);
-						return;
-					}
-					const nextCount = displayedCount + revealChars;
-					const segment = targetCharsRef.current.slice(displayedCount, nextCount).join("");
-					if (segment) {
-						const nextDisplayed = displayedContentRef.current + segment;
-						displayedContentRef.current = nextDisplayed;
-						displayedCountRef.current = nextCount;
-						setDisplayedContent(nextDisplayed);
-					} else {
-						displayedContentRef.current = targetContentRef.current;
-						displayedCountRef.current = targetCount;
-						setDisplayedContent(targetContentRef.current);
-					}
-					rafRef.current = requestAnimationFrame(tick);
-				};
-				rafRef.current = requestAnimationFrame(tick);
-			}, [
-				config,
-				stopFrameLoop,
-				steadyCps
-			]);
-			(0, react.useEffect)(() => {
-				startFrameLoopRef.current = startFrameLoop;
-			}, [startFrameLoop]);
-			(0, react.useEffect)(() => {
-				if (!enabled) {
-					syncImmediate(content);
-					return;
-				}
-				const prevTargetContent = targetContentRef.current;
-				if (content === prevTargetContent) return;
-				const now = performance.now();
-				if (!content.startsWith(prevTargetContent)) {
-					syncImmediate(content);
-					return;
-				}
-				const appendedChars = [...content.slice(prevTargetContent.length)];
-				const appendedCount = appendedChars.length;
-				targetContentRef.current = content;
-				targetCharsRef.current.push(...appendedChars);
-				targetCountRef.current += appendedCount;
-				settleCpsRef.current = null;
-				const hadSample = lastInputTsRef.current > 0;
-				const deltaChars = targetCountRef.current - lastInputCountRef.current;
-				const deltaMs = Math.max(1, now - lastInputTsRef.current);
-				if (hadSample && deltaChars > 0) {
-					const instantCps = deltaChars * 1e3 / deltaMs;
-					const normalizedInstantCps = clamp(instantCps, config.minCps, config.maxFlushCps * 3);
-					const chunkEmaAlpha = .45;
-					chunkSizeEmaRef.current = chunkSizeEmaRef.current * .55 + appendedCount * chunkEmaAlpha;
-					arrivalCpsEmaRef.current = arrivalCpsEmaRef.current * .55 + normalizedInstantCps * chunkEmaAlpha;
-					emaCpsRef.current = emaCpsRef.current * (1 - config.emaAlpha) + normalizedInstantCps * config.emaAlpha;
-				}
-				lastInputTsRef.current = now;
-				lastInputCountRef.current = targetCountRef.current;
-				startFrameLoop();
-			}, [
-				content,
-				enabled,
-				config,
-				startFrameLoop,
-				syncImmediate
-			]);
-			(0, react.useEffect)(() => {
-				return () => {
-					stopFrameLoop();
-					debugRuntime.reportStream(streamIdRef.current, null);
-				};
-			}, [stopFrameLoop]);
-			return displayedContent;
-		}
-		//#endregion
-		//#region src/client/useFpsGuard.ts
-		/**
-		* Performance guard for the streaming reveal.
-		*
-		* Feeds an EMA-smoothed frame-rate monitor from a rAF loop while streaming
-		* and tracks whether the reply is on-screen. The returned `shouldHoldBack`
-		* predicate is true only while the frame rate is below the threshold AND the
-		* reply is offscreen — exactly the spec's "skip offscreen DOM updates when
-		* FPS < 30" rule. The smoother consumes the predicate as its commit veto.
-		*/
-		const FPS_THRESHOLD = 30;
-		const FPS_ALPHA = .12;
-		const RECOVER_FRAMES = 6;
-		const MAX_FRAME_MS = 100;
-		function useFpsGuard(active) {
-			const fpsRef = (0, react.useRef)({
-				emaMs: 0,
-				lastMs: 0,
-				healthyRun: 0,
-				degraded: false
-			});
-			const visibleRef = (0, react.useRef)(true);
-			const elementRef = (0, react.useRef)(null);
-			(0, react.useEffect)(() => {
-				if (!active) return;
-				let rafId = 0;
-				let lastDebugReport = 0;
-				const frame = (now) => {
-					rafId = requestAnimationFrame(frame);
-					const fps = fpsRef.current;
-					if (fps.lastMs === 0) {
-						fps.lastMs = now;
-						return;
-					}
-					const delta = Math.min(MAX_FRAME_MS, Math.max(1, now - fps.lastMs));
-					fps.lastMs = now;
-					fps.emaMs = fps.emaMs === 0 ? delta : fps.emaMs + FPS_ALPHA * (delta - fps.emaMs);
-					const currentFps = 1e3 / fps.emaMs;
-					if (currentFps < FPS_THRESHOLD) {
-						fps.healthyRun = 0;
-						fps.degraded = true;
-					} else if (fps.degraded) {
-						fps.healthyRun += 1;
-						if (fps.healthyRun >= RECOVER_FRAMES) fps.degraded = false;
-					}
-					if (now - lastDebugReport >= 100) {
-						debugRuntime.reportFps(currentFps, fps.emaMs, fps.degraded);
-						lastDebugReport = now;
-					}
-				};
-				rafId = requestAnimationFrame(frame);
-				return () => {
-					cancelAnimationFrame(rafId);
-					fpsRef.current = {
-						emaMs: 0,
-						lastMs: 0,
-						healthyRun: 0,
-						degraded: false
-					};
-					debugRuntime.clearFps();
-				};
-			}, [active]);
-			const ref = (0, react.useCallback)((element) => {
-				elementRef.current = element;
-			}, []);
-			(0, react.useEffect)(() => {
-				const element = elementRef.current;
-				if (element === null || typeof IntersectionObserver === "undefined") return;
-				const observer = new IntersectionObserver((entries) => {
-					for (const entry of entries) visibleRef.current = entry.isIntersecting;
-				}, { rootMargin: "120px 0px" });
-				observer.observe(element);
-				return () => observer.disconnect();
-			});
-			return {
-				ref,
-				shouldHoldBack: (0, react.useCallback)(() => {
-					return active && fpsRef.current.degraded && !visibleRef.current;
-				}, [active])
-			};
-		}
-		//#endregion
-		//#region src/client/teleprompterGlide.ts
-		/**
-		* Conversation-port follow while an assistant reply streams.
-		*
-		* A sub-stepped spring physics engine drives a float `animatedH`, rather
-		* than restarting native smooth-scroll animations as every glyph lands.
-		* Remaining lag rides a small compositor transform while the real scrollport
-		* stays at its floor. The transform is bounded by the measured paint gap
-		* before conversation chrome. This follower:
-		*
-		* - marks programmatic writes via `data-follow-owned` for compatible hosts;
-		* - sets `overflow-anchor: none` so CSS scroll-anchoring does not snap;
-		* - restores `animatedH` in a ResizeObserver (before paint) so a layout
-		*   pass cannot flash a snapped frame;
-		* - expresses safe lag as a compositor transform on message rows;
-		* - opens a speed-adaptive layout runway before fast output wraps, preserving
-		*   the reference spring constants at every reveal speed;
-		* - catches up any lag that cannot fit before turn status / composer chrome,
-		*   so fixed chrome never has to counter-shift and the host stays at-bottom;
-		* - never clips or overlays streamed text.
-		*
-		* A real reader gesture receives the effective visual position before the
-		* transform clears. Lifecycle completion instead settles at the floor.
-		*
-		* Directional wheel/touch intent unpins immediately; pointer/key input falls
-		* back to an upward scroll delta from the engine's own written position. A
-		* reader release re-acquires only after returning to the real floor.
-		*/
-		/**
-		* Programmatic follow marker retained for hosts that recognize external
-		* scroll ownership. Current Harness also sees the write land at the floor.
-		*/
-		const FOLLOW_OWNED_ATTR = "data-follow-owned";
-		/** Sub-pixel settle threshold; clearing below this cannot produce a visible rebound. */
-		const FOLLOW_SETTLE_EPSILON_PX = .25;
-		/** Safe-lag occupancy band over which reveal pressure is progressively reduced. */
-		const FOLLOW_BACKPRESSURE_START_RATIO = .25;
-		const GESTURE_EVENTS = [
-			"wheel",
-			"touchstart",
-			"touchmove",
-			"touchend",
-			"touchcancel",
-			"pointerdown",
-			"keydown"
-		];
-		/** Visible runway needed for the current reveal pressure. */
-		function computeFollowReserve(speedCps, runwayPx = 48) {
-			const available = Math.max(0, runwayPx);
-			if (available <= 0) return 0;
-			if (speedCps <= 90) return 0;
-			const normalized = Math.min(1, Math.max(0, (speedCps - 90) / 510));
-			const minimum = Math.min(available, 16);
-			return minimum + normalized * (available - minimum);
-		}
-		/**
-		* Reveal-rate multiplier needed to retain one-wrap headroom for the spring.
-		* Throttling starts only after a quarter of the safe transform is occupied;
-		* a constrained paint lands at the minimum immediately so the next reveal
-		* commit cannot keep feeding an already-full visual buffer.
-		*/
-		function computeFollowRevealScale(lagPx, capacityPx, constrained = false, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
-			if (constrained) return tuning.backpressureMinScale;
-			if (!Number.isFinite(capacityPx)) return 1;
-			if (capacityPx <= 0) return lagPx > 0 ? tuning.backpressureMinScale : 1;
-			const ratio = Math.min(1, Math.max(0, lagPx / capacityPx));
-			if (ratio >= .75) return tuning.backpressureMinScale;
-			const progress = Math.min(1, Math.max(0, (ratio - FOLLOW_BACKPRESSURE_START_RATIO) / .5));
-			const eased = progress * progress * (3 - 2 * progress);
-			return 1 - (1 - tuning.backpressureMinScale) * eased;
-		}
-		/**
-		* Semi-implicit spring integration with four substeps per <=32ms slice.
-		* @param dtMs - Frame delta in ms.
-		* @param input - Current visible lag and carried physics velocity.
-		* @returns The position advance, its fraction, and next velocity.
-		*/
-		function computeFollowStep(dtMs, input, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
-			if (input.lag <= .1 || dtMs <= 0) return {
-				advancePx: 0,
-				lerpStep: 0,
-				velocityPxPerSec: 0
-			};
-			let lag = input.lag;
-			let velocity = Math.max(0, input.velocityPxPerSec ?? 0);
-			const elapsedMs = Math.min(32, dtMs);
-			const slices = Math.max(1, Math.ceil(elapsedMs / 32));
-			const subDt = elapsedMs / 1e3 / slices / 4;
-			for (let slice = 0; slice < slices; slice += 1) for (let substep = 0; substep < 4; substep += 1) {
-				const acceleration = (tuning.springStiffness * lag - tuning.springDamping * velocity) / tuning.springMass;
-				velocity = Math.max(0, velocity + acceleration * subDt);
-				const advance = velocity * subDt;
-				if (advance >= lag) return {
-					advancePx: input.lag,
-					lerpStep: 1,
-					velocityPxPerSec: 0
-				};
-				lag -= advance;
-			}
-			const advancePx = input.lag - lag;
-			return {
-				advancePx,
-				lerpStep: advancePx / input.lag,
-				velocityPxPerSec: velocity
-			};
-		}
-		/** Element whose resize signals flow growth for the before-paint restore. */
-		function resizeProxyOf(port) {
-			return port.querySelector("[data-chat-transcript]") ?? port.querySelector("[data-chat-flow]");
-		}
-		/**
-		* Outermost message surfaces; nested tool rows ride their parent.
+		* Outermost message surfaces; nested tool rows ride their parent.
 		*
 		* Another plugin may insert its own element as a flow sibling of the Chat rows
 		* (meow-memory's fold bar is one; so is this plugin's own fold summary row).
@@ -945,15 +606,12 @@ window.__ModuleLoader__.load({
 			if (flow === null) return anchored;
 			const status = turnStatusOf(port);
 			const anchoredSet = new Set(anchored);
-			const __dbg = [...flow.children].filter((child) => child instanceof HTMLElement && child !== status && (anchoredSet.has(child) || child.querySelector("[data-chat-anchor-key]") === null));
-			console.log("[engine] reached end of shiftSurfacesOf, n=", __dbg.length);
-			globalThis.__dshssProbe = __dbg.map((e) => `${e.tagName}:${e.getAttribute("data-chat-anchor-key") ?? e.className}`);
-			return __dbg;
+			return [...flow.children].filter((child) => child instanceof HTMLElement && child !== status && (anchoredSet.has(child) || child.querySelector("[data-chat-anchor-key]") === null));
 		}
 		function currentShiftOf(element) {
 			return Number(/translate3d\(0(?:px)?,\s*(-?[\d.]+)px,\s*0(?:px)?\)/.exec(element.style.transform)?.[1] ?? 0);
 		}
-		function setShift(element, px) {
+		function setDirectShift(element, px) {
 			if (Math.abs(px) > .01) {
 				if (Math.abs(currentShiftOf(element) - px) <= .01 && element.style.willChange === "transform" && element.style.clipPath === "") return;
 				element.style.transform = `translate3d(0, ${px}px, 0)`;
@@ -965,9 +623,62 @@ window.__ModuleLoader__.load({
 			}
 			element.style.clipPath = "";
 		}
+		function setShift(element, px) {
+			if (Math.abs(px) > .01 && element.querySelector("[role=\"tooltip\"]") !== null) {
+				setDirectShift(element, 0);
+				return;
+			}
+			setDirectShift(element, px);
+		}
 		function turnStatusOf(port) {
 			return port.querySelector("[data-chat-turn-status], [data-chat-flow] > [role=\"status\"]");
 		}
+		const FOLLOW_FLOW_FILL_SYMBOL = Symbol.for("dsh-smooth-stream.follow-flow-fill");
+		const followFlowFillHost = globalThis;
+		const followFlowFills = followFlowFillHost[FOLLOW_FLOW_FILL_SYMBOL] ?? /* @__PURE__ */ new WeakMap();
+		followFlowFillHost[FOLLOW_FLOW_FILL_SYMBOL] = followFlowFills;
+		const FOLLOW_FLOW_FILL_USERS_SYMBOL = Symbol.for("dsh-smooth-stream.follow-flow-fill-users");
+		const followFlowFillUsersHost = globalThis;
+		const followFlowFillUsers = followFlowFillUsersHost[FOLLOW_FLOW_FILL_USERS_SYMBOL] ?? /* @__PURE__ */ new WeakMap();
+		followFlowFillUsersHost[FOLLOW_FLOW_FILL_USERS_SYMBOL] = followFlowFillUsers;
+		function flowElementOf(port) {
+			return port.querySelector("[data-chat-transcript]") ?? port.querySelector("[data-chat-flow]");
+		}
+		function ensureFlowFillsPort(port) {
+			const element = flowElementOf(port);
+			const owned = followFlowFills.get(port);
+			if (element === null) {
+				if (owned !== void 0) restoreFlowFill(port);
+				return;
+			}
+			const client = Math.max(0, port.clientHeight);
+			let overshoot = owned?.overshootPx;
+			if (overshoot === void 0) {
+				const pendingOriginal = element.style.minHeight;
+				element.style.minHeight = `${client}px`;
+				overshoot = Math.max(0, port.scrollHeight - client);
+				element.style.minHeight = pendingOriginal;
+				if (owned !== void 0) restoreFlowFill(port);
+			}
+			const target = `${Math.max(0, client - overshoot)}px`;
+			if (owned !== void 0) {
+				if (owned.element === element && owned.overshootPx === overshoot && element.style.minHeight === target) return;
+				restoreFlowFill(port);
+			}
+			const original = element.style.minHeight;
+			element.style.minHeight = target;
+			followFlowFills.set(port, {
+				element,
+				original,
+				overshootPx: overshoot
+			});
+		}
+		function restoreFlowFill(port) {
+			const owned = followFlowFills.get(port);
+			if (owned === void 0) return;
+			owned.element.style.minHeight = owned.original;
+			followFlowFills.delete(port);
+		}
 		/** Height committed by one newly mounted Chat row, including its flex gap. */
 		function entranceExtentOf(root) {
 			const row = root.closest("[data-chat-flow-key]") ?? root;
@@ -991,11 +702,48 @@ window.__ModuleLoader__.load({
 		const followRunways = followRunwayRegistry[FOLLOW_RUNWAYS_SYMBOL] ?? /* @__PURE__ */ new WeakMap();
 		followRunwayRegistry[FOLLOW_RUNWAYS_SYMBOL] = followRunways;
 		const followPaintLimits = /* @__PURE__ */ new WeakMap();
+		const followHadChrome = /* @__PURE__ */ new WeakSet();
+		/** Last painted shift per port, to spread a wrap's one-line step over frames. */
+		const followLastShiftPx = /* @__PURE__ */ new WeakMap();
+		/** Last runway offset seen per port, to rebase the extent when the margin size changes. */
+		const followRunwayOffsetHistory = /* @__PURE__ */ new WeakMap();
+		/** Last observed scroll floor per port, for the slack→overflow runway re-measure. */
+		const followFloorHistory = /* @__PURE__ */ new WeakMap();
+		/** One-shot flag: the transition frame must paint the full runway as baseline. */
+		const followSlackTransition = /* @__PURE__ */ new WeakSet();
 		function invalidatePaintLimit(port) {
 			followPaintLimits.delete(port);
 		}
 		/** Logical position and velocity survive a React owner handoff and finish. */
 		const followMotionStates = /* @__PURE__ */ new WeakMap();
+		const followReaderHolds = /* @__PURE__ */ new WeakMap();
+		/**
+		* Commit-time correction channel. A reveal commit that lands after this
+		* frame's ResizeObserver delivery would otherwise paint one intermediate
+		* frame — content grown, scrollTop/transform not yet compensated — before
+		* the next tick fixes it. Reveal arms call {@link notifyFollowCommit} right
+		* after their commit; the leading follower re-runs its geometry in the same
+		* task, so the intermediate state never reaches a paint.
+		*/
+		const followCommitListeners = /* @__PURE__ */ new WeakMap();
+		function notifyFollowCommit(fromInsidePort) {
+			if (fromInsidePort === null) return;
+			const port = fromInsidePort.closest("[data-conversation-scroll]");
+			const listeners = port === null ? void 0 : followCommitListeners.get(port);
+			if (listeners === void 0) return;
+			for (const listener of [...listeners]) listener();
+		}
+		function subscribeFollowCommit(port, fn) {
+			let listeners = followCommitListeners.get(port);
+			if (listeners === void 0) {
+				listeners = /* @__PURE__ */ new Set();
+				followCommitListeners.set(port, listeners);
+			}
+			listeners.add(fn);
+			return () => {
+				listeners.delete(fn);
+			};
+		}
 		function restoreRunway(port) {
 			const runway = followRunways.get(port);
 			if (runway === void 0) return;
@@ -1007,14 +755,13 @@ window.__ModuleLoader__.load({
 			if (value === "") return false;
 			const terms = [...value.matchAll(/([\d.]+)px/g)];
 			if (terms.length === 0 || value.replaceAll(/calc|px|[\d.+()\s]/g, "") !== "") return false;
-			return terms.every(([, raw]) => {
-				const px = Number(raw);
-				return Number.isFinite(px) && px >= 48 && Math.abs(px % 48) <= Number.EPSILON;
-			});
+			const values = terms.map(([, raw]) => Number(raw));
+			if (values.some((px) => !Number.isFinite(px))) return false;
+			return [LEGACY_RUNWAY_PX, 72].some((unit) => values.every((px) => px >= unit && Math.abs(px % unit) <= Number.EPSILON));
 		}
 		/** Remove unowned runway residue written by v0.3.3 and earlier bundles. */
 		function migrateLegacyRunway(port, surfaces, status, composer) {
-			if (followRunways.has(port)) return;
+			if (followRunways.has(port)) return false;
 			let migrated = false;
 			if (status !== null && isLegacyRunway(status.style.marginTop)) {
 				status.style.marginTop = "";
@@ -1026,13 +773,29 @@ window.__ModuleLoader__.load({
 				migrated = true;
 			}
 			if (migrated) invalidatePaintLimit(port);
+			return migrated;
 		}
-		function ensureRunway(port, surfaces, runwayPx = 48) {
+		function ensureRunway(port, surfaces, runwayPx = 72) {
 			const status = turnStatusOf(port);
 			const composer = port.querySelector("[data-composer-seat]");
-			migrateLegacyRunway(port, surfaces, status, composer);
+			if (status !== null && followRunways.get(port) === void 0) {
+				const inlinePx = Number.parseFloat(status.style.marginTop ?? "") || 0;
+				if (Math.abs(inlinePx - 72) <= .5) {
+					followRunways.set(port, {
+						element: status,
+						offset: inlinePx,
+						property: "marginTop",
+						original: "",
+						requestedPx: inlinePx
+					});
+					invalidatePaintLimit(port);
+				}
+			}
+			const migratedLegacy = migrateLegacyRunway(port, surfaces, status, composer);
 			const naturalHeight = Math.max(0, port.scrollHeight - runwayOffsetOf(port));
-			if (runwayPx <= 0 || port.clientHeight <= 0 || naturalHeight <= port.clientHeight) {
+			const existing = followRunways.get(port);
+			const requestedRunwayPx = migratedLegacy || existing?.normalizedLegacy === true ? 72 : runwayPx;
+			if (requestedRunwayPx <= 0 || port.clientHeight <= 0 || naturalHeight <= port.clientHeight) {
 				restoreRunway(port);
 				return;
 			}
@@ -1049,18 +812,19 @@ window.__ModuleLoader__.load({
 			}
 			const element = target.element;
 			const current = followRunways.get(port);
-			if (current?.element === element && current.property === target.property && current.requestedPx === runwayPx) return;
+			if (current?.element === element && current.property === target.property && current.requestedPx === requestedRunwayPx) return;
 			restoreRunway(port);
 			const beforeHeight = port.scrollHeight;
 			const original = element.style[target.property];
-			element.style[target.property] = original === "" ? `${runwayPx}px` : `calc(${original} + ${runwayPx}px)`;
+			element.style[target.property] = original === "" ? `${requestedRunwayPx}px` : `calc(${original} + ${requestedRunwayPx}px)`;
 			const offset = Math.max(0, port.scrollHeight - beforeHeight);
 			followRunways.set(port, {
 				element,
 				offset,
 				property: target.property,
 				original,
-				requestedPx: runwayPx
+				requestedPx: requestedRunwayPx,
+				normalizedLegacy: migratedLegacy || existing?.normalizedLegacy === true
 			});
 			invalidatePaintLimit(port);
 		}
@@ -1073,13 +837,14 @@ window.__ModuleLoader__.load({
 			if (last === void 0) return 0;
 			const status = turnStatusOf(port);
 			const composer = port.querySelector("[data-composer-seat]");
+			if (status !== null || composer !== null) followHadChrome.add(port);
 			const cached = followPaintLimits.get(port);
 			if (cached !== void 0 && performance.now() - cached.measuredAtMs <= 250 && cached.clientHeight === port.clientHeight && cached.surface === last && cached.status === status && cached.composer === composer) return cached.limit;
 			const ceiling = [status, composer].filter((element) => element !== null).map((element) => ({
 				element,
 				rect: element.getBoundingClientRect()
 			})).filter(({ rect }) => Number.isFinite(rect.top) && Number.isFinite(rect.bottom) && rect.bottom > rect.top).sort((first, second) => first.rect.top - second.rect.top)[0];
-			if (ceiling === void 0) return status === null && composer === null ? Number.POSITIVE_INFINITY : runwayOffsetOf(port);
+			if (ceiling === void 0) return status === null && composer === null ? followHadChrome.has(port) ? 0 : Number.POSITIVE_INFINITY : runwayOffsetOf(port);
 			const ceilingTop = ceiling.rect.top - currentShiftOf(ceiling.element);
 			const naturalBottom = last.getBoundingClientRect().bottom - currentShiftOf(last);
 			const limit = Math.max(0, ceilingTop - naturalBottom - 1);
@@ -1091,491 +856,1144 @@ window.__ModuleLoader__.load({
 				status,
 				surface: last
 			});
-			return limit;
+			return limit;
+		}
+		function setFollowScrollTop(port, nextTop) {
+			if (Math.abs(port.scrollTop - nextTop) > .01) port.scrollTop = nextTop;
+			followScrollLedgers.set(port, port.scrollTop);
+			const ownedTop = String(port.scrollTop);
+			if (port.getAttribute(FOLLOW_OWNED_ATTR) !== ownedTop) port.setAttribute(FOLLOW_OWNED_ATTR, ownedTop);
+		}
+		/**
+		* Last scrollTop this engine wrote or accepted, per port. Reader intent is a
+		* real upward delta from this ledger; a key press or touch while pinned
+		* (typing in the composer) must not release the pin, because a released pin
+		* can never re-acquire while content streams away from the reader position.
+		*/
+		const followScrollLedgers = /* @__PURE__ */ new WeakMap();
+		const followActivityAt = /* @__PURE__ */ new WeakMap();
+		/** Whether this port was owned recently enough to identify a closing tail row. */
+		function hasRecentConversationFollow(port, windowMs = 250) {
+			const last = followActivityAt.get(port);
+			return last !== void 0 && performance.now() - last <= windowMs;
+		}
+		function readerScrolledUp(port) {
+			return port.scrollTop < (followScrollLedgers.get(port) ?? 0) - 8;
+		}
+		/**
+		* Paint a bounded visual lag and return the effective logical extent.
+		*
+		* This is the final geometry invariant, not merely an animation preference:
+		* any lag beyond the real gap to status/composer chrome is caught up in the
+		* same frame. Carrying that excess in `scrollTop` would move the transcript
+		* toward fixed chrome and also make the host expose jump-to-bottom.
+		*/
+		function applyVisual(port, animatedH, reservePx, velocityPxPerSec = 0, runwayPx = 72, shiftCeilingPx = Number.POSITIVE_INFINITY, promoteAtRest = false, trajectoryShiftPx) {
+			const surfaces = shiftSurfacesOf(port);
+			ensureFlowFillsPort(port);
+			{
+				const preFloor = Math.max(0, port.scrollHeight - port.clientHeight);
+				const lastFloorSeen = followFloorHistory.get(port);
+				if (lastFloorSeen !== void 0 && lastFloorSeen === 0 && preFloor > 0 && followRunways.has(port)) {
+					const owned = followRunways.get(port);
+					restoreRunway(port);
+					ensureRunway(port, surfaces, owned?.requestedPx ?? runwayPx);
+					followSlackTransition.add(port);
+				}
+				if (preFloor !== lastFloorSeen) {
+					invalidatePaintLimit(port);
+					followFloorHistory.set(port, preFloor);
+				}
+			}
+			ensureRunway(port, surfaces, reservePx);
+			const contentHeight2 = Math.max(0, port.scrollHeight);
+			const runwayOffset2 = runwayOffsetOf(port);
+			const prevOffset2 = followRunwayOffsetHistory.get(port);
+			if (prevOffset2 !== void 0 && runwayOffset2 !== prevOffset2) animatedH = Math.max(0, animatedH - (runwayOffset2 - prevOffset2));
+			followRunwayOffsetHistory.set(port, runwayOffset2);
+			const contentHeight = contentHeight2;
+			const runwayOffset = runwayOffset2;
+			const targetHeight = Math.max(0, contentHeight - runwayOffset);
+			const floor = Math.max(0, contentHeight - port.clientHeight);
+			const extent = Math.min(targetHeight, Math.max(0, animatedH));
+			if (port.style.overflowAnchor !== "none") port.style.overflowAnchor = "none";
+			if (port.style.scrollBehavior !== "auto") port.style.scrollBehavior = "auto";
+			if (floor <= 0) {
+				followRunwayOffsetHistory.set(port, 0);
+				setFollowScrollTop(port, 0);
+				followMotionStates.set(port, {
+					capacityPx: Number.POSITIVE_INFINITY,
+					constrained: false,
+					extent: targetHeight,
+					lagPx: 0,
+					reservePx: 0,
+					velocityPxPerSec: 0
+				});
+				for (const surface of surfaces) setShift(surface, 0);
+				followLastShiftPx.set(port, 0);
+				const status = turnStatusOf(port);
+				if (status !== null) setShift(status, 0);
+				return targetHeight;
+			}
+			const limit = safeShiftLimit(port, surfaces);
+			followSlackTransition.delete(port);
+			const visibleReserve = Math.min(runwayOffset, Math.max(0, reservePx));
+			const baselineShift = runwayOffset - visibleReserve;
+			const requestedLag = Math.max(0, targetHeight - extent);
+			const availableShift = Math.min(Math.max(0, limit), Math.max(0, shiftCeilingPx));
+			const motionShift = Math.min(trajectoryShiftPx ?? baselineShift + requestedLag, availableShift);
+			let shift = Math.max(motionShift, promoteAtRest && motionShift <= .01 && availableShift > 0 ? .1 : 0);
+			const previousShift = followLastShiftPx.get(port);
+			if (previousShift !== void 0 && shift < previousShift - 8) shift = previousShift - 8;
+			followLastShiftPx.set(port, shift);
+			const effectiveLag = Math.max(0, motionShift - baselineShift);
+			const capacityPx = Math.max(0, limit - baselineShift);
+			const effectiveExtent = targetHeight - effectiveLag;
+			setFollowScrollTop(port, floor);
+			followMotionStates.set(port, {
+				capacityPx,
+				constrained: requestedLag > effectiveLag + FOLLOW_SETTLE_EPSILON_PX,
+				extent: effectiveExtent,
+				lagPx: effectiveLag,
+				reservePx: visibleReserve,
+				velocityPxPerSec
+			});
+			for (const surface of surfaces) setShift(surface, shift);
+			const status = turnStatusOf(port);
+			if (status !== null) setShift(status, 0);
+			return effectiveExtent;
+		}
+		function clearMotion(port) {
+			port.removeAttribute(FOLLOW_OWNED_ATTR);
+			port.style.overflowAnchor = "";
+			port.style.scrollBehavior = "";
+			for (const surface of shiftSurfacesOf(port)) setShift(surface, 0);
+			const status = turnStatusOf(port);
+			if (status !== null) setShift(status, 0);
+		}
+		function clearVisual(port) {
+			clearMotion(port);
+			restoreRunway(port);
+			followMotionStates.delete(port);
+			followLastShiftPx.delete(port);
+			invalidatePaintLimit(port);
+		}
+		/** Keep an already-promoted surface at zero until one stable final paint lands. */
+		function holdCompositorAtRest(element) {
+			element.style.transform = "translate3d(0, 0px, 0)";
+			element.style.willChange = "transform";
+			element.style.clipPath = "";
+		}
+		/** Remove equal offsets, land on the floor, then retire the compositor quietly. */
+		function finishAtNaturalFloor(port, retainCompositor = true) {
+			const surfaces = shiftSurfacesOf(port);
+			const status = turnStatusOf(port);
+			if (!retainCompositor) {
+				restoreRunway(port);
+				settleAtFloor(port);
+				clearMotion(port);
+				followMotionStates.delete(port);
+				return;
+			}
+			const promoted = [...surfaces, ...status === null ? [] : [status]].filter((element) => element.style.transform !== "" || element.style.willChange === "transform");
+			const promotedSet = new Set(promoted);
+			restoreRunway(port);
+			settleAtFloor(port);
+			port.removeAttribute(FOLLOW_OWNED_ATTR);
+			port.style.overflowAnchor = "";
+			port.style.scrollBehavior = "";
+			for (const surface of surfaces) if (promotedSet.has(surface)) holdCompositorAtRest(surface);
+			else setShift(surface, 0);
+			if (status !== null) {
+				if (promotedSet.has(status)) holdCompositorAtRest(status);
+				else setShift(status, 0);
+			}
+			followMotionStates.delete(port);
+			if (promoted.length === 0) return;
+			requestAnimationFrame(() => {
+				requestAnimationFrame(() => {
+					for (const element of promoted) if (Math.abs(currentShiftOf(element)) <= .01) setShift(element, 0);
+				});
+			});
 		}
-		function setFollowScrollTop(port, nextTop) {
-			if (Math.abs(port.scrollTop - nextTop) > .01) port.scrollTop = nextTop;
-			followScrollLedgers.set(port, port.scrollTop);
-			const ownedTop = String(port.scrollTop);
-			if (port.getAttribute(FOLLOW_OWNED_ATTR) !== ownedTop) port.setAttribute(FOLLOW_OWNED_ATTR, ownedTop);
+		function settleAtFloor(port) {
+			setFollowScrollTop(port, Math.max(0, port.scrollHeight - port.clientHeight));
+			followReaderHolds.delete(port);
 		}
+		/** Only the newest active follower may write one port's shared visual state. */
+		const followLeaders = /* @__PURE__ */ new WeakMap();
+		let followGeneration = 0;
 		/**
-		* Last scrollTop this engine wrote or accepted, per port. Reader intent is a
-		* real upward delta from this ledger; a key press or touch while pinned
-		* (typing in the composer) must not release the pin, because a released pin
-		* can never re-acquire while content streams away from the reader position.
+		* Own the conversation scrollport's bottom-follow while `active` is true.
+		*
+		* @param rootRef - An element inside the conversation scrollport.
+		* @param active - True while the reply is still revealing.
+		* @param speedCpsRef - Live reveal-rate EMA from the smoother.
+		* @param revealScaleRef - Optional backpressure control for text reveal.
+		* @param predictive - Whether to reserve paint room ahead of growth.
+		* @param entrance - Whether the first committed row height should glide in.
+		* @param onEntranceSettled - Releases a one-shot entrance owner after catch-up.
+		* @param predictiveRef - Optional live visibility gate for predictive runway.
+		* @param entranceExtentRef - Optional measured growth delta for a generic row.
+		* @param revealedCharsRef - Committed code-point count for feed-forward phase.
 		*/
-		const followScrollLedgers = /* @__PURE__ */ new WeakMap();
-		const followActivityAt = /* @__PURE__ */ new WeakMap();
-		/** Whether this port was owned recently enough to identify a closing tail row. */
-		function hasRecentConversationFollow(port, windowMs = 250) {
-			const last = followActivityAt.get(port);
-			return last !== void 0 && performance.now() - last <= windowMs;
-		}
-		function readerScrolledUp(port) {
-			return port.scrollTop < (followScrollLedgers.get(port) ?? 0) - 8;
+		function useConversationFollow(rootRef, active, speedCpsRef, revealScaleRef, predictive = true, entrance = false, onEntranceSettled, predictiveRef, entranceExtentRef, revealedCharsRef) {
+			const activeRef = (0, react.useRef)(active);
+			const entranceRef = (0, react.useRef)(entrance);
+			const onEntranceSettledRef = (0, react.useRef)(onEntranceSettled);
+			entranceRef.current = entrance;
+			onEntranceSettledRef.current = onEntranceSettled;
+			activeRef.current = active;
+			(0, react.useLayoutEffect)(() => {
+				if (!active) return;
+				const startedAsEntrance = entrance;
+				const owner = {};
+				const generation = ++followGeneration;
+				let rafId = 0;
+				let last = performance.now();
+				let following = true;
+				let primed = false;
+				let animatedH = 0;
+				let reservePx = 0;
+				let velocityPxPerSec = 0;
+				let interacting = false;
+				let readerGestureIntent = false;
+				let readerReleased = false;
+				let touchStartY = null;
+				let interactTimer = null;
+				let port = null;
+				let resize = null;
+				let observedTail = null;
+				let statusWasPresent = null;
+				let trajectoryPositionPx = null;
+				let trajectoryVelocityPxPerMs = 0;
+				let trajectoryTargetVelocityPxPerMs = 0;
+				let trajectoryFloorPx = null;
+				let trajectoryGrowthAtMs = null;
+				let trajectoryAccumulatedGrowthPx = 0;
+				let trajectoryAccumulatedGrowthMs = 0;
+				let trajectoryGrowthSamples = 0;
+				let trajectoryWasActive = false;
+				const revealPhase = new FollowRevealPhaseTracker();
+				let holding = null;
+				let entrancePending = entranceRef.current;
+				const finishEntrance = () => {
+					if (!entrancePending) return;
+					entrancePending = false;
+					onEntranceSettledRef.current?.();
+				};
+				const updateRevealScale = (next, elapsedMs, urgent = false) => {
+					if (revealScaleRef === void 0) return;
+					const tuning = debugRuntime.activeTuning();
+					const state = followMotionStates.get(next);
+					const target = state === void 0 ? 1 : computeFollowRevealScale(state.lagPx, state.capacityPx, state.constrained, tuning);
+					const current = Math.min(1, Math.max(tuning.backpressureMinScale, revealScaleRef.current));
+					if (target < current || urgent) {
+						revealScaleRef.current = Math.min(current, target);
+						return;
+					}
+					const releaseStep = 1 - Math.exp(-Math.max(0, elapsedMs) / 240);
+					revealScaleRef.current = current + (target - current) * releaseStep;
+				};
+				const releaseRevealScale = () => {
+					if (revealScaleRef !== void 0) revealScaleRef.current = 1;
+				};
+				const reportFollow = (next, isActive) => {
+					const state = followMotionStates.get(next);
+					debugRuntime.reportFollow(next, {
+						lagPx: state ? state.lagPx : -1,
+						velocityPxPerSec: state?.velocityPxPerSec ?? 0,
+						reservePx: state?.reservePx ?? 0,
+						capacityPx: state ? state.capacityPx : -1,
+						revealScale: revealScaleRef?.current ?? 1,
+						following,
+						constrained: state?.constrained ?? false,
+						scrollTop: next.scrollTop,
+						scrollHeight: next.scrollHeight,
+						clientHeight: next.clientHeight,
+						active: isActive
+					});
+				};
+				const isLeader = (next) => followLeaders.get(next)?.owner === owner;
+				const hold = (next) => {
+					followActivityAt.set(next, performance.now());
+					if (holding === next && isLeader(next)) return;
+					holding = next;
+					const leader = followLeaders.get(next);
+					if (leader === void 0 || generation > leader.generation) followLeaders.set(next, {
+						generation,
+						owner
+					});
+				};
+				const drop = (next) => {
+					if (holding === next) holding = null;
+					if (isLeader(next)) {
+						clearMotion(next);
+						followMotionStates.delete(next);
+						releaseRevealScale();
+						debugRuntime.reportFollow(next, null);
+					}
+				};
+				const handBackVisual = (next) => {
+					const shift = currentShiftOf(shiftSurfacesOf(next).at(-1) ?? next);
+					const transferableShift = shift > .25 ? shift : 0;
+					const visualTop = Math.max(0, next.scrollTop - transferableShift);
+					clearMotion(next);
+					restoreRunway(next);
+					const floor = Math.max(0, next.scrollHeight - next.clientHeight);
+					next.scrollTop = Math.min(visualTop, Math.max(0, floor - 26));
+					followScrollLedgers.set(next, next.scrollTop);
+				};
+				const markGesture = (event) => {
+					interacting = true;
+					if (event.type === "wheel") {
+						const deltaY = event.deltaY;
+						if (Number.isFinite(deltaY) && deltaY < 0) readerGestureIntent = true;
+					} else if (event.type === "touchstart") touchStartY = event.touches[0]?.clientY ?? null;
+					else if (event.type === "touchmove") {
+						const touch = event.touches[0];
+						if (touch !== void 0) {
+							if (touchStartY === null) touchStartY = touch.clientY;
+							if (touch.clientY - touchStartY > 1) readerGestureIntent = true;
+						}
+					} else if (event.type === "touchend" || event.type === "touchcancel") touchStartY = null;
+					if (interactTimer !== null) clearTimeout(interactTimer);
+					interactTimer = setTimeout(() => {
+						interacting = false;
+						readerGestureIntent = false;
+						interactTimer = null;
+					}, 800);
+				};
+				const restoreBeforePaint = () => {
+					if (!following || port === null || !isLeader(port)) return;
+					const tuning = debugRuntime.activeTuning();
+					const predictGrowth = predictiveRef?.current ?? predictive;
+					const floor = Math.max(0, port.scrollHeight - port.clientHeight);
+					if (followFloorHistory.get(port) !== floor) invalidatePaintLimit(port);
+					const isReasoningSurface = rootRef.current?.querySelector("[data-variant=\"think\"]") !== null;
+					const trajectoryShift = predictive && !isReasoningSurface && runwayOffsetOf(port) > 0 && trajectoryPositionPx !== null ? floor - trajectoryPositionPx : void 0;
+					animatedH = applyVisual(port, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx, Number.POSITIVE_INFINITY, !predictGrowth, trajectoryShift);
+					if (trajectoryShift !== void 0) trajectoryPositionPx = floor - currentShiftOf(shiftSurfacesOf(port).at(-1) ?? port);
+					updateRevealScale(port, 0, true);
+					reportFollow(port, activeRef.current);
+				};
+				let unsubscribeCommit = null;
+				const bindPort = (next) => {
+					if (port === next) return;
+					if (port !== null) {
+						for (const name of GESTURE_EVENTS) port.removeEventListener(name, markGesture);
+						resize?.disconnect();
+					}
+					unsubscribeCommit?.();
+					port = next;
+					invalidatePaintLimit(port);
+					unsubscribeCommit = subscribeFollowCommit(port, () => {
+						restoreBeforePaint();
+					});
+					for (const name of GESTURE_EVENTS) port.addEventListener(name, markGesture, { passive: true });
+					if (typeof ResizeObserver !== "undefined") {
+						resize = new ResizeObserver(restoreBeforePaint);
+						resize.observe(port);
+						const proxy = resizeProxyOf(port);
+						if (proxy !== null) resize.observe(proxy);
+					}
+				};
+				/**
+				* Keep the observer on the flow's TAIL surface. A flow locked to the
+				* viewport by min-height does not resize when content grows inside it —
+				* only the last message row does, and missing that resize means missing
+				* the pre-paint correction for that frame's wrap.
+				*/
+				const observeTailSurface = () => {
+					if (resize === null || port === null) return;
+					const tail = shiftSurfacesOf(port).at(-1) ?? null;
+					if (tail === observedTail) return;
+					if (observedTail !== null) resize.unobserve(observedTail);
+					observedTail = tail;
+					if (tail !== null) resize.observe(tail);
+				};
+				const frame = (now) => {
+					rafId = requestAnimationFrame(frame);
+					const elapsedMs = Math.max(.001, now - last);
+					const dt = Math.min(32, elapsedMs);
+					const tuning = debugRuntime.activeTuning();
+					last = now;
+					const root = rootRef.current;
+					if (root === null) return;
+					const nextPort = root.closest("[data-conversation-scroll]");
+					if (nextPort === null) return;
+					bindPort(nextPort);
+					observeTailSurface();
+					if (nextPort.clientHeight <= 0) return;
+					const reportedLag = Math.max(0, nextPort.scrollHeight - nextPort.clientHeight) - nextPort.scrollTop;
+					const extent = Math.min(nextPort.scrollHeight, Math.max(0, nextPort.scrollHeight - reportedLag));
+					if (!primed) {
+						const inherited = nextPort.hasAttribute(FOLLOW_OWNED_ATTR) ? followMotionStates.get(nextPort) : void 0;
+						if (inherited === void 0) {
+							const entranceExtent = entrancePending ? entranceExtentRef?.current ?? entranceExtentOf(root) : 0;
+							const predictGrowth = predictiveRef?.current ?? predictive;
+							animatedH = entrancePending ? Math.max(0, nextPort.scrollHeight - entranceExtent) : nextPort.scrollHeight;
+							const hasStatus = turnStatusOf(nextPort) !== null;
+							reservePx = predictGrowth && (hasStatus || speedCpsRef.current > 90) ? computeFollowReserve(speedCpsRef.current, tuning.runwayPx) : 0;
+							statusWasPresent = hasStatus;
+							velocityPxPerSec = 0;
+							following = !readerScrolledUp(nextPort) && !followReaderHolds.has(nextPort);
+						} else {
+							animatedH = Math.min(nextPort.scrollHeight, inherited.extent);
+							reservePx = inherited.reservePx;
+							velocityPxPerSec = inherited.velocityPxPerSec;
+							following = true;
+						}
+						if (following) {
+							hold(nextPort);
+							if (isLeader(nextPort)) {
+								animatedH = applyVisual(nextPort, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx, Number.POSITIVE_INFINITY, !(predictiveRef?.current ?? predictive));
+								if (predictive && root.querySelector("[data-variant=\"think\"]") === null && runwayOffsetOf(nextPort) > 0) {
+									const floor = Math.max(0, nextPort.scrollHeight - nextPort.clientHeight);
+									const requestedMinLagPx = Math.max(20, runwayOffsetOf(nextPort) - 32);
+									const paintMaxLagPx = Math.max(0, safeShiftLimit(nextPort, shiftSurfacesOf(nextPort)) - 1);
+									const minLagPx = Math.min(requestedMinLagPx, paintMaxLagPx);
+									const currentShift = currentShiftOf(shiftSurfacesOf(nextPort).at(-1) ?? nextPort);
+									trajectoryPositionPx = floor - Math.min(paintMaxLagPx, Math.max(minLagPx, currentShift));
+									trajectoryTargetVelocityPxPerMs = Math.max(0, speedCpsRef.current) * .4 / 1e3;
+									trajectoryVelocityPxPerMs = trajectoryTargetVelocityPxPerMs;
+									trajectoryFloorPx = floor;
+									trajectoryGrowthAtMs = now;
+									trajectoryAccumulatedGrowthPx = 0;
+									trajectoryAccumulatedGrowthMs = 0;
+									trajectoryGrowthSamples = 0;
+									trajectoryWasActive = true;
+								}
+								updateRevealScale(nextPort, elapsedMs);
+								reportFollow(nextPort, activeRef.current);
+								const runwayOffset = runwayOffsetOf(nextPort);
+								if (Math.max(0, nextPort.scrollHeight - animatedH - runwayOffset) <= .25) finishEntrance();
+							} else finishEntrance();
+						} else finishEntrance();
+						primed = true;
+						return;
+					}
+					if (!following && (!interacting || readerReleased && !readerGestureIntent && reportedLag <= 1) && reportedLag <= (readerReleased ? 1 : 25)) {
+						following = true;
+						readerReleased = false;
+						followReaderHolds.delete(nextPort);
+						animatedH = extent;
+						reservePx = 0;
+						velocityPxPerSec = 0;
+						followScrollLedgers.set(nextPort, nextPort.scrollTop);
+						hold(nextPort);
+					} else if (following && interacting && (readerGestureIntent || readerScrolledUp(nextPort))) {
+						following = false;
+						readerGestureIntent = false;
+						readerReleased = true;
+						followReaderHolds.set(nextPort, { atMs: performance.now() });
+						handBackVisual(nextPort);
+						animatedH = nextPort.scrollHeight;
+						reservePx = 0;
+						velocityPxPerSec = 0;
+						drop(nextPort);
+						finishEntrance();
+					}
+					if (!activeRef.current || !following) {
+						followScrollLedgers.set(nextPort, nextPort.scrollTop);
+						reportFollow(nextPort, activeRef.current);
+						return;
+					}
+					hold(nextPort);
+					if (!isLeader(nextPort)) {
+						finishEntrance();
+						return;
+					}
+					const predictGrowth = predictiveRef?.current ?? predictive;
+					const hasStatus = turnStatusOf(nextPort) !== null;
+					const statusJustRemoved = predictGrowth && statusWasPresent === true && !hasStatus;
+					if (statusJustRemoved) reservePx = tuning.runwayPx;
+					statusWasPresent = hasStatus;
+					const reserveEnabled = hasStatus || statusJustRemoved || reservePx > .25 || speedCpsRef.current > 90;
+					const pressureReserveTarget = predictGrowth && reserveEnabled ? computeFollowReserve(speedCpsRef.current, tuning.runwayPx) : 0;
+					const heldReserveTarget = tuning.runwayPx < reservePx ? tuning.runwayPx : Math.max(reservePx, pressureReserveTarget);
+					const effectiveReserveTarget = !predictGrowth ? 0 : statusJustRemoved ? tuning.runwayPx : heldReserveTarget;
+					const reserveStep = 1 - Math.exp(-elapsedMs / tuning.reserveResponseMs);
+					reservePx += (effectiveReserveTarget - reservePx) * reserveStep;
+					if (predictGrowth || runwayOffsetOf(nextPort) > .5) ensureRunway(nextPort, shiftSurfacesOf(nextPort), reservePx);
+					const runwayOffset = runwayOffsetOf(nextPort);
+					const contentHeight = nextPort.scrollHeight;
+					const floorNow = Math.max(0, contentHeight - nextPort.clientHeight);
+					const trajectoryActive = predictive && root.querySelector("[data-variant=\"think\"]") === null && runwayOffset > 0;
+					let trajectoryShift;
+					if (trajectoryActive) {
+						const requestedMinLagPx = Math.max(20, runwayOffset - 32);
+						const paintLimit = safeShiftLimit(nextPort, shiftSurfacesOf(nextPort));
+						const maxLagPx = Math.max(0, paintLimit - 1);
+						const minLagPx = Math.min(requestedMinLagPx, maxLagPx);
+						if (trajectoryPositionPx === null || trajectoryFloorPx === null) {
+							const currentShift = currentShiftOf(shiftSurfacesOf(nextPort).at(-1) ?? nextPort);
+							trajectoryPositionPx = floorNow - Math.min(maxLagPx, Math.max(minLagPx, currentShift));
+							trajectoryTargetVelocityPxPerMs = Math.max(0, speedCpsRef.current) * .4 / 1e3;
+							trajectoryVelocityPxPerMs = trajectoryTargetVelocityPxPerMs;
+							trajectoryGrowthAtMs = now;
+						} else if (floorNow > trajectoryFloorPx + .5) {
+							const intervalMs = Math.max(1, now - (trajectoryGrowthAtMs ?? now));
+							if (trajectoryGrowthSamples > 0) {
+								trajectoryAccumulatedGrowthPx += floorNow - trajectoryFloorPx;
+								trajectoryAccumulatedGrowthMs += intervalMs;
+								const measuredVelocity = trajectoryAccumulatedGrowthPx / trajectoryAccumulatedGrowthMs;
+								const targetBlend = 1 - Math.exp(-intervalMs / 240);
+								trajectoryTargetVelocityPxPerMs += (measuredVelocity - trajectoryTargetVelocityPxPerMs) * targetBlend;
+							}
+							trajectoryGrowthSamples += 1;
+							trajectoryGrowthAtMs = now;
+						} else if (floorNow < trajectoryFloorPx - .5) {
+							trajectoryPositionPx = floorNow - minLagPx;
+							trajectoryGrowthAtMs = now;
+							trajectoryAccumulatedGrowthPx = 0;
+							trajectoryAccumulatedGrowthMs = 0;
+							trajectoryGrowthSamples = 0;
+						}
+						trajectoryFloorPx = floorNow;
+						const phaseTarget = revealedCharsRef === void 0 ? floorNow : revealPhase.advance(floorNow, revealedCharsRef.current).targetPx;
+						const trajectoryStep = computeFollowTrajectoryStep(elapsedMs, {
+							positionPx: trajectoryPositionPx,
+							velocityPxPerMs: trajectoryVelocityPxPerMs,
+							targetPx: phaseTarget,
+							targetVelocityPxPerMs: trajectoryTargetVelocityPxPerMs,
+							minLagPx,
+							maxLagPx,
+							paintFloorPx: floorNow
+						});
+						trajectoryPositionPx = trajectoryStep.positionPx;
+						trajectoryVelocityPxPerMs = trajectoryStep.velocityPxPerMs;
+						trajectoryShift = trajectoryStep.shiftPx;
+						trajectoryWasActive = true;
+						const baselineShift = runwayOffset - Math.min(runwayOffset, Math.max(0, reservePx));
+						animatedH = contentHeight - runwayOffset - Math.max(0, trajectoryShift - baselineShift);
+						velocityPxPerSec = trajectoryVelocityPxPerMs * 1e3;
+					} else {
+						if (trajectoryWasActive) {
+							const currentShift = currentShiftOf(shiftSurfacesOf(nextPort).at(-1) ?? nextPort);
+							animatedH = contentHeight - runwayOffset - Math.max(0, currentShift);
+							velocityPxPerSec = trajectoryVelocityPxPerMs * 1e3;
+							trajectoryPositionPx = null;
+							trajectoryWasActive = false;
+						}
+						const lag = Math.max(0, contentHeight - animatedH - runwayOffset);
+						const step = computeFollowStep(dt, {
+							lag,
+							speedEma: speedCpsRef.current,
+							velocityPxPerSec
+						}, tuning);
+						if (lag <= .1) {
+							animatedH = contentHeight - runwayOffset;
+							velocityPxPerSec = 0;
+						} else {
+							const minimumLag = predictGrowth ? 0 : Math.max(0, reservePx);
+							animatedH = Math.min(contentHeight - runwayOffset - minimumLag, animatedH + step.advancePx);
+							velocityPxPerSec = step.velocityPxPerSec;
+						}
+					}
+					animatedH = applyVisual(nextPort, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx, Number.POSITIVE_INFINITY, !predictGrowth, trajectoryShift);
+					if (trajectoryActive) trajectoryPositionPx = floorNow - currentShiftOf(shiftSurfacesOf(nextPort).at(-1) ?? nextPort);
+					updateRevealScale(nextPort, elapsedMs);
+					reportFollow(nextPort, true);
+					if (Math.max(0, nextPort.scrollHeight - animatedH - runwayOffsetOf(nextPort)) <= .25) finishEntrance();
+				};
+				frame(performance.now());
+				return () => {
+					cancelAnimationFrame(rafId);
+					unsubscribeCommit?.();
+					if (interactTimer !== null) clearTimeout(interactTimer);
+					resize?.disconnect();
+					if (port !== null) for (const name of GESTURE_EVENTS) port.removeEventListener(name, markGesture);
+					const host = rootRef.current?.closest("[data-conversation-scroll]") ?? port;
+					if (host === null) return;
+					holding = null;
+					if (!isLeader(host)) return;
+					const preserveReader = interacting && (readerGestureIntent || readerScrolledUp(host));
+					if (!following || !primed) {
+						if (!following && primed) followReaderHolds.set(host, { atMs: performance.now() });
+						clearVisual(host);
+						followLeaders.delete(host);
+						releaseRevealScale();
+						debugRuntime.reportFollow(host, null);
+						return;
+					}
+					if (preserveReader) {
+						handBackVisual(host);
+						followReaderHolds.set(host, { atMs: performance.now() });
+						clearVisual(host);
+						followLeaders.delete(host);
+						releaseRevealScale();
+						debugRuntime.reportFollow(host, null);
+						return;
+					}
+					const lagBeforeCompletionPaint = Math.max(0, host.scrollHeight - animatedH - runwayOffsetOf(host));
+					if (!activeRef.current && lagBeforeCompletionPaint <= 25) {
+						finishAtNaturalFloor(host, !startedAsEntrance);
+						followLeaders.delete(host);
+						releaseRevealScale();
+						debugRuntime.reportFollow(host, null);
+						return;
+					}
+					const completionShift = currentShiftOf(shiftSurfacesOf(host).at(-1) ?? host);
+					const completionShiftCeiling = completionShift > .25 ? completionShift : Number.POSITIVE_INFINITY;
+					const completionTuning = debugRuntime.activeTuning();
+					const previousCompletionRunway = runwayOffsetOf(host);
+					ensureRunway(host, shiftSurfacesOf(host), Math.max(reservePx, completionTuning.runwayPx));
+					const completionRunway = runwayOffsetOf(host);
+					animatedH = Math.max(0, animatedH - (completionRunway - previousCompletionRunway));
+					settleAtFloor(host);
+					animatedH = applyVisual(host, animatedH, reservePx, velocityPxPerSec, completionRunway, completionShiftCeiling);
+					reportFollow(host, false);
+					const runwayOffset = runwayOffsetOf(host);
+					const remainingLag = Math.max(0, host.scrollHeight - animatedH - runwayOffset);
+					if (remainingLag <= .25 || !activeRef.current && remainingLag <= 25) {
+						finishAtNaturalFloor(host, !startedAsEntrance);
+						followLeaders.delete(host);
+						releaseRevealScale();
+						debugRuntime.reportFollow(host, null);
+						return;
+					}
+					for (const name of GESTURE_EVENTS) host.addEventListener(name, markGesture, { passive: true });
+					const stopSettleListeners = () => {
+						for (const name of GESTURE_EVENTS) host.removeEventListener(name, markGesture);
+						if (interactTimer !== null) {
+							clearTimeout(interactTimer);
+							interactTimer = null;
+						}
+					};
+					let settleLast = performance.now();
+					let settleMarginPx = Math.max(runwayOffsetOf(host), reservePx);
+					let settleMarginRate = settleMarginPx / 160;
+					const settleFrame = (now) => {
+						if (!isLeader(host)) {
+							stopSettleListeners();
+							return;
+						}
+						if (interacting && (readerGestureIntent || readerScrolledUp(host))) {
+							readerGestureIntent = false;
+							handBackVisual(host);
+							clearVisual(host);
+							followLeaders.delete(host);
+							releaseRevealScale();
+							debugRuntime.reportFollow(host, null);
+							stopSettleListeners();
+							return;
+						}
+						const dt = Math.min(32, Math.max(0, now - settleLast));
+						const tuning = debugRuntime.activeTuning();
+						settleLast = now;
+						if (settleMarginPx > 0 && settleMarginRate > 0) {
+							settleMarginPx = Math.max(0, settleMarginPx - settleMarginRate * dt);
+							ensureRunway(host, shiftSurfacesOf(host), settleMarginPx);
+							reservePx = Math.min(reservePx, settleMarginPx);
+						}
+						const runwayOffset = runwayOffsetOf(host);
+						const lag = Math.max(0, host.scrollHeight - animatedH - runwayOffset);
+						if (lag <= .25 && settleMarginPx <= .25) {
+							animatedH = host.scrollHeight;
+							reservePx = 0;
+							velocityPxPerSec = 0;
+							followRunways.delete(host);
+							finishAtNaturalFloor(host, !startedAsEntrance);
+							followLeaders.delete(host);
+							releaseRevealScale();
+							debugRuntime.reportFollow(host, null);
+							stopSettleListeners();
+							return;
+						}
+						const step = computeFollowStep(dt, {
+							lag,
+							speedEma: speedCpsRef.current,
+							velocityPxPerSec
+						}, tuning);
+						animatedH = Math.min(host.scrollHeight - runwayOffset, animatedH + step.advancePx);
+						velocityPxPerSec = step.velocityPxPerSec;
+						settleAtFloor(host);
+						animatedH = applyVisual(host, animatedH, reservePx, velocityPxPerSec, Math.max(settleMarginPx, runwayOffset));
+						reportFollow(host, false);
+						requestAnimationFrame(settleFrame);
+					};
+					requestAnimationFrame(settleFrame);
+				};
+			}, [
+				active,
+				rootRef,
+				speedCpsRef,
+				revealScaleRef,
+				predictive,
+				predictiveRef
+			]);
+			(0, react.useLayoutEffect)(() => {
+				const host = rootRef.current?.closest("[data-conversation-scroll]") ?? null;
+				if (host !== null) followFlowFillUsers.set(host, (followFlowFillUsers.get(host) ?? 0) + 1);
+				return () => {
+					if (host === null) return;
+					const remaining = Math.max(0, (followFlowFillUsers.get(host) ?? 1) - 1);
+					if (remaining > 0) {
+						followFlowFillUsers.set(host, remaining);
+						return;
+					}
+					followFlowFillUsers.delete(host);
+					requestAnimationFrame(() => {
+						requestAnimationFrame(() => {
+							if (!followLeaders.has(host) && !followFlowFillUsers.has(host)) restoreFlowFill(host);
+						});
+					});
+				};
+			}, [rootRef]);
 		}
+		//#endregion
+		//#region src/client/useSmoothStreamContent.ts
 		/**
-		* Paint a bounded visual lag and return the effective logical extent.
+		* Stream-smoothing reveal hook.
 		*
-		* This is the final geometry invariant, not merely an animation preference:
-		* any lag beyond the real gap to status/composer chrome is caught up in the
-		* same frame. Carrying that excess in `scrollTop` would move the transcript
-		* toward fixed chrome and also make the host expose jump-to-bottom.
+		* Buffers the model's chunked text and reveals it at a cadence that tracks
+		* the observed arrival rate, so a long reply never dumps whole paragraphs at
+		* once and a fast stream never stutters. Port of lobe-ui's smoother: EMA
+		* arrival cps + chunk size, backlog pressure, commit-interval widening with
+		* tail length, and a flush-speed settle drain once the input idles. The
+		* reveal decision is the pure {@link computeRevealStep} for unit tests.
+		*
+		* `shouldHoldBack` is the performance guard's veto: while it returns true the
+		* loop keeps measuring but skips the DOM commit, so an offscreen reply never
+		* competes with visible frames when the frame rate is degraded.
 		*/
-		function applyVisual(port, animatedH, reservePx, velocityPxPerSec = 0, runwayPx = 48) {
-			const surfaces = shiftSurfacesOf(port);
-			ensureRunway(port, surfaces, runwayPx);
-			const contentHeight = Math.max(0, port.scrollHeight);
-			const runwayOffset = runwayOffsetOf(port);
-			const targetHeight = Math.max(0, contentHeight - runwayOffset);
-			const floor = Math.max(0, contentHeight - port.clientHeight);
-			const extent = Math.min(targetHeight, Math.max(0, animatedH));
-			if (port.style.overflowAnchor !== "none") port.style.overflowAnchor = "none";
-			if (port.style.scrollBehavior !== "auto") port.style.scrollBehavior = "auto";
-			if (floor <= 0) {
-				setFollowScrollTop(port, 0);
-				followMotionStates.set(port, {
-					capacityPx: Number.POSITIVE_INFINITY,
-					constrained: false,
-					extent: targetHeight,
-					lagPx: 0,
-					reservePx: 0,
-					velocityPxPerSec: 0
-				});
-				for (const surface of surfaces) setShift(surface, 0);
-				const status = turnStatusOf(port);
-				if (status !== null) setShift(status, 0);
-				return targetHeight;
+		const PRESET_CONFIG = {
+			balanced: {
+				activeInputWindowMs: 220,
+				defaultCps: 80,
+				emaAlpha: .35,
+				flushCps: 180,
+				largeAppendChars: 120,
+				maxActiveCps: 360,
+				maxCps: 240,
+				maxFlushCps: 480,
+				minCps: 24,
+				settleAfterMs: 280,
+				settleDrainMaxMs: 420,
+				settleDrainMinMs: 120,
+				targetBufferMs: 40
+			},
+			realtime: {
+				activeInputWindowMs: 140,
+				defaultCps: 120,
+				emaAlpha: .45,
+				flushCps: 240,
+				largeAppendChars: 180,
+				maxActiveCps: 480,
+				maxCps: 320,
+				maxFlushCps: 640,
+				minCps: 32,
+				settleAfterMs: 200,
+				settleDrainMaxMs: 280,
+				settleDrainMinMs: 100,
+				targetBufferMs: 24
+			},
+			silky: {
+				activeInputWindowMs: 280,
+				defaultCps: 64,
+				emaAlpha: .28,
+				flushCps: 140,
+				largeAppendChars: 100,
+				maxActiveCps: 280,
+				maxCps: 180,
+				maxFlushCps: 400,
+				minCps: 20,
+				settleAfterMs: 360,
+				settleDrainMaxMs: 520,
+				settleDrainMinMs: 160,
+				targetBufferMs: 56
 			}
-			setFollowScrollTop(port, floor);
-			const limit = floor > 0 ? safeShiftLimit(port, surfaces) : 0;
-			const visibleReserve = Math.min(runwayOffset, Math.max(0, reservePx));
-			const baselineShift = runwayOffset - visibleReserve;
-			const requestedLag = Math.max(0, targetHeight - extent);
-			const shift = Math.min(baselineShift + requestedLag, Math.max(0, limit));
-			const effectiveLag = Math.max(0, shift - baselineShift);
-			const capacityPx = Math.max(0, limit - baselineShift);
-			const effectiveExtent = targetHeight - effectiveLag;
-			followMotionStates.set(port, {
-				capacityPx,
-				constrained: requestedLag > effectiveLag + FOLLOW_SETTLE_EPSILON_PX,
-				extent: effectiveExtent,
-				lagPx: effectiveLag,
-				reservePx: visibleReserve,
-				velocityPxPerSec
-			});
-			for (const surface of surfaces) setShift(surface, shift);
-			const status = turnStatusOf(port);
-			if (status !== null) setShift(status, 0);
-			return effectiveExtent;
-		}
-		function clearMotion(port) {
-			port.removeAttribute(FOLLOW_OWNED_ATTR);
-			port.style.overflowAnchor = "";
-			port.style.scrollBehavior = "";
-			for (const surface of shiftSurfacesOf(port)) setShift(surface, 0);
-			const status = turnStatusOf(port);
-			if (status !== null) setShift(status, 0);
+		};
+		const QUEUE_ACCEL_EXPONENT = 1.25;
+		const CATCHUP_SECONDS = .15;
+		const clamp = (value, min, max) => {
+			return Math.min(max, Math.max(min, value));
+		};
+		/** Float-debt queue integration from `ultimate_stream_physics_scroller.html`. */
+		function computeAdaptiveQueueStep(backlog, dtMs, debt, revealScale = 1, tuning = DEFAULT_STREAM_DEBUG_TUNING) {
+			if (backlog <= 0 || dtMs <= 0) return {
+				revealChars: 0,
+				debt: 0,
+				speedCps: 0
+			};
+			const speedCps = Math.min(tuning.maxRevealCps, 90 + Math.pow(backlog, QUEUE_ACCEL_EXPONENT) * tuning.queuePressure);
+			const effectiveScale = clamp(revealScale * tuning.revealScale, .05, 2);
+			const accumulated = Math.max(0, debt) + speedCps * effectiveScale * (dtMs / 1e3);
+			const revealChars = Math.min(backlog, Math.floor(accumulated));
+			return {
+				revealChars,
+				debt: revealChars >= backlog ? 0 : accumulated - revealChars,
+				speedCps
+			};
 		}
-		function clearVisual(port) {
-			clearMotion(port);
-			restoreRunway(port);
-			followMotionStates.delete(port);
-			invalidatePaintLimit(port);
+		/** Counts user-perceived characters (code points), not UTF-16 units. */
+		const countChars = (text) => {
+			let count = 0;
+			for (const char of text) count += 1;
+			return count;
+		};
+		/** Pure settle-drain decision shared by the frame loop and its tests. */
+		function computeSettleDrain(config, input) {
+			if (input.inputActive || !input.settling) return 0;
+			const overflowCps = Math.max(0, input.backlog - 300) * 1e3 / 2;
+			const drainTargetMs = clamp(input.backlog * 8, config.settleDrainMinMs, config.settleDrainMaxMs);
+			const settleCps = input.backlog * 1e3 / drainTargetMs;
+			return clamp(Math.max(settleCps, overflowCps), config.flushCps, config.maxFlushCps);
 		}
-		/** Keep an already-promoted surface at zero until one stable final paint lands. */
-		function holdCompositorAtRest(element) {
-			element.style.transform = "translate3d(0, 0px, 0)";
-			element.style.willChange = "transform";
-			element.style.clipPath = "";
+		/**
+		* Fixed velocity that closes a producer-complete queue within its deadline.
+		* This completion-only target may exceed the live-stream flush ceiling.
+		*/
+		function computeCompletionDrain(config, backlog, initialCps = 0) {
+			if (backlog <= 0) return 0;
+			const deadlineSeconds = clamp(backlog * 8, config.settleDrainMinMs, config.settleDrainMaxMs) / 1e3;
+			const rampAreaSeconds = SETTLE_RAMP_TAU_S * (1 - Math.exp(-deadlineSeconds / SETTLE_RAMP_TAU_S));
+			const deadlineCps = (backlog - Math.max(0, initialCps) * rampAreaSeconds) / Math.max(.001, deadlineSeconds - rampAreaSeconds);
+			return Math.max(deadlineCps, computeSettleDrain(config, {
+				backlog,
+				inputActive: false,
+				settling: true
+			}));
 		}
-		/** Remove equal offsets, land on the floor, then retire the compositor quietly. */
-		function finishAtNaturalFloor(port) {
-			const surfaces = shiftSurfacesOf(port);
-			const status = turnStatusOf(port);
-			const promoted = [...surfaces, ...status === null ? [] : [status]].filter((element) => element.style.transform !== "" || element.style.willChange === "transform");
-			const promotedSet = new Set(promoted);
-			restoreRunway(port);
-			settleAtFloor(port);
-			port.removeAttribute(FOLLOW_OWNED_ATTR);
-			port.style.overflowAnchor = "";
-			port.style.scrollBehavior = "";
-			for (const surface of surfaces) if (promotedSet.has(surface)) holdCompositorAtRest(surface);
-			else setShift(surface, 0);
-			if (status !== null) {
-				if (promotedSet.has(status)) holdCompositorAtRest(status);
-				else setShift(status, 0);
+		/**
+		* Drain rate multiplier once the input ends: leftover backlog reveals at
+		* this multiple of the steady rate, so the end never drags.
+		*/
+		const SETTLE_DRAIN_MULTIPLIER = 1.8;
+		/** Time constant for ramping the completion-drain velocity up from streaming pace. */
+		const SETTLE_RAMP_TAU_S = .09;
+		/** Pure per-frame reveal decision shared by the loop and its tests. */
+		function computeRevealStep(config, input, dtSeconds) {
+			const trackedCps = Math.max(input.emaCps, input.arrivalCpsEma);
+			const baseCps = clamp(trackedCps, config.minCps, config.maxFlushCps);
+			const targetLagChars = input.inputActive ? Math.max(2, Math.round(baseCps * config.targetBufferMs / 1e3)) : 0;
+			let currentCps;
+			if (input.steadyCps !== void 0) currentCps = input.inputActive || input.settling ? clamp(input.steadyCps * (input.inputActive ? 1 : SETTLE_DRAIN_MULTIPLIER), config.minCps, config.maxFlushCps) : 0;
+			else if (input.inputActive) {
+				const overflow = Math.max(0, input.backlog - 32);
+				const catchup = overflow > 0 ? overflow / CATCHUP_SECONDS : 0;
+				currentCps = clamp(baseCps * 1.08 + catchup, config.minCps, config.maxFlushCps);
+			} else if (input.settling) currentCps = computeSettleDrain(config, input);
+			else {
+				const idleFlushCps = Math.max(config.flushCps, baseCps * 1.8, input.arrivalCpsEma * .8);
+				currentCps = clamp(idleFlushCps, config.flushCps, config.maxFlushCps);
 			}
-			followMotionStates.delete(port);
-			if (promoted.length === 0) return;
-			requestAnimationFrame(() => {
-				requestAnimationFrame(() => {
-					if (port.hasAttribute(FOLLOW_OWNED_ATTR)) return;
-					for (const element of promoted) if (Math.abs(currentShiftOf(element)) <= .01) setShift(element, 0);
-				});
-			});
-		}
-		function settleAtFloor(port) {
-			setFollowScrollTop(port, Math.max(0, port.scrollHeight - port.clientHeight));
+			const minRevealChars = input.inputActive ? 1 : 2;
+			return {
+				revealChars: Math.max(minRevealChars, Math.round(currentCps * dtSeconds)),
+				targetLagChars
+			};
 		}
-		/** Only the newest active follower may write one port's shared visual state. */
-		const followLeaders = /* @__PURE__ */ new WeakMap();
-		let followGeneration = 0;
 		/**
-		* Own the conversation scrollport's bottom-follow while `active` is true.
+		* Smooth a chunked content stream into a reveal-paced display string.
 		*
-		* @param rootRef - An element inside the conversation scrollport.
-		* @param active - True while the reply is still revealing.
-		* @param speedCpsRef - Live reveal-rate EMA from the smoother.
-		* @param revealScaleRef - Optional backpressure control for text reveal.
-		* @param predictive - Whether to reserve paint room ahead of growth.
-		* @param entrance - Whether the first committed row height should glide in.
-		* @param onEntranceSettled - Releases a one-shot entrance owner after catch-up.
-		* @param predictiveRef - Optional live visibility gate for predictive runway.
-		* @param entranceExtentRef - Optional measured growth delta for a generic row.
+		* @param content - The full accumulated input so far.
+		* @param options - Preset, guard, and steady-rate wiring.
+		* @returns The displayed content, revealed at the smoothed cadence.
 		*/
-		function useConversationFollow(rootRef, active, speedCpsRef, revealScaleRef, predictive = true, entrance = false, onEntranceSettled, predictiveRef, entranceExtentRef) {
-			const activeRef = (0, react.useRef)(active);
-			const entranceRef = (0, react.useRef)(entrance);
-			const onEntranceSettledRef = (0, react.useRef)(onEntranceSettled);
-			entranceRef.current = entrance;
-			onEntranceSettledRef.current = onEntranceSettled;
+		function useSmoothStreamContent(content, { enabled = true, inputComplete = false, preset = "balanced", shouldHoldBack, steadyCps, defaultCps, speedCpsRef, revealedCharsRef, revealScaleRef, onRevealCommit } = {}) {
+			const config = PRESET_CONFIG[preset];
+			const seedCps = defaultCps ?? config.defaultCps;
+			const initialContent = enabled ? "" : content;
+			const [displayedContent, setDisplayedContent] = (0, react.useState)(initialContent);
+			const displayedContentRef = (0, react.useRef)(initialContent);
+			const displayedCountRef = (0, react.useRef)(countChars(initialContent));
+			const targetContentRef = (0, react.useRef)(initialContent);
+			const targetCharsRef = (0, react.useRef)([...initialContent]);
+			const targetCountRef = (0, react.useRef)(countChars(initialContent));
+			const emaCpsRef = (0, react.useRef)(seedCps);
+			const lastInputTsRef = (0, react.useRef)(0);
+			const lastInputCountRef = (0, react.useRef)(countChars(initialContent));
+			const chunkSizeEmaRef = (0, react.useRef)(1);
+			const arrivalCpsEmaRef = (0, react.useRef)(seedCps);
+			const rafRef = (0, react.useRef)(null);
+			const lastFrameTsRef = (0, react.useRef)(null);
+			const queueDebtRef = (0, react.useRef)(0);
+			const settleCpsRef = (0, react.useRef)(null);
+			const lastDrainCpsRef = (0, react.useRef)(0);
+			const holdBackRef = (0, react.useRef)(shouldHoldBack);
+			const speedOutRef = (0, react.useRef)(speedCpsRef);
+			speedOutRef.current = speedCpsRef;
+			const revealedCharsOutRef = (0, react.useRef)(revealedCharsRef);
+			revealedCharsOutRef.current = revealedCharsRef;
+			const revealScaleOutRef = (0, react.useRef)(revealScaleRef);
+			revealScaleOutRef.current = revealScaleRef;
+			const onRevealCommitOutRef = (0, react.useRef)(onRevealCommit);
+			onRevealCommitOutRef.current = onRevealCommit;
+			const inputCompleteRef = (0, react.useRef)(inputComplete);
+			inputCompleteRef.current = inputComplete;
+			const streamIdRef = (0, react.useRef)(`stream-${Math.random().toString(36).slice(2)}`);
 			(0, react.useEffect)(() => {
-				activeRef.current = active;
-			}, [active]);
-			(0, react.useLayoutEffect)(() => {
-				if (!active) return;
-				const owner = {};
-				const generation = ++followGeneration;
-				let rafId = 0;
-				let last = performance.now();
-				let following = true;
-				let primed = false;
-				let animatedH = 0;
-				let reservePx = 0;
-				let velocityPxPerSec = 0;
-				let interacting = false;
-				let readerGestureIntent = false;
-				let readerReleased = false;
-				let touchStartY = null;
-				let interactTimer = null;
-				let port = null;
-				let resize = null;
-				let holding = null;
-				let entrancePending = entranceRef.current;
-				const finishEntrance = () => {
-					if (!entrancePending) return;
-					entrancePending = false;
-					onEntranceSettledRef.current?.();
-				};
-				const updateRevealScale = (next, elapsedMs, urgent = false) => {
-					if (revealScaleRef === void 0) return;
-					const tuning = debugRuntime.activeTuning();
-					const state = followMotionStates.get(next);
-					const target = state === void 0 ? 1 : computeFollowRevealScale(state.lagPx, state.capacityPx, state.constrained, tuning);
-					const current = Math.min(1, Math.max(tuning.backpressureMinScale, revealScaleRef.current));
-					if (target < current || urgent) {
-						revealScaleRef.current = Math.min(current, target);
-						return;
-					}
-					const releaseStep = 1 - Math.exp(-Math.max(0, elapsedMs) / 240);
-					revealScaleRef.current = current + (target - current) * releaseStep;
-				};
-				const releaseRevealScale = () => {
-					if (revealScaleRef !== void 0) revealScaleRef.current = 1;
-				};
-				const reportFollow = (next, isActive) => {
-					const state = followMotionStates.get(next);
-					debugRuntime.reportFollow(next, {
-						lagPx: state?.lagPx ?? Math.max(0, next.scrollHeight - next.clientHeight - next.scrollTop),
-						velocityPxPerSec: state?.velocityPxPerSec ?? 0,
-						reservePx: state?.reservePx ?? 0,
-						capacityPx: state?.capacityPx ?? 0,
-						revealScale: revealScaleRef?.current ?? 1,
-						following,
-						constrained: state?.constrained ?? false,
-						scrollTop: next.scrollTop,
-						scrollHeight: next.scrollHeight,
-						clientHeight: next.clientHeight,
-						active: isActive
-					});
-				};
-				const isLeader = (next) => followLeaders.get(next)?.owner === owner;
-				const hold = (next) => {
-					followActivityAt.set(next, performance.now());
-					if (holding === next && isLeader(next)) return;
-					holding = next;
-					const leader = followLeaders.get(next);
-					if (leader === void 0 || generation > leader.generation) followLeaders.set(next, {
-						generation,
-						owner
-					});
-				};
-				const drop = (next) => {
-					if (holding === next) holding = null;
-					if (isLeader(next)) {
-						clearMotion(next);
-						followMotionStates.delete(next);
-						releaseRevealScale();
-						debugRuntime.reportFollow(next, null);
+				holdBackRef.current = shouldHoldBack;
+			}, [shouldHoldBack]);
+			const stopFrameLoop = (0, react.useCallback)(() => {
+				if (rafRef.current !== null) {
+					cancelAnimationFrame(rafRef.current);
+					rafRef.current = null;
+				}
+				lastFrameTsRef.current = null;
+			}, []);
+			const startFrameLoopRef = (0, react.useRef)(() => {});
+			const syncImmediate = (0, react.useCallback)((nextContent) => {
+				stopFrameLoop();
+				const chars = [...nextContent];
+				const now = performance.now();
+				targetContentRef.current = nextContent;
+				targetCharsRef.current = chars;
+				targetCountRef.current = chars.length;
+				displayedContentRef.current = nextContent;
+				displayedCountRef.current = chars.length;
+				queueDebtRef.current = 0;
+				settleCpsRef.current = null;
+				lastDrainCpsRef.current = 0;
+				const speedOut = speedOutRef.current;
+				if (speedOut !== void 0) speedOut.current = seedCps;
+				setDisplayedContent(nextContent);
+				emaCpsRef.current = seedCps;
+				chunkSizeEmaRef.current = 1;
+				arrivalCpsEmaRef.current = seedCps;
+				lastInputTsRef.current = now;
+				lastInputCountRef.current = chars.length;
+			}, [seedCps, stopFrameLoop]);
+			const startFrameLoop = (0, react.useCallback)(() => {
+				if (rafRef.current !== null) return;
+				const tick = (now) => {
+					const targetCount = targetCountRef.current;
+					const displayedCount = displayedCountRef.current;
+					const backlog = targetCount - displayedCount;
+					if (backlog <= 0) {
+						queueDebtRef.current = 0;
+						settleCpsRef.current = null;
+						const speedOut = speedOutRef.current;
+						if (speedOut !== void 0) speedOut.current = seedCps;
+						debugRuntime.reportStream(streamIdRef.current, null);
+						stopFrameLoop();
+						return;
 					}
-				};
-				const handBackVisual = (next) => {
-					const shift = currentShiftOf(shiftSurfacesOf(next).at(-1) ?? next);
-					const visualTop = Math.max(0, next.scrollTop - Math.max(0, shift));
-					clearMotion(next);
-					restoreRunway(next);
-					const floor = Math.max(0, next.scrollHeight - next.clientHeight);
-					next.scrollTop = Math.min(visualTop, Math.max(0, floor - 26));
-					followScrollLedgers.set(next, next.scrollTop);
-				};
-				const markGesture = (event) => {
-					interacting = true;
-					if (event.type === "wheel") {
-						const deltaY = event.deltaY;
-						if (Number.isFinite(deltaY) && deltaY < 0) readerGestureIntent = true;
-					} else if (event.type === "touchstart") touchStartY = event.touches[0]?.clientY ?? null;
-					else if (event.type === "touchmove") {
-						const touch = event.touches[0];
-						if (touch !== void 0) {
-							if (touchStartY === null) touchStartY = touch.clientY;
-							if (touch.clientY - touchStartY > 1) readerGestureIntent = true;
-						}
-					} else if (event.type === "touchend" || event.type === "touchcancel") touchStartY = null;
-					if (interactTimer !== null) clearTimeout(interactTimer);
-					interactTimer = setTimeout(() => {
-						interacting = false;
-						readerGestureIntent = false;
-						interactTimer = null;
-					}, 800);
-				};
-				const restoreBeforePaint = () => {
-					if (!following || port === null || !isLeader(port)) return;
-					invalidatePaintLimit(port);
-					const tuning = debugRuntime.activeTuning();
-					animatedH = applyVisual(port, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx);
-					updateRevealScale(port, 0, true);
-					reportFollow(port, activeRef.current);
-				};
-				const bindPort = (next) => {
-					if (port === next) return;
-					if (port !== null) {
-						for (const name of GESTURE_EVENTS) port.removeEventListener(name, markGesture);
-						resize?.disconnect();
+					if (lastFrameTsRef.current === null) {
+						lastFrameTsRef.current = now;
+						rafRef.current = requestAnimationFrame(tick);
+						return;
 					}
-					port = next;
-					invalidatePaintLimit(port);
-					for (const name of GESTURE_EVENTS) port.addEventListener(name, markGesture, { passive: true });
-					if (typeof ResizeObserver !== "undefined") {
-						resize = new ResizeObserver(restoreBeforePaint);
-						resize.observe(port);
-						const proxy = resizeProxyOf(port);
-						if (proxy !== null) resize.observe(proxy);
+					const frameIntervalMs = Math.max(0, now - lastFrameTsRef.current);
+					const dtSeconds = Math.max(.001, Math.min(frameIntervalMs / 1e3, .12));
+					lastFrameTsRef.current = now;
+					const idleMs = now - lastInputTsRef.current;
+					const producerComplete = inputCompleteRef.current;
+					const debugTuning = debugRuntime.activeTuning();
+					const inputActive = !producerComplete && idleMs <= config.activeInputWindowMs;
+					const settling = producerComplete || !inputActive && idleMs >= config.settleAfterMs;
+					if (!producerComplete) settleCpsRef.current = null;
+					let revealChars;
+					let revealSpeedCps;
+					let nextQueueDebt = 0;
+					if (producerComplete) {
+						const previousCps = lastDrainCpsRef.current > 0 ? lastDrainCpsRef.current : Math.max(config.minCps, emaCpsRef.current);
+						const drainTargetCps = settleCpsRef.current ?? computeCompletionDrain(config, backlog, previousCps);
+						settleCpsRef.current = drainTargetCps;
+						const rampedCps = previousCps + (drainTargetCps - previousCps) * (1 - Math.exp(-dtSeconds / SETTLE_RAMP_TAU_S));
+						const settleCps = Math.min(drainTargetCps, Math.max(previousCps, rampedCps));
+						lastDrainCpsRef.current = Math.min(drainTargetCps, rampedCps);
+						const accumulated = Math.max(0, queueDebtRef.current) + settleCps * dtSeconds;
+						revealChars = Math.min(backlog, Math.floor(accumulated));
+						revealSpeedCps = settleCps;
+						nextQueueDebt = revealChars >= backlog ? 0 : accumulated - revealChars;
+						if (revealChars >= backlog) lastDrainCpsRef.current = 0;
+					} else if (steadyCps !== void 0) {
+						const step = computeRevealStep(config, {
+							backlog,
+							chunkSizeEma: chunkSizeEmaRef.current,
+							arrivalCpsEma: arrivalCpsEmaRef.current,
+							emaCps: emaCpsRef.current,
+							inputActive,
+							settling,
+							steadyCps
+						}, dtSeconds);
+						revealChars = Math.min(Math.round(step.revealChars * debugTuning.revealScale), backlog);
+						revealSpeedCps = frameIntervalMs > 0 ? revealChars * 1e3 / frameIntervalMs : 0;
+					} else {
+						const step = computeAdaptiveQueueStep(backlog, frameIntervalMs, queueDebtRef.current, revealScaleOutRef.current?.current ?? 1, debugTuning);
+						revealChars = step.revealChars;
+						revealSpeedCps = step.speedCps;
+						nextQueueDebt = step.debt;
 					}
-				};
-				const frame = (now) => {
-					rafId = requestAnimationFrame(frame);
-					const elapsedMs = Math.max(.001, now - last);
-					const dt = Math.min(32, elapsedMs);
-					const tuning = debugRuntime.activeTuning();
-					last = now;
-					const root = rootRef.current;
-					if (root === null) return;
-					const nextPort = root.closest("[data-conversation-scroll]");
-					if (nextPort === null) return;
-					bindPort(nextPort);
-					if (nextPort.clientHeight <= 0) return;
-					const reportedLag = Math.max(0, nextPort.scrollHeight - nextPort.clientHeight) - nextPort.scrollTop;
-					const extent = Math.min(nextPort.scrollHeight, Math.max(0, nextPort.scrollHeight - reportedLag));
-					if (!primed) {
-						const inherited = nextPort.hasAttribute(FOLLOW_OWNED_ATTR) ? followMotionStates.get(nextPort) : void 0;
-						if (inherited === void 0) {
-							const entranceExtent = entrancePending ? entranceExtentRef?.current ?? entranceExtentOf(root) : 0;
-							animatedH = Math.max(0, nextPort.scrollHeight - entranceExtent);
-							reservePx = 0;
-							velocityPxPerSec = 0;
-							following = Math.max(0, reportedLag - entranceExtent) <= 25;
-						} else {
-							animatedH = Math.min(nextPort.scrollHeight, inherited.extent);
-							reservePx = inherited.reservePx;
-							velocityPxPerSec = inherited.velocityPxPerSec;
-							following = true;
-						}
-						if (following) {
-							hold(nextPort);
-							if (isLeader(nextPort)) {
-								animatedH = applyVisual(nextPort, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx);
-								updateRevealScale(nextPort, elapsedMs);
-								reportFollow(nextPort, activeRef.current);
-								const runwayOffset = runwayOffsetOf(nextPort);
-								if (Math.max(0, nextPort.scrollHeight - animatedH - runwayOffset) <= .25) finishEntrance();
-							} else finishEntrance();
-						} else finishEntrance();
-						primed = true;
+					debugRuntime.reportStream(streamIdRef.current, {
+						backlog,
+						speedCps: revealSpeedCps,
+						targetChars: targetCount,
+						displayedChars: displayedCount,
+						active: !producerComplete
+					});
+					if (holdBackRef.current?.() === true) {
+						rafRef.current = requestAnimationFrame(tick);
 						return;
 					}
-					if (!following && (!interacting || readerReleased && !readerGestureIntent && reportedLag <= 1) && reportedLag <= (readerReleased ? 1 : 25)) {
-						following = true;
-						readerReleased = false;
-						animatedH = extent;
-						reservePx = 0;
-						velocityPxPerSec = 0;
-						followScrollLedgers.set(nextPort, nextPort.scrollTop);
-						hold(nextPort);
-					} else if (following && interacting && (readerGestureIntent || readerScrolledUp(nextPort))) {
-						following = false;
-						readerGestureIntent = false;
-						readerReleased = true;
-						handBackVisual(nextPort);
-						animatedH = nextPort.scrollHeight;
-						reservePx = 0;
-						velocityPxPerSec = 0;
-						drop(nextPort);
-						finishEntrance();
+					queueDebtRef.current = nextQueueDebt;
+					const speedOut = speedOutRef.current;
+					if (speedOut !== void 0) speedOut.current = revealSpeedCps;
+					if (revealChars <= 0) {
+						rafRef.current = requestAnimationFrame(tick);
+						return;
 					}
-					if (!activeRef.current || !following) {
-						followScrollLedgers.set(nextPort, nextPort.scrollTop);
-						reportFollow(nextPort, activeRef.current);
+					const nextCount = displayedCount + revealChars;
+					const segment = targetCharsRef.current.slice(displayedCount, nextCount).join("");
+					if (segment) {
+						const nextDisplayed = displayedContentRef.current + segment;
+						displayedContentRef.current = nextDisplayed;
+						displayedCountRef.current = nextCount;
+						setDisplayedContent(nextDisplayed);
+					} else {
+						displayedContentRef.current = targetContentRef.current;
+						displayedCountRef.current = targetCount;
+						setDisplayedContent(targetContentRef.current);
+					}
+					rafRef.current = requestAnimationFrame(tick);
+				};
+				rafRef.current = requestAnimationFrame(tick);
+			}, [
+				config,
+				seedCps,
+				stopFrameLoop,
+				steadyCps
+			]);
+			(0, react.useLayoutEffect)(() => {
+				const revealedCharsOut = revealedCharsOutRef.current;
+				if (revealedCharsOut !== void 0) revealedCharsOut.current = displayedCountRef.current;
+				if (displayedContent === "") return;
+				onRevealCommitOutRef.current?.();
+			}, [displayedContent]);
+			(0, react.useEffect)(() => {
+				startFrameLoopRef.current = startFrameLoop;
+			}, [startFrameLoop]);
+			(0, react.useEffect)(() => {
+				if (!enabled) {
+					syncImmediate(content);
+					return;
+				}
+				const prevTargetContent = targetContentRef.current;
+				if (content === prevTargetContent) return;
+				const now = performance.now();
+				if (!content.startsWith(prevTargetContent)) {
+					syncImmediate(content);
+					return;
+				}
+				const appendedChars = [...content.slice(prevTargetContent.length)];
+				const appendedCount = appendedChars.length;
+				targetContentRef.current = content;
+				targetCharsRef.current.push(...appendedChars);
+				targetCountRef.current += appendedCount;
+				settleCpsRef.current = null;
+				const hadSample = lastInputTsRef.current > 0;
+				const deltaChars = targetCountRef.current - lastInputCountRef.current;
+				const deltaMs = Math.max(1, now - lastInputTsRef.current);
+				if (hadSample && deltaChars > 0) {
+					const instantCps = deltaChars * 1e3 / deltaMs;
+					const normalizedInstantCps = clamp(instantCps, config.minCps, config.maxFlushCps * 3);
+					const chunkEmaAlpha = .45;
+					chunkSizeEmaRef.current = chunkSizeEmaRef.current * .55 + appendedCount * chunkEmaAlpha;
+					arrivalCpsEmaRef.current = arrivalCpsEmaRef.current * .55 + normalizedInstantCps * chunkEmaAlpha;
+					emaCpsRef.current = emaCpsRef.current * (1 - config.emaAlpha) + normalizedInstantCps * config.emaAlpha;
+				}
+				lastInputTsRef.current = now;
+				lastInputCountRef.current = targetCountRef.current;
+				startFrameLoop();
+			}, [
+				content,
+				enabled,
+				config,
+				startFrameLoop,
+				syncImmediate
+			]);
+			(0, react.useEffect)(() => {
+				return () => {
+					stopFrameLoop();
+					debugRuntime.reportStream(streamIdRef.current, null);
+				};
+			}, [stopFrameLoop]);
+			return displayedContent;
+		}
+		//#endregion
+		//#region src/client/useFpsGuard.ts
+		/**
+		* Performance guard for the streaming reveal.
+		*
+		* Feeds an EMA-smoothed frame-rate monitor from a rAF loop while streaming
+		* and tracks whether the reply is on-screen. The returned `shouldHoldBack`
+		* predicate is true only while the frame rate is below the threshold AND the
+		* reply is offscreen — exactly the spec's "skip offscreen DOM updates when
+		* FPS < 30" rule. The smoother consumes the predicate as its commit veto.
+		*/
+		const FPS_THRESHOLD = 30;
+		const FPS_ALPHA = .12;
+		const RECOVER_FRAMES = 6;
+		const MAX_FRAME_MS = 100;
+		function useFpsGuard(active) {
+			const fpsRef = (0, react.useRef)({
+				emaMs: 0,
+				lastMs: 0,
+				healthyRun: 0,
+				degraded: false
+			});
+			const visibleRef = (0, react.useRef)(true);
+			const elementRef = (0, react.useRef)(null);
+			(0, react.useEffect)(() => {
+				if (!active) return;
+				let rafId = 0;
+				let lastDebugReport = 0;
+				const frame = (now) => {
+					rafId = requestAnimationFrame(frame);
+					const fps = fpsRef.current;
+					if (fps.lastMs === 0) {
+						fps.lastMs = now;
 						return;
 					}
-					hold(nextPort);
-					if (!isLeader(nextPort)) {
-						finishEntrance();
-						return;
+					const delta = Math.min(MAX_FRAME_MS, Math.max(1, now - fps.lastMs));
+					fps.lastMs = now;
+					fps.emaMs = fps.emaMs === 0 ? delta : fps.emaMs + FPS_ALPHA * (delta - fps.emaMs);
+					const currentFps = 1e3 / fps.emaMs;
+					if (currentFps < FPS_THRESHOLD) {
+						fps.healthyRun = 0;
+						fps.degraded = true;
+					} else if (fps.degraded) {
+						fps.healthyRun += 1;
+						if (fps.healthyRun >= RECOVER_FRAMES) fps.degraded = false;
 					}
-					const runwayOffset = runwayOffsetOf(nextPort);
-					const contentHeight = nextPort.scrollHeight;
-					const lag = Math.max(0, contentHeight - animatedH - runwayOffset);
-					const predictGrowth = predictiveRef?.current ?? predictive;
-					const reserveTarget = !predictGrowth ? 0 : computeFollowReserve(speedCpsRef.current, tuning.runwayPx);
-					const reserveStep = 1 - Math.exp(-elapsedMs / tuning.reserveResponseMs);
-					reservePx += (reserveTarget - reservePx) * reserveStep;
-					const step = computeFollowStep(dt, {
-						lag,
-						speedEma: speedCpsRef.current,
-						velocityPxPerSec
-					}, tuning);
-					if (lag <= .1) {
-						animatedH = contentHeight - runwayOffset;
-						velocityPxPerSec = 0;
-					} else {
-						const minimumLag = predictGrowth ? 0 : Math.max(0, reservePx);
-						animatedH = Math.min(contentHeight - runwayOffset - minimumLag, animatedH + step.advancePx);
-						velocityPxPerSec = step.velocityPxPerSec;
+					if (now - lastDebugReport >= 100) {
+						debugRuntime.reportFps(currentFps, fps.emaMs, fps.degraded);
+						lastDebugReport = now;
 					}
-					animatedH = applyVisual(nextPort, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx);
-					updateRevealScale(nextPort, elapsedMs);
-					reportFollow(nextPort, true);
-					if (Math.max(0, nextPort.scrollHeight - animatedH - runwayOffsetOf(nextPort)) <= .25) finishEntrance();
 				};
-				frame(performance.now());
+				rafId = requestAnimationFrame(frame);
 				return () => {
 					cancelAnimationFrame(rafId);
-					if (interactTimer !== null) clearTimeout(interactTimer);
-					resize?.disconnect();
-					if (port !== null) for (const name of GESTURE_EVENTS) port.removeEventListener(name, markGesture);
-					const host = rootRef.current?.closest("[data-conversation-scroll]") ?? port;
-					if (host === null) return;
-					holding = null;
-					if (!isLeader(host)) return;
-					const preserveReader = interacting && (readerGestureIntent || readerScrolledUp(host));
-					if (!following || !primed) {
-						clearVisual(host);
-						followLeaders.delete(host);
-						releaseRevealScale();
-						debugRuntime.reportFollow(host, null);
-						return;
-					}
-					if (preserveReader) {
-						handBackVisual(host);
-						clearVisual(host);
-						followLeaders.delete(host);
-						releaseRevealScale();
-						debugRuntime.reportFollow(host, null);
-						return;
-					}
-					const completionTuning = debugRuntime.activeTuning();
-					ensureRunway(host, shiftSurfacesOf(host), completionTuning.runwayPx);
-					const completionRunway = runwayOffsetOf(host);
-					const completionMinimumLag = Math.max(0, reservePx);
-					animatedH = Math.min(animatedH, host.scrollHeight - completionRunway - completionMinimumLag);
-					settleAtFloor(host);
-					animatedH = applyVisual(host, animatedH, reservePx, velocityPxPerSec, completionTuning.runwayPx);
-					reportFollow(host, false);
-					const runwayOffset = runwayOffsetOf(host);
-					if (Math.max(0, host.scrollHeight - animatedH - runwayOffset) <= .25 && reservePx <= .25) {
-						finishAtNaturalFloor(host);
-						followLeaders.delete(host);
-						releaseRevealScale();
-						debugRuntime.reportFollow(host, null);
-						return;
-					}
-					for (const name of GESTURE_EVENTS) host.addEventListener(name, markGesture, { passive: true });
-					const stopSettleListeners = () => {
-						for (const name of GESTURE_EVENTS) host.removeEventListener(name, markGesture);
-						if (interactTimer !== null) {
-							clearTimeout(interactTimer);
-							interactTimer = null;
-						}
-					};
-					let settleLast = performance.now();
-					const settleFrame = (now) => {
-						if (!isLeader(host)) {
-							stopSettleListeners();
-							return;
-						}
-						if (interacting && (readerGestureIntent || readerScrolledUp(host))) {
-							readerGestureIntent = false;
-							handBackVisual(host);
-							clearVisual(host);
-							followLeaders.delete(host);
-							releaseRevealScale();
-							debugRuntime.reportFollow(host, null);
-							stopSettleListeners();
-							return;
-						}
-						const dt = Math.min(32, Math.max(0, now - settleLast));
-						const tuning = debugRuntime.activeTuning();
-						settleLast = now;
-						const runwayOffset = runwayOffsetOf(host);
-						const lag = Math.max(0, host.scrollHeight - animatedH - runwayOffset);
-						const reserveStep = 1 - Math.exp(-dt / tuning.reserveResponseMs);
-						reservePx += (0 - reservePx) * reserveStep;
-						if (lag <= .25 && reservePx <= .25) {
-							animatedH = host.scrollHeight - runwayOffset;
-							reservePx = 0;
-							velocityPxPerSec = 0;
-							finishAtNaturalFloor(host);
-							followLeaders.delete(host);
-							releaseRevealScale();
-							debugRuntime.reportFollow(host, null);
-							stopSettleListeners();
-							return;
-						}
-						const step = computeFollowStep(dt, {
-							lag,
-							speedEma: speedCpsRef.current,
-							velocityPxPerSec
-						}, tuning);
-						const minimumLag = Math.max(0, reservePx);
-						animatedH = Math.min(host.scrollHeight - runwayOffset - minimumLag, animatedH + step.advancePx);
-						velocityPxPerSec = step.velocityPxPerSec;
-						settleAtFloor(host);
-						animatedH = applyVisual(host, animatedH, reservePx, velocityPxPerSec, tuning.runwayPx);
-						reportFollow(host, false);
-						requestAnimationFrame(settleFrame);
+					fpsRef.current = {
+						emaMs: 0,
+						lastMs: 0,
+						healthyRun: 0,
+						degraded: false
 					};
-					requestAnimationFrame(settleFrame);
+					debugRuntime.clearFps();
 				};
-			}, [
-				active,
-				rootRef,
-				speedCpsRef,
-				revealScaleRef,
-				predictive,
-				predictiveRef
-			]);
+			}, [active]);
+			const ref = (0, react.useCallback)((element) => {
+				elementRef.current = element;
+			}, []);
+			(0, react.useEffect)(() => {
+				const element = elementRef.current;
+				if (element === null || typeof IntersectionObserver === "undefined") return;
+				const observer = new IntersectionObserver((entries) => {
+					for (const entry of entries) visibleRef.current = entry.isIntersecting;
+				}, { rootMargin: "120px 0px" });
+				observer.observe(element);
+				return () => observer.disconnect();
+			});
+			return {
+				ref,
+				shouldHoldBack: (0, react.useCallback)(() => {
+					return active && fpsRef.current.degraded && !visibleRef.current;
+				}, [active])
+			};
 		}
 		//#endregion
 		//#region src/client/FollowHost.tsx
@@ -1585,24 +2003,38 @@ window.__ModuleLoader__.load({
 		* generic wrapped renderers re-arm one glide when their DOM grows without
 		* requiring a business-kind-specific lifecycle predicate.
 		*/
-		function FollowHost({ active, entrance = false, onEntranceSettled, onGrowth, entranceExtentRef, speedCpsRef, revealScaleRef, predictive = true, predictiveRef, hostRef, children }) {
+		function FollowHost({ active, entrance = false, onEntranceSettled, onGrowth, entranceExtentRef, speedCpsRef, revealedCharsRef, revealScaleRef, predictive = true, predictiveRef, hostRef, children }) {
 			const localRootRef = (0, react.useRef)(null);
 			const rootRef = hostRef ?? localRootRef;
-			useConversationFollow(rootRef, active || entrance, speedCpsRef, revealScaleRef, predictive, entrance, onEntranceSettled, predictiveRef, entranceExtentRef);
+			useConversationFollow(rootRef, active || entrance, speedCpsRef, revealScaleRef, predictive, entrance, onEntranceSettled, predictiveRef, entranceExtentRef, revealedCharsRef);
 			(0, react.useEffect)(() => {
 				if (onGrowth === void 0 || typeof ResizeObserver === "undefined") return;
 				const root = rootRef.current;
 				if (root === null) return;
 				let previousHeight = null;
+				let pendingGrowth = 0;
+				let growthFrame = null;
+				const flushGrowth = () => {
+					growthFrame = null;
+					if (pendingGrowth <= 0) return;
+					const delta = pendingGrowth;
+					pendingGrowth = 0;
+					onGrowth(delta);
+				};
 				const observer = new ResizeObserver((entries) => {
-					const nextHeight = entries[0]?.contentRect.height ?? root.getBoundingClientRect().height;
-					if (!Number.isFinite(nextHeight)) return;
-					if (previousHeight !== null && nextHeight > previousHeight + .5) onGrowth(nextHeight - previousHeight);
+					const measuredHeight = entries[0]?.contentRect.height;
+					if (measuredHeight === void 0 || !Number.isFinite(measuredHeight)) return;
+					const nextHeight = measuredHeight;
+					if (previousHeight !== null && nextHeight > previousHeight + .5) {
+						pendingGrowth += nextHeight - previousHeight;
+						if (growthFrame === null) growthFrame = requestAnimationFrame(flushGrowth);
+					}
 					previousHeight = nextHeight;
 				});
 				observer.observe(root);
 				return () => {
 					observer.disconnect();
+					if (growthFrame !== null) cancelAnimationFrame(growthFrame);
 				};
 			}, [onGrowth]);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1845,7 +2277,7 @@ window.__ModuleLoader__.load({
 		* drains, the settled full parse (KaTeX math, fence highlighting, file
 		* mentions) swaps in exactly once.
 		*/
-		function AnimatedMarkdownText({ text, codeLabels, fileMentions, streaming, ownFollow, followSpeedCpsRef, followRevealScaleRef, onPredictiveChange, preset, shouldHoldBack }) {
+		function AnimatedMarkdownText({ text, codeLabels, fileMentions, streaming, ownFollow, followSpeedCpsRef, followRevealedCharsRef, followRevealScaleRef, onPredictiveChange, preset, shouldHoldBack }) {
 			const reduced = usePrefersReducedMotion();
 			const [typing, setTyping] = (0, react.useState)(streaming);
 			const localSpeedCpsRef = (0, react.useRef)(35);
@@ -1860,7 +2292,11 @@ window.__ModuleLoader__.load({
 				preset,
 				shouldHoldBack,
 				speedCpsRef,
-				revealScaleRef: followRevealScaleRef
+				revealedCharsRef: followRevealedCharsRef,
+				revealScaleRef: followRevealScaleRef,
+				onRevealCommit: () => {
+					notifyFollowCommit(followRootRef.current);
+				}
 			});
 			const shown = reduced ? text : displayed;
 			const live = typing && !reduced;
@@ -1901,6 +2337,7 @@ window.__ModuleLoader__.load({
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FollowHost, {
 				active: live && ownFollow,
 				speedCpsRef,
+				revealedCharsRef: followRevealedCharsRef,
 				revealScaleRef: followRevealScaleRef,
 				predictive: streaming,
 				hostRef: followRootRef,
@@ -1946,18 +2383,27 @@ window.__ModuleLoader__.load({
 		function AnimatedReasoning({ text, running, preset, thinkAutoExpand, shouldHoldBack, followSpeedCpsRef, followRevealScaleRef, t }) {
 			const reduced = usePrefersReducedMotion();
 			const [expanded, setExpanded] = (0, react.useState)(running && thinkAutoExpand);
+			const [autoClosed, setAutoClosed] = (0, react.useState)(false);
 			const summaryRef = (0, react.useRef)(null);
+			const commitAnchorRef = (0, react.useRef)(null);
 			const displayed = useSmoothStreamContent(text, {
 				enabled: running && !reduced,
 				preset,
 				shouldHoldBack,
 				speedCpsRef: followSpeedCpsRef,
-				revealScaleRef: followRevealScaleRef
+				revealScaleRef: followRevealScaleRef,
+				onRevealCommit: () => {
+					notifyFollowCommit(commitAnchorRef.current);
+				}
 			});
 			const shown = running && !reduced ? displayed : text;
 			const summary = running ? latestLine(shown) : firstLine(text);
 			(0, react.useLayoutEffect)(() => {
-				if (thinkAutoExpand) setExpanded(running);
+				if (thinkAutoExpand) {
+					setExpanded(running);
+					setAutoClosed(!running);
+				}
+				notifyFollowCommit(commitAnchorRef.current);
 			}, [running, thinkAutoExpand]);
 			(0, react.useEffect)(() => {
 				const element = summaryRef.current;
@@ -1966,6 +2412,7 @@ window.__ModuleLoader__.load({
 			}, [running, summary]);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: TypewriterAssistantNodeView_module_css_default.follow,
+				ref: commitAnchorRef,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: TypewriterAssistantNodeView_module_css_default.think,
 					"data-variant": "think",
@@ -1982,8 +2429,10 @@ window.__ModuleLoader__.load({
 						title: "Think",
 						open: expanded,
 						onToggle: () => {
+							setAutoClosed(false);
 							setExpanded((value) => !value);
 						},
+						bodyTransition: !autoClosed,
 						collapsedContent: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: TypewriterAssistantNodeView_module_css_default.thinkSeparator,
 							"aria-hidden": true
@@ -2017,6 +2466,7 @@ window.__ModuleLoader__.load({
 			const reduced = usePrefersReducedMotion();
 			const { ref: guardRef, shouldHoldBack } = useFpsGuard(streaming);
 			const rootSpeedRef = (0, react.useRef)(35);
+			const rootRevealedCharsRef = (0, react.useRef)(0);
 			const rootRevealScaleRef = (0, react.useRef)(1);
 			const reasoningTailIndex = streaming && data.blocks[data.blocks.length - 1]?.kind === "reasoning" ? data.blocks.length - 1 : -1;
 			const reasoningOwnsSpeed = reasoningTailIndex !== -1;
@@ -2075,6 +2525,7 @@ window.__ModuleLoader__.load({
 							streaming,
 							ownFollow: !streaming && index === lastFollow,
 							followSpeedCpsRef: index === lastFollow ? rootSpeedRef : void 0,
+							followRevealedCharsRef: index === lastFollow ? rootRevealedCharsRef : void 0,
 							followRevealScaleRef: index === lastFollow ? rootRevealScaleRef : void 0,
 							onPredictiveChange: index === lastFollow ? updateTextPrediction : void 0,
 							preset,
@@ -2128,6 +2579,7 @@ window.__ModuleLoader__.load({
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FollowHost, {
 					active: streaming && !reduced,
 					speedCpsRef: rootSpeedRef,
+					revealedCharsRef: rootRevealedCharsRef,
 					revealScaleRef: rootRevealScaleRef,
 					predictiveRef: rootPredictiveRef,
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2270,6 +2722,7 @@ window.__ModuleLoader__.load({
 			/** True between start() and stop(); the preference toggle re-enters both. */
 			running = false;
 			lastPassError = "";
+			followDeferredAt = null;
 			flow = null;
 			/** Stable segment key → summary row + gesture state. */
 			segmentStates = /* @__PURE__ */ new Map();
@@ -2322,6 +2775,7 @@ window.__ModuleLoader__.load({
 			}
 			stop() {
 				this.running = false;
+				this.followDeferredAt = null;
 				if (this.raf !== 0) cancelAnimationFrame(this.raf);
 				this.raf = 0;
 				if (this.timer !== 0) clearTimeout(this.timer);
@@ -2352,10 +2806,16 @@ window.__ModuleLoader__.load({
 					this.rearmAudit();
 				}, AUDIT_TICK_MS);
 			}
-			/** Body-level observations only need to wake us up near the active flow. */
+			/** Only mutations inside the active flow can affect collapse geometry. */
 			shouldSchedule(records) {
 				if (records.length === 0 || this.flow === null || !this.flow.isConnected) return true;
-				return records.some((record) => nodeWithin(record.target, this.flow) || nodeWithin(this.flow, record.target));
+				const flow = this.flow;
+				return records.some((record) => {
+					const changed = [...record.addedNodes, ...record.removedNodes];
+					if (changed.length > 0 && changed.every((node) => isFloatingOverlayNode(node))) return false;
+					if (record.target === flow || nodeWithin(record.target, flow)) return true;
+					return changed.some((node) => nodeWithin(node, flow));
+				});
 			}
 			/** Walk each record to its flow child so reply-cache invalidation stays
 			* targeted; anything unattributable invalidates conservatively. */
@@ -2452,38 +2912,62 @@ window.__ModuleLoader__.load({
 					if (state.row === null || !state.row.isConnected) state.row = this.createProcessedRow(state);
 					this.syncProcessedRow(state);
 				}
-				for (const [key, state] of [...this.segmentStates]) {
-					if (completedKeys.has(key)) continue;
-					state.row?.remove();
-					this.segmentStates.delete(key);
-				}
-				const desiredHidden = /* @__PURE__ */ new Set();
-				for (const segment of segments) {
-					const state = this.segmentStates.get(segment.key);
-					if (state !== void 0 && !state.expanded) {
-						for (const seat of segment.hideSeats) this.hideElement(seat, desiredHidden);
-						for (const row of segment.finalThinkRows) this.hideElement(row, desiredHidden);
-						if (segment.finalStep !== null) this.restoreElement(segment.finalStep);
-					} else {
-						for (const seat of segment.hideSeats) this.restoreElement(seat);
-						for (const row of segment.finalThinkRows) this.restoreElement(row);
-						if (segment.finalStep !== null) this.restoreElement(segment.finalStep);
+				const portNow = flow.closest("[data-conversation-scroll]");
+				if (completedKeys.size > 0 && portNow !== null && hasRecentConversationFollow(portNow, 140)) {
+					const now = Date.now();
+					this.followDeferredAt ??= now;
+					if (now - this.followDeferredAt < 2e3) {
+						this.schedule();
+						return;
 					}
 				}
-				for (const segment of segments) {
-					if (!hasVisibleSegmentWork(segment)) {
+				this.followDeferredAt = null;
+				const port = flow.closest("[data-conversation-scroll]");
+				const beforeFloor = Math.max(0, (port?.scrollHeight ?? 0) - (port?.clientHeight ?? 0));
+				const pinnedToFloor = port !== null && beforeFloor - port.scrollTop <= 30;
+				const anchorBefore = lastVisibleAnchorTop(flow);
+				const applyMutations = () => {
+					for (const [key, state] of [...this.segmentStates]) {
+						if (completedKeys.has(key)) continue;
+						state.row?.remove();
+						this.segmentStates.delete(key);
+					}
+					const desiredHidden = /* @__PURE__ */ new Set();
+					for (const segment of segments) {
 						const state = this.segmentStates.get(segment.key);
-						if (state !== void 0 && state.row !== null) {
-							state.row.remove();
-							state.row = null;
+						if (state !== void 0 && !state.expanded) {
+							for (const seat of segment.hideSeats) this.hideElement(seat, desiredHidden);
+							for (const row of segment.finalThinkRows) this.hideElement(row, desiredHidden);
+							if (segment.finalStep !== null) this.restoreElement(segment.finalStep);
+						} else {
+							for (const seat of segment.hideSeats) this.restoreElement(seat);
+							for (const row of segment.finalThinkRows) this.restoreElement(row);
+							if (segment.finalStep !== null) this.restoreElement(segment.finalStep);
+						}
+					}
+					for (const segment of segments) {
+						if (!hasVisibleSegmentWork(segment)) {
+							const state = this.segmentStates.get(segment.key);
+							if (state !== void 0 && state.row !== null) {
+								state.row.remove();
+								state.row = null;
+							}
 						}
+						for (const seat of segment.hideSeats) this.retainDisplayControl(seat, desiredHidden);
+						for (const row of segment.finalThinkRows) this.retainDisplayControl(row, desiredHidden);
+						if (segment.finalStep !== null) this.retainDisplayControl(segment.finalStep, desiredHidden);
+					}
+					this.restoreUnusedDisplays(desiredHidden);
+					for (const state of this.segmentStates.values()) this.placeProcessedRow(flow, state);
+				};
+				applyMutations();
+				if (port !== null && pinnedToFloor && anchorBefore !== null) {
+					const anchorAfter = lastVisibleAnchorTop(flow);
+					if (anchorAfter !== null) {
+						const delta = anchorAfter - anchorBefore;
+						if (Math.abs(delta) > .5) port.scrollTop += delta;
 					}
-					for (const seat of segment.hideSeats) this.retainDisplayControl(seat, desiredHidden);
-					for (const row of segment.finalThinkRows) this.retainDisplayControl(row, desiredHidden);
-					if (segment.finalStep !== null) this.retainDisplayControl(segment.finalStep, desiredHidden);
 				}
-				this.restoreUnusedDisplays(desiredHidden);
-				for (const state of this.segmentStates.values()) this.placeProcessedRow(flow, state);
 				for (const key of [...this.runningSince.keys()]) if (!liveSegmentKeys.has(key)) this.runningSince.delete(key);
 				for (const key of [...this.completedOnce]) if (!liveSegmentKeys.has(key)) this.completedOnce.delete(key);
 			}
@@ -2633,6 +3117,23 @@ window.__ModuleLoader__.load({
 			for (let current = node; current !== null; current = current.parentNode) if (current === ancestor) return true;
 			return false;
 		}
+		/**
+		* Whether a mutation-added/removed node is a `position: fixed` overlay (the
+		* harness Tooltip bubble / a popover) that never affects the flow's collapse
+		* geometry. The primitives Tooltip mounts its fixed bubble as a Fragment
+		* sibling inside the message row — `position: fixed` arrives from its CSS
+		* module class, not inline style — so it appears within `[data-chat-flow]`
+		* even though it is viewport-fixed and layout-neutral. Matching on the
+		* tooltip's structural role instead of computed style keeps the filter
+		* reliable before the node has been laid out.
+		*/
+		function isFloatingOverlayNode(node) {
+			if (!(node instanceof HTMLElement)) return false;
+			if (node.getAttribute("role") === "tooltip") return true;
+			if (node.style.position === "fixed") return true;
+			if (node.style.position === "absolute" && node.parentElement?.getAttribute("role") === "tooltip") return true;
+			return false;
+		}
 		/** Top-level message order, excluding this plugin's own summary rows. */
 		function flowItems(flow) {
 			return [...flow.children].filter((el) => el instanceof HTMLElement && !el.classList.contains(PROCESSED_CLASS));
@@ -2840,6 +3341,19 @@ window.__ModuleLoader__.load({
 		* tails only carry an end timestamp, which is diffed against the opening user
 		* row's timestamp.
 		*/
+		/**
+		* Viewport-top of the last visible anchored message row, or null when none is
+		* rendered. Used to pin the reader's visual anchor across a fold commit.
+		*/
+		function lastVisibleAnchorTop(flow) {
+			const rows = flow.querySelectorAll("[data-chat-anchor-key]");
+			for (let index = rows.length - 1; index >= 0; index -= 1) {
+				const row = rows[index];
+				if (row.getClientRects().length === 0) continue;
+				return row.getBoundingClientRect().top;
+			}
+			return null;
+		}
 		function parseTurnDuration(boundary) {
 			const text = boundary.textContent ?? "";
 			const zh = text.match(/用时\s*(\d+)分(\d+)秒|用时\s*(\d+)秒/);
@@ -3385,32 +3899,32 @@ window.__ModuleLoader__.load({
 			tag.textContent = css$1;
 		}
 		var SmoothStreamCard_module_css_default = {
-			"fieldHead": "XNGeRG_fieldHead",
-			"label": "XNGeRG_label",
-			"version": "XNGeRG_version",
-			"header": "XNGeRG_header",
-			"body": "XNGeRG_body",
 			"failure": "XNGeRG_failure",
 			"updateRow": "XNGeRG_updateRow",
-			"updateCopy": "XNGeRG_updateCopy",
-			"field": "XNGeRG_field",
 			"footer": "XNGeRG_footer",
-			"name": "XNGeRG_name",
-			"failed": "XNGeRG_failed",
-			"discard": "XNGeRG_discard",
-			"toggle": "XNGeRG_toggle",
-			"fieldDisabled": "XNGeRG_fieldDisabled",
-			"readOnly": "XNGeRG_readOnly",
-			"headText": "XNGeRG_headText",
-			"cardOpen": "XNGeRG_cardOpen",
-			"save": "XNGeRG_save",
-			"hint": "XNGeRG_hint",
-			"chevron": "XNGeRG_chevron",
 			"update": "XNGeRG_update",
+			"cardOpen": "XNGeRG_cardOpen",
+			"fieldDisabled": "XNGeRG_fieldDisabled",
+			"header": "XNGeRG_header",
+			"chevronOpen": "XNGeRG_chevronOpen",
+			"field": "XNGeRG_field",
+			"version": "XNGeRG_version",
 			"pending": "XNGeRG_pending",
+			"chevron": "XNGeRG_chevron",
+			"hint": "XNGeRG_hint",
+			"failed": "XNGeRG_failed",
 			"description": "XNGeRG_description",
+			"label": "XNGeRG_label",
+			"fieldHead": "XNGeRG_fieldHead",
+			"updateCopy": "XNGeRG_updateCopy",
+			"save": "XNGeRG_save",
+			"discard": "XNGeRG_discard",
+			"body": "XNGeRG_body",
+			"name": "XNGeRG_name",
 			"card": "XNGeRG_card",
-			"chevronOpen": "XNGeRG_chevronOpen"
+			"readOnly": "XNGeRG_readOnly",
+			"headText": "XNGeRG_headText",
+			"toggle": "XNGeRG_toggle"
 		};
 		//#endregion
 		//#region src/client/SmoothStreamCard.tsx
@@ -3631,7 +4145,7 @@ window.__ModuleLoader__.load({
 		/** Bridges the plugin's protected Host interface onto a staged settings form. */
 		var SmoothStreamCardController = class {
 			api;
-			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)(this.projection());
+			store = createSnapshotStore(this.projection());
 			loaded;
 			loadedDebug;
 			stagedBase;
@@ -3911,34 +4425,34 @@ window.__ModuleLoader__.load({
 			tag.textContent = css;
 		}
 		var DebugPanel_module_css_default = {
-			"control": "m4_tdG_control",
-			"secondaryButton": "m4_tdG_secondaryButton",
-			"infoButton": "m4_tdG_infoButton",
-			"footerSpacer": "m4_tdG_footerSpacer",
-			"visuallyHidden": "m4_tdG_visuallyHidden",
-			"panelHeader": "m4_tdG_panelHeader",
-			"metric": "m4_tdG_metric",
 			"section": "m4_tdG_section",
-			"unsaved": "m4_tdG_unsaved",
-			"state": "m4_tdG_state",
+			"panelHeader": "m4_tdG_panelHeader",
 			"statusDot": "m4_tdG_statusDot",
-			"controlLabel": "m4_tdG_controlLabel",
-			"scrollArea": "m4_tdG_scrollArea",
-			"numberWrap": "m4_tdG_numberWrap",
-			"title": "m4_tdG_title",
-			"trigger": "m4_tdG_trigger",
-			"footer": "m4_tdG_footer",
 			"iconButton": "m4_tdG_iconButton",
-			"panel": "m4_tdG_panel",
-			"controlHead": "m4_tdG_controlHead",
+			"unsaved": "m4_tdG_unsaved",
+			"infoButton": "m4_tdG_infoButton",
 			"triggerActive": "m4_tdG_triggerActive",
-			"range": "m4_tdG_range",
-			"unit": "m4_tdG_unit",
-			"primaryButton": "m4_tdG_primaryButton",
 			"number": "m4_tdG_number",
-			"metrics": "m4_tdG_metrics",
+			"primaryButton": "m4_tdG_primaryButton",
 			"statusLive": "m4_tdG_statusLive",
-			"guide": "m4_tdG_guide"
+			"metric": "m4_tdG_metric",
+			"control": "m4_tdG_control",
+			"secondaryButton": "m4_tdG_secondaryButton",
+			"panel": "m4_tdG_panel",
+			"controlHead": "m4_tdG_controlHead",
+			"guide": "m4_tdG_guide",
+			"controlLabel": "m4_tdG_controlLabel",
+			"numberWrap": "m4_tdG_numberWrap",
+			"visuallyHidden": "m4_tdG_visuallyHidden",
+			"footer": "m4_tdG_footer",
+			"trigger": "m4_tdG_trigger",
+			"title": "m4_tdG_title",
+			"metrics": "m4_tdG_metrics",
+			"unit": "m4_tdG_unit",
+			"footerSpacer": "m4_tdG_footerSpacer",
+			"range": "m4_tdG_range",
+			"state": "m4_tdG_state",
+			"scrollArea": "m4_tdG_scrollArea"
 		};
 		//#endregion
 		//#region src/client/DebugPanel.tsx