@blade-hq/agent-client 2610.0.0-beta.9 → 2610.0.0-beta.90

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 137 个公开声明。
+共 247 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -11,6 +11,34 @@
 acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
 ```
 
+## `AccountComputer` (interface)
+
+```ts
+arch: string | null | undefined
+blade_home: string | null | undefined
+created_at: string
+daemon_version: string | null | undefined
+hostname: string | null | undefined
+id: string
+label: string
+last_seen_at: string | null | undefined
+online: boolean
+os: string | null | undefined
+workspace: string | null | undefined
+```
+
+## `AccountComputerList` (interface)
+
+```ts
+computers: AccountComputer[]
+```
+
+## `acknowledgeTurnEvents` (function)
+
+```ts
+acknowledgeTurnEvents: (acknowledge?: () => void) => void
+```
+
 ## `ActiveCompactionState` (interface)
 
 ```ts
@@ -41,26 +69,48 @@ toolCallId: string
 ## `AgentSession` (class)
 
 ```ts
-append: (text: string) => void
 attach: (label: string, data: unknown) => void
 attachApp: (options: AttachAppOptions) => Promise<AppCliAttachment | null>
+cancelPendingLocate: () => void
+cancelQueuedMessage: (itemId: string, expectedVersion?: number) => Promise<QueueOperationResult>
 compact: () => Promise<Record<string, unknown>>
 countFiles: (dirPath?: string) => Promise<number>
+deliverQueuedMessage: (itemId: string, expectedVersion: number) => Promise<QueueOperationResult>
 dispose: () => void
 downloadFile: (filePath: string, downloadName?: string) => Promise<void>
 exitReplay: () => Promise<void>
 getState: () => SessionState
+hasOlderHistory: boolean
 insertText: (text: string) => void
 isDisposed: boolean
+isStatic: boolean
 listDir: (dirPath?: string) => Promise<FileEntry[]>
+loadOlderHistory: (options?: { beforeCommit?: () => void; }) => Promise<void>
+loadTurnIndex: () => Promise<SessionTurnIndexItem[]>
+locateEntry: (entryId: string) => Promise<boolean>
 off: <K extends keyof AgentSessionEvents>(name: K, handler: (event: AgentSessionEvents[K]) => void) => void
 on: <K extends keyof AgentSessionEvents>(name: K, handler: (event: AgentSessionEvents[K]) => void) => () => void
 onCommand: (action: string, handler: CommandHandler) => () => void
+queueMessage: (content: string) => Promise<QueueOperationResult>
+refreshQueue: () => Promise<QueueOperationResult>
+reorderQueuedMessages: (expectedRevision: number, orderedIds: string[]) => Promise<QueueOperationResult>
+resumeQueue: () => Promise<QueueOperationResult>
 send: (content: MessageContent, options?: SendOptions) => Promise<boolean>
 sessionId: string
 setReplaySpeed: (speed: ReplaySpeed) => Promise<void>
 stop: () => Promise<Record<string, unknown>>
 subscribe: (listener: () => void) => () => void
+updateQueuedMessage: (itemId: string, expectedVersion: number, content: string) => Promise<QueueOperationResult>
+```
+
+## `AgentSessionError` (class)
+
+```ts
+cause: unknown
+code: string | undefined
+message: string
+name: "AgentSessionError"
+stack: string | undefined
 ```
 
 ## `AgentSessionEventName` (type)
@@ -77,7 +127,7 @@ attachRequested: { label: string; content: string; }
 backgroundTask: { id: string; command: string; description?: string; status: "starting" | "running" | "cancelling" | "succeeded" | "failed" | "cancelled" | "lost"; failureReason?: string | null; exitCode?: number | null; elapsedSeconds: number; output?: string; }
 chatEnd: { status: string; }
 command: { action: string; payload: unknown; toolCallId?: string; }
-error: { message: string; }
+error: { message: string; code?: string; }
 insertTextRequested: { text: string; }
 message: { message: ChatMessage; turn: TurnProjection; }
 modeChange: { mode: "planning" | "executing"; }
@@ -85,11 +135,11 @@ notification: { type: string; title: string; detail?: string; status: "info" | "
 replayMismatch: { actualMessage?: string; expectedMessage?: string; respond: (decision: "keep_replay" | "continue_replay") => void; }
 rewind: { checkpointId: string; }
 sandboxOom: { toolCallId: string; }
-sessionUpdated: { intent?: string; status?: SessionStatus; model?: string | null; boundSkillId?: string | null; replayState?: Record<string, unknown> | null; }
+sessionUpdated: { workspacePath?: string; chatGroupId?: string | null; intent?: string; status?: SessionStatus; model?: string | null; boundSkillId?: string | null; replayState?: Record<string, unknown> | null; }
 taskListUpdated: { tasks: unknown[]; }
 toolCall: { toolCall: ToolCallInfo; turn: TurnProjection; }
-toolPreview: { toolCallId: string; type: "resource-html" | "resource-uri"; content: string; title: string; }
-toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; }
+toolPreview: { sourcePath?: string; toolCallId: string; type: "resource-html" | "resource-uri" | "resource-file"; content: string; title: string; mcpApp?: McpAppData; }
+toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; source: "live" | "bootstrap_replay" | "reconnect_replay"; }
 workspaceChanged: { filePath?: string; }
 ```
 
@@ -133,6 +183,7 @@ tool_name: string | null | undefined
 
 ```ts
 custom: Record<number, string>
+note: string | undefined
 selections: Record<number, number[]>
 ```
 
@@ -152,6 +203,20 @@ cli: AppCliDefinition | undefined
 getContext: () => Record<string, unknown> | Promise<Record<string, unknown>>
 ```
 
