@blade-hq/agent-react 2610.0.0-beta.3 → 2610.0.0-beta.31

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 170 个公开声明。
+共 213 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -52,6 +52,12 @@ slots: ChatViewSlots | undefined
 theme: "light" | "dark" | undefined
 ```
 
+## `AgentComputerLaunchOutcome` (type)
+
+```ts
+export type AgentComputerLaunchOutcome = "pending" | "succeeded" | "failed" | "unknown"
+```
+
 ## `AgentLoopInfo` (interface)
 
 ```ts
@@ -155,6 +161,7 @@ tool_name: string | null | undefined
 
 ```ts
 custom: Record<number, string>
+note: string | undefined
 selections: Record<number, number[]>
 ```
 
@@ -239,6 +246,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
@@ -268,7 +276,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
 ```
@@ -292,6 +299,12 @@ client: BladeClient
 buildMessageContent: (text: string, attachments: Array<{ kind: "file"; name: string; uploadedPath?: string; textContent?: string | null; mimeType?: string; }>) => MessageContent
 ```
 
+## `canToggleComputer` (function)
+
+```ts
+canToggleComputer: (computer: SessionComputer) => boolean
+```
+
 ## `ChatCompletionTool` (interface)
 
 ```ts
@@ -299,12 +312,19 @@ function: { name: string; description?: string; parameters?: Record<string, unkn
 type: "function"
 ```
 
+## `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
@@ -312,6 +332,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
@@ -366,6 +387,12 @@ footer: ReactNode
 header: ReactNode
 ```
 
+## `classifyAgentComputerLaunchOutcome` (function)
+
+```ts
+classifyAgentComputerLaunchOutcome: (toolCall: { status?: string; result?: unknown; }) => AgentComputerLaunchOutcome
+```
+
 ## `ClientProjectionBuilder` (class)
 
 ```ts
@@ -375,6 +402,12 @@ reset: () => void
 seedSequence: (maxSeq: number) => void
 ```
 
+## `collectMemoryRefs` (function)
+
+```ts
+collectMemoryRefs: (messages: ChatMessage[]) => MemoryRefInfo[]
+```
+
 ## `CommandEnvelope` (interface)
 
 ```ts
@@ -407,6 +440,25 @@ tokens_before: number | null | undefined
 trigger: "auto" | "manual" | "forced_retry" | null | undefined
 ```
 
+## `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
@@ -435,6 +487,95 @@ 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"
+```
+
+## `ContextCard` (function)
+
+```ts
+ContextCard: ({ context, className }: ContextCardProps) => JSX.Element
+```
+
+## `ContextCardProps` (interface)
+
+```ts
+className: string | undefined
+context: ContextProjectionData
+```
+
+## `ContextDisplayState` (interface)
+
+```ts
+detail: string
+isRemoved: boolean
+summary: string
+title: string
+```
+
+## `ContextGroupCard` (function)
+
+```ts
+ContextGroupCard: ({ contexts, className }: ContextGroupCardProps) => JSX.Element | null
+```
+
+## `ContextGroupCardProps` (interface)
+
+```ts
+className: string | undefined
+contexts: readonly ContextProjectionData[]
+```
+
+## `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
@@ -444,6 +585,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
@@ -454,7 +596,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
@@ -499,6 +641,12 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
+## `EMPTY_PLATFORM_ENDPOINTS` (const)
+
+```ts
+EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -600,6 +748,18 @@ export type FollowupInteractionEvent =
       artifactKind: "file"
 ```
 
+## `getContextDisplayState` (function)
+
+```ts
+getContextDisplayState: (context: ContextProjectionData) => ContextDisplayState
+```
+
+## `getContextGroupDisplayState` (function)
+
+```ts
+getContextGroupDisplayState: (contexts: readonly ContextProjectionData[]) => ContextGroupDisplayState
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -654,6 +814,12 @@ export type GlobalSearchResultItem =
   | GlobalSearchFileResult
 ```
 
+## `groupAdjacentContextRuns` (function)
+
+```ts
+groupAdjacentContextRuns: (kinds: readonly (string | null)[]) => readonly (readonly number[])[]
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
@@ -696,6 +862,18 @@ direction: "host-to-agent"
 payload: unknown
 ```
 
+## `isAgentComputerCommand` (function)
+
+```ts
+isAgentComputerCommand: (command: string) => boolean
+```
+
+## `isAgentComputerToolCall` (function)
+
+```ts
+isAgentComputerToolCall: (argumentsJson: string | null | undefined) => boolean
+```
+
 ## `isCommandEnvelope` (function)
 
 ```ts
@@ -705,7 +883,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)
@@ -818,6 +996,20 @@ id: string
 name: string
 ```
 
+## `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
@@ -864,6 +1056,12 @@ id: number
 skill_name: string | null | undefined
 ```
 
+## `MemoryRefsHint` (function)
+
+```ts
+MemoryRefsHint: ({ refs }: { refs: MemoryRefInfo[]; }) => JSX.Element
+```
+
 ## `MessageContent` (type)
 
 ```ts
@@ -889,6 +1087,8 @@ baseUrl: string | undefined
 default: string
 defaultServiceModel: string | undefined
 models: ModelOption[]
+unavailableModelIds: string[] | undefined
+unavailableProviderIds: string[] | undefined
 ```
 
 ## `ModelOption` (interface)
@@ -905,6 +1105,12 @@ serviceModelId: string | undefined
 list: () => Promise<ModelCatalog>
 ```
 
+## `normalizeAdjacentUrlFormatting` (function)
+
+```ts
+normalizeAdjacentUrlFormatting: (value: string) => string
+```
+
 ## `normalizeMessageContent` (function)
 
 ```ts
@@ -935,6 +1141,20 @@ content: string
 label: string
 ```
 
+## `ParsedWhatIfPrompt` (interface)
+
+```ts
+fromStep: number | null
+quotes: WhatIfQuote[]
+userText: string
+```
+
+## `parseWhatIfPrompt` (function)
+
+```ts
+parseWhatIfPrompt: (text: string) => ParsedWhatIfPrompt | null
+```
+
 ## `PatchEnvelope` (interface)
 
 ```ts
@@ -945,6 +1165,18 @@ sequence: number
 turn_id: string
 ```
 
+## `PlatformEndpoints` (interface)
+
+```ts
+services: Partial<Record<"agent" | "os" | "hub" | "oauth" | "llmGateway" | "gitea" | "tile", string>>
+```
+
+## `PlatformServiceName` (type)
+
+```ts
+export type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]
+```
+
 ## `PostChatFollowup` (interface)
 
 ```ts
@@ -1017,6 +1249,12 @@ payload: Record<string, unknown>
 type: string
 ```
 
+## `reconcileOptimisticUserTurns` (function)
+
+```ts
+reconcileOptimisticUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
+```
+
 ## `ReplayBar` (function)
 
 ```ts
@@ -1089,6 +1327,12 @@ speed: ReplaySpeed | undefined
 status: "replay" | "autonomous" | undefined
 ```
 
+## `resolveServiceUrl` (function)
+
+```ts
+resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
+```
+
 ## `ResultFeedback` (interface)
 
 ```ts
@@ -1160,6 +1404,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
@@ -1167,6 +1412,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
@@ -1198,6 +1470,7 @@ solution: SolutionDefinition | undefined
 ## `SessionDetail` (interface)
 
 ```ts
+agent_runtime_id: string | null | undefined
 biz_role_id: string | null | undefined
 bound_skill_id: string | null | undefined
 created_at: string
@@ -1290,6 +1563,7 @@ SessionInfo = type({
   "disable_tools?": "string[]",
   "runtime_type?": "string | null",
   "daemon_id?": "string | null",
+  "agent_runtime_id?": "string | null",
   "workspace_path?": "string | null",
   "match?": "unknown",
 })
@@ -1506,6 +1780,12 @@ export type SolutionDefinition =
 export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 ```
 
+## `sortComputers` (function)
+
+```ts
+sortComputers: (computers: SessionComputer[]) => SessionComputer[]
+```
+
 ## `Task` (type)
 
 ```ts
@@ -1604,13 +1884,23 @@ archived_count: number | null | undefined
 archived_files: ArchivedFileInfo[] | null | undefined
 archived_tool_calls: ArchivedToolCallInfo[] | null | undefined
 blocks: ContentBlock[]
+client_render_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
 id: string
-kind: "message" | "compaction" | undefined
+kind: "message" | "context" | "compaction" | undefined
 loop_id: string
 memory_refs: MemoryRef[] | null | undefined
 model: string | null | undefined
@@ -1619,6 +1909,7 @@ 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"
 summary_full: string | null | undefined
@@ -1701,6 +1992,29 @@ send: (text: string) => Promise<boolean>
 stop: () => void
 ```
 
+## `useMessagePin` (function)
+
+```ts
+useMessagePin: ({ targetKey, pinTarget, layoutKey, getScrollElement, getContentElement, getTargetElement, getTargetScrollTop, getSpacerHeight, setSpacerHeight, stopAutoScroll, scrollToBottom, margin, }: UseMessagePinOptions) => { release: () => void; isActive: () => boolean; }
+```
+
+## `UseMessagePinOptions` (interface)
+
+```ts
+getContentElement: (() => HTMLElement | null) | undefined
+getScrollElement: () => HTMLElement | null
+getSpacerHeight: () => number
+getTargetElement: () => HTMLElement | null
+getTargetScrollTop: ((scroll: HTMLElement) => number | null) | undefined
+layoutKey: string | undefined
+margin: number | undefined
+pinTarget: boolean
+scrollToBottom: () => void
+setSpacerHeight: (height: number) => void
+stopAutoScroll: () => void
+targetKey: string | null
+```
+
 ## `useReplay` (function)
 
 ```ts
@@ -1735,3 +2049,24 @@ token: string
 username: string
 ```
 
+## `WhatIfQuote` (interface)
+
+```ts
+label: string
+snapshot: string
+stepNumber: number | null
+```
+
+## `WhatIfUserBubble` (function)
+
+```ts
+WhatIfUserBubble: ({ parsed, onQuoteClick }: WhatIfUserBubbleProps) => JSX.Element
+```
+
+## `WhatIfUserBubbleProps` (interface)
+
+```ts
+onQuoteClick: ((stepNumber: number) => void) | undefined
+parsed: ParsedWhatIfPrompt
+```
+