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

package/lib/types/rewind.d.ts

@@ -9,23 +9,22 @@
  * transcript) is untouched; only the model-visible surface is cut, so the
  * next request derives its context from the target message onward.
  *
- * Marker shape (v0.3.4+): the marker is an EMPTY `assistant/message` with a
- * replace `surfaceOp`, wrapped in its own step frame —
+ * Marker shape (v0.1.3/v2): the marker is an EMPTY `user/message` carrying a
+ * replace `surfaceOp` — a single event:
  *
- *   step/start (turn, step) → assistant/message (marker) → step/end (turn, step)
+ *   user/message (marker, empty content) → { surfaceOp {replace, start, end} }
  *
- * The step frame exists because the harness token-meter replays the log and
- * requires every `assistant/message` to sit inside an OPEN step whose
- * `(turn, step)` matches exactly (`token meter: assistant/message at seq N
- * has no matching step/start event` otherwise) — a bare marker appended while
- * idle (every step already closed) makes every later measure() call throw,
- * which disables /compact and automatic compaction. The frame's `turn` is the
- * LAST STARTED turn (`markerTurnOf`) and `step` is that turn's next unused
- * step number (`markerStepOf`): never a reused one, or the client
- * conversation assembler sees a duplicate `step/start` and rejects the log
- * with "received more than one start Match". The agent loop numbers its own
- * steps from memory (each new turn restarts at 1), so the ghost step can
- * never collide with a future real step.
+ * v2 reserves surface `replace` to a node that cites every shadowed seq via
+ * `sourceEventSeqs`, and `assistant/message` can no longer carry
+ * `sourceEventSeqs` (it now embeds its provider stream instead) — so the
+ * replacement node must be a `user/message`, exactly as /compact's checkpoint
+ * is. No ghost `step/start`…`step/end` frame is needed: the token-meter's
+ * step state machine ignores `user/message`, and the session invariant
+ * (`invariant.ts`) imposes no open-turn requirement on it, so the marker is
+ * appended while idle, outside any turn. The empty content means the marker
+ * carries no language; it sits at the surface tail as the model-visible
+ * "cut point" (an empty `user/message` derives to itself, so it remains a
+ * present-but-empty user turn in derived history).
  *
  * @module dsh-rewind/rewind
  */
@@ -85,48 +84,6 @@ export declare const CANDIDATE_PREVIEW_CHARS = 80;
  * still pass an explicit `limit`.
  */
 export declare const DEFAULT_CANDIDATE_LIMIT = 100;