+## `AuthBusyReconnect` (class)
+
+```ts
+cancel: () => void
+pending: boolean
+schedule: (error: unknown, reconnect: () => void) => boolean
+```
+
+## `authBusyRetryDelayMs` (function)
+
+```ts
+authBusyRetryDelayMs: (error: unknown) => number | null
+```
+
 ## `AuthResource` (class)
 
 ```ts
@@ -217,6 +282,8 @@ statusText: string
 auth: AuthResource
 blob: (method: HttpMethod, path: string) => Promise<Blob>
 buildAuthedUrl: (path: string) => string
+chatGroups: ChatGroupsResource
+computers: ComputersResource
 fetch: (method: HttpMethod, path: string, init?: BladeFetchInit, isRetry?: boolean) => Promise<Response>
 formData: (method: HttpMethod, path: string, form: FormData, options?: { expectOk?: boolean; onUploadProgress?: (progress: UploadProgress) => void; }) => Promise<Response>
 hasToken: () => boolean
@@ -229,10 +296,13 @@ logoutToken: () => void
 models: ModelsResource
 onSocketReplaced: (listener: () => void) => () => void
 options: BladeClientOptions
+plugins: PluginsResource
+requestCommand: (event: string, payload: Record<string, unknown>, timeoutMs: number) => Promise<Record<string, unknown>>
 responseFromInit: (path: string, init?: RequestInit) => Promise<Response>
 sessions: SessionsResource
 setBaseUrl: (baseUrl: string) => void
 setToken: (token: string | null) => void
+siteVisits: SiteVisitsResource
 socket: () => TypedSocket
 text: (method: HttpMethod, path: string) => Promise<string>
 textFromInit: (path: string, init?: RequestInit) => Promise<string>
@@ -243,10 +313,10 @@ token: string | null
 
 ```ts
 baseUrl: string
+commandTransport: ((event: string, payload: Record<string, unknown>, send: () => Promise<Record<string, unknown>>) => Promise<Record<string, unknown>>) | undefined
 fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
 onRefreshSuccess: (() => void | Promise<void>) | undefined
 socketToken: string | (() => string | null | undefined) | undefined
-streamTokens: boolean | undefined
 token: string | (() => string | null | undefined) | undefined
 tokenStorage: TokenStorageMode | undefined
 ```
@@ -257,12 +327,78 @@ tokenStorage: TokenStorageMode | undefined
 buildMessageContent: (text: string, attachments: Array<{ kind: "file"; name: string; uploadedPath?: string; textContent?: string | null; mimeType?: string; }>) => MessageContent
 ```
 
+## `buildToolUiCardKey` (function)
+
+```ts
+buildToolUiCardKey: (toolCallId: string, type: ToolUiCardContentType, content: string, sourcePath?: string) => string
+```
+
+## `canCancelQueuedMessage` (function)
+
+```ts
+canCancelQueuedMessage: (item: QueuedMessage) => boolean
+```
+
+## `canDeliverQueuedMessage` (function)
+
+```ts
+canDeliverQueuedMessage: (item: QueuedMessage) => boolean
+```
+
+## `canEditQueuedMessage` (function)
+
+```ts
+canEditQueuedMessage: (item: QueuedMessage) => boolean
+```
+
+## `canToggleComputer` (function)
+
+```ts
+canToggleComputer: (computer: SessionComputer) => boolean
+```
+
+## `ChatEnd` (interface)
+
+```ts
+duration_ms: number
+status: string
+```
+
+## `chatErrorForDisplay` (function)
+
+```ts
+chatErrorForDisplay: (message: string, developer?: boolean) => string
+```
+
+## `ChatGroup` (interface)
+
+```ts
+created_at: string
+id: string
+initiator: "ui" | "sdk" | null
+instructions: string
+name: string
+session_count: number
+updated_at: string
+workspace_path: string
+```
+
+## `ChatGroupsResource` (class)
+
+```ts
+create: (payload: { name: string; instructions?: string; initiator?: "ui" | "sdk"; }) => Promise<ChatGroup>
+delete: (groupId: string, options?: { deleteWorkspace?: boolean; }) => Promise<{ deleted: boolean; deleted_sessions: number; }>
+list: () => Promise<ChatGroup[]>
+update: (groupId: string, payload: { name?: string; instructions?: string; }) => Promise<ChatGroup>
+```
+
 ## `ChatMessage` (interface)
 
 ```ts
 blocks: ContentBlock[] | undefined
 compaction: CompactionInfo | undefined
 content: MessageContent
+context: ContextProjectionData | undefined
 duration_ms: number | undefined
 entry_id: string | undefined
 kind: string | undefined
@@ -286,6 +422,18 @@ reset: () => void
 seedSequence: (maxSeq: number) => void
 ```
 
+## `collectInlineToolUiCards` (function)
+
+```ts
+collectInlineToolUiCards: (messages: ChatMessage[]) => InlineToolUiCardEntry[]
+```
+
+## `collectPreviewToolUiCards` (function)
+
+```ts
+collectPreviewToolUiCards: (messages: ChatMessage[]) => PreviewToolUiCardEntry[]
+```
+
 ## `CommandEnvelope` (interface)
 
 ```ts
@@ -318,6 +466,50 @@ tokens_before: number | null | undefined
 trigger: "auto" | "manual" | "forced_retry" | null | undefined
 ```
 
+## `computerDaemonVersion` (function)
+
+```ts
+computerDaemonVersion: (computer: SessionComputer) => string
+```
+
+## `computerOS` (function)
+
+```ts
+computerOS: (computer: SessionComputer) => ComputerOS
+```
+
+## `ComputerOS` (type)
+
+```ts
+export type ComputerOS = "macos" | "windows" | "linux" | "unknown"
+```
+
+## `computerPlatformLabel` (function)
+
+```ts
+computerPlatformLabel: (computer: SessionComputer) => string
+```
+
+## `ComputersResource` (class)
+
+```ts
+list: (sessionId: string) => Promise<SessionComputerList>
+listAccount: () => Promise<AccountComputerList>
+setEnabled: (sessionId: string, computer: string, enabled: boolean) => Promise<SessionComputer>
+```
+
+## `computerState` (function)
+
+```ts
+computerState: (computer: SessionComputer) => ComputerState
+```
+
+## `ComputerState` (type)
+
+```ts
+export type ComputerState = "primary" | "enabled" | "offline" | "idle"
+```
+
 ## `connectEmbedded` (function)
 
 ```ts
@@ -334,18 +526,89 @@ export type ConnectionStatus = "connecting" | "connected" | "reconnecting" | "di
 
 ```ts
 content: unknown
