@blade-hq/agent-react 2608.0.6 → 2608.0.7-beta.0

package/public-api.md

@@ -3,7 +3,13 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 131 个公开声明。
+共 171 个公开声明。
+
+## `acceptedPostChatFollowupCompletesLatestRun` (function)
+
+```ts
+acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
+```
 
 ## `ActiveCompactionState` (interface)
 
@@ -24,6 +30,28 @@ trigger: "auto" | "manual" | "forced_retry" | null | undefined
 turn_id: string
 ```
 
+## `AgentChat` (function)
+
+```ts
+AgentChat: (props: AgentChatProps) => JSX.Element
+```
+
+## `AgentChatProps` (interface)
+
+```ts
+classNames: ChatViewClassNames | undefined
+commands: Record<string, (data: unknown) => void> | undefined
+createOptions: CreateSessionRequest | undefined
+onFollowupInteraction: ((event: FollowupInteractionEvent) => void) | undefined
+onSessionCreated: ((sessionId: string) => void) | undefined
+onSessionReady: ((session: AgentSession) => void) | undefined
+placeholder: string | undefined
+renderers: ChatViewRenderers | undefined
+sessionId: string | undefined
+slots: ChatViewSlots | undefined
+theme: "light" | "dark" | undefined
+```
+
 ## `AgentLoopInfo` (interface)
 
 ```ts
@@ -42,6 +70,7 @@ compact: () => Promise<Record<string, unknown>>
 countFiles: (dirPath?: string) => Promise<number>
 dispose: () => void
 downloadFile: (filePath: string, downloadName?: string) => Promise<void>
+exitReplay: () => Promise<void>
 getState: () => SessionState
 insertText: (text: string) => void
 isDisposed: boolean
