@deepseek-ai/dsh-session-log-deepseek 0.1.2-alpha.5 → 0.1.3-alpha.2

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/session/session-log-deepseek/README.md
-README.md: b08b2d3cde78e7a3cf7050e90ff57655ad70d409
-README.zh.md: 0ee216c6c69178695eb629b2a81faef73103b13d
+README.md: 047cd8133b88ceacce1fdaafa87a60611532a18c
+README.zh.md: be6b97bc889a037847289d4f5757c12823969a63

package/README.md

@@ -34,12 +34,12 @@ Shipped profiles mount the plugin so an overlay can enable it, but the default c
 <a id="request-field"></a>
 ## Request field
 
-For a request carrying a live `sessionId`, the plugin folds the greatest accepted watermark for that exact Session identity, snapshots `Session.events`, and sends the contiguous suffix after the watermark. A process-local fold scans each event once and consumes later appends incrementally; restart and HMR rebuild it from the durable log. The version-1 field contains a v0-compatible raw session header (`seedLength` is present only for a seeded Session), numeric `afterSeq` and `throughSeq`, and every complete canonical event translated to raw-number envelope fields. Forked sessions ignore inherited parent watermarks because each watermark records the Session id sent on the accepted request.
+For a request carrying a live `sessionId`, the plugin folds the greatest accepted watermark for that exact Session format generation, snapshots `Session.events`, and sends the contiguous suffix after the watermark. A process-local fold scans each event once and consumes later appends incrementally; restart and HMR rebuild it from the durable log. The version-1 field contains `sessionFormatVersion`, a raw session header (`seedLength` is present only for a seeded Session), numeric `afterSeq` and `throughSeq`, and every complete canonical event translated to raw-number envelope fields. Forked sessions ignore inherited parent watermarks because both the recorded Session id and format generation must match the request source.
 
 <a id="acceptance-and-retry"></a>
 ## Acceptance and retry
 
-The DeepSeek adapter calls the prepared contribution's `accept()` after HTTP 2xx, before it consumes the SSE body. Acceptance appends `session-log-deepseek/delivery-accepted` with the uploaded `throughSeq`; the next request uploads that event as part of its new suffix. Transport and non-2xx failures append no acceptance record, so later requests resend the uncertain range. Concurrent deliveries may be accepted out of order; folding the maximum matching `throughSeq` prevents cursor regression.
+The DeepSeek adapter calls the prepared contribution's `accept()` after HTTP 2xx, before it consumes the SSE body. Acceptance appends `session-log-deepseek/delivery-accepted` with the uploaded `throughSeq` and `sessionFormatVersion`; a record that omits the format field denotes v0. The next request uploads that event as part of its new suffix. Transport and non-2xx failures append no acceptance record, so later requests resend the uncertain range. Concurrent deliveries may be accepted out of order; folding the maximum matching `throughSeq` prevents cursor regression.
 
 A crash after server acceptance but before the watermark reaches persistence can replay an accepted range after restart. This is the at-least-once failure direction: uncertainty creates duplicates, never a skipped sequence. The ordinary session checkpoint policy persists the watermark at the next semantic checkpoint; this plugin performs no independent I/O.
 

package/README.zh.md

@@ -34,12 +34,12 @@ kind: "package-reference"
 <a id="request-field"></a>
 ## 请求字段
 
-对于携带存活 `sessionId` 的请求，插件会折叠该确切会话身份的最大已接受水位，对 `Session.events` 取快照，并发送水位之后的连续后缀。进程内 fold 会让每条事件只被扫描一次并增量消费后续追加；重启与 HMR 会从持久日志重建它。版本 1 字段包含兼容 v0 的原始会话 header（仅 seeded Session 携带 `seedLength`）、数值型 `afterSeq` 与 `throughSeq`，以及把完整权威事件翻译为原始数值 envelope 字段后的数组元素。每个水位都会记录已接受请求发送的会话 id，因此 fork 会话会忽略从父会话继承的水位。
+对于携带存活 `sessionId` 的请求，插件会折叠该确切会话格式代的最大已接受水位，对 `Session.events` 取快照，并发送水位之后的连续后缀。进程内 fold 会让每条事件只被扫描一次并增量消费后续追加；重启与 HMR 会从持久日志重建它。版本 1 字段包含 `sessionFormatVersion`、原始会话 header（仅 seeded Session 携带 `seedLength`）、数值型 `afterSeq` 与 `throughSeq`，以及把完整权威事件翻译为原始数值 envelope 字段后的数组元素。只有记录的会话 id 与格式代均匹配请求来源时水位才生效，因此 fork 会话会忽略从父会话继承的水位。
 
 <a id="acceptance-and-retry"></a>
 ## 接受与重试
 
