@blade-hq/agent-client 2612.0.0-beta.2 → 2612.0.0-beta.21

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 89 个公开声明。
+共 117 个公开声明。
 
 ## `AccountComputer` (interface)
 
@@ -62,6 +62,7 @@ deliverQueuedMessage: (itemId: string, expectedVersion: number) => Promise<Queue
 dispose: () => void
 downloadFile: (filePath: string, downloadName?: string) => Promise<void>
 exitReplay: () => Promise<void>
+getDelivery: (requestId: string) => Promise<DeliveryReceipt>
 getState: () => SessionState
 hasOlderHistory: boolean
 insertText: (text: string) => void
@@ -74,6 +75,7 @@ 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
+prepareSend: (content: string, options?: PreparedSendOptions) => PreparedSend
 queueMessage: (content: string) => Promise<QueueOperationResult>
 refreshQueue: () => Promise<QueueOperationResult>
 refreshRunningState: () => Promise<void>
@@ -81,6 +83,7 @@ reloadHistory: () => Promise<boolean>
 reorderQueuedMessages: (expectedRevision: number, orderedIds: string[]) => Promise<QueueOperationResult>
 resumeQueue: () => Promise<QueueOperationResult>
 send: (content: MessageContent, options?: SendOptions) => Promise<boolean>
+sendPrepared: (request: PreparedSend) => Promise<DeliveryReceipt>
 sessionId: string
 setReplaySpeed: (speed: ReplaySpeed) => Promise<void>
 stop: () => Promise<Record<string, unknown>>
@@ -120,7 +123,7 @@ 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: { workspacePath?: string; chatGroupId?: string | null; 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; replayState?: Record<string, unknown> | null; }
 taskListUpdated: { tasks: unknown[]; }
 toolCall: { toolCall: ToolCallInfo; turn: TurnProjection; }
 toolPreview: { sourcePath?: string; toolCallId: string; type: "resource-html" | "resource-uri" | "resource-file"; content: string; title: string; mcpApp?: McpAppData; }
@@ -165,7 +168,7 @@ getContext: () => Record<string, unknown> | Promise<Record<string, unknown>>
 
 ```ts
 exchangeCode: (params: ExchangeCodeParams) => Promise<ExchangeCodeResult>
-getMe: () => Promise<UserInfo>
+getMe: (options?: { signal?: AbortSignal; }) => Promise<UserInfo>
 getProviders: () => Promise<ProvidersResponse>
 login: (options?: LoginOptions) => Promise<LoginResult>
 logout: () => Promise<{ logout_url: string; }>
@@ -200,7 +203,9 @@ blob: (method: HttpMethod, path: string) => Promise<Blob>
 buildAuthedUrl: (path: string) => string
 chatGroups: ChatGroupsResource
 computers: ComputersResource
+connectToolProvider: (options: ToolProviderOptions) => ToolProvider
 fetch: (method: HttpMethod, path: string, init?: BladeFetchInit, isRetry?: boolean) => Promise<Response>
+forAnonymousSession: (sessionId: string) => BladeClient
 formData: (method: HttpMethod, path: string, form: FormData, options?: { expectOk?: boolean; onUploadProgress?: (progress: UploadProgress) => void; }) => Promise<Response>
 hasToken: () => boolean
 headless: HeadlessResource
@@ -228,9 +233,10 @@ token: string | null
 ## `BladeClientOptions` (interface)
 
 ```ts
+anonymousSessionId: string | undefined
 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
+commandTransport: ((event: string, payload: Record<string, unknown>, send: () => Promise<Record<string, unknown>>, scope?: { anonymousSessionId: string; }) => Promise<Record<string, unknown>>) | undefined
+fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
 onRefreshSuccess: (() => void | Promise<void>) | undefined
 socketToken: string | (() => string | null | undefined) | undefined
 token: string | (() => string | null | undefined) | undefined
