@blade-hq/agent-client 2610.0.1 → 2612.0.0-beta.1

package/dist/embed/mount-renderer.d.ts

@@ -0,0 +1,50 @@
+import type { ChatMessage, ToolCallInfo } from "../schemas/message";
+/**
+ * 挂载式渲染器：SDK 给一个 DOM 节点和这个区块的数据，由宿主自己把内容挂上去
+ * （Vue 组件、原生 DOM 都行），不需要 React。
+ *
+ * - 返回清理函数：数据变化时 SDK 先清理再重新挂载，区块卸载时清理。
+ * - 返回 `{ update, destroy }`：数据变化时调用 `update` 原地更新，区块卸载时调用 `destroy`。
+ */
+export type MountResult<T> = undefined | (() => void) | MountHandle<T>;
+export interface MountHandle<T> {
+    update?(data: T): void;
+    destroy(): void;
+}
+export interface MountRendererObject<T> {
+    /** 返回 false 时这个区块走 SDK 默认渲染；不写等于全部接管。 */
+    match?(data: T): boolean;
+    mount(target: HTMLElement, data: T): MountResult<T>;
+}
+/** 直接写函数等于 `{ mount }`：接管这一类区块的全部实例。 */
+export type MountRenderer<T> = MountRendererObject<T> | ((target: HTMLElement, data: T) => MountResult<T>);
+/**
+ * `<blade-chat>` 元素的 `renderers` 属性（JS 属性，不是 HTML 属性）：
+ *
+ * ```js
+ * chat.renderers = {
+ *   toolCall: {
+ *     match: ({ toolCall }) => toolCall.name === "draw_chart",
+ *     mount(target, { toolCall }) { target.textContent = toolCall.arguments; return () => {} },
+ *   },
+ * }
+ * ```
+ */
+export interface BladeChatMountRenderers {
+    /** 工具调用卡片。 */
+    toolCall?: MountRenderer<{
+        toolCall: ToolCallInfo;
+        sessionId?: string;
+    }>;
+    /** 用户消息气泡。 */
+    userMessage?: MountRenderer<{
+        message: ChatMessage;
+    }>;
+    /** 助手正文；`compact` 为真时正文在执行过程里。 */
+    assistantText?: MountRenderer<{
+        message: ChatMessage;
+        streaming: boolean;
+        compact: boolean;
+        sessionId?: string;
+    }>;
+}

package/dist/index.d.ts

@@ -1,72 +1,29 @@
 export { BladeClient } from "./blade-client";
 export type { BladeClientOptions, UploadProgress } from "./blade-client";
 export { BladeApiError } from "./rest";
-export { isEntryGoneError } from "./resources/sessions";
-export { PollingBackoff } from "./polling-backoff";
 export type { LoginOptions, LoginResult, TokenStorageMode } from "./auth-login";
-export { EMPTY_PLATFORM_ENDPOINTS, loadPlatformEndpoints, resolveServiceUrl, } from "./platform-endpoints";
-export type { LoadPlatformEndpointsOptions, PlatformEndpoints, PlatformServiceName, } from "./platform-endpoints";
 export { SDK_NAME, SDK_VERSION } from "./version";
 export { AgentSession } from "./session/agent-session";
 export type { AttachAppOptions, SendOptions } from "./session/agent-session";
 export { AgentSessionError } from "./session/errors";
-export { SessionHub } from "./session/hub";
-export type { SessionConnectOptions } from "./session/hub";
 export type { AgentSessionEvents, AgentSessionEventName } from "./session/events";
-export { isMcpAppData } from "./schemas/mcp-app";
-export type { McpAppArchive, McpAppContextState, McpAppContextUpdate, McpAppData, } from "./schemas/mcp-app";
+export type { WorkflowRunEntry, WorkflowRunState } from "./session/workflow";
+export type { ActiveCompactionState, AgentLoopInfo, AskUserAnswerData, ConnectionStatus, ReplaySnapshot, SessionState, } from "./session/state";
 export { SessionSetupError } from "./session/definition";
