@rei-standard/amsg-server 2.0.0-pre1 → 2.0.1

package/README.md

@@ -1,8 +1,8 @@
 # @rei-standard/amsg-server
 
-`@rei-standard/amsg-server` 是 ReiStandard 主动消息标准的服务端 SDK（v2.0.0-pre1），提供 Blob 租户配置、租户 token 鉴权和标准路由处理器。
+`@rei-standard/amsg-server` 是 ReiStandard 主动消息标准的服务端 SDK（v2.0.1），提供 Blob 租户配置、租户 token 鉴权和标准路由处理器。
 
-## v2.0.0-pre1 变更摘要
+## v2.0.1 变更摘要
 
 - 初始化流程合并为 `POST /api/v1/init-tenant`
 - 移除旧端点：`init-database`、`init-master-key`
@@ -50,6 +50,17 @@ const rei = await createReiServer({
 // GET  /api/v1/messages             -> rei.handlers.messages.GET
 ```
 
+## AI 接口 `apiUrl` 约束
+
+当 `messageType` 为 `prompted` / `auto`，或 `instant` 使用 AI 配置时：
+
+- `apiUrl` 必须是完整聊天端点（例如：`https://api.openai.com/v1/chat/completions`）。
+- SDK 会自动做最小规范化：去首尾空白、去路径尾部多余 `/`。
+- SDK **不会**自动补全 `/v1`、`/chat/completions` 等路径。
+- `maxTokens` 为可选字段：传了就映射为 `max_tokens`；不传则不指定（由上游模型默认策略决定）。
+
+如果上游返回 `405 Method Not Allowed`，通常表示 `apiUrl` 指向了基础域名而非聊天端点，请优先检查配置值。
+
 ## 一体化初始化流程
 
 1. 管理员配置环境变量（VAPID + tenant secrets）

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/server/adapters/factory.js
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/server/adapters/factory.js
 async function createAdapter(config) {
   if (!config || !config.driver) {
     throw new Error(
@@ -66,6 +66,9 @@ function validateScheduleMessagePayload(payload) {
   if (payload.recurrenceType && !["none", "daily", "weekly"].includes(payload.recurrenceType)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["recurrenceType"] } };
   }
+  if (payload.maxTokens !== void 0 && payload.maxTokens !== null && (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0)) {
+    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["maxTokens"] } };
+  }
   if (payload.messageType === "fixed") {
     if (!payload.userMessage) {
       return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { missingFields: ["userMessage (required for fixed type)"] } };
@@ -505,25 +508,66 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
   }
 }
 async function _callAI(payload) {
-  const aiResponse = await fetch(payload.apiUrl, {
+  const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
+  const requestBody = buildAiRequestBody(payload);
+  const aiResponse = await fetch(normalizedApiUrl, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "Authorization": `Bearer ${payload.apiKey}`
     },
-    body: JSON.stringify({
-      model: payload.primaryModel,
-      messages: [{ role: "user", content: payload.completePrompt }],
-      max_tokens: 500,
-      temperature: 0.8
-    }),
+    body: JSON.stringify(requestBody),
     signal: AbortSignal.timeout(3e5)
   });
   if (!aiResponse.ok) {
-    throw new Error(`AI API error: ${aiResponse.status} ${aiResponse.statusText}`);
+    if (aiResponse.status === 405) {
+      throw new Error(
+        `AI API error: 405 Method Not Allowed. apiUrl must point to a full chat endpoint (for example: /chat/completions). Received: ${normalizedApiUrl}`
+      );
+    }
+    throw new Error(
+      `AI API error: ${aiResponse.status} ${aiResponse.statusText || "Unknown Error"}. Request URL: ${normalizedApiUrl}`
+    );
   }
   const aiData = await aiResponse.json();
-  return aiData.choices[0].message.content.trim();
+  const content = _optionalChain([aiData, 'optionalAccess', _ => _.choices, 'optionalAccess', _2 => _2[0], 'optionalAccess', _3 => _3.message, 'optionalAccess', _4 => _4.content]);
+  if (typeof content !== "string" || !content.trim()) {
+    throw new Error("AI API error: response missing choices[0].message.content");
+  }
+  return content.trim();
+}
+function buildAiRequestBody(payload) {
+  const requestBody = {
+    model: payload.primaryModel,
+    messages: [{ role: "user", content: payload.completePrompt }],
+    temperature: 0.8
+  };
+  if (payload.maxTokens === void 0 || payload.maxTokens === null) {
+    return requestBody;
+  }
+  if (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0) {
+    throw new Error("Invalid maxTokens: maxTokens must be a positive integer when provided.");
+  }
+  requestBody.max_tokens = payload.maxTokens;
+  return requestBody;
+}
+function normalizeAiApiUrl(apiUrl) {
+  if (typeof apiUrl !== "string" || !apiUrl.trim()) {
+    throw new Error(
+      "Invalid apiUrl: apiUrl is required. Please provide a full chat endpoint URL (for example: https://api.openai.com/v1/chat/completions)."
+    );
+  }
+  const trimmedApiUrl = apiUrl.trim();
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(trimmedApiUrl);
+  } catch (e3) {
+    throw new Error(
+      `Invalid apiUrl: "${apiUrl}". Please provide a valid absolute URL that points to a full chat endpoint.`
+    );
+  }
+  parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, "") || "/";
+  return parsedUrl.toString();
 }
 
 // src/server/handlers/schedule-message.js