+delivery_id: string | null | undefined
 display_name: string | null | undefined
 tool_call_id: string | null | undefined
 tool_name: string | null | undefined
 type: "text" | "thinking" | "tool_use" | "tool_result" | "tool_ui" | "tool_bridge" | "system_notification" | "mode_change" | "plan_status" | "ask_user_answer"
 ```
 
+## `ContentDelta` (interface)
+
+```ts
+content: string
+loop_name: string | undefined
+```
+
 ## `contentPreview` (function)
 
 ```ts
 contentPreview: (content: MessageContent, maxLen?: number) => string
 ```
 
+## `ContextAction` (type)
+
+```ts
+export type ContextAction = "published" | "retained" | "removed"
+```
+
+## `ContextDisplayState` (interface)
+
+```ts
+detail: string
+isRemoved: boolean
+summary: string
+title: string
+```
+
+## `ContextGroupDisplayState` (interface)
+
+```ts
+count: number
+summary: string
+title: string
+```
+
+## `contextProjectionData` (function)
+
+```ts
+contextProjectionData: (fields: ContextProjectionFields) => ContextProjectionData | null
+```
+
+## `ContextProjectionData` (interface)
+
+```ts
+context_action: ContextAction
+context_key: string
+context_kind: string
+context_name: string
+context_order: number
+context_revision: string
+display_summary: string | null | undefined
+display_title: string | null | undefined
+sources: ContextSourceInfo[]
+```
+
+## `ContextProjectionFields` (interface)
+
+```ts
+context_action: ContextAction | null | undefined
+context_key: string | null | undefined
+context_kind: string | null | undefined
+context_name: string | null | undefined
+context_order: number | null | undefined
+context_revision: string | null | undefined
+display_summary: string | null | undefined
+display_title: string | null | undefined
+sources: ContextSourceInfo[] | null | undefined
+```
+
+## `ContextSourceInfo` (type)
+
+```ts
+export type ContextSourceInfo = Record<string, unknown>
+```
+
 ## `createInitialSessionState` (function)
 
 ```ts
@@ -355,7 +618,9 @@ createInitialSessionState: (sessionId: string) => SessionState
 ## `CreateSessionRequest` (interface)
 
 ```ts
+agent_runtime_id: string | null | undefined
 biz_role_id: string | null | undefined
+chat_group_id: string | null | undefined
 compaction_ratio: number | null | undefined
 daemon_id: string | null | undefined
 disable_tools: string[] | null | undefined
@@ -365,7 +630,7 @@ intent: string | undefined
 memory_enabled: boolean | null | undefined
 model: string | null | undefined
 primary_skill_id: string | null | undefined
-runtime_type: "sandbox" | "daemon" | null | undefined
+runtime_type: "sandbox" | "daemon" | "native" | null | undefined
 session_solution_asset_id: string | null | undefined
 solution_id: string | undefined
 solution_ref: PublishedSolutionRef | undefined
@@ -385,6 +650,7 @@ createSocket: (options: CreateSocketOptions) => TypedSocket
 baseUrl: string
 path: string | undefined
 token: string | (() => string | null | undefined) | undefined
+transports: ("polling" | "websocket")[] | undefined
 ```
 
 ## `DEFAULT_REPLAY_SPEED` (const)
@@ -410,6 +676,18 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
+## `EMPTY_PLATFORM_ENDPOINTS` (const)
+
+```ts
+EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
+```
+
+## `EMPTY_SESSION_QUEUE` (const)
+
+```ts
+EMPTY_SESSION_QUEUE: SessionQueueSnapshot
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -466,6 +744,18 @@ label: string
 target: string
 ```
 
+## `getContextDisplayState` (function)
+
+```ts
+getContextDisplayState: (context: ContextProjectionData) => ContextDisplayState
+```
+
+## `getContextGroupDisplayState` (function)
+
+```ts
+getContextGroupDisplayState: (contexts: readonly ContextProjectionData[]) => ContextGroupDisplayState
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -520,12 +810,24 @@ export type GlobalSearchResultItem =
   | GlobalSearchFileResult
 ```
 
+## `groupAdjacentContextRuns` (function)
+
+```ts
+groupAdjacentContextRuns: (kinds: readonly (string | null)[]) => readonly (readonly number[])[]
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
 groupMessagesByLoop: (messages: ChatMessage[]) => MessageGroup[]
 ```
 
+## `hasChatRunEvent` (function)
+
+```ts
+hasChatRunEvent: (events: RawEvent[]) => boolean
+```
+
 ## `HeadlessResource` (class)
 
 ```ts
@@ -534,10 +836,19 @@ runInSession: { <T = unknown>(sessionId: string, prompt: string, options: Headle
 runWithSession: { <T = unknown>(prompt: string, options: HeadlessRunOptions & { schema: JsonSchemaObject; }): Promise<HeadlessRunInSessionResult<T>>; (prompt: string, options?: HeadlessRunOptions): Promise<HeadlessRunInSessionResult<string>>; }
 ```
 
+## `HistoricalCommand` (interface)
+
+```ts
+action: string
+deliveryId: string
+payload: unknown
+toolCallId: string | undefined
+```
+
 ## `ImageUrlContentPart` (interface)
 
 ```ts
-image_url: { url: string; }
+image_url: { url: string; source_path?: string; width?: number; height?: number; }
 type: "image_url"
 ```
 
