@deepseek-ai/dsh-session-log-deepseek 0.1.7-rc.2 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: e2aa29e41bc101c4
   zh: 2ef629f2a444bc13
 /deepseek-ai-dsh-session-log-deepseek/configuration:
-  en: 1e8712ec4f0fefcc
-  zh: 5ffe754b2cefdd21
+  en: 1b899e63d8039643
+  zh: d489461bbb618b5d
 /deepseek-ai-dsh-session-log-deepseek/request-field:
   en: 197814e2c48d05b5
   zh: f4616fb23a3c7a32

package/README.md

@@ -27,10 +27,12 @@ Incremental canonical session-log upload for official DeepSeek LLM API requests.
 
 | Key | Default | Meaning |
 |---|---:|---|
-| `enabled` | `true` | Register the `dsh_session_log` contribution. Set it to `false` to stop Session-log upload. |
+| `enabled` | `true` | Send the `dsh_session_log` contribution. Changes apply to the next request; `false` stops Session-log upload. |
 | `maxBytes` | 8 MiB | Largest serialized `dsh_session_log` field, in UTF-8 bytes, that one request carries. |
 
-Shipped profiles mount the plugin, so the default configuration registers the request field and appends the acceptance watermark; an overlay opts out with `enabled: false`.
+Shipped profiles mount the plugin, so the default configuration registers the request field and appends the acceptance watermark; `enabled: false` stops the contribution. The Web switch can override bundle defaults through the active profile; home patches and command-line overlays retain precedence and reject conflicting form writes.
+
+The Web **Settings → General → Upload Session Log when using the official model API** switch persists `enabled` through the Host configuration. In-flight requests keep their prepared payload. Re-enabling resumes the unaccepted suffix, including events recorded while disabled. OpenTelemetry feedback uploads have a separate setting.
 
 <a id="request-field"></a>
 ## Request field

package/README.zh.md

@@ -27,10 +27,12 @@ kind: "package-reference"
 
 | 配置键 | 默认值 | 含义 |
 |---|---:|---|
-| `enabled` | `true` | 注册 `dsh_session_log` 贡献。将其设为 `false` 可停止会话日志上传。 |
+| `enabled` | `true` | 发送 `dsh_session_log` 贡献。修改从下一次请求生效；设为 `false` 可停止会话日志上传。 |
 | `maxBytes` | 8 MiB | 单次请求携带的 `dsh_session_log` 字段序列化后的最大 UTF-8 字节数。 |
 
-随附 profile 会挂载该插件，因此默认配置会注册请求字段并追加接受水位；overlay 可用 `enabled: false` 选择退出。
+随附 profile 会挂载该插件，因此默认配置会注册请求字段并追加接受水位；`enabled: false` 会停止贡献。Web 开关可通过当前 profile 覆盖组合包默认值；home patch 和命令行 overlay 保持更高优先级，会拒绝与其冲突的表单写入。
+
+Web **设置 → 通用 → 在使用官方模型 API 时上传 Session Log** 开关通过 Host 配置持久化 `enabled`。进行中的请求保留已准备的载荷。重新开启后继续上传尚未确认的后缀，包括关闭期间记录的事件。OpenTelemetry 反馈上传使用独立设置。
 
 <a id="request-field"></a>
 ## 请求字段

package/lib/index.js

@@ -15,7 +15,7 @@ const name = "session-log-deepseek";
 const inject = ["deepseekLlmApiExtensions", "sessions"];
 /** Validated Session-log request contribution configuration. */
 const Config = z.object({
-	enabled: z.boolean().default(true),
+	enabled: z.boolean().default(true).volatile(),
 	maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024)
 });
 const acceptanceFolds = /* @__PURE__ */ new WeakMap();
