@blade-hq/agent-react 2612.0.0-beta.0 → 2612.0.0-beta.10

package/dist/{chunk-G3PMV62Z.js → chunk-PR4QN5HX.js}

@@ -4,7 +4,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
@@ -29,8 +35,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 export {
+  __require,
   __commonJS,
   __export,
   __toESM
 };
-//# sourceMappingURL=chunk-G3PMV62Z.js.map
+//# sourceMappingURL=chunk-PR4QN5HX.js.map

package/dist/components/AgentChat.d.ts

@@ -1,7 +1,7 @@
-import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
+import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client/internal";
 import { type ReactNode } from "react";
-import { type ChatPresentationProps } from "./ChatSurface";
-import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
+import type { ChatPresentationProps } from "../chat/customization";
+import type { FollowupInteractionEvent } from "../chat/followup-interaction";
 export interface AgentChatProps extends ChatPresentationProps {
     /** follow-up、成果和评分交互；SDK 不绑定任何分析厂商。 */
     onFollowupInteraction?: (event: FollowupInteractionEvent) => void;

package/dist/components/ChatInput.d.ts

@@ -1,3 +1,4 @@
+import { type KeyboardEvent } from "react";
 interface Props {
     /** 受控输入内容（由 ChatView 持有，便于 attach/insertText 注入）。 */
     value: string;
@@ -28,11 +29,12 @@ interface Props {
     toolbarClassName?: string;
     queueKey?: string;
     hasAttachments?: boolean;
+    onKeyDown?: (event: KeyboardEvent<HTMLTextAreaElement>) => void;
 }
 /**
  * 轻量聊天输入框：textarea（Enter 发送 / Shift+Enter 换行）+ 发送/停止按钮。
  * 不含第一方版本的富文本编辑、@ 补全、技能菜单、语音输入与模型选择。
  * 内容受控，session.attach() / insertText() 通过 ChatView 注入到这里。
  */
-export declare function ChatInput({ value, onValueChange, onSend, onStop, isStreaming, isStopping, queueWhileRunning, mergesWithPanelAbove, placeholder, className, innerClassName, textareaClassName, toolbarClassName, queueKey, hasAttachments, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ChatInput({ value, onValueChange, onSend, onStop, isStreaming, isStopping, queueWhileRunning, mergesWithPanelAbove, placeholder, className, innerClassName, textareaClassName, toolbarClassName, queueKey, hasAttachments, onKeyDown, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatView.d.ts

@@ -2,8 +2,8 @@ import { type AgentChatProps } from "./AgentChat";
 import { type LlmChatHandle } from "./LlmChat";
 import type { LlmAdvancedSettings, LlmOverride } from "./LlmAdvancedSettings";
 import type { LlmChatOptions } from "../hooks/use-llm-chat";
-export type { AssistantTextRendererProps, AskUserQuestionRendererProps, ChatViewClassNames, ChatViewRenderers, ChatViewSlots, PlanUpdateRendererProps, UserMessageRendererProps, } from "./ChatSurface";
-export type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
+export type { AssistantTextRendererProps, AskUserQuestionRendererProps, ChatViewClassNames, ChatViewRenderers, ChatViewSlots, PlanUpdateRendererProps, UserMessageRendererProps, } from "../chat/customization";
+export type { FollowupInteractionEvent } from "../chat/followup-interaction";
 export interface ChatViewProps extends AgentChatProps {
     /** 挂哪个下层组件。默认 `agent`——不传就是接 Blade 智能体会话的原有行为。 */
     mode?: "agent" | "llm";

package/dist/components/ConnectorPanel.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client/internal";
 import { type ReactNode } from "react";
 import { type PluginConnectorItem } from "./plugin-connector";
 import { type PluginConnectorSelection } from "./connector-panel-types";

package/dist/components/ContextCard.d.ts

@@ -1,4 +1,4 @@
-import { type ContextProjectionData } from "@blade-hq/agent-client";
+import { type ContextProjectionData } from "@blade-hq/agent-client/internal";
 export interface ContextCardProps {
     context: ContextProjectionData;
     className?: string;

package/dist/components/LlmChat.d.ts

@@ -1,5 +1,5 @@
+import { type ChatPresentationProps } from "../chat/customization";
 import { type LlmChatOptions } from "../hooks/use-llm-chat";
-import { type ChatPresentationProps } from "./ChatSurface";
 import { type LlmAdvancedSettings, type LlmOverride } from "./LlmAdvancedSettings";
 /** 纯 LLM 模式的操作句柄，对应智能体模式的 session.insertText() / send()。 */
 export interface LlmChatHandle {

package/dist/components/McpAppCard.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient } from "@blade-hq/agent-client";
+import type { BladeClient } from "@blade-hq/agent-client/internal";
 export interface McpAppMessage {
     sessionId: string;
     sourceId: string;

package/dist/components/PlanUpdateBlock.d.ts

@@ -22,11 +22,3 @@ export declare function PlanUpdateBlock({ toolCall, running, autoReveal, classNa
     autoReveal?: boolean;
     className?: string;
 }): import("react/jsx-runtime").JSX.Element | null;
-export declare function CurrentPlanPanel({ messages, running, revealRevision, sessionId, className, }: {
-    messages: ChatMessage[];
-    running?: boolean;
-    /** 仅实时成功的 update_plan 递增；历史 hydration 不得改变。 */
-    revealRevision?: number;
-    sessionId?: string;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/PluginConnectorList.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 import type { PluginConnectorItem } from "./plugin-connector";
 export interface ConfiguringPlugin {
     name: string;

package/dist/components/ReplayBar.d.ts

@@ -1,4 +1,4 @@
-import type { ReplaySpeed } from "@blade-hq/agent-client";
+import type { ReplaySpeed } from "@blade-hq/agent-client/internal";
 export interface ReplayBarProps {
     /** 非回放会话传 false 时整条不渲染。 */
     isReplay: boolean;

package/dist/components/SessionPluginConfigDialog.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPlugin, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPlugin, SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 export interface SessionPluginConfigDialogProps {
     client: BladeClient;
     sessionId: string;

package/dist/components/SessionPluginConfigForm.d.ts

@@ -1,4 +1,4 @@
-import type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 export interface SessionPluginConfigDraft {
     set: SessionPluginConfigSet[];
     remove: string[];

package/dist/components/SessionPluginIcon.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPlugin } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPlugin } from "@blade-hq/agent-client/internal";
 export interface SessionPluginIconProps {
     client: BladeClient;
     /**

package/dist/components/SessionPluginSelector.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client/internal";
 export interface SessionPluginSelectorProps {
     client: BladeClient;
     sessionId: string;

package/dist/components/SessionQueuePanel.d.ts

@@ -1,4 +1,4 @@
-import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-client";
+import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-client/internal";
 import { type JSX } from "react";
 export interface SessionQueuePanelProps {
     snapshot: SessionQueueSnapshot;

package/dist/components/ToolUiCardView.d.ts

@@ -1,4 +1,4 @@
-import { type ToolUiCard } from "@blade-hq/agent-client";
+import { type ToolUiCard } from "@blade-hq/agent-client/internal";
 /**
  * MCP Apps 使用 SDK/Web 共享的 AppBridge；恢复只消费留档，不重读资源。
  * 普通资源卡片仍使用 agent-client 的共享内容判定。

package/dist/components/TopicAssetSubmitDialog.d.ts

@@ -0,0 +1,14 @@
+/** Shared permission decision for any session-file UI. The server checks again on submission. */
+export declare function useTopicAssetSubmissionAccess(sessionId: string | null): {
+    data: import("@blade-hq/agent-client").ChatGroup | null | undefined;
+    error: Error | null;
+};
+export interface TopicAssetSubmitDialogProps {
+    sessionId: string;
+    topicId: string;
+    path: string;
+    onClose: () => void;
+    onSubmitted?: () => void;
+}
+/** Copy an existing sandbox file into the topic; never move or rewrite the draft. */
+export declare function TopicAssetSubmitDialog({ sessionId, topicId, path, onClose, onSubmitted }: TopicAssetSubmitDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/plugin-config-draft.d.ts

@@ -1,4 +1,4 @@
-import type { SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 export type ConfigPath = (string | number)[];
 export type ConfigValues = Record<string, unknown>;
 export declare function createConfigDraft(config: SessionPluginConfigState): {

package/dist/components/plugin-config-schema.d.ts

@@ -1,4 +1,4 @@
-import type { SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 export type JsonSchema = Record<string, unknown>;
 export declare function pointerOf(parts: (string | number)[]): string;
 export declare function pointerParts(pointer: string): string[];

package/dist/components/plugin-connector.d.ts

@@ -1,4 +1,4 @@
-import type { PluginCatalogEntry, SessionPlugin, SessionPluginConfigSummary } from "@blade-hq/agent-client";
+import type { PluginCatalogEntry, SessionPlugin, SessionPluginConfigSummary } from "@blade-hq/agent-client/internal";
 /**
  * 连接器面板里的一行插件。
  *
@@ -13,6 +13,7 @@ export interface PluginConnectorItem {
     icon: string | null;
     /** 图标从哪个接口取：账号级目录，还是会话内已准备的包。 */
     iconSource: "account" | "session";
+    auth_status?: PluginCatalogEntry["auth_status"];
     installed: boolean | null;
     /** 会话里已提交的选择；首页候选恒为 false。 */
     active: boolean;

package/dist/components/use-session-plugin-activation.d.ts

@@ -1,4 +1,4 @@
-import type { BladeClient, SessionPluginActivation, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { BladeClient, SessionPluginActivation, SessionPluginConfigState } from "@blade-hq/agent-client/internal";
 import type { ConfiguringPlugin } from "./PluginConnectorList";
 import { type PluginConnectorItem } from "./plugin-connector";
 export interface UseSessionPluginActivationResult {

package/dist/context.d.ts

@@ -1,14 +1,23 @@
 import type { BladeClient } from "@blade-hq/agent-client";
 import { type ReactNode } from "react";
+import type { BladeHost } from "./host";
 export interface BladeProviderProps {
     client: BladeClient;
+    /**
+     * 宿主提供的业务动作（打开文件、跳转会话、上传附件……）。全部可选：
+     * 没提供的动作，聊天界面里对应的按钮和菜单项不显示。传稳定引用（模块常量或
+     * useMemo），每次渲染新建对象会让依赖它的清单反复重新加载。
+     */
+    host?: BladeHost;
     children: ReactNode;
 }
 /**
- * 提供 client 级共享（一条连接、一份鉴权）。不含任何全局状态：
+ * 提供 client 级共享（一条连接、一份鉴权）与宿主动作。不含任何全局状态：
  * 同一 Provider 下多个 ChatView / useAgentSession 各自独立。
  */
-export declare function BladeProvider({ client, children }: BladeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function BladeProvider({ client, host, children }: BladeProviderProps): import("react/jsx-runtime").JSX.Element;
 /** 读取当前 BladeProvider 提供的 client。不在 Provider 内使用时抛错。 */
 export declare function useBladeClient(): BladeClient;
 export declare function useOptionalBladeClient(): BladeClient | null;
+/** 读取宿主动作；不在 Provider 内或宿主没传 `host` 时是空对象（所有动作都缺失）。 */
+export declare function useBladeHost(): BladeHost;

package/dist/embed/blade-chat-element.d.ts

@@ -1,4 +1,4 @@
-import { type AgentSession } from "@blade-hq/agent-client";
+import { type AgentSession, type BladeChatMountRenderers } from "@blade-hq/agent-client";
 /**
  * `<blade-chat base-url="https://..." session-id="可选" theme="light|dark">`
  *
@@ -10,11 +10,24 @@ export declare class BladeChatElement extends HTMLElement {
     private root;
     private shadow;
     private mountPoint;
+    /** 弹层根：Shadow DOM 里 Radix 弹层默认挂的 document.body 够不着内置样式，统一挂到这里。 */
+    private overlayRoot;
     /** 当前会话（连接完成后可用）；BladeAgent.getChat() 依赖它。 */
     session: AgentSession | null;
     private sessionWaiters;
     /** 自动创建的会话 id：attribute 变化触发的重渲染要继续用它，避免重复建会话。 */
     private autoCreatedSessionId;
+    private mountRenderers;
+    /** 转换后的 React 渲染器按渲染器对象缓存，避免每次渲染重建挂载内容。 */
+    private reactRenderers;
+    /**
+     * 挂载式渲染器（JS 属性，不是 HTML 属性）：为工具卡片、用户消息、助手正文提供
+     * DOM 节点与数据，由宿主自己挂载内容（Vue 组件、原生 DOM 都行）。
+     * 挂载节点是本元素的 light DOM 子节点，经 `<slot>` 显示在对应位置。
+     */
+    get renderers(): BladeChatMountRenderers | null;
+    set renderers(value: BladeChatMountRenderers | null);
+    private currentReactRenderers;
     connectedCallback(): void;
     /**
      * 自定义样式口子：<blade-chat> 的直接 <style> 子元素会被拷入 Shadow DOM，

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,16 @@ 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;
+    normalizeTopicAssetRefs: typeof agentClient.normalizeTopicAssetRefs;
+    normalizePluginRefs: typeof agentClient.normalizePluginRefs;
     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,50 @@
+/**
+ * 宿主接口：聊天界面需要、但只有宿主知道怎么做的业务动作。
+ *
+ * 只放少量动作，不透传路由对象、全局 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[]>;
+}
+/** 宿主上传完成的附件。 */
+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,23 @@
 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";
+export { TopicAssetSubmitDialog, useTopicAssetSubmissionAccess } from "./components/TopicAssetSubmitDialog";
+export type { TopicAssetSubmitDialogProps } from "./components/TopicAssetSubmitDialog";