dsh-rewind-plugin 0.7.5 → 0.9.0-alpha.1

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

@@ -5,7 +5,17 @@
  *
  * @module dsh-rewind/client/hidden
  */
-import type { ChatConversationViewNode, CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { CommandNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/** A chat-snapshot view node as the hiding / composer-refill logic reads it.
+ * The harness's view node shape plus the `anchorSeq` the chat snapshot carries
+ * (the plugin reads `anchorSeq` off each node; it is not declared on the
+ * harness's `ConversationViewNode`). */
+export interface ChatConversationViewNode {
+    readonly key: string;
+    readonly kind?: string;
+    readonly data?: unknown;
+    readonly anchorSeq: number;
+}
 /** Minimal chat snapshot reader the hiding logic needs. */
 export interface HiddenChat {
     readonly order: readonly string[];
@@ -14,55 +24,36 @@ export interface HiddenChat {
     };
 }
 /**
- * Reader for one session's live chat snapshot. This is one of the plugin's
- * "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual channels: 0.1.1-rc.2 serves the chat from the
- * session face snapshot, while 0.1.2-rc.1 (and the whole 0.1.2 line) serves it
- * from the `uiConversation` service's named "chat" view (contributed by
- * dsh-client-ui-chat through the uiSession slot hook). See
- * SiriLee/dsh-rewind#7.
+ * Reader for one session's live chat snapshot. On the 0.1.2-rc.1 line (the
+ * plugin's single baseline) the chat is served by the `uiConversation`
+ * service's named "chat" view (contributed by dsh-client-ui-chat through the
+ * uiSession slot hook).
  */
 export type ChatOf = (session: {
     readonly sessionId: string;
-    getSnapshot(): {
-        chat?: unknown;
-    };
 } | undefined) => HiddenChat | undefined;
 /**
  * Subscribe to one session's live chat-update signal, for waiting on a chat
- * snapshot change without polling. Dual-channel, mirroring `chatOf`: the
- * 0.1.2-rc.1 `uiConversation` "chat" view when registered, else the session
- * face (0.1.1-rc.2, whose snapshot still carries `chat`, so its own
- * `subscribe` is the chat-update signal). `cb` fires whenever the chat
- * snapshot invalidates.
+ * snapshot change without polling. The 0.1.2-rc.1 `uiConversation` "chat"
+ * view's own `subscribe` is the chat-update signal; `cb` fires whenever the
+ * chat snapshot invalidates.
  */
 export type ChatWatch = (sessionId: string, cb: () => void) => () => void;
 /**
- * Choose the chat-update subscription for `waitForCommand`: prefer the
- * `uiConversation` "chat" view's own `subscribe` when available (0.1.2-rc.1,
- * where the chat-update signal lives), else the session face's `subscribe`
- * (0.1.1-rc.2, whose snapshot still carries the chat, so its own subscribe is
- * the chat-update signal). Extracted as a pure channel-selection step so the
- * "view vs face" branch is unit-testable; the resolvers are injected by the
- * caller (see `watchChat` in index.ts). Never throws.
+ * Choose the chat-update subscription for `waitForCommand`: the
+ * `uiConversation` "chat" view's own `subscribe`. Extracted as a pure
+ * channel-selection step so the resolver is unit-testable; the resolver is
+ * injected by the caller (see `watchChat` in index.ts). Never throws.
  */
 export declare function resolveChatWatch(resolveView: (sessionId: string) => {
     subscribe?(cb: () => void): () => void;
-} | undefined, resolveFace: (sessionId: string) => {
-    subscribe(cb: () => void): () => void;
 } | undefined, sessionId: string, cb: () => void): () => void;
 /**
- * Resolve the chat snapshot across the two harness channels: the session-face
- * snapshot first (0.1.1-rc.2 — on 0.1.2-rc.1 the face no longer carries
- * `chat`, so the field reads `undefined`), then the `uiConversation` "chat"
- * view. The view's `getSnapshot()` returns undefined until the named view is
- * registered, so both channels missing degrades to `undefined` (no targets, no
- * hiding — never a crash).
+ * Resolve the chat snapshot from the `uiConversation` "chat" view. The view's
+ * `getSnapshot()` returns undefined until the named view is registered, which
+ * degrades to `undefined` (no targets, no hiding — never a crash).
  */
-export declare function chatSnapshotOf(face: {
-    getSnapshot(): {
-        chat?: unknown;
-    };
-} | undefined, chatView: {
+export declare function chatSnapshotOf(chatView: {
     getSnapshot(): unknown;
 } | undefined): HiddenChat | undefined;
 /**

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

@@ -26,9 +26,27 @@
  *
  * @module dsh-rewind/client
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
 export declare const name = "dsh-rewind";
 export declare const inject: string[];
+/**
+ * The client plugin root context read by `apply(ctx)`. Local structural face:
+ * the harness client context is a cordis `Context` augmented by runtime
+ * services, so the plugin declares the subset it reads. `sessions` is the real
+ * `ISessions` from `@deepseek-ai/dsh-api-session-controller`.
+ */
+export interface ClientContext {
+    effect(execute: () => Iterable<unknown>, label?: string): unknown;
+    locale: {
+        register(namespace: string, messages: Record<string, Record<string, string>>): unknown;
+        bind(namespace: string): (key: string) => string;
+        subscribe(cb: () => void): () => void;
+    };
+    sessions: ISessions;
+    get(name: string): unknown;
+    slots: unknown;
+    commandUi: unknown;
+}
 /**
  * Client plugin body: command decoration + parameterized guard + locale + the
  * portal bridge.

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

@@ -13,8 +13,8 @@
  *
  * @module dsh-rewind/client/popover
  */
-import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
-import type { CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { CommandNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import { type ChatOf, type ChatWatch } from './hidden.ts';
 import type { RewindKey } from './locales.ts';
 type Translate = (key: RewindKey, params?: Record<string, unknown>) => string;
@@ -33,16 +33,15 @@ export interface PopoverOptions {
     readonly onRetract?: () => void;
     readonly preview: string;
     /**
-     * Dual-channel chat reader (0.1.1-rc.2 session face / 0.1.2-rc.1
-     * uiConversation view): the durable variant's command probes scan the chat
-     * through it. Unused by the pending-retract variant.
+     * Chat reader on the 0.1.2-rc.1 `uiConversation` "chat" view: the durable
+     * variant's command probes scan the chat through it. Unused by the
+     * pending-retract variant.
      */
     readonly chatOf: ChatOf;
     /**
      * Subscribe to one session's live chat-update signal, so a probe waiting on
-     * a command's chat node can be woken when the chat snapshot changes (0.1.2-rc.1
-     * the session face no longer fires on a chat update). Passed straight through
-     * to `waitForCommand`.
+     * a command's chat node can be woken when the chat snapshot changes. Passed
+     * straight through to `waitForCommand`.
      */
     readonly watchChat: ChatWatch;
     /** The button that opened the popover (outside-click ignore target). */
@@ -70,7 +69,7 @@ export declare function knownCommandSeqs(session: SessionFace, chatOf: ChatOf, m
  * session snapshot (command/run + command/done land as one CommandNode).
  * @returns the outcome text-bearing node, or null on timeout.
  */
-export declare function waitForCommand(session: SessionFace, chatOf: ChatOf, match: (node: CommandNode) => boolean, timeoutMs?: number, watch?: (cb: () => void) => () => void): Promise<{
+export declare function waitForCommand(session: SessionFace, chatOf: ChatOf, match: (node: CommandNode) => boolean, timeoutMs: number | undefined, watch: (cb: () => void) => () => void): Promise<{
     kind: 'success' | 'error';
     text?: string;
 } | null>;

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

@@ -23,7 +23,7 @@
  * @module dsh-rewind/client/portals
  */
 import { type ReactNode } from 'react';
-import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
 import { type ChatOf, type ChatWatch, type HiddenChat } from './hidden.ts';
 import type { RewindKey } from './locales.ts';
 type Translate = (key: RewindKey, params?: Record<string, unknown>) => string;
@@ -53,26 +53,23 @@ export type PortalTarget = {
 export interface RewindBridgeDeps {
     readonly sessionOf: (sessionId: string) => SessionFace | undefined;
     /**
-     * Dual-channel chat reader (0.1.1-rc.2 session face / 0.1.2-rc.1
-     * uiConversation "chat" view): every chat snapshot read goes through it. See
-     * `chatSnapshotOf` in hidden.ts for the channel precedence.
+     * Chat reader on the 0.1.2-rc.1 `uiConversation` "chat" view: every chat
+     * snapshot read goes through it. See `chatSnapshotOf` in hidden.ts.
      */
     readonly chatOf: ChatOf;
     /**
      * Subscribe to one session's live chat-update signal, so the composer refill
      * waiting on an executed rewind's chat node can be woken when the chat
-     * snapshot changes (0.1.2-rc.1 the session face no longer fires on a chat
-     * update). Passed through to `waitForCommand`.
+     * snapshot changes. Passed through to `waitForCommand`.
      */
     readonly watchChat: ChatWatch;
     readonly currentSessionId: () => string | undefined;
     readonly t: Translate;
     readonly subscribeLocale: (cb: () => void) => () => void;
     /**
-     * Session-aware dual-channel composer writer (see `writeComposer`): the
-     * 0.1.2-rc.1 `conversation.input` facade `setDraft` when reachable, else the
-     * 0.1.1-rc.2/0.1.2-rc.1 DOM fill. Session-scoped so the refill only lands in
-     * the session that just rewound.
+     * Session-aware composer writer (see `writeComposer`): the 0.1.2-rc.1
+     * `conversation.input` facade `setDraft` when reachable, else the DOM fill.
+     * Session-scoped so the refill only lands in the session that just rewound.
      */
     readonly setComposerText: (sessionId: string, text: string) => boolean;
 }
@@ -99,20 +96,18 @@ interface ComposerDraftWriter {
     setDraft(text: string): void;
 }
 /**
- * Fill the dsh composer with `text`. DOM dual-channel fallback: the 0.1.1-rc.2
- * `<textarea>` path, then the 0.1.2-rc.1 `contenteditable` path. Used by
- * `setComposerText` (the harness-facade-aware writer) as the last-resort and
- * by `runRewindAndFill` to put the withdrawn target message back into the
- * composer after a rewind. Best-effort — no composer match means false,
- * never a throw.
+ * Fill the dsh composer with `text` through the 0.1.2-rc.1 `contenteditable`
+ * DOM path. Used by `setComposerText` (the harness-facade-aware writer) as the
+ * last-resort and by `runRewindAndFill` to put the withdrawn target message
+ * back into the composer after a rewind. Best-effort — no composer match means
+ * false, never a throw.
  */
 export declare function fillComposer(text: string): boolean;
 /**
- * Dual-channel composer write, mirroring `chatSnapshotOf`: prefer the harness
- * facade's `setDraft` (0.1.2-rc.1, correct whole-draft replace), then degrade
- * to the DOM `fillComposer` (0.1.1-rc.2 textarea / 0.1.2-rc.1 contenteditable).
- * A facade that throws (session teardown) is treated as absent so the DOM path
- * still restores the text. Never throws.
+ * Composer write: prefer the harness facade's `setDraft` (0.1.2-rc.1, correct
+ * whole-draft replace), then degrade to the DOM `fillComposer` (0.1.2-rc.1
+ * contenteditable). A facade that throws (session teardown) is treated as
+ * absent so the DOM path still restores the text. Never throws.
  * @param text - the withdrawn target message text.
  * @param facade - the 0.1.2-rc.1 session input draft writer, when reachable.
  * @returns whether a channel applied the text.
@@ -136,24 +131,15 @@ export declare function runRewindAndFill(session: SessionFace, seq: number, mode
  * Locate the actions container of a user/steering seat row — the element the
  * ↶ button portals into (the copy/branch IconActions row).
  *
- * @dualmode 0.1.1-rc.2 ↔ 0.1.2-rc.1
- * - 0.1.1-rc.2: the hover-reveal root is attribute-marked
- *   `[data-time-hover-root]` and mounts the actions row as its LAST child. A
- *   pending row IS that root; a durable row CONTAINS it as a descendant.
- * - 0.1.2-rc.1: the marker was removed from user rows (it now lives only on the
- *   per-turn tail footer, `TurnTailNodeView`), and the user action row is
- *   revealed via CSS `:has()`. The container is instead located structurally:
- *   the direct holder of the copy `<button>` (the `MessageIconActions`
- *   container, which mounts that button as a direct child —
- *   `MessageIconActions.tsx:83,86`).
- *
- * The 0.1.2-alpha.2/3 `[data-actions-reveal]` attribute-marked rows (see
- * `ACTIONS_ROOT_SELECTOR`) are an intermediate state absorbed by the
- * attribute branch below; they are not needed by either endpoint.
+ * On the 0.1.2-rc.1 line the `data-time-hover-root` marker lives only on the
+ * per-turn tail footer (`TurnTailNodeView`), and the user action row is
+ * revealed via CSS `:has()`. The container is located structurally: the direct
+ * holder of the copy `<button>` (the `MessageIconActions` container, which
+ * mounts that button as a direct child — `MessageIconActions.tsx:83,86`).
  *
  * Returns undefined when no qualifying container is found; the caller refuses
  * to portal (never a crash, never a wrong attachment). Exported as a test seam
- * (see `collectTargets`) so the dual-channel finder is exercised directly for
+ * (see `collectTargets`) so the row-shape finder is exercised directly for
  * both durable and pending row shapes without a full React portal render.
  */
 export declare function actionsContainerOf(row: HTMLElement | undefined): HTMLElement | undefined;
@@ -174,10 +160,9 @@ interface RewindPortalsProps extends RewindBridgeDeps {
  * synchronous full-transcript scan inside a commit microtask.
  */
 export declare function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, watchChat, t, subscribeLocale, setComposerText }: RewindPortalsProps): ReactNode;
-/** The current composer draft, on whichever channel: 0.1.1-rc.2 textarea
- * `.value`, 0.1.2-rc.1 contenteditable `textContent`. Empty when the composer
- * is absent. Exported as a test seam (the empty-composer guard in
- * `retractPending`). */
+/** The current composer draft: the 0.1.2-rc.1 contenteditable `textContent`.
+ * Empty when the composer is absent. Exported as a test seam (the
+ * empty-composer guard in `retractPending`). */
 export declare function composerText(): string;
 /**
  * Build the slot-entry component for the plugin apply(): a tiny bridge that

package/lib/types/client/settings-card.d.ts

@@ -12,10 +12,9 @@
  *
  * It neither imports the client settings typed contract nor depends on the
  * 0.1.2-rc.1-only `mutate` write API: it reads `getSnapshot().value` and writes
- * via the `set(field, value)` method present on both 0.1.1-rc.2 and 0.1.2-rc.1,
- * and the card receives a tiny structural `CleanupCardApi` supplied by
- * `src/client/index.ts` so the component stays harness-agnostic and
- * unit-testable in isolation.
+ * via the `set(field, value)` method, and the card receives a tiny structural
+ * `CleanupCardApi` supplied by `src/client/index.ts` so the component stays
+ * harness-agnostic and unit-testable in isolation.
  *
  * @module dsh-rewind/client/settings-card
  */

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

@@ -23,4 +23,4 @@ export declare const CLASS: {
 /** The ↶ glyph, drawn inline so the bundle stays dependency-free. */
 export declare const REWIND_ICON_SVG: string;
 /** One injected stylesheet (scoped under `.dsh-rewind-*`). */
-export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: 28px;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Snapshot-cleanup settings card (mirrors the harness PluginCard look) ---- */\n/* Dual-channel note: the harness card corner/border drifted across versions \u2014\n   0.1.1-rc.2 uses border-radius 12px + 1px solid border-l2, while 0.1.2-rc.1\n   uses 16px + 0.5px border-l4 (and adds corner-shape: round). We intentionally\n   keep the 0.1.1-rc.2 values here for now; if the 0.1.2-rc.1 look is wanted,\n   switch these on the host version like the other dual-channel surfaces (see the\n   host-version probe in src/client/index.ts). */\n.dsh-rewind-cleanup-card {\n  list-style: none;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-alias-bg-layer-3);\n  transition: border-color .16s, background .16s;\n}\n.dsh-rewind-cleanup-card:hover {\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-card-open {\n  background: var(--dsw-alias-bg-layer-2);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-header {\n  width: 100%;\n  appearance: none;\n  border: 0;\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  cursor: pointer;\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 14px 16px;\n  border-radius: 12px;\n}\n.dsh-rewind-cleanup-header:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: -2px;\n}\n.dsh-rewind-cleanup-head-text {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.dsh-rewind-cleanup-name {\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-desc {\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-chevron {\n  flex: none;\n  color: var(--dsw-alias-label-tertiary);\n  transition: transform .16s;\n}\n.dsh-rewind-cleanup-chevron-open {\n  transform: rotate(180deg);\n}\n.dsh-rewind-cleanup-pending {\n  flex: none;\n  border-radius: 999px;\n  padding: 1px 8px;\n  font-size: 11px;\n  line-height: 17px;\n  font-weight: 500;\n  white-space: nowrap;\n  background: var(--dsw-alias-bg-module-platform);\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-body {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n  margin: 0 16px;\n  padding: 4px 0 8px;\n}\n.dsh-rewind-cleanup-readonly {\n  margin: 12px 0 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-permission {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field + .dsh-rewind-cleanup-field {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-rewind-cleanup-label {\n  flex: 1;\n  min-width: 0;\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-error {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n/* Switch row: label left, role=switch button right, hint below (Subagent module). */\n.dsh-rewind-cleanup-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-cleanup-switch {\n  box-sizing: border-box;\n  position: relative;\n  flex: 0 0 auto;\n  width: 36px;\n  height: 20px;\n  padding: 2px;\n  border: 0;\n  border-radius: 10px;\n  background: var(--dsw-alias-border-l3);\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-switch-on {\n  background: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-switch:disabled {\n  cursor: default;\n  opacity: 0.5;\n}\n.dsh-rewind-cleanup-switch:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 2px;\n}\n.dsh-rewind-cleanup-thumb {\n  display: block;\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  corner-shape: round;\n  background: var(--dsw-alias-label-primary-foreground);\n  transition: transform 120ms ease;\n}\n.dsh-rewind-cleanup-switch-on .dsh-rewind-cleanup-thumb {\n  transform: translateX(16px);\n}\n.dsh-rewind-cleanup-input {\n  box-sizing: border-box;\n  height: 34px;\n  padding: 0 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-input:focus-visible {\n  outline: none;\n  border-color: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-input:disabled {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n.dsh-rewind-cleanup-input-invalid {\n  border-color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-failed {\n  flex: 1;\n  min-width: 0;\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-discard,\n.dsh-rewind-cleanup-save {\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  padding: 5px 14px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-discard {\n  border-color: var(--dsw-alias-border-l2);\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-discard:hover:not(:disabled) {\n  color: var(--dsw-alias-label-primary);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-save {\n  background: var(--dsw-alias-label-primary);\n  color: var(--dsw-alias-bg-layer-3);\n}\n.dsh-rewind-cleanup-discard:disabled,\n.dsh-rewind-cleanup-save:disabled {\n  opacity: 0.4;\n  cursor: default;\n}\n.dsh-rewind-cleanup-discard:focus-visible,\n.dsh-rewind-cleanup-save:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 1px;\n}\n";
+export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: 28px;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Snapshot-cleanup settings card (mirrors the harness PluginCard look) ---- */\n/* Standardized on the 0.1.2 harness card look (border-radius 16px + 0.5px\n   border-l4, 0.5px internal separators). */\n.dsh-rewind-cleanup-card {\n  list-style: none;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: 16px;\n  background: var(--dsw-alias-bg-layer-3);\n  transition: border-color .16s, background .16s;\n}\n.dsh-rewind-cleanup-card:hover {\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-card-open {\n  background: var(--dsw-alias-bg-layer-2);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-header {\n  width: 100%;\n  appearance: none;\n  border: 0;\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  cursor: pointer;\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 14px 16px;\n  border-radius: 12px;\n}\n.dsh-rewind-cleanup-header:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: -2px;\n}\n.dsh-rewind-cleanup-head-text {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.dsh-rewind-cleanup-name {\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-desc {\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-chevron {\n  flex: none;\n  color: var(--dsw-alias-label-tertiary);\n  transition: transform .16s;\n}\n.dsh-rewind-cleanup-chevron-open {\n  transform: rotate(180deg);\n}\n.dsh-rewind-cleanup-pending {\n  flex: none;\n  border-radius: 999px;\n  padding: 1px 8px;\n  font-size: 11px;\n  line-height: 17px;\n  font-weight: 500;\n  white-space: nowrap;\n  background: var(--dsw-alias-bg-module-platform);\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-body {\n  border-top: 0.5px solid var(--dsw-alias-border-l2);\n  margin: 0 16px;\n  padding: 4px 0 8px;\n}\n.dsh-rewind-cleanup-readonly {\n  margin: 12px 0 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-permission {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field + .dsh-rewind-cleanup-field {\n  border-top: 0.5px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-rewind-cleanup-label {\n  flex: 1;\n  min-width: 0;\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-error {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n/* Switch row: label left, role=switch button right, hint below (Subagent module). */\n.dsh-rewind-cleanup-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-cleanup-switch {\n  box-sizing: border-box;\n  position: relative;\n  flex: 0 0 auto;\n  width: 36px;\n  height: 20px;\n  padding: 2px;\n  border: 0;\n  border-radius: 10px;\n  background: var(--dsw-alias-border-l3);\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-switch-on {\n  background: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-switch:disabled {\n  cursor: default;\n  opacity: 0.5;\n}\n.dsh-rewind-cleanup-switch:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 2px;\n}\n.dsh-rewind-cleanup-thumb {\n  display: block;\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  corner-shape: round;\n  background: var(--dsw-alias-label-primary-foreground);\n  transition: transform 120ms ease;\n}\n.dsh-rewind-cleanup-switch-on .dsh-rewind-cleanup-thumb {\n  transform: translateX(16px);\n}\n.dsh-rewind-cleanup-input {\n  box-sizing: border-box;\n  height: 34px;\n  padding: 0 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-input:focus-visible {\n  outline: none;\n  border-color: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-input:disabled {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n.dsh-rewind-cleanup-input-invalid {\n  border-color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-failed {\n  flex: 1;\n  min-width: 0;\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-discard,\n.dsh-rewind-cleanup-save {\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  padding: 5px 14px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-discard {\n  border-color: var(--dsw-alias-border-l2);\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-discard:hover:not(:disabled) {\n  color: var(--dsw-alias-label-primary);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-save {\n  background: var(--dsw-alias-label-primary);\n  color: var(--dsw-alias-bg-layer-3);\n}\n.dsh-rewind-cleanup-discard:disabled,\n.dsh-rewind-cleanup-save:disabled {\n  opacity: 0.4;\n  cursor: default;\n}\n.dsh-rewind-cleanup-discard:focus-visible,\n.dsh-rewind-cleanup-save:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 1px;\n}\n";

package/lib/types/index.d.ts

@@ -4,11 +4,17 @@
  * lives in `src/client/`).
  *
  * Rewind mechanism: planning is pure (`src/rewind.ts`); execution appends a
- * marker `assistant/message` into the session log whose `surfaceOp` replaces
- * every surface node after the target message with the marker. The
- * append-only log (and the rendered transcript) is untouched — only the
- * model-visible surface is cut, so the next request derives its context from
- * the target onward.
+ * marker `user/message` into the session log whose `surfaceOp` replaces every
+ * surface node after the target message with the marker. The append-only log
+ * (and the rendered transcript) is untouched — only the model-visible surface
+ * is cut, so the next request derives its context from the target onward.
+ * The marker is an EMPTY `user/message`: v2 reserves surface `replace` to a
+ * node that cites every shadowed seq (`sourceEventSeqs`), and
+ * `assistant/message` can no longer carry those — so the replacement node is
+ * a `user/message`, exactly as /compact's checkpoint is. An empty
+ * `user/message` derives to itself (a present-but-empty user turn), so the
+ * marker stays as the surface-tail cut point rather than vanishing.
+ *
  *
  * File restore (mode `both`) follows Claude Code's checkpointing: the plugin
  * backs up each tracked write-class edit BEFORE it happens (at the

package/lib/types/locales.d.ts

@@ -69,6 +69,25 @@ export declare const en: {
     'cleanup.clearCancelled': string;
     'cleanup.clearFailed': string;
     'cleanup.usage': string;
+    'rewindfix.description': string;
+    'rewindfix.inputHint': string;
+    'rewindfix.dryRun': string;
+    'rewindfix.done': string;
+    'rewindfix.cancelled': string;
+    'rewindfix.launcherGuard': string;
+    'rewindfix.counts': string;
+    'rewindfix.writeOk': string;
+    'rewindfix.skip.loaded': string;
+    'rewindfix.skip.noMarkers': string;
+    'rewindfix.skip.noArtifact': string;
+    'rewindfix.skip.loadedNow': string;
+    'rewindfix.fail.unreadable': string;
+    'rewindfix.fail.repair': string;
+    'rewindfix.fail.locked': string;
+    'rewindfix.fail.generic': string;
+    'rewindfix.persistenceUnavailable': string;
+    'rewindfix.sessionStoreUnavailable': string;
+    'rewindfix.locked': string;
 };
 /** The host rewind dictionary key union. */
 export type HostKey = keyof typeof en;

package/lib/types/rewind-fix.d.ts

@@ -0,0 +1,109 @@
+/**
+ * `/dsh-rewind-fix` — orchestration layer.
+ *
+ * This module owns the COMMAND semantics and the per-session repair pipeline. It
+ * intentionally does NOT re-implement the physical codec (`./session-log-io.ts`)
+ * or the A/B→C transform (`./rewind-marker-repair.ts`); it wires those against
+ * the harness's own session services (read path = `sessionPersistence` +
+ * `ctx.sessions`; write path = self-contained 2-frame zstd rewrite + atomic
+ * tmp+rename, because the persistence layer is append-only & repairing a log
+ * must rewrite non-tail events).
+ *
+ * Safety model (settled in the design):
+ *   - Only NON-loaded (closed) sessions are repaired. "Loaded" = the harness has
+ *     the session's in-memory `this.log`, which is the seq authority — rewriting
+ *     that session's file would fork it.
+ *   - Per-session `.lock` (O_EXCL) guards against two tabs/processes fixing the
+ *     same closed session concurrently.
+ *   - Each repair is backed up and rolled back on write/verify failure; an
+ *     interrupted run is idempotent (already-C / marker-free sessions are no-ops).
+ *   - Repaired sessions have their snapshots cleared via `store.clearSession`.
+ *
+ * There is no streaming progress channel (`CommandResult` returns once), so the
+ * command is "dry wait" like `/compact`: the client is told it takes minutes and
+ * a single final summary is returned via `command/done`.
+ *
+ * {@link runRewindFix} is the DOMAIN core: it returns structured data (not a
+ * rendered string) over a narrow deps interface, so it is unit-testable without a
+ * real cordis `Context` and stays locale-agnostic. `renderRewindFixReport`
+ * renders that data through the plugin's locale translator `t`, and
+ * `registerRewindFix` adapts a real `Context` + `SnapshotStore` + renderer and
+ * registers the command.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionHeader, SessionId } from '@deepseek-ai/dsh-session';
+/** A locale renderer: dictionary key + optional `{name}` params → text. */
+export type RenderFn = (key: string, params?: Record<string, string | number>) => string;
+/** Structural view of the snapshot store the repair needs (`clearSession` only). */
+interface SnapshotStoreLike {
+    clearSession(sessionId: string): Promise<unknown>;
+}
+/** The narrow dependency set {@link runRewindFix} needs (injected; unit-testable). */
+export interface RewindFixDeps {
+    listSnapshots(signal?: AbortSignal): Promise<Array<{
+        header: SessionHeader;
+    }>>;
+    readRaw(id: SessionId, signal?: AbortSignal): Promise<{
+        content: string;
+    } | undefined>;
+    locate(header: SessionHeader): {
+        path: string;
+    } | undefined;
+    isSessionLoaded(id: SessionId): boolean;
+    clearSession(id: string): Promise<unknown>;
+}
+export interface RewindFixOptions {
+    /** `--apply` executes the repair; otherwise dry run (no writes). */
+    apply: boolean;
+    /** The launcher session itself needs repair (guard warning). */
+    launcherHasMarkers: boolean;
+    signal?: AbortSignal;
+    /**
+     * Max sessions processed concurrently. Sessions are independent files, so a
+     * bounded pool overlaps zstd decode/encode across them (the dominant cost).
+     * Default 4; capped by the session count. Higher means more peak memory.
+     */
+    concurrency?: number;
+}
+/** Why a session was skipped or failed (drives the localized label). */
+export type OutcomeReason = 'loaded' | 'no-markers' | 'no-artifact' | 'loaded-between' | 'unreadable' | 'repair' | 'locked';
+/** One per-session outcome, carried into the report. */
+export interface SessionOutcome {
+    readonly id: string;
+    readonly status: 'repaired' | 'skipped' | 'failed';
+    readonly a: number;
+    readonly b: number;
+    readonly c: number;
+    readonly reason?: OutcomeReason;
+    readonly error?: string;
+}
+/** Structured result of {@link runRewindFix} (locale-agnostic, unit-testable). */
+export interface RewindFixResult {
+    readonly launcherHasMarkers: boolean;
+    readonly cancelled: boolean;
+    readonly scanned: number;
+    readonly durationMs: number;
+    readonly apply: boolean;
+    readonly sessions: SessionOutcome[];
+}
+/**
+ * Register the `/dsh-rewind-fix` host command. `store` must be the plugin's
+ * `SnapshotStore` so repaired sessions get their snapshots cleared; `render` is
+ * the plugin's locale translator.
+ */
+export declare function registerRewindFix(ctx: Context, store: SnapshotStoreLike, render: RenderFn): void;
+/**
+ * The domain core. Enumerates all persisted sessions, applies the safety rules,
+ * repairs each marker-bearing CLOSED session, and returns structured outcome
+ * data. It never throws: every per-session failure is recorded and the run
+ * continues (idempotent; a rollback restores the original artifact).
+ */
+export declare function runRewindFix(deps: RewindFixDeps, opts: RewindFixOptions): Promise<RewindFixResult>;
+/**
+ * Render a {@link RewindFixResult} through the locale translator. The RESULT
+ * headline is the FIRST line (so the client card's single-line collapsed
+ * summary shows it), followed by the per-session detail lines (shown when the
+ * card is expanded).
+ */
+export declare function renderRewindFixReport(result: RewindFixResult, render: RenderFn): string;
+export {};

package/lib/types/rewind-marker-repair.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Pure repair core for legacy rewind markers.
+ *
+ * The `/dsh-rewind-fix` command rewrites the OLD plugin's rewind marker — a
+ * bare `assistant/message(turn=N, step=0)` (form A) or a ghost-frame
+ * `[step/start][assistant/message][step/end]` inside a closed turn (form B) —
+ * into the CURRENT marker shape (form C): an empty-content `user/message` whose
+ * `source` cites the plugin and whose `surfaceOp`/`sourceEventSeqs` still carry
+ * the surface replace. Form C is what a 0.1.3 harness accepts.
+ *
+ * This module is PURE: it only recognizes event shapes and rewrites them. It
+ * does zero IO and has no dependency on the harness session services. The
+ * session-log IO layer (read/write) and the command orchestration live
+ * elsewhere; here we export the transform plus the shared C-marker contract so
+ * the running plugin and the repair agree on the exact marker data shape.
+ *
+ * Correctness contract:
+ *   - A → C is an in-place retype (seq does NOT shift).
+ *   - B → C deletes the two ghost `step/start`/`step/end` events AND re-denses
+ *     every surviving event's `seq`, so the whole log is one global compaction —
+ *     the same mechanism DSH's own compaction/forward-migration uses.
+ *   - Every reference (surfaceOp/sourceEventSeqs/data.*) is rewritten through a
+ *     single `oldSeq → newSeq` map, because deleting frames shifts every later
+ *     event and a later marker's references may cite an earlier marker's seq.
+ *   - A marker that survives is retargeted to form C and participates in the
+ *     renumbering, so references INTO it follow the map too.
+ *
+ * The transform never mutates its inputs: input events are copied and the
+ * mutable reference fields are rebuilt onto fresh objects (a decoded event's
+ * `data` is deep-frozen, so mutating a range in place would throw).
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { ContentBlock } from '@deepseek-ai/dsh-llm';
+/** The rewind-marker source the current plugin writes (form C contract). */
+export declare const REWIND_MARKER_SOURCE: {
+    readonly kind: 'plugin';
+    readonly plugin: 'dsh-rewind';
+};
+/** The rewind-marker message content: empty (closest to "invisible"). */
+export declare const REWIND_MARKER_CONTENT: readonly ContentBlock[];
+/**
+ * Build the form-C marker `data` (the `user/message` payload). When `id` is
+ * supplied it is preserved verbatim (the repair keeps the original marker's
+ * `message.id`); when omitted a fresh id is generated so the running plugin can
+ * reuse this contract for its live `buildMarker()`.
+ */
+export declare function buildRewindMarkerData(id?: string): Record<string, unknown>;
+/** The surface `replace` op carried by a rewind marker. */
+export interface ReplaceSurfaceOp {
+    op: 'replace';
+    start: number;
+    end: number;
+}
+/** Type guard for the surface `replace` op. */
+export declare function isReplaceSurfaceOp(value: unknown): value is ReplaceSurfaceOp;
+/** Is `event` a legacy rewind marker in either form A or B? */
+export declare function isLegacyRewindMarker(event: Readonly<SessionEvent>): boolean;
+/** Is `event` already a form-C rewind marker? (the target shape) */
+export declare function isFormCMarker(event: Readonly<SessionEvent>): boolean;
+/** Result of {@link repairRewindMarkers}. */
+export interface RepairOutput {
+    /** The repaired events, densely seq'd, in log order. */
+    events: SessionEvent[];
+    /** original event seq → new dense seq for every SURVIVING event. */
+    mapSeq: ReadonlyMap<number, number>;
+    /** Per-form counts observed in the repaired run. */
+    stats: {
+        a: number;
+        b: number;
+        c: number;
+        removedGhosts: number;
+    };
+}
+/**
+ * Rewrite any number of stacked rewind markers (forms A and B, interleaved)
+ * into form C in one global compaction.
+ *
+ * @param input - the decoded event list, in log order. Not mutated.
+ * @returns the repaired event list, the oldSeq→newSeq map, and per-form counts.
+ * @throws {Error} when a surviving reference points at a seq that was consumed
+ *   (a removed ghost frame); failing closed avoids writing a corrupt log.
+ */
+export declare function repairRewindMarkers(input: ReadonlyArray<SessionEvent | unknown>): RepairOutput;