@acosmi/sdk-ts 2.13.0 → 2.15.0

package/dist/node/{index-BI-Y3iOO.d.ts → index-yOZUFtNQ.d.ts}

@@ -179,15 +179,34 @@ interface RerankResponse {
     model?: string;
 }
 /**
- * 模型可接收的用户输入模态 (v1.2+).
+ * 模型可接收的用户输入模态 —— **本 SDK 已知的那些** (v1.2+).
  *
  * - 'text': 文本输入
  * - 'image': 截图 / 图片输入 (多模态)
+ * - 'video': 视频输入 (多模态向量 / 重排序类模型, 网关 2026-06-20 起下发)
  *
  * ManagedModel.inputModalities 包含 'image' 才允许向该模型直接发图;
  * 缺失字段时调用方应保守按 text-only / unknown 处理.
+ *
+ * 这个联合体是**查询用**的 (helper 的 modality 参数), 不是数据域的全集 —— 见
+ * {@link InputModalityTag}.
  */
-type InputModality = 'text' | 'image';
+type InputModality = 'text' | 'image' | 'video';
+/**
+ * 目录里实际可能出现的模态标签 —— **开放值域**, 已知取值见 {@link InputModality}.
+ *
+ * 值域由网关托管模型目录持有, 靠运营动作扩张 (不是靠发 SDK 新版)。把数据字段
+ * 声明成封闭联合体, 等于让类型对在网真实数据撒谎; 2026-08-02 CrabCode 客户端
+ * 因同一形态的封闭枚举 (Rust 侧) 把整个网关模型列表打空过数周。
+ *
+ * 因此: **查询**用 {@link InputModality} (已知标签, 有自动补全),
+ * **数据**用本类型 (照收未知标签, 不丢信息、不谎报)。
+ *
+ * 刻意就是朴素 `string`, 不用 `InputModality | (string & {})` 那个"保留补全"的
+ * 技巧: 补全只在**书写**字面量时有价值, 而本类型描述的是**读到**的目录数据;
+ * 那个技巧还要靠 `{}` —— 本仓 eslint `ban-types` 明令禁止。
+ */
+type InputModalityTag = string;
 /** BucketClass 字面量常量 — V30 二轮审计 D-P1-3 修复 */
 declare const BucketClassCommercial = "COMMERCIAL";
 declare const BucketClassGeneric = "GENERIC";