@@ -562,16 +873,48 @@ direction: "host-to-agent"
 payload: unknown
 ```
 
+## `inferToolStatus` (function)
+
+```ts
+inferToolStatus: (resultStr: string) => "done" | "error" | "cancelled"
+```
+
+## `InlineToolUiCardEntry` (interface)
+
+```ts
+card: ToolUiCard
+key: string
+toolCallId: string
+```
+
+## `isAppDevToolUiCard` (function)
+
+```ts
+isAppDevToolUiCard: (card: ToolUiCard, isAppDev: boolean) => boolean
+```
+
+## `isBackgroundWakeMessage` (function)
+
+```ts
+isBackgroundWakeMessage: (message: Pick<ChatMessage, "blocks">) => boolean
+```
+
 ## `isCommandEnvelope` (function)
 
 ```ts
 isCommandEnvelope: (value: unknown) => value is CommandEnvelope
 ```
 
+## `isEntryGoneError` (function)
+
+```ts
+isEntryGoneError: (error: unknown) => boolean
+```
+
 ## `isHiddenInternalMessage` (function)
 
 ```ts
-isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boolean
+isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">, options?: { includeLegacyForkContext?: boolean; }) => boolean
 ```
 
 ## `isInboundEnvelope` (function)
@@ -580,6 +923,30 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boo
 isInboundEnvelope: (value: unknown) => value is InboundEnvelope
 ```
 
+## `isInternalStatusToolUiCard` (function)
+
+```ts
+isInternalStatusToolUiCard: (card: { title?: string | null; } | null) => boolean
+```
+
+## `isMcpAppData` (function)
+
+```ts
+isMcpAppData: (value: unknown) => value is McpAppData
+```
+
+## `isSessionQueueSnapshot` (function)
+
+```ts
+isSessionQueueSnapshot: (value: unknown) => value is SessionQueueSnapshot
+```
+
+## `isToolUiCard` (function)
+
+```ts
+isToolUiCard: (value: unknown) => value is ToolUiCard
+```
+
 ## `latestPostChatFollowup` (function)
 
 ```ts
@@ -602,6 +969,37 @@ export enum LayoutType {
 }
 ```
 
+## `LiveRevisionState` (interface)
+
+```ts
+byTurnId: ReadonlyMap<string, number>
+current: number
+```
+
+## `LlmResponseDone` (interface)
+
+```ts
+content: string | null | undefined
+loop_name: string | undefined
+reasoning: string | null | undefined
+role: string
+tool_calls: { id: string; function: { name: string; arguments: string; }; }[] | undefined
+```
+
+## `loadPlatformEndpoints` (function)
+
+```ts
+loadPlatformEndpoints: (options?: LoadPlatformEndpointsOptions) => Promise<PlatformEndpoints>
+```
+
+## `LoadPlatformEndpointsOptions` (interface)
+
+```ts
+baseUrl: string | undefined
+fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
+timeoutMs: number | undefined
+```
+
 ## `LoginOptions` (interface)
 
 ```ts
@@ -617,6 +1015,49 @@ token: string
 user: { id?: string; username?: string; display_name?: string; } | undefined
 ```
 
+## `McpAppArchive` (interface)
+
+```ts
+html: string
+mimeType: string
+plugin: string
+previousToolInput: Record<string, unknown> | undefined
+previousToolResult: Record<string, unknown> | undefined
+resourceMeta: Record<string, unknown>
+resourceUri: string
+sourceId: string
+toolInput: Record<string, unknown>
+toolResult: Record<string, unknown>
+```
+
+## `McpAppContextState` (interface)
+
+```ts
+content: string
+plugin: string | null
+revision: string
+server_alias: string | null
+```
+
+## `McpAppContextUpdate` (interface)
+
+```ts
+content: string
+expected_revision: string | null
+request_id: string
+```
+
+## `McpAppData` (interface)
+
+```ts
+mimeType: string
+resourceMeta: Record<string, unknown>
+resourceUri: string
+sourceId: string
+toolInput: Record<string, unknown>
+toolResult: Record<string, unknown>
+```
+
 ## `MemoryRef` (interface)
 
 ```ts
@@ -658,6 +1099,8 @@ baseUrl: string | undefined
 default: string
 defaultServiceModel: string | undefined
 models: ModelOption[]
+unavailableModelIds: string[] | undefined
+unavailableProviderIds: string[] | undefined
 ```
 
 ## `ModelOption` (interface)
@@ -704,6 +1147,12 @@ content: string
 label: string
 ```
 
+## `parseQueueAck` (function)
+
+```ts
+parseQueueAck: (response: unknown, fallbackSessionId: string) => QueueOperationResult
+```
+
 ## `PatchEnvelope` (interface)
 
 ```ts
@@ -714,6 +1163,51 @@ sequence: number
 turn_id: string
 ```
 
+## `PendingQuestionRef` (interface)
+
+```ts
+child_loop_name: string
+child_tool_call_id: string
+description: string | null | undefined
+```
+
+## `PlatformEndpoints` (interface)
+
+```ts
+services: Partial<Record<"os" | "hub" | "agent" | "oauth" | "llmGateway" | "gitea" | "tile", string>>
+```
+
+## `PlatformServiceName` (type)
+
+```ts
+export type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]
+```
+
+## `PluginCatalogEntry` (interface)
+
+```ts
+display_name: string | null
+icon: string | null
+installed: boolean
+name: string
+```
+
+## `PluginsResource` (class)
+
+```ts
+catalog: (init?: RequestInit) => Promise<{ plugins: PluginCatalogEntry[]; }>
+fetchIcon: (name: string) => Promise<Blob>
+iconUrl: (name: string) => string
+```
+
+## `PollingBackoff` (class)
+
+```ts
+failed: (error: unknown) => void
+reset: () => void
+waitMs: () => number | false
+```
+
 ## `PostChatFollowup` (interface)
 
 ```ts
@@ -744,6 +1238,21 @@ bizRoleId: string | undefined
 kind: "prepared"
 ```
 
+## `prependOlder` (function)
+
+```ts
+prependOlder: (current: TurnProjection[], page: TurnProjection[]) => TurnProjection[]
+```
+
+## `PreviewToolUiCardEntry` (interface)
+
+```ts
+blocks: ContentBlock[]
+card: ToolUiCard
+key: string
+toolCall: ToolCallInfo
+```
+
 ## `PrimarySkillParallelMode` (interface)
 
 ```ts
