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

package/dist/embed/entry.d.ts

@@ -18,72 +18,11 @@ declare function getChat(element: Element | null): Promise<AgentSession>;
 declare const BladeAgent: {
     BladeClient: typeof agentClient.BladeClient;
     BladeApiError: typeof agentClient.BladeApiError;
-    isEntryGoneError: typeof agentClient.isEntryGoneError;
-    PollingBackoff: typeof agentClient.PollingBackoff;
-    EMPTY_PLATFORM_ENDPOINTS: agentClient.PlatformEndpoints;
-    loadPlatformEndpoints: typeof agentClient.loadPlatformEndpoints;
-    resolveServiceUrl: typeof agentClient.resolveServiceUrl;
     SDK_NAME: "agent-client";
     SDK_VERSION: string;
     AgentSession: typeof AgentSession;
     AgentSessionError: typeof agentClient.AgentSessionError;
-    SessionHub: typeof agentClient.SessionHub;
-    isMcpAppData: typeof agentClient.isMcpAppData;
     SessionSetupError: typeof agentClient.SessionSetupError;
-    createInitialSessionState: typeof agentClient.createInitialSessionState;
-    reconcileHistoricalUserTurns: typeof agentClient.reconcileHistoricalUserTurns;
-    reconcileOptimisticUserTurns: typeof agentClient.reconcileOptimisticUserTurns;
-    toReplaySnapshot: typeof agentClient.toReplaySnapshot;
-    EMPTY_SESSION_QUEUE: agentClient.SessionQueueSnapshot;
-    canCancelQueuedMessage: typeof agentClient.canCancelQueuedMessage;
-    canDeliverQueuedMessage: typeof agentClient.canDeliverQueuedMessage;
-    canEditQueuedMessage: typeof agentClient.canEditQueuedMessage;
-    isSessionQueueSnapshot: typeof agentClient.isSessionQueueSnapshot;
-    parseQueueAck: typeof agentClient.parseQueueAck;
-    queuePauseReasonLabel: typeof agentClient.queuePauseReasonLabel;
-    queuedMessageStatusLabel: typeof agentClient.queuedMessageStatusLabel;
-    shouldApplySnapshot: typeof agentClient.shouldApplySnapshot;
-    connectEmbedded: typeof agentClient.connectEmbedded;
-    isCommandEnvelope: typeof agentClient.isCommandEnvelope;
-    isInboundEnvelope: typeof agentClient.isInboundEnvelope;
-    ComputersResource: typeof agentClient.ComputersResource;
-    canToggleComputer: typeof agentClient.canToggleComputer;
-    computerDaemonVersion: typeof agentClient.computerDaemonVersion;
-    computerOS: typeof agentClient.computerOS;
-    computerPlatformLabel: typeof agentClient.computerPlatformLabel;
-    computerState: typeof agentClient.computerState;
-    sortComputers: typeof agentClient.sortComputers;
-    ModelsResource: typeof agentClient.ModelsResource;
-    ChatGroupsResource: typeof agentClient.ChatGroupsResource;
-    PluginsResource: typeof agentClient.PluginsResource;
-    hasChatRunEvent: typeof agentClient.hasChatRunEvent;
-    inferToolStatus: typeof agentClient.inferToolStatus;
-    buildMessageContent: typeof agentClient.buildMessageContent;
-    chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
-    contentPreview: typeof agentClient.contentPreview;
-    extractTextAttachments: typeof agentClient.extractTextAttachments;
-    getFileParts: typeof agentClient.getFileParts;
-    getImageParts: typeof agentClient.getImageParts;
-    getTextContent: typeof agentClient.getTextContent;
-    groupMessagesByLoop: typeof agentClient.groupMessagesByLoop;
-    isHiddenInternalMessage: typeof agentClient.isHiddenInternalMessage;
-    isBackgroundWakeMessage: typeof agentClient.isBackgroundWakeMessage;
-    normalizeMessageContent: typeof agentClient.normalizeMessageContent;
-    transformSlashCommand: typeof agentClient.transformSlashCommand;
-    contextProjectionData: typeof agentClient.contextProjectionData;
-    getContextDisplayState: typeof agentClient.getContextDisplayState;
-    getContextGroupDisplayState: typeof agentClient.getContextGroupDisplayState;
-    groupAdjacentContextRuns: typeof agentClient.groupAdjacentContextRuns;
-    latestPostChatFollowup: typeof agentClient.latestPostChatFollowup;
-    buildToolUiCardKey: typeof agentClient.buildToolUiCardKey;
-    collectInlineToolUiCards: typeof agentClient.collectInlineToolUiCards;
-    collectPreviewToolUiCards: typeof agentClient.collectPreviewToolUiCards;
-    isAppDevToolUiCard: typeof agentClient.isAppDevToolUiCard;
-    isInternalStatusToolUiCard: typeof agentClient.isInternalStatusToolUiCard;
-    isToolUiCard: typeof agentClient.isToolUiCard;
-    resolveToolUiCardContent: typeof agentClient.resolveToolUiCardContent;
-    prependOlder: typeof agentClient.prependOlder;
-    replaceWindow: typeof agentClient.replaceWindow;
     DEFAULT_REPLAY_SPEED: agentClient.ReplaySpeed;
     SessionInfo: import("arktype/internal/variants/object.ts").ObjectType<{
         id: string;
@@ -123,23 +62,14 @@ declare const BladeAgent: {
         match?: unknown;
     }, {}>;
     SessionStatus: import("arktype/internal/variants/string.ts").StringType<"completed" | "created" | "failed" | "interrupted" | "running" | "waiting_for_input", {}>;
-    LayoutType: typeof agentClient.LayoutType;
-    Task: import("arktype/internal/variants/object.ts").ObjectType<{
-        id: string;
-        goal: string;
-        skills: string[];
-        depends_on: string[];
-        status: "done" | "failed" | "in_progress" | "pending" | "skipped";
-        result_summary: string;
-        number: string;
-    }, {}>;
-    TaskStatus: import("arktype/internal/variants/string.ts").StringType<"done" | "failed" | "in_progress" | "pending" | "skipped", {}>;
-    acceptedPostChatFollowupCompletesLatestRun: typeof agentClient.acceptedPostChatFollowupCompletesLatestRun;
-    acknowledgeTurnEvents: typeof agentClient.acknowledgeTurnEvents;
-    ClientProjectionBuilder: typeof agentClient.ClientProjectionBuilder;
-    AuthBusyReconnect: typeof agentClient.AuthBusyReconnect;
-    authBusyRetryDelayMs: typeof agentClient.authBusyRetryDelayMs;
-    createSocket: typeof agentClient.createSocket;
+    chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
+    contentPreview: typeof agentClient.contentPreview;
+    getFileParts: typeof agentClient.getFileParts;
+    getImageParts: typeof agentClient.getImageParts;
+    getTextContent: typeof agentClient.getTextContent;
+    groupMessagesByLoop: typeof agentClient.groupMessagesByLoop;
+    transformSlashCommand: typeof agentClient.transformSlashCommand;
+    userFacingErrorText: typeof agentClient.userFacingErrorText;
     getChat: typeof getChat;
     BladeChatElement: typeof BladeChatElement;
 };

package/dist/hooks/use-replay.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSession, ReplaySpeed } from "@blade-hq/agent-client";
+import type { AgentSession, ReplaySpeed } from "@blade-hq/agent-client/internal";
 /** 回放中用户说的话和录制内容对不上，需要当场决定往哪走。 */
 export interface ReplayMismatch {
     /** 用户这次实际发出的内容。 */

package/dist/hooks/use-turn-navigation.d.ts

@@ -1,4 +1,4 @@
-import { type ChatMessage, type SessionTurnIndexItem, type TurnProjection } from "@blade-hq/agent-client";
+import { type ChatMessage, type SessionTurnIndexItem, type TurnProjection } from "@blade-hq/agent-client/internal";
 /** 高亮用的类名。样式在 agent-react 的 style.css 与内置 Web 的 app.css 各有一份。 */
 export declare const TURN_NAV_HIGHLIGHT_CLASS = "blade-turn-nav-flash";
 /**

package/dist/host.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 宿主接口：聊天界面需要、但只有宿主知道怎么做的业务动作。
+ *
+ * 只放少量动作，不透传路由对象、全局 store、QueryClient 或编辑器实例——组件
+ * 拿到的永远是「做一件事」的函数。每个动作都可选：缺失时对应的按钮与菜单项
+ * 不渲染（不是禁用），所以 `<blade-chat>` 不注入任何动作时只剩最小功能集。
+ */
+export interface BladeHost {
+    /** 在宿主的工作区里打开会话中的文件（可带行号、显示名）。 */
+    openWorkspaceFile?(target: {
+        sessionId: string;
+        path: string;
+        line?: number;
+        name?: string;
+    }): void | Promise<void>;
+    /** 打开预览（网页地址或会话里的端口）；本机地址由宿主决定在哪里打开（如沙盒浏览器）。 */
+    openPreview?(target: {
+        sessionId: string;
+        url?: string;
+        port?: number;
+    }): void | Promise<void>;
+    /** 跳转到另一个会话。 */
+    openSession?(sessionId: string): void;
+    /** 跳转到项目。 */
+    openProject?(projectId: string): void;
+    /** 上传输入框里选中的附件，返回可随消息发送的附件描述。 */
+    uploadAttachments?(files: File[], context: {
+        sessionId?: string;
+    }): Promise<HostAttachment[]>;
+    /** 可在输入框里提及的技能清单。 */
+    listSkills?(context: {
+        sessionId?: string;
+    }): Promise<HostCatalogItem[]>;
+    /** 可在输入框里提及的知识库清单。 */
+    listKnowledgeBases?(context: {
+        sessionId?: string;
+    }): Promise<HostCatalogItem[]>;
+}
+/** 宿主上传完成的附件。 */
+export interface HostAttachment {
+    name: string;
+    /** 会话工作区里的相对路径（上传到工作区时有）。 */
+    path?: string;
+    /** 可直接访问的地址（上传到外部存储时有）。 */
+    url?: string;
+    mimeType?: string;
+    size?: number;
+}
+/** 技能、知识库等可提及条目。 */
+export interface HostCatalogItem {
+    id: string;
+    name: string;
+    description?: string;
+}

package/dist/index.d.ts

@@ -1,79 +1,21 @@
 export { BladeProvider, useBladeClient } from "./context";
 export type { BladeProviderProps } from "./context";
+export type { BladeHost, HostAttachment, HostCatalogItem } from "./host";
 export { useAgentSession } from "./hooks/use-agent-session";
 export type { UseAgentSessionOptions, UseAgentSessionResult } from "./hooks/use-agent-session";
 export { useReplay } from "./hooks/use-replay";
 export type { ReplayMismatch, UseReplayResult } from "./hooks/use-replay";
-export { useLlmChat } from "./hooks/use-llm-chat";
-export { useMessagePin } from "./hooks/use-message-pin";
-export type { UseMessagePinOptions } from "./hooks/use-message-pin";
-export { useTypewriterReveal } from "./hooks/use-typewriter-reveal";
-export type { UseTypewriterRevealResult } from "./hooks/use-typewriter-reveal";
-export { latestUserSpeechEntryId, TURN_NAV_HIGHLIGHT_CLASS, turnNavItemsFromMessages, useTurnNavigation, } from "./hooks/use-turn-navigation";
-export type { TurnNavigationOptions, TurnNavigationResult, TurnNavigationSource, } from "./hooks/use-turn-navigation";
-export { TurnNavRail } from "./components/TurnNavRail";
-export type { TurnNavRailProps } from "./components/TurnNavRail";
-export type { ChatCompletionTool, LlmChatOptions, LlmToolCall, UseLlmChatResult, } from "./hooks/use-llm-chat";
-export { ChatView } from "./components/ChatView";
-export type { AssistantTextRendererProps, AskUserQuestionRendererProps, ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, PlanUpdateRendererProps, UserMessageRendererProps, } from "./components/ChatView";
-export { ConnectorPanel } from "./components/ConnectorPanel";
-export type { ConnectorPanelProps } from "./components/ConnectorPanel";
-export { PluginConnectorList } from "./components/PluginConnectorList";
-export type { ConfiguringPlugin, PluginConnectorListProps } from "./components/PluginConnectorList";
-export { useSessionPluginActivation } from "./components/use-session-plugin-activation";
-export type { UseSessionPluginActivationResult } from "./components/use-session-plugin-activation";
-export { catalogToConnectorItems, filterConnectorItems, mergeConnectorItems, } from "./components/plugin-connector";
-export type { PluginConnectorItem } from "./components/plugin-connector";
-export { selectionFromItem, triggerSummary, TRIGGER_ICON_LIMIT } from "./components/connector-panel-types";
-export type { PluginConnectorSelection, TriggerSummary, } from "./components/connector-panel-types";
-export { SessionPluginSelector } from "./components/SessionPluginSelector";
-export type { SessionPluginSelectorProps } from "./components/SessionPluginSelector";
-export { SessionPluginIcon, sessionPluginLabel } from "./components/SessionPluginIcon";
-export type { SessionPluginIconProps, SessionPluginLabelProps } from "./components/SessionPluginIcon";
-export { PluginTriggerStack } from "./components/PluginTriggerStack";
-export type { PluginTriggerStackProps } from "./components/PluginTriggerStack";
-export { SessionPluginConfigDialog } from "./components/SessionPluginConfigDialog";
-export type { SessionPluginConfigDialogProps } from "./components/SessionPluginConfigDialog";
-export { SessionPluginConfigForm } from "./components/SessionPluginConfigForm";
-export type { SessionPluginConfigDraft, SessionPluginConfigFormProps, } from "./components/SessionPluginConfigForm";
-export { AgentChat } from "./components/AgentChat";
-export type { AgentChatProps } from "./components/AgentChat";
-export { LlmChat } from "./components/LlmChat";
-export type { LlmChatHandle, LlmChatProps } from "./components/LlmChat";
-export type { LlmAdvancedSettings, LlmOverride } from "./components/LlmAdvancedSettings";
-export { MarkdownContent } from "./components/MarkdownContent";
-export { ExternalAnchor, normalizeAdjacentUrlFormatting, stripSystemReminders } from "./components/MarkdownContent";
-export type { MarkdownContentProps } from "./components/MarkdownContent";
-export { DEFAULT_ALLOWED_TAGS, MarkdownRenderer } from "./components/markdown";
-export type { AllowedTags, CodeBlockOverrides, LinkSafetyConfig, MarkdownComponents, MarkdownRendererProps, RawHtmlPlugin, } from "./components/markdown";
-export { WhatIfUserBubble } from "./components/WhatIfUserBubble";
-export type { WhatIfUserBubbleProps } from "./components/WhatIfUserBubble";
-export { parseWhatIfPrompt } from "./lib/whatif-prompt";
-export type { ParsedWhatIfPrompt, WhatIfQuote } from "./lib/whatif-prompt";
 export { ReplayBar } from "./components/ReplayBar";
 export type { ReplayBarProps } from "./components/ReplayBar";
 export { ReplayMismatchPrompt } from "./components/ReplayMismatchPrompt";
 export type { ReplayMismatchPromptProps } from "./components/ReplayMismatchPrompt";
-export type { ToolCallRenderer } from "./components/ToolCallBlock";
-export { CurrentPlanPanel, getPlanUpdateDisplayState, isPlanUpdateTool, PLAN_AUTO_COLLAPSE_MS, parsePlanUpdate, pickCurrentPlanStep, PlanUpdateBlock, } from "./components/PlanUpdateBlock";
-export type { PlanStepStatus, PlanUpdateData, PlanUpdateDisplayState, } from "./components/PlanUpdateBlock";
-export { ContextCard, ContextGroupCard } from "./components/ContextCard";
-export type { ContextCardProps, ContextGroupCardProps } from "./components/ContextCard";
-export { collectMemoryRefs, MemoryRefsHint } from "./components/AssistantTurnBlock";
-export { ToolUiCardView } from "./components/ToolUiCardView";
-export type { AskUserQuestionData } from "./components/AskUserQuestionBlock";
-export { McpAppCard } from "./components/McpAppCard";
-export type { McpAppMessage } from "./components/McpAppCard";
-export { SessionMemoryToggle } from "./components/SessionMemoryToggle";
-export type { SessionMemoryToggleProps } from "./components/SessionMemoryToggle";
-export { SessionQueuePanel, isQueuePanelVisible } from "./components/SessionQueuePanel";
-export type { SessionQueuePanelProps } from "./components/SessionQueuePanel";
-export { isAgentComputerCommand, isAgentComputerToolCall, classifyAgentComputerLaunchOutcome, } from "./lib/agent-computer-command";
-export type { AgentComputerLaunchOutcome } from "./lib/agent-computer-command";
-export * from "@blade-hq/agent-client";
-export { AgentTaskCard } from "./components/AgentTaskCard";
-export type { AgentTaskCardProps, AgentTaskStatus } from "./components/AgentTaskCard";
-export { SessionBranchPicker } from "./components/SessionBranchPicker";
-export type { SessionBranchPickerProps } from "./components/SessionBranchPicker";
-export { MessageImage, type MessageImageProps } from "./components/MessageImage";
-export { BackgroundWakeNotice } from "./components/BackgroundWakeNotice";
+export { ChatView } from "./components/ChatView";
+export type { ChatViewProps } from "./components/ChatView";
+export type { AskUserQuestionRendererProps, AssistantTextRendererProps, ChatViewClassNames, ChatViewRenderers, ChatViewSlots, PlanUpdateRendererProps, ToolCallRenderer, ToolRendererProps, UserMessageRendererProps, } from "./chat/customization";
+export type { FollowupInteractionEvent } from "./chat/followup-interaction";
+export type { AskUserQuestionData } from "./chat/AskUserQuestionBlock";
+export type { PlanStepStatus, PlanUpdateData } from "./components/PlanUpdateBlock";
+export type { LlmChatHandle } from "./components/LlmChat";
+export type { ChatCompletionTool, LlmChatOptions, LlmToolCall } from "./hooks/use-llm-chat";
+export { MarkdownContent } from "./chat/markdown/MarkdownContent";
+export type { MarkdownContentProps } from "./chat/markdown/MarkdownContent";