@acosmi/sdk-ts 1.0.2 → 1.2.0

package/dist/node/index.d.cts

@@ -1,10 +1,53 @@
-import { S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, M as ModelCapabilities, b as ChatRequest, c as ManagedModel, d as ModelCoefficient, Q as QuotaSummary, P as ProviderAdapter, e as ChatResponse, A as AnthropicResponse, f as StreamEvent, g as SourcesEvent, h as StreamSettlement, E as EntitlementBalance, B as BalanceDetail, i as EntitlementItem, j as ConsumeRecordPage, k as ModelByQuotaResponse, l as ModelBucket, m as TokenPackage, n as PayPayload, O as Order, o as OrderStatus, W as WalletStats, p as Transaction, q as SkillStoreQuery, r as SkillStoreItem, s as SkillBrowseResponse, t as SkillBrowseListResponse, u as SkillSummary, v as CertificationStatus, G as GenerateSkillRequest, w as GenerateSkillResult, x as OptimizeSkillRequest, y as OptimizeSkillResult, z as ToolView, N as NotificationList, D as DeviceRegistration, F as NotificationPreference, H as WSEvent } from './index-C3Z_84Bv.cjs';
-export { I as APIResponse, J as AnthropicContentBlock, K as AnthropicUsage, L as BucketClassCommercial, R as BucketClassGeneric, U as BucketInfo, V as BucketRow, X as BusinessError, Y as ChatContentBlock, Z as ChatMessage, _ as ChatUsage, $ as ConsumeRecord, a0 as EffortConfig, a1 as GeoLoc, a2 as HTTPError, a3 as ModelNotFoundError, a4 as NetworkError, a5 as Notification, a6 as NotificationUnreadCount, a7 as OpenAIChatChoice, a8 as OpenAIChatMessage, a9 as OpenAIChatResponse, aa as OpenAIFunctionCall, ab as OpenAIStreamChoice, ac as OpenAIStreamChunk, ad as OpenAIStreamDelta, ae as OpenAIStreamToolCall, af as OpenAIToolCall, ag as OpenAIUsage, ah as OrderTerminalError, ai as OutputConfig, aj as ProviderFormat, ak as RateLimitError, al as ServerTool, am as ServerToolTypeWebSearch, an as SkillStoreListItem, ao as StreamError, ap as ThinkingConfig, aq as ThinkingHigh, ar as ThinkingHighMinMaxTokens, as as ThinkingMax, at as ThinkingMaxFallbackMaxTokens, au as ThinkingOff, av as ToolListResponse, aw as ToolProvider, ax as WebSearchConfig, ay as WebSearchSource, az as YudaoPageResult, aA as anthropicResponseTextContent, aB as anthropicResponseThinkingContent, aC as anthropicResponseToolUseBlocks, aD as apiResponseBusinessError, aE as apiResponseGetMessage, aF as bucketInfoIsCommercial, aG as bucketRowIsCommercial, aH as getAdapter, aI as getAdapterForModel, aJ as newThinkingConfig, aK as newWebSearchTool, aL as parseNotificationEvent, aM as parseSettlement, aN as parseSourcesEvent, aO as tokenSetIsExpired } from './index-C3Z_84Bv.cjs';
+import { M as ManagedModel, I as InputModality, S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, b as ModelCoefficient, Q as QuotaSummary, c as ModelCapabilities, d as ChatRequest, P as ProviderAdapter, e as ChatResponse, A as AnthropicResponse, f as StreamEvent, g as SourcesEvent, h as StreamSettlement, E as EntitlementBalance, B as BalanceDetail, i as EntitlementItem, j as ConsumeRecordPage, k as ModelByQuotaResponse, l as ModelBucket, m as TokenPackage, n as PayPayload, O as Order, o as OrderStatus, W as WalletStats, p as Transaction, q as SkillStoreQuery, r as SkillStoreItem, s as SkillBrowseResponse, t as SkillBrowseListResponse, u as SkillSummary, v as CertificationStatus, G as GenerateSkillRequest, w as GenerateSkillResult, x as OptimizeSkillRequest, y as OptimizeSkillResult, z as ToolView, N as NotificationList, D as DeviceRegistration, F as NotificationPreference, H as WSEvent } from './index-B2Uuh21R.cjs';
+export { J as APIResponse, K as AnthropicContentBlock, L as AnthropicUsage, R as BucketClassCommercial, U as BucketClassGeneric, V as BucketInfo, X as BucketRow, Y as BusinessError, Z as ChatContentBlock, _ as ChatMessage, $ as ChatUsage, a0 as ConsumeRecord, a1 as EffortConfig, a2 as GeoLoc, a3 as HTTPError, a4 as ModelNotFoundError, a5 as NetworkError, a6 as Notification, a7 as NotificationUnreadCount, a8 as OpenAIChatChoice, a9 as OpenAIChatMessage, aa as OpenAIChatResponse, ab as OpenAIFunctionCall, ac as OpenAIStreamChoice, ad as OpenAIStreamChunk, ae as OpenAIStreamDelta, af as OpenAIStreamToolCall, ag as OpenAIToolCall, ah as OpenAIUsage, ai as OrderTerminalError, aj as OutputConfig, ak as ProviderFormat, al as RateLimitError, am as ServerTool, an as ServerToolTypeWebSearch, ao as SkillStoreListItem, ap as StreamError, aq as ThinkingConfig, ar as ThinkingHigh, as as ThinkingHighMinMaxTokens, at as ThinkingMax, au as ThinkingMaxFallbackMaxTokens, av as ThinkingOff, aw as ToolListResponse, ax as ToolProvider, ay as WebSearchConfig, az as WebSearchSource, aA as YudaoPageResult, aB as anthropicResponseTextContent, aC as anthropicResponseThinkingContent, aD as anthropicResponseToolUseBlocks, aE as apiResponseBusinessError, aF as apiResponseGetMessage, aG as bucketInfoIsCommercial, aH as bucketRowIsCommercial, aI as getAdapter, aJ as getAdapterForModel, aK as newThinkingConfig, aL as newWebSearchTool, aM as parseNotificationEvent, aN as parseSettlement, aO as parseSourcesEvent, aP as tokenSetIsExpired } from './index-B2Uuh21R.cjs';
 import { M as MinimalSanitizeConfig } from './index-nvLKgCm9.cjs';
 export { i as sanitize } from './index-nvLKgCm9.cjs';
 export { AnthropicAdapter } from './adapters/anthropic.cjs';
 export { OpenAIAdapter } from './adapters/openai.cjs';
 
