@blade-hq/agent-react 2610.0.0-beta.70 → 2610.0.0-beta.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blade-hq/agent-react",
-  "version": "2610.0.0-beta.70",
+  "version": "2610.0.0-beta.72",
   "description": "Blade Agent React 绑定：BladeProvider、useAgentSession、开箱即用的 ChatView 聊天界面。",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@blade-hq/agent-client": "2610.0.0-beta.70"
+    "@blade-hq/agent-client": "2610.0.0-beta.72"
   },
   "bundledDependencies": [],
   "peerDependencies": {

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 324 个公开声明。
+共 359 个公开声明。
 
 ## `acceptedPostChatFollowupCompletesLatestRun` (function)
 
@@ -100,6 +100,7 @@ toolCallId: string
 ```ts
 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>
@@ -111,8 +112,11 @@ 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
@@ -202,6 +206,24 @@ note: string | undefined
 selections: Record<number, number[]>
 ```
 
+## `AskUserQuestionData` (interface)
+
+```ts
+questions: QuestionItem[]
+source_loop: SourceLoopInfo | null | undefined
+```
+
+## `AskUserQuestionRendererProps` (interface)
+
+```ts
+answerData: AskUserAnswerData | undefined
+answered: boolean
+data: AskUserQuestionData
+onAnswer: ((answer: string, toolCallId: string, answerData: AskUserAnswerData) => void) | undefined
+sessionStatus: string
+toolCallId: string
+```
+
 ## `AsrAudioPayload` (type)
 
 ```ts
@@ -211,6 +233,15 @@ export type AsrAudioPayload =
   | { pcm: ArrayBuffer | Uint8Array; request_id?: string }
 ```
 
+## `AssistantTextRendererProps` (interface)
+
+```ts
+compact: boolean
+message: ChatMessage
+sessionId: string | undefined
+streaming: boolean
+```
+
 ## `AttachAppOptions` (interface)
 
 ```ts
@@ -396,6 +427,13 @@ function: { name: string; description?: string; parameters?: Record<string, unkn
 type: "function"
 ```
 
+## `ChatEnd` (interface)
+
+```ts
+duration_ms: number
+status: string
+```
+
 ## `chatErrorForDisplay` (function)
 
 ```ts
@@ -452,10 +490,34 @@ ChatView: (props: ChatViewProps) => JSX.Element
 ## `ChatViewClassNames` (interface)
 
 ```ts
+agentLoop: string | undefined
+askCard: string | undefined
+askOption: string | undefined
+assistantText: string | undefined
+assistantTurn: string | undefined
 banner: string | undefined
 chatInput: string | undefined
+empty: string | undefined
+errorBar: string | undefined
+errorMessage: string | undefined
+fileCard: string | undefined
+followup: string | undefined
+followupAction: string | undefined
+inputInner: string | undefined
+inputToolbar: string | undefined
+memoryRefs: string | undefined
 messageList: string | undefined
+messagesContent: string | undefined
+messagesScroll: string | undefined
+planPanel: string | undefined
+queuePanel: string | undefined
 root: string | undefined
+scrollToBottom: string | undefined
+textarea: string | undefined
+thinking: string | undefined
+toolRow: string | undefined
+userBubble: string | undefined
+userMessage: string | undefined
 ```
 
 ## `ChatViewProps` (interface)
@@ -481,7 +543,11 @@ theme: "light" | "dark" | undefined
 ## `ChatViewRenderers` (interface)
 
 ```ts
+askUserQuestion: ((props: AskUserQuestionRendererProps) => ReactNode | null) | undefined
+assistantText: ((props: AssistantTextRendererProps) => ReactNode | null) | undefined
+planUpdate: ((props: PlanUpdateRendererProps) => ReactNode | null) | undefined
 toolCall: ToolCallRenderer | undefined
+userMessage: ((props: UserMessageRendererProps) => ReactNode | null) | undefined
 ```
 
 ## `ChatViewSlots` (interface)
@@ -653,6 +719,13 @@ 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
@@ -1074,6 +1147,12 @@ direction: "host-to-agent"
 payload: unknown
 ```
 
+## `inferToolStatus` (function)
+
+```ts
+inferToolStatus: (resultStr: string) => "done" | "error" | "cancelled"
+```
+
 ## `InlineToolUiCardEntry` (interface)
 
 ```ts
@@ -1106,6 +1185,12 @@ isAppDevToolUiCard: (card: ToolUiCard, isAppDev: boolean) => boolean
 isCommandEnvelope: (value: unknown) => value is CommandEnvelope
 ```
 
+## `isEntryGoneError` (function)
+
+```ts
+isEntryGoneError: (error: unknown) => boolean
+```
+
 ## `isHiddenInternalMessage` (function)
 
 ```ts
@@ -1160,6 +1245,12 @@ isToolUiCard: (value: unknown) => value is ToolUiCard
 latestPostChatFollowup: (turns: TurnProjection[]) => PostChatFollowup | null
 ```
 
+## `latestUserSpeechEntryId` (function)
+
+```ts
+latestUserSpeechEntryId: (turns: TurnProjection[]) => string | null
+```
+
 ## `LayoutType` (enum)
 
 ```ts
@@ -1257,6 +1348,16 @@ baseURL: string | undefined
 model: string | undefined
 ```
 
+## `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
+```
+
 ## `LlmToolCall` (interface)
 
 ```ts
@@ -1386,7 +1487,7 @@ skill_name: string | null | undefined
 ## `MemoryRefsHint` (function)
 
 ```ts
-MemoryRefsHint: ({ refs }: { refs: MemoryRefInfo[]; }) => JSX.Element
+MemoryRefsHint: ({ refs, className }: { refs: MemoryRefInfo[]; className?: string; }) => JSX.Element
 ```
 
 ## `mergeConnectorItems` (function)
@@ -1510,6 +1611,14 @@ sequence: number
 turn_id: string
 ```
 
+## `PendingQuestionRef` (interface)
+
+```ts
+child_loop_name: string
+child_tool_call_id: string
+description: string | null | undefined
+```
+
 ## `pickCurrentPlanStep` (function)
 
 ```ts
@@ -1531,7 +1640,7 @@ export type PlanStepStatus = "pending" | "in_progress" | "completed"
 ## `PlanUpdateBlock` (function)
 
 ```ts
-PlanUpdateBlock: ({ toolCall, running, autoReveal, }: { toolCall: ToolCallInfo; running?: boolean; autoReveal?: boolean; }) => JSX.Element | null
+PlanUpdateBlock: ({ toolCall, running, autoReveal, className, }: { toolCall: ToolCallInfo; running?: boolean; autoReveal?: boolean; className?: string; }) => JSX.Element | null
 ```
 
 ## `PlanUpdateData` (interface)
@@ -1547,6 +1656,14 @@ current: ToolCallInfo | null
 updating: boolean
 ```
 
+## `PlanUpdateRendererProps` (interface)
+
+```ts
+plan: PlanUpdateData
+running: boolean
+sessionId: string | undefined
+```
+
 ## `PlatformEndpoints` (interface)
 
 ```ts
@@ -1715,6 +1832,21 @@ title: string
 version: number
 ```
 
+## `PrimarySkillStageSpec` (interface)
+
+```ts
+id: string
+name: string
+steps: PrimarySkillStepSpec[]
+```
+
+## `PrimarySkillStepSpec` (interface)
+
+```ts
+label: string
+n: number
+```
+
 ## `ProvidersResponse` (interface)
 
 ```ts
@@ -1939,6 +2071,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
@@ -2378,6 +2521,13 @@ revision: number
 session_id: string
 ```
 
+## `SessionSearchMatch` (interface)
+
+```ts
+field: "title" | "content"
+snippet: { role: string; text: string; } | null
+```
+
 ## `SessionSetupError` (class)
 
 ```ts
@@ -2426,8 +2576,9 @@ getSessionHistory: (sessionId: string, init?: RequestInit) => Promise<SessionHis
 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?: { limit?: number; before?: string; }) => Promise<SessionTurnsPage>