-DeepSeek 适配器会在 HTTP 2xx 后、消费 SSE（Server-Sent Events）正文前调用已准备贡献的 `accept()`。接受操作会追加 `session-log-deepseek/delivery-accepted` 及已上传的 `throughSeq`；下一次请求再把该事件作为新后缀的一部分上传。传输失败与非 2xx 失败不会追加接受记录，因此后续请求会重发不确定范围。并发交付可能乱序得到接受；折叠匹配记录中最大的 `throughSeq` 可以防止游标回退。
+DeepSeek 适配器会在 HTTP 2xx 后、消费 SSE（Server-Sent Events）正文前调用已准备贡献的 `accept()`。接受操作会追加 `session-log-deepseek/delivery-accepted`、已上传的 `throughSeq` 与 `sessionFormatVersion`；省略格式字段的记录表示 v0。下一次请求再把该事件作为新后缀的一部分上传。传输失败与非 2xx 失败不会追加接受记录，因此后续请求会重发不确定范围。并发交付可能乱序得到接受；折叠匹配记录中最大的 `throughSeq` 可以防止游标回退。
 
 服务端接受后、持久化水位前发生崩溃，可能让恢复后的进程重放已经接受的范围。这是至少一次交付的失败方向：不确定性会制造重复，绝不会跳过序列。普通会话检查点策略会在下一个语义检查点持久化水位；本插件不执行独立 I/O。
 

package/lib/index.js

@@ -15,7 +15,7 @@ const inject = ["deepseekLlmApiExtensions", "sessions"];
 /** Validated Session-log request contribution configuration. */
 const Config = z.object({ enabled: z.boolean().default(false) });
 const acceptanceFolds = /* @__PURE__ */ new WeakMap();
-/** Translate logical Session metadata back to the stable version-0 wire header. */
+/** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
 	const header = session.header;
 	return {
@@ -49,7 +49,7 @@ function wireEvent(event) {
 	};
 }
 /**
-* Highest confirmed sequence for this exact session identity.
+* Highest confirmed sequence for this exact Session format generation.
 * @param session - canonical log whose matching acceptance events are folded.
 * @returns greatest accepted sequence, or `-1` before any accepted request.
 */
