@blade-hq/agent-client 2610.0.0-rc.0 → 2610.0.0

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 162 个公开声明。
+共 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,10 +135,10 @@ 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; }
+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; }
 ```
@@ -153,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
@@ -218,6 +282,7 @@ 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>
@@ -231,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>
@@ -245,6 +313,7 @@ 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
@@ -258,18 +327,71 @@ 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
@@ -300,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
@@ -332,10 +466,35 @@ 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>
 ```
 
@@ -367,12 +526,20 @@ 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
@@ -453,6 +620,7 @@ createInitialSessionState: (sessionId: string) => SessionState
 ```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
@@ -482,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)
@@ -513,6 +682,12 @@ iframe: HTMLIFrameElement | undefined
 EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
 ```
 
+## `EMPTY_SESSION_QUEUE` (const)
+
+```ts
+EMPTY_SESSION_QUEUE: SessionQueueSnapshot
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -647,6 +822,12 @@ groupAdjacentContextRuns: (kinds: readonly (string | null)[]) => readonly (reado
 groupMessagesByLoop: (messages: ChatMessage[]) => MessageGroup[]
 ```
 
+## `hasChatRunEvent` (function)
+
+```ts
+hasChatRunEvent: (events: RawEvent[]) => boolean
+```
+
 ## `HeadlessResource` (class)
 
 ```ts
@@ -655,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"
 ```
 
@@ -683,12 +873,44 @@ 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
@@ -701,6 +923,30 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">, option
 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
@@ -723,6 +969,23 @@ 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
@@ -752,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
@@ -841,6 +1147,12 @@ content: string
 label: string
 ```
 
+## `parseQueueAck` (function)
+
+```ts
+parseQueueAck: (response: unknown, fallbackSessionId: string) => QueueOperationResult
+```
+
 ## `PatchEnvelope` (interface)
 
 ```ts
@@ -851,6 +1163,14 @@ sequence: number
 turn_id: string
 ```
 
+## `PendingQuestionRef` (interface)
+
+```ts
+child_loop_name: string
+child_tool_call_id: string
+description: string | null | undefined
+```
+
 ## `PlatformEndpoints` (interface)
 
 ```ts
@@ -863,6 +1183,31 @@ services: Partial<Record<"os" | "hub" | "agent" | "oauth" | "llmGateway" | "gite
 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
@@ -893,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
@@ -913,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
@@ -928,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
@@ -935,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
@@ -981,6 +1423,12 @@ status: "replay" | "autonomous" | undefined
 resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
 ```
 
+## `resolveToolUiCardContent` (function)
+
+```ts
+resolveToolUiCardContent: (card: ToolUiCard) => { type: ToolUiCardContentType; content: string; } | null
+```
+
 ## `ResultFeedback` (interface)
 
 ```ts
@@ -1027,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
@@ -1055,6 +1514,7 @@ 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
@@ -1125,14 +1585,17 @@ solution: SolutionDefinition | undefined
 
 ```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
@@ -1149,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
@@ -1195,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",
@@ -1219,10 +1684,82 @@ SessionInfo = type({
   "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
@@ -1242,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
@@ -1263,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; }>
@@ -1276,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>
@@ -1301,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; }>
@@ -1325,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
@@ -1342,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
@@ -1350,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
@@ -1440,6 +2092,12 @@ export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 sortComputers: (computers: SessionComputer[]) => SessionComputer[]
 ```
 
+## `SystemError` (interface)
+
+```ts
+message: string
+```
+
 ## `Task` (type)
 
 ```ts
@@ -1500,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
@@ -1513,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
@@ -1533,6 +2264,7 @@ 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
@@ -1544,9 +2276,12 @@ context_revision: string | null | undefined
 context_window: number | undefined
 display_summary: string | null | undefined
 display_title: string | null | undefined
-duration_ms: number | 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" | "context" | "compaction" | undefined
 loop_id: string
@@ -1560,6 +2295,7 @@ 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