@deepseek-ai/dsh-session-log-deepseek 0.1.3-alpha.2 → 0.1.5-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: 047cd8133b88ceacce1fdaafa87a60611532a18c
-README.zh.md: be6b97bc889a037847289d4f5757c12823969a63
+README.md: 38a5ec64cee32c25b11e5b7c0b55b7302f66952a
+README.zh.md: 598345ebfbc24d4786aa9e7361d947b41b5d79d0

package/README.md

@@ -34,7 +34,7 @@ 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 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.
+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. Surface events require `surfaceOp`, with numeric `startSeq` and `endSeq` for replacements; only user and tool events may carry `sourceEventSeqs`. Assistant provenance stays in the embedded stream, and log-only events carry neither metadata field.
 
 <a id="acceptance-and-retry"></a>
 ## Acceptance and retry

package/README.zh.md

@@ -34,7 +34,7 @@ kind: "package-reference"
 <a id="request-field"></a>
 ## 请求字段
 
-对于携带存活 `sessionId` 的请求，插件会折叠该确切会话格式代的最大已接受水位，对 `Session.events` 取快照，并发送水位之后的连续后缀。进程内 fold 会让每条事件只被扫描一次并增量消费后续追加；重启与 HMR 会从持久日志重建它。版本 1 字段包含 `sessionFormatVersion`、原始会话 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 会话会忽略从父会话继承的水位。 表层事件必须携带 `surfaceOp`，替换范围使用数值型 `startSeq` 与 `endSeq`；仅 user 与 tool 事件可以携带 `sourceEventSeqs`。assistant 的来源保留在内嵌流中，仅日志事件不携带这两个元数据字段。
 
 <a id="acceptance-and-retry"></a>
 ## 接受与重试

package/lib/index.js

@@ -1,6 +1,6 @@
 import z from "@deepseek-ai/schemastery";
 import { brandString } from "@deepseek-ai/dsh-brand";
