@acosmi/sdk-ts 1.0.0

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

@@ -0,0 +1,992 @@
+/** OAuth Authorization Server 元数据 (RFC 8414) */
+interface ServerMetadata {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    revocation_endpoint: string;
+    registration_endpoint: string;
+    scopes_supported: string[];
+}
+/** OAuth token 响应 */
+interface TokenResponse {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    refresh_token?: string;
+    scope?: string;
+}
+/** 持久化 token 对 */
+interface TokenSet {
+    access_token: string;
+    refresh_token: string;
+    /** ISO 8601 格式 */
+    expires_at: string;
+    scope: string;
+    client_id: string;
+    server_url: string;
+}
+/** token 是否已过期 (提前 30 秒视为过期) */
+declare function tokenSetIsExpired(t: TokenSet): boolean;
+/** 动态注册响应 */
+interface ClientRegistration {
+    client_id: string;
+    client_secret?: string;
+}
+/** 模型能力矩阵 — 下游通过此结构决定 UI 功能开关和 Beta Header 注入 */
+interface ModelCapabilities {
+    supports_thinking: boolean;
+    supports_adaptive_thinking: boolean;
+    /** 交错思考 (Interleaved Thinking) */
+    supports_isp: boolean;
+    supports_web_search: boolean;
+    supports_tool_search: boolean;
+    supports_structured_output: boolean;
+    supports_effort: boolean;
+    /** 模型是否支持 thinking_level="max" 强度档 (深度思考) */
+    supports_max_effort: boolean;
+    /** Opus 4.6 独有 (Speed="fast") */
+    supports_fast_mode: boolean;
+    /** Auto 模式 (模型自主选择工具/搜索策略) */
+    supports_auto_mode: boolean;
+    supports_1m_context: boolean;
+    supports_prompt_cache: boolean;
+    /** 通过 context-management beta 控制 */
+    supports_cache_editing: boolean;
+    /** Claude 4 内置 */
+    supports_token_efficient: boolean;
+    supports_redact_thinking: boolean;
+    max_input_tokens: number;
+    max_output_tokens: number;
+}
+/** BucketClass 字面量常量 — V30 二轮审计 D-P1-3 修复 */
+declare const BucketClassCommercial = "COMMERCIAL";
+declare const BucketClassGeneric = "GENERIC";
+/**
+ * 用户在某 modelId 上的桶余额聚合视图 (V30 entitlement-listing).
+ *
+ * 多桶聚合规则 (上游 nexus-v4 计算后下发, 全部单位为 ETU):
+ *   - quotaEtu / usedEtu / remainingEtu: 该 modelId 下用户全部 active 桶求和
+ *   - sharedPoolEtu: 求和量中"来自通配桶"的部分 (跨模型可消耗)
+ *   - bucketClass / expiresAt: 取最高优先级桶
+ *   - expired: 全部桶都过期才置 true
+ */
+interface BucketInfo {
+    quotaEtu: number;
+    usedEtu: number;
+    remainingEtu: number;
+    sharedPoolEtu?: number;
+    expiresAt?: string;
+    bucketClass: string;
+    expired?: boolean;
+    /** v0.19+ — GENERIC alive 桶 tokenRemaining 求和 ("免费余额", 真实可消费) */
+    freeRemainingEtu: number;
+    /** v0.19+ — COMMERCIAL alive 桶 tokenRemaining 求和 ("付费余额") */
+    paidRemainingEtu: number;
+}
+/** 大小写不敏感判定 — 与 buildBucketView (managed_model.go) EqualFold 语义对齐 */
+declare function bucketInfoIsCommercial(b: BucketInfo | null | undefined): boolean;
+/** 托管模型 */
+interface ManagedModel {
+    id: string;
+    name: string;
+    provider: string;
+    modelId: string;
+    maxTokens: number;
+    isEnabled: boolean;
+    pricePerMTok?: number;
+    isDefault?: boolean;
+    contextWindow?: number;
+    capabilities: ModelCapabilities;
+    /**
+     * 上游 gateway 为此模型启用的请求格式列表
+     * 取值: "anthropic" | "openai"
+     * 空值表示上游未声明, SDK 回落 provider 硬编码分支 (向后兼容)
+     */
+    supported_formats?: string[];
+    /**
+     * 上游建议客户端优先使用的格式
+     * 取值: "anthropic" | "openai"; 空值等价于 supported_formats[0]
+     */
+    preferred_format?: string;
+    /**
+     * 当前用户在此模型上的桶余额聚合 (V0.18 V30 entitlement-listing).
+     *
+     * 仅当调用方为非 admin 用户 (web user / desktop OAuth) 时上游才会返回此字段:
+     *   - admin / X-Internal-Bypass 调用 → 缺失
+     *   - 普通用户 → 非空, 含 quota/used/remaining 求和
+     */
+    bucketInfo?: BucketInfo;
+}
+/** 单桶视图 — QuotaSummary.freeBuckets/paidBuckets 元素 */
+interface BucketRow {
+    bucketId: string;
+    /** 精确桶为具体 modelId, 通配桶为 "*" */
+    modelId: string;
+    /** COMMERCIAL | GENERIC */
+    bucketClass: string;
+    tokenQuota: number;
+    tokenUsed: number;
+    tokenRemaining: number;
+    /** 永久桶为 undefined */
+    expiresAt?: string;
+    expired?: boolean;
+}
+declare function bucketRowIsCommercial(r: BucketRow | null | undefined): boolean;
+/**
+ * GET /api/v4/entitlements/quota-summary 返回体, 调用 client.getQuotaSummary 获取.
+ *
+ * 设计目的: 个人中心钱包栏一次性展示"我还有多少免费 + 多少付费"+ 各自最近到期时间.
+ */
+interface QuotaSummary {
+    /** GENERIC (免费/赠送) alive 桶 tokenRemaining 求和 */
+    freeTotalEtu: number;
+    /** COMMERCIAL (付费购买) alive 桶 tokenRemaining 求和 */
+    paidTotalEtu: number;
+    /** GENERIC 桶详情 (含过期, UI 列流水); 空时为空数组 */
+    freeBuckets: BucketRow[];
+    /** COMMERCIAL 桶详情 (含过期); 空时为空数组 */
+    paidBuckets: BucketRow[];
+    /** GENERIC alive 桶中最早到期; 永久桶/无 alive 时缺失 */
+    nextFreeExpiresAt?: string;
+    /** COMMERCIAL alive 桶中最早到期; 同上 */
+    nextPaidExpiresAt?: string;
+}
+/** 聊天消息 (简单文本格式, CrabClaw 使用) */
+interface ChatMessage {
+    role: string;
+    content: string;
+}
+/** Anthropic 响应内容块 */
+interface ChatContentBlock {
+    type: string;
+    text?: string;
+    citations?: unknown;
+    thinking?: string;
+    signature?: string;
+    data?: string;
+    id?: string;
+    name?: string;
+    /** json.RawMessage in Go */
+    input?: unknown;
+    server_name?: string;
+    caller?: unknown;
+    tool_use_id?: string;
+    content?: unknown;
+    is_error?: boolean;
+}
+/** Anthropic 格式 token 用量 */
+interface ChatUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+/** 三档思考级别 (v0.9.0) */
+declare const ThinkingOff = "off";
+declare const ThinkingHigh = "high";
+declare const ThinkingMax = "max";
+/** 标准思考最低 maxTokens — CrabCode 默认 MAX_OUTPUT_TOKENS_DEFAULT = 32_000 */
+declare const ThinkingHighMinMaxTokens = 32000;
+/** 深度思考回退 maxTokens — Opus 4.6 上限 128K */
+declare const ThinkingMaxFallbackMaxTokens = 128000;
+/** 控制模型思考行为 */
+interface ThinkingConfig {
+    /** "enabled" | "disabled" | "adaptive" */
+    type: string;
+    /** 仅 type="enabled" 时 (旧模型回退) */
+    budget_tokens?: number;
+    /** 思考级别 (v0.9.0): "off" | "high" | "max" */
+    level?: string;
+    /** "none" | "summary" | "" (默认空=完整) */
+    display?: string;
+}
+/** 根据三档 level 创建配置 */
+declare function newThinkingConfig(level: string): ThinkingConfig;
+/** 服务端工具定义 — SDK 将工具 schema 合入 API 请求的 tools 数组 */
+interface ServerTool {
+    type: string;
+    name: string;
+    config?: Record<string, unknown>;
+}
+/** Server Tool 类型常量 */
+declare const ServerToolTypeWebSearch = "web_search_20250305";
+/** 地理位置 */
+interface GeoLoc {
+    /** ISO 3166-1 alpha-2 */
+    country: string;
+    city?: string;
+}
+/** ServerTool.config 结构 (type=web_search_20250305) */
+interface WebSearchConfig {
+    /** 每请求最大搜索次数, 默认 8 */
+    max_uses?: number;
+    /** 域名白名单 (与 blocked_domains 互斥) */
+    allowed_domains?: string[];
+    /** 域名黑名单 (与 allowed_domains 互斥) */
+    blocked_domains?: string[];
+    user_location?: GeoLoc;
+}
+/** 控制推理努力级别 */
+interface EffortConfig {
+    /** "low" | "medium" | "high" | "max" */
+    level: string;
+}
+/** 控制输出格式 (结构化输出) */
+interface OutputConfig {
+    /** "json_schema" | "" */
+    format?: string;
+    schema?: unknown;
+}
+/**
+ * 创建搜索 Server Tool 的便捷方法
+ * allowed_domains 与 blocked_domains 互斥, 同时传入抛 Error
+ */
+declare function newWebSearchTool(cfg?: WebSearchConfig | null): ServerTool;
+/**
+ * 聊天请求
+ *
+ * 基础字段供 CrabClaw 使用, 扩展字段供 CrabCode 使用。
+ * 所有新增字段零值不改变行为 (向后兼容)。
+ *
+ * 注意：扩展字段（rawMessages/system/tools/...）不会被原样 JSON.stringify,
+ * 而由 buildRequestBody (adapter) 选择性序列化到请求体。
+ */
+interface ChatRequest {
+    messages?: ChatMessage[];
+    stream?: boolean;
+    max_tokens?: number;
+    /** 复杂消息体 (含 content blocks / 多模态), 非 nil 时优先于 messages */
+    rawMessages?: unknown;
+    /** string 或 ContentBlock[] */
+    system?: unknown;
+    /** 标准工具定义 (Tool[]) */
+    tools?: unknown;
+    temperature?: number;
+    thinking?: ThinkingConfig;
+    metadata?: Record<string, string>;
+    /** 显式 beta (SDK 自动合并) */
+    betas?: string[];
+    /** 服务端工具 (buildRequestBody 合入 tools 数组) */
+    serverTools?: ServerTool[];
+    /** "" | "fast" (Fast Mode) */
+    speed?: string;
+    effort?: EffortConfig;
+    outputConfig?: OutputConfig;
+    /** 任意扩展字段 (buildRequestBody 合入请求体) */
+    extraBody?: Record<string, unknown>;
+    /**
+     * v0.13.0: OpenAI wire format 原生字段。AnthropicAdapter 忽略,
+     * OpenAIAdapter 按 OpenAI 规范序列化。
+     *
+     * 对应 OpenAI `parallel_tool_calls` 顶层字段, undefined = 不设置 (沿用上游默认 true)。
+     */
+    parallelToolCalls?: boolean;
+}
+/** 联网搜索结果来源 (与后端 adk/stream_helpers.go SourceItem 对齐) */
+interface WebSearchSource {
+    title: string;
+    url: string;
+    snippet?: string;
+}
+/** 搜索来源事件 (从 SSE "sources" 事件解析) */
+interface SourcesEvent {
+    sources: WebSearchSource[];
+    session_id?: string;
+}
+/**
+ * 从 StreamEvent 中解析搜索来源
+ * 返回 null 表示该事件不是 sources 类型
+ */
+declare function parseSourcesEvent(ev: StreamEvent): SourcesEvent | null;
+interface OpenAIChatResponse {
+    id: string;
+    /** "chat.completion" */
+    object: string;
+    model: string;
+    choices: OpenAIChatChoice[];
+    usage: OpenAIUsage;
+}
+interface OpenAIChatChoice {
+    index: number;
+    message: OpenAIChatMessage;
+    /** "stop", "tool_calls", "length" */
+    finish_reason: string;
+}
+interface OpenAIChatMessage {
+    role: string;
+    content: string;
+    tool_calls?: OpenAIToolCall[];
+    /** GLM/DeepSeek thinking */
+    reasoning_content?: string;
+}
+interface OpenAIToolCall {
+    id: string;
+    /** "function" */
+    type: string;
+    function: OpenAIFunctionCall;
+}
+interface OpenAIFunctionCall {
+    name: string;
+    arguments: string;
+}
+interface OpenAIUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/** OpenAI SSE delta 格式 */
+interface OpenAIStreamChunk {
+    id: string;
+    /** "chat.completion.chunk" */
+    object: string;
+    choices: OpenAIStreamChoice[];
+    usage?: OpenAIUsage;
+}
+interface OpenAIStreamChoice {
+    index: number;
+    delta: OpenAIStreamDelta;
+    finish_reason: string | null;
+}
+interface OpenAIStreamDelta {
+    role?: string;
+    content?: string;
+    reasoning_content?: string;
+    tool_calls?: OpenAIStreamToolCall[];
+}
+interface OpenAIStreamToolCall {
+    index: number;
+    id?: string;
+    type?: string;
+    function: OpenAIFunctionCall;
+}
+/**
+ * 同步聊天响应 (Anthropic format, v0.4.1)
+ *
+ * tokenRemaining / callRemaining / modelTokenRemaining* 不在 wire JSON 中, 由 client 从 Header 填充。
+ * 哨兵 -1 表示服务端未返回。
+ */
+interface ChatResponse {
+    id: string;
+    type: string;
+    model: string;
+    role: string;
+    content: ChatContentBlock[];
+    stop_reason: string;
+    usage: ChatUsage;
+    /** -1 表示服务端未返回 */
+    tokenRemaining: number;
+    callRemaining: number;
+    modelTokenRemaining: number;
+    modelTokenRemainingETU: number;
+}
+/**
+ * Anthropic 内容块
+ * 覆盖: text / thinking / redacted_thinking / tool_use / tool_result /
+ *       server_tool_use / mcp_tool_use / mcp_tool_result
+ */
+interface AnthropicContentBlock {
+    type: string;
+    text?: string;
+    /** tool_use / server_tool_use / mcp_tool_use block ID */
+    id?: string;
+    /** tool_use function name */
+    name?: string;
+    /** tool_use arguments (json.RawMessage) */
+    input?: unknown;
+    /** thinking block content */
+    thinking?: string;
+    /** text — web_search 搜索引用 */
+    citations?: unknown;
+    /** thinking — Anthropic 签名 (后续请求必须回传) */
+    signature?: string;
+    /** redacted_thinking — base64 编码的被审查思考内容 */
+    data?: string;
+    /** server_tool_use / mcp_tool_use / mcp_tool_result — 服务端工具来源 */
+    server_name?: string;
+    /** mcp_tool_use — MCP 调用者上下文 */
+    caller?: unknown;
+    /** tool_result / mcp_tool_result — 工具执行结果 */
+    tool_use_id?: string;
+    content?: unknown;
+    is_error?: boolean;
+}
+/** Anthropic token 用量 */
+interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+/**
+ * Anthropic 原生格式同步响应
+ * POST /managed-models/:id/anthropic 返回此格式 (无 response.Success 包装)
+ */
+interface AnthropicResponse {
+    id: string;
+    /** "message" */
+    type: string;
+    /** "assistant" */
+    role: string;
+    content: AnthropicContentBlock[];
+    model: string;
+    stop_reason: string;
+    stop_sequence?: string | null;
+    usage: AnthropicUsage;
+}
+/** 提取所有 text 类型内容块的文本，拼接返回 */
+declare function anthropicResponseTextContent(r: AnthropicResponse): string;
+/** 提取所有 thinking 类型内容块的文本，拼接返回 */
+declare function anthropicResponseThinkingContent(r: AnthropicResponse): string;
+/** 返回所有 tool_use 类型的内容块 */
+declare function anthropicResponseToolUseBlocks(r: AnthropicResponse): AnthropicContentBlock[];
+/**
+ * SSE 流式事件
+ *
+ * v0.11.0 新增 blockIndex/blockType/ephemeral 三字段 (in-band content block 元数据)。
+ * 零值等价 v0.10.0 行为, 未识别的事件三字段全部零值。
+ */
+interface StreamEvent {
+    event: string;
+    data: string;
+    /** 对齐 Anthropic content_block_start/delta/stop 的 index 字段 */
+    blockIndex?: number;
+    /** 由 content_block_start 解析得到, delta/stop 从 index→type 映射查出 */
+    blockType?: string;
+    /** 网关标记此 block 下一轮不应回传 */
+    ephemeral?: boolean;
+}
+/**
+ * 流式结算事件 (从 settled SSE 事件解析)
+ * 包含本次请求的 token 消耗及结算后的剩余余额
+ */
+interface StreamSettlement {
+    requestId: string;
+    consumeStatus: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    /** 结算后剩余 token (-1 表示服务端未返回) */
+    tokenRemaining: number;
+    /** 结算后剩余调用次数 (-1 表示服务端未返回) */
+    callRemaining: number;
+}
+/** 从 settled 类型的 StreamEvent 中解析结算信息. 不是 settled 类型则返回 null. */
+declare function parseSettlement(ev: StreamEvent): StreamSettlement | null;
+/** 权益余额 (聚合) */
+interface EntitlementBalance {
+    totalTokenQuota: number;
+    totalTokenUsed: number;
+    totalTokenRemaining: number;
+    totalCallQuota: number;
+    totalCallUsed: number;
+    totalCallRemaining: number;
+    activeEntitlements: number;
+}
+/** 单条权益明细 */
+interface EntitlementItem {
+    id: string;
+    type: string;
+    status: string;
+    tokenQuota: number;
+    tokenUsed: number;
+    tokenRemaining: number;
+    callQuota: number;
+    callUsed: number;
+    callRemaining: number;
+    expiresAt?: string;
+    sourceId?: string;
+    sourceType?: string;
+    remark?: string;
+    createdAt: string;
+}
+/** 详细余额 (含每条权益明细) */
+interface BalanceDetail {
+    totalTokenQuota: number;
+    totalTokenUsed: number;
+    totalTokenRemaining: number;
+    totalCallQuota: number;
+    totalCallUsed: number;
+    totalCallRemaining: number;
+    activeEntitlements: number;
+    entitlements: EntitlementItem[];
+}
+/** 核销记录 */
+interface ConsumeRecord {
+    id: string;
+    entitlementId: string;
+    requestId: string;
+    modelId?: string;
+    tokensConsumed: number;
+    status: string;
+    createdAt: string;
+}
+/** 核销记录分页响应 */
+interface ConsumeRecordPage {
+    records: ConsumeRecord[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/**
+ * 单桶视图 (用户多桶 hero / 模型切换提示用)
+ *
+ * 字段名仍叫 ETU 但 T3 死代码清除后 = raw token (V29 系数管理已退役)。
+ */
+interface ModelBucket {
+    bucketId: string;
+    entitlementId: string;
+    /** "*" = 通配 */
+    modelId: string;
+    /** COMMERCIAL / GENERIC */
+    bucketClass: string;
+    tokenQuota: number;
+    tokenUsed: number;
+    tokenRemaining: number;
+    callQuota: number;
+    callUsed: number;
+    callRemaining: number;
+    allowedModelsJson?: string;
+}
+/** GetByModel 响应; primaryBucket 在 bucketId 为空时表示无可用桶。 */
+interface ModelByQuotaResponse {
+    modelId: string;
+    /** 折算后剩余 (调度判定用) */
+    etuRemaining: number;
+    /** 反系数估算的原始 token (UI 展示用) */
+    rawTokenRemaining: number;
+    hasQuota: boolean;
+    primaryBucket?: ModelBucket;
+}
+/** 单条模型系数 (SDK TTL 8s 缓存源) */
+interface ModelCoefficient {
+    modelId: string;
+    tenantId: string;
+    inputCoef: number;
+    outputCoef: number;
+    cacheReadCoef: number;
+    cacheCreationCoef: number;
+    version: number;
+    effectiveAt: string;
+}
+/** 流量包商品。price 用 string (Go json.Number) 避免浮点精度丢失。 */
+interface TokenPackage {
+    id: string;
+    name: string;
+    description?: string;
+    tokenQuota: number;
+    callQuota?: number;
+    price: string;
+    validDays: number;
+    isEnabled: boolean;
+    sortOrder?: number;
+}
+/** 订单。amount 用 string (Go json.Number) 避免精度丢失。 */
+interface Order {
+    id: string;
+    packageId: string;
+    packageName?: string;
+    amount: string;
+    status: string;
+    payUrl?: string;
+    createdAt: string;
+}
+/** 订单状态 */
+interface OrderStatus {
+    orderId: string;
+    status: string;
+}
+/** 下单请求 */
+interface PayPayload {
+    payMethod?: string;
+}
+/** 钱包统计。金额使用 string (Go json.Number) 避免浮点精度丢失 (金融安全) */
+interface WalletStats {
+    balance: string;
+    monthlyConsumption: string;
+    monthlyRecharge: string;
+    transactionCount: number;
+}
+/** 交易记录 */
+interface Transaction {
+    id: string;
+    type: string;
+    amount: string;
+    remark?: string;
+    createdAt: string;
+}
+interface SkillStoreItem {
+    id: string;
+    pluginId: string;
+    key: string;
+    name: string;
+    description: string;
+    icon: string;
+    category: string;
+    inputSchema: string;
+    outputSchema: string;
+    timeout: number;
+    retryCount: number;
+    retryDelay: number;
+    version: string;
+    totalCalls: number;
+    avgDurationMs: number;
+    successRate: number;
+    isEnabled: boolean;
+    securityLevel: string;
+    securityScore: number;
+    scope: string;
+    status: string;
+    downloadCount: number;
+    readme: string;
+    tags: string[];
+    author: string;
+    publisherId: string;
+    isPublished: boolean;
+    pluginName: string;
+    pluginIcon: string;
+    updatedAt: string;
+    visibility?: string;
+    certificationStatus?: string;
+    source?: string;
+}
+/** 技能商店搜索参数 (非 wire 类型, 用于 client 方法参数) */
+interface SkillStoreQuery {
+    category?: string;
+    keyword?: string;
+    tag?: string;
+}
+/** 技能统计概览 */
+interface SkillSummary {
+    installed: number;
+    created: number;
+    total: number;
+    storeAvailable: number;
+}
+/** 技能商店分页浏览响应 */
+interface SkillBrowseResponse {
+    items: SkillStoreItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/**
+ * 技能商店列表项（轻量，仅含浏览所需字段）
+ * 配合服务端 fields=minimal 参数使用，响应体积缩减 90%+
+ */
+interface SkillStoreListItem {
+    id: string;
+    key: string;
+    name: string;
+    description: string;
+    icon: string;
+    category: string;
+    version: string;
+    author: string;
+    downloadCount: number;
+    tags: string[];
+    certificationStatus?: string;
+    visibility?: string;
+    source?: string;
+    updatedAt: string;
+}
+/** 技能商店轻量浏览响应 */
+interface SkillBrowseListResponse {
+    items: SkillStoreListItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/** 技能认证状态响应 */
+interface CertificationStatus {
+    skillId: string;
+    certificationStatus: string;
+    certifiedAt?: number;
+    securityLevel?: string;
+    securityScore: number;
+    report?: unknown;
+}
+interface GenerateSkillRequest {
+    purpose: string;
+    examples?: string[];
+    inputHints?: string;
+    outputHints?: string;
+    category?: string;
+    language?: string;
+}
+interface GenerateSkillResult {
+    skillName: string;
+    skillKey: string;
+    description: string;
+    skillMd: string;
+    inputSchema: string;
+    outputSchema: string;
+    testCases: string[];
+    readme: string;
+    category: string;
+    tags: string[];
+    timeout: number;
+}
+interface OptimizeSkillRequest {
+    skillName: string;
+    description?: string;
+    inputSchema?: string;
+    outputSchema?: string;
+    readme?: string;
+    aspects?: string[];
+}
+interface OptimizeSkillResult {
+    optimizedSkill: GenerateSkillResult;
+    changes: string[];
+    score: number;
+}
+interface ToolView {
+    id: string;
+    key: string;
+    name: string;
+    description: string;
+    icon: string;
+    category: string;
+    inputSchema: string;
+    outputSchema: string;
+    timeout: number;
+    isEnabled: boolean;
+    provider?: ToolProvider;
+}
+interface ToolProvider {
+    id: string;
+    name: string;
+    icon: string;
+    sourceType: string;
+    mcpEndpoint?: string;
+    isEnabled: boolean;
+}
+interface ToolListResponse {
+    skills: ToolView[];
+    total: number;
+}
+/** 下载限流错误 (429) */
+declare class RateLimitError extends Error {
+    retryAfter: string;
+    raw: string;
+    constructor(message: string, retryAfter: string, raw: string);
+}
+/**
+ * API 业务层错误 (HTTP 200 但 code != 0)
+ * tk-dist 代理透传 yudao 响应, HTTP 状态码为 200, 业务错误在 JSON code 字段
+ */
+declare class BusinessError extends Error {
+    code: number;
+    constructor(code: number, message: string);
+}
+/**
+ * 订单到达非成功终态 (FAILED/CANCELLED/CLOSED/EXPIRED/REFUNDED)
+ * waitForPayment 在订单终态为非成功时抛此错误
+ */
+declare class OrderTerminalError extends Error {
+    orderId: string;
+    status: string;
+    constructor(orderId: string, status: string);
+}
+/**
+ * 模型缓存未命中且 listModels 刷新后仍未找到。
+ *
+ * 历史上 getCachedModel miss 时硬返 ManagedModel{provider:"anthropic"} 占位,
+ * 导致未预热场景下的 chat 请求按 AnthropicAdapter 编码, 被发到错误端点。
+ * v0.13.x 改为 miss → listModels 自动刷新一次; 仍 miss → 抛此错误。
+ */
+declare class ModelNotFoundError extends Error {
+    modelId: string;
+    constructor(modelId: string);
+}
+/**
+ * 结构化 HTTP 非 2xx 错误.
+ *
+ * 用 instanceof 提取:
+ *   try { ... } catch (e) {
+ *     if (e instanceof HTTPError && e.statusCode === 429) { ... }
+ *   }
+ */
+declare class HTTPError extends Error {
+    statusCode: number;
+    /** anthropic.error.type / openai.error.type, 缺失为空 */
+    type: string;
+    /** Retry-After 头解析的秒数, 0 表示未提供或解析失败 */
+    retryAfter: number;
+    /** 原始响应体 (截断到 maxErrorBodySize) */
+    body: string;
+    constructor(statusCode: number, opts?: {
+        type?: string;
+        message?: string;
+        retryAfter?: number;
+        body?: string;
+    });
+}
+/**
+ * 结构化网络层错误 (传输失败, 区别于上游业务错误).
+ *
+ * 包装 fetch 抛出的错误 — 含 timeout / EOF / connection refused / DNS 失败等.
+ * retry policy: isTimeout / isEOF 任一为 true → 默认可重试.
+ */
+declare class NetworkError extends Error {
+    /** 操作描述, e.g. "POST /v1/messages" */
+    op: string;
+    /** 请求 URL (脱敏后) */
+    url: string;
+    cause?: unknown;
+    timeout: boolean;
+    eof: boolean;
+    constructor(op: string, url: string, cause: unknown, opts?: {
+        timeout?: boolean;
+        eof?: boolean;
+    });
+    isTimeout(): boolean;
+    isEOF(): boolean;
+}
+/**
+ * 流式失败事件的结构化表示。
+ *
+ * 由 gateway 的 `managed_model_stream_failed` 事件解析得到。客户端可通过
+ * instanceof 提取并按 code/retryable 决策。
+ */
+declare class StreamError extends Error {
+    /** 例: "empty_response" / "rate_limit" / "overloaded" / "" */
+    code: string;
+    /** 例: "provider" / "settlement" */
+    stage: string;
+    /** 用户友好提示 (中文); 历史字段, 与 rawError 区分 */
+    userMessage: string;
+    /** gateway 原始 error 字符串 */
+    rawError: string;
+    /** 客户端是否值得重试 */
+    retryable: boolean;
+    constructor(opts?: {
+        code?: string;
+        stage?: string;
+        message?: string;
+        rawError?: string;
+        retryable?: boolean;
+    });
+}
+/** nexus-v4 标准响应。兼容 yudao 格式 (msg) 和 nexus-v4 格式 (message) */
+interface APIResponse<T> {
+    code: number;
+    message?: string;
+    msg?: string;
+    data: T;
+}
+/** 优先返回 message, 降级到 msg (兼容 yudao 透传) */
+declare function apiResponseGetMessage<T>(r: APIResponse<T>): string;
+/** 检查业务层错误码 — code != 0 时抛 BusinessError */
+declare function apiResponseBusinessError<T>(r: APIResponse<T>): BusinessError | null;
+/** yudao 分页响应格式 (tk-dist 代理透传) */
+interface YudaoPageResult<T> {
+    list: T[];
+    total: number;
+}
+/** 单条通知 */
+interface Notification {
+    id: string;
+    title: string;
+    content: string;
+    /** system | billing | security | task | commission | entitlement */
+    type: string;
+    isRead: boolean;
+    createdAt: string;
+}
+/** 分页通知列表 */
+interface NotificationList {
+    list: Notification[];
+    unreadCount: number;
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/** 未读通知计数 */
+interface NotificationUnreadCount {
+    unreadCount: number;
+}
+/** 通知偏好 (按类型+渠道) */
+interface NotificationPreference {
+    typeCode: string;
+    channelInApp: boolean;
+    channelEmail: boolean;
+    channelSms: boolean;
+    channelPush: boolean;
+}
+/** 推送设备注册 */
+interface DeviceRegistration {
+    /** android | ios | harmony */
+    platform: string;
+    token: string;
+    appVersion: string;
+}
+/** 服务端推送事件 */
+interface WSEvent {
+    type: string;
+    topic?: string;
+    /** json.RawMessage in Go */
+    data?: unknown;
+    connId?: string;
+    timestamp?: string;
+    message?: string;
+}
+/**
+ * 从 WSEvent 中解析通知
+ * 返回 null 表示该事件不是系统通知
+ */
+declare function parseNotificationEvent(ev: WSEvent): Notification | null;
+
+/** 标识请求格式 */
+declare enum ProviderFormat {
+    /** Anthropic 原生格式 */
+    Anthropic = 0,
+    /** OpenAI 兼容格式 */
+    OpenAI = 1
+}
+/** 将 ChatRequest 转换为特定格式的 adapter 接口 */
+interface ProviderAdapter {
+    /** 此 adapter 使用的请求格式 */
+    format(): ProviderFormat;
+    /**
+     * API 路径后缀
+     * Anthropic: "/anthropic", OpenAI: "/chat"
+     */
+    endpointSuffix(): string;
+    /**
+     * 将 ChatRequest 转换为 HTTP body (object → JSON.stringify)
+     * caps 用于条件化字段注入 (如 betas)
+     */
+    buildRequestBody(caps: ModelCapabilities, req: ChatRequest): Record<string, unknown>;
+    /** 解析同步响应 body 为 ChatResponse */
+    parseResponse(body: Uint8Array | string): ChatResponse;
+    /**
+     * 解析一行 SSE data 为 StreamEvent
+     * 返回 { event, done }; done=true 表示流结束 ([DONE] 或 message_stop)
+     */
+    parseStreamLine(eventType: string, data: string): {
+        event: StreamEvent;
+        done: boolean;
+    };
+}
+
+/**
+ * 根据 provider 返回对应的 adapter (v0.5.0 遗留 API, 向后兼容)
+ * 新代码应使用 getAdapterForModel
+ */
+declare function getAdapter(provider: string): ProviderAdapter;
+/**
+ * 按 ManagedModel 的 preferred_format / supported_formats 选择 adapter
+ *
+ * 决策顺序:
+ *  1. preferred_format 非空 → 按其值返回 (anthropic | openai)
+ *  2. supported_formats 含 "anthropic" → AnthropicAdapter
+ *  3. supported_formats 含 "openai" → OpenAIAdapter
+ *  4. 两字段均空 (旧上游) → 回落 provider 名硬编码 (原 getAdapter 行为)
+ *
+ * 这使得 dashscope / zhipu / deepseek 等 provider 的模型如果上游启用了
+ * Anthropic 兼容端点, 也能走 /anthropic 路径, 不再被 provider 字符串硬编码到 /chat
+ * 导致 tool_reference 400.
+ */
+declare function getAdapterForModel(m: ManagedModel): ProviderAdapter;
+
+export { type ConsumeRecord as $, type AnthropicResponse as A, type BalanceDetail as B, type ClientRegistration as C, type DeviceRegistration as D, type EntitlementBalance as E, type NotificationPreference as F, type GenerateSkillRequest as G, type WSEvent as H, type APIResponse as I, type AnthropicContentBlock as J, type AnthropicUsage as K, BucketClassCommercial as L, type ModelCapabilities as M, type NotificationList as N, type Order as O, type ProviderAdapter as P, type QuotaSummary as Q, BucketClassGeneric as R, type ServerMetadata as S, type TokenResponse as T, type BucketInfo as U, type BucketRow as V, type WalletStats as W, BusinessError as X, type ChatContentBlock as Y, type ChatMessage as Z, type ChatUsage as _, type TokenSet as a, type EffortConfig as a0, type GeoLoc as a1, HTTPError as a2, ModelNotFoundError as a3, NetworkError as a4, type Notification as a5, type NotificationUnreadCount as a6, type OpenAIChatChoice as a7, type OpenAIChatMessage as a8, type OpenAIChatResponse as a9, anthropicResponseTextContent as aA, anthropicResponseThinkingContent as aB, anthropicResponseToolUseBlocks as aC, apiResponseBusinessError as aD, apiResponseGetMessage as aE, bucketInfoIsCommercial as aF, bucketRowIsCommercial as aG, getAdapter as aH, getAdapterForModel as aI, newThinkingConfig as aJ, newWebSearchTool as aK, parseNotificationEvent as aL, parseSettlement as aM, parseSourcesEvent as aN, tokenSetIsExpired as aO, type OpenAIFunctionCall as aa, type OpenAIStreamChoice as ab, type OpenAIStreamChunk as ac, type OpenAIStreamDelta as ad, type OpenAIStreamToolCall as ae, type OpenAIToolCall as af, type OpenAIUsage as ag, OrderTerminalError as ah, type OutputConfig as ai, ProviderFormat as aj, RateLimitError as ak, type ServerTool as al, ServerToolTypeWebSearch as am, type SkillStoreListItem as an, StreamError as ao, type ThinkingConfig as ap, ThinkingHigh as aq, ThinkingHighMinMaxTokens as ar, ThinkingMax as as, ThinkingMaxFallbackMaxTokens as at, ThinkingOff as au, type ToolListResponse as av, type ToolProvider as aw, type WebSearchConfig as ax, type WebSearchSource as ay, type YudaoPageResult as az, type ChatRequest as b, type ManagedModel as c, type ModelCoefficient as d, type ChatResponse as e, type StreamEvent as f, type SourcesEvent as g, type StreamSettlement as h, type EntitlementItem as i, type ConsumeRecordPage as j, type ModelByQuotaResponse as k, type ModelBucket as l, type TokenPackage as m, type PayPayload as n, type OrderStatus as o, type Transaction as p, type SkillStoreQuery as q, type SkillStoreItem as r, type SkillBrowseResponse as s, type SkillBrowseListResponse as t, type SkillSummary as u, type CertificationStatus as v, type GenerateSkillResult as w, type OptimizeSkillRequest as x, type OptimizeSkillResult as y, type ToolView as z };