@rei-standard/amsg-server 2.3.2 → 2.4.0-next.2

package/README.md

@@ -9,7 +9,7 @@
 - 业务端点统一使用 `Authorization: Bearer <tenantToken>`
 - `send-notifications` 支持 `cronToken`（Header 或 query token）
 
-2.2+ 的字段增量（`messages` 数组、`splitPattern`、`avatarUrl` 严格校验）在规范的 [§6.1](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#61-ai-消息字段约束) / [§6.2](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#62-avatarurl-严格校验)；行为已对齐 `amsg-instant`，向后兼容。
+2.2+ 的字段增量（`messages` 数组、`splitPattern`、`avatarUrl` 软清空策略）在规范的 [§6.1](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#61-ai-消息字段约束) / [§6.2](https://github.com/Tosd0/ReiStandard/blob/main/standards/active-messaging-api.md#62-avatarurl-软清空策略)；行为已对齐 `amsg-instant`，向后兼容。
 
 ## 安装
 

package/dist/index.cjs

@@ -190,7 +190,8 @@ function validateScheduleMessagePayload(payload) {
   }
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: avatarErr, details: { invalidFields: ["avatarUrl"] } };
+    console.warn("[amsg-server] avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u7F6E\u7A7A\uFF1A", avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["uuid (invalid UUID format)"] } };
@@ -482,6 +483,10 @@ function isUniqueViolation(error) {
 
 // src/server/lib/message-processor.js
 
+
+
+
+var _amsgshared = require('@rei-standard/amsg-shared');
 var DEFAULT_SPLIT_REGEX = /([。！？!?]+)/;
 function splitOnceByRegex(chunk, regex) {
   const out = chunk.split(regex).reduce((acc, part, i, arr) => {
@@ -502,6 +507,22 @@ function splitMessageIntoSentences(messageContent, splitPattern = null) {
   }
   return chunks.length > 0 ? chunks : [messageContent];
 }
+function readReasoningContent(llmResponse) {
+  if (!llmResponse || typeof llmResponse !== "object") return null;
+  const choices = (
+    /** @type {{ choices?: unknown }} */
+    llmResponse.choices
+  );
+  if (!Array.isArray(choices) || choices.length === 0) return null;
+  const message = (
+    /** @type {{ message?: { reasoning_content?: unknown } }} */
+    _optionalChain([choices, 'access', _2 => _2[0], 'optionalAccess', _3 => _3.message])
+  );
+  const raw = _optionalChain([message, 'optionalAccess', _4 => _4.reasoning_content]);
+  if (typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
 async function processSingleMessage(task, ctx, providedMasterKey) {
   try {
     const masterKey = providedMasterKey || ctx.masterKey;
@@ -511,19 +532,24 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     const userKey = deriveUserEncryptionKey(task.user_id, masterKey);
     const decryptedPayload = JSON.parse(decryptFromStorage(task.encrypted_payload, userKey));
     let messageContent;
+    let llmResponse = null;
     if (decryptedPayload.messageType === "fixed") {
       messageContent = decryptedPayload.userMessage;
     } else if (decryptedPayload.messageType === "instant") {
       const hasPrompt = !!decryptedPayload.completePrompt || Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0;
       if (hasPrompt && decryptedPayload.apiUrl && decryptedPayload.apiKey && decryptedPayload.primaryModel) {
-        messageContent = await _callAI(decryptedPayload);
+        const aiResult = await _callAI(decryptedPayload);
+        messageContent = aiResult.content;
+        llmResponse = aiResult.response;
       } else if (decryptedPayload.userMessage) {
         messageContent = decryptedPayload.userMessage;
       } else {
         throw new Error("Invalid instant message: no content source available");
       }
     } else if (decryptedPayload.messageType === "prompted" || decryptedPayload.messageType === "auto") {
-      messageContent = await _callAI(decryptedPayload);
+      const aiResult = await _callAI(decryptedPayload);
+      messageContent = aiResult.content;
+      llmResponse = aiResult.response;
     } else {
       throw new Error("Invalid message configuration: no content source available");
     }
@@ -532,23 +558,48 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
       throw new Error("VAPID configuration missing - push notifications cannot be sent");
     }
     const pushSubscription = decryptedPayload.pushSubscription;
-    for (let i = 0; i < messages.length; i++) {
-      const notificationPayload = {
+    const sessionId = task.id != null ? `sess_task_${task.id}` : `sess_${_crypto.randomUUID.call(void 0, )}`;
+    const source = decryptedPayload.messageType === "instant" ? "instant" : "scheduled";
+    const messageSubtype = decryptedPayload.messageSubtype || "chat";
+    const avatarUrl = decryptedPayload.avatarUrl || null;
+    const metadata = decryptedPayload.metadata || {};
+    const messageIdBase = task.id != null ? `msg_task_${task.id}` : `msg_${_crypto.randomUUID.call(void 0, )}_instant`;
+    const reasoning = readReasoningContent(llmResponse);
+    if (reasoning) {
+      const reasoningPush = _amsgshared.buildReasoningPush.call(void 0, {
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_reasoning`,
+        sessionId,
+        reasoningContent: reasoning,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         title: `\u6765\u81EA ${decryptedPayload.contactName}`,
+        contactName: decryptedPayload.contactName,
+        avatarUrl,
+        messageSubtype,
+        metadata
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(reasoningPush));
+      await new Promise((resolve) => setTimeout(resolve, 1500));
+    }
+    for (let i = 0; i < messages.length; i++) {
+      const contentPush = _amsgshared.buildContentPush.call(void 0, {
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_${i}`,
+        sessionId,
         message: messages[i],
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        title: `\u6765\u81EA ${decryptedPayload.contactName}`,
         contactName: decryptedPayload.contactName,
-        messageId: `msg_${_crypto.randomUUID.call(void 0, )}_${task.id || "instant"}_${i}`,
+        avatarUrl,
+        messageSubtype,
         messageIndex: i + 1,
         totalMessages: messages.length,
-        messageType: decryptedPayload.messageType,
-        messageSubtype: decryptedPayload.messageSubtype || "chat",
         taskId: task.id || null,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        source: decryptedPayload.messageType === "instant" ? "instant" : "scheduled",
-        avatarUrl: decryptedPayload.avatarUrl || null,
-        metadata: decryptedPayload.metadata || {}
-      };
-      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(notificationPayload));
+        metadata
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(contentPush));
       if (i < messages.length - 1) {
         await new Promise((resolve) => setTimeout(resolve, 1500));
       }
@@ -643,11 +694,11 @@ async function _callAI(payload) {
     );
   }
   const aiData = await aiResponse.json();
-  const content = _optionalChain([aiData, 'optionalAccess', _2 => _2.choices, 'optionalAccess', _3 => _3[0], 'optionalAccess', _4 => _4.message, 'optionalAccess', _5 => _5.content]);
+  const content = _optionalChain([aiData, 'optionalAccess', _5 => _5.choices, 'optionalAccess', _6 => _6[0], 'optionalAccess', _7 => _7.message, 'optionalAccess', _8 => _8.content]);
   if (typeof content !== "string" || !content.trim()) {
     throw new Error("AI API error: response missing choices[0].message.content");
   }
-  return content.trim();
+  return { response: aiData, content: content.trim() };
 }
 function buildAiRequestBody(payload) {
   const llmMessages = Array.isArray(payload.messages) && payload.messages.length > 0 ? payload.messages : [{ role: "user", content: payload.completePrompt }];
@@ -1102,7 +1153,8 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, "avatarUrl")) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: avatarErr, details: { invalidFields: ["avatarUrl"] } } } };
+        console.warn("[amsg-server] update-message avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u5FFD\u7565\uFF1A", avatarErr);
+        delete updates.avatarUrl;
       }
     }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);
