@deepseek-ai/dsh-session-log-deepseek 0.2.0-rc.2 → 0.2.1-alpha.2

package/README.i18n.yaml

@@ -18,8 +18,8 @@
   en: 1b899e63d8039643
   zh: d489461bbb618b5d
 /deepseek-ai-dsh-session-log-deepseek/request-field:
-  en: 197814e2c48d05b5
-  zh: f4616fb23a3c7a32
+  en: 65795dc44af4b15e
+  zh: 849c7d57f16f66af
 /deepseek-ai-dsh-session-log-deepseek/acceptance-and-retry:
   en: 3688592c474b3e95
   zh: 5e83afeb9aa9e9e3

package/README.md

@@ -39,7 +39,7 @@ The Web **Settings → General → Upload Session Log when using the official mo
 
 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 longest contiguous run after the watermark that fits `maxBytes`. 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 system, user, and tool events may carry `sourceEventSeqs`. Assistant provider metadata stays in the embedded stream, and log-only events carry neither metadata field.
 
-`maxBytes` bounds the complete serialized field in UTF-8 bytes, including the header and numeric envelope fields. A backlog above the limit drains across consecutive accepted requests, each continuing after the previous `throughSeq`. When the first pending event alone exceeds the limit, the request omits `dsh_session_log`, the plugin logs a warning, and the watermark stays before that event until `maxBytes` admits it. An event too large for the runtime to serialize at all is handled the same way, and no `maxBytes` value admits it.
+`maxBytes` bounds the complete serialized field in UTF-8 bytes, including the header and numeric envelope fields. A backlog above the limit drains across consecutive accepted requests, each continuing after the previous `throughSeq`. When the first pending event alone exceeds the limit, the request omits `dsh_session_log`, the plugin logs one warning per blocking event, and the watermark stays before that event until `maxBytes` admits it. An event too large for the runtime to serialize at all is handled the same way, and no `maxBytes` value admits it.
 
 <a id="acceptance-and-retry"></a>
 ## Acceptance and retry

package/README.zh.md

@@ -39,7 +39,7 @@ Web **设置 → 通用 → 在使用官方模型 API 时上传 Session Log**
 
 对于携带存活 `sessionId` 的请求，插件会折叠该确切会话格式代的最大已接受水位，对 `Session.events` 取快照，并发送水位之后能放进 `maxBytes` 的最长连续事件段。进程内 fold 会让每条事件只被扫描一次并增量消费后续追加；重启与 HMR（热模块替换）会从持久日志重建它。版本 1 字段包含 `sessionFormatVersion`、原始会话 header（仅 seeded Session 携带 `seedLength`）、数值型 `afterSeq` 与 `throughSeq`，以及每个已转换为原始数值 envelope 字段的完整规范事件。只有记录的会话 id 与格式代均匹配请求来源时水位才生效，因此 fork 会话会忽略从父会话继承的水位。表层事件必须携带 `surfaceOp`，替换范围使用数值型 `startSeq` 与 `endSeq`；仅 system、user 与 tool 事件可以携带 `sourceEventSeqs`。assistant 的提供方元数据保留在内嵌流中，只出现在日志中的事件不携带这两个元数据字段。
 
-`maxBytes` 按 UTF-8 字节限制完整的序列化字段，包括 header 与数值型 envelope 字段。超过上限的积压会分多次已接受的请求补传，每次都从上一次的 `throughSeq` 之后继续。第一条待发事件本身就超过上限时，请求会省略 `dsh_session_log`，插件记录一条告警，水位停在该事件之前，直到 `maxBytes` 能容纳它。运行时根本无法序列化的超大事件也按同样方式处理，且任何 `maxBytes` 都无法容纳它。
+`maxBytes` 按 UTF-8 字节限制完整的序列化字段，包括 header 与数值型 envelope 字段。超过上限的积压会分多次已接受的请求补传，每次都从上一次的 `throughSeq` 之后继续。第一条待发事件本身就超过上限时，请求会省略 `dsh_session_log`，插件对每个阻塞事件只记录一次告警，水位停在该事件之前，直到 `maxBytes` 能容纳它。运行时根本无法序列化的超大事件也按同样方式处理，且任何 `maxBytes` 都无法容纳它。
 
 <a id="acceptance-and-retry"></a>
 ## 接受与重试

package/lib/index.js

@@ -19,6 +19,8 @@ const Config = z.object({
 	maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024)
 });
 const acceptanceFolds = /* @__PURE__ */ new WeakMap();
