@deepseek-ai/dsh-session-snapshot 0.1.2-alpha.2 → 0.1.2-alpha.4

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/test-support/session-snapshot/README.md
-README.md: 9f1907af8b9e50f587bcc05b93d8e3730c8f272c
-README.zh.md: 2d4290578a655df91eb60f63177c97fc5d82da6c
+README.md: 0e099dba28f45031bdaa3c187f3e3ffce5b3b2b9
+README.zh.md: f81b3038b14b94716f4f045aee2d70daa27930dc

package/README.md

@@ -87,7 +87,7 @@ A scenario requiring a non-Windows host declares `posixOnly`, which skips its ru
 ### What can go wrong
 
 - **A fixture guard rejects the committed files** — orphan scenario dirs, missing files, multiple pins for one header class, duplicate sidecar content, unscrubbed JSONL headers, and malformed pinning headers all fail the suite before comparisons run.
-- **The session harvest needs raw JSONL mode** — snapshot configs set the JSONL backend's `compression: 'none'`; compressed JSONL and SQLite compositions have no snapshot-harvest path.
+- **The session harvest needs raw JSONL mode** — snapshot configs set the JSONL backend's `compression: 'none'`; compressed JSONL has no snapshot-harvest path.
 - **Built mode needs current artifacts** — run `pnpm run build` before selecting `DSH_EXAMPLE_MODE=lib`; source mode remains the zero-build path.
 
 -----
@@ -116,7 +116,7 @@ The shared core owns manifests, workspace setup/comparison, typed identity mappi
 | [`src/workspace.ts`](src/workspace.ts) | Scenario workspace setup and complete expected-state comparison |
 | [`src/suite.ts`](src/suite.ts) | Scenario-table suite factory, fixture guards, record/refresh write-back |
 | [`src/index.ts`](src/index.ts) | Package entry re-exporting the four layers |
-| [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant; consuming test suites exercise the kit) |
+| — | No runtime invariant companion is published; this test-support package owns no production event stream or mutable data; consuming test suites exercise its behavior. |
 
 ### Data flow
 
@@ -154,7 +154,7 @@ None; this package neither assembles nor sends a provider request.
 
 These limits define when the kit needs special care. They are current package constraints, not a task backlog.
 
-- **Session harvest requires raw JSONL mode** — `runScenario` collects persisted `.jsonl` logs, so snapshot configs set the JSONL backend's `compression: 'none'`; compressed JSONL and SQLite compositions have no snapshot-harvest path.
+- **Session harvest requires raw JSONL mode** — `runScenario` collects persisted `.jsonl` logs, so snapshot configs set the JSONL backend's `compression: 'none'`; compressed JSONL has no snapshot-harvest path.
 - **Built mode requires current artifacts** — run `pnpm run build` before selecting `DSH_EXAMPLE_MODE=lib`; source mode remains the zero-build path.
 - **ACP remains for protocol behavior** — cancellation and permission round trips whose stimulus is the ACP client stay on that adapter; assembled one-shot and persistent-control behavior uses headless and SDK adapters.
 

package/README.zh.md

