@khorsheed/dsh-message-timeline 0.1.0 → 0.2.0

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

@@ -4,7 +4,7 @@ import type { TimelineRailProps } from './slots.ts';
  * @param props - composed props (see {@link TimelineRailProps}).
  * @returns nothing visible in the seat; the floating panel while the chat view shows.
  */
-export declare function TimelineRail({ useSession, sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t, }: TimelineRailProps): import("react").ReactPortal | null;
+export declare function TimelineRail({ sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t, ...standard }: TimelineRailProps): import("react").ReactPortal | null;
 /** Memoized export for the slot machinery (stable component identity). */
 export declare const TimelineRailEntry: import("react").MemoExoticComponent<typeof TimelineRail>;
 //# sourceMappingURL=TimelineRail.d.ts.map

package/lib/types/client/TimelineRail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimelineRail.d.ts","sourceRoot":"","sources":["../../../src/client/TimelineRail.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAoBjE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EAAE,SAAS,EACrB,eAAe,EAAE,UAAU,EAAE,YAAY,EACzC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAC9B,EAAE,iBAAiB,sCA4InB;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,0DAAqB,CAAA"}
+{"version":3,"file":"TimelineRail.d.ts","sourceRoot":"","sources":["../../../src/client/TimelineRail.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAsBjE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,eAAe,EAAE,UAAU,EAAE,YAAY,EACzC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAC7B,GAAG,QAAQ,EACZ,EAAE,iBAAiB,sCAmMnB;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,0DAAqB,CAAA"}

package/lib/types/client/TimelineRail.js

@@ -15,7 +15,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { memo, useEffect, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
 import { PANEL_WIDTH_MIN } from './config.js';
+import { chatHookOf } from './chat-hook.js';
 import { previewText } from './preview.js';
+import { foldHiddenSpans, isSeqHidden } from './hidden-spans.js';
+import { isTimelineRowKind, EDIT_KIND, RESTORED_KIND } from './timeline-kinds.js';
 import css from './TimelineRail.module.css';
 /** Extract the preview blocks of one user/steering node (kind-checked by the caller). */
 function nodeContent(node) {
@@ -36,23 +39,84 @@ const DEGRADED_WIDTH_RATIO = 0.4;
  * @param props - composed props (see {@link TimelineRailProps}).
  * @returns nothing visible in the seat; the floating panel while the chat view shows.
  */
-export function TimelineRail({ useSession, sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t, }) {
+export function TimelineRail({ sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t, ...standard }) {
     const rail = useRail(s => s);
-    const order = useSession(s => s.chat.order);
-    const nodes = useSession(s => s.chat.nodes);
+    // Chat data lives in the `useChat` standard prop on 0.1.2 (the rc-line
+    // session-snapshot seat is gone); the helper degrades to an empty slice
+    // when the seat is absent.
+    const useChatSlice = chatHookOf(standard);
+    const useSession = standard.useSession;
+    const order = useChatSlice(c => c.order);
+    const nodes = useChatSlice(c => c.nodes);
     const hasMore = useSession(s => s.hasMore);
     const loadingOlder = useSession(s => s.loadingOlder);
     const items = useMemo(() => {
+        // The node store is an in-memory snapshot; take it once so the span fold
+        // and the message-tools append read the same snapshot.
+        let store = [];
+        let spans = [];
+        try {
+            store = nodes.values();
+            spans = foldHiddenSpans(store);
+        }
+        catch {
+            // Degrade, don't explode: a failed store read leaves no spans and no
+            // appended bubbles, so the baseline order rows still render (a withdraw
+            // span reappears, and bubbles re-appear, after the store recovers).
+        }
+        // A message-tools withdraw (or an in-place edit) leaves the withdrawn
+        // originals in the store with a sibling `message-tools-withdrawn` /
+        // `message-tools-edited` node carrying the span they cover as
+        // `{ hiddenStartSeq, seq }`. Those originals can still surface in the
+        // host's `order`, but the DOM hider hides their transcript rows — a rail
+        // row for one is a dead row (clicking cannot scroll to it). Drop any such
+        // row whose anchorSeq sits inside a span, from either loop below. An
+        // ordinary session carries no span node, so the fold is empty and every
+        // order row still renders: this filter never alters the baseline.
+        const hidden = (node) => isSeqHidden(spans, node.anchorSeq);
         const result = [];
+        const seen = new Set();
         for (const key of order) {
             const node = nodes.get(key);
             if (node === undefined)
                 continue;
-            const kind = node.kind;
-            if (kind !== 'user' && !(includeSteering && kind === 'steering'))
+            if (!isTimelineRowKind(node.kind, includeSteering))
+                continue;
+            if (hidden(node))
                 continue;
             result.push({ key, node });
+            seen.add(key);
+        }
+        // After a message-tools in-place edit the replacement materializes as a
+        // `message-tools-edited` bubble (a restore as `message-tools-restored`)
+        // that the host's visible `order` does not always surface, even though it
+        // renders in the flow — an edit of the first message would drain the rail
+        // to zero rows. Append any such visible bubble the order omitted, provided
+        // it is not itself a withdrawn original (inside a span). Only these two
+        // bubble kinds are appended — a plain user/steering node not in `order`
+        // must never be resurrected as an orphan row. Normal sessions carry no
+        // such nodes, so this never alters the baseline.
+        for (const node of store) {
+            if (node.kind !== EDIT_KIND && node.kind !== RESTORED_KIND)
+                continue;
+            if (node.visibility === 'hidden')
+                continue;
+            if (seen.has(node.key))
+                continue;
+            if (hidden(node))
+                continue;
+            result.push({ key: node.key, node });
+            seen.add(node.key);
         }
+        // The order loop is seq-sorted, but the appended bubbles walked the store
+        // (whose iteration order is not seq-ordered), so a bubble for an OLDER
+        // message would otherwise land at the very end, past the newest row.
+        // Sort the combined rows by anchorSeq so every row — original or appended
+        // — sits at its true transcript position. JS sort is stable, and an
+        // ordinary session has no appended bubbles, so this never reorders the
+        // baseline (which is already seq-sorted). Dropped rows are gone before the
+        // sort, so a withdrawn original never resurfaces.
+        result.sort((left, right) => left.node.anchorSeq - right.node.anchorSeq);
         return result;
     }, [order, nodes, includeSteering]);
     // The lit row: the hover/arrow preselection while it moves, otherwise the

package/lib/types/client/chat-hook.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Chat snapshot hook seat. Host 0.1.2 split the chat snapshot out of the
+ * session snapshot into the `useChat` session standard prop (ui-chat); its
+ * snapshot carries the fields the panel reads (`order`, `nodes`) at the top
+ * level. The rc-line `useSession(...).chat` seat went away with the baseline
+ * flip, so there is no second arm: the helper reads `useChat` and degrades to
+ * an empty slice (panel hidden, never a throw) when the prop is absent.
+ */
+import type { ChatConversationViewNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * The chat slice the panel's selectors read — the narrow face of ui-chat's
+ * ChatSnapshot the rail depends on (a structural subset, so the official
+ * `UseChat` hook is directly assignable).
+ */
+export interface ChatSlice {
+    /** Visible chat node keys in render order. */
+    readonly order: readonly string[];
+    /** Live per-key node store. */
+    readonly nodes: {
+        get(key: string): ChatConversationViewNode | undefined;
+        values(): readonly ChatConversationViewNode[];
+    };
+}
+/** Selector hook over the chat slice. */
+export type ChatSliceHook = SnapshotSelectorHook<ChatSlice>;
+/**
+ * Pick the live chat hook for this entry.
+ * @param props - the entry's composed props (useChat present on 0.1.2 hosts).
+ * @returns the `useChat` prop, or the empty-slice hook when the seat is absent.
+ */
+export declare function chatHookOf(props: {
+    useChat?: SnapshotSelectorHook<ChatSlice>;
+}): ChatSliceHook;
+//# sourceMappingURL=chat-hook.d.ts.map

package/lib/types/client/chat-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-hook.d.ts","sourceRoot":"","sources":["../../../src/client/chat-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE5E;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE;QACd,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAAA;QACtD,MAAM,IAAI,SAAS,wBAAwB,EAAE,CAAA;KAC9C,CAAA;CACF;AAED,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAA;AAW3D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAA;CAAE,GAAG,aAAa,CAE9F"}

package/lib/types/client/chat-hook.js

@@ -0,0 +1,15 @@
+/** Empty slice behind the absent-prop degrade: no rows, so the panel hides. */
+const EMPTY_SLICE = {
+    order: [],
+    nodes: { get: () => undefined, values: () => [] },
+};
+/** Constant hook answering every selector from the empty slice. */
+const EMPTY_HOOK = (selector) => selector(EMPTY_SLICE);
+/**
+ * Pick the live chat hook for this entry.
+ * @param props - the entry's composed props (useChat present on 0.1.2 hosts).
+ * @returns the `useChat` prop, or the empty-slice hook when the seat is absent.
+ */
+export function chatHookOf(props) {
+    return props.useChat ?? EMPTY_HOOK;
+}

package/lib/types/client/hidden-spans.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hidden-span folding for the rail. A message-tools withdraw (or an in-place
+ * edit) shadows a span of the transcript but leaves the withdrawn original
+ * rows in the node store — and, because the projection offers no suppression
+ * seam, a withdrawn user message stays visible in the host `order` while the
+ * sibling DOM hider hides its row by CSS. A rail row for such a node is a dead
+ * row: the transcript row it would target is `display:none`, so a click cannot
+ * scroll to it.
+ *
+ * The span a withdraw or edit covers is carried right on the store by the
+ * sibling `message-tools-withdrawn` / `message-tools-edited` node as
+ * `{ hiddenStartSeq, seq }` (its `anchorSeq` is `seq`, the exclusive end, so
+ * the divider/edited bubble itself is never inside its own span). Folding
+ * those spans — exactly the pair list message-tools' `foldHiddenRanges`
+ * builds — lets the rail skip any row whose `anchorSeq` falls inside one.
+ *
+ * This module reads only generic store node data (no import from message-tools
+ * and no dependence on its type map). An ordinary session carries no such
+ * node, so the fold is empty and every order row still renders: the fix never
+ * alters the baseline path.
+ */
+import type { ChatConversationViewNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+/**
+ * Fold the hidden seq spans out of the store into the flat
+ * `[start, endExclusive, ...]` pair list ordered by start — the same shape
+ * message-tools' renderers and DOM hider consume (`{ hiddenStartSeq, seq }`,
+ * inclusive start, exclusive end). A malformed carrier (missing or inverted
+ * bounds) is skipped rather than poisoning the fold.
+ * @param nodes - every materialized chat node (any order).
+ * @returns the flattened hidden spans; empty when no withdraw/edit landed.
+ */
+export declare function foldHiddenSpans(nodes: readonly ChatConversationViewNode[]): number[];
+/**
+ * Whether a node seq falls inside one of the folded hidden spans.
+ * @param spans - the flattened spans from {@link foldHiddenSpans}.
+ * @param seq - the node seq to test.
+ * @returns true when the seq is hidden (a withdrawn original).
+ */
+export declare function isSeqHidden(spans: readonly number[], seq: number): boolean;
+//# sourceMappingURL=hidden-spans.d.ts.map

package/lib/types/client/hidden-spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hidden-spans.d.ts","sourceRoot":"","sources":["../../../src/client/hidden-spans.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AAStF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,GAAG,MAAM,EAAE,CAWpF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAO1E"}

package/lib/types/client/hidden-spans.js

@@ -0,0 +1,40 @@
+import { isHiddenSpanCarrierKind } from './timeline-kinds.js';
+/**
+ * Fold the hidden seq spans out of the store into the flat
+ * `[start, endExclusive, ...]` pair list ordered by start — the same shape
+ * message-tools' renderers and DOM hider consume (`{ hiddenStartSeq, seq }`,
+ * inclusive start, exclusive end). A malformed carrier (missing or inverted
+ * bounds) is skipped rather than poisoning the fold.
+ * @param nodes - every materialized chat node (any order).
+ * @returns the flattened hidden spans; empty when no withdraw/edit landed.
+ */
+export function foldHiddenSpans(nodes) {
+    const pairs = [];
+    for (const node of nodes) {
+        if (!isHiddenSpanCarrierKind(node.kind))
+            continue;
+        const data = node.data;
+        if (data.hiddenStartSeq === undefined || data.seq === undefined)
+            continue;
+        if (data.hiddenStartSeq >= data.seq)
+            continue;
+        pairs.push([data.hiddenStartSeq, data.seq]);
+    }
+    pairs.sort((left, right) => left[0] - right[0]);
+    return pairs.flat();
+}
+/**
+ * Whether a node seq falls inside one of the folded hidden spans.
+ * @param spans - the flattened spans from {@link foldHiddenSpans}.
+ * @param seq - the node seq to test.
+ * @returns true when the seq is hidden (a withdrawn original).
+ */
+export function isSeqHidden(spans, seq) {
+    for (let index = 0; index + 1 < spans.length; index += 2) {
+        const start = spans[index];
+        const end = spans[index + 1];
+        if (start !== undefined && end !== undefined && seq >= start && seq < end)
+            return true;
+    }
+    return false;
+}

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

@@ -10,7 +10,7 @@
  * hidden panel when those attributes change — no official code is modified.
  * @module @khorsheed/dsh-message-timeline/client
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context } from '@deepseek-ai/cordis';
 import { type TimelineConfig } from './config.ts';
 export type { TimelineConfig } from './config.ts';
 export { resolveConfig } from './config.ts';
@@ -25,5 +25,5 @@ export declare const inject: string[];
  * @param ctx - client root context.
  * @param config - entry config; defaults apply when the runner passes none.
  */
-export declare function apply(ctx: ClientContext, config?: Partial<TimelineConfig>): void;
+export declare function apply(ctx: Context, config?: Partial<TimelineConfig>): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAM3E,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAMhE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAK1G,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAkC,CAAA;AAErD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CA+BhF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAclD,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAMhE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAK1G,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAkC,CAAA;AAErD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CA+B1E"}

package/lib/types/client/rail-tracker.d.ts

@@ -12,15 +12,20 @@
  * (one console.warn), missing rows only clear the active marker and make
  * jumps no-ops. Nothing throws and no official code is modified.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context } from '@deepseek-ai/cordis';
 import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
 import type { TimelineRailState } from './slots.ts';
 /**
  * Measure the panel's viewport box from one scrollport: its rect inset by the
- * panel padding, minus the sticky composer seat at the bottom and the
- * conversation tab strip at the top. The tabs render just above the
- * scrollport, but centering reads against the whole window, so the strip
- * height leaves the box either way — otherwise the list sits visibly high.
+ * panel padding, minus the chat input card at the bottom and the conversation
+ * tab strip at the top. The tabs render just above the scrollport, but
+ * centering reads against the whole window, so the strip height leaves the
+ * box either way — otherwise the list sits visibly high.
+ * The bottom ends at the `[data-composer-card]` top — the chat box — NOT the
+ * whole `[data-composer-seat]` top: dock cards (goal/todo/queue) sit above
+ * the input inside the seat, and counting them would push the timeline up off
+ * the conversation. Falls back to the seat top, then the column bottom, when
+ * the markers are absent.
  * The scrollport's own width rides along for the width-cap fallback when the
  * message-flow probe is unanswered.
  * @param scrollport - the official conversation scrollport element.
@@ -35,12 +40,19 @@ export declare function measureGeometry(scrollport: HTMLElement): {
 } | null;
 /**
  * The viewport x of the message flow's left edge: the left of the first
- * rendered `[data-chat-flow-kind]` row, which sits flush inside the official
- * centered content column (max 748px, `margin: 0 auto`). Every flow row
- * shares that edge, so the first one found suffices. The panel's right edge
- * stays left of it — the panel may only occupy the scrollport's left gutter.
+ * laid-out `[data-chat-flow-kind]` row, which sits flush inside the official
+ * centered content column (max 748px, `margin: 0 auto`). Laid-out flow rows
+ * share that edge, so the first meaningful one suffices. The panel's right
+ * edge stays left of it — the panel may only occupy the scrollport's left
+ * gutter.
+ *
+ * Rows that are not laid out in the flow are skipped: a message-tools edit
+ * leaves the withdrawn originals in the DOM (hidden, zero-size, or off the
+ * column at x=0), and probing their left edge yields 0 — which would make the
+ * width gate compute a negative left gutter and hide the entire rail. Any
+ * real flow row sits inside the conversation column at a positive x.
  * @param scrollport - the official conversation scrollport element.
- * @returns the flow's left edge, or null while no flow row is rendered.
+ * @returns the flow's left edge, or null while no laid-out flow row is rendered.
  */
 export declare function flowLeftX(scrollport: HTMLElement): number | null;
 /**
@@ -80,5 +92,5 @@ export interface RailTracker {
  * @param includeSteering - whether steering rows count as user dots.
  * @returns the tracker face.
  */
-export declare function installRailTracker(ctx: ClientContext, includeSteering: boolean): RailTracker;
+export declare function installRailTracker(ctx: Context, includeSteering: boolean): RailTracker;
 //# sourceMappingURL=rail-tracker.d.ts.map

package/lib/types/client/rail-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rail-tracker.d.ts","sourceRoot":"","sources":["../../../src/client/rail-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAenD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoB5H;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAa7F;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACjD,qFAAqF;IACrF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,GAAG,WAAW,CAoI5F"}
+{"version":3,"file":"rail-tracker.d.ts","sourceRoot":"","sources":["../../../src/client/rail-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AAGtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAgBnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAyB5H;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAQhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAa7F;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;IACjD,qFAAqF;IACrF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAG,WAAW,CA2KtF"}

package/lib/types/client/rail-tracker.js

@@ -1,3 +1,4 @@
+import { isTimelineRowKind } from './timeline-kinds.js';
 /** Horizontal inset of the rail from the scrollport's left edge (px). */
 const RAIL_LEFT_INSET = 6;
 /** Vertical padding above and below the rail inside the scrollport (px). */
@@ -11,10 +12,15 @@ const IDLE = {
 };
 /**
  * Measure the panel's viewport box from one scrollport: its rect inset by the
- * panel padding, minus the sticky composer seat at the bottom and the
- * conversation tab strip at the top. The tabs render just above the
- * scrollport, but centering reads against the whole window, so the strip
- * height leaves the box either way — otherwise the list sits visibly high.
+ * panel padding, minus the chat input card at the bottom and the conversation
+ * tab strip at the top. The tabs render just above the scrollport, but
+ * centering reads against the whole window, so the strip height leaves the
+ * box either way — otherwise the list sits visibly high.
+ * The bottom ends at the `[data-composer-card]` top — the chat box — NOT the
+ * whole `[data-composer-seat]` top: dock cards (goal/todo/queue) sit above
+ * the input inside the seat, and counting them would push the timeline up off
+ * the conversation. Falls back to the seat top, then the column bottom, when
+ * the markers are absent.
  * The scrollport's own width rides along for the width-cap fallback when the
  * message-flow probe is unanswered.
  * @param scrollport - the official conversation scrollport element.
@@ -25,8 +31,6 @@ export function measureGeometry(scrollport) {
     const rect = scrollport.getBoundingClientRect();
     if (rect.width === 0 && rect.height === 0)
         return null;
-    const composer = scrollport.querySelector('[data-composer-seat]');
-    const composerHeight = composer?.getBoundingClientRect().height ?? 0;
     let topInset = RAIL_VERTICAL_PADDING;
     for (const tabs of scrollport.ownerDocument.querySelectorAll('[role="tablist"]')) {
         const tabsRect = tabs.getBoundingClientRect();
@@ -36,25 +40,46 @@ export function measureGeometry(scrollport) {
             break;
         }
     }
+    const card = scrollport.querySelector('[data-composer-card]');
+    const seat = scrollport.querySelector('[data-composer-seat]');
+    const bottom = card !== null
+        ? card.getBoundingClientRect().top - RAIL_VERTICAL_PADDING
+        : seat !== null
+            ? seat.getBoundingClientRect().top - RAIL_VERTICAL_PADDING
+            : rect.bottom - RAIL_VERTICAL_PADDING;
     return {
         left: rect.left + RAIL_LEFT_INSET,
         top: rect.top + topInset,
-        height: Math.max(0, rect.height - composerHeight - topInset - RAIL_VERTICAL_PADDING),
+        height: Math.max(0, bottom - rect.top - topInset),
         width: rect.width,
     };
 }
 /**
  * The viewport x of the message flow's left edge: the left of the first
- * rendered `[data-chat-flow-kind]` row, which sits flush inside the official
- * centered content column (max 748px, `margin: 0 auto`). Every flow row
- * shares that edge, so the first one found suffices. The panel's right edge
- * stays left of it — the panel may only occupy the scrollport's left gutter.
+ * laid-out `[data-chat-flow-kind]` row, which sits flush inside the official
+ * centered content column (max 748px, `margin: 0 auto`). Laid-out flow rows
+ * share that edge, so the first meaningful one suffices. The panel's right
+ * edge stays left of it — the panel may only occupy the scrollport's left
+ * gutter.
+ *
+ * Rows that are not laid out in the flow are skipped: a message-tools edit
+ * leaves the withdrawn originals in the DOM (hidden, zero-size, or off the
+ * column at x=0), and probing their left edge yields 0 — which would make the
+ * width gate compute a negative left gutter and hide the entire rail. Any
+ * real flow row sits inside the conversation column at a positive x.
  * @param scrollport - the official conversation scrollport element.
- * @returns the flow's left edge, or null while no flow row is rendered.
+ * @returns the flow's left edge, or null while no laid-out flow row is rendered.
  */
 export function flowLeftX(scrollport) {
-    const row = scrollport.querySelector('[data-chat-flow-kind]');
-    return row === null ? null : row.getBoundingClientRect().left;
+    for (const row of scrollport.querySelectorAll('[data-chat-flow-kind]')) {
+        const rect = row.getBoundingClientRect();
+        if (rect.width === 0 && rect.height === 0)
+            continue;
+        if (rect.left <= 0)
+            continue;
+        return rect.left;
+    }
+    return null;
 }
 /**
  * Resolve the key of the user-message row the reading position belongs to:
@@ -72,7 +97,7 @@ export function activeRowKey(scrollport, includeSteering) {
     let lastAbove = null;
     for (const row of scrollport.querySelectorAll('[data-chat-flow-kind]')) {
         const kind = row.dataset.chatFlowKind;
-        if (kind !== 'user' && !(includeSteering && kind === 'steering'))
+        if (kind === undefined || !isTimelineRowKind(kind, includeSteering))
             continue;
         if (row.getBoundingClientRect().bottom <= viewTop) {
             lastAbove = row.dataset.chatAnchorKey ?? lastAbove;
@@ -114,6 +139,12 @@ export function installRailTracker(ctx, includeSteering) {
     let resizeObserver;
     let rafPending = false;
     let warned = false;
+    // Bind-generation token: every teardown (a rebind or a dispose) bumps it, so
+    // a still-pending bind frame that closed over an older token becomes stale
+    // and bails. Without this, a bind scheduled before a dispose/rebind would
+    // run afterward — binding the global scrollport under a stale session or,
+    // worse, re-adding listeners and a ResizeObserver to a disposed tracker.
+    let bindToken = 0;
     const nextFrame = typeof requestAnimationFrame === 'function'
         ? requestAnimationFrame
         : (callback) => { setTimeout(callback, 16); };
@@ -130,10 +161,37 @@ export function installRailTracker(ctx, includeSteering) {
         for (const fn of [...listeners])
             fn();
     };
+    const attach = (el) => {
+        if (scrollport !== null)
+            scrollport.removeEventListener('scroll', onScroll);
+        resizeObserver?.disconnect();
+        scrollport = el;
+        scrollport.addEventListener('scroll', onScroll, { passive: true });
+        if (typeof ResizeObserver === 'function') {
+            resizeObserver = new ResizeObserver(scheduleUpdate);
+            resizeObserver.observe(el);
+            const composer = el.querySelector('[data-composer-seat]');
+            if (composer !== null)
+                resizeObserver.observe(composer);
+        }
+    };
     const update = () => {
-        if (scrollport === null)
-            return;
-        const geometry = measureGeometry(scrollport);
+        // Self-heal the scrollport binding: while unbound (or bound to a node the
+        // host remounted away — the conversation view re-renders under a stable
+        // session), re-probe the DOM. On rc hosts currentProvideInfo announced
+        // the remount; on 0.1.2 the feed is gone, so the observer/resize/scroll
+        // cadence that already lands here owns re-resolution on both lines.
+        let el = scrollport;
+        if (el === null || !el.isConnected) {
+            if (activeSession === undefined)
+                return;
+            const found = document.querySelector('[data-conversation-scroll]');
+            if (found === null)
+                return;
+            attach(found);
+            el = found;
+        }
+        const geometry = measureGeometry(el);
         if (geometry === null)
             return;
         publish({
@@ -143,9 +201,9 @@ export function installRailTracker(ctx, includeSteering) {
             top: geometry.top,
             height: geometry.height,
             scrollportWidth: geometry.width,
-            flowLeft: flowLeftX(scrollport),
-            activeKey: activeRowKey(scrollport, includeSteering),
-            chatView: scrollport.querySelector('[data-chat-flow]') !== null,
+            flowLeft: flowLeftX(el),
+            activeKey: activeRowKey(el, includeSteering),
+            chatView: el.querySelector('[data-chat-flow]') !== null,
         });
     };
     const scheduleUpdate = () => {
@@ -159,6 +217,7 @@ export function installRailTracker(ctx, includeSteering) {
     };
     const onScroll = () => { scheduleUpdate(); };
     const teardownBind = () => {
+        bindToken++;
         if (scrollport !== null)
             scrollport.removeEventListener('scroll', onScroll);
         scrollport = null;
@@ -175,7 +234,14 @@ export function installRailTracker(ctx, includeSteering) {
             publish(IDLE);
             return;
         }
+        const token = bindToken;
         nextFrame(() => {
+            // This frame was scheduled by an earlier bind whose generation has since
+            // been superseded by a rebind or a dispose: ignore it entirely rather
+            // than binding the scrollport under a stale session or binding into a
+            // disposed tracker.
+            if (token !== bindToken)
+                return;
             const found = document.querySelector('[data-conversation-scroll]');
             if (found === null) {
                 if (!warned) {
@@ -185,15 +251,7 @@ export function installRailTracker(ctx, includeSteering) {
                 publish(IDLE);
                 return;
             }
-            scrollport = found;
-            scrollport.addEventListener('scroll', onScroll, { passive: true });
-            if (typeof ResizeObserver === 'function') {
-                resizeObserver = new ResizeObserver(scheduleUpdate);
-                resizeObserver.observe(scrollport);
-                const composer = scrollport.querySelector('[data-composer-seat]');
-                if (composer !== null)
-                    resizeObserver.observe(composer);
-            }
+            attach(found);
             update();
         });
     };
@@ -201,7 +259,15 @@ export function installRailTracker(ctx, includeSteering) {
         bind(ctx.sessions.list.getSnapshot().current);
     };
     const stopList = ctx.sessions.list.subscribe(bindCurrent);
-    const stopProvide = ctx.sessions.currentProvideInfo.subscribe(bindCurrent);
+    // Host 0.1.2-alpha.1 removed ISessions.currentProvideInfo (commit
+    // be531688f3 — the provide-channel projection went with the runtime
+    // package). rc hosts still publish it, and it is the precise remount
+    // signal there, so subscribe when the feed exists and skip it when the
+    // service predates/omits it — update() below re-resolves a missing or
+    // detached scrollport from the MutationObserver/resize cadence, which
+    // covers the remount signal on both lines.
+    const provideFeed = ctx.sessions.currentProvideInfo;
+    const stopProvide = provideFeed?.subscribe(bindCurrent);
     bindCurrent();
     // Layout fallbacks beyond the scrollport's own ResizeObserver: a window
     // resize re-measures, and a body MutationObserver catches panel folds and
@@ -230,7 +296,7 @@ export function installRailTracker(ctx, includeSteering) {
         },
         dispose: () => {
             stopList();
-            stopProvide();
+            stopProvide?.();
             if (typeof window !== 'undefined')
                 window.removeEventListener('resize', onWindowResize);
             mutationObserver?.disconnect();

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

@@ -3,7 +3,7 @@
  * face (jump/loadOlder plus the rail geometry hook) and the composed props of
  * the `conversation.session.header.utilities` entry.
  */
-import type { ChatConversationViewNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ChatConversationViewNode } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { HostObservable, InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 /**
  * Live rail geometry plus the currently visible user message, published by
@@ -18,7 +18,11 @@ export interface TimelineRailState {
     left: number;
     /** Viewport y of the rail's top edge (below the session header). */
     top: number;
-    /** Rail height in px (scrollport minus the composer seat). */
+    /**
+     * Rail height in px: the scrollport from below the tab strip down to the
+     * chat input card top — dock cards (goal/todo/queue) above the input never
+     * shorten it, so the timeline stays flush with the chat box.
+     */
     height: number;
     /** Scrollport width in px (the degraded width cap when the flow probe fails). */
     scrollportWidth: number;

package/lib/types/client/slots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,EACV,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EACtD,MAAM,kCAAkC,CAAA;AAOzC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAA;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAA;IACX,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,eAAe,EAAE,OAAO,CAAA;IACxB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,wEAAwE;IACxE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,KAAK,EAAE;QACL,qEAAqE;QACrE,IAAI,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;KACxC,CAAA;CACF;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAA;CACxC;AAED,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAC3B,YAAY,CAAC,uCAAuC,CAAC,GACnD,UAAU,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../../src/client/slots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,EACV,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EACtD,MAAM,kCAAkC,CAAA;AAUzC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAA;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,eAAe,EAAE,OAAO,CAAA;IACxB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,wEAAwE;IACxE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,KAAK,EAAE;QACL,qEAAqE;QACrE,IAAI,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAA;KACxC,CAAA;CACF;AAED,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAA;CACxC;AAED,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAC3B,YAAY,CAAC,uCAAuC,CAAC,GACnD,UAAU,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,kBAAkB,CAAC,CAAA"}

package/lib/types/client/timeline-kinds.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Timeline node-kind classification. The rail's projection (which store nodes
+ * become rows) and its DOM tracking (which flow rows read as the reading
+ * position) must agree on the set of "timeline row" kinds, and the hidden-
+ * span fold must agree on the set of "span carrier" kinds. Rather than repeat
+ * these inline predicates at every site — where a future kind could be added
+ * to one place and silently missed in another — they live here as the single
+ * source of truth. Both are pure and read only the `kind` string, so they hold
+ * no dependency on the message-tools package and work for any session.
+ */
+/** A message-tools edited-bubble row (an in-place edit replacement). */
+export declare const EDIT_KIND = "message-tools-edited";
+/** A message-tools restored row (a withdrawn message replayed at the tail). */
+export declare const RESTORED_KIND = "message-tools-restored";
+/**
+ * Whether a node kind renders as a timeline row. The rail lists user messages
+ * (and optionally steering), plus the message-tools edited/restored bubbles
+ * that the host `order` does not always surface.
+ * @param kind - the node's kind string.
+ * @param includeSteering - whether steering rows count as user messages.
+ * @returns true when the kind belongs on the timeline.
+ */
+export declare function isTimelineRowKind(kind: string, includeSteering: boolean): boolean;
+/**
+ * Whether a node kind carries a hidden span (`{ hiddenStartSeq, seq }`) that
+ * the rail must fold to drop the covered originals. The withdrawal divider and
+ * the edited bubble both declare the span they shadow.
+ * @param kind - the node's kind string.
+ * @returns true when the kind declares a hidden span.
+ */
+export declare function isHiddenSpanCarrierKind(kind: string): boolean;
+//# sourceMappingURL=timeline-kinds.d.ts.map