-/**
- * Turn number for the rewind marker.
- *
- * The marker MUST NOT reuse the harness's next-turn number. The agent loop
- * numbers its next real turn `lastTurn/start + 1` (dsh-agent-loop), so a
- * marker numbered `maxTurn + 1` collides: the log then holds an
- * `assistant/message` (the marker) BEFORE the `turn/start` of the same turn,
- * and the client conversation-context builder rejects that ordering with
- * `conversation Context …:turn-tail… received an update before its start
- * Match` — history load fails and the whole conversation disappears from the
- * UI (reproduced across real sessions).
- *
- * The marker therefore reuses the LAST STARTED turn's number: the harness has
- * already consumed it (its next turn is strictly larger), so it can never be
- * reused by a future `turn/start`, and the marker lands as a harmless
- * trailing update on that turn's already-closed tail context (its `turn/end`
- * is already matched) — no new context, no reordering, nothing rendered, and
- * the empty content still derives to `null` in the model context.
- *
- * @param events - the full session event log.
- * @returns a turn number the harness can never reuse for a future `turn/start`.
- */
-export declare function markerTurnOf(events: readonly SessionEvent[]): number;
-/**
- * Step number for the rewind marker's ghost step frame.
- *
- * The marker's `assistant/message` must be wrapped in `step/start` …
- * `step/end` of the SAME `(turn, step)` so the harness token-meter replay
- * accepts it (see the module doc). The step number MUST be a step this turn
- * has never started: the client conversation assembler treats `step/start`
- * as the start of an `assistant-step` context keyed `turn:step`, so reusing
- * an already-started step number makes the log replay throw "received more
- * than one start Match" and the history disappears from the UI. Reusing
- * `lastStep + 1` is always safe: the harness numbers a turn's steps from
- * memory (each new turn restarts at 1), so the ghost step can never collide
- * with a future real step of this turn.
- *
- * @param events - the full session event log.
- * @param turn - the marker's turn (normally `markerTurnOf(events)`).
- * @returns the smallest step number this turn has never started (≥ 1).
- */
-export declare function markerStepOf(events: readonly SessionEvent[], turn: number): number;
 /** Narrow an event to a user message. */
 export declare function isUserMessageEvent(event: SessionEvent): event is SessionEvent<'user/message'>;
 /**

package/lib/types/session-log-io.d.ts

@@ -0,0 +1,57 @@
+import { type SessionEvent } from '@deepseek-ai/dsh-session';
+/** A complete frame's byte range within a buffer. */
+export interface ZstdFrameRange {
+    start: number;
+    end: number;
+}
+/** Result of scanning a buffer for complete zstd frames. */
+export interface ZstdFrameScan {
+    frames: ZstdFrameRange[];
+    /** Offset of an incomplete trailing frame, or undefined when the buffer is whole. */
+    tornStart?: number;
+}
+/**
+ * Scan a buffer for structurally complete Zstandard frames (mirrors DSH
+ * `scanZstdFrames`). A trailing incomplete frame is reported as `tornStart`
+ * and omitted from `frames`.
+ */
+export declare function scanZstdFrames(buffer: Buffer): ZstdFrameScan;
+/**
+ * Compress one independently decodable, checksummed Zstandard frame (mirrors DSH
+ * `compressZstdFrame`). Async so it runs on libuv's threadpool and does not
+ * block the event loop, letting a concurrency pool overlap compression across
+ * sessions.
+ */
+export declare function compressZstdFrame(input: Buffer | string): Promise<Buffer>;
+/** Decompress one complete Zstandard frame (validates its checksum). Async (threadpool). */
+export declare function decompressZstdFrame(input: Buffer): Promise<Buffer>;
+/** Decode a concatenated multi-frame zstd buffer to plaintext (async, threadpool). Frames are
+ * decoded in bounded parallel batches (a large log can have tens of thousands of frames). */
+export declare function decodeZstd(buffer: Buffer): Promise<string>;
+/** One complete session plaintext split into its header line and event body. */
+export interface SplitSession {
+    /** The first line (a `type:'session'` record) WITHOUT its trailing newline. */
+    headerLine: string;
+    /** Every event row, newline-separated, after the header line. */
+    body: string;
+}
+/** Split a session plaintext into an independent header line and the event body. */
+export declare function splitSession(plaintext: string): SplitSession;
+/**
+ * Decode a JSONL event body into logical {@link SessionEvent}s. Layout-blind:
+ * packed chunk rows and per-line rows both decode; range-encoded provenance is
+ * expanded. This is the read-side counterpart that consumes the body that
+ * `sessionPersistence.readRaw(id)` produced.
+ */
+export declare function decodeEventBody(body: string): SessionEvent[];
+export interface EncodeOptions {
+    /** Pack delta-chunk runs into storage rows (lossless, ~60% smaller). Default true. */
+    readonly packChunks?: boolean;
+}
+/**
+ * Encode a header line + events into a 2-frame Zstandard buffer (mirrors DSH
+ * `encodePhysicalJsonl`): the header is its OWN frame, the body its own.
+ * @param headerLine - the header JSON text, no trailing newline.
+ * @param events - the repaired event list in log order.
+ */
+export declare function encodeSessionLog(headerLine: string, events: readonly SessionEvent[], options?: EncodeOptions): Promise<Buffer>;

package/lib/types/snapshot-cleanup.d.ts

