@blade-hq/agent-client 2610.0.0-beta.4 → 2610.0.0-beta.41

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 136 个公开声明。
+共 174 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -11,6 +11,12 @@
 acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
 ```
 
+## `acknowledgeTurnEvents` (function)
+
+```ts
+acknowledgeTurnEvents: (acknowledge?: () => void) => void
+```
+
 ## `ActiveCompactionState` (interface)
 
 ```ts
@@ -44,18 +50,23 @@ toolCallId: string
 append: (text: string) => void
 attach: (label: string, data: unknown) => void
 attachApp: (options: AttachAppOptions) => Promise<AppCliAttachment | null>
+cancelQueued: (id: number) => Promise<boolean>
 compact: () => Promise<Record<string, unknown>>
 countFiles: (dirPath?: string) => Promise<number>
 dispose: () => void
 downloadFile: (filePath: string, downloadName?: string) => Promise<void>
 exitReplay: () => Promise<void>
 getState: () => SessionState
+hasOlderHistory: boolean
 insertText: (text: string) => void
 isDisposed: boolean
 listDir: (dirPath?: string) => Promise<FileEntry[]>
+listQueue: () => Promise<Array<{ id: number; message: string; }>>
+loadOlderHistory: (options?: { beforeCommit?: () => void; }) => Promise<void>
 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
+queue: (content: string) => Promise<boolean>
 send: (content: MessageContent, options?: SendOptions) => Promise<boolean>
 sessionId: string
 setReplaySpeed: (speed: ReplaySpeed) => Promise<void>
@@ -89,7 +100,7 @@ sessionUpdated: { intent?: string; status?: SessionStatus; model?: string | 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; }
+toolResult: { toolCall: ToolCallInfo; turn: TurnProjection; source: "live" | "bootstrap_replay" | "reconnect_replay"; }
 workspaceChanged: { filePath?: string; }
 ```
 
@@ -133,6 +144,7 @@ tool_name: string | null | undefined
 
 ```ts
 custom: Record<number, string>
+note: string | undefined
 selections: Record<number, number[]>
 ```
 
@@ -217,6 +229,7 @@ statusText: string
 auth: AuthResource
 blob: (method: HttpMethod, path: string) => Promise<Blob>
 buildAuthedUrl: (path: string) => string
+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
@@ -246,7 +259,6 @@ baseUrl: string
 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 +269,25 @@ tokenStorage: TokenStorageMode | undefined
 buildMessageContent: (text: string, attachments: Array<{ kind: "file"; name: string; uploadedPath?: string; textContent?: string | null; mimeType?: string; }>) => MessageContent
 ```
 
+## `canToggleComputer` (function)
+
+```ts
+canToggleComputer: (computer: SessionComputer) => boolean
+```
+
+## `chatErrorForDisplay` (function)
+
+```ts
+chatErrorForDisplay: (message: string, developer?: boolean) => string
+```
+
 ## `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
@@ -270,6 +295,7 @@ loop_name: string | undefined
 memory_refs: MemoryRefInfo[] | undefined
 parent_id: string | null | undefined
 reasoning: string | undefined
+render_id: string | undefined
 role: "error" | "user" | "assistant" | "tool"
 status: "streaming" | "completed" | "paused" | "failed" | "interrupted" | undefined
 timestamp: string | undefined
@@ -317,6 +343,49 @@ 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>
+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
@@ -333,6 +402,7 @@ 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
@@ -345,6 +415,69 @@ type: "text" | "thinking" | "tool_use" | "tool_result" | "tool_ui" | "tool_bridg
 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
@@ -354,6 +487,7 @@ createInitialSessionState: (sessionId: string) => SessionState
 ## `CreateSessionRequest` (interface)
 
 ```ts
+agent_runtime_id: string | null | undefined
 biz_role_id: string | null | undefined
 compaction_ratio: number | null | undefined
 daemon_id: string | null | undefined
@@ -364,7 +498,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
@@ -409,6 +543,12 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
+## `EMPTY_PLATFORM_ENDPOINTS` (const)
+
+```ts
+EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -465,6 +605,18 @@ label: string
 target: string
 ```
 
+## `getContextDisplayState` (function)
+
+```ts
+getContextDisplayState: (context: ContextProjectionData) => ContextDisplayState
+```
+
+## `getContextGroupDisplayState` (function)
+
+```ts
+getContextGroupDisplayState: (contexts: readonly ContextProjectionData[]) => ContextGroupDisplayState
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -519,12 +671,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
@@ -533,6 +697,15 @@ 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
@@ -570,7 +743,7 @@ isCommandEnvelope: (value: unknown) => value is CommandEnvelope
 ## `isHiddenInternalMessage` (function)
 
 ```ts
-isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boolean
+isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">, options?: { includeLegacyForkContext?: boolean; }) => boolean
 ```
 
 ## `isInboundEnvelope` (function)