+/**
+ * 判断 ManagedModel 是否声明支持指定输入模态.
+ *
+ * 语义:
+ *   - model 为 null/undefined → false
+ *   - model.inputModalities 缺失或非数组 → false (保守, 未声明不当支持)
+ *   - 大小写敏感 (上游契约即小写 'text' | 'image')
+ */
+declare function modelSupportsInputModality(model: ManagedModel | null | undefined, modality: InputModality): boolean;
+/** 等价 modelSupportsInputModality(model, 'image') — 调用方常见快捷判定. */
+declare function modelSupportsImageInput(model: ManagedModel | null | undefined): boolean;
+/**
+ * 在 catalog 中按 catalog 顺序查找首个支持指定模态的模型.
+ *
+ * 选择规则:
+ *   1. isEnabled !== false (默认开, 显式 false 才剔除)
+ *   2. inputModalities 包含指定模态
+ *   3. 命中后按 catalog 顺序返回第一个; 未命中返 null
+ *
+ * 注意: 该 helper 不读 isDefault, 调用方需要 "默认优先" 请用
+ * findDesktopVisualUnderstandingModel 或自行排序.
+ */
+declare function findFirstModelByInputModality(models: ManagedModel[], modality: InputModality): ManagedModel | null;
+/**
+ * 在 catalog 中选出最适合做 "桌面视觉理解 sidecar" 的模型.
+ *
+ * 设计目的: CrabCode desktop automation 链路里, 主模型不一定多模态;
+ * 截图先送 sidecar 解析成结构化 UI 描述, 再喂主模型. 这里选 sidecar 模型
+ * 严格走运营标注的 supports_desktop_visual_understanding capability, 不靠
+ * 模型名猜.
+ *
+ * 选择规则 (按用户指定顺序):
+ *   1. isEnabled !== false
+ *   2. capabilities.supports_desktop_visual_understanding === true
+ *   3. inputModalities 包含 'image' (必须真能吃图)
+ *   4. 命中集合中优先 isDefault === true; 否则返回 catalog 顺序第一个
+ *
+ * 全部不满足返 null. 调用方收到 null 应:
+ *   - 提示用户在管理后台/网关侧开启桌面视觉 sidecar 模型, 或
+ *   - 降级停掉依赖截图的工作流, 而不是硬选一个非视觉模型送图.
+ */
+declare function findDesktopVisualUnderstandingModel(models: ManagedModel[]): ManagedModel | null;
+
 /**
  * 从 well-known 端点获取 Desktop OAuth 服务元数据。
  *
@@ -297,10 +340,182 @@ interface BlockMeta {
  */
 declare function extractAnthropicBlockMeta(eventType: string, data: string, blockTypeMap: Map<number, BlockMeta>): [number, string, boolean];
 