-export type { SessionConfig, SessionDefinition, SessionSetupStage, SkillDefinition, SkillFile, TextFile, SolutionDefinition, } from "./session/definition";
-export { createInitialSessionState, reconcileHistoricalUserTurns, reconcileOptimisticUserTurns, toReplaySnapshot, } from "./session/state";
-export type { AskUserAnswerData, AgentLoopInfo, ActiveCompactionState, ConnectionStatus, ReplaySnapshot, SessionState, } from "./session/state";
-export { EMPTY_SESSION_QUEUE, canCancelQueuedMessage, canDeliverQueuedMessage, canEditQueuedMessage, isSessionQueueSnapshot, parseQueueAck, queuePauseReasonLabel, queuedMessageStatusLabel, shouldApplySnapshot, } from "./session/queue";
-export type { QueueAck, QueueOperationResult, QueuedMessage, QueuedMessageStatus, SessionQueueSnapshot, } from "./session/queue";
-export { connectEmbedded } from "./commands/embedded";
-export type { EmbeddedChat, EmbeddedChatOptions } from "./commands/embedded";
+export type { SessionConfig, SessionDefinition, SessionSetupStage, SkillDefinition, SkillFile, SolutionDefinition, TextFile, } from "./session/definition";
+export type { QueuedMessage, QueuedMessageStatus, QueueOperationResult, SessionQueueSnapshot, } from "./session/queue";
 export type { CommandHandler } from "./commands/registry";
-export type { CommandEnvelope, InboundAction, InboundEnvelope } from "./commands/protocol";
-export { isCommandEnvelope, isInboundEnvelope } from "./commands/protocol";
+export type { BladeChatMountRenderers, MountHandle, MountRenderer, MountRendererObject, MountResult, } from "./embed/mount-renderer";
 export type { AuthResource, ExchangeCodeParams, ExchangeCodeResult, ProvidersResponse, UserInfo, } from "./resources/auth";
 export type { HeadlessResource } from "./resources/headless";
