@acosmi/sdk-ts 1.0.0

package/dist/node/index-nvLKgCm9.d.cts

@@ -0,0 +1,147 @@
+/** Anthropic content block 类型 (请求 + 响应 + ephemeral) */
+type BlockType = 'text' | 'image' | 'video' | 'document' | 'search_result' | 'thinking' | 'redacted_thinking' | 'tool_use' | 'tool_result' | 'tool_reference' | 'server_tool_use' | 'web_search_tool_result' | 'code_execution_tool_result' | 'mcp_tool_use' | 'mcp_tool_result' | 'container_upload';
+declare const BlockText: BlockType;
+declare const BlockImage: BlockType;
+declare const BlockVideo: BlockType;
+declare const BlockDocument: BlockType;
+declare const BlockSearchResult: BlockType;
+declare const BlockThinking: BlockType;
+declare const BlockRedactedThinking: BlockType;
+declare const BlockToolUse: BlockType;
+declare const BlockToolResult: BlockType;
+declare const BlockToolReference: BlockType;
+declare const BlockServerToolUse: BlockType;
+declare const BlockWebSearchToolResult: BlockType;
+declare const BlockCodeExecutionToolResult: BlockType;
+declare const BlockMCPToolUse: BlockType;
+declare const BlockMCPToolResult: BlockType;
+declare const BlockContainerUpload: BlockType;
+/** 流式响应 delta 类型 (与 BlockType 正交) */
+type DeltaType = 'text_delta' | 'input_json_delta' | 'thinking_delta' | 'signature_delta' | 'citations_delta';
+declare const DeltaText: DeltaType;
+declare const DeltaInputJSON: DeltaType;
+declare const DeltaThinking: DeltaType;
+declare const DeltaSignature: DeltaType;
+declare const DeltaCitations: DeltaType;
+/**
+ * 网关在 block JSON 中注入的 in-band 标记字段名。
+ * 存在且值为 true 时代表该 block 不应回传下一轮。
+ *
+ * 选择 in-band 标记而非独立 SSE 事件的理由:
+ *   - 零缓冲 / 零顺序依赖 / 零延迟
+ *   - history 剥离天然可做
+ */
+declare const EphemeralMarkerField = "acosmi_ephemeral";
+
+/**
+ * SDK 层防御性配置。只做所有下游 provider 都不可能接受的底线剥除;
+ * 具体 provider 适配由网关承担。
+ *
+ * 零值 = 不校验 / 不剥除, 等价于未启用。
+ */
+interface MinimalSanitizeConfig {
+    /** 体积上限 (字节, 仅对 base64 内联媒体生效; URL 版交网关把关). 0 = 不校验. */
+    maxImageBytes?: number;
+    maxVideoBytes?: number;
+    maxPDFBytes?: number;
+    /** history 轮次硬上限 (防止内存爆炸 / 上行带宽). 0 = 不校验. 超限抛 ErrHistoryTooDeep. */
+    maxMessagesTurns?: number;
+    /** 公共黑名单 (所有 provider 均拒绝的 block 类型). 默认空. */
+    permanentDenyBlocks?: BlockType[];
+}
+declare class HistoryTooDeepError extends Error {
+    constructor();
+}
+declare class BlockDeniedError extends Error {
+    constructor();
+}
+/** 体积超限错误, 携带实际/上限字节数以便上游展示。 */
+declare class SizeError extends Error {
+    blockType: BlockType;
+    actual: number;
+    limit: number;
+    constructor(blockType: BlockType, actual: number, limit: number);
+}
+declare const ErrHistoryTooDeep: HistoryTooDeepError;
+declare const ErrBlockDenied: BlockDeniedError;
+
+/**
+ * 对已经解析为 unknown[] 的 messages 做底线防御: 深度校验 +
+ * 体积校验 + deny-list 剥除 + tool_use_id 联动剥除 tool_result。
+ *
+ * 入参形态: messages 的每个元素预期是 object (含 role / content); content 为 string (plain text)
+ * 或 unknown[] (block 数组)。形态异常的元素原样透传, 不抛错。
+ *
+ * 通过返回新 messages (可能 block 数组被缩减); 早失败抛错 (调用方应放弃本次请求)。
+ */
+declare function sanitize(messages: unknown[], cfg: MinimalSanitizeConfig): unknown[];
+
+/** 判定一个 block 是否应被剥除 */
+type BlockPredicate = (block: Record<string, unknown>) => boolean;
+/**
+ * 按 pred 从 messages 中剥除 block, 并联动剥除对应的 tool_result (user 轮)。
+ *
+ * 收敛两步: 先扫收集 droppedToolUseIDs, 再整体剥; 这样顺序不影响正确性
+ * (即使 tool_result 在 tool_use 之前出现也能捕获)。
+ *
+ * 不修改入参 messages 中任何 map 的 key, 只重构数组。
+ * 未被修改的 message 保持原引用 (零拷贝优化)。
+ */
+declare function dropBlocks(messages: unknown[], pred: BlockPredicate): unknown[];
+/**
+ * 从 messages 中剥除带 acosmi_ephemeral:true 标记的 block, 以及对应的 tool_result。
+ *
+ * 硬豁免: thinking / redacted_thinking 块永不剥, 即使携带 ephemeral 标记。
+ *
+ * 理由: Anthropic extended thinking + tool_use 续轮场景下, 上游强制要求
+ * assistant 历史中保留原始 thinking 块, 否则返回:
+ *   "The content[].thinking in the thinking mode must be passed back to the API."
+ *
+ * 历史污染防御: 即使旧版网关 / 历史响应里 thinking 块带了 ephemeral=true,
+ * 客户端在调用 stripEphemeral 时也不应剥除。网关侧 anthropic preset 已停止注入此标记,
+ * 本豁免兜底历史会话与第三方调用方两类已污染场景。
+ */
+declare function stripEphemeral(messages: unknown[]): unknown[];
+
+declare const index_BlockCodeExecutionToolResult: typeof BlockCodeExecutionToolResult;
+declare const index_BlockContainerUpload: typeof BlockContainerUpload;
+type index_BlockDeniedError = BlockDeniedError;
+declare const index_BlockDeniedError: typeof BlockDeniedError;
+declare const index_BlockDocument: typeof BlockDocument;
+declare const index_BlockImage: typeof BlockImage;
+declare const index_BlockMCPToolResult: typeof BlockMCPToolResult;
+declare const index_BlockMCPToolUse: typeof BlockMCPToolUse;
+type index_BlockPredicate = BlockPredicate;
+declare const index_BlockRedactedThinking: typeof BlockRedactedThinking;
+declare const index_BlockSearchResult: typeof BlockSearchResult;
+declare const index_BlockServerToolUse: typeof BlockServerToolUse;
+declare const index_BlockText: typeof BlockText;
+declare const index_BlockThinking: typeof BlockThinking;
+declare const index_BlockToolReference: typeof BlockToolReference;
+declare const index_BlockToolResult: typeof BlockToolResult;
+declare const index_BlockToolUse: typeof BlockToolUse;
+type index_BlockType = BlockType;
+declare const index_BlockVideo: typeof BlockVideo;
+declare const index_BlockWebSearchToolResult: typeof BlockWebSearchToolResult;
+declare const index_DeltaCitations: typeof DeltaCitations;
+declare const index_DeltaInputJSON: typeof DeltaInputJSON;
+declare const index_DeltaSignature: typeof DeltaSignature;
+declare const index_DeltaText: typeof DeltaText;
+declare const index_DeltaThinking: typeof DeltaThinking;
+type index_DeltaType = DeltaType;
+declare const index_EphemeralMarkerField: typeof EphemeralMarkerField;
+declare const index_ErrBlockDenied: typeof ErrBlockDenied;
+declare const index_ErrHistoryTooDeep: typeof ErrHistoryTooDeep;
+type index_HistoryTooDeepError = HistoryTooDeepError;
+declare const index_HistoryTooDeepError: typeof HistoryTooDeepError;
+type index_MinimalSanitizeConfig = MinimalSanitizeConfig;
+type index_SizeError = SizeError;
+declare const index_SizeError: typeof SizeError;
+declare const index_dropBlocks: typeof dropBlocks;
+declare const index_sanitize: typeof sanitize;
+declare const index_stripEphemeral: typeof stripEphemeral;
+declare namespace index {
+  export { index_BlockCodeExecutionToolResult as BlockCodeExecutionToolResult, index_BlockContainerUpload as BlockContainerUpload, index_BlockDeniedError as BlockDeniedError, index_BlockDocument as BlockDocument, index_BlockImage as BlockImage, index_BlockMCPToolResult as BlockMCPToolResult, index_BlockMCPToolUse as BlockMCPToolUse, type index_BlockPredicate as BlockPredicate, index_BlockRedactedThinking as BlockRedactedThinking, index_BlockSearchResult as BlockSearchResult, index_BlockServerToolUse as BlockServerToolUse, index_BlockText as BlockText, index_BlockThinking as BlockThinking, index_BlockToolReference as BlockToolReference, index_BlockToolResult as BlockToolResult, index_BlockToolUse as BlockToolUse, type index_BlockType as BlockType, index_BlockVideo as BlockVideo, index_BlockWebSearchToolResult as BlockWebSearchToolResult, index_DeltaCitations as DeltaCitations, index_DeltaInputJSON as DeltaInputJSON, index_DeltaSignature as DeltaSignature, index_DeltaText as DeltaText, index_DeltaThinking as DeltaThinking, type index_DeltaType as DeltaType, index_EphemeralMarkerField as EphemeralMarkerField, index_ErrBlockDenied as ErrBlockDenied, index_ErrHistoryTooDeep as ErrHistoryTooDeep, index_HistoryTooDeepError as HistoryTooDeepError, type index_MinimalSanitizeConfig as MinimalSanitizeConfig, index_SizeError as SizeError, index_dropBlocks as dropBlocks, index_sanitize as sanitize, index_stripEphemeral as stripEphemeral };
+}
+
+export { dropBlocks as A, BlockCodeExecutionToolResult as B, sanitize as C, DeltaCitations as D, EphemeralMarkerField as E, stripEphemeral as F, HistoryTooDeepError as H, type MinimalSanitizeConfig as M, SizeError as S, BlockContainerUpload as a, BlockDeniedError as b, BlockDocument as c, BlockImage as d, BlockMCPToolResult as e, BlockMCPToolUse as f, type BlockPredicate as g, BlockRedactedThinking as h, index as i, BlockSearchResult as j, BlockServerToolUse as k, BlockText as l, BlockThinking as m, BlockToolReference as n, BlockToolResult as o, BlockToolUse as p, type BlockType as q, BlockVideo as r, BlockWebSearchToolResult as s, DeltaInputJSON as t, DeltaSignature as u, DeltaText as v, DeltaThinking as w, type DeltaType as x, ErrBlockDenied as y, ErrHistoryTooDeep as z };