@@ -591,6 +635,7 @@ function createScheduleMessageHandler(ctx) {
       apiKey: payload.apiKey || null,
       primaryModel: payload.primaryModel || null,
       completePrompt: payload.completePrompt || null,
+      maxTokens: _nullishCoalesce(payload.maxTokens, () => ( null)),
       pushSubscription: payload.pushSubscription,
       metadata: payload.metadata || {}
     };
@@ -899,6 +944,9 @@ function createUpdateMessageHandler(ctx) {
     if (updates.recurrenceType && !["none", "daily", "weekly"].includes(updates.recurrenceType)) {
       return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: "\u66F4\u65B0\u6570\u636E\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["recurrenceType"] } } } };
     }
+    if (Object.prototype.hasOwnProperty.call(updates, "maxTokens") && updates.maxTokens !== null && (!Number.isInteger(updates.maxTokens) || updates.maxTokens <= 0)) {
+      return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: "\u66F4\u65B0\u6570\u636E\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["maxTokens"] } } } };
+    }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);
     if (!existingTask) {
       const taskStatus = await db.getTaskStatus(taskUuid, userId);
@@ -914,7 +962,8 @@ function createUpdateMessageHandler(ctx) {
       ...updates.userMessage && { userMessage: updates.userMessage },
       ...updates.recurrenceType && { recurrenceType: updates.recurrenceType },
       ...updates.avatarUrl && { avatarUrl: updates.avatarUrl },
-      ...updates.metadata && { metadata: updates.metadata }
+      ...updates.metadata && { metadata: updates.metadata },
+      ...Object.prototype.hasOwnProperty.call(updates, "maxTokens") && { maxTokens: _nullishCoalesce(updates.maxTokens, () => ( null)) }
     };
     const encryptedPayload = encryptForStorage(JSON.stringify(updatedData), userKey);
     const extraFields = updates.nextSendAt ? { next_send_at: updates.nextSendAt } : void 0;
@@ -1106,7 +1155,7 @@ async function resolveBlobStore(namespace) {
   }
   try {
     const blobModule = await Promise.resolve().then(() => _interopRequireWildcard(require("@netlify/blobs")));
-    const getStore = blobModule.getStore || _optionalChain([blobModule, 'access', _ => _.default, 'optionalAccess', _2 => _2.getStore]);
+    const getStore = blobModule.getStore || _optionalChain([blobModule, 'access', _5 => _5.default, 'optionalAccess', _6 => _6.getStore]);
     if (typeof getStore === "function") {
       return getStore({ name: namespace });
     }
@@ -1194,7 +1243,7 @@ function verifyTenantToken(token, secret, options = {}) {
   let payload;
   try {
     payload = JSON.parse(base64UrlDecode2(encodedPayload).toString("utf8"));
-  } catch (e3) {
+  } catch (e4) {
     throw new Error("INVALID_TENANT_AUTH");
   }
   if (!payload || typeof payload !== "object" || payload.v !== 1) {
@@ -1251,7 +1300,7 @@ function parseTokenFromUrl(url) {
   try {
     const parsed = new URL(url, "https://dummy.local");
     return String(parsed.searchParams.get("token") || "").trim();
-  } catch (e4) {
+  } catch (e5) {
     return "";
   }
 }

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { createDecipheriv, createHash, randomBytes, createCipheriv, randomUUID,
 
 /**
  * Adapter Factory
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Creates a database adapter instance based on the supplied configuration.
  *
@@ -35,12 +35,12 @@ async function createAdapter(config) {
 
   switch (config.driver) {
     case 'neon': {
-      const { NeonAdapter } = await import('./neon-Ch9Abtfp.d.cts');
+      const { NeonAdapter } = await import('./neon-CJl66EGy.d.cts');
       return new NeonAdapter(config.connectionString);
     }
 
     case 'pg': {
-      const { PgAdapter } = await import('./pg-BpYu3O81.d.cts');
+      const { PgAdapter } = await import('./pg-07S-u_H4.d.cts');
       return new PgAdapter(config.connectionString);
     }
 
@@ -54,7 +54,7 @@ async function createAdapter(config) {
 
 /**
  * Validation utility library (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  */
 
 /**
@@ -132,6 +132,14 @@ function validateScheduleMessagePayload(payload) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['recurrenceType'] } };
   }
 
+  if (
+    payload.maxTokens !== undefined &&
+    payload.maxTokens !== null &&
+    (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0)
+  ) {
+    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['maxTokens'] } };
+  }
+
   if (payload.messageType === 'fixed') {
     if (!payload.userMessage) {
       return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { missingFields: ['userMessage (required for fixed type)'] } };
@@ -320,7 +328,7 @@ function getHeader(headers = {}, name) {
 
 /**
  * Handler: init-tenant
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -456,7 +464,7 @@ function createInitTenantHandler(ctx) {
 
 /**
  * Encryption utility library (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Wraps AES-256-GCM operations for request/response and storage encryption.
  */
@@ -558,7 +566,7 @@ function decryptFromStorage(encryptedText, encryptionKey) {
 
 /**
  * Handler: get-user-key
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ GET: function }}
@@ -627,7 +635,7 @@ function isUniqueViolation(error) {
 
 /**
  * Message Processor (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Handles single message content generation and Web Push delivery.
  * Receives its dependencies (encryption helpers, webpush, VAPID config)
@@ -824,32 +832,110 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
  * @private
  */
 async function _callAI(payload) {
-  const aiResponse = await fetch(payload.apiUrl, {
+  const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
+  const requestBody = buildAiRequestBody(payload);
+
+  const aiResponse = await fetch(normalizedApiUrl, {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
       'Authorization': `Bearer ${payload.apiKey}`
     },
-    body: JSON.stringify({
-      model: payload.primaryModel,
-      messages: [{ role: 'user', content: payload.completePrompt }],
-      max_tokens: 500,
-      temperature: 0.8
-    }),
+    body: JSON.stringify(requestBody),
     signal: AbortSignal.timeout(300000)
   });
 
   if (!aiResponse.ok) {
-    throw new Error(`AI API error: ${aiResponse.status} ${aiResponse.statusText}`);
+    if (aiResponse.status === 405) {
+      throw new Error(
+        `AI API error: 405 Method Not Allowed. ` +
+        `apiUrl must point to a full chat endpoint (for example: /chat/completions). ` +
+        `Received: ${normalizedApiUrl}`
+      );
+    }
+
+    throw new Error(
+      `AI API error: ${aiResponse.status} ${aiResponse.statusText || 'Unknown Error'}. ` +
+      `Request URL: ${normalizedApiUrl}`
+    );
   }
 
   const aiData = await aiResponse.json();
-  return aiData.choices[0].message.content.trim();
+  const content = aiData?.choices?.[0]?.message?.content;
+  if (typeof content !== 'string' || !content.trim()) {
+    throw new Error('AI API error: response missing choices[0].message.content');
+  }
+
+  return content.trim();
+}
+
+/**
+ * Build OpenAI-compatible request body.
+ *
+ * `max_tokens` is optional:
+ * - include it only when payload.maxTokens is provided
+ * - omit it when payload.maxTokens is undefined / null
+ *
+ * @param {Object} payload
+ * @returns {Object}
+ */
+function buildAiRequestBody(payload) {
+  const requestBody = {
+    model: payload.primaryModel,
+    messages: [{ role: 'user', content: payload.completePrompt }],
+    temperature: 0.8
+  };
+
+  if (payload.maxTokens === undefined || payload.maxTokens === null) {
+    return requestBody;
+  }
+
+  if (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0) {
+    throw new Error('Invalid maxTokens: maxTokens must be a positive integer when provided.');
+  }
+
+  requestBody.max_tokens = payload.maxTokens;
+  return requestBody;
+}
+
+/**
+ * Normalize AI API URL with minimal, non-breaking rules:
+ * - trim whitespace
+ * - remove redundant trailing slashes from pathname
+ * - keep query string untouched
+ *
+ * Note: This function does NOT auto-append /v1 or /chat/completions.
+ *
+ * @param {string} apiUrl
+ * @returns {string}
+ */
+function normalizeAiApiUrl(apiUrl) {
+  if (typeof apiUrl !== 'string' || !apiUrl.trim()) {
+    throw new Error(
+      'Invalid apiUrl: apiUrl is required. ' +
+      'Please provide a full chat endpoint URL (for example: https://api.openai.com/v1/chat/completions).'
+    );
+  }
+
+  const trimmedApiUrl = apiUrl.trim();
+  let parsedUrl;
+
+  try {
+    parsedUrl = new URL(trimmedApiUrl);
+  } catch {
+    throw new Error(
+      `Invalid apiUrl: "${apiUrl}". ` +
+      'Please provide a valid absolute URL that points to a full chat endpoint.'
+    );
+  }
+
+  parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, '') || '/';
+  return parsedUrl.toString();
 }
 
 /**
  * Handler: schedule-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -933,6 +1019,7 @@ function createScheduleMessageHandler(ctx) {
       apiKey: payload.apiKey || null,
       primaryModel: payload.primaryModel || null,
       completePrompt: payload.completePrompt || null,
+      maxTokens: payload.maxTokens ?? null,
       pushSubscription: payload.pushSubscription,
       metadata: payload.metadata || {}
     };
@@ -1046,7 +1133,7 @@ function createScheduleMessageHandler(ctx) {
 
 /**
  * Handler: send-notifications
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -1236,7 +1323,7 @@ function createSendNotificationsHandler(ctx) {
 
 /**
  * Handler: update-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ PUT: function }}
@@ -1306,6 +1393,14 @@ function createUpdateMessageHandler(ctx) {
       return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: '更新数据格式错误', details: { invalidFields: ['recurrenceType'] } } } };
     }
 
+    if (
+      Object.prototype.hasOwnProperty.call(updates, 'maxTokens') &&
+      updates.maxTokens !== null &&
+      (!Number.isInteger(updates.maxTokens) || updates.maxTokens <= 0)
+    ) {
+      return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: '更新数据格式错误', details: { invalidFields: ['maxTokens'] } } } };
+    }
+
     // Fetch existing task
     const existingTask = await db.getTaskByUuid(taskUuid, userId);
 
@@ -1325,7 +1420,8 @@ function createUpdateMessageHandler(ctx) {
       ...(updates.userMessage && { userMessage: updates.userMessage }),
       ...(updates.recurrenceType && { recurrenceType: updates.recurrenceType }),
       ...(updates.avatarUrl && { avatarUrl: updates.avatarUrl }),
-      ...(updates.metadata && { metadata: updates.metadata })
+      ...(updates.metadata && { metadata: updates.metadata }),
+      ...(Object.prototype.hasOwnProperty.call(updates, 'maxTokens') && { maxTokens: updates.maxTokens ?? null })
     };
 
     const encryptedPayload = encryptForStorage(JSON.stringify(updatedData), userKey);
@@ -1355,7 +1451,7 @@ function createUpdateMessageHandler(ctx) {
 
 /**
  * Handler: cancel-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ DELETE: function }}
@@ -1408,7 +1504,7 @@ function createCancelMessageHandler(ctx) {
 
 /**
  * Handler: messages
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ GET: function }}
@@ -1911,7 +2007,7 @@ function createTenantContextManager(options) {
 
 /**
  * ReiStandard Server SDK Entry Point
- * v2.0.0-pre1
+ * v2.0.1
  *
  * Usage:
  *   import { createReiServer } from '@rei-standard/amsg-server';

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { createDecipheriv, createHash, randomBytes, createCipheriv, randomUUID,
 
 /**
  * Adapter Factory
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Creates a database adapter instance based on the supplied configuration.
  *
@@ -35,12 +35,12 @@ async function createAdapter(config) {
 
   switch (config.driver) {
     case 'neon': {
-      const { NeonAdapter } = await import('./neon-DyBfYFkz.d.ts');
+      const { NeonAdapter } = await import('./neon-DYvGnCzx.d.ts');
       return new NeonAdapter(config.connectionString);
     }
 
     case 'pg': {
-      const { PgAdapter } = await import('./pg-DJWS_HZ3.d.ts');
+      const { PgAdapter } = await import('./pg-Du-pN_UT.d.ts');
       return new PgAdapter(config.connectionString);
     }
 
@@ -54,7 +54,7 @@ async function createAdapter(config) {
 
 /**
  * Validation utility library (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  */
 
 /**
@@ -132,6 +132,14 @@ function validateScheduleMessagePayload(payload) {
     return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['recurrenceType'] } };
   }
 
+  if (
+    payload.maxTokens !== undefined &&
+    payload.maxTokens !== null &&
+    (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0)
+  ) {
+    return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { invalidFields: ['maxTokens'] } };
+  }
+
   if (payload.messageType === 'fixed') {
     if (!payload.userMessage) {
       return { valid: false, errorCode: 'INVALID_PARAMETERS', errorMessage: '缺少必需参数或参数格式错误', details: { missingFields: ['userMessage (required for fixed type)'] } };
@@ -320,7 +328,7 @@ function getHeader(headers = {}, name) {
 
 /**
  * Handler: init-tenant
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -456,7 +464,7 @@ function createInitTenantHandler(ctx) {
 
 /**
  * Encryption utility library (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Wraps AES-256-GCM operations for request/response and storage encryption.
  */
@@ -558,7 +566,7 @@ function decryptFromStorage(encryptedText, encryptionKey) {
 
 /**
  * Handler: get-user-key
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ GET: function }}
@@ -627,7 +635,7 @@ function isUniqueViolation(error) {
 
 /**
  * Message Processor (SDK version)
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Handles single message content generation and Web Push delivery.
  * Receives its dependencies (encryption helpers, webpush, VAPID config)
@@ -824,32 +832,110 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
  * @private
  */
 async function _callAI(payload) {
-  const aiResponse = await fetch(payload.apiUrl, {
+  const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
+  const requestBody = buildAiRequestBody(payload);
+
+  const aiResponse = await fetch(normalizedApiUrl, {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
       'Authorization': `Bearer ${payload.apiKey}`
     },
-    body: JSON.stringify({
-      model: payload.primaryModel,
-      messages: [{ role: 'user', content: payload.completePrompt }],
-      max_tokens: 500,
-      temperature: 0.8
-    }),
+    body: JSON.stringify(requestBody),
     signal: AbortSignal.timeout(300000)
   });
 
   if (!aiResponse.ok) {
-    throw new Error(`AI API error: ${aiResponse.status} ${aiResponse.statusText}`);
+    if (aiResponse.status === 405) {
+      throw new Error(
+        `AI API error: 405 Method Not Allowed. ` +
+        `apiUrl must point to a full chat endpoint (for example: /chat/completions). ` +
+        `Received: ${normalizedApiUrl}`
+      );
+    }
+
+    throw new Error(
+      `AI API error: ${aiResponse.status} ${aiResponse.statusText || 'Unknown Error'}. ` +
+      `Request URL: ${normalizedApiUrl}`
+    );
   }
 
   const aiData = await aiResponse.json();
-  return aiData.choices[0].message.content.trim();
+  const content = aiData?.choices?.[0]?.message?.content;
+  if (typeof content !== 'string' || !content.trim()) {
+    throw new Error('AI API error: response missing choices[0].message.content');
+  }
+
+  return content.trim();
+}
+
+/**
+ * Build OpenAI-compatible request body.
+ *
+ * `max_tokens` is optional:
+ * - include it only when payload.maxTokens is provided
+ * - omit it when payload.maxTokens is undefined / null
+ *
+ * @param {Object} payload
+ * @returns {Object}
+ */
+function buildAiRequestBody(payload) {
+  const requestBody = {
+    model: payload.primaryModel,
+    messages: [{ role: 'user', content: payload.completePrompt }],
+    temperature: 0.8
+  };
+
+  if (payload.maxTokens === undefined || payload.maxTokens === null) {
+    return requestBody;
+  }
+
+  if (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0) {
+    throw new Error('Invalid maxTokens: maxTokens must be a positive integer when provided.');
+  }
+
+  requestBody.max_tokens = payload.maxTokens;
+  return requestBody;
+}
+
+/**
+ * Normalize AI API URL with minimal, non-breaking rules:
+ * - trim whitespace
+ * - remove redundant trailing slashes from pathname
+ * - keep query string untouched
+ *
+ * Note: This function does NOT auto-append /v1 or /chat/completions.
+ *
+ * @param {string} apiUrl
+ * @returns {string}
+ */
+function normalizeAiApiUrl(apiUrl) {
+  if (typeof apiUrl !== 'string' || !apiUrl.trim()) {
+    throw new Error(
+      'Invalid apiUrl: apiUrl is required. ' +
+      'Please provide a full chat endpoint URL (for example: https://api.openai.com/v1/chat/completions).'
+    );
+  }
+
+  const trimmedApiUrl = apiUrl.trim();
+  let parsedUrl;
+
+  try {
+    parsedUrl = new URL(trimmedApiUrl);
+  } catch {
+    throw new Error(
+      `Invalid apiUrl: "${apiUrl}". ` +
+      'Please provide a valid absolute URL that points to a full chat endpoint.'
+    );
+  }
+
+  parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, '') || '/';
+  return parsedUrl.toString();
 }
 
 /**
  * Handler: schedule-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -933,6 +1019,7 @@ function createScheduleMessageHandler(ctx) {
       apiKey: payload.apiKey || null,
       primaryModel: payload.primaryModel || null,
       completePrompt: payload.completePrompt || null,
+      maxTokens: payload.maxTokens ?? null,
       pushSubscription: payload.pushSubscription,
       metadata: payload.metadata || {}
     };
@@ -1046,7 +1133,7 @@ function createScheduleMessageHandler(ctx) {
 
 /**
  * Handler: send-notifications
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ POST: function }}
@@ -1236,7 +1323,7 @@ function createSendNotificationsHandler(ctx) {
 
 /**
  * Handler: update-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ PUT: function }}
@@ -1306,6 +1393,14 @@ function createUpdateMessageHandler(ctx) {
       return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: '更新数据格式错误', details: { invalidFields: ['recurrenceType'] } } } };
     }
 
+    if (
+      Object.prototype.hasOwnProperty.call(updates, 'maxTokens') &&
+      updates.maxTokens !== null &&
+      (!Number.isInteger(updates.maxTokens) || updates.maxTokens <= 0)
+    ) {
+      return { status: 400, body: { success: false, error: { code: 'INVALID_UPDATE_DATA', message: '更新数据格式错误', details: { invalidFields: ['maxTokens'] } } } };
+    }
+
     // Fetch existing task
     const existingTask = await db.getTaskByUuid(taskUuid, userId);
 
@@ -1325,7 +1420,8 @@ function createUpdateMessageHandler(ctx) {
       ...(updates.userMessage && { userMessage: updates.userMessage }),
       ...(updates.recurrenceType && { recurrenceType: updates.recurrenceType }),
       ...(updates.avatarUrl && { avatarUrl: updates.avatarUrl }),
-      ...(updates.metadata && { metadata: updates.metadata })
+      ...(updates.metadata && { metadata: updates.metadata }),
+      ...(Object.prototype.hasOwnProperty.call(updates, 'maxTokens') && { maxTokens: updates.maxTokens ?? null })
     };
 
     const encryptedPayload = encryptForStorage(JSON.stringify(updatedData), userKey);
@@ -1355,7 +1451,7 @@ function createUpdateMessageHandler(ctx) {
 
 /**
  * Handler: cancel-message
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ DELETE: function }}
@@ -1408,7 +1504,7 @@ function createCancelMessageHandler(ctx) {
 
 /**
  * Handler: messages
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @param {Object} ctx - Server context.
  * @returns {{ GET: function }}
@@ -1911,7 +2007,7 @@ function createTenantContextManager(options) {
 
 /**
  * ReiStandard Server SDK Entry Point
- * v2.0.0-pre1
+ * v2.0.1
  *
  * Usage:
  *   import { createReiServer } from '@rei-standard/amsg-server';

package/dist/index.mjs

@@ -66,6 +66,9 @@ function validateScheduleMessagePayload(payload) {
   if (payload.recurrenceType && !["none", "daily", "weekly"].includes(payload.recurrenceType)) {
     return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["recurrenceType"] } };
   }
+  if (payload.maxTokens !== void 0 && payload.maxTokens !== null && (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0)) {
+    return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["maxTokens"] } };
+  }
   if (payload.messageType === "fixed") {
     if (!payload.userMessage) {
       return { valid: false, errorCode: "INVALID_PARAMETERS", errorMessage: "\u7F3A\u5C11\u5FC5\u9700\u53C2\u6570\u6216\u53C2\u6570\u683C\u5F0F\u9519\u8BEF", details: { missingFields: ["userMessage (required for fixed type)"] } };
@@ -505,25 +508,66 @@ async function processMessagesByUuid(uuid, ctx, maxRetries = 2, userId, provided
   }
 }
 async function _callAI(payload) {
-  const aiResponse = await fetch(payload.apiUrl, {
+  const normalizedApiUrl = normalizeAiApiUrl(payload.apiUrl);
+  const requestBody = buildAiRequestBody(payload);
+  const aiResponse = await fetch(normalizedApiUrl, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "Authorization": `Bearer ${payload.apiKey}`
     },
-    body: JSON.stringify({
-      model: payload.primaryModel,
-      messages: [{ role: "user", content: payload.completePrompt }],
-      max_tokens: 500,
-      temperature: 0.8
-    }),
+    body: JSON.stringify(requestBody),
     signal: AbortSignal.timeout(3e5)
   });
   if (!aiResponse.ok) {
-    throw new Error(`AI API error: ${aiResponse.status} ${aiResponse.statusText}`);
+    if (aiResponse.status === 405) {
+      throw new Error(
+        `AI API error: 405 Method Not Allowed. apiUrl must point to a full chat endpoint (for example: /chat/completions). Received: ${normalizedApiUrl}`
+      );
+    }
+    throw new Error(
+      `AI API error: ${aiResponse.status} ${aiResponse.statusText || "Unknown Error"}. Request URL: ${normalizedApiUrl}`
+    );
   }
   const aiData = await aiResponse.json();
-  return aiData.choices[0].message.content.trim();
+  const content = aiData?.choices?.[0]?.message?.content;
+  if (typeof content !== "string" || !content.trim()) {
+    throw new Error("AI API error: response missing choices[0].message.content");
+  }
+  return content.trim();
+}
+function buildAiRequestBody(payload) {
+  const requestBody = {
+    model: payload.primaryModel,
+    messages: [{ role: "user", content: payload.completePrompt }],
+    temperature: 0.8
+  };
+  if (payload.maxTokens === void 0 || payload.maxTokens === null) {
+    return requestBody;
+  }
+  if (!Number.isInteger(payload.maxTokens) || payload.maxTokens <= 0) {
+    throw new Error("Invalid maxTokens: maxTokens must be a positive integer when provided.");
+  }
+  requestBody.max_tokens = payload.maxTokens;
+  return requestBody;
+}
+function normalizeAiApiUrl(apiUrl) {
+  if (typeof apiUrl !== "string" || !apiUrl.trim()) {
+    throw new Error(
+      "Invalid apiUrl: apiUrl is required. Please provide a full chat endpoint URL (for example: https://api.openai.com/v1/chat/completions)."
+    );
+  }
+  const trimmedApiUrl = apiUrl.trim();
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(trimmedApiUrl);
+  } catch {
+    throw new Error(
+      `Invalid apiUrl: "${apiUrl}". Please provide a valid absolute URL that points to a full chat endpoint.`
+    );
+  }
+  parsedUrl.pathname = parsedUrl.pathname.replace(/\/+$/, "") || "/";
+  return parsedUrl.toString();
 }
 
 // src/server/handlers/schedule-message.js
@@ -591,6 +635,7 @@ function createScheduleMessageHandler(ctx) {
       apiKey: payload.apiKey || null,
       primaryModel: payload.primaryModel || null,
       completePrompt: payload.completePrompt || null,
+      maxTokens: payload.maxTokens ?? null,
       pushSubscription: payload.pushSubscription,
       metadata: payload.metadata || {}
     };
@@ -899,6 +944,9 @@ function createUpdateMessageHandler(ctx) {
     if (updates.recurrenceType && !["none", "daily", "weekly"].includes(updates.recurrenceType)) {
       return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: "\u66F4\u65B0\u6570\u636E\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["recurrenceType"] } } } };
     }
+    if (Object.prototype.hasOwnProperty.call(updates, "maxTokens") && updates.maxTokens !== null && (!Number.isInteger(updates.maxTokens) || updates.maxTokens <= 0)) {
+      return { status: 400, body: { success: false, error: { code: "INVALID_UPDATE_DATA", message: "\u66F4\u65B0\u6570\u636E\u683C\u5F0F\u9519\u8BEF", details: { invalidFields: ["maxTokens"] } } } };
+    }
     const existingTask = await db.getTaskByUuid(taskUuid, userId);
     if (!existingTask) {
       const taskStatus = await db.getTaskStatus(taskUuid, userId);
@@ -914,7 +962,8 @@ function createUpdateMessageHandler(ctx) {
       ...updates.userMessage && { userMessage: updates.userMessage },
       ...updates.recurrenceType && { recurrenceType: updates.recurrenceType },
       ...updates.avatarUrl && { avatarUrl: updates.avatarUrl },
-      ...updates.metadata && { metadata: updates.metadata }
+      ...updates.metadata && { metadata: updates.metadata },
+      ...Object.prototype.hasOwnProperty.call(updates, "maxTokens") && { maxTokens: updates.maxTokens ?? null }
     };
     const encryptedPayload = encryptForStorage(JSON.stringify(updatedData), userKey);
     const extraFields = updates.nextSendAt ? { next_send_at: updates.nextSendAt } : void 0;

package/dist/{neon-DyBfYFkz.d.ts → neon-CJl66EGy.d.cts}

@@ -1,9 +1,9 @@
 import { neon } from '@neondatabase/serverless';
-import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-D-ldTuIC.js';
+import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-C8OnYk6j.cjs';
 
 /**
  * Neon Serverless Database Adapter
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @implements {import('./interface.js').DbAdapter}
  */

package/dist/{neon-Ch9Abtfp.d.cts → neon-DYvGnCzx.d.ts}

@@ -1,9 +1,9 @@
 import { neon } from '@neondatabase/serverless';
-import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-D-ldTuIC.cjs';
+import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-C8OnYk6j.js';
 
 /**
  * Neon Serverless Database Adapter
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * @implements {import('./interface.js').DbAdapter}
  */

package/dist/{pg-DJWS_HZ3.d.ts → pg-07S-u_H4.d.cts}

@@ -1,9 +1,9 @@
 import { Pool } from 'pg';
-import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-D-ldTuIC.js';
+import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-C8OnYk6j.cjs';
 
 /**
  * PostgreSQL (pg) Database Adapter
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Uses the standard 'pg' npm package.
  *

package/dist/{pg-BpYu3O81.d.cts → pg-Du-pN_UT.d.ts}

@@ -1,9 +1,9 @@
 import { Pool } from 'pg';
-import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-D-ldTuIC.cjs';
+import { T as TABLE_SQL, I as INDEXES, V as VERIFY_TABLE_SQL, C as COLUMNS_SQL } from './schema-C8OnYk6j.js';
 
 /**
  * PostgreSQL (pg) Database Adapter
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  *
  * Uses the standard 'pg' npm package.
  *

package/dist/{schema-D-ldTuIC.d.cts → schema-C8OnYk6j.d.cts}

@@ -1,6 +1,6 @@
 /**
  * Shared SQL schema constants
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  */
 
 const TABLE_SQL = `

package/dist/{schema-D-ldTuIC.d.ts → schema-C8OnYk6j.d.ts}

@@ -1,6 +1,6 @@
 /**
  * Shared SQL schema constants
- * ReiStandard SDK v2.0.0-pre1
+ * ReiStandard SDK v2.0.1
  */
 
 const TABLE_SQL = `

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rei-standard/amsg-server",
-  "version": "2.0.0-pre1",
+  "version": "2.0.1",
   "description": "ReiStandard Active Messaging server SDK with pluggable database adapters",
   "repository": {
     "type": "git",