@acosmi/sdk-ts 2.9.0 → 2.11.0

package/dist/node/index.cjs

@@ -93,7 +93,21 @@ var init_types = __esm({
 });
 
 // src/shared/errors.ts
-exports.RateLimitError = void 0; exports.BusinessError = void 0; exports.OrderTerminalError = void 0; exports.ModelNotFoundError = void 0; exports.HTTPError = void 0; exports.NetworkError = void 0; exports.StreamError = void 0;
+function isWindowLimitError(err) {
+  if (!(err instanceof exports.HTTPError)) return false;
+  if (err.errorCode === windowLimitErrorCode) return true;
+  return err.message.includes(windowLimitErrorCode) || err.body.includes(windowLimitErrorCode);
+}
+function isWindowLimitStreamError(err) {
+  if (err == null || typeof err !== "object") return false;
+  const e = err;
+  if (e.code === windowLimitStreamCode) return true;
+  for (const field of [e.message, e.userMessage, e.rawError]) {
+    if (typeof field === "string" && field.includes(windowLimitErrorCode)) return true;
+  }
+  return false;
+}
+exports.RateLimitError = void 0; exports.BusinessError = void 0; exports.OrderTerminalError = void 0; exports.ModelNotFoundError = void 0; exports.HTTPError = void 0; exports.NetworkError = void 0; exports.StreamError = void 0; var windowLimitErrorCode, windowLimitStreamCode;
 var init_errors = __esm({
   "src/shared/errors.ts"() {
     exports.RateLimitError = class extends Error {
@@ -140,6 +154,12 @@ var init_errors = __esm({
       retryAfter;
       /** 原始响应体 (截断到 maxErrorBodySize) */
       body;
+      /** 后端业务机器码 (响应体顶层 errorCode, e.g. "WINDOW_LIMIT_EXCEEDED"); 缺失为 undefined */
+      errorCode;
+      /** 窗口限额场景: 触发的滚动窗口档位 (FIVE_HOUR = 5 小时 / WEEKLY = 7 天); 缺失为 undefined */
+      windowKind;
+      /** 窗口限额场景: 预计恢复时间 (ISO-8601 UTC); 缺失为 undefined */
+      windowResetAt;
       constructor(statusCode, opts = {}) {
         let msg;
         if (opts.type) {
@@ -157,6 +177,9 @@ var init_errors = __esm({
         this.type = opts.type ?? "";
         this.retryAfter = opts.retryAfter ?? 0;
         this.body = opts.body ?? "";
+        this.errorCode = opts.errorCode;
+        this.windowKind = opts.windowKind;
+        this.windowResetAt = opts.windowResetAt;
       }
     };
     exports.NetworkError = class extends Error {
@@ -212,6 +235,8 @@ var init_errors = __esm({
         this.retryable = retryable;
       }
     };
+    windowLimitErrorCode = "WINDOW_LIMIT_EXCEEDED";
+    windowLimitStreamCode = "window_limit_exceeded";
   }
 });
 
@@ -1932,19 +1957,28 @@ function parseHTTPErrorWithHeader(statusCode, body, header) {
   }
   let type = "";
   let message = "";
+  let errorCode;
+  let windowKind;
+  let windowResetAt;
   try {
     const obj = JSON.parse(bodyStr);
     if (obj && typeof obj === "object") {
-      const errObj = obj.error;
+      const top = obj;
+      const errObj = top.error;
       if (errObj && typeof errObj === "object") {
         const e = errObj;
         if (typeof e.message === "string") message = e.message;
         if (typeof e.type === "string") type = e.type;
+      } else if (typeof top.message === "string") {
+        message = top.message;
       }
+      if (typeof top.errorCode === "string") errorCode = top.errorCode;
+      if (top.windowKind === "FIVE_HOUR" || top.windowKind === "WEEKLY") windowKind = top.windowKind;
+      if (typeof top.windowResetAt === "string") windowResetAt = top.windowResetAt;
     }
   } catch {
   }
-  return new exports.HTTPError(statusCode, { type, message, retryAfter, body: bodyStr });
+  return new exports.HTTPError(statusCode, { type, message, retryAfter, body: bodyStr, errorCode, windowKind, windowResetAt });
 }
 function classifyTransport(op, urlStr, err) {
   const ne = new exports.NetworkError(op, urlStr, err);
@@ -2208,9 +2242,16 @@ var Client = class _Client {
   fetchImpl;
   /** 互斥锁 (TS 用 Promise chain 替代 sync.Mutex) */
   mu = Promise.resolve();
-  /** WebSocket 状态 (实际方法由 ws.ts mixin 维护) */
+  /**
+   * WebSocket 状态 (实际方法由 ws.ts mixin 维护)。
+   * @internal — 实现细节: 跨模块 (ws.ts mixin) 需可见故为 public, 但非消费者 API,
+   * 消费者用 connect/subscribe 等高层方法; 引用的 WSState 不进公开文档。
+   */
   ws = null;
-  /** v0.15.1: token 就绪等待机制 — login 成功后 resolve, 等待方解除阻塞 */
+  /**
+   * v0.15.1: token 就绪等待机制 — login 成功后 resolve, 等待方解除阻塞。
+   * @internal — 内部同步原语 (Deferred), 非消费者 API。
+   */
   tokenReady = newDeferred();
   /** Login 进行中 — 等待方需等而非 fail-fast */
   loginInFlight = false;
@@ -5631,6 +5672,9 @@ function normalizeError(value) {
     message: stringField(value, "message", "error") || "agent run failed",
     stage: optionalStringField(value, "stage"),
     retryable: typeof value.retryable === "boolean" ? value.retryable : void 0,
+    // 窗口限额扩展 (code="window_limit_exceeded"): 契约 wire 为 camelCase, 蛇形兼容兜底。
+    windowKind: optionalStringField(value, "windowKind", "window_kind"),
+    windowResetAt: optionalStringField(value, "windowResetAt", "window_reset_at"),
     raw: value
   };
 }
@@ -7692,6 +7736,8 @@ exports.isSSECommentLine = isSSECommentLine;
 exports.isSSLError = isSSLError;
 exports.isTerminalRemoteEvent = isTerminalRemoteEvent;
 exports.isValidTokenSet = isValidTokenSet;
+exports.isWindowLimitError = isWindowLimitError;
+exports.isWindowLimitStreamError = isWindowLimitStreamError;
 exports.maxEndUserIdLength = maxEndUserIdLength;
 exports.modelScopes = modelScopes;
 exports.modelSupportsImageInput = modelSupportsImageInput;