-/** 根据模型能力和请求参数自动组装 beta header 列表 */
-declare function buildBetas(caps: ModelCapabilities, req: ChatRequest): string[];
-/** 合并两个字符串数组并去重, 保留顺序 */
-declare function uniqueMerge(base: string[], extra: string[]): string[];
+type AgentRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+interface AgentRunLocalContextPolicy {
+    enabled?: boolean;
+    readonly?: boolean;
+    maxBytes?: number;
+    allowedTools?: string[];
+}
+interface AgentRunArtifactPolicy {
+    enabled?: boolean;
+    maxFiles?: number;
+}
+interface AgentRunCreateRequest {
+    appId: string;
+    mode?: string;
+    sessionId?: string;
+    input: string;
+    messages?: unknown[];
+    model?: string;
+    activeSkillIds?: string[];
+    knowledgeBaseIds?: string[];
+    metadata?: Record<string, string>;
+    localContextPolicy?: AgentRunLocalContextPolicy;
+    artifactPolicy?: AgentRunArtifactPolicy;
+}
+interface AgentRun {
+    runId: string;
+    sessionId: string;
+    appId?: string;
+    mode?: string;
+    status: AgentRunStatus;
+    createdAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    error?: AgentRunErrorPayload;
+    metadata?: Record<string, string>;
+}
+interface AgentRunCreateResponse {
+    runId: string;
+    sessionId: string;
+    status: AgentRunStatus;
+}
+interface AgentRunArtifact {
+    id: string;
+    filename: string;
+    contentType?: string;
+    size?: number;
+    type?: string;
+    metadata?: Record<string, string>;
+}
+interface AgentRunArtifactList {
+    artifacts: AgentRunArtifact[];
+}
+interface AgentRunDownload {
+    data: Uint8Array;
+    filename: string;
+    contentType?: string;
+}
+interface AgentRunUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreateTokens?: number;
+    exact?: boolean;
+    source?: string;
+    [key: string]: unknown;
+}
+interface AgentRunSettlement {
+    requestId?: string;
+    status?: string;
+    consumeStatus?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreateTokens?: number;
+    tokenRemaining?: number;
+    callRemaining?: number;
+    retryQueued?: boolean;
+    exact?: boolean;
+    [key: string]: unknown;
+}
+interface AgentRunErrorPayload {
+    code?: string;
+    message: string;
+    stage?: string;
+    retryable?: boolean;
+    raw?: unknown;
+}
+interface AgentRunLocalToolResult {
+    requestId: string;
+    ok: boolean;
+    content?: unknown;
+    error?: string;
+}
+interface AgentRunLocalToolHandlerContext {
+    runId: string;
+    requestId: string;
+    name: string;
+    signal: AbortSignal;
+}
+type AgentRunLocalToolHandler = (input: unknown, context: AgentRunLocalToolHandlerContext) => Promise<unknown> | unknown;
+interface AgentRunStreamOptions {
+    /**
+     * true by default. When enabled, an error event is converted into
+     * AgentRunStreamError after the event has been parsed.
+     */
+    throwOnError?: boolean;
+}
+interface AgentRunRunOptions extends AgentRunStreamOptions {
+}
+interface AgentRunWithLocalToolsOptions extends AgentRunRunOptions {
+    timeoutMs?: number;
+    onEvent?: (event: AgentRunStreamEvent) => void | Promise<void>;
+}
+type AgentRunStreamEvent = {
+    type: 'run_started';
+    runId: string;
+    sessionId: string;
+} | {
+    type: 'status';
+    status: AgentRunStatus | string;
+    message?: string;
+} | {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'reasoning_delta';
+    text: string;
+} | {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    input?: unknown;
+} | {
+    type: 'tool_result';
+    id: string;
+    name?: string;
+    result?: unknown;
+    error?: string;
+} | {
+    type: 'local_tool_request';
+    requestId: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'artifact';
+    artifact: AgentRunArtifact;
+} | {
+    type: 'sources';
+    sources: unknown;
+} | {
+    type: 'usage';
+    usage: AgentRunUsage;
+} | {
+    type: 'settle';
+    settlement: AgentRunSettlement;
+} | {
+    type: 'error';
+    error: AgentRunErrorPayload;
+} | {
+    type: 'done';
+    runId: string;
+    status: AgentRunStatus | string;
+};
+declare class AgentRunStreamError extends Error {
+    event: Extract<AgentRunStreamEvent, {
+        type: 'error';
+    }>;
+    code: string;
+    stage: string;
+    retryable: boolean;
+    constructor(event: Extract<AgentRunStreamEvent, {
+        type: 'error';
+    }>);
+}
 
 type FilterStatus = 'ok' | 'admin-bypass' | 'internal-bypass' | 'disabled-by-flag' | 'fallback-tkdist-error' | 'fallback-tkdist-deployment-skew' | 'fallback-no-buckets' | 'fallback-missing-userid' | '';
 declare const FilterStatusOK: FilterStatus;
@@ -590,6 +805,37 @@ declare class Client {
     }, signal?: AbortSignal): Promise<Response>;
 }
 