@@ -1326,7 +1378,7 @@ async function resolveBlobStore(namespace) {
   }
   try {
     const blobModule = await Promise.resolve().then(() => _interopRequireWildcard(require("@netlify/blobs")));
-    const getStore = blobModule.getStore || _optionalChain([blobModule, 'access', _6 => _6.default, 'optionalAccess', _7 => _7.getStore]);
+    const getStore = blobModule.getStore || _optionalChain([blobModule, 'access', _9 => _9.default, 'optionalAccess', _10 => _10.getStore]);
     if (typeof getStore === "function") {
       return getStore({ name: namespace });
     }

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { createDecipheriv, createHash, randomBytes, createCipheriv, randomUUID, timingSafeEqual, createHmac } from 'crypto';
+import { buildReasoningPush, buildContentPush } from '@rei-standard/amsg-shared';
 
 /**
  * Adapter Factory
@@ -315,7 +316,11 @@ function validateScheduleMessagePayload(payload) {
 
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: avatarErr, details: { invalidFields: ['avatarUrl'] } };
+    // Soft-strip: a bad avatarUrl (data: URI / oversized / malformed) used to
+    // 400 the whole schedule. Avatar is cosmetic — drop the field, log, and
+    // let the rest of the task ship. See standards §6.2.
+    console.warn('[amsg-server] avatarUrl 不合法，已置空：', avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['uuid (invalid UUID format)'] } };
@@ -793,11 +798,23 @@ function isUniqueViolation(error) {
 
 /**
  * Message Processor (SDK version)
- * ReiStandard SDK v2.0.1
+ * ReiStandard amsg-server v2.4.0
+ *
+ * Handles single message content generation and Web Push delivery for
+ * scheduled tasks (`fixed` / `prompted` / `auto`) and the legacy
+ * via-server instant path (`messageType: 'instant'`).
  *
- * Handles single message content generation and Web Push delivery.
- * Receives its dependencies (encryption helpers, webpush, VAPID config)
- * via a context object so that it stays free of process.env references.
+ * Push wire shape comes from `@rei-standard/amsg-shared`'s
+ * discriminated union (`AmsgPush`). The SW (`@rei-standard/amsg-sw`)
+ * routes on `messageKind`. Server-driven pushes always carry
+ * `source: 'instant'` (for the legacy in-server instant) or
+ * `source: 'scheduled'` (for everything else).
+ *
+ * v2.4.0: when the LLM response carries non-empty
+ * `choices[0].message.reasoning_content`, the processor now emits a
+ * standalone `ReasoningPush` **before** the `ContentPush` burst.
+ * `messagesSent` in the return value continues to reflect the sentence
+ * count only (reasoning is an auxiliary push, not a sentence).
  */
 
 
@@ -850,6 +867,25 @@ function splitMessageIntoSentences(messageContent, splitPattern = null) {
   return chunks.length > 0 ? chunks : [messageContent];
 }
 
+/**
+ * Read `choices[0].message.reasoning_content` as a non-empty trimmed
+ * string, or null when absent / empty. Mirrors
+ * `amsg-instant/src/message-processor.js#readReasoningContent`.
+ *
+ * @param {unknown} llmResponse
+ * @returns {string | null}
+ */
+function readReasoningContent(llmResponse) {
+  if (!llmResponse || typeof llmResponse !== 'object') return null;
+  const choices = /** @type {{ choices?: unknown }} */ (llmResponse).choices;
+  if (!Array.isArray(choices) || choices.length === 0) return null;
+  const message = /** @type {{ message?: { reasoning_content?: unknown } }} */ (choices[0])?.message;
+  const raw = message?.reasoning_content;
+  if (typeof raw !== 'string') return null;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
 /**
  * @typedef {Object} ProcessorContext
  * @property {Object}  webpush           - The web-push module instance (already VAPID-configured).
@@ -876,14 +912,19 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     const decryptedPayload = JSON.parse(decryptFromStorage(task.encrypted_payload, userKey));
 
     let messageContent;
+    /** @type {unknown} */
+    let llmResponse = null;
 
     if (decryptedPayload.messageType === 'fixed') {
       messageContent = decryptedPayload.userMessage;
 
     } else if (decryptedPayload.messageType === 'instant') {
-      const hasPrompt = !!decryptedPayload.completePrompt || (Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0);
+      const hasPrompt = !!decryptedPayload.completePrompt
+        || (Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0);
       if (hasPrompt && decryptedPayload.apiUrl && decryptedPayload.apiKey && decryptedPayload.primaryModel) {
-        messageContent = await _callAI(decryptedPayload);
+        const aiResult = await _callAI(decryptedPayload);
+        messageContent = aiResult.content;
+        llmResponse = aiResult.response;
       } else if (decryptedPayload.userMessage) {
         messageContent = decryptedPayload.userMessage;
       } else {
@@ -891,7 +932,9 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
       }
 
     } else if (decryptedPayload.messageType === 'prompted' || decryptedPayload.messageType === 'auto') {
-      messageContent = await _callAI(decryptedPayload);
+      const aiResult = await _callAI(decryptedPayload);
+      messageContent = aiResult.content;
+      llmResponse = aiResult.response;
     } else {
       throw new Error('Invalid message configuration: no content source available');
     }
@@ -908,25 +951,68 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     }
 
     const pushSubscription = decryptedPayload.pushSubscription;
+    // sessionId is shared across the optional ReasoningPush and every
+    // ContentPush from this LLM round. Pin it to the task id when
+    // available (scheduled tasks) so retries reuse the same id;
+    // otherwise mint a UUID.
+    const sessionId = task.id != null
+      ? `sess_task_${task.id}`
+      : `sess_${randomUUID()}`;
+    const source = decryptedPayload.messageType === 'instant' ? 'instant' : 'scheduled';
+    const messageSubtype = decryptedPayload.messageSubtype || 'chat';
+    const avatarUrl = decryptedPayload.avatarUrl || null;
+    const metadata = decryptedPayload.metadata || {};
+
+    // `messageId` format — deterministic when we have a task.id so a
+    // retry produces the same id for the same (task, sentence) pair
+    // (downstream dedupers can key on it). Falls back to a UUID for
+    // the legacy in-server instant path that has no row id.
+    const messageIdBase = task.id != null
+      ? `msg_task_${task.id}`
+      : `msg_${randomUUID()}_instant`;
+
+    // ReasoningPush — auto-emitted before the content burst when the
+    // LLM response carried non-empty reasoning_content. `fixed` and
+    // explicit-userMessage paths produce no LLM response, so this
+    // block is naturally skipped for them (llmResponse stays null).
+    const reasoning = readReasoningContent(llmResponse);
+    if (reasoning) {
+      const reasoningPush = buildReasoningPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_reasoning`,
+        sessionId,
+        reasoningContent: reasoning,
+        timestamp: new Date().toISOString(),
+        title: `来自 ${decryptedPayload.contactName}`,
+        contactName: decryptedPayload.contactName,
+        avatarUrl,
+        messageSubtype,
+        metadata,
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(reasoningPush));
+      await new Promise(resolve => setTimeout(resolve, 1500));
+    }
 
     for (let i = 0; i < messages.length; i++) {
-      const notificationPayload = {
-        title: `来自 ${decryptedPayload.contactName}`,
+      const contentPush = buildContentPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_${i}`,
+        sessionId,
         message: messages[i],
+        timestamp: new Date().toISOString(),
+        title: `来自 ${decryptedPayload.contactName}`,
         contactName: decryptedPayload.contactName,
-        messageId: `msg_${randomUUID()}_${task.id || 'instant'}_${i}`,
+        avatarUrl,
+        messageSubtype,
         messageIndex: i + 1,
         totalMessages: messages.length,
-        messageType: decryptedPayload.messageType,
-        messageSubtype: decryptedPayload.messageSubtype || 'chat',
         taskId: task.id || null,
-        timestamp: new Date().toISOString(),
-        source: decryptedPayload.messageType === 'instant' ? 'instant' : 'scheduled',
-        avatarUrl: decryptedPayload.avatarUrl || null,
-        metadata: decryptedPayload.metadata || {}
-      };
+        metadata,
+      });
 
