@deepseek-ai/dsh-experimental-webworker-packer 0.1.6-alpha.2 → 0.1.7-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/experimental/webworker-packer/README.md
-README.md: 90723b7718393ed32005bd6146764044a8ec80b1
-README.zh.md: 9d7df43bf2b49d7b4a0438fcdb96fdbe44cc326a
+README.md: dfb3eccf8343f29c1028dae3a2db22a543675de8
+README.zh.md: 3c528628a8d810db00d9bd8b2c0b64a179faa729

package/README.md

@@ -31,11 +31,13 @@ The pack is a three-layer standard stack:
 
 1. **Roster** — the composed profile's plugin rows (standard YAML parse under Include's dialect, `!!js` intact), plus the rows of every config tree the CLI declares in its `package.json` `dsh.configTrees` (agent presets), materialized as a Node-style dependency closure. External peer edges never bind the worker; workspace peers stay on the chain.
 2. **Publish view** — each workspace or vendored package contributes its built npm slice (`files` through picomatch) without source or workspace `dist/`. External packages retain published JavaScript under both `src/` and `dist/` because their `main` or `exports` may point there; only generic test, map, declaration, and archive exclusions apply.
-3. **Reachability sweep** — the runtime loader's own resolution walks from every workspace export face plus the worker assembly's seeds (`IMAGE_ENTRY_SEEDS`), lowering each reached module to the wrapper contract at pack time. The transform reports statically named imports, re-exports, and dynamic imports; calls through `require`; and module-scope direct calls of the form `createRequire(import.meta.url)('pkg')` through a named import from `node:module` or `module`, including an import alias. Page assets (`lib/client.js` behind `./client` exports) ship verbatim; an unresolvable request from our own code fails the pack, third-party ones are tolerated to fail loud at require time.
+3. **Reachability sweep** — the runtime loader's own resolution walks from every non-wildcard workspace runtime export plus the worker assembly's seeds (`IMAGE_ENTRY_SEEDS`), lowering each reached module to the wrapper contract at pack time. Declaration-only condition trees do not seed the sweep; runtime requests for those exports still fail. The transform reports statically named imports, re-exports, and dynamic imports; calls through `require`; and module-scope direct calls of the form `createRequire(import.meta.url)('pkg')` through a named import from `node:module` or `module`, including an import alias. Page assets (`lib/client.js` behind `./client` exports) ship verbatim; an unresolvable request from our own code fails the pack, third-party ones are tolerated to fail loud at require time.
 
 `repository.ts` owns the repo-shaped inputs (workspace scan of `vendor/`, `packages/`, `native/system/packages/`, and `apps/`; profile composition through the real CLI dump path); `pack.ts` owns none of them, so the same library packs a different tree by being called differently. The native scan makes the Landlock entry package an ordinary published-view dependency while its executable remains a Worker platform implementation. The CLI is `dsh-pack-vfs-image --out <file> [--profile web]`; `apps/web`'s `build:preview` runs it after the preview shell build.
 
-The repository adapter also declares the preview-only fixture trees under `webworker-runtime/tests/fixtures/`. The CLI packs each named fixture into a separate deterministic overlay archive plus a browser-readable manifest. Overlay files bypass npm publish-view and module-reachability exclusions, so dot directories and example source files remain intact; their mounts are limited to `home/` and `workspace/`. `pack.ts` treats them as opaque bytes, and Session and Workspace interpretation stays in the runtime packages that own those formats.
+The repository adapter also declares the preview-only fixture trees under `webworker-runtime/tests/fixtures/`. The CLI packs each named fixture into a separate deterministic overlay archive plus a browser-readable manifest. Overlay files bypass npm publish-view and module-reachability exclusions, so dot directories and example source files remain intact; their mounts are limited to `home/` and `workspace/`. `packVfsOverlay` treats all files as opaque bytes.
+
+`packPreviewFixture` prepares the newest canonical raw Session generation in each fixture directory through the [Session format catalog](../../session/session-format-catalog/README.md) in Node. It collects direct-child discovery evidence from the same fixture root before completing historical parent catalogs. It strictly restores the source, encodes and strictly validates the current successor, and packs that successor beside unchanged source files. A malformed, unsupported, or future selected generation refuses the build without falling back. Temporary successors are removed after packing. Browser write-open then uses current data without invoking Node's migration-verification Worker. Projection caches remain owner-validated; an older generation cannot supply a current fold checkpoint.
 
 -----
 