@@ -87,7 +87,7 @@ defineAcpSnapshotSuite({
 ### 可能出什么问题
 
 - **fixture 保护拒绝已提交文件**——遗留场景目录、缺失文件、一个 header 类别包含多个 pin、重复的伴随文件内容、未擦除的 JSONL header 与格式错误的 pin header 都会在比较运行前使套件失败。
-- **会话收集需要原始 JSONL mode**——快照配置使用 JSONL 后端的 `compression: 'none'`；压缩 JSONL 与 SQLite 组合没有快照收集路径。
+- **会话收集需要原始 JSONL mode**——快照配置使用 JSONL 后端的 `compression: 'none'`；压缩 JSONL 没有快照收集路径。
 - **构建 mode 需要当前产物**——选择 `DSH_EXAMPLE_MODE=lib` 前先运行 `pnpm run build`；源 mode 仍是零构建路径。
 
 -----
@@ -116,7 +116,7 @@ defineAcpSnapshotSuite({
 | [`src/workspace.ts`](src/workspace.ts) | 场景 workspace 设置与完整预期状态比较 |
 | [`src/suite.ts`](src/suite.ts) | 场景表套件工厂、fixture 保护、录制/刷新回写 |
 | [`src/index.ts`](src/index.ts) | 再导出四个层的包入口 |
-| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式；消费它的测试套件会检验该工具包） |
+| — | 不发布运行时不变式伴生入口；消费它的测试套件会检验该工具包。 |
 
 ### 数据流
 
@@ -154,7 +154,7 @@ defineAcpSnapshotSuite({
 
 这些限制说明何时需要对该工具包特别小心。它们是当前包约束，不是任务积压。
 
-- **会话收集需要原始 JSONL mode**——`runScenario` 收集持久化 `.jsonl` 日志，因此快照配置使用 JSONL 后端的 `compression: 'none'`；压缩 JSONL 与 SQLite 组合没有快照收集路径。
+- **会话收集需要原始 JSONL mode**——`runScenario` 收集持久化 `.jsonl` 日志，因此快照配置使用 JSONL 后端的 `compression: 'none'`；压缩 JSONL 没有快照收集路径。
 - **构建 mode 需要当前产物**——选择 `DSH_EXAMPLE_MODE=lib` 前先运行 `pnpm run build`；源 mode 仍是零构建路径。
 - **ACP 继续覆盖协议行为**——刺激来自 ACP 客户端的取消与权限往返留在该适配器；组装式一次性行为与持久控制行为使用 headless 与 SDK 适配器。
 

package/lib/index.js

@@ -12,7 +12,7 @@ import { pathToFileURL } from "node:url";
 import * as yaml from "js-yaml";
 import { entryListSchema } from "@deepseek-ai/cordis-plugin-include";
 import { resolveExampleLaunch } from "@deepseek-ai/dsh-loader-smoke";
-import { decodeSeqRanges, decodeStorageRecord, packChunkRuns } from "@deepseek-ai/dsh-session";
+import { SessionLogOffset, SessionSeq, decodeSeqRanges, decodeStorageRecord, packChunkRuns } from "@deepseek-ai/dsh-session";
 import { isSurfaceEligibleType } from "@deepseek-ai/dsh-session/surface";
 //#region lib/types/identity.js
 /** Relationship-preserving identity redaction for committed session snapshots. */
@@ -1197,7 +1197,7 @@ function normalizeSessionLog(rawLog, ctx, options = {}) {
 function repackSessionSnapshot(rawLog) {
 	const lines = rawLog.split("\n").filter((line) => line.trim().length > 0);
 	const header = lines.shift();
-	let nextSeq = 0;
+	let nextSeq = SessionLogOffset(0);
 	return [
 		header,
 		...packChunkRuns(lines.flatMap((line) => {
@@ -1208,15 +1208,15 @@ function repackSessionSnapshot(rawLog) {
 					seq0: nextSeq,
 					time0: 0
 				});
-				nextSeq += decoded.length;
+				nextSeq = SessionLogOffset(nextSeq + decoded.length);
 				return decoded;
 			}
 			const event = {
 				...record,
-				seq: nextSeq,
+				seq: SessionSeq(nextSeq),
 				time: 0
 			};
-			nextSeq += 1;
+			nextSeq = SessionLogOffset(nextSeq + 1);
 			return [event];
 		})).map((stored) => {
 			const projected = { ...stored };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-snapshot",
   "description": "Session-log snapshot core with an ACP protocol adapter, expected-output normalization, and fixture invariants",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,16 +18,11 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
@@ -35,27 +30,25 @@
     "@agentclientprotocol/sdk": "1.4.0",
     "js-yaml": "^4.2.0",
     "vitest": "^4.1.8",
-    "@deepseek-ai/cordis-plugin-include": "1.0.7",
-    "@deepseek-ai/dsh-loader-smoke": "0.1.2-alpha.2"
+    "@deepseek-ai/dsh-loader-smoke": "0.1.2-alpha.4",
+    "@deepseek-ai/cordis-plugin-include": "1.0.7"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-agent-loop": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-subagent": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tools": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-user-questions": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.4"
   }
 }

package/lib/invariant.js

@@ -1,23 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-session-snapshot`.
-* @module @deepseek-ai/dsh-session-snapshot/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-session-snapshot";
-/** Cordis companion plugin name. */
-const name = "session-snapshot-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: this test-support package owns no production event stream or mutable data;
-* consuming test suites exercise its behavior.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-session-snapshot`.
- * @module @deepseek-ai/dsh-session-snapshot/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "session-snapshot-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map