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

package/public-api.md

@@ -3,7 +3,13 @@
 > 本文件由 `scripts/public-api-report.mjs` 生成，请勿手改。
 > 公共面变更时重新生成本报告，并同步更新 README 对应章节——CI 会校验两者。
 
-共 117 个公开声明。
+共 137 个公开声明。
+
+## `acceptedPostChatFollowupCompletesLatestRun` (function)
+
+```ts
+acceptedPostChatFollowupCompletesLatestRun: (events: RawEvent[], updates: ProjectionUpdate[]) => boolean
+```
 
 ## `ActiveCompactionState` (interface)
 
@@ -42,6 +48,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 +58,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 +155,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 +246,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 +270,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
@@ -376,6 +387,12 @@ path: string | undefined
 token: string | (() => string | null | undefined) | undefined
 ```
 
+## `DEFAULT_REPLAY_SPEED` (const)
+
+```ts
+DEFAULT_REPLAY_SPEED: ReplaySpeed
+```
+
 ## `EmbeddedChat` (interface)
 
 ```ts
@@ -393,6 +410,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
@@ -425,6 +458,14 @@ path: string
 tags: string[] | undefined
 ```
 
+## `FinalArtifact` (interface)
+
+```ts
+kind: "link" | "file"
+label: string
+target: string
+```
+
 ## `getFileParts` (function)
 
 ```ts
@@ -443,6 +484,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
@@ -503,6 +580,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
@@ -571,7 +654,9 @@ export type ModeId = "planning" | "executing"
 ## `ModelCatalog` (interface)
 
 ```ts
+baseUrl: string | undefined
 default: string
+defaultServiceModel: string | undefined
 models: ModelOption[]
 ```
 
@@ -580,6 +665,7 @@ models: ModelOption[]
 ```ts
 id: string
 label: string
+serviceModelId: string | undefined
 ```
 
 ## `ModelsResource` (class)
@@ -628,6 +714,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
@@ -689,6 +786,71 @@ payload: Record<string, unknown>
 type: string
 ```
 
+## `reconcileOptimisticUserTurns` (function)
+
+```ts
+reconcileOptimisticUserTurns: (currentTurns: TurnProjection[], incomingTurns: TurnProjection[]) => TurnProjection[]
+```
+
+## `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
@@ -925,6 +1087,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>
@@ -935,23 +1098,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; }>
@@ -970,9 +1136,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)
@@ -998,6 +1166,13 @@ files: TextFile[]
 name: string
 ```
 
+## `SkillMentionAvailability` (interface)
+
+```ts
+installed: boolean | undefined
+local: boolean | undefined
+```
+
 ## `Solution` (interface)
 
 ```ts
@@ -1141,10 +1316,16 @@ result: unknown
 status: "done" | "error" | "cancelled" | "awaiting_answer" | "pending" | undefined
 ```
 
+## `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)
@@ -1154,6 +1335,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
@@ -1165,6 +1347,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