@@ -57,6 +59,7 @@ None; this package neither assembles nor sends a provider request.
 - **Vendored package sources (`src/*.ts`) are excluded** — nothing resolves them at runtime; a future in-worker source-inspection feature would need a dedicated include rule.
 - **The packer assumes built `lib/` artifacts are current**: it never compiles, so a stale workspace build packs stale bytes. Run the repository build first.
 - **The CLI requires its original repository location**: `dsh-pack-vfs-image` finds the checkout relative to its own installed file and reads the source CLI, configuration trees, and preview fixtures there. An npm installation supports the parameterized library API; the CLI and repository helpers require a complete, built DeepSeek Harness checkout.
+- **Preview Session inputs use raw JSONL** — `packPreviewFixture` rejects compressed and noncanonical Session generation filenames. Generic overlays remain byte-preserving.
 
 
 <a id="dev-note"></a>

package/README.zh.md

@@ -31,11 +31,13 @@ VFS 镜像打包器：把一份合成 profile 变成浏览器 worker 挂载为
 
 1. **Roster**——合成 profile 的插件行（标准 YAML 解析、Include 方言、`!!js` 原样保留），加上 CLI（命令行界面）在 `package.json` `dsh.configTrees` 里声明的每棵配置树（agent（智能体） presets）的行，按 Node 式依赖闭包物化。外部 peer 边绝不会绑定到 worker，workspace peer 保留在链上。
 2. **发布视图**——每个 workspace 或 vendored 包贡献其构建后的 npm 切片（`files` 走 picomatch），不带源码和 workspace `dist/`。外部包的 `main` 或 `exports` 可能指向 `src/` 或 `dist/`，因此两处发布 JavaScript 都会保留，只应用通用的测试、map、声明与归档排除规则。
-3. **可达性 sweep**——用运行时加载器自己的解析，从全部 workspace 导出面加 worker 装配种子（`IMAGE_ENTRY_SEEDS`）出发，打包时把每个可达模块转换为符合包装层约定的形式。该转换会报告名称可静态确定的 import、re-export 与动态 import、经 `require` 发起的调用，以及通过 `node:module` 或 `module` 具名导入（含导入别名）在模块作用域直接发起的 `createRequire(import.meta.url)('pkg')` 调用。页面资产（`./client` 导出背后的 `lib/client.js`）原样直发；自家代码的不可解析请求会让打包失败，第三方不可解析请求则允许延后到 require 时明确失败。
+3. **可达性 sweep**——用运行时加载器自己的解析, 从全部不含通配符的 workspace 运行时导出加 worker 装配种子 (`IMAGE_ENTRY_SEEDS`) 出发, 打包时把每个可达模块转换为符合包装层约定的形式. 仅含类型声明的条件树不作为扫描入口; 运行时代码请求这些导出仍会失败. 该转换会报告名称可静态确定的 import、re-export 与动态 import、经 `require` 发起的调用, 以及通过 `node:module` 或 `module` 具名导入 (含导入别名) 在模块作用域直接发起的 `createRequire(import.meta.url)('pkg')` 调用. 页面资产 (`./client` 导出背后的 `lib/client.js`) 原样直发; 自家代码的不可解析请求会让打包失败, 第三方不可解析请求则允许延后到 require 时明确失败.
 
 `repository.ts` 拥有仓库形态输入（`vendor/`、`packages/`、`native/system/packages/` 与 `apps/` 的 workspace 扫描；经真 CLI dump 路径合成 profile）；`pack.ts` 一概不拥有，同一库换参即可打另一棵树。Native 扫描使 Landlock 入口包成为普通发布视图依赖，其可执行文件仍由 Worker 平台实现。CLI 为 `dsh-pack-vfs-image --out <file> [--profile web]`；`apps/web` 的 `build:preview` 在预览壳构建后运行它。
 
