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

package/public-api.md

@@ -3,7 +3,7 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 137 个公开声明。
+共 159 个公开声明。
 
 ## `ActiveCompactionState` (interface)
 
@@ -24,6 +24,27 @@ 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
+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 +63,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 +73,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 +170,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>
@@ -260,6 +284,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
@@ -300,6 +331,9 @@ 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
+onLlmReady: ((handle: LlmChatHandle) => void) | undefined
 onSessionCreated: ((sessionId: string) => void) | undefined
 onSessionReady: ((session: AgentSession) => void) | undefined
 placeholder: string | undefined
@@ -433,6 +467,12 @@ path: string | undefined
 token: string | (() => string | null | undefined) | undefined
 ```
 
+## `DEFAULT_REPLAY_SPEED` (const)
+
+```ts
+DEFAULT_REPLAY_SPEED: ReplaySpeed
+```
+
 ## `EmbeddedChat` (interface)
 
 ```ts
@@ -450,10 +490,20 @@ allowedOrigins: string[]
 iframe: HTMLIFrameElement | undefined
 ```
 
-## `EMPTY_PLATFORM_ENDPOINTS` (const)
+## `ExchangeCodeParams` (interface)
 
 ```ts
-EMPTY_PLATFORM_ENDPOINTS: PlatformEndpoints
+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)
@@ -582,18 +632,86 @@ export enum LayoutType {
 }
 ```
 
-## `loadPlatformEndpoints` (function)
+## `LlmAdvancedSettings` (interface)
 
 ```ts
-loadPlatformEndpoints: (options?: LoadPlatformEndpointsOptions) => Promise<PlatformEndpoints>
+apiKey: boolean | undefined
+baseURL: boolean | undefined
+model: boolean | undefined
+storage: "local" | "memory" | undefined
+storageKey: string | undefined
 ```
 
-## `LoadPlatformEndpointsOptions` (interface)
+## `LlmChat` (function)
 
 ```ts
-baseUrl: string | undefined
+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
-timeoutMs: number | 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)
@@ -663,7 +781,9 @@ export type ModeId = "planning" | "executing"
 ## `ModelCatalog` (interface)
 
 ```ts
+baseUrl: string | undefined
 default: string
+defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -672,6 +792,7 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
+serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)
@@ -720,18 +841,6 @@ sequence: number
 turn_id: string
 ```
 
-## `PlatformEndpoints` (interface)
-
-```ts
-services: Partial<Record<"os" | "hub" | "agent" | "oauth" | "llmGateway" | "gitea", string>>
-```
-
-## `PlatformServiceName` (type)
-
-```ts
-export type PlatformServiceName = (typeof PLATFORM_SERVICE_NAMES)[number]
-```
-
 ## `PreparedSolution` (interface)
 
 ```ts
@@ -793,10 +902,76 @@ payload: Record<string, unknown>
 type: string
 ```
 
-## `resolveServiceUrl` (function)
+## `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
-resolveServiceUrl: (endpoints: PlatformEndpoints, name: PlatformServiceName, path?: string) => string | null
+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
 ```
 
 ## `RunOptions` (interface)
@@ -1035,6 +1210,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>
@@ -1056,12 +1232,12 @@ revokeShare: (sessionId: string, token: string) => Promise<{ revoked: boolean; }
 rewindSession: (sessionId: string, checkpointId: string) => Promise<{ id: string; content: string; }>
 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; }>
@@ -1080,9 +1256,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)
@@ -1108,6 +1286,13 @@ files: TextFile[]
 name: string
 ```
 
+## `SkillMentionAvailability` (interface)
+
+```ts
+installed: boolean | undefined
+local: boolean | undefined
+```
+
 ## `Solution` (interface)
 
 ```ts
@@ -1257,10 +1442,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)
@@ -1349,6 +1540,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