@@ -62,6 +62,9 @@ function acceptedThrough(session) {
 		const event = session.eventAt(SessionSeq(index));
 		if (event === void 0) throw new Error(`session-log-deepseek: missing event ${String(index)} below captured length ${String(length)}`);
 		if (event.type !== "session-log-deepseek/delivery-accepted") continue;
+		const acceptedFormatVersion = event.data.sessionFormatVersion ?? 0;
+		if (!Number.isSafeInteger(acceptedFormatVersion) || acceptedFormatVersion < 0 || Object.is(acceptedFormatVersion, -0)) throw new Error(`session-log-deepseek: malformed acceptance format version at seq ${event.seq}`);
+		if (acceptedFormatVersion !== session.header.version) continue;
 		let acceptedSeq;
 		try {
 			acceptedSeq = SessionSeq(event.data.throughSeq);
@@ -96,6 +99,7 @@ function apply(ctx, config) {
 		return {
 			value: {
 				version: 1,
+				sessionFormatVersion: session.header.version,
 				session: wireHeader(session),
 				afterSeq: Number(afterSeq),
 				throughSeq: Number(throughSeq),
@@ -104,6 +108,7 @@ function apply(ctx, config) {
 			accept: () => {
 				session.append("session-log-deepseek/delivery-accepted", {
 					sessionId: session.id,
+					sessionFormatVersion: session.header.version,
 					throughSeq
 				});
 			}

package/lib/invariant.js

@@ -9,6 +9,9 @@ const inject = ["invariants"];
 /** Validate one acceptance watermark against its containing event and session. */
 function validateDeliveryAccepted(session, event, fail) {
 	const { sessionId, throughSeq } = event.data;
+	const acceptedFormatVersion = event.data.sessionFormatVersion ?? 0;
+	if (!Number.isSafeInteger(acceptedFormatVersion) || acceptedFormatVersion < 0 || Object.is(acceptedFormatVersion, -0)) fail(`session-log-deepseek/delivery-accepted sessionFormatVersion must be a non-negative safe integer, got ${String(acceptedFormatVersion)}`);
+	if (acceptedFormatVersion !== session.header.version) return;
 	const inherited = session.header.parentSession !== void 0 && !session.isOwnSeq(event.seq);
 	if (sessionId !== session.id && !inherited) fail("a non-inherited session-log-deepseek/delivery-accepted event must name its containing session");
 	let acceptedSeq;

package/lib/types/index.d.ts

@@ -20,7 +20,7 @@ export interface Config {
 /** Validated Session-log request contribution configuration. */
 export declare const Config: z<Config>;
 /**
- * Highest confirmed sequence for this exact session identity.
+ * Highest confirmed sequence for this exact Session format generation.
  * @param session - canonical log whose matching acceptance events are folded.
  * @returns greatest accepted sequence, or `-1` before any accepted request.
  */

package/lib/types/index.js

@@ -16,7 +16,7 @@ export const Config = z.object({
     enabled: z.boolean().default(false),
 });
 const acceptanceFolds = new WeakMap();
-/** Translate logical Session metadata back to the stable version-0 wire header. */
+/** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
     const header = session.header;
     return {
@@ -52,7 +52,7 @@ function wireEvent(event) {
     };
 }
 /**
- * Highest confirmed sequence for this exact session identity.
+ * Highest confirmed sequence for this exact Session format generation.
  * @param session - canonical log whose matching acceptance events are folded.
  * @returns greatest accepted sequence, or `-1` before any accepted request.
  */
@@ -68,6 +68,14 @@ export function acceptedThrough(session) {
         }
         if (event.type !== 'session-log-deepseek/delivery-accepted')
             continue;
+        const acceptedFormatVersion = event.data.sessionFormatVersion ?? 0;
+        if (!Number.isSafeInteger(acceptedFormatVersion)
+            || acceptedFormatVersion < 0
+            || Object.is(acceptedFormatVersion, -0)) {
+            throw new Error(`session-log-deepseek: malformed acceptance format version at seq ${event.seq}`);
+        }
+        if (acceptedFormatVersion !== session.header.version)
+            continue;
         let acceptedSeq;
         try {
             acceptedSeq = SessionSeq(event.data.throughSeq);
@@ -111,6 +119,7 @@ export function apply(ctx, config) {
             const suffix = session.snapshotEvents(SessionLogOffset(afterSeq + 1));
             const value = {
                 version: 1,
+                sessionFormatVersion: session.header.version,
                 session: wireHeader(session),
                 afterSeq: Number(afterSeq),
                 throughSeq: Number(throughSeq),
@@ -119,7 +128,11 @@ export function apply(ctx, config) {
             return {
                 value,
                 accept: () => {
-                    session.append('session-log-deepseek/delivery-accepted', { sessionId: session.id, throughSeq });
+                    session.append('session-log-deepseek/delivery-accepted', {
+                        sessionId: session.id,
+                        sessionFormatVersion: session.header.version,
+                        throughSeq,
+                    });
                     // TODO: Add an immediate lightweight checkpoint if duplicate replay after a 2xx crash window becomes unacceptable.
                 },
             };

package/lib/types/invariant.js

@@ -8,6 +8,15 @@ export const inject = ['invariants'];
 /** Validate one acceptance watermark against its containing event and session. */
 function validateDeliveryAccepted(session, event, fail) {
     const { sessionId, throughSeq } = event.data;
+    const acceptedFormatVersion = event.data.sessionFormatVersion ?? 0;
+    if (!Number.isSafeInteger(acceptedFormatVersion)
+        || acceptedFormatVersion < 0
+        || Object.is(acceptedFormatVersion, -0)) {
+        fail('session-log-deepseek/delivery-accepted sessionFormatVersion must be a non-negative safe integer'
+            + `, got ${String(acceptedFormatVersion)}`);
+    }
+    if (acceptedFormatVersion !== session.header.version)
+        return;
     const inherited = session.header.parentSession !== undefined
         && !session.isOwnSeq(event.seq);
     if (sessionId !== session.id && !inherited) {

package/lib/types/types.d.ts

@@ -1,7 +1,7 @@
 /** Wire types for lossless incremental DeepSeek session-log upload. */
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
 import type { JsonValue } from '@deepseek-ai/dsh-util-values';
-/** Version-0 Session header fields serialized on the external request wire. */
+/** Session header fields serialized as raw JSON primitives on the external request wire. */
 export interface DeepSeekSessionLogWireHeader {
     readonly version: number;
     readonly id: string;
@@ -33,6 +33,8 @@ export interface DeepSeekSessionLogWireEvent {
 /** Versioned incremental session-log field carried by an official DeepSeek request. */
 export interface DeepSeekSessionLogExtension {
     readonly version: 1;
+    /** Session format generation represented by this suffix. */
+    readonly sessionFormatVersion: number;
     readonly session: DeepSeekSessionLogWireHeader;
     /** Highest sequence durably recorded as accepted before this request, or `-1`. */
     readonly afterSeq: number;
@@ -52,6 +54,8 @@ declare module '@deepseek-ai/dsh-session/types' {
         'session-log-deepseek/delivery-accepted': {
             /** Session identity the accepted delivery carried; inherited fork markers retain the parent's id. */
             sessionId: import('@deepseek-ai/dsh-session/types').SessionId;
+            /** Accepted Session format generation; absence identifies version 0. */
+            sessionFormatVersion?: number;
             /** Last canonical event included in the accepted request. */
             throughSeq: import('@deepseek-ai/dsh-session/types').SessionSeq;
         };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-log-deepseek",
   "description": "Incremental lossless session-log request extension for the official DeepSeek LLM API",
-  "version": "0.1.2-alpha.5",
+  "version": "0.1.3-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,20 +37,28 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-brand": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5"
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
+    "@deepseek-ai/cordis-plugin-include": "^1.0.7",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-command-feedback": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm-mock-server": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-message-feedback": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.3-alpha.2"
   }
 }