@acosmi/sdk-ts 2.14.0 → 2.16.0

package/dist/node/index.cjs

@@ -43,6 +43,57 @@ function newWebSearchTool(cfg) {
   }
   return st;
 }
+function classifySourcesEvent(ev) {
+  let parsed;
+  try {
+    parsed = JSON.parse(ev.data);
+  } catch {
+    return ev.event === "sources" ? { kind: "malformed_sources", code: "invalid_json" } : { kind: "not_sources" };
+  }
+  const wrapper = typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
+  if (wrapper?.type !== "sources" && ev.event !== "sources") {
+    return { kind: "not_sources" };
+  }
+  if (!wrapper || !Object.prototype.hasOwnProperty.call(wrapper, "sources")) {
+    return { kind: "malformed_sources", code: "missing_sources" };
+  }
+  if (Object.prototype.hasOwnProperty.call(wrapper, "session_id") && wrapper.session_id !== void 0 && typeof wrapper.session_id !== "string") {
+    return { kind: "malformed_sources", code: "session_id_invalid" };
+  }
+  if (!Array.isArray(wrapper.sources)) {
+    return { kind: "malformed_sources", code: "sources_not_array" };
+  }
+  const sessionID = typeof wrapper.session_id === "string" ? wrapper.session_id : void 0;
+  if (wrapper.sources.length === 0) {
+    return {
+      kind: "empty_sources",
+      ...sessionID === void 0 ? {} : { session_id: sessionID }
+    };
+  }
+  for (const source of wrapper.sources) {
+    if (typeof source !== "object" || source === null || Array.isArray(source)) {
+      return { kind: "malformed_sources", code: "source_not_object" };
+    }
+    const item = source;
+    if (typeof item.title !== "string") {
+      return { kind: "malformed_sources", code: "source_title_invalid" };
+    }
+    if (typeof item.url !== "string") {
+      return { kind: "malformed_sources", code: "source_url_invalid" };
+    }
+    if (Object.prototype.hasOwnProperty.call(item, "snippet") && item.snippet !== void 0 && typeof item.snippet !== "string") {
+      return { kind: "malformed_sources", code: "source_snippet_invalid" };
+    }
+  }
+  return {
+    kind: "sources",
+    value: {
+      ...wrapper,
+      sources: wrapper.sources,
+      ...sessionID === void 0 ? {} : { session_id: sessionID }
+    }
+  };
+}
 function parseSourcesEvent(ev) {
   let wrapper;
   try {
@@ -2239,6 +2290,13 @@ var ErrOAuthCORSBlocked = "oauth_cors_blocked";
 var ErrRefreshProxyFailed = "refresh_proxy_failed";
 var ErrTokenExpired = "token_expired";
 var CHAT_REQUEST_TIMEOUT_MS = 11 * 60 * 1e3;
+function notifyUpstreamActivity(cb) {
+  if (!cb) return;
+  try {
+    cb();
+  } catch {
+  }
+}
 var DEFAULT_API_TIMEOUT_MS = 6e4;
 function newDeferred() {
   let resolve;
@@ -2952,7 +3010,13 @@ var Client = class _Client {
     try {
       const { body, adapter } = await this.buildChatRequest(modelID, r, ctl.signal);
       const endpoint = `/managed-models/${encodeURIComponent(modelID)}${adapter.endpointSuffix()}`;
-      const { result, headers } = await this.doJSONFullRaw("POST", endpoint, body, ctl.signal);
+      const { result, headers } = await this.doJSONFullRaw(
+        "POST",
+        endpoint,
+        body,
+        ctl.signal,
+        CHAT_REQUEST_TIMEOUT_MS
+      );
       const resp = adapter.parseResponse(result);
       const v1 = headers.get("X-Token-Remaining");
       if (v1) {
@@ -3017,7 +3081,13 @@ var Client = class _Client {
    */
   async generateVideo(modelID, req, signal) {
     const endpoint = `/managed-models/${encodeURIComponent(modelID)}/videos/generations`;
-    const { result } = await this.doJSONFullRaw("POST", endpoint, req, signal);
+    const { result } = await this.doJSONFullRaw(
+      "POST",
+      endpoint,
+      req,
+      signal,
+      CHAT_REQUEST_TIMEOUT_MS
+    );
     return this.unwrapAPIResponse(result);
   }
   /**
@@ -3086,7 +3156,8 @@ var Client = class _Client {
         "POST",
         `/managed-models/${encodeURIComponent(modelID)}/anthropic`,
         data,
-        ctl.signal
+        ctl.signal,
+        CHAT_REQUEST_TIMEOUT_MS
       );
       const rawStr = new TextDecoder().decode(result);
       try {
@@ -3120,7 +3191,13 @@ var Client = class _Client {
       const body = adapter.buildRequestBody(caps, r);
       const data = JSON.stringify(body);
       const endpoint = `/managed-models/${encodeURIComponent(modelID)}${adapter.endpointSuffix()}`;
-      const { result } = await this.doJSONFullRaw("POST", endpoint, data, ctl.signal);
+      const { result } = await this.doJSONFullRaw(
+        "POST",
+        endpoint,
+        data,
+        ctl.signal,
+        CHAT_REQUEST_TIMEOUT_MS
+      );
       const { parseOpenAIResponseToAnthropic: parseOpenAIResponseToAnthropic2 } = await Promise.resolve().then(() => (init_openai(), openai_exports));
       return parseOpenAIResponseToAnthropic2(result);
     } finally {
@@ -3130,23 +3207,27 @@ var Client = class _Client {
   /**
    * 流式聊天 (SSE), 通过 async generator 返回事件
    * v0.5.0: 根据 adapter 路由端点
+   *
+   * @param onUpstreamActivity 见 {@link UpstreamActivityCallback}
    */
-  chatStream(modelID, req, signal) {
+  chatStream(modelID, req, signal, onUpstreamActivity) {
     return {
-      [Symbol.asyncIterator]: () => this.chatStreamGen(modelID, req, signal, false)
+      [Symbol.asyncIterator]: () => this.chatStreamGen(modelID, req, signal, false, onUpstreamActivity)
     };
   }
   /**
    * Anthropic 原生格式流式聊天 (SSE)
    * 调用 POST /managed-models/:id/anthropic, SSE 事件为 Anthropic 协议格式
    * 无 started/settled/failed 自定义事件, 无 data: [DONE], message_stop 为自然结束
+   *
+   * @param onUpstreamActivity 见 {@link UpstreamActivityCallback}
    */
-  chatMessagesStream(modelID, req, signal) {
+  chatMessagesStream(modelID, req, signal, onUpstreamActivity) {
     return {
-      [Symbol.asyncIterator]: () => this.chatMessagesStreamGen(modelID, req, signal, false)
+      [Symbol.asyncIterator]: () => this.chatMessagesStreamGen(modelID, req, signal, false, onUpstreamActivity)
     };
   }
-  async *chatStreamGen(modelID, req, signal, retried) {
+  async *chatStreamGen(modelID, req, signal, retried, onUpstreamActivity) {
     const r = { ...req, stream: true };
     const { body, adapter } = await this.buildChatRequest(modelID, r, signal);
     const token = await this.ensureToken(signal);
@@ -3179,7 +3260,7 @@ var Client = class _Client {
           `stream: unauthorized and refresh failed: ${refreshErr instanceof Error ? refreshErr.message : String(refreshErr)}`
         );
       }
-      yield* this.chatStreamGen(modelID, req, signal, true);
+      yield* this.chatStreamGen(modelID, req, signal, true, onUpstreamActivity);
       return;
     }
     if (!resp.ok) {
@@ -3195,6 +3276,7 @@ var Client = class _Client {
     }
     let currentEvent = "";
     for await (const line of iterSSELines(resp.body)) {
+      notifyUpstreamActivity(onUpstreamActivity);
       if (isSSECommentLine(line)) continue;
       if (line.startsWith("event:")) {
         currentEvent = line.slice("event:".length).trim();
@@ -3215,7 +3297,7 @@ var Client = class _Client {
       }
     }
   }
-  async *chatMessagesStreamGen(modelID, req, signal, retried) {
+  async *chatMessagesStreamGen(modelID, req, signal, retried, onUpstreamActivity) {
     const r = { ...req, stream: true };
     const { body, adapter } = await this.buildChatRequest(modelID, r, signal);
     const token = await this.ensureToken(signal);
@@ -3248,7 +3330,7 @@ var Client = class _Client {
           `messages stream: unauthorized and refresh failed: ${refreshErr instanceof Error ? refreshErr.message : String(refreshErr)}`
         );
       }
-      yield* this.chatMessagesStreamGen(modelID, req, signal, true);
+      yield* this.chatMessagesStreamGen(modelID, req, signal, true, onUpstreamActivity);
       return;
     }
     if (!resp.ok) {
@@ -3261,6 +3343,7 @@ var Client = class _Client {
     if (adapter.format() === 1 /* OpenAI */) {
       const converter = newOpenAIStreamConverter();
       for await (const line of iterSSELines(resp.body)) {
+        notifyUpstreamActivity(onUpstreamActivity);
         if (isSSECommentLine(line)) continue;
         if (line.startsWith("event:")) {
           line.slice("event:".length).trim();
@@ -3275,6 +3358,7 @@ var Client = class _Client {
       const blockTypeMap = /* @__PURE__ */ new Map();
       let currentEvent = "";
       for await (const line of iterSSELines(resp.body)) {
+        notifyUpstreamActivity(onUpstreamActivity);
         if (isSSECommentLine(line)) continue;
         if (line.startsWith("event:")) {
           currentEvent = line.slice("event:".length).trim();
@@ -3407,7 +3491,19 @@ var Client = class _Client {
       ctl.dispose();
     }
   }
-  /** doJSONFull 的 raw bytes 变体 (chat 用, 不立即 JSON.parse) */
+  /**
+   * doJSONFull 的 raw bytes 变体 (chat 用, 不立即 JSON.parse)
+   *
+   * ⚠️ 契约 (2026-08-06): `timeoutMs` 的 30s 默认值只适用于**控制面**端点 (列目录 /
+   * 查配额 / 取任务状态)。凡走**模型推理或生成**的端点 —— chat / anthropic /
+   * embeddings / rerank / images / videos —— 一律必须显式传入 `CHAT_REQUEST_TIMEOUT_MS`,
+   * 哪怕调用方已经用 `withRequestTimeout` 建了外层预算: 外层只约束 `signal`, 内层
+   * 会**另建**一个 `timeoutMs` 计时器, 30s 恒先于任何更长的外层预算触发。
+   *
+   * 这不是假设 —— 2026-08-06 事故里 chat 路径正因漏传本参数而被恒定钉死在 30s,
+   * 且上方 v1.6.0 的注释还声称它已是 11min。回归闸门见
+   * `tests/chat-timeout-budget.test.ts`。
+   */
   async doJSONFullRaw(method, path, body, signal, timeoutMs = 3e4) {
     return this.doJSONFullRawInternal(method, path, body, signal, false, timeoutMs);
   }
@@ -7068,6 +7164,15 @@ function sleep2(ms, signal) {
 }
 
 // src/support/bug-report.ts
+function unwrapBugReport(raw, op, isComplete) {
+  if (raw && isComplete(raw)) return raw;
+  const inner = raw?.data;
+  if (inner && isComplete(inner)) return inner;
+  const keys = raw && typeof raw === "object" ? Object.keys(raw) : [];
+  throw new Error(
+    `acosmi: ${op}: gateway accepted the request but the response is missing required fields (observed keys: ${keys.length > 0 ? keys.join(",") : "<none>"})`
+  );
+}
 Client.prototype.submitBugReport = async function(reportData, signal) {
   if (reportData == null) {
     throw new Error("acosmi: reportData required");
@@ -7084,7 +7189,11 @@ Client.prototype.submitBugReport = async function(reportData, signal) {
     { content: contentStr },
     signal
   );
-  return result.data;
+  return unwrapBugReport(
+    result,
+    "submitBugReport",
+    (r) => typeof r.feedback_id === "string" && r.feedback_id.length > 0
+  );
 };
 Client.prototype.getBugReport = async function(bugID, signal) {
   const trimmed = bugID.trim();
@@ -7097,7 +7206,7 @@ Client.prototype.getBugReport = async function(bugID, signal) {
     null,
     signal
   );
-  return resp.data;
+  return unwrapBugReport(resp, "getBugReport", (r) => typeof r.id === "string");
 };
 
 // src/subscription/client.ts
@@ -7688,6 +7797,7 @@ exports.AgentRunStreamError = AgentRunStreamError;
 exports.AgentRunsClient = AgentRunsClient;
 exports.AudienceEnum = AudienceEnum;
 exports.BillingModeEnum = BillingModeEnum;
+exports.CHAT_REQUEST_TIMEOUT_MS = CHAT_REQUEST_TIMEOUT_MS;
 exports.ChatBridgeClient = ChatBridgeClient;
 exports.Client = Client;
 exports.ComplianceClient = ComplianceClient;
@@ -7791,6 +7901,7 @@ exports.bucketRowIsCommercial = bucketRowIsCommercial;
 exports.buildBetas = buildBetas;
 exports.chatBridgeScopes = chatBridgeScopes;
 exports.classifyComplianceError = classifyComplianceError;
+exports.classifySourcesEvent = classifySourcesEvent;
 exports.commerceScopes = commerceScopes;
 exports.completeWebAuthorizationRequest = completeWebAuthorizationRequest;
 exports.complianceErrorToRetryAdvice = complianceErrorToRetryAdvice;