+/** Event each Session's upload was last reported blocked at; a block is logged once. */
+const blockedWarnings = /* @__PURE__ */ new WeakMap();
 /** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
 	const header = session.header;
@@ -165,7 +167,8 @@ function apply(ctx, config) {
 		const last = events.length === 0 ? void 0 : pending[events.length - 1];
 		if (last === void 0) {
 			const first = pending[0];
-			if (first !== void 0) {
+			if (first !== void 0 && blockedWarnings.get(session) !== first.seq) {
+				blockedWarnings.set(session, first.seq);
 				const seq = String(first.seq);
 				ctx.logger.warn(Number.isFinite(candidateBytes) ? `session-log-deepseek: event ${seq} of session "${session.id}" needs a ${String(candidateBytes)}-byte dsh_session_log field, above maxBytes ${String(maxBytes)}; this session's upload stays at event ${seq} until maxBytes admits it` : `session-log-deepseek: event ${seq} of session "${session.id}" is too large to serialize into a dsh_session_log field; this session's upload stays at event ${seq}`);
 			}

package/lib/types/index.js

@@ -18,6 +18,8 @@ export const Config = z.object({
     maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024),
 });
 const acceptanceFolds = new WeakMap();
+/** Event each Session's upload was last reported blocked at; a block is logged once. */
+const blockedWarnings = new WeakMap();
 /** Translate logical Session metadata to raw external request fields. */
 function wireHeader(session) {
     const header = session.header;
@@ -177,7 +179,8 @@ export function apply(ctx, config) {
             const last = events.length === 0 ? undefined : pending[events.length - 1];
             if (last === undefined) {
                 const first = pending[0];
-                if (first !== undefined) {
+                if (first !== undefined && blockedWarnings.get(session) !== first.seq) {
+                    blockedWarnings.set(session, first.seq);
                     const seq = String(first.seq);
                     ctx.logger.warn(Number.isFinite(candidateBytes)
                         ? `session-log-deepseek: event ${seq} of session "${session.id}" needs a ${String(candidateBytes)}-byte`

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.2.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -18,10 +18,6 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./types": {
       "types": "./lib/types/types.d.ts",
       "default": "./lib/types/types.js"
@@ -31,35 +27,32 @@
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2",
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/cordis-plugin-include": "~1.0.9",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-command-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm-mock-server": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-message-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/cordis-plugin-include": "~1.0.10-alpha.1",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-command-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-mock-server": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-message-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2"
   }
 }

package/lib/invariant.js

@@ -1,52 +0,0 @@
-import { SessionSeq } from "@deepseek-ai/dsh-session";
-//#region lib/types/invariant.js
-/** Package-owned invariants for DeepSeek session-log acceptance watermarks. */
-const PACKAGE_NAME = "@deepseek-ai/dsh-session-log-deepseek";
-/** Cordis companion plugin name. */
-const name = "session-log-deepseek-invariant";
-/** Service required before the companion can reserve package ownership. */
-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;
-	try {
-		acceptedSeq = SessionSeq(throughSeq);
-	} catch {
-		fail(`session-log-deepseek/delivery-accepted throughSeq must identify an earlier event, got ${throughSeq} at seq ${event.seq}`);
-	}
-	if (acceptedSeq >= event.seq) fail(`session-log-deepseek/delivery-accepted throughSeq must identify an earlier event, got ${throughSeq} at seq ${event.seq}`);
-}
-/** Validate acceptance watermarks already present in one Session. */
-function validateSession(session, fail) {
-	for (const event of session.snapshotEvents()) if (event.type === "session-log-deepseek/delivery-accepted") validateDeliveryAccepted(session, event, fail);
-}
-/** Validate one live session-event dispatch. */
-function validateDispatched(args, fail) {
-	const [session, event] = args;
-	if (event.type === "session-log-deepseek/delivery-accepted") validateDeliveryAccepted(session, event, fail);
-}
-/** Install validation for restored, newly created, and newly appended watermarks. */
-const install = Object.assign((ctx, fail) => {
-	const validateExisting = (session) => {
-		validateSession(session, fail);
-	};
-	ctx.sessions.list().forEach(validateExisting);
-	ctx.on("session/created", validateExisting, { global: true });
-	ctx.on("internal/dispatch", (_mode, eventName, args) => {
-		if (eventName === "session/event") validateDispatched(args, fail);
-	}, { global: true });
-}, { inject: ["sessions"] });
-/**
-* 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,13 +0,0 @@
-/** Package-owned invariants for DeepSeek session-log acceptance watermarks. */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "session-log-deepseek-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

package/lib/types/invariant.js

@@ -1,66 +0,0 @@
-/** Package-owned invariants for DeepSeek session-log acceptance watermarks. */
-import { SessionSeq } from '@deepseek-ai/dsh-session';
-const PACKAGE_NAME = '@deepseek-ai/dsh-session-log-deepseek';
-/** Cordis companion plugin name. */
-export const name = 'session-log-deepseek-invariant';
-/** Service required before the companion can reserve package ownership. */
-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) {
-        fail('a non-inherited session-log-deepseek/delivery-accepted event must name its containing session');
-    }
-    let acceptedSeq;
-    try {
-        acceptedSeq = SessionSeq(throughSeq);
-    }
-    catch {
-        fail(`session-log-deepseek/delivery-accepted throughSeq must identify an earlier event, got ${throughSeq} at seq ${event.seq}`);
-    }
-    if (acceptedSeq >= event.seq) {
-        fail(`session-log-deepseek/delivery-accepted throughSeq must identify an earlier event, got ${throughSeq} at seq ${event.seq}`);
-    }
-}
-/** Validate acceptance watermarks already present in one Session. */
-function validateSession(session, fail) {
-    // oxlint-disable-next-line typescript/no-deprecated -- Existing Session history read; migration deferred.
-    for (const event of session.snapshotEvents()) {
-        if (event.type === 'session-log-deepseek/delivery-accepted')
-            validateDeliveryAccepted(session, event, fail);
-    }
-}
-/** Validate one live session-event dispatch. */
-function validateDispatched(args, fail) {
-    const [session, event] = args;
-    if (event.type === 'session-log-deepseek/delivery-accepted')
-        validateDeliveryAccepted(session, event, fail);
-}
-/** Install validation for restored, newly created, and newly appended watermarks. */
-const install = Object.assign((ctx, fail) => {
-    const validateExisting = (session) => { validateSession(session, fail); };
-    ctx.sessions.list().forEach(validateExisting);
-    ctx.on('session/created', validateExisting, { global: true });
-    ctx.on('internal/dispatch', (_mode, eventName, args) => {
-        if (eventName === 'session/event')
-            validateDispatched(args, fail);
-    }, { global: true });
-}, { inject: ['sessions'] });
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//# sourceMappingURL=invariant.js.map