-      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(notificationPayload));
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(contentPush));
 
       if (i < messages.length - 1) {
         await new Promise(resolve => setTimeout(resolve, 1500));
@@ -1030,7 +1116,15 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
 
 /**
  * Call an OpenAI-compatible API.
+ *
+ * Returns the full response object alongside the extracted (trimmed)
+ * `content` string. Callers that only need the text can ignore
+ * `response`; callers that want `reasoning_content` / `tool_calls`
+ * read from `response.choices[0].message`.
+ *
  * @private
+ * @param {Object} payload
+ * @returns {Promise<{ response: unknown, content: string }>}
  */
 async function _callAI(payload) {
   const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
@@ -1067,7 +1161,7 @@ async function _callAI(payload) {
     throw new Error('AI API error: response missing choices[0].message.content');
   }
 
-  return content.trim();
+  return { response: aiData, content: content.trim() };
 }
 
 /**
@@ -1125,20 +1219,6 @@ function buildAiRequestBody(payload) {
  * to avoid an architectural dependency (server should not depend on the
  * stateless worker package).
  *
- * Rules (idempotent — running it twice equals running it once):
- *   - Already ends with `/chat/completions`             → leave as-is.
- *   - Bare host (no path or just `/`)                   → append `/v1/chat/completions`.
- *   - Path ends with a version segment like `/v1`,
- *     `/v2`, … (with or without trailing slash)         → append only
- *     `/chat/completions`; never doubles `/v1` for
- *     callers who already include it.
- *   - Anything else (custom path that doesn't match the
- *     OpenAI shape, e.g. `/v1/messages` for
- *     Anthropic-style proxies)                          → leave as-is. The caller
- *     knows their own routing.
- *
- * Query string is preserved verbatim.
- *
  * @param {string} apiUrl
  * @returns {string}
  */
@@ -1702,7 +1782,11 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, 'avatarUrl')) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: avatarErr, details: { invalidFields: ['avatarUrl'] } } } };
+        // Soft-strip: drop the bad avatarUrl from the patch (keeps the
+        // existing stored avatar untouched) and continue applying the rest
+        // of the update. See standards §6.2.
+        console.warn('[amsg-server] update-message avatarUrl 不合法，已忽略：', avatarErr);
+        delete updates.avatarUrl;
       }
     }
 

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { createDecipheriv, createHash, randomBytes, createCipheriv, randomUUID, timingSafeEqual, createHmac } from 'crypto';
+import { buildReasoningPush, buildContentPush } from '@rei-standard/amsg-shared';
 
 /**
  * Adapter Factory
@@ -315,7 +316,11 @@ function validateScheduleMessagePayload(payload) {
 
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: avatarErr, details: { invalidFields: ['avatarUrl'] } };
+    // Soft-strip: a bad avatarUrl (data: URI / oversized / malformed) used to
+    // 400 the whole schedule. Avatar is cosmetic — drop the field, log, and
+    // let the rest of the task ship. See standards §6.2.
+    console.warn('[amsg-server] avatarUrl 不合法，已置空：', avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['uuid (invalid UUID format)'] } };
@@ -793,11 +798,23 @@ function isUniqueViolation(error) {
 
 /**
  * Message Processor (SDK version)
- * ReiStandard SDK v2.0.1
+ * ReiStandard amsg-server v2.4.0
+ *
+ * Handles single message content generation and Web Push delivery for
+ * scheduled tasks (`fixed` / `prompted` / `auto`) and the legacy
+ * via-server instant path (`messageType: 'instant'`).
  *
- * Handles single message content generation and Web Push delivery.
- * Receives its dependencies (encryption helpers, webpush, VAPID config)
- * via a context object so that it stays free of process.env references.
+ * Push wire shape comes from `@rei-standard/amsg-shared`'s
+ * discriminated union (`AmsgPush`). The SW (`@rei-standard/amsg-sw`)
+ * routes on `messageKind`. Server-driven pushes always carry
+ * `source: 'instant'` (for the legacy in-server instant) or
+ * `source: 'scheduled'` (for everything else).
+ *
+ * v2.4.0: when the LLM response carries non-empty
+ * `choices[0].message.reasoning_content`, the processor now emits a
+ * standalone `ReasoningPush` **before** the `ContentPush` burst.
+ * `messagesSent` in the return value continues to reflect the sentence
+ * count only (reasoning is an auxiliary push, not a sentence).
  */
 
 