@@ -261,14 +280,16 @@ interface ManagedModel {
     /**
      * 模型可接收的用户输入模态 (v1.2+, CrabCode desktop automation / computer-use 选模型用).
      *
-     * 取值: 'text' | 'image' 的子集. 'image' 表示模型可直接接收 screenshot/image 输入.
+     * 已知取值见 {@link InputModality} ('text' | 'image' | 'video'); 'image' 表示模型可
+     * 直接接收 screenshot/image 输入。类型是**开放**的 ({@link InputModalityTag}) ——
+     * 目录新增模态时旧版 SDK 照样原样透出, 不静默丢值。
      *
      * 兼容上游字段名 input_modalities (snake_case) — listModels 在写缓存前会做归一化.
      *
      * **缺失语义**: 上游未下发时该字段为 undefined, 调用方必须保守按 text-only / unknown
      * 处理, 严禁默认假设支持 image. 同样严禁用模型名 substring 反推 modality.
      */
-    inputModalities?: InputModality[];
+    inputModalities?: InputModalityTag[];
 }
 /** 单桶视图 — QuotaSummary.freeBuckets/paidBuckets 元素 */
 interface BucketRow {
@@ -501,9 +522,36 @@ interface SourcesEvent {
     sources: WebSearchSource[];
     session_id?: string;
 }
+/** sources 事件结构错误的稳定机器码。 */
+type SourcesEventIssueCode = 'invalid_json' | 'missing_sources' | 'sources_not_array' | 'source_not_object' | 'source_title_invalid' | 'source_url_invalid' | 'source_snippet_invalid' | 'session_id_invalid';
+/**
+ * sources SSE 的无歧义分类结果。
+ *
+ * `empty_sources` 是合法零结果；`malformed_sources` 才表示结构损坏。
+ */
+type SourcesEventParseResult = {
+    kind: 'not_sources';
+} | {
+    kind: 'empty_sources';
+    session_id?: string;
+} | {
+    kind: 'sources';
+    value: SourcesEvent;
+} | {
+    kind: 'malformed_sources';
+    code: SourcesEventIssueCode;
+};
+/**
+ * 同时识别 SSE event name 与 JSON payload discriminator，并把合法空结果
+ * 与非 sources、结构损坏明确分开。未知额外字段不影响分类。
+ */
+declare function classifySourcesEvent(ev: StreamEvent): SourcesEventParseResult;
 /**
  * 从 StreamEvent 中解析搜索来源
- * 返回 null 表示该事件不是 sources 类型
+ *
+ * @deprecated 需要区分合法空结果与结构损坏时使用 classifySourcesEvent。
+ * 此 legacy API 保留原有宽松解析和返回对象形状；新代码不得据此区分
+ * 合法空结果与结构损坏。
  */
 declare function parseSourcesEvent(ev: StreamEvent): SourcesEvent | null;
 /**
@@ -619,4 +667,4 @@ declare function getAdapter(provider: string): ProviderAdapter;
  */
 declare function getAdapterForModel(m: ManagedModel): ProviderAdapter;
 
-export { parseSourcesEvent as $, ThinkingMaxFallbackMaxTokens as A, BucketClassCommercial as B, type ChatContentBlock as C, ThinkingOff as D, type EffortConfig as E, type VideoTaskResponse as F, type GeoLoc as G, type WebSearchSource as H, type ImageGenerationRequest as I, type WindowLimitStatus as J, type WindowResetSummary as K, bucketInfoIsCommercial as L, type ManagedModel as M, bucketRowIsCommercial as N, type OutputConfig as O, type ProviderAdapter as P, type QuotaSummary as Q, type RerankDocument as R, type ServerTool as S, type ThinkingConfig as T, getAdapter as U, type VideoGenerationRequest as V, type WebSearchConfig as W, getAdapterForModel as X, newThinkingConfig as Y, newWebSearchTool as Z, parseSettlement as _, BucketClassGeneric as a, type BucketInfo as b, type BucketRow as c, type ChatMessage as d, type ChatRequest as e, type ChatResponse as f, type ChatUsage as g, type EmbeddingData as h, type EmbeddingRequest as i, type EmbeddingResponse as j, type ImageGenerationResponse as k, type InputModality as l, type ModelCapabilities as m, type MultimodalContent as n, ProviderFormat as o, type RerankQuery as p, type RerankRequest as q, type RerankResponse as r, type RerankResult as s, ServerToolTypeWebSearch as t, type SourcesEvent as u, type StreamEvent as v, type StreamSettlement as w, ThinkingHigh as x, ThinkingHighMinMaxTokens as y, ThinkingMax as z };
+export { getAdapterForModel as $, ThinkingHigh as A, BucketClassCommercial as B, type ChatContentBlock as C, ThinkingHighMinMaxTokens as D, type EffortConfig as E, ThinkingMax as F, type GeoLoc as G, ThinkingMaxFallbackMaxTokens as H, type ImageGenerationRequest as I, ThinkingOff as J, type VideoTaskResponse as K, type WebSearchSource as L, type ManagedModel as M, type WindowLimitStatus as N, type OutputConfig as O, type ProviderAdapter as P, type QuotaSummary as Q, type RerankDocument as R, type ServerTool as S, type ThinkingConfig as T, type WindowResetSummary as U, type VideoGenerationRequest as V, type WebSearchConfig as W, bucketInfoIsCommercial as X, bucketRowIsCommercial as Y, classifySourcesEvent as Z, getAdapter as _, BucketClassGeneric as a, newThinkingConfig as a0, newWebSearchTool as a1, parseSettlement as a2, parseSourcesEvent as a3, type BucketInfo as b, type BucketRow as c, type ChatMessage as d, type ChatRequest as e, type ChatResponse as f, type ChatUsage as g, type EmbeddingData as h, type EmbeddingRequest as i, type EmbeddingResponse as j, type ImageGenerationResponse as k, type InputModality as l, type InputModalityTag as m, type ModelCapabilities as n, type MultimodalContent as o, ProviderFormat as p, type RerankQuery as q, type RerankRequest as r, type RerankResponse as s, type RerankResult as t, ServerToolTypeWebSearch as u, type SourcesEvent as v, type SourcesEventIssueCode as w, type SourcesEventParseResult as x, type StreamEvent as y, type StreamSettlement as z };

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 {
@@ -3610,9 +3661,7 @@ function normalizeInputModalities(models) {
     if (Array.isArray(m.inputModalities)) continue;
     const snake = m.input_modalities;
     if (Array.isArray(snake)) {
-      m.inputModalities = snake.filter(
-        (v) => v === "text" || v === "image"
-      );
+      m.inputModalities = snake.filter((v) => typeof v === "string");
     }
   }
   return models;
@@ -7793,6 +7842,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;