-仓库适配器还声明 `webworker-runtime/tests/fixtures/` 下仅用于 preview 的 fixture（测试前置数据） tree。CLI 会把每套具名 fixture 打成一份独立的确定性 overlay 归档，并写出浏览器可读的 manifest（元数据清单）。Overlay 文件绕过 npm 发布视图和模块可达性排除规则，因此点目录与示例源码会完整保留；其挂载位置仅限 `home/` 与 `workspace/`。`pack.ts` 把它们视为不透明字节；会话与 Workspace 的解释仍归拥有这些格式的运行时包。
+仓库适配器还声明 `webworker-runtime/tests/fixtures/` 下仅用于 preview 的 fixture（测试前置数据） tree。CLI 会把每套具名 fixture 打成一份独立的确定性 overlay 归档，并写出浏览器可读的 manifest（元数据清单）。Overlay 文件绕过 npm 发布视图和模块可达性排除规则，因此点目录与示例源码会完整保留；其挂载位置仅限 `home/` 与 `workspace/`。`packVfsOverlay` 将所有文件视为不透明字节。
+
+`packPreviewFixture` 在 Node 中通过 [Session 格式目录](../../session/session-format-catalog/README.zh.md)准备每个 fixture 目录里最新的规范原始 Session 代际。它从同一 fixture 根目录收集直属子 Session 的发现证据，再补全历史父目录。它严格恢复源文件、编码并严格校验当前后继文件，然后将后继文件与未改变的源文件一同打包。如果选中的代际格式错误、不受支持或属于未来版本，构建会拒绝，不回退。临时后继文件在打包后删除。浏览器以写模式打开时即可使用当前数据，无需调用 Node 的迁移校验 Worker。投影缓存仍由其所属包校验；较早代际不能提供当前折叠检查点。
 
 -----
 
@@ -57,6 +59,7 @@ VFS 镜像打包器：把一份合成 profile 变成浏览器 worker 挂载为
 - **vendored 包源码（`src/*.ts`）被排除**——运行时无人解析它们；未来若有 worker 内源码巡检功能需要专门的 include 规则。
 - **打包器假定构建产物 `lib/` 是新鲜的**：它从不编译，工作区构建陈旧就会打包陈旧字节。先跑仓库构建。
 - **CLI 必须位于原有仓库位置**：`dsh-pack-vfs-image` 相对于自身安装文件定位检出目录，并从中读取源码 CLI、配置树和预览 fixture。npm 安装支持参数化的库 API；CLI 和仓库辅助函数需要完整且已构建的 DeepSeek Harness 检出目录。
+- **Preview Session 输入使用原始 JSONL** — `packPreviewFixture` 拒绝压缩文件与不规范的 Session 代际文件名。通用 overlay 仍逐字节保留输入。
 
 
 <a id="dev-note"></a>

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as previewFixtures, i as indexWorkspacePackages, l as packVfsImage, n as configTrees, r as describePack, t as composeProfile, u as packVfsOverlay } from "./repository-f0am6-5_.js";
+import { a as previewFixtures, i as indexWorkspacePackages, n as configTrees, o as packPreviewFixture, r as describePack, t as composeProfile, u as packVfsImage } from "./repository-Dpj3ScQ2.js";
 import { PREVIEW_FIXTURE_MANIFEST_FILE, PREVIEW_FIXTURE_MANIFEST_VERSION } from "@deepseek-ai/dsh-experimental-webworker-runtime";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