package/dist/node/index-nvLKgCm9.d.ts

@@ -0,0 +1,147 @@
+/** Anthropic content block 类型 (请求 + 响应 + ephemeral) */
+type BlockType = 'text' | 'image' | 'video' | 'document' | 'search_result' | 'thinking' | 'redacted_thinking' | 'tool_use' | 'tool_result' | 'tool_reference' | 'server_tool_use' | 'web_search_tool_result' | 'code_execution_tool_result' | 'mcp_tool_use' | 'mcp_tool_result' | 'container_upload';
+declare const BlockText: BlockType;
+declare const BlockImage: BlockType;
+declare const BlockVideo: BlockType;
+declare const BlockDocument: BlockType;
+declare const BlockSearchResult: BlockType;
+declare const BlockThinking: BlockType;
+declare const BlockRedactedThinking: BlockType;
+declare const BlockToolUse: BlockType;
+declare const BlockToolResult: BlockType;
+declare const BlockToolReference: BlockType;
+declare const BlockServerToolUse: BlockType;
+declare const BlockWebSearchToolResult: BlockType;
+declare const BlockCodeExecutionToolResult: BlockType;
+declare const BlockMCPToolUse: BlockType;
+declare const BlockMCPToolResult: BlockType;
+declare const BlockContainerUpload: BlockType;
+/** 流式响应 delta 类型 (与 BlockType 正交) */
+type DeltaType = 'text_delta' | 'input_json_delta' | 'thinking_delta' | 'signature_delta' | 'citations_delta';
+declare const DeltaText: DeltaType;
+declare const DeltaInputJSON: DeltaType;
+declare const DeltaThinking: DeltaType;
+declare const DeltaSignature: DeltaType;
+declare const DeltaCitations: DeltaType;
+/**
+ * 网关在 block JSON 中注入的 in-band 标记字段名。
+ * 存在且值为 true 时代表该 block 不应回传下一轮。
+ *
+ * 选择 in-band 标记而非独立 SSE 事件的理由:
+ *   - 零缓冲 / 零顺序依赖 / 零延迟
+ *   - history 剥离天然可做
+ */
+declare const EphemeralMarkerField = "acosmi_ephemeral";
+
+/**
+ * SDK 层防御性配置。只做所有下游 provider 都不可能接受的底线剥除;
+ * 具体 provider 适配由网关承担。
+ *
+ * 零值 = 不校验 / 不剥除, 等价于未启用。
+ */
+interface MinimalSanitizeConfig {
+    /** 体积上限 (字节, 仅对 base64 内联媒体生效; URL 版交网关把关). 0 = 不校验. */
+    maxImageBytes?: number;
+    maxVideoBytes?: number;
+    maxPDFBytes?: number;
+    /** history 轮次硬上限 (防止内存爆炸 / 上行带宽). 0 = 不校验. 超限抛 ErrHistoryTooDeep. */
+    maxMessagesTurns?: number;
+    /** 公共黑名单 (所有 provider 均拒绝的 block 类型). 默认空. */
+    permanentDenyBlocks?: BlockType[];
+}
+declare class HistoryTooDeepError extends Error {
+    constructor();
+}
+declare class BlockDeniedError extends Error {
+    constructor();
+}
+/** 体积超限错误, 携带实际/上限字节数以便上游展示。 */
+declare class SizeError extends Error {
+    blockType: BlockType;
+    actual: number;
+    limit: number;
+    constructor(blockType: BlockType, actual: number, limit: number);
+}
+declare const ErrHistoryTooDeep: HistoryTooDeepError;
+declare const ErrBlockDenied: BlockDeniedError;
+
+/**
+ * 对已经解析为 unknown[] 的 messages 做底线防御: 深度校验 +
+ * 体积校验 + deny-list 剥除 + tool_use_id 联动剥除 tool_result。
+ *
+ * 入参形态: messages 的每个元素预期是 object (含 role / content); content 为 string (plain text)
+ * 或 unknown[] (block 数组)。形态异常的元素原样透传, 不抛错。
+ *
+ * 通过返回新 messages (可能 block 数组被缩减); 早失败抛错 (调用方应放弃本次请求)。
+ */
+declare function sanitize(messages: unknown[], cfg: MinimalSanitizeConfig): unknown[];
+
+/** 判定一个 block 是否应被剥除 */
+type BlockPredicate = (block: Record<string, unknown>) => boolean;
+/**
+ * 按 pred 从 messages 中剥除 block, 并联动剥除对应的 tool_result (user 轮)。
+ *
+ * 收敛两步: 先扫收集 droppedToolUseIDs, 再整体剥; 这样顺序不影响正确性
+ * (即使 tool_result 在 tool_use 之前出现也能捕获)。
+ *
+ * 不修改入参 messages 中任何 map 的 key, 只重构数组。
+ * 未被修改的 message 保持原引用 (零拷贝优化)。
+ */
+declare function dropBlocks(messages: unknown[], pred: BlockPredicate): unknown[];
+/**
+ * 从 messages 中剥除带 acosmi_ephemeral:true 标记的 block, 以及对应的 tool_result。
+ *
+ * 硬豁免: thinking / redacted_thinking 块永不剥, 即使携带 ephemeral 标记。
+ *
+ * 理由: Anthropic extended thinking + tool_use 续轮场景下, 上游强制要求
+ * assistant 历史中保留原始 thinking 块, 否则返回:
+ *   "The content[].thinking in the thinking mode must be passed back to the API."
+ *
+ * 历史污染防御: 即使旧版网关 / 历史响应里 thinking 块带了 ephemeral=true,
+ * 客户端在调用 stripEphemeral 时也不应剥除。网关侧 anthropic preset 已停止注入此标记,
+ * 本豁免兜底历史会话与第三方调用方两类已污染场景。
+ */
+declare function stripEphemeral(messages: unknown[]): unknown[];
+
+declare const index_BlockCodeExecutionToolResult: typeof BlockCodeExecutionToolResult;
+declare const index_BlockContainerUpload: typeof BlockContainerUpload;
+type index_BlockDeniedError = BlockDeniedError;
+declare const index_BlockDeniedError: typeof BlockDeniedError;
+declare const index_BlockDocument: typeof BlockDocument;
+declare const index_BlockImage: typeof BlockImage;
+declare const index_BlockMCPToolResult: typeof BlockMCPToolResult;
+declare const index_BlockMCPToolUse: typeof BlockMCPToolUse;
+type index_BlockPredicate = BlockPredicate;
+declare const index_BlockRedactedThinking: typeof BlockRedactedThinking;
+declare const index_BlockSearchResult: typeof BlockSearchResult;
+declare const index_BlockServerToolUse: typeof BlockServerToolUse;
+declare const index_BlockText: typeof BlockText;
+declare const index_BlockThinking: typeof BlockThinking;
+declare const index_BlockToolReference: typeof BlockToolReference;
+declare const index_BlockToolResult: typeof BlockToolResult;
+declare const index_BlockToolUse: typeof BlockToolUse;
+type index_BlockType = BlockType;
+declare const index_BlockVideo: typeof BlockVideo;
+declare const index_BlockWebSearchToolResult: typeof BlockWebSearchToolResult;
+declare const index_DeltaCitations: typeof DeltaCitations;
+declare const index_DeltaInputJSON: typeof DeltaInputJSON;
+declare const index_DeltaSignature: typeof DeltaSignature;
+declare const index_DeltaText: typeof DeltaText;
+declare const index_DeltaThinking: typeof DeltaThinking;
+type index_DeltaType = DeltaType;
+declare const index_EphemeralMarkerField: typeof EphemeralMarkerField;
+declare const index_ErrBlockDenied: typeof ErrBlockDenied;
+declare const index_ErrHistoryTooDeep: typeof ErrHistoryTooDeep;
+type index_HistoryTooDeepError = HistoryTooDeepError;
+declare const index_HistoryTooDeepError: typeof HistoryTooDeepError;
+type index_MinimalSanitizeConfig = MinimalSanitizeConfig;
+type index_SizeError = SizeError;
+declare const index_SizeError: typeof SizeError;
+declare const index_dropBlocks: typeof dropBlocks;
+declare const index_sanitize: typeof sanitize;
+declare const index_stripEphemeral: typeof stripEphemeral;
+declare namespace index {
+  export { index_BlockCodeExecutionToolResult as BlockCodeExecutionToolResult, index_BlockContainerUpload as BlockContainerUpload, index_BlockDeniedError as BlockDeniedError, index_BlockDocument as BlockDocument, index_BlockImage as BlockImage, index_BlockMCPToolResult as BlockMCPToolResult, index_BlockMCPToolUse as BlockMCPToolUse, type index_BlockPredicate as BlockPredicate, index_BlockRedactedThinking as BlockRedactedThinking, index_BlockSearchResult as BlockSearchResult, index_BlockServerToolUse as BlockServerToolUse, index_BlockText as BlockText, index_BlockThinking as BlockThinking, index_BlockToolReference as BlockToolReference, index_BlockToolResult as BlockToolResult, index_BlockToolUse as BlockToolUse, type index_BlockType as BlockType, index_BlockVideo as BlockVideo, index_BlockWebSearchToolResult as BlockWebSearchToolResult, index_DeltaCitations as DeltaCitations, index_DeltaInputJSON as DeltaInputJSON, index_DeltaSignature as DeltaSignature, index_DeltaText as DeltaText, index_DeltaThinking as DeltaThinking, type index_DeltaType as DeltaType, index_EphemeralMarkerField as EphemeralMarkerField, index_ErrBlockDenied as ErrBlockDenied, index_ErrHistoryTooDeep as ErrHistoryTooDeep, index_HistoryTooDeepError as HistoryTooDeepError, type index_MinimalSanitizeConfig as MinimalSanitizeConfig, index_SizeError as SizeError, index_dropBlocks as dropBlocks, index_sanitize as sanitize, index_stripEphemeral as stripEphemeral };
+}
+
+export { dropBlocks as A, BlockCodeExecutionToolResult as B, sanitize as C, DeltaCitations as D, EphemeralMarkerField as E, stripEphemeral as F, HistoryTooDeepError as H, type MinimalSanitizeConfig as M, SizeError as S, BlockContainerUpload as a, BlockDeniedError as b, BlockDocument as c, BlockImage as d, BlockMCPToolResult as e, BlockMCPToolUse as f, type BlockPredicate as g, BlockRedactedThinking as h, index as i, BlockSearchResult as j, BlockServerToolUse as k, BlockText as l, BlockThinking as m, BlockToolReference as n, BlockToolResult as o, BlockToolUse as p, type BlockType as q, BlockVideo as r, BlockWebSearchToolResult as s, DeltaInputJSON as t, DeltaSignature as u, DeltaText as v, DeltaThinking as w, type DeltaType as x, ErrBlockDenied as y, ErrHistoryTooDeep as z };