@@ -46,9 +46,9 @@ export declare const CleanupConfigSchema: z<CleanupConfig>;
 /**
  * Structural face of the settings scope the host needs for the policy: a
  * resolved read and a validated write. Kept local (never imports the settings
- * contract) so the host bundle links on both 0.1.1-rc.2 and 0.1.2-rc.1 — the
- * settings API drift (0.1.2 adds `mutate`, 0.1.1 does not) is confined to the
- * seam the host passes in, never to this module.
+ * contract) so the host bundle does not type-couple on the client settings
+ * API (0.1.2 adds `mutate`; it is unused here), and the seam the host passes
+ * in isolates the drift to this module.
  */
 export interface CleanupSettingsScope {
     /** The resolved policy: schema defaults, then base, then the user layer. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.7.5",
+  "version": "0.9.0-alpha.1",
   "description": "DSH 插件：真正便捷无感的同窗口内对话回退，从不新建分支；自带轻量工作区备份，可一并还原文件（完整 Claude Code /rewind 语义）。 · DSH plugin: genuinely effortless in-window conversation rewind — never forking a new session; ships a lightweight workspace backup that restores files together with the rewind (full Claude Code /rewind semantics).",
   "keywords": [
     "deepseek-harness",
@@ -52,7 +52,6 @@
     "client": {
       "inject": [
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-commands",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings"
@@ -74,19 +73,18 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6 || ^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-fs": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -98,9 +96,6 @@
     "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-client-ui-commands": {
       "optional": true
     },
@@ -138,29 +133,37 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-command-compact": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-compaction-basic": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-goal": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-plan-mode": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-stats": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-token-meter": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-questions": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-command-compact": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-compaction-basic": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-goal": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-stats": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.31",
     "@types/react-dom": "^18.3.7",

package/docs/compat/troubleshooting.md

@@ -1,41 +0,0 @@
-# Troubleshooting
-
-[简体中文](troubleshooting.zh.md)
-
-## History load failure: `…turn-tail… received an update before its start Match`
-
-Rewinds from `≤ 0.2.4` collided with the next real turn's `turn/start`, so reopening the session showed
-
-```
-Failed to load history: conversation Context …:turn-tail… received an update before its start Match (internal)
-```
-
-and the history vanished. Rewinds from `0.2.5` on no longer collide; already-corrupted sessions need an offline repair (the log is append-only). The repair tool (`dsh-rewind-repair`) is no longer shipped from v0.4.0 — install a pre-v0.4.0 release to get it (fully quit dsh web / host first, then):
-
-```sh
-npm exec --yes --package=dsh-rewind-plugin@0.3.3 -- dsh-rewind-repair
-npm exec --yes --package=dsh-rewind-plugin@0.3.3 -- dsh-rewind-repair -- --dry-run  # preview only
-```
-
-It only rewrites the marker events' `data.turn` (seqs, order, and zstd frame structure intact) and backs up the original file before writing — safe to run repeatedly. From a source checkout of a pre-v0.4.0 tag: `node scripts/repair-markers.mjs` (identical flags).
-
-## Known compatibility boundaries
-
-Behavioral notes — none of these is a crash — verified by the compatibility
-probe suites; the audit [audit.md](audit.md) is the source of truth and lists
-the probes that pin each one:
-
-- Session stats / telemetry do **not** roll back with a rewind.
-- Withdrawn messages stay **searchable and exported** (`/export` and full-text
-  search read the raw log).
-- Session titles may **regenerate** (title derives from the current surface).
-- Files written by a **cancelled tool call** (write happened, no snapshot
-  commit) cannot be restored by "conversation and code".
-
-**R-OPENSTEP** (harness-side, plugin does not guard): a session log carrying an
-*unclosed* `step/start` (a crash before the agent loop's `finally` closed the
-step) makes later step activity break token-meter replay, so `/compact` can
-fail after a rewind. Harness `0.1.1-rc.2` fixes the crash path on load
-(`interruptedTurnClosers`); a plugin-side up-front rejection was tried and
-**reverted** (`177ec14`, false positives on real logs). Deep analysis:
-[audit.md](audit.md) → R-OPENSTEP.

package/docs/compat/troubleshooting.zh.md

@@ -1,29 +0,0 @@
-# 故障修复
-
-[English](troubleshooting.md)
-
-## 历史加载失败：`…turn-tail… received an update before its start Match`
-
-0.2.4 及之前版本的回退与下一条真实回合的 `turn/start` 撞号，重开会话时历史整段消失。0.2.5 起的新回退不再产生该冲突；**已损坏的旧会话需离线修复**（日志是 append-only 的）。修复工具（`dsh-rewind-repair`）v0.4.0 起不再随包提供——安装 v0.4.0 之前的版本即可获取（先完全退出 dsh web / host，然后）：
-
-```sh
-npm exec --yes --package=dsh-rewind-plugin@0.3.3 -- dsh-rewind-repair
-npm exec --yes --package=dsh-rewind-plugin@0.3.3 -- dsh-rewind-repair -- --dry-run  # 只预览不写盘
-```
-
-工具只改写标记事件的 `data.turn`（保持 seq / 顺序 / zstd 帧结构不变），改前自动备份原文件——可安全重复运行。源码方式：v0.4.0 之前的 tag 下 `node scripts/repair-markers.mjs`（参数相同）。
-
-## 已知兼容边界
-
-以下均为**预期行为而非崩溃**（探针钉住，完整依据见 [audit.md](audit.md) 事实源）：
-
-- 会话统计 / 遥测**不回退**（折叠的是完整日志）；
-- 被撤回的消息**仍可搜索、可导出**（`/export` 与全文搜索基于原始日志）；
-- 会话标题可能**重新生成**（标题由当前 surface 派生）；
-- 被**取消的工具调用**写入的文件（无快照提交）无法由「回退对话和代码」恢复。
-
-**R-OPENSTEP**（harness 侧，插件不设守卫）：日志中存在*未闭合* `step/start`
-（agent 循环的 `finally` 闭合 step 前崩溃）时，后续 step 活动会破坏 token-meter
-重放，回退后 `/compact` 可能报错。harness `0.1.1-rc.2` 已在加载时自动闭合
-（`interruptedTurnClosers`）；插件曾实现前置拒绝但已回退（`177ec14`，真实日志
-误判）。深入分析：[audit.md](audit.md) → R-OPENSTEP。

package/lib/types/session-events.d.ts

@@ -1,37 +0,0 @@
-/**
- * Cross-channel session event-log reader.
- *
- * This is a "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual-channel reader. Harness 0.1.1-rc.2
- * exposes the full log as `Session.events` (`get events(): readonly
- * SessionEvent[]`); the 0.1.2 line (alpha.4+, now 0.1.2-rc.1) removed that
- * member and replaced it with the on-demand APIs `snapshotEvents(from?, to?)`
- * (half-open range, internally cached), `eventAt(seq)`, `ownEvents()` and
- * `seq`. This module reads the full log through whichever channel the host
- * exposes, so the plugin keeps one code path across both endpoints.
- *
- * `snapshotEvents()` is deliberately preferred over `ownEvents()`:
- * `snapshotEvents()` defaults to the whole log (including any fork-inherited
- * prefix), which is exactly what `Session.events` returned on 0.1.1-rc.2 — the
- * rewind semantics are preserved for fork-seeded sessions. `ownEvents()`
- * would drop the inherited prefix and change behaviour.
- *
- * @module dsh-rewind/session-events
- */
-import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
-/**
- * Read the full event log of a session, transparently across harness channels:
- * - 0.1.1-rc.2 (`Session.events`): the live immutable log array.
- * - 0.1.2-rc.1 (`Session.snapshotEvents()`): a deep-frozen snapshot, cached
- *   by the session until the next append. This is the single 0.1.2-line
- *   channel (alpha.2/3 still exposed `events` and thus fall into the
- *   0.1.1-rc.2 branch below).
- *
- * Falls back to an empty log when the session exposes neither member (a future
- * harness shape) rather than throwing — callers already treat the empty log as
- * "no candidates".
- *
- * @param session - the session to read.
- * @returns the full event log in log order (the same shape 0.1.1-rc.2's `events`
- *   returned, so existing consumers are unchanged).
- */
-export declare function eventsOf(session: Session): readonly SessionEvent[];

package/lib/types/settings-locale.d.ts

@@ -1,33 +0,0 @@
-/**
- * Version-neutral settings-namespace reading for the host half.
- *
- * This is a "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual channel. DSH 0.1.1-rc.2 exposes a
- * `settingsNamespace(value)` brand helper, and `settings.get` is typed to
- * require a branded `SettingsNamespace`. The 0.1.2 line (0.1.2-rc.1) removed
- * that helper (the `SettingsNamespace` *type* remains) and `settings.get`
- * accepts the raw namespace string. This module collapses both into one runtime
- * call: on 0.1.1-rc.2 the brand is a compile-time marker erased at runtime (so
- * `settingsNamespace(ns)` returns `ns`), on 0.1.2-rc.1 the brand helper is
- * absent and the raw `ns` string is used directly. That is what lets a single
- * compiled host bundle link and run on both harness generations.
- *
- * @module dsh-rewind/settings-locale
- */
-/** Minimal structural face of the settings provider the host reads from. */
-export interface SettingsProviderLike {
-    /**
-     * Read one registered settings section by namespace. Accepts whatever the
-     * running DSH generation passes: a branded `SettingsNamespace` (0.1.1-rc.2,
-     * brand erased) or the raw namespace string (0.1.2-rc.1).
-     */
-    get(ns: string): unknown;
-}
-/** The `settingsNamespace(ns)` brand helper, or `undefined` when removed (0.1.2-rc.1). */
-export type SettingsNamespaceBrand = ((value: string) => string) | undefined;
-/**
- * Read one settings section keyed by `ns`, tolerant of the settings-namespace
- * brand across DSH generations. Pass the brand helper when available (the
- * 0.1.1-rc.2 path); it is `undefined` on 0.1.2-rc.1, where the raw `ns` string
- * is used directly. Never throws: an absent section simply returns `undefined`.
- */
-export declare function readSettingsSection(provider: SettingsProviderLike, ns: string, brand: SettingsNamespaceBrand): unknown;