-import { SessionLogOffset, SessionSeq, isSurfaceEvent } from "@deepseek-ai/dsh-session";
+import { KNOWN_SESSION_EVENT_TYPES, SessionLogOffset, SessionSeq } from "@deepseek-ai/dsh-session";
 //#region lib/types/index.js
 /**
 * Incremental session-log contribution for official DeepSeek LLM API requests.
@@ -32,20 +32,48 @@ function wireHeader(session) {
 }
 /** Translate compile-time sequence brands to raw numeric request fields. */
 function wireEvent(event) {
-	const surfaceEvent = isSurfaceEvent(event) ? event : void 0;
-	const surfaceOp = surfaceEvent?.surfaceOp;
-	return {
-		type: event.type,
+	const common = {
 		seq: Number(event.seq),
 		time: event.time,
 		data: event.data,
-		...event.ignorable === void 0 ? {} : { ignorable: event.ignorable },
-		...surfaceEvent?.sourceEventSeqs === void 0 ? {} : { sourceEventSeqs: surfaceEvent.sourceEventSeqs.map(Number) },
-		...surfaceOp === void 0 ? {} : surfaceOp === "append" ? { surfaceOp } : { surfaceOp: {
-			op: "replace",
-			start: Number(surfaceOp.start),
-			end: Number(surfaceOp.end)
-		} }
+		...event.ignorable === void 0 ? {} : { ignorable: event.ignorable }
+	};
+	switch (event.type) {
+		case "system/message":
+		case "user/message":
+		case "tool/result": return {
+			...common,
+			type: event.type,
+			surfaceOp: wireSurfaceOp(event.surfaceOp),
+			...event.sourceEventSeqs === void 0 ? {} : { sourceEventSeqs: event.sourceEventSeqs.map(Number) }
+		};
+		case "assistant/message": return {
+			...common,
+			type: event.type,
+			surfaceOp: wireSurfaceOp(event.surfaceOp)
+		};
+		default:
+			if (!KNOWN_SESSION_EVENT_TYPES.has(event.type) && event.ignorable === true) {
+				const opaque = event;
+				return {
+					...common,
+					type: event.type,
+					ignorable: true,
+					...opaque.surfaceOp === void 0 ? {} : { surfaceOp: opaque.surfaceOp },
+					...opaque.sourceEventSeqs === void 0 ? {} : { sourceEventSeqs: opaque.sourceEventSeqs }
+				};
+			}
+			return {
+				...common,
+				type: event.type
+			};
+	}
+}
+function wireSurfaceOp(op) {
+	return op === "append" ? op : {
+		op: "replace",
+		startSeq: Number(op.startSeq),
+		endSeq: Number(op.endSeq)
 	};
 }
 /**

package/lib/types/index.js

@@ -6,7 +6,7 @@
  */
 import z from '@deepseek-ai/schemastery';
 import { brandString } from '@deepseek-ai/dsh-brand';
-import { isSurfaceEvent, SessionLogOffset, SessionSeq } from '@deepseek-ai/dsh-session';
+import { KNOWN_SESSION_EVENT_TYPES, SessionLogOffset, SessionSeq } from '@deepseek-ai/dsh-session';
 /** Cordis plugin name. */
 export const name = 'session-log-deepseek';
 /** Services required to resolve sessions and contribute the provider request field. */
@@ -33,23 +33,42 @@ function wireHeader(session) {
 }
 /** Translate compile-time sequence brands to raw numeric request fields. */
 function wireEvent(event) {
-    const surfaceEvent = isSurfaceEvent(event) ? event : undefined;
-    const surfaceOp = surfaceEvent?.surfaceOp;
-    return {
-        type: event.type,
+    const common = {
         seq: Number(event.seq),
         time: event.time,
         data: event.data,
         ...event.ignorable === undefined ? {} : { ignorable: event.ignorable },
-        ...surfaceEvent?.sourceEventSeqs === undefined
-            ? {}
-            : { sourceEventSeqs: surfaceEvent.sourceEventSeqs.map(Number) },
-        ...surfaceOp === undefined
-            ? {}
-            : surfaceOp === 'append'
-                ? { surfaceOp }
-                : { surfaceOp: { op: 'replace', start: Number(surfaceOp.start), end: Number(surfaceOp.end) } },
     };
+    switch (event.type) {
+        case 'system/message':
+        case 'user/message':
+        case 'tool/result':
+            return {
+                ...common,
+                type: event.type,
+                surfaceOp: wireSurfaceOp(event.surfaceOp),
+                ...event.sourceEventSeqs === undefined ? {} : { sourceEventSeqs: event.sourceEventSeqs.map(Number) },
+            };
+        case 'assistant/message':
+            return { ...common, type: event.type, surfaceOp: wireSurfaceOp(event.surfaceOp) };
+        default: {
+            // Restored unknown ignorable records are opaque, not current surface events.
+            if (!KNOWN_SESSION_EVENT_TYPES.has(event.type) && event.ignorable === true) {
+                const opaque = event;
+                return {
+                    ...common, type: event.type, ignorable: true,
+                    ...opaque.surfaceOp === undefined ? {} : { surfaceOp: opaque.surfaceOp },
+                    ...opaque.sourceEventSeqs === undefined ? {} : { sourceEventSeqs: opaque.sourceEventSeqs },
+                };
+            }
+            return { ...common, type: event.type };
+        }
+    }
+}
+function wireSurfaceOp(op) {
+    return op === 'append'
+        ? op
+        : { op: 'replace', startSeq: Number(op.startSeq), endSeq: Number(op.endSeq) };
 }
 /**
  * Highest confirmed sequence for this exact Session format generation.

package/lib/types/types.d.ts

@@ -1,5 +1,5 @@
 /** Wire types for lossless incremental DeepSeek session-log upload. */
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import type { SessionEvent, SurfaceEventType } from '@deepseek-ai/dsh-session';
 import type { JsonValue } from '@deepseek-ai/dsh-util-values';
 /** Session header fields serialized as raw JSON primitives on the external request wire. */
 export interface DeepSeekSessionLogWireHeader {
@@ -17,19 +17,41 @@ export interface DeepSeekSessionLogWireHeader {
 /** Raw-number surface mutation serialized on the external request wire. */
 export type DeepSeekSessionLogWireSurfaceOp = 'append' | {
     readonly op: 'replace';
-    readonly start: number;
-    readonly end: number;
+    readonly startSeq: number;
+    readonly endSeq: number;
 };
-/** One complete canonical event translated to raw JSON primitives for upload. */
-export interface DeepSeekSessionLogWireEvent {
-    readonly type: SessionEvent['type'];
+/**
+ * One canonical event translated to raw JSON primitives for upload. Surface
+ * events require an operation; system, user, and tool events may cite sources.
+ * Assistant provenance is embedded in its data; log-only events carry neither field.
+ */
+export type DeepSeekSessionLogWireEvent = {
+    [K in SessionEvent['type']]: {
+        readonly type: K;
+        readonly seq: number;
+        readonly time: number;
+        readonly data: JsonValue;
+        readonly ignorable?: true;
+    } & (K extends SurfaceEventType ? {
+        readonly surfaceOp: DeepSeekSessionLogWireSurfaceOp;
+    } & (K extends 'assistant/message' ? {
+        readonly sourceEventSeqs?: never;
+    } : {
+        readonly sourceEventSeqs?: readonly number[];
+    }) : {
+        readonly surfaceOp?: never;
+        readonly sourceEventSeqs?: never;
+    });
+}[SessionEvent['type']] | {
+    /** Unrecognized ignorable records retain opaque metadata without surface semantics. */
+    readonly type: string;
     readonly seq: number;
     readonly time: number;
     readonly data: JsonValue;
-    readonly ignorable?: true;
-    readonly sourceEventSeqs?: readonly number[];
-    readonly surfaceOp?: DeepSeekSessionLogWireSurfaceOp;
-}
+    readonly ignorable: true;
+    readonly surfaceOp?: JsonValue;
+    readonly sourceEventSeqs?: JsonValue;
+};
 /** Versioned incremental session-log field carried by an official DeepSeek request. */
 export interface DeepSeekSessionLogExtension {
     readonly version: 1;

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.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,28 +37,28 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.5-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@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"
+    "@deepseek-ai/dsh-invariants": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@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"
+    "@deepseek-ai/dsh-command-feedback": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm-mock-server": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-message-feedback": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-alpha.2"
   }
 }