@blade-hq/agent-react 2610.0.0-beta.51 → 2610.0.0-beta.53

package/README.md

@@ -388,7 +388,13 @@ blade-chat { --primary: 262 83% 58%; height: 640px; }
 
 为方便单包引入，本包 re-export 了 agent-client 的全部公开声明（`BladeClient`、`AgentSession`、`SessionState`、协议类型等），文档一律见 [agent-client 的 README](../agent-client/README.md)。完整签名见 [public-api.md](./public-api.md)。
 
-本包自有声明：`BladeProvider`、`BladeProviderProps`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useMessagePin`、`UseMessagePinOptions`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`FollowupInteractionEvent`、`ToolCallRenderer`、`CurrentPlanPanel`、`PlanUpdateBlock`、`PlanUpdateData`、`PlanUpdateDisplayState`、`PlanStepStatus`、`getPlanUpdateDisplayState`、`isPlanUpdateTool`、`parsePlanUpdate`、`pickCurrentPlanStep`、`PLAN_AUTO_COLLAPSE_MS`、`MarkdownContent`、`MarkdownContentProps`、`parseWhatIfPrompt`、`ParsedWhatIfPrompt`、`WhatIfQuote`、`WhatIfUserBubble`、`WhatIfUserBubbleProps`。
+本包自有声明：`BladeProvider`、`BladeProviderProps`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useMessagePin`、`UseMessagePinOptions`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`FollowupInteractionEvent`、`ToolCallRenderer`、`CurrentPlanPanel`、`PlanUpdateBlock`、`PlanUpdateData`、`PlanUpdateDisplayState`、`PlanStepStatus`、`getPlanUpdateDisplayState`、`isPlanUpdateTool`、`parsePlanUpdate`、`pickCurrentPlanStep`、`PLAN_AUTO_COLLAPSE_MS`、`MarkdownContent`、`MarkdownContentProps`、`parseWhatIfPrompt`、`ParsedWhatIfPrompt`、`WhatIfQuote`、`WhatIfUserBubble`、`WhatIfUserBubbleProps`、`SessionQueuePanel`、`SessionQueuePanelProps`。
+
+## 会话消息队列
+
+智能体会话的等待消息由服务端持久化，`ChatView` / `AgentChat` 已在输入框上方渲染队列区域（空队列不占位，条目数超过三条可折叠）。输入框不再有「直接插入 / 排队执行」开关：会话空闲时提交直接开始处理，运行中提交默认入队；暂停时在面板上显示原因和「继续执行」。面板数据来自 `useAgentSession` 状态里的 `queue`（`SessionQueueSnapshot`），可编辑/删除/立即补充的判定来自 agent-client 的 `canEditQueuedMessage` / `canCancelQueuedMessage` / `canDeliverQueuedMessage`，文案用 `queuedMessageStatusLabel` / `queuePauseReasonLabel`。
+
+自建布局可直接使用 `<SessionQueuePanel>`，属性类型为 `SessionQueuePanelProps`：传 `snapshot`、`canDeliver`、可选的 `pendingItemId`（提交中的条目禁用操作）与 `notice`（冲突/失败说明），以及 `onResume` / `onCancel` / `onEdit` / `onMove` / `onReorder` / `onDeliver` 回调。上移/下移与拖动排序最终都提交当前 pending 条目的完整 id 顺序。冲突时队列由服务端快照刷新，`ChatView` 会把未保存的正文放回输入框，不会静默丢掉用户编辑的内容。
 
 `PollingBackoff` 从 agent-client 重导出，供自定义只读轮询计算退避时间；它不发送或重放请求。用法见 [agent-client 轮询说明](../agent-client/README.md#只读轮询退避)。
 

package/dist/components/ChatInput.d.ts

@@ -3,8 +3,8 @@ 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;

package/dist/components/ChatSurface.d.ts

@@ -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/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/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

@@ -1,51 +1,6 @@
 import type { SessionPluginConfigState } from "@blade-hq/agent-client";
-/**
- * JSON Schema (Draft 2020-12) support surface for the shared plugin form.
- *
- * The platform validates with the full standard validator; the form only
- * renders the constructs it can render honestly. Anything outside this list is
- * reported with a located reason instead of being dropped or downgraded to a
- * raw JSON editor — "不支持的呈现明确报错，不静默丢字段".
- */
 export type JsonSchema = Record<string, unknown>;
-export interface Discriminator {
-    key: string;
-    label: string;
-    options: {
-        value: string;
-        label: string;
-    }[];
-}
 export declare function pointerOf(parts: (string | number)[]): string;
 export declare function pointerParts(pointer: string): string[];
-/** Follow intra-document `$ref` chains. Package-relative refs are refused. */
-export declare function resolveNode(root: JsonSchema, node: JsonSchema): JsonSchema | null;
-export declare function nodeTypes(node: JsonSchema): string[];
-export declare function isSecret(node: JsonSchema): boolean;
-export declare function optionsOf(node: JsonSchema): {
-    value: unknown;
-    label: string;
-}[] | null;
-export declare function labelOf(node: JsonSchema, fallback: string): string;
-export declare function hintOf(node: JsonSchema): string | null;
-/**
- * Whether a branch keyword can be rendered, and why not when it cannot.
- *
- * `oneOf` is supported only in the shape a login form actually needs: every
- * branch pins the same discriminator property with `const`. Anything else would
- * mean guessing which fields to show.
- */
-export declare function unsupportedReason(root: JsonSchema, node: JsonSchema, pointer?: string, ancestors?: Set<JsonSchema>): string | null;
-/**
- * The switch a form can render: a property every `oneOf` branch pins with
- * `const`, declared with an `enum` (or `const`) in `properties`.
- */
-export declare function discriminatorOf(root: JsonSchema, node: JsonSchema): Discriminator | null;
-/** Required pointers for the whole document, following the active branch. */
-export declare function requiredPointers(root: JsonSchema, values: Record<string, unknown>): Set<string>;
-/** Whether a subtree holds `writeOnly` anywhere inside it. */
-export declare function containsSecret(root: JsonSchema, node: JsonSchema): boolean;
-export declare function readAt(document: Record<string, unknown>, pointer: string): unknown;
-/** The form's support verdict for a whole declaration. */
 export declare function formSupport(schema: JsonSchema | null): string | null;
 export declare function configIsEditable(state: SessionPluginConfigState): boolean;

package/dist/embed/entry.d.ts

@@ -32,6 +32,15 @@ declare const BladeAgent: {
     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;

package/dist/index.d.ts

@@ -45,6 +45,8 @@ 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";