+declare module '@acosmi/sdk-ts' {
+    interface Client {
+        /** SDK-facing cloud agent run gateway. */
+        readonly agentRuns: AgentRunsClient;
+    }
+}
+declare class AgentRunsClient {
+    private readonly client;
+    constructor(client: Client);
+    create(req: AgentRunCreateRequest, signal?: AbortSignal): Promise<AgentRunCreateResponse>;
+    get(runId: string, signal?: AbortSignal): Promise<AgentRun>;
+    stream(runId: string, opts?: AgentRunStreamOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    cancel(runId: string, signal?: AbortSignal): Promise<AgentRun>;
+    listArtifacts(runId: string, signal?: AbortSignal): Promise<AgentRunArtifact[]>;
+    downloadArtifact(runId: string, artifactId: string, signal?: AbortSignal): Promise<AgentRunDownload>;
+    submitLocalToolResult(runId: string, result: AgentRunLocalToolResult, signal?: AbortSignal): Promise<AgentRun>;
+    run(req: AgentRunCreateRequest, opts?: AgentRunRunOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    runWithLocalTools(req: AgentRunCreateRequest, handlers: Record<string, AgentRunLocalToolHandler>, opts?: AgentRunWithLocalToolsOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    private runGen;
+    private runWithLocalToolsGen;
+    private invokeLocalTool;
+    private streamGen;
+    private requestAPI;
+    private requestRaw;
+}
+
+/** 根据模型能力和请求参数自动组装 beta header 列表 */
+declare function buildBetas(caps: ModelCapabilities, req: ChatRequest): string[];
+/** 合并两个字符串数组并去重, 保留顺序 */
+declare function uniqueMerge(base: string[], extra: string[]): string[];
+
 declare module '@acosmi/sdk-ts' {
     interface Client {
         /** 查询当前用户的权益余额 (聚合) */
@@ -833,4 +1079,4 @@ declare module '@acosmi/sdk-ts' {
     }
 }
 
-export { AnthropicResponse, type AuthorizeResult, BalanceDetail, type BlockMeta, type BugReportResult, type BugView, CertificationStatus, ChatRequest, ChatResponse, Client, ClientRegistration, type Config, ConsumeRecordPage, DefaultRetryPolicy, DeviceRegistration, EntitlementBalance, EntitlementItem, ErrAuthDenied, ErrBrowserOpen, ErrDiscovery, ErrRegistration, ErrSSLProxy, ErrTimeout, ErrTokenExchange, EventAuthURL, EventComplete, EventError, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, GenerateSkillRequest, GenerateSkillResult, InMemoryTokenStore, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, ModelBucket, ModelByQuotaResponse, ModelCapabilities, ModelCoefficient, NotificationList, NotificationPreference, OptimizeSkillRequest, OptimizeSkillResult, Order, OrderStatus, PayPayload, ProviderAdapter, QuotaSummary, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, ServerMetadata, SkillBrowseListResponse, SkillBrowseResponse, SkillStoreItem, SkillStoreQuery, SkillSummary, SourcesEvent, StreamEvent, StreamSettlement, TokenPackage, TokenResponse, TokenSet, type TokenStore, ToolView, Transaction, type WSConfig, WSEvent, WalletStats, allScopes, authorize, buildBetas, commerceScopes, computeBackoff, defaultRetryable, defaultSafeToRetry, discover, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, isSSLError, modelScopes, newFileTokenStore, newTokenSet, refreshToken, register, revokeToken, skillScopes, uniqueMerge };
+export { type AgentRun, type AgentRunArtifact, type AgentRunArtifactList, type AgentRunArtifactPolicy, type AgentRunCreateRequest, type AgentRunCreateResponse, type AgentRunDownload, type AgentRunErrorPayload, type AgentRunLocalContextPolicy, type AgentRunLocalToolHandler, type AgentRunLocalToolHandlerContext, type AgentRunLocalToolResult, type AgentRunRunOptions, type AgentRunSettlement, type AgentRunStatus, AgentRunStreamError, type AgentRunStreamEvent, type AgentRunStreamOptions, type AgentRunUsage, type AgentRunWithLocalToolsOptions, AgentRunsClient, AnthropicResponse, type AuthorizeResult, BalanceDetail, type BlockMeta, type BugReportResult, type BugView, CertificationStatus, ChatRequest, ChatResponse, Client, ClientRegistration, type Config, ConsumeRecordPage, DefaultRetryPolicy, DeviceRegistration, EntitlementBalance, EntitlementItem, ErrAuthDenied, ErrBrowserOpen, ErrDiscovery, ErrRegistration, ErrSSLProxy, ErrTimeout, ErrTokenExchange, EventAuthURL, EventComplete, EventError, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, GenerateSkillRequest, GenerateSkillResult, InMemoryTokenStore, InputModality, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, ModelBucket, ModelByQuotaResponse, ModelCapabilities, ModelCoefficient, NotificationList, NotificationPreference, OptimizeSkillRequest, OptimizeSkillResult, Order, OrderStatus, PayPayload, ProviderAdapter, QuotaSummary, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, ServerMetadata, SkillBrowseListResponse, SkillBrowseResponse, SkillStoreItem, SkillStoreQuery, SkillSummary, SourcesEvent, StreamEvent, StreamSettlement, TokenPackage, TokenResponse, TokenSet, type TokenStore, ToolView, Transaction, type WSConfig, WSEvent, WalletStats, allScopes, authorize, buildBetas, commerceScopes, computeBackoff, defaultRetryable, defaultSafeToRetry, discover, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, findDesktopVisualUnderstandingModel, findFirstModelByInputModality, isSSLError, modelScopes, modelSupportsImageInput, modelSupportsInputModality, newFileTokenStore, newTokenSet, refreshToken, register, revokeToken, skillScopes, uniqueMerge };

package/dist/node/index.d.ts

@@ -1,10 +1,53 @@
-import { S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, M as ModelCapabilities, b as ChatRequest, c as ManagedModel, d as ModelCoefficient, Q as QuotaSummary, P as ProviderAdapter, e as ChatResponse, A as AnthropicResponse, f as StreamEvent, g as SourcesEvent, h as StreamSettlement, E as EntitlementBalance, B as BalanceDetail, i as EntitlementItem, j as ConsumeRecordPage, k as ModelByQuotaResponse, l as ModelBucket, m as TokenPackage, n as PayPayload, O as Order, o as OrderStatus, W as WalletStats, p as Transaction, q as SkillStoreQuery, r as SkillStoreItem, s as SkillBrowseResponse, t as SkillBrowseListResponse, u as SkillSummary, v as CertificationStatus, G as GenerateSkillRequest, w as GenerateSkillResult, x as OptimizeSkillRequest, y as OptimizeSkillResult, z as ToolView, N as NotificationList, D as DeviceRegistration, F as NotificationPreference, H as WSEvent } from './index-C3Z_84Bv.js';
-export { I as APIResponse, J as AnthropicContentBlock, K as AnthropicUsage, L as BucketClassCommercial, R as BucketClassGeneric, U as BucketInfo, V as BucketRow, X as BusinessError, Y as ChatContentBlock, Z as ChatMessage, _ as ChatUsage, $ as ConsumeRecord, a0 as EffortConfig, a1 as GeoLoc, a2 as HTTPError, a3 as ModelNotFoundError, a4 as NetworkError, a5 as Notification, a6 as NotificationUnreadCount, a7 as OpenAIChatChoice, a8 as OpenAIChatMessage, a9 as OpenAIChatResponse, aa as OpenAIFunctionCall, ab as OpenAIStreamChoice, ac as OpenAIStreamChunk, ad as OpenAIStreamDelta, ae as OpenAIStreamToolCall, af as OpenAIToolCall, ag as OpenAIUsage, ah as OrderTerminalError, ai as OutputConfig, aj as ProviderFormat, ak as RateLimitError, al as ServerTool, am as ServerToolTypeWebSearch, an as SkillStoreListItem, ao as StreamError, ap as ThinkingConfig, aq as ThinkingHigh, ar as ThinkingHighMinMaxTokens, as as ThinkingMax, at as ThinkingMaxFallbackMaxTokens, au as ThinkingOff, av as ToolListResponse, aw as ToolProvider, ax as WebSearchConfig, ay as WebSearchSource, az as YudaoPageResult, aA as anthropicResponseTextContent, aB as anthropicResponseThinkingContent, aC as anthropicResponseToolUseBlocks, aD as apiResponseBusinessError, aE as apiResponseGetMessage, aF as bucketInfoIsCommercial, aG as bucketRowIsCommercial, aH as getAdapter, aI as getAdapterForModel, aJ as newThinkingConfig, aK as newWebSearchTool, aL as parseNotificationEvent, aM as parseSettlement, aN as parseSourcesEvent, aO as tokenSetIsExpired } from './index-C3Z_84Bv.js';
+import { M as ManagedModel, I as InputModality, S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, b as ModelCoefficient, Q as QuotaSummary, c as ModelCapabilities, d as ChatRequest, P as ProviderAdapter, e as ChatResponse, A as AnthropicResponse, f as StreamEvent, g as SourcesEvent, h as StreamSettlement, E as EntitlementBalance, B as BalanceDetail, i as EntitlementItem, j as ConsumeRecordPage, k as ModelByQuotaResponse, l as ModelBucket, m as TokenPackage, n as PayPayload, O as Order, o as OrderStatus, W as WalletStats, p as Transaction, q as SkillStoreQuery, r as SkillStoreItem, s as SkillBrowseResponse, t as SkillBrowseListResponse, u as SkillSummary, v as CertificationStatus, G as GenerateSkillRequest, w as GenerateSkillResult, x as OptimizeSkillRequest, y as OptimizeSkillResult, z as ToolView, N as NotificationList, D as DeviceRegistration, F as NotificationPreference, H as WSEvent } from './index-B2Uuh21R.js';
+export { J as APIResponse, K as AnthropicContentBlock, L as AnthropicUsage, R as BucketClassCommercial, U as BucketClassGeneric, V as BucketInfo, X as BucketRow, Y as BusinessError, Z as ChatContentBlock, _ as ChatMessage, $ as ChatUsage, a0 as ConsumeRecord, a1 as EffortConfig, a2 as GeoLoc, a3 as HTTPError, a4 as ModelNotFoundError, a5 as NetworkError, a6 as Notification, a7 as NotificationUnreadCount, a8 as OpenAIChatChoice, a9 as OpenAIChatMessage, aa as OpenAIChatResponse, ab as OpenAIFunctionCall, ac as OpenAIStreamChoice, ad as OpenAIStreamChunk, ae as OpenAIStreamDelta, af as OpenAIStreamToolCall, ag as OpenAIToolCall, ah as OpenAIUsage, ai as OrderTerminalError, aj as OutputConfig, ak as ProviderFormat, al as RateLimitError, am as ServerTool, an as ServerToolTypeWebSearch, ao as SkillStoreListItem, ap as StreamError, aq as ThinkingConfig, ar as ThinkingHigh, as as ThinkingHighMinMaxTokens, at as ThinkingMax, au as ThinkingMaxFallbackMaxTokens, av as ThinkingOff, aw as ToolListResponse, ax as ToolProvider, ay as WebSearchConfig, az as WebSearchSource, aA as YudaoPageResult, aB as anthropicResponseTextContent, aC as anthropicResponseThinkingContent, aD as anthropicResponseToolUseBlocks, aE as apiResponseBusinessError, aF as apiResponseGetMessage, aG as bucketInfoIsCommercial, aH as bucketRowIsCommercial, aI as getAdapter, aJ as getAdapterForModel, aK as newThinkingConfig, aL as newWebSearchTool, aM as parseNotificationEvent, aN as parseSettlement, aO as parseSourcesEvent, aP as tokenSetIsExpired } from './index-B2Uuh21R.js';
 import { M as MinimalSanitizeConfig } from './index-nvLKgCm9.js';
 export { i as sanitize } from './index-nvLKgCm9.js';
 export { AnthropicAdapter } from './adapters/anthropic.js';
 export { OpenAIAdapter } from './adapters/openai.js';
 
+/**
+ * 判断 ManagedModel 是否声明支持指定输入模态.
+ *
+ * 语义:
+ *   - model 为 null/undefined → false
+ *   - model.inputModalities 缺失或非数组 → false (保守, 未声明不当支持)
+ *   - 大小写敏感 (上游契约即小写 'text' | 'image')
+ */
+declare function modelSupportsInputModality(model: ManagedModel | null | undefined, modality: InputModality): boolean;
+/** 等价 modelSupportsInputModality(model, 'image') — 调用方常见快捷判定. */
+declare function modelSupportsImageInput(model: ManagedModel | null | undefined): boolean;
+/**
+ * 在 catalog 中按 catalog 顺序查找首个支持指定模态的模型.
+ *
+ * 选择规则:
+ *   1. isEnabled !== false (默认开, 显式 false 才剔除)
+ *   2. inputModalities 包含指定模态
+ *   3. 命中后按 catalog 顺序返回第一个; 未命中返 null
+ *
+ * 注意: 该 helper 不读 isDefault, 调用方需要 "默认优先" 请用
+ * findDesktopVisualUnderstandingModel 或自行排序.
+ */
+declare function findFirstModelByInputModality(models: ManagedModel[], modality: InputModality): ManagedModel | null;
+/**
+ * 在 catalog 中选出最适合做 "桌面视觉理解 sidecar" 的模型.
+ *
+ * 设计目的: CrabCode desktop automation 链路里, 主模型不一定多模态;
+ * 截图先送 sidecar 解析成结构化 UI 描述, 再喂主模型. 这里选 sidecar 模型
+ * 严格走运营标注的 supports_desktop_visual_understanding capability, 不靠
+ * 模型名猜.
+ *
+ * 选择规则 (按用户指定顺序):
+ *   1. isEnabled !== false
+ *   2. capabilities.supports_desktop_visual_understanding === true
+ *   3. inputModalities 包含 'image' (必须真能吃图)
+ *   4. 命中集合中优先 isDefault === true; 否则返回 catalog 顺序第一个
+ *
+ * 全部不满足返 null. 调用方收到 null 应:
+ *   - 提示用户在管理后台/网关侧开启桌面视觉 sidecar 模型, 或
+ *   - 降级停掉依赖截图的工作流, 而不是硬选一个非视觉模型送图.
+ */
+declare function findDesktopVisualUnderstandingModel(models: ManagedModel[]): ManagedModel | null;
+
 /**
  * 从 well-known 端点获取 Desktop OAuth 服务元数据。
  *
@@ -297,10 +340,182 @@ interface BlockMeta {
  */
 declare function extractAnthropicBlockMeta(eventType: string, data: string, blockTypeMap: Map<number, BlockMeta>): [number, string, boolean];
 
-/** 根据模型能力和请求参数自动组装 beta header 列表 */
-declare function buildBetas(caps: ModelCapabilities, req: ChatRequest): string[];
-/** 合并两个字符串数组并去重, 保留顺序 */
-declare function uniqueMerge(base: string[], extra: string[]): string[];
+type AgentRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+interface AgentRunLocalContextPolicy {
+    enabled?: boolean;
+    readonly?: boolean;
+    maxBytes?: number;
+    allowedTools?: string[];
+}
+interface AgentRunArtifactPolicy {
+    enabled?: boolean;
+    maxFiles?: number;
+}
+interface AgentRunCreateRequest {
+    appId: string;
+    mode?: string;
+    sessionId?: string;
+    input: string;
+    messages?: unknown[];
+    model?: string;
+    activeSkillIds?: string[];
+    knowledgeBaseIds?: string[];
+    metadata?: Record<string, string>;
+    localContextPolicy?: AgentRunLocalContextPolicy;
+    artifactPolicy?: AgentRunArtifactPolicy;
+}
+interface AgentRun {
+    runId: string;
+    sessionId: string;
+    appId?: string;
+    mode?: string;
+    status: AgentRunStatus;
+    createdAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    error?: AgentRunErrorPayload;
+    metadata?: Record<string, string>;
+}
+interface AgentRunCreateResponse {
+    runId: string;
+    sessionId: string;
+    status: AgentRunStatus;
+}
+interface AgentRunArtifact {
+    id: string;
+    filename: string;
+    contentType?: string;
+    size?: number;
+    type?: string;
+    metadata?: Record<string, string>;
+}
+interface AgentRunArtifactList {
+    artifacts: AgentRunArtifact[];
+}
+interface AgentRunDownload {
+    data: Uint8Array;
+    filename: string;
+    contentType?: string;
+}
+interface AgentRunUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreateTokens?: number;
+    exact?: boolean;
+    source?: string;
+    [key: string]: unknown;
+}
+interface AgentRunSettlement {
+    requestId?: string;
+    status?: string;
+    consumeStatus?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cacheReadTokens?: number;
+    cacheCreateTokens?: number;
+    tokenRemaining?: number;
+    callRemaining?: number;
+    retryQueued?: boolean;
+    exact?: boolean;
+    [key: string]: unknown;
+}
+interface AgentRunErrorPayload {
+    code?: string;
+    message: string;
+    stage?: string;
+    retryable?: boolean;
+    raw?: unknown;
+}
+interface AgentRunLocalToolResult {
+    requestId: string;
+    ok: boolean;
+    content?: unknown;
+    error?: string;
+}
+interface AgentRunLocalToolHandlerContext {
+    runId: string;
+    requestId: string;
+    name: string;
+    signal: AbortSignal;
+}
+type AgentRunLocalToolHandler = (input: unknown, context: AgentRunLocalToolHandlerContext) => Promise<unknown> | unknown;
+interface AgentRunStreamOptions {
+    /**
+     * true by default. When enabled, an error event is converted into
+     * AgentRunStreamError after the event has been parsed.
+     */
+    throwOnError?: boolean;
+}
+interface AgentRunRunOptions extends AgentRunStreamOptions {
+}
+interface AgentRunWithLocalToolsOptions extends AgentRunRunOptions {
+    timeoutMs?: number;
+    onEvent?: (event: AgentRunStreamEvent) => void | Promise<void>;
+}
+type AgentRunStreamEvent = {
+    type: 'run_started';
+    runId: string;
+    sessionId: string;
+} | {
+    type: 'status';
+    status: AgentRunStatus | string;
+    message?: string;
+} | {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'reasoning_delta';
+    text: string;
+} | {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    input?: unknown;
+} | {
+    type: 'tool_result';
+    id: string;
+    name?: string;
+    result?: unknown;
+    error?: string;
+} | {
+    type: 'local_tool_request';
+    requestId: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'artifact';
+    artifact: AgentRunArtifact;
+} | {
+    type: 'sources';
+    sources: unknown;
+} | {
+    type: 'usage';
+    usage: AgentRunUsage;
+} | {
+    type: 'settle';
+    settlement: AgentRunSettlement;
+} | {
+    type: 'error';
+    error: AgentRunErrorPayload;
+} | {
+    type: 'done';
+    runId: string;
+    status: AgentRunStatus | string;
+};
+declare class AgentRunStreamError extends Error {
+    event: Extract<AgentRunStreamEvent, {
+        type: 'error';
+    }>;
+    code: string;
+    stage: string;
+    retryable: boolean;
+    constructor(event: Extract<AgentRunStreamEvent, {
+        type: 'error';
+    }>);
+}
 
 type FilterStatus = 'ok' | 'admin-bypass' | 'internal-bypass' | 'disabled-by-flag' | 'fallback-tkdist-error' | 'fallback-tkdist-deployment-skew' | 'fallback-no-buckets' | 'fallback-missing-userid' | '';
 declare const FilterStatusOK: FilterStatus;
@@ -590,6 +805,37 @@ declare class Client {
     }, signal?: AbortSignal): Promise<Response>;
 }
 
+declare module '@acosmi/sdk-ts' {
+    interface Client {
+        /** SDK-facing cloud agent run gateway. */
+        readonly agentRuns: AgentRunsClient;
+    }
+}
+declare class AgentRunsClient {
+    private readonly client;
+    constructor(client: Client);
+    create(req: AgentRunCreateRequest, signal?: AbortSignal): Promise<AgentRunCreateResponse>;
+    get(runId: string, signal?: AbortSignal): Promise<AgentRun>;
+    stream(runId: string, opts?: AgentRunStreamOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    cancel(runId: string, signal?: AbortSignal): Promise<AgentRun>;
+    listArtifacts(runId: string, signal?: AbortSignal): Promise<AgentRunArtifact[]>;
+    downloadArtifact(runId: string, artifactId: string, signal?: AbortSignal): Promise<AgentRunDownload>;
+    submitLocalToolResult(runId: string, result: AgentRunLocalToolResult, signal?: AbortSignal): Promise<AgentRun>;
+    run(req: AgentRunCreateRequest, opts?: AgentRunRunOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    runWithLocalTools(req: AgentRunCreateRequest, handlers: Record<string, AgentRunLocalToolHandler>, opts?: AgentRunWithLocalToolsOptions, signal?: AbortSignal): AsyncIterable<AgentRunStreamEvent>;
+    private runGen;
+    private runWithLocalToolsGen;
+    private invokeLocalTool;
+    private streamGen;
+    private requestAPI;
+    private requestRaw;
+}
+
+/** 根据模型能力和请求参数自动组装 beta header 列表 */
+declare function buildBetas(caps: ModelCapabilities, req: ChatRequest): string[];
+/** 合并两个字符串数组并去重, 保留顺序 */
+declare function uniqueMerge(base: string[], extra: string[]): string[];
+
 declare module '@acosmi/sdk-ts' {
     interface Client {
         /** 查询当前用户的权益余额 (聚合) */
@@ -833,4 +1079,4 @@ declare module '@acosmi/sdk-ts' {
     }
 }
 
-export { AnthropicResponse, type AuthorizeResult, BalanceDetail, type BlockMeta, type BugReportResult, type BugView, CertificationStatus, ChatRequest, ChatResponse, Client, ClientRegistration, type Config, ConsumeRecordPage, DefaultRetryPolicy, DeviceRegistration, EntitlementBalance, EntitlementItem, ErrAuthDenied, ErrBrowserOpen, ErrDiscovery, ErrRegistration, ErrSSLProxy, ErrTimeout, ErrTokenExchange, EventAuthURL, EventComplete, EventError, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, GenerateSkillRequest, GenerateSkillResult, InMemoryTokenStore, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, ModelBucket, ModelByQuotaResponse, ModelCapabilities, ModelCoefficient, NotificationList, NotificationPreference, OptimizeSkillRequest, OptimizeSkillResult, Order, OrderStatus, PayPayload, ProviderAdapter, QuotaSummary, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, ServerMetadata, SkillBrowseListResponse, SkillBrowseResponse, SkillStoreItem, SkillStoreQuery, SkillSummary, SourcesEvent, StreamEvent, StreamSettlement, TokenPackage, TokenResponse, TokenSet, type TokenStore, ToolView, Transaction, type WSConfig, WSEvent, WalletStats, allScopes, authorize, buildBetas, commerceScopes, computeBackoff, defaultRetryable, defaultSafeToRetry, discover, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, isSSLError, modelScopes, newFileTokenStore, newTokenSet, refreshToken, register, revokeToken, skillScopes, uniqueMerge };
+export { type AgentRun, type AgentRunArtifact, type AgentRunArtifactList, type AgentRunArtifactPolicy, type AgentRunCreateRequest, type AgentRunCreateResponse, type AgentRunDownload, type AgentRunErrorPayload, type AgentRunLocalContextPolicy, type AgentRunLocalToolHandler, type AgentRunLocalToolHandlerContext, type AgentRunLocalToolResult, type AgentRunRunOptions, type AgentRunSettlement, type AgentRunStatus, AgentRunStreamError, type AgentRunStreamEvent, type AgentRunStreamOptions, type AgentRunUsage, type AgentRunWithLocalToolsOptions, AgentRunsClient, AnthropicResponse, type AuthorizeResult, BalanceDetail, type BlockMeta, type BugReportResult, type BugView, CertificationStatus, ChatRequest, ChatResponse, Client, ClientRegistration, type Config, ConsumeRecordPage, DefaultRetryPolicy, DeviceRegistration, EntitlementBalance, EntitlementItem, ErrAuthDenied, ErrBrowserOpen, ErrDiscovery, ErrRegistration, ErrSSLProxy, ErrTimeout, ErrTokenExchange, EventAuthURL, EventComplete, EventError, FileTokenStore, type FilterStatus, FilterStatusAdminBypass, FilterStatusDisabledByFlag, FilterStatusFallbackMissingUser, FilterStatusFallbackNoBuckets, FilterStatusFallbackTkdistError, FilterStatusFallbackTkdistSkew, FilterStatusInternalBypass, FilterStatusOK, FilterStatusUnknown, GenerateSkillRequest, GenerateSkillResult, InMemoryTokenStore, InputModality, LocalStorageTokenStore, type LoginErrCode, type LoginEvent, type LoginEventType, type LoginOptions, ManagedModel, ModelBucket, ModelByQuotaResponse, ModelCapabilities, ModelCoefficient, NotificationList, NotificationPreference, OptimizeSkillRequest, OptimizeSkillResult, Order, OrderStatus, PayPayload, ProviderAdapter, QuotaSummary, type RetryPolicy, type RetryRequestInfo, ScopeAI, ScopeAccount, ScopeEntitlements, ScopeModels, ScopeModelsChat, ScopeProfile, ScopeSkillStore, ScopeSkills, ScopeTokenPackages, ScopeTools, ScopeToolsExecute, ScopeWallet, ScopeWalletReadonly, ServerMetadata, SkillBrowseListResponse, SkillBrowseResponse, SkillStoreItem, SkillStoreQuery, SkillSummary, SourcesEvent, StreamEvent, StreamSettlement, TokenPackage, TokenResponse, TokenSet, type TokenStore, ToolView, Transaction, type WSConfig, WSEvent, WalletStats, allScopes, authorize, buildBetas, commerceScopes, computeBackoff, defaultRetryable, defaultSafeToRetry, discover, effectivePolicy, exchangeCode, extractAnthropicBlockMeta, fileLockDefaults, findDesktopVisualUnderstandingModel, findFirstModelByInputModality, isSSLError, modelScopes, modelSupportsImageInput, modelSupportsInputModality, newFileTokenStore, newTokenSet, refreshToken, register, revokeToken, skillScopes, uniqueMerge };