-export { ComputersResource } from "./resources/computers";
-export { canToggleComputer, computerDaemonVersion, computerOS, computerPlatformLabel, computerState, sortComputers, } from "./resources/computers";
-export type { AccountComputer, AccountComputerList, ComputerOS, ComputerState, SessionComputer, SessionComputerList, } from "./resources/computers";
-export { ModelsResource } from "./resources/models";
-export type { ModelCatalog, ModelOption } from "./resources/models";
-export type { SessionsResource } from "./resources/sessions";
-export type { SessionPlugin, SessionPluginActivation } from "./resources/sessions";
-export type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState, SessionPluginConfigStateName, SessionPluginConfigSummary, SessionPluginConfigUpdate, } from "./resources/sessions";
-export { ChatGroupsResource } from "./resources/chat-groups";
-export type { ChatGroup } from "./resources/chat-groups";
-export { PluginsResource } from "./resources/plugins";
-export type { PluginCatalogEntry } from "./resources/plugins";
-export type { SiteVisitsResource, SiteVisitsSummary } from "./resources/site-visits";
-export { hasChatRunEvent } from "./shared/projection";
-export type { CreateSessionRequest, AppCliAttachment, AppCliDefinition, FileEntry, ImportSessionOptions, PaginatedSessionsResult, GlobalSearchConversationResult, GlobalSearchFileResult, GlobalSearchResult, GlobalSearchResultItem, ResultFeedback, ResultFeedbackReason, HistoricalCommand, SessionContextStats, SessionHistory, SessionTurnsPage, SessionTurnsQuery, SessionTurnIndex, SessionTurnIndexItem, ShareLinkResult, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
-export type { ArchivedFileInfo, ArchivedToolCallInfo, ChatMessage, CompactionInfo, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolBridgeContent, ToolCallInfo, } from "./schemas/message";
-export { inferToolStatus } from "./schemas/message";
-export type { ChatEnd, ContentDelta, LlmResponseDone, SessionStatusEvent, SystemError, ToolCallArgumentsDelta, ToolCallCreated, ToolResultDelta, ToolResultDone, } from "./schemas/event";
-export { buildMessageContent, chatErrorForDisplay, contentPreview, extractTextAttachments, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, isHiddenInternalMessage, isBackgroundWakeMessage, normalizeMessageContent, transformSlashCommand, } from "./schemas/message-utils";
-export { contextProjectionData, getContextDisplayState, getContextGroupDisplayState, groupAdjacentContextRuns, } from "./schemas/context";
-export type { ContextAction, ContextDisplayState, ContextGroupDisplayState, ContextProjectionData, ContextProjectionFields, ContextSourceInfo, } from "./schemas/context";
-export type { ParsedTextAttachment, ParsedTextContext, SkillMentionAvailability, } from "./schemas/message-utils";
-export type { ContentBlock, FinalArtifact, MemoryRef, PatchEnvelope, PendingQuestionRef, PostChatFollowup, RunTiming, ToolCallProjection, TurnProjection, } from "./schemas/projection";
-export { latestPostChatFollowup } from "./schemas/projection-utils";
-export { buildToolUiCardKey, collectInlineToolUiCards, collectPreviewToolUiCards, isAppDevToolUiCard, isInternalStatusToolUiCard, isToolUiCard, resolveToolUiCardContent, } from "./shared/tool-ui-card";
-export type { InlineToolUiCardEntry, PreviewToolUiCardEntry, ToolUiCard, ToolUiCardContentType, } from "./shared/tool-ui-card";
-export { prependOlder, replaceWindow } from "./session/history-page";
-export type { LiveRevisionState } from "./session/history-page";
-export { DEFAULT_REPLAY_SPEED } from "./schemas/session";
-export { SessionInfo, SessionStatus } from "./schemas/session";
-export type { ModeId, PrimarySkillParallelMode, PrimarySkillSnapshot, PrimarySkillStageSpec, PrimarySkillStepSpec, PublishedSolutionRef, ReplayPreview, ReplaySpeed, ReplayState, SessionDetail, SessionPortMapping, SessionSearchMatch, SkillEditorTemplateId, TemplateId, } from "./schemas/session";
-export { LayoutType } from "./schemas/solution";
-export type { BizRole, Solution, SolutionAppField, SolutionAppState, SolutionAppUiConfig, } from "./schemas/solution";
-export { Task, TaskStatus } from "./schemas/task";
-export type { BackgroundTask, BackgroundTaskStopResult } from "./schemas/background";
-export { acceptedPostChatFollowupCompletesLatestRun, acknowledgeTurnEvents, ClientProjectionBuilder, } from "./shared/projection";
-export type { RawEvent } from "./shared/projection";
-export { AuthBusyReconnect, authBusyRetryDelayMs } from "./shared/auth-busy";
-export { createSocket } from "./socket";
-export type { CreateSocketOptions, TypedSocket } from "./socket";
-export type { AsrAudioPayload } from "./types/socket-events";
-export type * from "./types/sdk-profile";
+export type { RunOptions, RunResult, RunTrace } from "./types/sdk-profile";
+export type { ModelsResource, ModelCatalog, ModelOption } from "./resources/models";
+export type { ComputersResource } from "./resources/computers";
+export type { AccountComputer, SessionComputer } from "./resources/computers";
+export type { AppCliAttachment, AppCliDefinition, CreateSessionRequest, FileEntry, PaginatedSessionsResult, SessionsResource, SessionTurnsPage, SessionTurnsQuery, UploadFileEntry, UploadFilesOptions, } from "./resources/sessions";
+export { DEFAULT_REPLAY_SPEED, SessionInfo, SessionStatus } from "./schemas/session";
+export type { ReplaySpeed, ReplayState, SessionDetail } from "./schemas/session";
+export type { ChatMessage, FileContentPart, ImageUrlContentPart, MemoryRefInfo, MessageContent, MessageContentPart, TextContentPart, ToolCallInfo, } from "./schemas/message";
+export { chatErrorForDisplay, contentPreview, getFileParts, getImageParts, getTextContent, groupMessagesByLoop, transformSlashCommand, } from "./schemas/message-utils";
+export type { SkillMentionAvailability } from "./schemas/message-utils";
+export { userFacingErrorText } from "./shared/oom";