@@ -764,6 +1273,21 @@ title: string
 version: number
 ```
 
+## `PrimarySkillStageSpec` (interface)
+
+```ts
+id: string
+name: string
+steps: PrimarySkillStepSpec[]
+```
+
+## `PrimarySkillStepSpec` (interface)
+
+```ts
+label: string
+n: number
+```
+
 ## `ProvidersResponse` (interface)
 
 ```ts
@@ -779,6 +1303,61 @@ export type PublishedSolutionRef =
   | { source: "hub"; org: string; name: string }
 ```
 
+## `QueueAck` (interface)
+
+```ts
+items: QueuedMessage[] | undefined
+message: string | null | undefined
+pause_reason: string | null | undefined
+paused: boolean | undefined
+revision: number | undefined
+running: boolean | undefined
+session_id: string | undefined
+status: "error" | "ok" | "conflict" | "queued"
+```
+
+## `QueuedMessage` (interface)
+
+```ts
+content: string
+created_at: string
+error: string | undefined
+id: string
+position: number
+status: QueuedMessageStatus
+target_run_id: string | undefined
+updated_at: string
+version: number
+```
+
+## `QueuedMessageStatus` (type)
+
+```ts
+export type QueuedMessageStatus = "pending" | "delivering" | "claimed" | "consumed" | "cancelled"
+```
+
+## `queuedMessageStatusLabel` (function)
+
+```ts
+queuedMessageStatusLabel: (status: QueuedMessageStatus) => string
+```
+
+## `QueueOperationResult` (interface)
+
+```ts
+code: string | undefined
+conflict: boolean
+message: string | null
+ok: boolean
+snapshot: SessionQueueSnapshot | null
+```
+
+## `queuePauseReasonLabel` (function)
+
+```ts
+queuePauseReasonLabel: (reason: string | null | undefined) => string | null
+```
+
 ## `RawEvent` (interface)
 
 ```ts
@@ -786,12 +1365,24 @@ payload: Record<string, unknown>
 type: string
 ```
 
+## `reconcileHistoricalUserTurns` (function)
+
+```ts
+reconcileHistoricalUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
+```
+
 ## `reconcileOptimisticUserTurns` (function)
 
 ```ts
 reconcileOptimisticUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
 ```
 
+## `replaceWindow` (function)
+
+```ts
+replaceWindow: (current: TurnProjection[], page: TurnProjection[], liveRevisionAtStart: number, liveRevisions: LiveRevisionState) => TurnProjection[]
+```
+
 ## `ReplayPreview` (interface)
 
 ```ts
@@ -826,6 +1417,18 @@ speed: ReplaySpeed | undefined
 status: "replay" | "autonomous" | undefined
 ```
 
+## `resolveServiceUrl` (function)
+
+```ts
+resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
+```
+
+## `resolveToolUiCardContent` (function)
+
+```ts
+resolveToolUiCardContent: (card: ToolUiCard) => { type: ToolUiCardContentType; content: string; } | null
+```
+
 ## `ResultFeedback` (interface)
 
 ```ts
@@ -872,6 +1475,17 @@ result: unknown
 sessionId: string
 ```
 
+## `RunTiming` (interface)
+
+```ts
+duration_ms: number | null | undefined
+loop_id: string
+run_id: string
+scope: "chat" | "subagent"
+started_at: string | null | undefined
+status: "completed" | "paused" | "failed" | "cancelled" | "incomplete"
+```
+
 ## `RunTrace` (interface)
 
 ```ts
@@ -897,13 +1511,42 @@ SDK_VERSION: string
 
 ```ts
 askUserAnswer: Record<string, unknown> | undefined
+kbIds: number[] | undefined
 mode: string | undefined
 model: string | undefined
+queueWhenRunning: boolean | undefined
 replayDecision: "keep_replay" | "continue_replay" | undefined
 thinkingOverride: boolean | undefined
 whatif: { from_step: number; quotes: Array<Record<string, unknown>>; deprecate_entry_ids: string[]; } | undefined
 ```
 
+## `SessionComputer` (interface)
+
+```ts
+agent_runtimes: unknown[] | undefined
+allowed_paths: string[] | undefined
+arch: string | null | undefined
+blade_home: string | null | undefined
+created_at: string
+daemon_version: string | null | undefined
+enabled: boolean
+home: string | null | undefined
+hostname: string | null | undefined
+id: string
+is_primary: boolean
+label: string
+last_seen_at: string | null | undefined
+online: boolean
+os: string | null | undefined
+workspace: string | null | undefined
+```
+
+## `SessionComputerList` (interface)
+
+```ts
+computers: SessionComputer[]
+```
+
 ## `SessionConfig` (interface)
 
 ```ts
@@ -915,6 +1558,12 @@ memoryEnabled: boolean | undefined
 model: string | undefined
 ```
 
+## `SessionConnectOptions` (interface)
+
+```ts
+setup: ((session: AgentSession) => void) | undefined
+```
+
 ## `SessionContextStats` (interface)
 
 ```ts
@@ -935,14 +1584,18 @@ solution: SolutionDefinition | undefined
 ## `SessionDetail` (interface)
 
 ```ts
+agent_runtime_id: string | null | undefined
+ba_version: string | null | undefined
 biz_role_id: string | null | undefined
 bound_skill_id: string | null | undefined
+chat_group_id: string | null | undefined
 created_at: string
 daemon_id: string | null | undefined
 disable_tools: (string[] & string[]) | undefined
 enable_thinking: boolean | null | undefined
 env: Record<string, string> | undefined
 id: string
+initiator: "unknown" | "ui" | "sdk" | null | undefined
 intent: string
 is_example: boolean | undefined
 is_headless: boolean | undefined
@@ -959,6 +1612,7 @@ primary_skill_id: string | null | undefined
 primary_skill_snapshot: PrimarySkillSnapshot | null | undefined
 replay_state: ReplayState | null | undefined
 runtime_type: string | null | undefined
+sandbox_version: string | null | undefined
 shared: boolean | undefined
 solution: Solution | null | undefined
 solution_id: string | null | undefined