@@ -850,6 +867,25 @@ function splitMessageIntoSentences(messageContent, splitPattern = null) {
   return chunks.length > 0 ? chunks : [messageContent];
 }
 
+/**
+ * Read `choices[0].message.reasoning_content` as a non-empty trimmed
+ * string, or null when absent / empty. Mirrors
+ * `amsg-instant/src/message-processor.js#readReasoningContent`.
+ *
+ * @param {unknown} llmResponse
+ * @returns {string | null}
+ */
+function readReasoningContent(llmResponse) {
+  if (!llmResponse || typeof llmResponse !== 'object') return null;
+  const choices = /** @type {{ choices?: unknown }} */ (llmResponse).choices;
+  if (!Array.isArray(choices) || choices.length === 0) return null;
+  const message = /** @type {{ message?: { reasoning_content?: unknown } }} */ (choices[0])?.message;
+  const raw = message?.reasoning_content;
+  if (typeof raw !== 'string') return null;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+
 /**
  * @typedef {Object} ProcessorContext
  * @property {Object}  webpush           - The web-push module instance (already VAPID-configured).
@@ -876,14 +912,19 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     const decryptedPayload = JSON.parse(decryptFromStorage(task.encrypted_payload, userKey));
 
     let messageContent;
+    /** @type {unknown} */
+    let llmResponse = null;
 
     if (decryptedPayload.messageType === 'fixed') {
       messageContent = decryptedPayload.userMessage;
 
     } else if (decryptedPayload.messageType === 'instant') {
-      const hasPrompt = !!decryptedPayload.completePrompt || (Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0);
+      const hasPrompt = !!decryptedPayload.completePrompt
+        || (Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0);
       if (hasPrompt && decryptedPayload.apiUrl && decryptedPayload.apiKey && decryptedPayload.primaryModel) {
-        messageContent = await _callAI(decryptedPayload);
+        const aiResult = await _callAI(decryptedPayload);
+        messageContent = aiResult.content;
+        llmResponse = aiResult.response;
       } else if (decryptedPayload.userMessage) {
         messageContent = decryptedPayload.userMessage;
       } else {
@@ -891,7 +932,9 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
       }
 
     } else if (decryptedPayload.messageType === 'prompted' || decryptedPayload.messageType === 'auto') {
-      messageContent = await _callAI(decryptedPayload);
+      const aiResult = await _callAI(decryptedPayload);
+      messageContent = aiResult.content;
+      llmResponse = aiResult.response;
     } else {
       throw new Error('Invalid message configuration: no content source available');
     }
@@ -908,25 +951,68 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     }
 
     const pushSubscription = decryptedPayload.pushSubscription;
