@blade-hq/agent-react 2610.0.0-beta.50 → 2610.0.0-beta.52

package/dist/components/ChatInput.d.ts

@@ -3,19 +3,20 @@ interface Props {
     value: string;
     onValueChange: (value: string) => void;
     onSend: (text: string) => boolean | Promise<boolean>;
-    /** Optional direct insertion path used while another response streams. */
-    onAppend?: (text: string) => void;
+    /** 运行中提交：把消息交给服务端队列（入队）。 */
+    onAppend?: (text: string) => boolean | undefined | Promise<boolean>;
     onStop: () => void;
     isStreaming: boolean;
     isStopping?: boolean;
     placeholder?: string;
     className?: string;
     queueKey?: string;
+    hasAttachments?: boolean;
 }
 /**
  * 轻量聊天输入框：textarea（Enter 发送 / Shift+Enter 换行）+ 发送/停止按钮。
  * 不含第一方版本的富文本编辑、@ 补全、技能菜单、语音输入与模型选择。
  * 内容受控，session.attach() / insertText() 通过 ChatView 注入到这里。
  */
-export declare function ChatInput({ value, onValueChange, onSend, onAppend, onStop, isStreaming, isStopping, placeholder, className, queueKey, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ChatInput({ value, onValueChange, onSend, onAppend, onStop, isStreaming, isStopping, placeholder, className, queueKey, hasAttachments, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatSurface.d.ts

@@ -1,5 +1,5 @@
 import type { AskUserAnswerData, ChatMessage, ConnectionStatus, PostChatFollowup } from "@blade-hq/agent-client";
-import type { ReactNode } from "react";
+import { type ReactNode } from "react";
 import type { ToolCallRenderer } from "./ToolCallBlock";
 import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 import type { ResultFeedback } from "@blade-hq/agent-client";
@@ -45,7 +45,7 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     onInputChange: (value: string) => void;
     onSuggestion?: (value: string) => void;
     onSend: (text: string) => Promise<boolean>;
-    onAppend?: (text: string) => void;
+    onAppend?: (text: string) => boolean | undefined | Promise<boolean>;
     onStop: () => void;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
@@ -56,6 +56,8 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
     /** 输入框上方的内部区域（纯 LLM 模式的高级设置用）。不传时不渲染任何节点。 */
     beforeInput?: ReactNode;
+    /** 输入框上方的会话队列面板（智能体模式用）。不传时不渲染任何节点。 */
+    queuePanel?: ReactNode;
     /** 仅 Agent 模式启用 Blade 的 update_plan 面板。 */
     showPlanUpdates?: boolean;
     /** 仅实时成功的 update_plan 递增；历史 hydration 不得改变。 */
@@ -75,5 +77,5 @@ interface ChatSurfaceProps extends ChatPresentationProps {
  * 这里的 DOM 结构受 tests/chat-view-compat.test.tsx 的快照保护——接入方拿
  * .blade-chat-* 类名写了自己的样式，结构一动他们的页面就歪。
  */
-export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onAppend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, showPlanUpdates, planRevealRevision, historyPaging, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatSurface({ theme, classNames, renderers, slots, placeholder, connection, errorMessage, messages, postChatFollowup, isStreaming, isStopping, inputText, onInputChange, onSuggestion, onSend, onAppend, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, queuePanel, showPlanUpdates, planRevealRevision, historyPaging, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/McpAppCard.d.ts

@@ -0,0 +1,14 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+export interface McpAppMessage {
+    sessionId: string;
+    sourceId: string;
+    label: string;
+    content: string;
+}
+export declare const McpAppMessageContext: import("react").Context<((message: McpAppMessage) => void) | null>;
+export declare function McpAppCard({ sessionId, sourceId, client: suppliedClient, onMessage: suppliedOnMessage }: {
+    sessionId: string;
+    sourceId: string;
+    client?: BladeClient;
+    onMessage?: (message: McpAppMessage) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginConfigDialog.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPlugin, SessionPluginConfigState } from "@blade-hq/agent-client";
+export interface SessionPluginConfigDialogProps {
+    client: BladeClient;
+    sessionId: string;
+    plugin: Pick<SessionPlugin, "name" | "display_name" | "icon">;
+    /** Called after every successful save with the freshly published state. */
+    onSaved?: (state: SessionPluginConfigState) => void;
+    onClose: () => void;
+}
+export declare function SessionPluginConfigDialog({ client, sessionId, plugin, ...props }: SessionPluginConfigDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginConfigForm.d.ts

@@ -0,0 +1,14 @@
+import type { SessionPluginConfigError, SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+export interface SessionPluginConfigDraft {
+    set: SessionPluginConfigSet[];
+    remove: string[];
+}
+export interface SessionPluginConfigFormProps {
+    config: SessionPluginConfigState;
+    submitting: boolean;
+    errors: SessionPluginConfigError[];
+    failure: string | null;
+    onSubmit: (draft: SessionPluginConfigDraft) => void;
+    onCancel: () => void;
+}
+export declare function SessionPluginConfigForm({ config, submitting, errors, failure, onSubmit, onCancel, }: SessionPluginConfigFormProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionPluginIcon.d.ts

@@ -0,0 +1,19 @@
+import type { BladeClient, SessionPlugin } from "@blade-hq/agent-client";
+export interface SessionPluginIconProps {
+    client: BladeClient;
+    sessionId: string;
+    plugin: Pick<SessionPlugin, "name" | "icon">;
+    className?: string;
+}
+export interface SessionPluginLabelProps {
+    plugin: Pick<SessionPlugin, "name" | "display_name">;
+}
+/**
+ * Business name for a plugin, falling back to the technical ID.
+ *
+ * The ID stays authoritative for paths, authorization, caching and calls; this
+ * helper only decides what a user reads. Keep it shared — one place decides.
+ */
+export declare function sessionPluginLabel(plugin: Pick<SessionPlugin, "name" | "display_name">): string;
+/** Package-local plugin icon, with a stable generic placeholder. */
+export declare function SessionPluginIcon({ client, sessionId, plugin, className }: SessionPluginIconProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/SessionQueuePanel.d.ts

@@ -0,0 +1,25 @@
+import { type QueuedMessage, type SessionQueueSnapshot } from "@blade-hq/agent-client";
+import { type JSX } from "react";
+export interface SessionQueuePanelProps {
+    snapshot: SessionQueueSnapshot;
+    /** 当前是否有可接收补充的运行任务（决定「立即补充」是否可用） */
+    canDeliver: boolean;
+    /** 正在等服务端确认的条目 id：禁用该条目的操作，避免重复提交 */
+    pendingItemId?: string | null;
+    /** 冲突/失败提示，例如「该消息已开始执行」；展示在面板顶部 */
+    notice?: string | null;
+    onResume: () => void;
+    onCancel: (item: QueuedMessage) => void;
+    onEdit: (item: QueuedMessage, content: string) => boolean | undefined | Promise<boolean>;
+    onRequeue?: (content: string) => Promise<boolean>;
+    onMove: (item: QueuedMessage, delta: -1 | 1) => void;
+    onReorder: (orderedIds: string[]) => void;
+    onDeliver: (item: QueuedMessage) => void;
+}
+/**
+ * 会话消息队列面板：输入框上方的「待执行 · N」区域。
+ *
+ * 纯展示组件，不持有会话状态；能否编辑/删除/补充全部用 agent-client 的判定函数，
+ * 不在本包重写一份。上移/下移、拖动排序最终都由调用方提交完整的 pending id 顺序。
+ */
+export declare function SessionQueuePanel({ snapshot, canDeliver, pendingItemId, notice, onResume, onCancel, onEdit, onRequeue, onMove, onReorder, onDeliver, }: SessionQueuePanelProps): JSX.Element | null;

package/dist/components/ToolUiCardView.d.ts

@@ -0,0 +1,9 @@
+import { type ToolUiCard } from "@blade-hq/agent-client";
+/**
+ * MCP Apps 使用 SDK/Web 共享的 AppBridge；恢复只消费留档，不重读资源。
+ * 普通资源卡片仍使用 agent-client 的共享内容判定。
+ */
+export declare function ToolUiCardView({ card, sessionId }: {
+    card: ToolUiCard;
+    sessionId?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,13 @@
+import type { SessionPluginConfigSet, SessionPluginConfigState } from "@blade-hq/agent-client";
+export type ConfigPath = (string | number)[];
+export type ConfigValues = Record<string, unknown>;
+export declare function createConfigDraft(config: SessionPluginConfigState): {
+    values: ConfigValues;
+    retained: Map<string, string>;
+};
+/** Array edits address the original indices because the API applies sets before removals. */
+export declare function originalConfigPath(path: ConfigPath, removed: Set<string>): ConfigPath;
+export declare function configDraftOperations(initial: ConfigValues, values: ConfigValues, retained: Map<string, string>, removed: Set<string>): {
+    set: SessionPluginConfigSet[];
+    remove: string[];
+};

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

@@ -0,0 +1,6 @@
+import type { SessionPluginConfigState } from "@blade-hq/agent-client";
+export type JsonSchema = Record<string, unknown>;
+export declare function pointerOf(parts: (string | number)[]): string;
+export declare function pointerParts(pointer: string): string[];
+export declare function formSupport(schema: JsonSchema | null): string | null;
+export declare function configIsEditable(state: SessionPluginConfigState): boolean;

package/dist/embed/entry.d.ts

@@ -26,11 +26,21 @@ declare const BladeAgent: {
     SDK_VERSION: string;
     AgentSession: typeof AgentSession;
     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;
@@ -60,6 +70,13 @@ declare const BladeAgent: {
     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;

package/dist/{highlighted-body-B3W2YXNL-YD7FAP6V.js → highlighted-body-B3W2YXNL-IASCZDV2.js}

@@ -3,7 +3,8 @@ import {
   Ks,
   Qe,
   R
-} from "./chunk-ZXXLY4RM.js";
+} from "./chunk-MAAMCOAU.js";
+import "./chunk-G3PMV62Z.js";
 
 // ../../node_modules/.pnpm/streamdown@2.3.0_react-dom@19.2.4_react@19.2.4__react@19.2.4/node_modules/streamdown/dist/highlighted-body-B3W2YXNL.js
 import { useContext, useState, useEffect } from "react";
@@ -24,4 +25,4 @@ var L = ({ code: s, language: t, raw: e, className: n, ...d$1 }) => {
 export {
   L as HighlightedCodeBlockBody
 };
-//# sourceMappingURL=highlighted-body-B3W2YXNL-YD7FAP6V.js.map
+//# sourceMappingURL=highlighted-body-B3W2YXNL-IASCZDV2.js.map

package/dist/{highlighted-body-B3W2YXNL-YD7FAP6V.js.map → highlighted-body-B3W2YXNL-IASCZDV2.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../../node_modules/.pnpm/streamdown@2.3.0_react-dom@19.2.4_react@19.2.4__react@19.2.4/node_modules/streamdown/dist/highlighted-body-B3W2YXNL.js"],"sourcesContent":["\"use client\";\nimport {k,d,c}from'./chunk-RLXIAIE6.js';import {useContext,useState,useEffect}from'react';import {jsx}from'react/jsx-runtime';var L=({code:s,language:t,raw:e,className:n,...d$1})=>{let{shikiTheme:l}=useContext(k),o=d(),[m,i]=useState(e);return useEffect(()=>{if(!o){i(e);return}let g=o.highlight({code:s,language:t,themes:l},p=>{i(p);});g&&i(g);},[s,t,l,o,e]),jsx(c,{className:n,language:t,result:m,...d$1})};export{L as HighlightedCodeBlockBody};"],"mappings":";;;;;;;;AACwC,SAAQ,YAAW,UAAS,iBAAc;AAAQ,SAAQ,WAAQ;AAAoB,IAAI,IAAE,CAAC,EAAC,MAAK,GAAE,UAAS,GAAE,KAAI,GAAE,WAAU,GAAE,GAAG,IAAG,MAAI;AAAC,MAAG,EAAC,YAAW,EAAC,IAAE,WAAW,CAAC,GAAE,IAAE,GAAE,GAAE,CAAC,GAAE,CAAC,IAAE,SAAS,CAAC;AAAE,SAAO,UAAU,MAAI;AAAC,QAAG,CAAC,GAAE;AAAC,QAAE,CAAC;AAAE;AAAA,IAAM;AAAC,QAAI,IAAE,EAAE,UAAU,EAAC,MAAK,GAAE,UAAS,GAAE,QAAO,EAAC,GAAE,OAAG;AAAC,QAAE,CAAC;AAAA,IAAE,CAAC;AAAE,SAAG,EAAE,CAAC;AAAA,EAAE,GAAE,CAAC,GAAE,GAAE,GAAE,GAAE,CAAC,CAAC,GAAE,IAAI,IAAE,EAAC,WAAU,GAAE,UAAS,GAAE,QAAO,GAAE,GAAG,IAAG,CAAC;AAAC;","names":[]}
+{"version":3,"sources":["../../../node_modules/.pnpm/streamdown@2.3.0_react-dom@19.2.4_react@19.2.4__react@19.2.4/node_modules/streamdown/dist/highlighted-body-B3W2YXNL.js"],"sourcesContent":["\"use client\";\nimport {k,d,c}from'./chunk-RLXIAIE6.js';import {useContext,useState,useEffect}from'react';import {jsx}from'react/jsx-runtime';var L=({code:s,language:t,raw:e,className:n,...d$1})=>{let{shikiTheme:l}=useContext(k),o=d(),[m,i]=useState(e);return useEffect(()=>{if(!o){i(e);return}let g=o.highlight({code:s,language:t,themes:l},p=>{i(p);});g&&i(g);},[s,t,l,o,e]),jsx(c,{className:n,language:t,result:m,...d$1})};export{L as HighlightedCodeBlockBody};"],"mappings":";;;;;;;;;AACwC,SAAQ,YAAW,UAAS,iBAAc;AAAQ,SAAQ,WAAQ;AAAoB,IAAI,IAAE,CAAC,EAAC,MAAK,GAAE,UAAS,GAAE,KAAI,GAAE,WAAU,GAAE,GAAG,IAAG,MAAI;AAAC,MAAG,EAAC,YAAW,EAAC,IAAE,WAAW,CAAC,GAAE,IAAE,GAAE,GAAE,CAAC,GAAE,CAAC,IAAE,SAAS,CAAC;AAAE,SAAO,UAAU,MAAI;AAAC,QAAG,CAAC,GAAE;AAAC,QAAE,CAAC;AAAE;AAAA,IAAM;AAAC,QAAI,IAAE,EAAE,UAAU,EAAC,MAAK,GAAE,UAAS,GAAE,QAAO,EAAC,GAAE,OAAG;AAAC,QAAE,CAAC;AAAA,IAAE,CAAC;AAAE,SAAG,EAAE,CAAC;AAAA,EAAE,GAAE,CAAC,GAAE,GAAE,GAAE,GAAE,CAAC,CAAC,GAAE,IAAI,IAAE,EAAC,WAAU,GAAE,UAAS,GAAE,QAAO,GAAE,GAAG,IAAG,CAAC;AAAC;","names":[]}

package/dist/index.d.ts

@@ -12,6 +12,12 @@ export { ChatView } from "./components/ChatView";
 export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, } from "./components/ChatView";
 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 { 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";
@@ -34,8 +40,13 @@ export type { PlanStepStatus, PlanUpdateData, PlanUpdateDisplayState, } from "./
 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 { McpAppCard } from "./components/McpAppCard";
+export type { McpAppMessage } from "./components/McpAppCard";
 export { SessionMemoryToggle } from "./components/SessionMemoryToggle";
 export type { SessionMemoryToggleProps } from "./components/SessionMemoryToggle";
+export { SessionQueuePanel } 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";