@@ -51,6 +80,7 @@ on: <K extends keyof AgentSessionEvents>(name: K, handler: (event: AgentSessionE
 onCommand: (action: string, handler: CommandHandler) => () => void
 send: (content: MessageContent, options?: SendOptions) => Promise<boolean>
 sessionId: string
+setReplaySpeed: (speed: ReplaySpeed) => Promise<void>
 stop: () => Promise<Record<string, unknown>>
 subscribe: (listener: () => void) => () => void
 ```
@@ -147,6 +177,7 @@ getContext: () => Record<string, unknown> | Promise<Record<string, unknown>>
 ## `AuthResource` (class)
 
 ```ts
+exchangeCode: (params: ExchangeCodeParams) => Promise<ExchangeCodeResult>
 getMe: () => Promise<UserInfo>
 getProviders: () => Promise<ProvidersResponse>
 login: (options?: LoginOptions) => Promise<LoginResult>
@@ -237,6 +268,7 @@ 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
 ```
@@ -260,6 +292,13 @@ client: BladeClient
 buildMessageContent: (text: string, attachments: Array<{ kind: "file"; name: string; uploadedPath?: string; textContent?: string | null; mimeType?: string; }>) => MessageContent
 ```
 
+## `ChatCompletionTool` (interface)
+
+```ts
+function: { name: string; description?: string; parameters?: Record<string, unknown>; }
+type: "function"
+```
+
 ## `ChatMessage` (interface)
 
 ```ts
@@ -273,6 +312,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
@@ -300,6 +340,10 @@ root: string | undefined
 classNames: ChatViewClassNames | undefined
 commands: Record<string, (data: unknown) => void> | undefined
 createOptions: CreateSessionRequest | undefined
+llm: (LlmChatOptions & { advanced?: boolean | LlmAdvancedSettings; onOverrideChange?: (override: LlmOverride) => void; }) | undefined
+mode: "agent" | "llm" | undefined
+onFollowupInteraction: ((event: FollowupInteractionEvent) => void) | undefined
+onLlmReady: ((handle: LlmChatHandle) => void) | undefined
 onSessionCreated: ((sessionId: string) => void) | undefined
 onSessionReady: ((session: AgentSession) => void) | undefined
 placeholder: string | undefined
@@ -433,6 +477,12 @@ path: string | undefined
 token: string | (() => string | null | undefined) | undefined
 ```
 
+## `DEFAULT_REPLAY_SPEED` (const)
+
+```ts
+DEFAULT_REPLAY_SPEED: ReplaySpeed
+```
+
 ## `EmbeddedChat` (interface)
 
 ```ts
@@ -450,6 +500,22 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
+## `ExchangeCodeParams` (interface)
+
+```ts
+clientOrigin: string
+code: string
+state: string
+```
+
+## `ExchangeCodeResult` (interface)
+
+```ts
+access_token: string
+token_type: string
+user: { id: string; username: string; display_name: string; avatar_url: string | null; }
+```
+
 ## `ExistingSolutionRef` (interface)
 
 ```ts
@@ -482,6 +548,59 @@ path: string
 tags: string[] | undefined
 ```
 
+## `FinalArtifact` (interface)
+
+```ts
+kind: "link" | "file"
+label: string
+target: string
+```
+
+## `FollowupInteractionEvent` (type)
+
+```ts
+export type FollowupInteractionEvent =
+  | {
+      type: "suggestions_shown"
+      sessionId?: string
+      assistantEntryId: string
+      count: number
+    }
+  | {
+      type: "suggestion_adopted"
+      sessionId?: string
+      assistantEntryId: string
+      suggestionIndex: number
+    }
+  | {
+      type: "artifact_shown"
+      sessionId?: string
+      assistantEntryId: string
+      artifactIndex: number
+      artifactKind: FinalArtifact["kind"]
+    }
+  | {
+      type: "artifact_opened"
+      sessionId?: string
+      assistantEntryId: string
+      artifactIndex: number
+      artifactKind: FinalArtifact["kind"]
+    }
+  | {
+      type: "artifact_download_started"
+      sessionId?: string
+      assistantEntryId: string
+      artifactIndex: number
+      artifactKind: "file"
+    }
+  | {
+      type: "artifact_download_succeeded"
+      sessionId?: string
+      assistantEntryId: string
+      artifactIndex: number
+      artifactKind: "file"
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -500,6 +619,42 @@ getImageParts: (content: MessageContent) => ImageUrlContentPart[]
 getTextContent: (content: MessageContent) => string
 ```
 
+## `GlobalSearchConversationResult` (interface)
+
+```ts
+matched: "title" | "content"
+session: SessionInfo
+snippet: string
+type: "conversation"
+```
+
+## `GlobalSearchFileResult` (interface)
+
+```ts
+matched: "name" | "path"
+name: string
+path: string
+session: SessionInfo
+snippet: string
+type: "file"
+```
+
+## `GlobalSearchResult` (interface)
+
+```ts
+indexing: boolean
+items: GlobalSearchResultItem[]
+truncated: boolean
+```
+
+## `GlobalSearchResultItem` (type)
+
+```ts
+export type GlobalSearchResultItem =
+  | GlobalSearchConversationResult
+  | GlobalSearchFileResult
+```
+
 ## `groupMessagesByLoop` (function)
 
 ```ts
@@ -560,6 +715,12 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boo
 isInboundEnvelope: (value: unknown) => value is InboundEnvelope
 ```
 
+## `latestPostChatFollowup` (function)
+
+```ts
+latestPostChatFollowup: (turns: TurnProjection[]) => PostChatFollowup | null
+```
+
 ## `LayoutType` (enum)
 
 ```ts
@@ -576,6 +737,88 @@ export enum LayoutType {
 }
 ```
 
+## `LlmAdvancedSettings` (interface)
+
+```ts
+apiKey: boolean | undefined
+baseURL: boolean | undefined
+model: boolean | undefined
+storage: "local" | "memory" | undefined
+storageKey: string | undefined
+```
+
+## `LlmChat` (function)
+
+```ts
+LlmChat: ({ classNames, renderers, slots, placeholder, theme, onReady, advanced, onOverrideChange, ...options }: LlmChatProps) => JSX.Element
+```
+
+## `LlmChatHandle` (interface)
+
+```ts
+insertText: (text: string) => void
+reset: () => void
+send: (text: string) => Promise<boolean>
+```
+
+## `LlmChatOptions` (interface)
+
+```ts
+apiKey: string | undefined
+baseURL: string
+extraBody: Record<string, unknown> | undefined
+fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
+headers: Record<string, string> | undefined
+historyTurns: number | undefined
+maxToolRounds: number | undefined
+model: string
+onToolCall: ((call: LlmToolCall) => Promise<unknown>) | undefined
+system: string | undefined
+temperature: number | undefined
+tools: ChatCompletionTool[] | undefined
+```
+
+## `LlmChatProps` (interface)
+
+```ts
+advanced: boolean | LlmAdvancedSettings | undefined
+apiKey: string | undefined
+baseURL: string
+classNames: ChatViewClassNames | undefined
+extraBody: Record<string, unknown> | undefined
+fetchImpl: { (input: RequestInfo | URL, init?: RequestInit): Promise<Response>; (input: string | URL | Request, init?: RequestInit): Promise<Response>; } | undefined
+headers: Record<string, string> | undefined
+historyTurns: number | undefined
+maxToolRounds: number | undefined
+model: string
+onOverrideChange: ((override: LlmOverride) => void) | undefined
+onReady: ((handle: LlmChatHandle) => void) | undefined
+onToolCall: ((call: LlmToolCall) => Promise<unknown>) | undefined
+placeholder: string | undefined
+renderers: ChatViewRenderers | undefined
+slots: ChatViewSlots | undefined
+system: string | undefined
+temperature: number | undefined
+theme: "light" | "dark" | undefined
+tools: ChatCompletionTool[] | undefined
+```
+
+## `LlmOverride` (interface)
+
+```ts
+apiKey: string | undefined
+baseURL: string | undefined
+model: string | undefined
+```
+
+## `LlmToolCall` (interface)
+
+```ts
+arguments: string
+id: string
+name: string
+```
+
 ## `LoginOptions` (interface)
 
 ```ts
@@ -643,7 +886,9 @@ export type ModeId = "planning" | "executing"
 ## `ModelCatalog` (interface)
 
 ```ts
+baseUrl: string | undefined
 default: string
+defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -652,6 +897,7 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
+serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)
@@ -700,6 +946,17 @@ sequence: number
 turn_id: string
 ```
 
+## `PostChatFollowup` (interface)
+
+```ts
+assistant_entry_id: string
+feedback_eligible: boolean
+feedback_scope: "latest_result"
+final_artifacts: FinalArtifact[] | undefined
+recaption: string | undefined
+suggestions: string[]
+```
+
 ## `PreparedSolution` (interface)
 
 ```ts
@@ -761,6 +1018,109 @@ payload: Record<string, unknown>
 type: string
 ```
 
+## `reconcileOptimisticUserTurns` (function)
+
+```ts
+reconcileOptimisticUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
+```
+
+## `ReplayBar` (function)
+
+```ts
+ReplayBar: ({ isReplay, speed, onSpeedChange, onExit, canControl, className, }: ReplayBarProps) => JSX.Element | null
+```
+
+## `ReplayBarProps` (interface)
+
+```ts
+canControl: boolean | undefined
+className: string | undefined
+isReplay: boolean
+onExit: () => void
+onSpeedChange: (speed: ReplaySpeed) => void
+speed: ReplaySpeed
+```
+
+## `ReplayMismatch` (interface)
+
+```ts
+actualMessage: string
+expectedMessage: string
+resolve: (decision: "keep_replay" | "continue_replay") => void
+```
+
+## `ReplayMismatchPrompt` (function)
+
+```ts
+ReplayMismatchPrompt: ({ mismatch, className }: ReplayMismatchPromptProps) => JSX.Element | null
+```
+
+## `ReplayMismatchPromptProps` (interface)
+
+```ts
+className: string | undefined
+mismatch: ReplayMismatch | null
+```
+
+## `ReplayPreview` (interface)
+
+```ts
+intent: string | null | undefined
+reason: string | null | undefined
+session_id: string
+supported: boolean
+```
+
+## `ReplaySnapshot` (interface)
+
+```ts
+isReplay: boolean
+sourceSessionId: string | null
+speed: ReplaySpeed
+```
+
+## `ReplaySpeed` (type)
+
+```ts
+export type ReplaySpeed = 1 | 2 | 5
+```
+
+## `ReplayState` (interface)
+
+```ts
+autonomous_reason: string | null | undefined
+ended_at: string | null | undefined
+next_source_entry_id: string | null | undefined
+source_session_id: string | undefined
+speed: ReplaySpeed | undefined
+status: "replay" | "autonomous" | undefined
+```
+
+## `ResultFeedback` (interface)
+
+```ts
+assistant_entry_id: string
+created_at: string
+helpful: boolean
+project_id: string | null
+reason: ResultFeedbackReason | null
+session_id: string
+surface: "unknown" | "chat" | "software_factory"
+updated_at: string
+```
+
+## `ResultFeedbackReason` (type)
+
+```ts
+export type ResultFeedbackReason =
+  | "not_solved"
+  | "inaccurate"
+  | "incomplete"
+  | "needs_major_changes"
+  | "too_slow"
+  | "other"
+```
+
 ## `RunOptions` (interface)
 
 ```ts
@@ -997,6 +1357,7 @@ downloadFile: (sessionId: string, filePath: string, downloadName?: string) => Pr
 exportSession: (sessionId: string) => Promise<void>
 getBackgroundTask: (sessionId: string, taskId: string, tail?: number, init?: RequestInit) => Promise<BackgroundTask>
 getDownloadDirUrl: (sessionId: string, dirPath: string) => string
+getReplayPreview: (sessionId: string) => Promise<ReplayPreview>
 getSession: (sessionId: string, init?: RequestInit) => Promise<SessionDetail>
 getSessionCheckpoints: (sessionId: string, init?: RequestInit) => Promise<{ nodes: CheckpointNode[]; leaf_id: string | null; }>
 getSessionContextStats: (sessionId: string, init?: RequestInit) => Promise<SessionContextStats>
@@ -1007,23 +1368,26 @@ 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[]>
 listDir: (sessionId: string, dirPath: string) => Promise<FileEntry[]>
+listResultFeedback: (sessionId: string) => Promise<ResultFeedback[]>
 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; }) => Promise<PaginatedSessionsResult>
 listSessionsWithSkillData: () => Promise<SkillDevSession[]>
 pinSession: (sessionId: string, pinned: boolean) => Promise<SessionInfo>
 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; }>
 revokeShare: (sessionId: string, token: string) => Promise<{ revoked: boolean; }>
 rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; }>
+searchOwnedContent: (params: { q: string; limit?: number; }) => Promise<GlobalSearchResult>
 setSessionEnv: (sessionId: string, env: Record<string, string>) => Promise<SessionDetail>
 shareFile: (sessionId: string, sourcePath: string, linkName?: string, shareFolder?: string) => Promise<{ path: string; target: string; }>
-startReplaySession: (sourceSessionId: string, speed?: 1 | 2 | 5) => Promise<{ session_id: string; }>
+startReplaySession: (sourceSessionId: string, speed?: ReplaySpeed) => Promise<{ session_id: string; }>
 stopBackgroundTask: (sessionId: string, taskId: string) => Promise<BackgroundTaskStopResult>
 switchBranch: (sessionId: string, checkpointId: string) => Promise<{ id: string; leaf_id: string; }>
 tokenizeMessages: (messages: Array<Record<string, unknown>>, options?: { model?: string; add_generation_prompt?: boolean; enable_thinking?: boolean | null; tools?: Array<Record<string, unknown>>; }) => Promise<TokenizeResult>
 tokenizePrompt: (prompt: string, model?: string) => Promise<TokenizeResult>
-updateReplaySession: (sessionId: string, payload: { speed?: 1 | 2 | 5; status?: "autonomous"; }) => Promise<{ replay_state: SessionInfo["replay_state"]; }>
+updateReplaySession: (sessionId: string, payload: { speed?: ReplaySpeed; status?: "autonomous"; }) => Promise<{ replay_state: SessionInfo["replay_state"]; }>
 updateSession: (sessionId: string, payload: { intent?: string; }) => Promise<SessionDetail>
 updateSessionMemory: (sessionId: string, memoryEnabled: boolean) => Promise<{ memory_enabled: boolean; }>
 updateSharing: (sessionId: string, shared: boolean) => Promise<{ shared: boolean; }>
@@ -1042,9 +1406,11 @@ errorMessage: string | null
 isStreaming: boolean
 messages: ChatMessage[]
 mode: "planning" | "executing" | null
+replay: ReplaySnapshot | null
 sessionId: string
 status: "completed" | "failed" | "interrupted" | "running" | "created" | "waiting_for_input" | null
 turns: TurnProjection[]
+viewerRole: "owner" | "viewer" | null
 ```
 
 ## `SessionStatus` (type)
@@ -1070,6 +1436,13 @@ files: TextFile[]
 name: string
 ```
 
+## `SkillMentionAvailability` (interface)
+
+```ts
+installed: boolean | undefined
+local: boolean | undefined
+```
+
 ## `Solution` (interface)
 
 ```ts
@@ -1219,10 +1592,16 @@ status: "done" | "error" | "cancelled" | "awaiting_answer" | "pending" | undefin
 export type ToolCallRenderer = (info: ToolCallInfo) => ReactNode | null
 ```
 
+## `toReplaySnapshot` (function)
+
+```ts
+toReplaySnapshot: (raw: ReplayState | null | undefined) => ReplaySnapshot | null
+```
+
 ## `transformSlashCommand` (function)
 
 ```ts
-transformSlashCommand: (skillName: string, rawInput: string) => string
+transformSlashCommand: (skillName: string, rawInput: string, { local, installed }?: SkillMentionAvailability) => string
 ```
 
 ## `TurnProjection` (interface)
@@ -1232,6 +1611,7 @@ 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_window: number | undefined
 duration_ms: number | undefined
@@ -1243,6 +1623,7 @@ loop_id: string
 memory_refs: MemoryRef[] | null | undefined
 model: string | null | undefined
 parent_fork_tool_call_id: string | null | undefined
+post_chat_followup: PostChatFollowup | null | undefined
 role: "user" | "assistant" | "system"
 saved_ratio: number | null | undefined
 sequence: number
@@ -1311,6 +1692,45 @@ state: SessionState | null
 useBladeClient: () => BladeClient
 ```
 
+## `useLlmChat` (function)
+
+```ts
+useLlmChat: (options: LlmChatOptions) => UseLlmChatResult
+```
+
+## `UseLlmChatResult` (interface)
+
+```ts
+error: string | null
+isStreaming: boolean
+messages: ChatMessage[]
+reset: () => void
+send: (text: string) => Promise<boolean>
+stop: () => void
+```
+
+## `useReplay` (function)
+
+```ts
+useReplay: (session: AgentSession | null) => UseReplayResult
+```
+
+## `UseReplayResult` (interface)
+
+```ts
+canControl: boolean
+canReplay: boolean
+error: Error | null
+exitToAutonomous: () => Promise<void>
+isReplay: boolean
+isStarting: boolean
+mismatch: ReplayMismatch | null
+setSpeed: (speed: ReplaySpeed) => Promise<void>
+speed: ReplaySpeed
+startReplay: (speed?: ReplaySpeed) => Promise<string>
+unsupportedReason: string | null
+```
+
 ## `UserInfo` (interface)
 
 ```ts

package/dist/components/FileCard.d.ts

@@ -1,16 +0,0 @@
-import { type ComponentPropsWithRef } from "react";
-import type { ExtraProps } from "streamdown";
-export type FileCardProps = ComponentPropsWithRef<"span"> & ExtraProps & {
-    "data-path"?: string;
-    "data-name"?: string;
-    dataPath?: string;
-    dataName?: string;
-    sessionId?: string;
-};
-/**
- * 智能体产出文件的下载链接（由 MEDIA 行折叠而来）。
- *
- * href 让 Vue/纯 HTML 宿主看到标准的「文件名→URL」语义；普通点击仍交给
- * downloadFile，避免跨域时 download 属性被忽略，也确保使用点击时的最新 token。
- */
-export declare function FileCard({ node, "data-path": pathAttribute, "data-name": nameAttribute, dataPath, dataName, sessionId, children, className, ...props }: FileCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/lib/media-tags.d.ts

@@ -1,24 +0,0 @@
-/**
- * MEDIA 行处理。后端提示词要求智能体产出文件时单独写一行 `MEDIA:<绝对路径>`
- * （见 host/src/blade_agent/host/orchestrator/prompt.py），界面必须把它折叠成文件下载链接——
- * 这是内部标记，直接摆给用户看就是 bug。
- */
-export declare const FILE_CARD_TAG = "blade-file-card";
-/**
- * 能不能拿这个路径去下载。绝对路径原样交给服务端解析（它会把工作区路径映射进沙盒、
- * 并拒绝越界），所以这里只挡明显不该放过的：空路径和 `..`。
- */
-export declare function isSafeMediaPath(path: string): boolean;
-/**
- * 把 MEDIA 行折叠成文件下载链接标签。
- *
- * `streaming` 时最后一行要特殊对待：MEDIA_LINE_RE 用 `$` 匹配行尾，而流式过程中最后一行
- * 随时都是「行尾」，逐 token 折叠会依次闪出 `MEDIA:`、半截路径的链接、再变成正确链接。
- * 所以正在写的那一行整行先不渲染，等它以换行结束、或消息转为 static 之后再折叠。
- *
- * 判据只能是 `streaming`，不能是「有没有尾随换行」：AssistantTurnBlock 传进来的文本是
- * trim 过的，静态消息永远没有尾随换行，那样判断会导致 MEDIA 行永远不折叠。
- */
-export declare function collapseMediaTags(text: string, options?: {
-    streaming?: boolean;
-}): string;