@@ -243,13 +249,89 @@ tokenStorage: TokenStorageMode | undefined
 chatErrorForDisplay: (message: string, developer?: boolean) => string
 ```
 
+## `ChatGroup` (interface)
+
+```ts
+created_at: string
+id: string
+initiator: "ui" | "sdk" | null
+instructions: string
+member_count: number
+name: string
+role: ChatGroupRole
+session_count: number
+updated_at: string
+workspace_path: string
+```
+
+## `ChatGroupAsset` (interface)
+
+```ts
+is_dir: boolean
+message: string
+path: string
+session_id: string | null
+sha256: string
+size: number
+submitted_by: string
+submitted_by_name: string
+updated_at: string
+```
+
+## `ChatGroupAssetList` (interface)
+
+```ts
+group_id: string
+items: ChatGroupAsset[]
+```
+
+## `ChatGroupMember` (interface)
+
+```ts
+added_at: string
+added_by: string
+display_name: string | null
+role: ChatGroupRole
+user_id: string
+username: string
+```
+
+## `ChatGroupRole` (type)
+
+```ts
+export type ChatGroupRole = "owner" | "editor" | "viewer"
+```
+
+## `ChatGroupTask` (interface)
+
+```ts
+agent_started: boolean
+can_open_session: boolean
+created_at: string
+created_by: string
+description: string
+due_date: string | null
+group_id: string
+id: string
+number: number
+owner_display_name: string
+owner_left: boolean
+owner_user_id: string
+session_id: string | null
+status: "done" | "todo" | "doing"
+title: string
+updated_at: string
+```
+
 ## `ChatMessage` (interface)
 
 ```ts
 blocks: ContentBlock[] | undefined
+client_request_id: string | undefined
 compaction: CompactionInfo | undefined
 content: MessageContent
 context: ContextProjectionData | undefined
+context_attachments: ContextAttachment[] | undefined
 duration_ms: number | undefined
 entry_id: string | undefined
 kind: string | undefined
@@ -257,11 +339,13 @@ loop_name: string | undefined
 memory_refs: MemoryRefInfo[] | undefined
 parent_id: string | null | undefined
 reasoning: string | undefined
+refs: MessageRef[] | undefined
 render_id: string | undefined
 role: "error" | "user" | "assistant" | "tool"
 status: "streaming" | "completed" | "paused" | "failed" | "interrupted" | undefined
 timestamp: string | undefined
 tool_calls: ToolCallInfo[] | undefined
+topic_asset_refs: TopicAssetRef[] | undefined
 ```
 
 ## `CommandHandler` (type)
@@ -290,10 +374,31 @@ export type ConnectionStatus = "connecting" | "connected" | "reconnecting" | "di
 contentPreview: (content: MessageContent, maxLen?: number) => string
 ```
 
+## `ContextAttachment` (interface)
+
+```ts
+content: string
+data: Record<string, unknown> | null | undefined
+files: { name: string; session_id?: string; path?: string; }[] | undefined
+id: string
+label: string
+```
+
+## `CreateChatGroupTask` (interface)
+
+```ts
+description: string | undefined
+due_date: string | null | undefined
+owner_user_id: string
+start_agent: boolean | undefined
+title: string
+```
+
 ## `CreateSessionRequest` (interface)
 
 ```ts
 agent_runtime_id: string | null | undefined
+anonymous: boolean | undefined
 biz_role_id: string | null | undefined
 chat_group_id: string | null | undefined
 compaction_ratio: number | null | undefined
@@ -301,16 +406,17 @@ daemon_id: string | null | undefined
 disable_tools: string[] | null | undefined
 enable_thinking: boolean | null | undefined
 env: Record<string, string> | undefined
+initiator: "ui" | "sdk" | undefined
 intent: string | undefined
+mcp_sources: McpSourceConfig[] | undefined
 memory_enabled: boolean | null | undefined
 model: string | null | undefined
-primary_skill_id: string | null | undefined
 runtime_type: "sandbox" | "daemon" | "native" | null | undefined
 session_solution_asset_id: string | null | undefined
+skip_confirmations: boolean | undefined
 solution_id: string | undefined
 solution_ref: PublishedSolutionRef | undefined
 solution_snapshot_session_id: string | undefined
-template_id: TemplateId | undefined
 ```
 
 ## `DEFAULT_REPLAY_SPEED` (const)
