@deepseek-ai/dsh-deepseek-llm-api-extensions 0.2.1-alpha.1 → 0.2.1-alpha.3

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: 6b7f62c318c9aad6
   zh: 5e22d58884e60c87
 /deepseek-ai-dsh-deepseek-llm-api-extensions/service:
-  en: 5a7d0d78328568d0
-  zh: c9180f610039e688
+  en: d9782207ffab7c50
+  zh: 22c2a10a5f0de61f
 /deepseek-ai-dsh-deepseek-llm-api-extensions/model-experience:
   en: 88a785350ced5c14
   zh: 755349be023a3f5c

package/README.md

@@ -24,7 +24,7 @@ Provider-specific registry for additive top-level fields on official DeepSeek LL
 ## Service
 
 - `register(field, provider)` reserves one field for the calling fiber. Duplicate or malformed names fail synchronously; disposing the registration releases it for a later provider.
-- `prepare(request)` snapshots the registered providers, prepares them concurrently, clones and freezes returned JSON values, and returns `{ fields, accept }`. A preparation failure rejects before HTTP dispatch; request cancellation stops awaiting providers even when one ignores its signal.
+- `prepare(request)` snapshots the registered providers, prepares them concurrently, clones and freezes returned JSON values, and returns `{ fields, accept }`. A provider whose preparation throws is omitted while the other fields are returned, and only its first failure is logged; request cancellation rejects and stops awaiting providers even when one ignores its signal.
 - `accept()` runs every captured post-2xx callback once. Concurrent calls join the same settlement, every callback settles before failures are reported, and several failures become one `AggregateError`.
 
 Each provider sees the exact serialized Messages body, the request `AbortSignal`, plus optional `sessionId` and auxiliary-call `purpose`. It must stop its own work promptly after cancellation and returns `undefined` when its field does not apply to that request. A prepared operation retains the providers it captured even if HMR removes their registrations before HTTP acceptance.

package/README.zh.md

@@ -24,7 +24,7 @@ kind: "package-reference"
 ## 服务
 
 - `register(field, provider)` 为调用 fiber 保留一个字段。重复或格式错误的名称会同步失败；dispose（资源释放）该注册后，后续提供方可以再次认领。
-- `prepare(request)` 对已注册提供方取快照，并发准备贡献，克隆并冻结返回的 JSON 值，然后返回 `{ fields, accept }`。准备失败会在 HTTP 分发前拒绝请求；请求取消后，即使某个提供方忽略信号，注册表也会停止等待。
+- `prepare(request)` 对已注册提供方取快照，并发准备贡献，克隆并冻结返回的 JSON 值，然后返回 `{ fields, accept }`。某个提供方准备时抛错，注册表会省略其字段，其余字段照常返回，且只记录该字段的首次失败；请求取消会使 `prepare` 拒绝，即使某个提供方忽略信号，注册表也会停止等待。
 - `accept()` 对每个捕获的 2xx 后回调只运行一次。并发调用会等待同一次结算，所有回调都在报告失败前完成，多个失败会合并为一个 `AggregateError`。
 
 每个提供方都会看到确切的已序列化 Messages 请求体、请求 `AbortSignal`，以及可选的 `sessionId` 与辅助调用 `purpose`。提供方必须在取消后迅速停止自身工作；字段不适用于当前请求时返回 `undefined`。即使 HMR（热模块替换）在 HTTP 接受前移除了注册，已准备的操作仍会保留其捕获的提供方。

package/lib/index.js