@@ -128,14 +128,14 @@ function acceptedThrough(session) {
 	return throughSeq;
 }
 /**
-* Register the incremental `dsh_session_log` request contribution when enabled.
+* Register the incremental request contribution; enablement is read for each request.
 * @param ctx - plugin context carrying Sessions and the DeepSeek request-extension registry.
 * @param config - validated configuration.
 */
 function apply(ctx, config) {
-	if (config.enabled !== true) return;
 	const { maxBytes } = config;
 	ctx.deepseekLlmApiExtensions.register("dsh_session_log", { prepare: (request) => {
+		if (!config.enabled.get()) return void 0;
 		if (request.sessionId === void 0) return void 0;
 		const session = ctx.sessions.get(brandString(request.sessionId));
 		if (session === void 0) return void 0;

package/lib/types/index.d.ts

@@ -4,7 +4,7 @@
  * can conservatively resend uncertain tails without maintaining another store.
  * @module @deepseek-ai/dsh-session-log-deepseek
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { Session, SessionSeqCursor } from '@deepseek-ai/dsh-session';
 export type * from './types.ts';
@@ -15,16 +15,22 @@ export declare const inject: string[];
 /** Session-log request contribution configuration. */
 export interface Config {
     /** Contribute `dsh_session_log` to official DeepSeek requests. Defaults to `true`. */
-    enabled?: boolean;
+    enabled: Volatile<boolean>;
     /**
      * Largest serialized `dsh_session_log` field, in UTF-8 bytes, that one request carries.
      * A request uploads the longest pending event prefix that fits; later requests continue
      * after its acceptance. Defaults to 8 MiB.
      */
-    maxBytes?: number;
+    maxBytes: number;
 }
 /** Validated Session-log request contribution configuration. */
-export declare const Config: z<Config>;
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    maxBytes: z<number, number, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    maxBytes: z<number, number, "defined">;
+}>>, "plain">;
 /**
  * Highest confirmed sequence for this exact Session format generation.
  * @param session - canonical log whose matching acceptance events are folded.
@@ -32,7 +38,7 @@ export declare const Config: z<Config>;
  */
 export declare function acceptedThrough(session: Session): SessionSeqCursor;
 /**
- * Register the incremental `dsh_session_log` request contribution when enabled.
+ * Register the incremental request contribution; enablement is read for each request.
  * @param ctx - plugin context carrying Sessions and the DeepSeek request-extension registry.
  * @param config - validated configuration.
  */

package/lib/types/index.js

@@ -14,7 +14,7 @@ export const name = 'session-log-deepseek';
 export const inject = ['deepseekLlmApiExtensions', 'sessions'];
 /** Validated Session-log request contribution configuration. */
 export const Config = z.object({
-    enabled: z.boolean().default(true),
+    enabled: z.boolean().default(true).volatile(),
     maxBytes: z.number().step(1).min(1).default(8 * 1024 * 1024),
 });
 const acceptanceFolds = new WeakMap();
@@ -134,17 +134,17 @@ export function acceptedThrough(session) {
     return throughSeq;
 }
 /**
- * Register the incremental `dsh_session_log` request contribution when enabled.
+ * Register the incremental request contribution; enablement is read for each request.
  * @param ctx - plugin context carrying Sessions and the DeepSeek request-extension registry.
  * @param config - validated configuration.
  */
 export function apply(ctx, config) {
-    if (config.enabled !== true)
-        return;
     // Schemastery validates and fills the defaults before `apply` runs.
     const { maxBytes } = config;
     ctx.deepseekLlmApiExtensions.register('dsh_session_log', {
         prepare: (request) => {
+            if (!config.enabled.get())
+                return undefined;
             // TODO: Define an explicit wire result for direct or stale-session calls if they become a supported product path.
             if (request.sessionId === undefined)
                 return undefined;

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.7-rc.2",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },
@@ -37,29 +37,29 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.1",
     "@deepseek-ai/schemastery": "~3.18.4"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "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.1.7-rc.2",
-    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-message-feedback": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm-mock-server": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-command-feedback": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-deepseek-llm-api-extensions": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm-mock-server": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-message-feedback": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.0-rc.1",
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }