@blade-hq/agent-react 2610.0.0-beta.9 → 2610.0.0-rc.0

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 171 个公开声明。
+共 226 个公开声明。
 
 ## `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
@@ -111,7 +117,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; }
 ```
 
@@ -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
@@ -367,6 +387,12 @@ footer: ReactNode
 header: ReactNode
 ```
 
+## `classifyAgentComputerLaunchOutcome` (function)
+
+```ts
+classifyAgentComputerLaunchOutcome: (toolCall: { status?: string; result?: unknown; }) => AgentComputerLaunchOutcome
+```
+
 ## `ClientProjectionBuilder` (class)
 
 ```ts
@@ -376,6 +402,12 @@ reset: () => void
 seedSequence: (maxSeq: number) => void
 ```
 
+## `collectMemoryRefs` (function)
+
+```ts
+collectMemoryRefs: (messages: ChatMessage[]) => MemoryRefInfo[]
+```
+
 ## `CommandEnvelope` (interface)
 
 ```ts
@@ -408,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
@@ -436,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
@@ -445,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
@@ -455,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
@@ -477,6 +618,12 @@ path: string | undefined
 token: string | (() => string | null | undefined) | undefined
 ```
 
+## `CurrentPlanPanel` (function)
+
+```ts
+CurrentPlanPanel: ({ messages, running, revealRevision, sessionId, className, }: { messages: ChatMessage[]; running?: boolean; revealRevision?: number; sessionId?: string; className?: string; }) => JSX.Element | null
+```
+
 ## `DEFAULT_REPLAY_SPEED` (const)
 
 ```ts
@@ -500,6 +647,12 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
+## `EMPTY_PLATFORM_ENDPOINTS` (const)
+
+```ts
+EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
+```
+
 ## `ExchangeCodeParams` (interface)
 
 ```ts
@@ -601,6 +754,18 @@ export type FollowupInteractionEvent =
       artifactKind: "file"
 ```
 
+## `getContextDisplayState` (function)
+
+```ts
+getContextDisplayState: (context: ContextProjectionData) => ContextDisplayState
+```
+
+## `getContextGroupDisplayState` (function)
+
+```ts
+getContextGroupDisplayState: (contexts: readonly ContextProjectionData[]) => ContextGroupDisplayState
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -613,6 +778,12 @@ getFileParts: (content: MessageContent) => FileContentPart[]
 getImageParts: (content: MessageContent) => ImageUrlContentPart[]
 ```
 
+## `getPlanUpdateDisplayState` (function)
+
+```ts
+getPlanUpdateDisplayState: (messages: ChatMessage[]) => PlanUpdateDisplayState
+```
+
 ## `getTextContent` (function)
 
 ```ts
@@ -655,6 +826,12 @@ export type GlobalSearchResultItem =
   | GlobalSearchFileResult
 ```
 
+## `groupAdjacentContextRuns` (function)
+
+```ts
+groupAdjacentContextRuns: (kinds: readonly (string | null)[]) => readonly (readonly number[])[]
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
@@ -697,6 +874,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
@@ -706,7 +895,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)
@@ -715,6 +904,12 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boo
 isInboundEnvelope: (value: unknown) => value is InboundEnvelope
 ```
 
+## `isPlanUpdateTool` (function)
+
+```ts
+isPlanUpdateTool: (toolCall: Pick<ToolCallInfo, "name">) => boolean
+```
+
 ## `latestPostChatFollowup` (function)
 
 ```ts
@@ -819,6 +1014,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
@@ -865,6 +1074,12 @@ id: number
 skill_name: string | null | undefined
 ```
 
+## `MemoryRefsHint` (function)
+
+```ts
+MemoryRefsHint: ({ refs }: { refs: MemoryRefInfo[]; }) => JSX.Element
+```
+
 ## `MessageContent` (type)
 
 ```ts
@@ -890,6 +1105,8 @@ baseUrl: string | undefined
 default: string
 defaultServiceModel: string | undefined
 models: ModelOption[]
+unavailableModelIds: string[] | undefined
+unavailableProviderIds: string[] | undefined
 ```
 
 ## `ModelOption` (interface)
@@ -906,6 +1123,12 @@ serviceModelId: string | undefined
 list: () => Promise<ModelCatalog>
 ```
 
+## `normalizeAdjacentUrlFormatting` (function)
+
+```ts
+normalizeAdjacentUrlFormatting: (value: string) => string
+```
+
 ## `normalizeMessageContent` (function)
 
 ```ts
@@ -936,6 +1159,26 @@ content: string
 label: string
 ```
 
+## `ParsedWhatIfPrompt` (interface)
+
+```ts
+fromStep: number | null
+quotes: WhatIfQuote[]
+userText: string
+```
+
+## `parsePlanUpdate` (function)
+
+```ts
+parsePlanUpdate: (argumentsJson: string) => PlanUpdateData | null
+```
+
+## `parseWhatIfPrompt` (function)
+
+```ts
+parseWhatIfPrompt: (text: string) => ParsedWhatIfPrompt | null
+```
+
 ## `PatchEnvelope` (interface)
 
 ```ts
@@ -946,6 +1189,55 @@ sequence: number
 turn_id: string
 ```
 
+## `pickCurrentPlanStep` (function)
+
+```ts
+pickCurrentPlanStep: (plan: PlanUpdateData["plan"]) => PlanUpdateData["plan"][number] | null
+```
+
+## `PLAN_AUTO_COLLAPSE_MS` (const)
+
+```ts
+PLAN_AUTO_COLLAPSE_MS: 5000
+```
+
+## `PlanStepStatus` (type)
+
+```ts
+export type PlanStepStatus = "pending" | "in_progress" | "completed"
+```
+
+## `PlanUpdateBlock` (function)
+
+```ts
+PlanUpdateBlock: ({ toolCall, running, autoReveal, }: { toolCall: ToolCallInfo; running?: boolean; autoReveal?: boolean; }) => JSX.Element | null
+```
+
+## `PlanUpdateData` (interface)
+
+```ts
+plan: { step: string; status: PlanStepStatus; }[]
+```
+
+## `PlanUpdateDisplayState` (interface)
+
+```ts
+current: ToolCallInfo | null
+updating: boolean
+```
+
+## `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
@@ -1096,6 +1388,12 @@ speed: ReplaySpeed | undefined
 status: "replay" | "autonomous" | undefined
 ```
 
+## `resolveServiceUrl` (function)
+
+```ts
+resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
+```
+
 ## `ResultFeedback` (interface)
 
 ```ts
@@ -1167,6 +1465,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
@@ -1174,6 +1473,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
@@ -1185,6 +1511,12 @@ memoryEnabled: boolean | undefined
 model: string | undefined
 ```
 
+## `SessionConnectOptions` (interface)
+
+```ts
+setup: ((session: AgentSession) => void) | undefined
+```
+
 ## `SessionContextStats` (interface)
 
 ```ts
@@ -1205,6 +1537,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
@@ -1254,7 +1587,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
@@ -1297,11 +1630,33 @@ SessionInfo = type({
   "disable_tools?": "string[]",
   "runtime_type?": "string | null",
   "daemon_id?": "string | null",
+  "agent_runtime_id?": "string | null",
   "workspace_path?": "string | null",
   "match?": "unknown",
 })
 ```
 
+## `SessionMemoryToggle` (function)
+
+```ts
+SessionMemoryToggle: ({ sessionId, enabled, client: clientProp, disabled, label, className, labelClassName, inputClassName, onSaved, onError, }: SessionMemoryToggleProps) => JSX.Element
+```
+
+## `SessionMemoryToggleProps` (interface)
+
+```ts
+className: string | undefined
+client: BladeClient | undefined
+disabled: boolean | undefined
+enabled: boolean
+inputClassName: string | undefined
+label: string | undefined
+labelClassName: string | undefined
+onError: ((error: unknown) => void) | undefined
+onSaved: ((sessionId: string, enabled: boolean) => void) | undefined
+sessionId: string
+```
+
 ## `SessionPortMapping` (interface)
 
 ```ts
@@ -1513,6 +1868,12 @@ export type SolutionDefinition =
 export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 ```
 
+## `sortComputers` (function)
+
+```ts
+sortComputers: (computers: SessionComputer[]) => SessionComputer[]
+```
+
 ## `Task` (type)
 
 ```ts
@@ -1613,12 +1974,21 @@ 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
@@ -1627,6 +1997,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
@@ -1675,6 +2046,7 @@ useAgentSession: (sessionId?: string, options?: UseAgentSessionOptions) => UseAg
 
 ```ts
 createOptions: CreateSessionRequest | undefined
+onSessionConnected: ((session: AgentSession) => () => void) | undefined
 onSessionCreated: ((sessionId: string) => void) | undefined
 ```
 
@@ -1709,6 +2081,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
@@ -1743,3 +2138,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
+```
+