@acosmi/sdk-ts 1.0.2 → 1.1.0

package/dist/node/index.d.cts

@@ -1,5 +1,5 @@
-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 { S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, M as ManagedModel, 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-BI8EgBXu.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-BI8EgBXu.cjs';
 import { M as MinimalSanitizeConfig } from './index-nvLKgCm9.cjs';
 export { i as sanitize } from './index-nvLKgCm9.cjs';
 export { AnthropicAdapter } from './adapters/anthropic.cjs';
@@ -297,10 +297,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 +762,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 +1036,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, 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 };

package/dist/node/index.d.ts

@@ -1,5 +1,5 @@
-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 { S as ServerMetadata, T as TokenResponse, a as TokenSet, C as ClientRegistration, M as ManagedModel, 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-BI8EgBXu.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-BI8EgBXu.js';
 import { M as MinimalSanitizeConfig } from './index-nvLKgCm9.js';
 export { i as sanitize } from './index-nvLKgCm9.js';
 export { AnthropicAdapter } from './adapters/anthropic.js';
@@ -297,10 +297,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 +762,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 +1036,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, 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 };