+    // sessionId is shared across the optional ReasoningPush and every
+    // ContentPush from this LLM round. Pin it to the task id when
+    // available (scheduled tasks) so retries reuse the same id;
+    // otherwise mint a UUID.
+    const sessionId = task.id != null
+      ? `sess_task_${task.id}`
+      : `sess_${randomUUID()}`;
+    const source = decryptedPayload.messageType === 'instant' ? 'instant' : 'scheduled';
+    const messageSubtype = decryptedPayload.messageSubtype || 'chat';
+    const avatarUrl = decryptedPayload.avatarUrl || null;
+    const metadata = decryptedPayload.metadata || {};
+
+    // `messageId` format — deterministic when we have a task.id so a
+    // retry produces the same id for the same (task, sentence) pair
+    // (downstream dedupers can key on it). Falls back to a UUID for
+    // the legacy in-server instant path that has no row id.
+    const messageIdBase = task.id != null
+      ? `msg_task_${task.id}`
+      : `msg_${randomUUID()}_instant`;
+
+    // ReasoningPush — auto-emitted before the content burst when the
+    // LLM response carried non-empty reasoning_content. `fixed` and
+    // explicit-userMessage paths produce no LLM response, so this
+    // block is naturally skipped for them (llmResponse stays null).
+    const reasoning = readReasoningContent(llmResponse);
+    if (reasoning) {
+      const reasoningPush = buildReasoningPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_reasoning`,
+        sessionId,
+        reasoningContent: reasoning,
+        timestamp: new Date().toISOString(),
+        title: `来自 ${decryptedPayload.contactName}`,
+        contactName: decryptedPayload.contactName,
+        avatarUrl,
+        messageSubtype,
+        metadata,
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(reasoningPush));
+      await new Promise(resolve => setTimeout(resolve, 1500));
+    }
 
     for (let i = 0; i < messages.length; i++) {
-      const notificationPayload = {
-        title: `来自 ${decryptedPayload.contactName}`,
+      const contentPush = buildContentPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_${i}`,
+        sessionId,
         message: messages[i],
+        timestamp: new Date().toISOString(),
+        title: `来自 ${decryptedPayload.contactName}`,
         contactName: decryptedPayload.contactName,
-        messageId: `msg_${randomUUID()}_${task.id || 'instant'}_${i}`,
+        avatarUrl,
+        messageSubtype,
         messageIndex: i + 1,
         totalMessages: messages.length,
-        messageType: decryptedPayload.messageType,
-        messageSubtype: decryptedPayload.messageSubtype || 'chat',
         taskId: task.id || null,
-        timestamp: new Date().toISOString(),
-        source: decryptedPayload.messageType === 'instant' ? 'instant' : 'scheduled',
-        avatarUrl: decryptedPayload.avatarUrl || null,
-        metadata: decryptedPayload.metadata || {}
-      };
+        metadata,
+      });
 
