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

package/public-api.md

@@ -3,13 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 171 个公开声明。
-
-## `acceptedPostChatFollowupCompletesLatestRun` (function)
-
-```ts
-acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
-```
+共 137 个公开声明。
 
 ## `ActiveCompactionState` (interface)
 
@@ -30,28 +24,6 @@ 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
@@ -70,7 +42,6 @@ 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
@@ -80,7 +51,6 @@ 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
 ```
@@ -177,7 +147,6 @@ 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>
@@ -268,7 +237,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,13 +260,6 @@ 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
@@ -312,7 +273,6 @@ 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
@@ -340,10 +300,6 @@ 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
@@ -477,12 +433,6 @@ path: string | undefined
 token: string | (() => string | null | undefined) | undefined
 ```
 
-## `DEFAULT_REPLAY_SPEED` (const)
-
-```ts
-DEFAULT_REPLAY_SPEED: ReplaySpeed
-```
-
 ## `EmbeddedChat` (interface)
 
 ```ts
@@ -500,20 +450,10 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
-## `ExchangeCodeParams` (interface)
-
-```ts
-clientOrigin: string
-code: string
-state: string
-```
-
-## `ExchangeCodeResult` (interface)
+## `EMPTY_PLATFORM_ENDPOINTS` (const)
 
 ```ts
-access_token: string
-token_type: string
-user: { id: string; username: string; display_name: string; avatar_url: string | null; }
+EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
 ```
 
 ## `ExistingSolutionRef` (interface)
@@ -548,59 +488,6 @@ 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
@@ -619,42 +506,6 @@ 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
@@ -715,12 +566,6 @@ isHiddenInternalMessage: (message: Pick<ChatMessage, "role" | "content">) => boo
 isInboundEnvelope: (value: unknown) => value is InboundEnvelope
 ```
 
-## `latestPostChatFollowup` (function)
-
-```ts
-latestPostChatFollowup: (turns: TurnProjection[]) => PostChatFollowup | null
-```
-
 ## `LayoutType` (enum)
 
 ```ts
@@ -737,86 +582,18 @@ 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)
+## `loadPlatformEndpoints` (function)
 
 ```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
+loadPlatformEndpoints: (options?: LoadPlatformEndpointsOptions) => Promise<PlatformEndpoints>
 ```
 
-## `LlmChatProps` (interface)
+## `LoadPlatformEndpointsOptions` (interface)
 
 ```ts
-advanced: boolean | LlmAdvancedSettings | undefined
-apiKey: string | undefined
-baseURL: string
-classNames: ChatViewClassNames | undefined
-extraBody: Record<string, unknown> | undefined
+baseUrl: string | 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
+timeoutMs: number | undefined
 ```
 
 ## `LoginOptions` (interface)
@@ -886,9 +663,7 @@ export type ModeId = "planning" | "executing"
 ## `ModelCatalog` (interface)
 
 ```ts
-baseUrl: string | undefined
 default: string
-defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -897,7 +672,6 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
-serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)
@@ -946,15 +720,16 @@ sequence: number
 turn_id: string
 ```
 
-## `PostChatFollowup` (interface)
+## `PlatformEndpoints` (interface)
+
+```ts
+services: Partial<Record<"os" | "hub" | "agent" | "oauth" | "llmGateway" | "gitea", string>>
+```
+
+## `PlatformServiceName` (type)
 
 ```ts
-assistant_entry_id: string
-feedback_eligible: boolean
-feedback_scope: "latest_result"
-final_artifacts: FinalArtifact[] | undefined
-recaption: string | undefined
-suggestions: string[]
+export type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]
 ```
 
 ## `PreparedSolution` (interface)
@@ -1018,107 +793,10 @@ 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)
+## `resolveServiceUrl` (function)
 
 ```ts
-export type ResultFeedbackReason =
-  | "not_solved"
-  | "inaccurate"
-  | "incomplete"
-  | "needs_major_changes"
-  | "too_slow"
-  | "other"
+resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
 ```
 
 ## `RunOptions` (interface)
@@ -1357,7 +1035,6 @@ 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>
@@ -1368,26 +1045,23 @@ 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?: ReplaySpeed) => Promise<{ session_id: string; }>
+startReplaySession: (sourceSessionId: string, speed?: 1 | 2 | 5) => 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?: ReplaySpeed; status?: "autonomous"; }) => Promise<{ replay_state: SessionInfo["replay_state"]; }>
+updateReplaySession: (sessionId: string, payload: { speed?: 1 | 2 | 5; 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; }>
@@ -1406,11 +1080,9 @@ 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)
@@ -1436,13 +1108,6 @@ files: TextFile[]
 name: string
 ```
 
-## `SkillMentionAvailability` (interface)
-
-```ts
-installed: boolean | undefined
-local: boolean | undefined
-```
-
 ## `Solution` (interface)
 
 ```ts
@@ -1592,16 +1257,10 @@ 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, { local, installed }?: SkillMentionAvailability) => string
+transformSlashCommand: (skillName: string, rawInput: string) => string
 ```
 
 ## `TurnProjection` (interface)
@@ -1611,7 +1270,6 @@ 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
@@ -1623,7 +1281,6 @@ 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
@@ -1692,45 +1349,6 @@ 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/AgentChat.d.ts

@@ -1,21 +0,0 @@
-import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
-import { type ChatPresentationProps } from "./ChatSurface";
-import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
-export interface AgentChatProps extends ChatPresentationProps {
-    /** follow-up、成果和评分交互；SDK 不绑定任何分析厂商。 */
-    onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
-    /** 连接既有会话；不传则按 createOptions 自动新建。 */
-    sessionId?: string;
-    createOptions?: CreateSessionRequest;
-    /** 自动创建出的 sessionId 通过此回调交还调用方持有。 */
-    onSessionCreated?: (sessionId: string) => void;
-    /** 会话连接完成后回调（页面协作场景拿 AgentSession 实例用）。 */
-    onSessionReady?: (session: AgentSession) => void;
-    /** 智能体下发给宿主页面的指令处理器（action → handler）。 */
-    commands?: Record<string, (data: unknown) => void>;
-}
-/**
- * 智能体模式的聊天界面：连接（或新建）一个 Blade 会话，渲染消息流与输入框。
- * 状态全部来自 useAgentSession，不依赖任何全局 store。
- */
-export declare function AgentChat(props: AgentChatProps): import("react/jsx-runtime").JSX.Element;