@@ -50,7 +50,7 @@ const fixtureDefinitions = previewFixtures(repoRoot);
 mkdirSync(join(dirname(outputFile), "fixtures"), { recursive: true });
 const fixtureLines = [];
 const fixtures = fixtureDefinitions.map((fixture) => {
-	const packed = packVfsOverlay(fixture.trees);
+	const packed = packPreviewFixture(fixture.trees);
 	const file = `fixtures/${fixture.id}.tar.gz`;
 	writeFileSync(join(dirname(outputFile), file), packed.image);
 	fixtureLines.push(`  fixture overlay     ${fixture.id} (${String(packed.image.byteLength)} B compressed)`);

package/lib/index.js

@@ -1,2 +1,2 @@
-import { a as previewFixtures, c as MANIFEST_PATH, d as WRAPPER_CONTRACT, i as indexWorkspacePackages, l as packVfsImage, n as configTrees, o as CONFIG_PATH, r as describePack, s as DEFAULT_ROOT, t as composeProfile, u as packVfsOverlay } from "./repository-f0am6-5_.js";
-export { CONFIG_PATH, DEFAULT_ROOT, MANIFEST_PATH, WRAPPER_CONTRACT, composeProfile, configTrees, describePack, indexWorkspacePackages, packVfsImage, packVfsOverlay, previewFixtures };
+import { a as previewFixtures, c as DEFAULT_ROOT, d as packVfsOverlay, f as WRAPPER_CONTRACT, i as indexWorkspacePackages, l as MANIFEST_PATH, n as configTrees, o as packPreviewFixture, r as describePack, s as CONFIG_PATH, t as composeProfile, u as packVfsImage } from "./repository-Dpj3ScQ2.js";
+export { CONFIG_PATH, DEFAULT_ROOT, MANIFEST_PATH, WRAPPER_CONTRACT, composeProfile, configTrees, describePack, indexWorkspacePackages, packPreviewFixture, packVfsImage, packVfsOverlay, previewFixtures };

package/lib/{repository-f0am6-5_.js → repository-Dpj3ScQ2.js}

@@ -1,6 +1,6 @@
 import { DEFAULT_ROOT, DEFAULT_ROOT as DEFAULT_ROOT$1, IMAGE_CONFIG_PATH, IMAGE_EMPTY_DIRECTORIES, IMAGE_MANIFEST_PATH, IMAGE_OVERLAY_DIRECTORIES, LOWERING_VERSION, MODULE_PROXIES, MODULE_PROXY_PREFIXES, MemoryVfs, REPLACED_EXTERNAL_PACKAGES, WorkerModuleLoader, lowerModuleSource, packTar } from "@deepseek-ai/dsh-experimental-webworker-runtime";
-import { existsSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync } from "node:fs";
-import { dirname, join, relative } from "node:path";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, posix, relative } from "node:path";
 import { gzipSync } from "node:zlib";
 import picomatch from "picomatch";
 import yaml from "js-yaml";
@@ -8,6 +8,9 @@ import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
 import { execFileSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { DSH_HOME_ENV } from "@deepseek-ai/dsh-home-paths";
+import { isSessionFormatJsonObject, parseSessionFormatLogFilename, sessionFormatLogFilename } from "@deepseek-ai/dsh-session-format";
+import { createSessionFormatCatalogWithChildren, historicalSessionFormatCatalog, sessionFormatCatalog } from "@deepseek-ai/dsh-session-format-catalog";
+import { historicalChildCatalogSource } from "@deepseek-ai/dsh-session-format-v3-to-v4";
 //#region lib/types/transform-image.js
 /**
 * The wrapper contract packed bodies are emitted against, and the image-entry
@@ -308,6 +311,13 @@ function debuggerNamer(workspaces, resolveFrom) {
 		return directory === void 0 ? key : `${directory}${rest.slice(packageName.length)}`;
 	};
 }
+/** Declaration-only condition trees add no runtime roots; explicit imports still resolve normally. */
+function isDeclarationOnlyExport(value) {
+	if (typeof value !== "object" || value === null) return false;
+	if (Array.isArray(value)) return value.length > 0 && value.every(isDeclarationOnlyExport);
+	const conditions = Object.entries(value);
+	return conditions.length > 0 && conditions.every(([condition, target]) => condition === "types" || condition.startsWith("types@") || isDeclarationOnlyExport(target));
+}
 function sweepImage(files, options, rootPackages, root) {
 	const decoder = new TextDecoder();
 	const encoder = new TextEncoder();
@@ -335,7 +345,7 @@ function sweepImage(files, options, rootPackages, root) {
 		} catch {
 			continue;
 		}
-		const subpaths = manifest.exports === void 0 ? ["."] : Object.keys(manifest.exports).filter((key) => key.startsWith(".") && !key.includes("*"));
+		const subpaths = manifest.exports === void 0 ? ["."] : Object.entries(manifest.exports).filter(([key, target]) => key.startsWith(".") && !key.includes("*") && !isDeclarationOnlyExport(target)).map(([key]) => key);
 		for (const subpath of subpaths) queue.push({
 			specifier: subpath === "." ? name : `${name}/${subpath.slice(2)}`,
 			from: root,
@@ -584,6 +594,97 @@ function packVfsOverlay(trees) {
 	};
 }
 //#endregion
+//#region lib/types/preview.js
+/** Node-side Session preparation for browser Preview data overlays. */
+/**
+* Pack Preview data with strictly validated current Session successors prepared in Node.
+* Committed source bytes remain in the overlay; only the newest canonical raw generation
+* of each Session is restored. Future, malformed, and unsupported selected data refuse the pack.
+* @param trees - Ordered source trees under the Preview's home and workspace mounts.
+* @returns Deterministic overlay containing unchanged inputs and final current successors.
+*/
+function packPreviewFixture(trees) {
+	const original = packVfsOverlay(trees);
+	const successors = /* @__PURE__ */ new Map();
+	const sources = selectedSessions(original.files).map((source) => {
+		const text = new TextDecoder("utf-8", { fatal: true }).decode(source.bytes);
+		if (!text.endsWith("\n")) throw new Error(`preview fixture: ${source.path} has a torn physical tail`);
+		const [headerLine = "", ...rows] = text.slice(0, -1).split("\n");
+		const header = JSON.parse(headerLine);
+		if (!isSessionFormatJsonObject(header) || header["version"] !== source.version || header["id"] !== source.id) throw new Error(`preview fixture: ${source.path} disagrees with its Session header`);
+		const restore = (source.version <= 3 ? historicalSessionFormatCatalog : sessionFormatCatalog).createRestore(header, {
+			recovery: "strict",
+			validation: "current"
+		});
+		const events = rows.map((row) => JSON.parse(row));
+		for (const event of events) restore.decodeRow(event);
+		return {
+			...source,
+			header,
+			events,
+			artifact: restore.finish()
+		};
+	});
+	for (const source of sources) {
+		if (source.version === sessionFormatCatalog.currentVersion) continue;
+		const restore = createSessionFormatCatalogWithChildren(sources.filter((child) => posix.dirname(child.directory) === posix.dirname(source.directory) && child.artifact.header.parentSession === source.id && child.artifact.header.origin === "subagent").map((child) => ({
+			...historicalChildCatalogSource(child.artifact),
+			sourcePath: child.path
+		}))).createRestore(source.header, {
+			recovery: "strict",
+			validation: "current"
+		});
+		for (const event of source.events) restore.decodeRow(event);
+		const artifact = restore.finish();
+		const encodedHeader = sessionFormatCatalog.encodeCurrentHeader(artifact.header, artifact.inheritedEventCount);
+		const encodedEvents = artifact.events.map((event) => sessionFormatCatalog.encodeCurrentEvent(event));
+		const verification = sessionFormatCatalog.createRestore(encodedHeader, {
+			recovery: "strict",
+			validation: "current"
+		});
+		for (const event of encodedEvents) verification.decodeRow(event);
+		verification.finish();
+		successors.set(posix.join(source.directory, sessionFormatLogFilename(sessionFormatCatalog.currentVersion)), [encodedHeader, ...encodedEvents].map((row) => JSON.stringify(row) + "\n").join(""));
+	}
+	if (successors.size === 0) return original;
+	const directory = mkdtempSync(join(tmpdir(), "dsh-preview-sessions-"));
+	try {
+		for (const [imagePath, content] of successors) {
+			const path = join(directory, imagePath.slice(14));
+			mkdirSync(dirname(path), { recursive: true });
+			writeFileSync(path, content, { flag: "wx" });
+		}
+		return packVfsOverlay([...trees, {
+			mount: "home/sessions",
+			directory
+		}]);
+	} finally {
+		rmSync(directory, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function selectedSessions(files) {
+	const selected = /* @__PURE__ */ new Map();
+	for (const [path, bytes] of Object.entries(files)) {
+		const match = /^home\/sessions\/[^/]+\/([^/]+)\/(session(?:\..*)?\.jsonl(?:\.zstd)?)$/u.exec(path);
+		if (match === null) continue;
+		const version = parseSessionFormatLogFilename(match[2]);
+		if (version === void 0) throw new Error(`preview fixture: ${path} must name a canonical raw Session generation`);
+		const directory = posix.dirname(path);
+		const previous = selected.get(directory);
+		if (previous === void 0 || previous.version < version) selected.set(directory, {
+			path,
+			directory,
+			id: match[1],
+			version,
+			bytes
+		});
+	}
+	return [...selected.values()];
+}
+//#endregion
 //#region lib/types/repository.js
 /**
 * Repository knowledge for the packer: where this tree's workspaces, profile
@@ -761,4 +862,4 @@ function describePack(result, repoRoot, outputFile) {
 	];
 }
 //#endregion
-export { previewFixtures as a, MANIFEST_PATH as c, WRAPPER_CONTRACT as d, indexWorkspacePackages as i, packVfsImage as l, configTrees as n, CONFIG_PATH as o, describePack as r, DEFAULT_ROOT$1 as s, composeProfile as t, packVfsOverlay as u };
+export { previewFixtures as a, DEFAULT_ROOT$1 as c, packVfsOverlay as d, WRAPPER_CONTRACT as f, indexWorkspacePackages as i, MANIFEST_PATH as l, configTrees as n, packPreviewFixture as o, describePack as r, CONFIG_PATH as s, composeProfile as t, packVfsImage as u };

package/lib/types/bin.js

@@ -11,8 +11,8 @@ import { mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { PREVIEW_FIXTURE_MANIFEST_FILE, PREVIEW_FIXTURE_MANIFEST_VERSION, } from '@deepseek-ai/dsh-experimental-webworker-runtime';
-import { packVfsImage, packVfsOverlay } from "./pack.js";
-import { composeProfile, configTrees, describePack, indexWorkspacePackages, previewFixtures, } from "./repository.js";
+import { packVfsImage } from "./pack.js";
+import { composeProfile, configTrees, describePack, indexWorkspacePackages, packPreviewFixture, previewFixtures, } from "./repository.js";
 /**
  * Read one `--flag value` pair.
  * @param name - Flag name without dashes.
@@ -56,7 +56,7 @@ const fixtureDirectory = join(dirname(outputFile), 'fixtures');
 mkdirSync(fixtureDirectory, { recursive: true });
 const fixtureLines = [];
 const fixtures = fixtureDefinitions.map((fixture) => {
-    const packed = packVfsOverlay(fixture.trees);
+    const packed = packPreviewFixture(fixture.trees);
     const file = `fixtures/${fixture.id}.tar.gz`;
     writeFileSync(join(dirname(outputFile), file), packed.image);
     fixtureLines.push(`  fixture overlay     ${fixture.id} (${String(packed.image.byteLength)} B compressed)`);

package/lib/types/index.d.ts

@@ -4,5 +4,5 @@
  */
 export { WRAPPER_CONTRACT, type ImageFiles, type TransformOutcome, } from './transform-image.ts';
 export { CONFIG_PATH, DEFAULT_ROOT, MANIFEST_PATH, packVfsImage, packVfsOverlay, type ConfigTree, type ImageTree, type PackOptions, type PackOverlayResult, type PackResult, } from './pack.ts';
-export { composeProfile, configTrees, describePack, indexWorkspacePackages, previewFixtures, type PreviewFixture, } from './repository.ts';
+export { composeProfile, configTrees, describePack, indexWorkspacePackages, packPreviewFixture, previewFixtures, type PreviewFixture, } from './repository.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/preview.d.ts

@@ -0,0 +1,11 @@
+/** Node-side Session preparation for browser Preview data overlays. */
+import { type ImageTree, type PackOverlayResult } from './pack.ts';
+/**
+ * Pack Preview data with strictly validated current Session successors prepared in Node.
+ * Committed source bytes remain in the overlay; only the newest canonical raw generation
+ * of each Session is restored. Future, malformed, and unsupported selected data refuse the pack.
+ * @param trees - Ordered source trees under the Preview's home and workspace mounts.
+ * @returns Deterministic overlay containing unchanged inputs and final current successors.
+ */
+export declare function packPreviewFixture(trees: readonly ImageTree[]): PackOverlayResult;
+//# sourceMappingURL=preview.d.ts.map

package/lib/types/repository.d.ts

@@ -1,4 +1,5 @@
 import type { ConfigTree, ImageTree, PackResult } from './pack.ts';
+export { packPreviewFixture } from './preview.ts';
 /** One built-in Preview source and the trees packed into its overlay. */
 export interface PreviewFixture {
     /** URL/query-safe identifier. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-experimental-webworker-packer",
   "description": "Build-time packer for the browser runtime's base VFS image and ordered data-overlay archives",
-  "version": "0.1.6-alpha.2",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -35,16 +35,19 @@
   "dependencies": {
     "js-yaml": "^4.2.0",
     "picomatch": "^4.0.4",
-    "@deepseek-ai/cordis-plugin-include": "^1.0.7",
-    "@deepseek-ai/dsh-experimental-webworker-runtime": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.2"
+    "@deepseek-ai/cordis-plugin-include": "^1.0.8",
+    "@deepseek-ai/dsh-experimental-webworker-runtime": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-format-v3-to-v4": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-format-catalog": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session-format": "^0.1.7-alpha.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/picomatch": "^3.0.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.3"
   }
 }