-      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(notificationPayload));
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(contentPush));
 
       if (i < messages.length - 1) {
         await new Promise(resolve => setTimeout(resolve, 1500));
@@ -1030,7 +1116,15 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
 
 /**
  * Call an OpenAI-compatible API.
+ *
+ * Returns the full response object alongside the extracted (trimmed)
+ * `content` string. Callers that only need the text can ignore
+ * `response`; callers that want `reasoning_content` / `tool_calls`
+ * read from `response.choices[0].message`.
+ *
  * @private
+ * @param {Object} payload
+ * @returns {Promise<{ response: unknown, content: string }>}
  */
 async function _callAI(payload) {
   const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
@@ -1067,7 +1161,7 @@ async function _callAI(payload) {
     throw new Error('AI API error: response missing choices[0].message.content');
   }
 
-  return content.trim();
+  return { response: aiData, content: content.trim() };
 }
 
 /**
@@ -1125,20 +1219,6 @@ function buildAiRequestBody(payload) {
  * to avoid an architectural dependency (server should not depend on the
  * stateless worker package).
  *
- * Rules (idempotent — running it twice equals running it once):
- *   - Already ends with `/chat/completions`             → leave as-is.
- *   - Bare host (no path or just `/`)                   → append `/v1/chat/completions`.
- *   - Path ends with a version segment like `/v1`,
- *     `/v2`, … (with or without trailing slash)         → append only
- *     `/chat/completions`; never doubles `/v1` for
- *     callers who already include it.
- *   - Anything else (custom path that doesn't match the
- *     OpenAI shape, e.g. `/v1/messages` for
- *     Anthropic-style proxies)                          → leave as-is. The caller
- *     knows their own routing.
- *
- * Query string is preserved verbatim.
- *
  * @param {string} apiUrl
  * @returns {string}
  */
@@ -1702,7 +1782,11 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, 'avatarUrl')) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: avatarErr, details: { invalidFields: ['avatarUrl'] } } } };
+        // Soft-strip: drop the bad avatarUrl from the patch (keeps the
+        // existing stored avatar untouched) and continue applying the rest
+        // of the update. See standards §6.2.
+        console.warn('[amsg-server] update-message avatarUrl 不合法，已忽略：', avatarErr);
+        delete updates.avatarUrl;
       }
     }
 