+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[]>
@@ -2495,6 +2646,28 @@ 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
@@ -2503,6 +2676,14 @@ nextBefore: string | null
 turns: TurnProjection[]
 ```
 
+## `SessionTurnsQuery` (interface)
+
+```ts
+before: string | undefined
+fromEntryId: string | undefined
+limit: number | undefined
+```
+
 ## `ShareLinkResult` (interface)
 
 ```ts
@@ -2542,6 +2723,12 @@ files: TextFile[]
 name: string
 ```
 
+## `SkillEditorTemplateId` (type)
+
+```ts
+export type SkillEditorTemplateId = "skill_editor"
+```
+
 ## `SkillMentionAvailability` (interface)
 
 ```ts
@@ -2625,6 +2812,12 @@ export type SolutionRef = ExistingSolutionRef | PreparedSolutionAsset
 sortComputers: (computers: SessionComputer[]) => SessionComputer[]
 ```
 
+## `SystemError` (interface)
+
+```ts
+message: string
+```
+
 ## `Task` (type)
 
 ```ts
@@ -2685,6 +2878,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
@@ -2698,12 +2910,46 @@ 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
+```
+
 ## `ToolCallRenderer` (type)
 
 ```ts
 export type ToolCallRenderer = (info: ToolCallInfo) => ReactNode | null
 ```
 
+## `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
@@ -2761,6 +3007,73 @@ total: number
 visible: Pick<PluginConnectorSelection, "name" | "iconSource" | "icon" | "displayName">[]
 ```
 
+## `TURN_NAV_HIGHLIGHT_CLASS` (const)
+
+```ts
+TURN_NAV_HIGHLIGHT_CLASS: "blade-turn-nav-flash"
+```
+
+## `TurnNavigationOptions` (interface)
+
+```ts
+beforeSeek: ((entryId: string) => void) | undefined
+cancelPendingLocate: (() => void) | undefined
+fallbackItems: TurnNavItem[] | undefined
+getLoadedEntryElement: (entryId: string) => HTMLElement | null
+isEntryLoaded: ((entryId: string) => boolean) | undefined
+loadTurnIndex: (() => Promise<SessionTurnIndexItem[]>) | undefined
+locateEntry: (entryId: string) => Promise<boolean>
+reloadKey: string | number | null | undefined
+revealEntry: ((entryId: string) => void) | undefined
+rewriteKey: string | number | null | undefined
+sessionId: string | null | undefined
+```
+
+## `TurnNavigationResult` (interface)
+
+```ts
+activeEntryId: string | null
+error: string | null
+failedEntryId: string | null
+items: TurnNavItem[]
+loadingEntryId: string | null
+selectEntry: (entryId: string) => void
+```
+
+## `TurnNavigationSource` (interface)
+
+```ts
+cancelPendingLocate: (() => void) | undefined
+fallbackItems: TurnNavItem[] | undefined
+loadTurnIndex: (() => Promise<SessionTurnIndexItem[]>) | undefined
+locateEntry: (entryId: string) => Promise<boolean>
+reloadKey: string | number | null | undefined
+rewriteKey: string | number | null | undefined
+```
+
+## `turnNavItemsFromMessages` (function)
+
+```ts
+turnNavItemsFromMessages: (messages: ChatMessage[]) => TurnNavItem[]
+```
+
+## `TurnNavRail` (function)
+
+```ts
+TurnNavRail: ({ items, activeTurnId, loadingTurnId, error, failedTurnId, onSelectTurn, }: TurnNavRailProps) => JSX.Element | null
+```
+
+## `TurnNavRailProps` (interface)
+
+```ts
+activeTurnId: string | null
+error: string | null | undefined
+failedTurnId: string | null | undefined
+items: TurnNavItem[]
+loadingTurnId: string | null | undefined
+onSelectTurn: (entryId: string) => void
+```
+
 ## `TurnProjection` (interface)
 
 ```ts
@@ -2940,6 +3253,12 @@ token: string
 username: string
 ```
 
+## `UserMessageRendererProps` (interface)
+
+```ts
+message: ChatMessage
+```
+
 ## `useSessionPluginActivation` (function)
 
 ```ts
@@ -2964,6 +3283,12 @@ retry: (item: PluginConnectorItem) => void
 toggle: (item: PluginConnectorItem, next: boolean) => void
 ```
 
+## `useTurnNavigation` (function)
+
+```ts
+useTurnNavigation: ({ sessionId, getLoadedEntryElement, isEntryLoaded, locateEntry, cancelPendingLocate, loadTurnIndex, fallbackItems, revealEntry, beforeSeek, reloadKey, rewriteKey, }: TurnNavigationOptions) => TurnNavigationResult
+```
+
 ## `useTypewriterReveal` (function)
 
 ```ts