@@ -601,6 +774,27 @@ export enum LayoutType {
 }
 ```
 
+## `LiveRevisionState` (interface)
+
+```ts
+byTurnId: ReadonlyMap<string, number>
+current: number
+```
+
+## `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
@@ -657,6 +851,8 @@ baseUrl: string | undefined
 default: string
 defaultServiceModel: string | undefined
 models: ModelOption[]
+unavailableModelIds: string[] | undefined
+unavailableProviderIds: string[] | undefined
 ```
 
 ## `ModelOption` (interface)
@@ -713,6 +909,18 @@ sequence: number
 turn_id: string
 ```
 
+## `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]
+```
+
 ## `PostChatFollowup` (interface)
 
 ```ts
@@ -743,6 +951,12 @@ bizRoleId: string | undefined
 kind: "prepared"
 ```
 
+## `prependOlder` (function)
+
+```ts
+prependOlder: (current: TurnProjection[], page: TurnProjection[]) => TurnProjection[]
+```
+
 ## `PrimarySkillParallelMode` (interface)
 
 ```ts
@@ -785,6 +999,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
@@ -819,6 +1051,12 @@ speed: ReplaySpeed | undefined
 status: "replay" | "autonomous" | undefined
 ```
 
+## `resolveServiceUrl` (function)
+
+```ts
+resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
+```
+
 ## `ResultFeedback` (interface)
 
 ```ts
@@ -890,6 +1128,7 @@ SDK_VERSION: string
 
 ```ts
 askUserAnswer: Record<string, unknown> | undefined
+kbIds: number[] | undefined
 mode: string | undefined
 model: string | undefined
 replayDecision: "keep_replay" | "continue_replay" | undefined
@@ -897,6 +1136,33 @@ 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
@@ -908,6 +1174,12 @@ memoryEnabled: boolean | undefined
 model: string | undefined
 ```
 
+## `SessionConnectOptions` (interface)
+
+```ts
+setup: ((session: AgentSession) => void) | undefined
+```
+
 ## `SessionContextStats` (interface)
 
 ```ts
@@ -928,6 +1200,8 @@ 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
 created_at: string
@@ -952,6 +1226,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
@@ -977,7 +1252,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
@@ -1020,7 +1295,10 @@ 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",
   "match?": "unknown",
 })
 ```
@@ -1086,7 +1364,9 @@ getSessionCheckpoints: (sessionId: string, init?: RequestInit) => Promise<{ node
 getSessionContextStats: (sessionId: string, init?: RequestInit) => Promise<SessionContextStats>
 getSessionHistory: (sessionId: string, init?: RequestInit) => Promise<SessionHistory>
 getSessionTasks: (sessionId: string) => Promise<Task[]>
+getSessionTurnCommands: (sessionId: string) => Promise<HistoricalCommand[]>
 getSessionTurns: (sessionId: string) => Promise<TurnProjection[]>
+getSessionTurnsPage: (sessionId: string, options?: { limit?: number; before?: string; }) => 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[]>
@@ -1127,8 +1407,10 @@ askAnswers: Record<string, AskUserAnswerData>
 connection: ConnectionStatus
 errorMessage: string | null
 isStreaming: boolean
+loadingOlder: boolean
 messages: ChatMessage[]
 mode: "planning" | "executing" | null
+nextBefore: string | null
 replay: ReplaySnapshot | null
 sessionId: string
 status: "completed" | "failed" | "interrupted" | "running" | "created" | "waiting_for_input" | null
@@ -1144,6 +1426,14 @@ SessionStatus = type(
 )
 ```
 
+## `SessionTurnsPage` (interface)
+
+```ts
+currentMode: "planning" | "executing"
+nextBefore: string | null
+turns: TurnProjection[]
+```
+
 ## `ShareLinkResult` (interface)
 
 ```ts
@@ -1236,6 +1526,12 @@ export type SolutionDefinition =
 export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 ```
 
+## `sortComputers` (function)
+
+```ts
+sortComputers: (computers: SessionComputer[]) => SessionComputer[]
+```
+
 ## `Task` (type)
 
 ```ts
@@ -1328,13 +1624,26 @@ archived_count: number | null | undefined
 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
+display_summary: string | null | undefined
+display_title: string | null | undefined
 duration_ms: number | undefined
 failure_reason: string | null | undefined
 fallback_applied: boolean | null | undefined
+first_token_delivery_ms: number | null | undefined
+first_token_ms: number | null | undefined
 id: string
-kind: "message" | "compaction" | undefined
+kind: "message" | "context" | "compaction" | undefined
 loop_id: string
 memory_refs: MemoryRef[] | null | undefined
 model: string | null | undefined
@@ -1343,8 +1652,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