@@ -984,7 +1638,7 @@ tools_tokens: number | null | undefined
 ## `SessionHub` (class)
 
 ```ts
-connect: (sessionId: string) => Promise<AgentSession>
+connect: (sessionId: string, options?: SessionConnectOptions) => Promise<AgentSession>
 disconnect: () => void
 disposeAll: () => void
 getConnection: () => ConnectionStatus
@@ -1005,6 +1659,7 @@ SessionInfo = type({
   "shared?": "boolean",
   "memory_enabled?": "boolean",
   "is_persistent?": "boolean",
+  "initiator?": "'ui' | 'sdk' | 'unknown' | null",
   "is_headless?": "boolean",
   "viewer_role?": "'owner' | 'viewer'",
   "template_id?": "string | null",
@@ -1027,11 +1682,84 @@ SessionInfo = type({
   "disable_tools?": "string[]",
   "runtime_type?": "string | null",
   "daemon_id?": "string | null",
+  "agent_runtime_id?": "string | null",
   "workspace_path?": "string | null",
+  "ba_version?": "string | null",
+  "sandbox_version?": "string | null",
+  "chat_group_id?": "string | null",
   "match?": "unknown",
 })
 ```
 
+## `SessionPlugin` (interface)
+
+```ts
+active: boolean
+config: SessionPluginConfigSummary | undefined
+display_name: string | null | undefined
+icon: string | null | undefined
+installed: boolean | null
+name: string
+projected: boolean
+projection_source: string | null | undefined
+reason: string | null | undefined
+status: string
+```
+
+## `SessionPluginActivation` (type)
+
+```ts
+export type SessionPluginActivation = Pick<SessionPlugin, "name" | "active" | "status" | "reason">
+```
+
+## `SessionPluginConfigError` (interface)
+
+```ts
+message: string
+path: string
+```
+
+## `SessionPluginConfigSet` (interface)
+
+```ts
+path: string
+value: unknown
+```
+
+## `SessionPluginConfigState` (interface)
+
+```ts
+errors: SessionPluginConfigError[]
+reason: string | null
+revision: string | null
+schema: Record<string, unknown> | null
+state: SessionPluginConfigStateName
+values: Record<string, unknown>
+write_only: string[]
+```
+
+## `SessionPluginConfigStateName` (type)
+
+```ts
+export type SessionPluginConfigStateName = "not_required" | "required" | "configured" | "error"
+```
+
+## `SessionPluginConfigSummary` (type)
+
+```ts
+export type SessionPluginConfigSummary =
+  | SessionPluginConfigStateName
+  | "unchecked"
+```
+
+## `SessionPluginConfigUpdate` (interface)
+
+```ts
+expected_revision: string | null | undefined
+remove: string[] | undefined
+set: SessionPluginConfigSet[] | undefined
+```
+
 ## `SessionPortMapping` (interface)
 
 ```ts
@@ -1051,6 +1779,23 @@ model: string | undefined
 solution: SolutionRef | undefined
 ```
 
+## `SessionQueueSnapshot` (interface)
+
+```ts
+items: QueuedMessage[]
+pause_reason: string | null
+paused: boolean
+revision: number
+session_id: string
+```
+
+## `SessionSearchMatch` (interface)
+
+```ts
+field: "title" | "content"
+snippet: { role: string; text: string; } | null
+```
+
 ## `SessionSetupError` (class)
 
 ```ts
@@ -1072,6 +1817,7 @@ export type SessionSetupStage = "solution" | "session" | "skill" | "connection"
 
 ```ts
 attachAppCli: (sessionId: string, definition: AppCliDefinition) => Promise<AppCliAttachment>
+callMcpApp: (sessionId: string, sourceId: string, request: { request_id: string; name: string; arguments: Record<string, unknown>; }, init?: RequestInit) => Promise<{ response: Record<string, unknown>; replayed: boolean; }>
 checkoutSession: (sessionId: string, checkpointId: string, position: "before" | "turn_end", mode?: "both" | "conversation" | "code", linear?: boolean) => Promise<{ id: string; content: string; position: string; mode?: string; files_restored?: boolean; linear?: boolean; }>
 connect: (sessionId: string) => Promise<AgentSession>
 copyFile: (sessionId: string, filePath: string) => Promise<{ path: string; }>
@@ -1085,24 +1831,36 @@ deleteFile: (sessionId: string, filePath: string) => Promise<void>
 deleteSession: (sessionId: string, options?: { deleteWorkspace?: boolean; }) => Promise<{ deleted: boolean; workspace_deleted?: boolean; }>
 downloadFile: (sessionId: string, filePath: string, downloadName?: string) => Promise<void>
 exportSession: (sessionId: string) => Promise<void>
+fetchImage: (sessionId: string, assetId: string, preview?: boolean) => Promise<Blob>
+fetchSessionPluginIcon: (sessionId: string, name: string) => Promise<Blob>
+fetchSharedImage: (token: string, assetId: string, preview?: boolean) => Promise<Blob>
 getBackgroundTask: (sessionId: string, taskId: string, tail?: number, init?: RequestInit) => Promise<BackgroundTask>
 getDownloadDirUrl: (sessionId: string, dirPath: string) => string
+getMcpApp: (sessionId: string, sourceId: string, init?: RequestInit) => Promise<McpAppArchive>
+getMcpAppContext: (sessionId: string, sourceId: string, init?: RequestInit) => Promise<McpAppContextState>
 getReplayPreview: (sessionId: string) => Promise<ReplayPreview>
 getSession: (sessionId: string, init?: RequestInit) => Promise<SessionDetail>
 getSessionCheckpoints: (sessionId: string, init?: RequestInit) => Promise<{ nodes: CheckpointNode[]; leaf_id: string | null; }>
 getSessionContextStats: (sessionId: string, init?: RequestInit) => Promise<SessionContextStats>
 getSessionHistory: (sessionId: string, init?: RequestInit) => Promise<SessionHistory>
+getSessionPluginConfig: (sessionId: string, name: string, init?: RequestInit) => Promise<{ plugin: string; config: SessionPluginConfigState; }>
 getSessionTasks: (sessionId: string) => Promise<Task[]>
