@deepseek-ai/dsh-llm-replay 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/llm-replay/README.md
-README.md: 54e37e4159788375e61539a6581f871dd35049ff
-README.zh.md: d6130daee619e4726ba4117d14dc0767e07d893f
+README.md: c0643bf6823e96cf3663f8299d0f5645d7974011
+README.zh.md: 1c2fe3393691b4988678497aa5948957f678c80b

package/README.md

@@ -102,7 +102,7 @@ Replay is built on one idea: the projected session log is the fixture. `deriveRe
 | File | Role |
 |---|---|
 | [`src/index.ts`](src/index.ts) | Types, fixture derivation, override validation, placeholder resolution, session binding, `installLlmReplay`, and the plugin export |
-| [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant; the stream grammar is checked by the LLM companion and derivation tests) |
+| — | No runtime invariant companion is published; this test-only adapter consumes a fixed replay script; its stream grammar is checked by the LLM companion and fixture derivation tests. |
 
 ### Binding and stream flow
 

package/README.zh.md

@@ -102,7 +102,7 @@ fixture 是运行一次真实 agent 所产生的持久化会话日志（`<scenar
 | 文件 | 职责 |
 |---|---|
 | [`src/index.ts`](src/index.ts) | 类型、fixture 派生、override 校验、占位符解析、会话绑定、`installLlmReplay` 与插件导出 |
-| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式；流语法由 LLM 伴生插件与派生测试检验） |
+| — | 不发布运行时不变式伴生入口；流语法由 LLM 伴生插件与派生测试检验。 |
 
 ### 绑定与流式流程
 

package/lib/index.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { delimiter } from "node:path";
-import { decodeSeqRanges, decodeStorageRecord } from "@deepseek-ai/dsh-session";
+import { SessionLogOffset, decodeSeqRanges, decodeStorageRecord } from "@deepseek-ai/dsh-session";
 import { LlmAdapter, LlmError, ReasoningEffortId, requestImageHandleText, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
 import { assertNever } from "@deepseek-ai/dsh-util-values";
 //#region lib/types/index.js
@@ -29,7 +29,7 @@ const PACKED_CHUNK_ROW_TYPES = new Set([
 */
 function parseSessionLog(text) {
 	const events = [];
-	let nextSeq = 0;
+	let nextSeq = SessionLogOffset(0);
 	let headerSkipped = false;
 	for (const [index, line] of text.split(/\r?\n/).entries()) {
 		if (line.trim().length === 0) continue;
@@ -60,7 +60,7 @@ function parseSessionLog(text) {
 			throw new Error(`session snapshot line ${index + 1}: ${detail}`, { cause: error });
 		}
 		events.push(...decoded);
-		nextSeq += decoded.length;
+		nextSeq = SessionLogOffset(nextSeq + decoded.length);
 	}
 	return events;
 }
@@ -68,7 +68,7 @@ function parseSessionLog(text) {
 * Read replay identity, ordering, and fork-seed facts from the JSONL header.
 *
 * @param text - the raw `.jsonl` file contents (only the header line is read).
-* @returns the header's `id`, `createdAt`, and `seedLength`, defaulted when absent.
+* @returns the header's `id`, `createdAt`, and inherited-event count, defaulted when absent.
 */
 function parseSessionHeader(text) {
 	const firstLine = text.split("\n").find((line) => line.trim().length > 0) ?? "{}";
@@ -76,7 +76,7 @@ function parseSessionHeader(text) {
 	return {
 		id: typeof parsed.id === "string" ? parsed.id : "",
 		createdAt: typeof parsed.createdAt === "number" ? parsed.createdAt : 0,
-		seedLength: typeof parsed.seedLength === "number" ? parsed.seedLength : 0
+		inheritedEventCount: SessionLogOffset(typeof parsed.seedLength === "number" ? parsed.seedLength : 0)
 	};
 }
 /**
@@ -369,7 +369,7 @@ function deriveScriptFromFile(file) {
 }
 /**
 * Load the primary and child scripts in bind order. Child derivation begins at
-* `seedLength` so inherited parent chunks are never replayed as child calls.
+* the v0 header's inherited-event cut so parent chunks are never replayed as child calls.
 *
 * @param config - the fixture paths: the primary log plus any recorded child logs.
 * @returns the primary script first, then the child scripts in bind order.
@@ -391,7 +391,7 @@ function loadSessionScripts(config) {
 		if (!existsSync(childFile)) throw new Error(`llm-replay: child fixture not found: ${childFile} — re-record the scenario`);
 		const text = readFileSync(childFile, "utf8");
 		const header = parseSessionHeader(text);
-		const ownEvents = parseSessionLog(text).slice(header.seedLength);
+		const ownEvents = parseSessionLog(text).slice(header.inheritedEventCount);
 		children.push({
 			recordedId: header.id,
 			createdAt: header.createdAt,

package/lib/types/index.d.ts

@@ -8,6 +8,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { type SessionEvent } from '@deepseek-ai/dsh-session';
+import type { SessionLogOffset as SessionLogOffsetType } from '@deepseek-ai/dsh-session';
 import type { GenerateOptions, ModelModality, RetryPolicyConfig, StreamChunk } from '@deepseek-ai/dsh-llm';
 /**
  * One recorded model call. `throw` may replay prefix chunks before failing;
@@ -161,12 +162,12 @@ export declare function parseSessionLog(text: string): SessionEvent[];
  * Read replay identity, ordering, and fork-seed facts from the JSONL header.
  *
  * @param text - the raw `.jsonl` file contents (only the header line is read).
- * @returns the header's `id`, `createdAt`, and `seedLength`, defaulted when absent.
+ * @returns the header's `id`, `createdAt`, and inherited-event count, defaulted when absent.
  */
 export declare function parseSessionHeader(text: string): {
     id: string;
     createdAt: number;
-    seedLength: number;
+    inheritedEventCount: SessionLogOffsetType;
 };
 /**
  * Reconstruct the per-`stream()` replay script from a recorded session log.
@@ -231,7 +232,7 @@ export declare function resolveScriptedEntry(entry: ReplayEntry, messages: Gener
 export declare function loadReplayScript(config: ReplayConfig): ReplayEntry[];
 /**
  * Load the primary and child scripts in bind order. Child derivation begins at
- * `seedLength` so inherited parent chunks are never replayed as child calls.
+ * the v0 header's inherited-event cut so parent chunks are never replayed as child calls.
  *
  * @param config - the fixture paths: the primary log plus any recorded child logs.
  * @returns the primary script first, then the child scripts in bind order.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-llm-replay",
   "description": "Replay LLM plugin: short-circuits llm/stream with model chunks reconstructed from a recorded session JSONL (keyless snapshot tests)",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,26 +18,20 @@
       "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",
   "peerDependencies": {
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-deepseek-llm-api-extensions": {
@@ -46,13 +40,12 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-compaction": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-util-values": "^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-llm-replay`.
-* @module @deepseek-ai/dsh-llm-replay/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-llm-replay";
-/** Cordis companion plugin name. */
-const name = "llm-replay-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: this test-only adapter consumes a fixed replay script; its stream grammar
-* is checked by the LLM companion and fixture derivation tests.
-*/
-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-llm-replay`.
- * @module @deepseek-ai/dsh-llm-replay/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "llm-replay-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