@@ -319,6 +425,17 @@ template_id: TemplateId | undefined
 DEFAULT_REPLAY_SPEED: ReplaySpeed
 ```
 
+## `DeliveryReceipt` (interface)
+
+```ts
+executionId: string | null | undefined
+itemId: string | undefined
+message: string | undefined
+queueStatus: string | undefined
+requestId: string
+status: "unknown" | "accepted" | "not_found" | "rejected"
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -407,6 +524,18 @@ token: string
 user: { id?: string; username?: string; display_name?: string; } | undefined
 ```
 
+## `McpSourceConfig` (interface)
+
+```ts
+bearer_token: string | null | undefined
+description: string | undefined
+eager_tools: string[] | undefined
+exposure: "lazy" | "eager" | undefined
+id: string
+include_tools: string[] | null | undefined
+url: string
+```
+
 ## `MemoryRefInfo` (interface)
 
 ```ts
@@ -427,6 +556,12 @@ export type MessageContent = string | MessageContentPart[]
 export type MessageContentPart = TextContentPart | ImageUrlContentPart | FileContentPart
 ```
 
+## `MessageRef` (type)
+
+```ts
+export type MessageRef = PluginRef | SkillRef
+```
+
 ## `ModelCatalog` (interface)
 
 ```ts
@@ -441,15 +576,18 @@ unavailableProviderIds: string[] | undefined
 ## `ModelOption` (interface)
 
 ```ts
+defaultReasoningLevel: string | undefined
 id: string
 label: string
+reasoningLevels: string[] | undefined
 serviceModelId: string | undefined
+thinkingAvailable: boolean | undefined
 ```
 
 ## `ModelsResource` (class)
 
 ```ts
-list: () => Promise<ModelCatalog>
+list: (options?: { signal?: AbortSignal; }) => Promise<ModelCatalog>
 ```
 
 ## `MountHandle` (interface)
@@ -478,6 +616,24 @@ mount: (target: HTMLElement, data: T) => MountResult<T>
 export type MountResult<T> = undefined | (() => void) | MountHandle<T>
 ```
 
+## `normalizeMessageRefs` (function)
+
+```ts
+normalizeMessageRefs: (value: unknown) => MessageRef[]
+```
+
+## `normalizePluginRefs` (function)
+
+```ts
+normalizePluginRefs: (value: unknown) => PluginRef[]
+```
+
+## `normalizeTopicAssetRefs` (function)
+
+```ts
+normalizeTopicAssetRefs: (value: unknown) => TopicAssetRef[]
+```
+
 ## `PaginatedSessionsResult` (interface)
 
 ```ts
@@ -488,6 +644,35 @@ offset: number
 total: number
 ```
 
+## `PluginRef` (interface)
+
+```ts
+id: string
+label: string
+plugin: string
+provider: "plugin"
+server: string
+```
+
+## `PreparedSend` (interface)
+
+```ts
+content: string
+options: PreparedSendOptions
+requestId: string
+sessionId: string
+```
+
+## `PreparedSendOptions` (interface)
+
+```ts
+contextAttachments: ContextAttachment[] | undefined
+mode: "planning" | "executing" | undefined
+model: string | undefined
+reasoningLevel: "max" | "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined
+thinkingOverride: boolean | undefined
+```
+
 ## `ProvidersResponse` (interface)
 
 ```ts