@@ -38,6 +38,8 @@ async function abortable(work, signal) {
 /** Registry of independently owned top-level fields for official DeepSeek requests. */
 var DeepSeekLlmApiExtensionRegistry = class extends Service {
 	providers = /* @__PURE__ */ new Map();
+	/** Fields whose preparation failure was already logged; later failures stay silent. */
+	warnedFields = /* @__PURE__ */ new Set();
 	constructor(ctx) {
 		super(ctx, "deepseekLlmApiExtensions");
 	}
@@ -62,23 +64,37 @@ var DeepSeekLlmApiExtensionRegistry = class extends Service {
 	}
 	/**
 	* Prepare every currently registered field from one immutable base request.
-	* Preparation failures reject before HTTP dispatch. Field values are cloned and frozen;
-	* providers retain no mutable alias to the outgoing request.
+	* A provider whose preparation throws, or whose value cannot be cloned, is omitted
+	* from this request; the first such failure per field is logged. Only cancellation rejects. Field values are cloned
+	* and frozen; providers retain no mutable alias to the outgoing request.
 	* @param request - exact serialized request facts before extension fields.
 	* @returns detached fields and their idempotent joint acceptance transaction.
 	*/
 	async prepare(request) {
 		request.signal.throwIfAborted();
 		const entries = [...this.providers.entries()];
-		const prepared = await abortable(Promise.all(entries.map(async ([field, provider]) => ({
-			field,
-			result: await provider.prepare(request)
-		}))), request.signal);
+		const prepared = await abortable(Promise.all(entries.map(async ([field, provider]) => {
+			try {
+				const result = await provider.prepare(request);
+				return result === void 0 ? void 0 : {
+					field,
+					value: freezeJson(structuredClone(result.value)),
+					result
+				};
+			} catch (error) {
+				if (!request.signal.aborted && !this.warnedFields.has(field)) {
+					this.warnedFields.add(field);
+					this.ctx.logger.warn(`deepseek-llm-api-extensions: omitting field ${JSON.stringify(field)} from this request because its preparation failed: %o`, error);
+				}
+				return;
+			}
+		})), request.signal);
 		const fields = Object.create(null);
 		const callbacks = [];
-		for (const { field, result } of prepared) {
-			if (result === void 0) continue;
-			fields[field] = freezeJson(structuredClone(result.value));
+		for (const item of prepared) {
+			if (item === void 0) continue;
+			const { field, value, result } = item;
+			fields[field] = value;
 			const accept = result.accept;
 			if (accept !== void 0) callbacks.push(accept.bind(result));
 		}

package/lib/types/index.d.ts

@@ -14,6 +14,8 @@ declare module '@deepseek-ai/cordis' {
 /** Registry of independently owned top-level fields for official DeepSeek requests. */
 export declare class DeepSeekLlmApiExtensionRegistry extends Service {
     private readonly providers;
+    /** Fields whose preparation failure was already logged; later failures stay silent. */
+    private readonly warnedFields;
     constructor(ctx: Context);
     /**
      * Register the sole provider of one top-level request field. Registration is effect-scoped.
@@ -24,8 +26,9 @@ export declare class DeepSeekLlmApiExtensionRegistry extends Service {
     register<K extends keyof DeepSeekLlmApiExtensionMap>(field: K, provider: DeepSeekLlmApiExtensionProvider<DeepSeekLlmApiExtensionMap[K]>): () => Promise<void>;
     /**
      * Prepare every currently registered field from one immutable base request.
-     * Preparation failures reject before HTTP dispatch. Field values are cloned and frozen;
-     * providers retain no mutable alias to the outgoing request.
+     * A provider whose preparation throws, or whose value cannot be cloned, is omitted
+     * from this request; the first such failure per field is logged. Only cancellation rejects. Field values are cloned
+     * and frozen; providers retain no mutable alias to the outgoing request.
      * @param request - exact serialized request facts before extension fields.
      * @returns detached fields and their idempotent joint acceptance transaction.
      */

package/lib/types/index.js

@@ -42,6 +42,8 @@ async function abortable(work, signal) {
 /** Registry of independently owned top-level fields for official DeepSeek requests. */
 export class DeepSeekLlmApiExtensionRegistry extends Service {
     providers = new Map();
+    /** Fields whose preparation failure was already logged; later failures stay silent. */
+    warnedFields = new Set();
     constructor(ctx) {
         super(ctx, 'deepseekLlmApiExtensions');
     }
@@ -71,24 +73,35 @@ export class DeepSeekLlmApiExtensionRegistry extends Service {
     }
     /**
      * Prepare every currently registered field from one immutable base request.
-     * Preparation failures reject before HTTP dispatch. Field values are cloned and frozen;
-     * providers retain no mutable alias to the outgoing request.
+     * A provider whose preparation throws, or whose value cannot be cloned, is omitted
+     * from this request; the first such failure per field is logged. Only cancellation rejects. Field values are cloned
+     * and frozen; providers retain no mutable alias to the outgoing request.
      * @param request - exact serialized request facts before extension fields.
      * @returns detached fields and their idempotent joint acceptance transaction.
      */
     async prepare(request) {
         request.signal.throwIfAborted();
         const entries = [...this.providers.entries()];
-        const prepared = await abortable(Promise.all(entries.map(async ([field, provider]) => ({
-            field,
-            result: await provider.prepare(request),
-        }))), request.signal);
+        const prepared = await abortable(Promise.all(entries.map(async ([field, provider]) => {
+            try {
+                const result = await provider.prepare(request);
+                return result === undefined ? undefined : { field, value: freezeJson(structuredClone(result.value)), result };
+            }
+            catch (error) {
+                if (!request.signal.aborted && !this.warnedFields.has(field)) {
+                    this.warnedFields.add(field);
+                    this.ctx.logger.warn(`deepseek-llm-api-extensions: omitting field ${JSON.stringify(field)} from this request because its preparation failed: %o`, error);
+                }
+                return undefined;
+            }
+        })), request.signal);
         const fields = Object.create(null);
         const callbacks = [];
-        for (const { field, result } of prepared) {
-            if (result === undefined)
+        for (const item of prepared) {
+            if (item === undefined)
                 continue;
-            fields[field] = freezeJson(structuredClone(result.value));
+            const { field, value, result } = item;
+            fields[field] = value;
             const accept = result.accept;
             if (accept !== undefined)
                 callbacks.push(accept.bind(result));

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "deepseek-llm-api-extensions"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek API 扩展",
+    "description": "允许其他插件向 DeepSeek 模型请求添加扩展字段。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-deepseek-llm-api-extensions",
   "description": "Additive request-field registry for the official DeepSeek LLM API adapter",
-  "version": "0.2.1-alpha.1",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -23,18 +23,20 @@
       "default": "./lib/types/types.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   }
 }