+getSessionTurnCommands: (sessionId: string) => Promise<HistoricalCommand[]>
+getSessionTurnIndex: (sessionId: string) => Promise<SessionTurnIndex>
 getSessionTurns: (sessionId: string) => Promise<TurnProjection[]>
+getSessionTurnsPage: (sessionId: string, options?: SessionTurnsQuery, init?: RequestInit) => Promise<SessionTurnsPage>
 getSharedSession: (token: string) => Promise<TurnProjection[]>
 importSession: (file: File, name?: string, solutionOverride?: string | null | ImportSessionOptions) => Promise<{ session_id: string; }>
 listBackgroundTasks: (sessionId: string, init?: RequestInit) => Promise<BackgroundTask[]>
-listDir: (sessionId: string, dirPath: string) => Promise<FileEntry[]>
+listDir: (sessionId: string, dirPath: string, showHidden?: boolean) => Promise<FileEntry[]>
 listResultFeedback: (sessionId: string) => Promise<ResultFeedback[]>
+listSessionPlugins: (sessionId: string, init?: RequestInit) => Promise<{ plugins: SessionPlugin[]; sync_version: number; sync_pending: boolean; }>
 listSessions: (template_id_prefix?: string, solution_id?: string) => Promise<SessionInfo[]>
-listSessionsPaginated: (params: { limit: number; offset: number; template_id_prefix?: string; solution_id?: string; solution_registry_id?: string; q?: string; }) => Promise<PaginatedSessionsResult>
+listSessionsPaginated: (params: { limit: number; offset: number; template_id_prefix?: string; solution_id?: string; solution_registry_id?: string; q?: string; chat_group_id?: string; }) => Promise<PaginatedSessionsResult>
 listSessionsWithSkillData: () => Promise<SkillDevSession[]>
+onMcpAppChanged: (sessionId: string, sourceId: string, listener: () => void) => () => void
 pinSession: (sessionId: string, pinned: boolean) => Promise<SessionInfo>
+prepareSessionPluginConfig: (sessionId: string, name: string, init?: RequestInit) => Promise<{ plugin: string; config: SessionPluginConfigState; }>
 previewImport: (file: File) => Promise<ImportPreview>
 probeSessionUrl: (sessionId: string, url: string) => Promise<{ reachable: boolean; requires_proxy: boolean; }>
 putResultFeedback: (sessionId: string, assistantEntryId: string, feedback: { helpful: boolean; reason?: ResultFeedbackReason | null; }) => Promise<ResultFeedback>
@@ -1110,16 +1868,20 @@ renameFile: (sessionId: string, filePath: string, newName: string) => Promise<{
 revokeShare: (sessionId: string, token: string) => Promise<{ revoked: boolean; }>
 rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; }>
 searchOwnedContent: (params: { q: string; limit?: number; }) => Promise<GlobalSearchResult>
+sessionPluginIconUrl: (sessionId: string, name: string) => string
 setSessionEnv: (sessionId: string, env: Record<string, string>) => Promise<SessionDetail>
+setSessionPluginActivation: (sessionId: string, name: string, active: boolean, init?: RequestInit) => Promise<{ plugin: SessionPluginActivation; sync_version: number; }>
 shareFile: (sessionId: string, sourcePath: string, linkName?: string, shareFolder?: string) => Promise<{ path: string; target: string; }>
 startReplaySession: (sourceSessionId: string, speed?: ReplaySpeed) => Promise<{ session_id: string; }>
 stopBackgroundTask: (sessionId: string, taskId: string) => Promise<BackgroundTaskStopResult>
 switchBranch: (sessionId: string, checkpointId: string) => Promise<{ id: string; leaf_id: string; }>
 tokenizeMessages: (messages: Array<Record<string, unknown>>, options?: { model?: string; add_generation_prompt?: boolean; enable_thinking?: boolean | null; tools?: Array<Record<string, unknown>>; }) => Promise<TokenizeResult>
 tokenizePrompt: (prompt: string, model?: string) => Promise<TokenizeResult>
+updateMcpAppContext: (sessionId: string, sourceId: string, body: McpAppContextUpdate, init?: RequestInit) => Promise<{ status: "accepted"; revision: string; }>
 updateReplaySession: (sessionId: string, payload: { speed?: ReplaySpeed; status?: "autonomous"; }) => Promise<{ replay_state: SessionInfo["replay_state"]; }>
-updateSession: (sessionId: string, payload: { intent?: string; }) => Promise<SessionDetail>
+updateSession: (sessionId: string, payload: { intent?: string; chat_group_id?: string | null; }) => Promise<SessionDetail>
 updateSessionMemory: (sessionId: string, memoryEnabled: boolean) => Promise<{ memory_enabled: boolean; }>
+updateSessionPluginConfig: (sessionId: string, name: string, update: SessionPluginConfigUpdate, init?: RequestInit) => Promise<{ plugin: string; config: SessionPluginConfigState; }>
 updateSharing: (sessionId: string, shared: boolean) => Promise<{ shared: boolean; }>
 uploadFiles: (sessionId: string, dirPath: string, files: FileList | File[] | UploadFileEntry[], options?: UploadFilesOptions) => Promise<{ uploaded: string[]; failed: string[]; }>
 writeFile: (sessionId: string, filePath: string, content: string) => Promise<{ success: boolean; }>
@@ -1134,8 +1896,11 @@ askAnswers: Record<string, AskUserAnswerData>
 connection: ConnectionStatus
 errorMessage: string | null
 isStreaming: boolean
+loadingOlder: boolean
 messages: ChatMessage[]
 mode: "planning" | "executing" | null
+nextBefore: string | null
+queue: SessionQueueSnapshot
 replay: ReplaySnapshot | null
 sessionId: string
 status: "completed" | "failed" | "interrupted" | "running" | "created" | "waiting_for_input" | null