@@ -495,6 +680,23 @@ password_enabled: boolean
 providers: { name: string; authorize_url: string; }[]
 ```
 
+## `ProviderTool` (interface)
+
+```ts
+description: string | undefined
+handler: (arguments_: Record<string, unknown>, context: { sessionId: string; signal: AbortSignal; }) => Promise<ProviderToolResult>
+inputSchema: Record<string, unknown>
+name: string
+```
+
+## `ProviderToolResult` (interface)
+
+```ts
+content: { type: "text"; text: string; }[]
+isError: boolean | undefined
+structuredContent: Record<string, unknown> | undefined
+```
+
 ## `QueuedMessage` (interface)
 
 ```ts
@@ -596,13 +798,15 @@ SDK_VERSION: string
 
 ```ts
 askUserAnswer: Record<string, unknown> | undefined
-kbIds: number[] | undefined
+contextAttachments: ContextAttachment[] | undefined
 mode: string | undefined
 model: string | undefined
 queueWhenRunning: boolean | undefined
 reasoningLevel: string | undefined
+refs: MessageRef[] | undefined
 replayDecision: "keep_replay" | "continue_replay" | undefined
 thinkingOverride: boolean | undefined
+topicAssetRefs: TopicAssetRef[] | undefined
 whatif: { from_step: number; quotes: Array<Record<string, unknown>>; deprecate_entry_ids: string[]; } | undefined
 ```
 
@@ -638,6 +842,15 @@ memoryEnabled: boolean | undefined
 model: string | undefined
 ```
 
+## `SessionConfiguration` (interface)
+
+```ts
+configuration: { solution_identity: Record<string, unknown> | null; solution_version: string | null; biz_role_id: string | null; biz_role_version: string | null; model: string | null; enable_thinking: boolean | null; memory_enabled: boolean; env: Record<string, string>; disable_tools: string[]; mcp_sources: Omit<McpSourceConfig, "bearer_token">[]; skip_confirmations: boolean; compaction_ratio: number | null; }
+revision: number
+session_id: string
+version: string | null
+```
+
 ## `SessionDefinition` (interface)
 
 ```ts