package/dist/index.mjs

@@ -190,7 +190,8 @@ function validateScheduleMessagePayload(payload) {
   }
   const avatarErr = validateAvatarUrl(payload.avatarUrl);
   if (avatarErr) {
-    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: avatarErr, details: { invalidFields: ["avatarUrl"] } };
+    console.warn("[amsg-server] avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u7F6E\u7A7A\uFF1A", avatarErr);
+    payload.avatarUrl = null;
   }
   if (payload.uuid && !isValidUUID(payload.uuid)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["uuid (invalid UUID format)"] } };
@@ -482,6 +483,10 @@ function isUniqueViolation(error) {
 
 // src/server/lib/message-processor.js
 import { randomUUID } from "crypto";
+import {
+  buildContentPush,
+  buildReasoningPush
+} from "@rei-standard/amsg-shared";
 var DEFAULT_SPLIT_REGEX = /([。！？!?]+)/;
 function splitOnceByRegex(chunk, regex) {
   const out = chunk.split(regex).reduce((acc, part, i, arr) => {
@@ -502,6 +507,22 @@ function splitMessageIntoSentences(messageContent, splitPattern = null) {
   }
   return chunks.length > 0 ? chunks : [messageContent];
 }
+function readReasoningContent(llmResponse) {
+  if (!llmResponse || typeof llmResponse !== "object") return null;
+  const choices = (
+    /** @type {{ choices?: unknown }} */
+    llmResponse.choices
+  );
+  if (!Array.isArray(choices) || choices.length === 0) return null;
+  const message = (
+    /** @type {{ message?: { reasoning_content?: unknown } }} */
+    choices[0]?.message
+  );
+  const raw = message?.reasoning_content;
+  if (typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
 async function processSingleMessage(task, ctx, providedMasterKey) {
   try {
     const masterKey = providedMasterKey || ctx.masterKey;
@@ -511,19 +532,24 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
     const userKey = deriveUserEncryptionKey(task.user_id, masterKey);
     const decryptedPayload = JSON.parse(decryptFromStorage(task.encrypted_payload, userKey));
     let messageContent;
+    let llmResponse = null;
     if (decryptedPayload.messageType === "fixed") {
       messageContent = decryptedPayload.userMessage;
     } else if (decryptedPayload.messageType === "instant") {
       const hasPrompt = !!decryptedPayload.completePrompt || Array.isArray(decryptedPayload.messages) && decryptedPayload.messages.length > 0;
       if (hasPrompt && decryptedPayload.apiUrl && decryptedPayload.apiKey && decryptedPayload.primaryModel) {
-        messageContent = await _callAI(decryptedPayload);
+        const aiResult = await _callAI(decryptedPayload);
+        messageContent = aiResult.content;
+        llmResponse = aiResult.response;
       } else if (decryptedPayload.userMessage) {
         messageContent = decryptedPayload.userMessage;
       } else {
         throw new Error("Invalid instant message: no content source available");
       }
     } else if (decryptedPayload.messageType === "prompted" || decryptedPayload.messageType === "auto") {
-      messageContent = await _callAI(decryptedPayload);
+      const aiResult = await _callAI(decryptedPayload);
+      messageContent = aiResult.content;
+      llmResponse = aiResult.response;
     } else {
       throw new Error("Invalid message configuration: no content source available");
     }
@@ -532,23 +558,48 @@ async function processSingleMessage(task, ctx, providedMasterKey) {
       throw new Error("VAPID configuration missing - push notifications cannot be sent");
     }
     const pushSubscription = decryptedPayload.pushSubscription;
-    for (let i = 0; i < messages.length; i++) {
-      const notificationPayload = {
+    const sessionId = task.id != null ? `sess_task_${task.id}` : `sess_${randomUUID()}`;
+    const source = decryptedPayload.messageType === "instant" ? "instant" : "scheduled";
+    const messageSubtype = decryptedPayload.messageSubtype || "chat";
+    const avatarUrl = decryptedPayload.avatarUrl || null;
+    const metadata = decryptedPayload.metadata || {};
+    const messageIdBase = task.id != null ? `msg_task_${task.id}` : `msg_${randomUUID()}_instant`;
+    const reasoning = readReasoningContent(llmResponse);
+    if (reasoning) {
+      const reasoningPush = buildReasoningPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_reasoning`,
+        sessionId,
+        reasoningContent: reasoning,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         title: `\u6765\u81EA ${decryptedPayload.contactName}`,
+        contactName: decryptedPayload.contactName,
+        avatarUrl,
+        messageSubtype,
+        metadata
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(reasoningPush));
+      await new Promise((resolve) => setTimeout(resolve, 1500));
+    }
+    for (let i = 0; i < messages.length; i++) {
+      const contentPush = buildContentPush({
+        messageType: decryptedPayload.messageType,
+        source,
+        messageId: `${messageIdBase}_${i}`,
+        sessionId,
         message: messages[i],
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        title: `\u6765\u81EA ${decryptedPayload.contactName}`,
         contactName: decryptedPayload.contactName,
-        messageId: `msg_${randomUUID()}_${task.id || "instant"}_${i}`,
+        avatarUrl,
+        messageSubtype,
         messageIndex: i + 1,
         totalMessages: messages.length,
-        messageType: decryptedPayload.messageType,
-        messageSubtype: decryptedPayload.messageSubtype || "chat",
         taskId: task.id || null,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        source: decryptedPayload.messageType === "instant" ? "instant" : "scheduled",
-        avatarUrl: decryptedPayload.avatarUrl || null,
-        metadata: decryptedPayload.metadata || {}
-      };
-      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(notificationPayload));
+        metadata
+      });
+      await ctx.webpush.sendNotification(pushSubscription, JSON.stringify(contentPush));
       if (i < messages.length - 1) {
         await new Promise((resolve) => setTimeout(resolve, 1500));
       }
@@ -647,7 +698,7 @@ async function _callAI(payload) {
   if (typeof content !== "string" || !content.trim()) {
     throw new Error("AI API error: response missing choices[0].message.content");
   }
-  return content.trim();
+  return { response: aiData, content: content.trim() };
 }
 function buildAiRequestBody(payload) {
   const llmMessages = Array.isArray(payload.messages) && payload.messages.length > 0 ? payload.messages : [{ role: "user", content: payload.completePrompt }];
@@ -1102,7 +1153,8 @@ function createUpdateMessageHandler(ctx) {
     if (Object.prototype.hasOwnProperty.call(updates, "avatarUrl")) {
       const avatarErr = validateAvatarUrl(updates.avatarUrl);
       if (avatarErr) {
-        return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: avatarErr, details: { invalidFields: ["avatarUrl"] } } } };
+        console.warn("[amsg-server] update-message avatarUrl \u4E0D\u5408\u6CD5\uFF0C\u5DF2\u5FFD\u7565\uFF1A", avatarErr);
+        delete updates.avatarUrl;
       }
     }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rei-standard/amsg-server",
-  "version": "2.3.2",
-  "description": "ReiStandard Active Messaging server SDK with pluggable database adapters",
+  "version": "2.4.0-next.2",
+  "description": "ReiStandard Active Messaging server SDK with pluggable database adapters. Three-axis push schema (messageKind / messageType / messageSubtype) from @rei-standard/amsg-shared. Auto-emits ReasoningPush when the LLM response carries reasoning_content.",
   "repository": {
     "type": "git",
     "url": "https://github.com/Tosd0/ReiStandard",
@@ -33,6 +33,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@rei-standard/amsg-shared": "0.1.0-next.4",
     "web-push": "^3.6.7",
     "@netlify/blobs": "^8.1.0"
   },