@@ -1151,6 +1916,44 @@ SessionStatus = type(
 )
 ```
 
+## `SessionStatusEvent` (interface)
+
+```ts
+session_id: string
+status: string
+```
+
+## `SessionTurnIndex` (interface)
+
+```ts
+items: SessionTurnIndexItem[]
+sessionId: string
+```
+
+## `SessionTurnIndexItem` (interface)
+
+```ts
+createdAt: string | null
+entryId: string
+preview: string
+```
+
+## `SessionTurnsPage` (interface)
+
+```ts
+currentMode: "planning" | "executing"
+nextBefore: string | null
+turns: TurnProjection[]
+```
+
+## `SessionTurnsQuery` (interface)
+
+```ts
+before: string | undefined
+fromEntryId: string | undefined
+limit: number | undefined
+```
+
 ## `ShareLinkResult` (interface)
 
 ```ts
@@ -1159,13 +1962,53 @@ token: string
 url: string
 ```
 
+## `shouldApplySnapshot` (function)
+
+```ts
+shouldApplySnapshot: (current: SessionQueueSnapshot | undefined, next: SessionQueueSnapshot) => boolean
+```
+
+## `SiteVisitsResource` (class)
+
+```ts
+record: () => Promise<SiteVisitsSummary>
+summary: () => Promise<SiteVisitsSummary>
+```
+
+## `SiteVisitsSummary` (interface)
+
+```ts
+as_of: string
+date: string
+timezone: string
+today_pv: number
+today_uv: number
+total_pv: number
+```
+
 ## `SkillDefinition` (interface)
 
 ```ts
-files: TextFile[]
+files: SkillFile[]
 name: string
 ```
 
+## `SkillEditorTemplateId` (type)
+
+```ts
+export type SkillEditorTemplateId = "skill_editor"
+```
+
+## `SkillFile` (type)
+
+```ts
+export type SkillFile = TextFile & {
+  /** 二进制内容使用 base64；省略时为 UTF-8 文本。 */
+  encoding?: "utf-8" | "base64"
+  executable?: boolean
+}
+```
+
 ## `SkillMentionAvailability` (interface)
 
 ```ts
@@ -1243,6 +2086,18 @@ export type SolutionDefinition =
 export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 ```
 
+## `sortComputers` (function)
+
+```ts
+sortComputers: (computers: SessionComputer[]) => SessionComputer[]
+```
+
+## `SystemError` (interface)
+
+```ts
+message: string
+```
+
 ## `Task` (type)
 
 ```ts
@@ -1303,6 +2158,25 @@ action: string
 payload: unknown
 ```
 
+## `ToolCallArgumentsDelta` (interface)
+
+```ts
+arguments_delta: string
+function: { name: string; }
+id: string
+index: number
+loop_name: string | undefined
+```
+
+## `ToolCallCreated` (interface)
+
+```ts
+function: { name: string; arguments: string; }
+id: string
+index: number
+loop_name: string | undefined
+```
+
 ## `ToolCallInfo` (interface)
 
 ```ts
@@ -1316,6 +2190,60 @@ result: unknown
 status: "done" | "error" | "cancelled" | "awaiting_answer" | "pending" | undefined
 ```
 
+## `ToolCallProjection` (interface)
+
+```ts
+arguments: string
+display_name: string
+duration_ms: number | null | undefined
+id: string
+pending_question_ref: PendingQuestionRef | null | undefined
+ran_in_parallel: boolean | undefined
+result: unknown
+started_at: string | null | undefined
+status: string
+subagent_runs: RunTiming[] | undefined
+tool_name: string
+```
+
+## `ToolResultDelta` (interface)
+
+```ts
+content: string
+loop_name: string | undefined
+stream: "stdout" | "stderr" | undefined
+tool_call_id: string
+```
+
+## `ToolResultDone` (interface)
+
+```ts
+content: string
+function: { name: string; }
+loop_name: string | undefined
+tool_call_id: string
+```
+
+## `ToolUiCard` (interface)
+
+```ts
+archived: boolean | undefined
+height: number
+mcpApp: McpAppData | undefined
+resourceHTML: string | undefined
+resourceUri: string | undefined
+resourceURI: string | undefined
+sourcePath: string | undefined
+target: "inline" | "preview"
+title: string | undefined
+```
+
+## `ToolUiCardContentType` (type)
+
+```ts
+export type ToolUiCardContentType = "resource-html" | "resource-uri" | "resource-file"
+```
+
 ## `toReplaySnapshot` (function)
 
 ```ts
@@ -1336,13 +2264,26 @@ archived_files: ArchivedFileInfo[] | null | undefined
 archived_tool_calls: ArchivedToolCallInfo[] | null | undefined
 blocks: ContentBlock[]
 client_render_id: string | null | undefined
+client_request_id: string | null | undefined
 compaction_id: string | null | undefined
+context_action: ContextAction | null | undefined
+context_content: unknown
+context_key: string | null | undefined
+context_kind: string | null | undefined
+context_name: string | null | undefined
+context_order: number | null | undefined
+context_revision: string | null | undefined
 context_window: number | undefined
-duration_ms: number | undefined
+display_summary: string | null | undefined
+display_title: string | null | undefined
+duration_ms: number | null | undefined
 failure_reason: string | null | undefined
 fallback_applied: boolean | null | undefined
+first_token_delivery_ms: number | null | undefined
+first_token_ms: number | null | undefined
+has_reported_timing: boolean | undefined
 id: string
-kind: "message" | "compaction" | undefined
+kind: "message" | "context" | "compaction" | undefined
 loop_id: string
 memory_refs: MemoryRef[] | null | undefined
 model: string | null | undefined
@@ -1351,8 +2292,10 @@ post_chat_followup: PostChatFollowup | null | undefined
 role: "user" | "assistant" | "system"
 saved_ratio: number | null | undefined
 sequence: number
+sources: ContextSourceInfo[] | null | undefined
 started_at: string | null | undefined
 status: "streaming" | "completed" | "paused" | "failed" | "interrupted"
+stream_duration_ms: number | null | undefined
 summary_full: string | null | undefined
 summary_preview: string | null | undefined
 tokens_after: number | null | undefined