@@ -651,9 +864,9 @@ solution: SolutionDefinition | undefined
 
 ```ts
 agent_runtime_id: string | null | undefined
+anonymous: boolean | 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
@@ -674,8 +887,6 @@ pinned_at: string | null | undefined
 plan_summary: string | null | undefined
 ports: SessionPortMapping[] | undefined
 preview_url: string | null | undefined
-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
@@ -684,7 +895,6 @@ solution: Solution | null | undefined
 solution_id: string | null | undefined
 solution_ref: PublishedSolutionRef | null | undefined
 status: "completed" | "failed" | "interrupted" | "running" | "created" | "waiting_for_input"
-template_id: TemplateId | null | undefined
 updated_at: string
 viewer_role: "owner" | "viewer" | undefined
 workspace_path: string | null | undefined
@@ -700,12 +910,12 @@ SessionInfo = type({
   created_at: "string",
   updated_at: "string",
   "shared?": "boolean",
+  "anonymous?": "boolean",
   "memory_enabled?": "boolean",
   "is_persistent?": "boolean",
   "initiator?": "'ui' | 'sdk' | 'unknown' | null",
   "is_headless?": "boolean",
   "viewer_role?": "'owner' | 'viewer'",
-  "template_id?": "string | null",
   "model?": "string | null",
   "enable_thinking?": "boolean | null",
   "solution_id?": "string | null",
@@ -713,10 +923,6 @@ SessionInfo = type({
   "biz_role_id?": "string | null",
   "solution?": "unknown",
   "plan_summary?": "string | null",
-  "primary_skill_id?": "string | null",
-  // ship-attack v2：后端 engine.set_bound_skill 写入的"绑定 skill id"。
-  // 未绑定 / 非 ship-attack session 为 null。
-  "bound_skill_id?": "string | null",
   "replay_state?": "unknown",
   "is_pinned?": "boolean",
   "pinned_at?": "string | null",
@@ -766,15 +972,16 @@ 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; }>
+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; history_committed?: boolean; file_checkpoint_cleanup_failed?: boolean; warning?: string; }>
 connect: (sessionId: string) => Promise<AgentSession>
 copyFile: (sessionId: string, filePath: string) => Promise<{ path: string; }>
 countFiles: (sessionId: string, dirPath?: string) => Promise<number>
 create: (request?: CreateSessionRequest | SessionDefinition) => Promise<AgentSession>
-createSession: (intent?: string, template_id?: TemplateId, primary_skill_id?: string | null) => Promise<{ session_id: string; }>
+createSession: (intent?: string) => Promise<{ session_id: string; }>
 createSessionWithRequest: (request: CreateSessionRequest) => Promise<{ session_id: string; }>
 createShare: (sessionId: string) => Promise<ShareLinkResult>
 createWithProfile: (params: { intent: string; profile: SessionProfile; }) => Promise<{ session_id: string; }>
+deleteAnonymousSession: (sessionId: string) => Promise<{ deleted: boolean; }>
 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>
@@ -789,9 +996,10 @@ getMcpAppContext: (sessionId: string, sourceId: string, init?: RequestInit) => P
 getReplayPreview: (sessionId: string) => Promise<ReplayPreview>
 getSession: (sessionId: string, init?: RequestInit) => Promise<SessionDetail>
 getSessionCheckpoints: (sessionId: string, init?: RequestInit) => Promise<{ nodes: CheckpointNode[]; leaf_id: string | null; }>
+getSessionConfiguration: (sessionId: string, init?: RequestInit) => Promise<SessionConfiguration>
 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; }>
+getSessionPluginConfig: (sessionId: string, name: string, init?: RequestInit, scope?: "personal" | "global") => Promise<{ plugin: string; config: SessionPluginConfigState; can_configure_global?: boolean; host?: SessionPluginHostState | null; }>
 getSessionTasks: (sessionId: string) => Promise<Task[]>
 getSessionTurnCommands: (sessionId: string) => Promise<HistoricalCommand[]>
 getSessionTurnIndex: (sessionId: string) => Promise<SessionTurnIndex>
@@ -799,12 +1007,13 @@ 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; }>
+listAnonymousSessions: () => Promise<Array<{ id: string; intent: string; created_at: string; status: string; }>>
 listBackgroundTasks: (sessionId: string, init?: RequestInit) => Promise<BackgroundTask[]>
 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; chat_group_id?: string; }) => Promise<PaginatedSessionsResult>
+listSessions: (solution_id?: string) => Promise<SessionInfo[]>
+listSessionsPaginated: (params: { limit: number; offset: number; 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>
@@ -813,8 +1022,9 @@ 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>
 renameFile: (sessionId: string, filePath: string, newName: string) => Promise<{ path: string; }>
+restartSessionPluginHost: (sessionId: string, name: string) => Promise<{ host: SessionPluginHostState | null; }>
 revokeShare: (sessionId: string, token: string) => Promise<{ revoked: boolean; }>
-rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; }>
+rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; history_committed?: boolean; file_checkpoint_cleanup_failed?: boolean; warning?: string; }>
 searchOwnedContent: (params: { q: string; limit?: number; }) => Promise<GlobalSearchResult>
 sessionPluginIconUrl: (sessionId: string, name: string) => string
 setSessionEnv: (sessionId: string, env: Record<string, string>) => Promise<SessionDetail>
@@ -828,8 +1038,9 @@ 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; chat_group_id?: string | null; }) => Promise<SessionDetail>
+updateSessionConfiguration: (sessionId: string, request: UpdateSessionConfigurationRequest) => Promise<SessionConfiguration>
 updateSessionMemory: (sessionId: string, memoryEnabled: boolean) => Promise<{ memory_enabled: boolean; }>
-updateSessionPluginConfig: (sessionId: string, name: string, update: SessionPluginConfigUpdate, init?: RequestInit) => Promise<{ plugin: string; config: SessionPluginConfigState; }>
+updateSessionPluginConfig: (sessionId: string, name: string, update: SessionPluginConfigUpdate, init?: RequestInit, scope?: "personal" | "global") => 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[]; results: Array<{ index: number; path?: string; error?: string; }>; }>
 writeFile: (sessionId: string, filePath: string, content: string) => Promise<{ success: boolean; }>
@@ -908,6 +1119,14 @@ installed: boolean | undefined
 local: boolean | undefined
 ```
 
