@acosmi/sdk-ts 2.10.0 → 2.12.0

package/dist/node/index.cjs

@@ -93,7 +93,34 @@ 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;
+}
+function isContinuableWindowLimitError(err) {
+  return isWindowLimitError(err) && err.windowOverridable === true;
+}
+function getWindowLimitStreamDetails(err) {
+  if (!isWindowLimitStreamError(err)) return null;
+  const e = err ?? {};
+  const kind = e.windowKind === "FIVE_HOUR" || e.windowKind === "WEEKLY" ? e.windowKind : void 0;
+  return {
+    windowKind: kind,
+    windowResetAt: typeof e.windowResetAt === "string" ? e.windowResetAt : void 0,
+    windowOverridable: typeof e.windowOverridable === "boolean" ? e.windowOverridable : void 0
+  };
+}
+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 +167,18 @@ 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;
+      /**
+       * [W1 2026-07-11 软限额] 窗口限额场景: 该 429 可否被用户「继续」开关豁免 —
+       * true = 5 小时软限额严格模式 (客户端可提示「继续任务」以消耗周配额继续);
+       * false/缺失 = 周窗/显式禁止/灰度关 (硬等待, 无豁免路径, 老网关不返回时为 undefined)。
+       */
+      windowOverridable;
       constructor(statusCode, opts = {}) {
         let msg;
         if (opts.type) {
@@ -157,6 +196,10 @@ 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;
+        this.windowOverridable = opts.windowOverridable;
       }
     };
     exports.NetworkError = class extends Error {
@@ -212,6 +255,8 @@ var init_errors = __esm({
         this.retryable = retryable;
       }
     };
+    windowLimitErrorCode = "WINDOW_LIMIT_EXCEEDED";
+    windowLimitStreamCode = "window_limit_exceeded";
   }
 });
 
@@ -1932,19 +1977,39 @@ function parseHTTPErrorWithHeader(statusCode, body, header) {
   }
   let type = "";
   let message = "";
+  let errorCode;
+  let windowKind;
+  let windowResetAt;
+  let windowOverridable;
   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;
+      if (typeof top.windowOverridable === "boolean") windowOverridable = top.windowOverridable;
     }
   } catch {
   }
-  return new exports.HTTPError(statusCode, { type, message, retryAfter, body: bodyStr });
+  return new exports.HTTPError(statusCode, {
+    type,
+    message,
+    retryAfter,
+    body: bodyStr,
+    errorCode,
+    windowKind,
+    windowResetAt,
+    windowOverridable
+  });
 }
 function classifyTransport(op, urlStr, err) {
   const ne = new exports.NetworkError(op, urlStr, err);
@@ -2733,6 +2798,24 @@ var Client = class _Client {
     );
     return resp.data;
   }
+  /**
+   * [W1 2026-07-11 软限额] 设置当前用户 5 小时窗口软限额「继续」开关 (v2.12+)。
+   *
+   * enabled=true = 软限额 (到达 5h 后继续消耗周配额, 默认); false = 严格模式 (到达即等待逐步恢复)。
+   * userId 由网关从鉴权态解析 (客户端永不传), 故只需 enabled + 可选 source (审计: web /
+   * crabcode-gui / crabcode-tui / dialog)。用于个人中心开关、429 严格模式「重新开启继续」续跑。
+   *
+   * @returns 网关回显的新状态 { enabled }。
+   */
+  async setWindowContinuePreference(enabled, opts) {
+    const resp = await this.doJSON(
+      "POST",
+      "/entitlements/window-continue-pref",
+      { enabled, source: opts?.source },
+      opts?.signal
+    );
+    return { enabled: resp.data.enabled };
+  }
   /**
    * 查询单个模型的能力矩阵
    * 优先从 listModels 缓存读取, miss 时调用 listModels 刷新
@@ -5638,6 +5721,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
   };
 }
@@ -7687,10 +7773,12 @@ exports.findFirstModelByInputModality = findFirstModelByInputModality;
 exports.generateState = generateState;
 exports.getAdapter = getAdapter;
 exports.getAdapterForModel = getAdapterForModel;
+exports.getWindowLimitStreamDetails = getWindowLimitStreamDetails;
 exports.isBillingConfirmable = isBillingConfirmable;
 exports.isChannelInboundEvent = isChannelInboundEvent;
 exports.isComplianceBusinessError = isComplianceBusinessError;
 exports.isComplianceTerminalError = isComplianceTerminalError;
+exports.isContinuableWindowLimitError = isContinuableWindowLimitError;
 exports.isIntegrationStatus = isIntegrationStatus;
 exports.isInvalidGrantError = isInvalidGrantError;
 exports.isPlatform = isPlatform;
@@ -7699,6 +7787,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;