+## `SkillRef` (interface)
+
+```ts
+id: string
+label: string
+provider: "skill"
+```
+
 ## `SolutionDefinition` (type)
 
 ```ts
@@ -945,17 +1164,91 @@ export type TokenStorageMode = "local" | "memory"
 arguments: string
 display_name: string | null | undefined
 duration_ms: number | null | undefined
+evidence: ToolEvidence[] | undefined
 id: string
 name: string
 pending_question_ref: PendingQuestionRef | null | undefined
 result: unknown
 status: "done" | "error" | "cancelled" | "awaiting_answer" | "pending" | undefined
+workflow_steps: WorkflowStepInfo[] | null | undefined
+```
+
+## `ToolEvidence` (interface)
+
+```ts
+branch: string
+digest: string
+id: string
+loop: string
+n: number
+parent_tool_call_id: string | undefined
+plugin: string
+server: string
+source: string
+text: string
+title: string
+tool_call_id: string
+url: string | undefined
+```
+
+## `ToolProvider` (class)
+
+```ts
+dispose: () => void
+ready: () => Promise<void>
+reconnect: () => void
+url: string
+```
+
+## `ToolProviderOptions` (interface)
+
+```ts
+capability: string
+onError: ((error: Error) => void) | undefined
+providerId: string
+tools: ProviderTool[]
+```
+
+## `TopicAssetRef` (interface)
+
+```ts
+path: string
+topic_id: string
 ```
 
 ## `transformSlashCommand` (function)
 
 ```ts
-transformSlashCommand: (skillName: string, rawInput: string, { local, installed }?: SkillMentionAvailability) => string
+transformSlashCommand: (skillName: string, rawInput: string, _availability?: SkillMentionAvailability) => string
+```
+
+## `UpdateChatGroupTask` (interface)
+
+```ts
+description: string | undefined
+due_date: string | null | undefined
+owner_user_id: string | undefined
+status: "done" | "todo" | "doing" | undefined
+title: string | undefined
+```
+
+## `UpdateSessionConfigurationRequest` (interface)
+
+```ts
+biz_role_id: string | undefined
+compaction_ratio: number | null | undefined
+disable_tools: string[] | undefined
+enable_thinking: boolean | null | undefined
+env: Record<string, string> | undefined
+expected_revision: number | undefined
+mcp_sources: McpSourceConfig[] | undefined
+memory_enabled: boolean | undefined
+model: string | undefined
+session_solution_asset_id: string | undefined
+skip_confirmations: boolean | undefined
+solution_id: string | undefined
+solution_ref: PublishedSolutionRef | undefined
+version: string
 ```
 
 ## `UploadFileEntry` (type)
@@ -1000,8 +1293,10 @@ username: string
 
 ```ts
 export type WorkflowRunEntry =
-  | { kind: "step"; stepId: string; desc: string; stepKind: string }
-  | { kind: "log"; text: string }
+  /** status:步骤终态(done / error / cancelled);落史与直播的终态更新都会带上。 */
+  | { kind: "step"; stepId: string; desc: string; stepKind: string; status?: string }
+  /** stepId:这行属于哪一步。并行分支的输出不按宣告顺序到达,不能按位置归到上一步。 */
+  | { kind: "log"; text: string; stepId?: string }
 ```
 
 ## `WorkflowRunState` (interface)
@@ -1013,3 +1308,15 @@ status: "running" | "done" | "error" | "cancelled"
 toolCallId: string
 ```
 
+## `WorkflowStepInfo` (interface)
+
+```ts
+desc: string | undefined
+log_seq: number | undefined
+output: string | undefined
+seq: number | undefined
+status: string | undefined
+step_id: string
+step_kind: string | undefined
+```
+