@blade-hq/agent-react 2610.0.0-beta.6 → 2610.0.0-beta.60

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

@@ -0,0 +1,40 @@
+import type { PluginCatalogEntry, SessionPlugin, SessionPluginConfigSummary } from "@blade-hq/agent-client";
+/**
+ * 连接器面板里的一行插件。
+ *
+ * 展示字段（名称、图标）和启用状态分开表达：目录接口在没有会话时也能给出名称与
+ * 图标，而「这次会话是否启用」只有会话接口知道。首页候选行恒为 `active: false`，
+ * 因为它只是待选，不代表已经激活。
+ */
+export interface PluginConnectorItem {
+    name: string;
+    display_name: string | null;
+    /** 图标 token；null 时显示统一占位，不隐藏整行。 */
+    icon: string | null;
+    /** 图标从哪个接口取：账号级目录，还是会话内已准备的包。 */
+    iconSource: "account" | "session";
+    installed: boolean | null;
+    /** 会话里已提交的选择；首页候选恒为 false。 */
+    active: boolean;
+    status: string;
+    reason?: string | null;
+    config?: SessionPluginConfigSummary;
+    projected: boolean;
+}
+/** 首页候选：只有账号级目录，没有会话状态。 */
+export declare function catalogToConnectorItems(catalog: PluginCatalogEntry[]): PluginConnectorItem[];
+/**
+ * 会话列表叠加账号目录。
+ *
+ * 目录可用时展示字段以目录为准（包可能还没准备，会话列表拿不到名称和图标），
+ * 目录不可用时退回会话行自己的字段，这样已选插件仍然可以取消。
+ */
+export declare function mergeConnectorItems(sessionPlugins: SessionPlugin[], catalog: PluginCatalogEntry[] | null): PluginConnectorItem[];
+/**
+ * 一行的配置说明文案；权威状态来自配置接口。
+ *
+ * `unchecked` 刻意没有文案：列表没有读过用户的 Home，说任何话都是噪音，
+ * 入口是开关本身。
+ */
+/** 按名称和显示名做本地过滤；空查询返回全部。 */
+export declare function filterConnectorItems(items: PluginConnectorItem[], query: string): PluginConnectorItem[];

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

@@ -0,0 +1,40 @@
+import type { BladeClient, SessionPluginActivation, SessionPluginConfigState } from "@blade-hq/agent-client";
+import type { ConfiguringPlugin } from "./PluginConnectorList";
+import { type PluginConnectorItem } from "./plugin-connector";
+export interface UseSessionPluginActivationResult {
+    items: PluginConnectorItem[];
+    loading: boolean;
+    /** 插件列表本身读不到（Hub 不可用等），已有选择仍然可取消。 */
+    listError: boolean;
+    /** 某次启用/停用/准备失败了。 */
+    mutationError: boolean;
+    /** 正在为哪些插件提交意图；对应的开关在转圈，但仍然可点（点是取消）。 */
+    inFlight: Record<string, true>;
+    busy: boolean;
+    configuring: ConfiguringPlugin | null;
+    reload: () => void;
+    toggle: (item: PluginConnectorItem, next: boolean) => void;
+    retry: (item: PluginConnectorItem) => void;
+    editConfig: (item: PluginConnectorItem) => void;
+    onConfigSaved: (state: SessionPluginConfigState) => void;
+    onConfigClose: () => void;
+}
+/**
+ * 会话内插件启用的唯一实现。
+ *
+ * 顺序是「先准备配置，再提交 activation」：缺配置时开关不落到已启用、立刻弹表单，
+ * 保存成功才提交；取消、校验失败、配置读取失败都不提交。绝不先持久化 active=true
+ * 再靠补偿关掉——那样用户下次刷新会看到一个从没被成功打开的插件。
+ *
+ * 停用仍然直接提交：在服务端它只是取消一条数据库选择，不准备包、不连 MCP。但如果
+ * 这次「启用」只是还在准备、压根没提交过 activation，取消就只是放弃本地意图。
+ *
+ * 所有异步响应都按 (lifetime, mutation) 校验：迟到的准备或激活结果不会把已经取消 /
+ * 已经切走会话的插件重新打开；反过来，旧响应发现服务端落库顺序与用户最新意图不同时，
+ * 会重新提交最新意图。
+ */
+export declare function useSessionPluginActivation({ client, sessionId, onChange, }: {
+    client: BladeClient;
+    sessionId: string;
+    onChange?: (plugin: SessionPluginActivation) => void;
+}): UseSessionPluginActivationResult;

package/dist/context.d.ts

@@ -11,3 +11,4 @@ export interface BladeProviderProps {
 export declare function BladeProvider({ client, children }: BladeProviderProps): import("react/jsx-runtime").JSX.Element;
 /** 读取当前 BladeProvider 提供的 client。不在 Provider 内使用时抛错。 */
 export declare function useBladeClient(): BladeClient;
+export declare function useOptionalBladeClient(): BladeClient | null;

package/dist/embed/entry.d.ts

@@ -18,18 +18,45 @@ declare function getChat(element: Element | null): Promise<AgentSession>;
 declare const BladeAgent: {
     BladeClient: typeof agentClient.BladeClient;
     BladeApiError: typeof agentClient.BladeApiError;
+    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;
     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;
     buildMessageContent: typeof agentClient.buildMessageContent;
+    chatErrorForDisplay: typeof agentClient.chatErrorForDisplay;
     contentPreview: typeof agentClient.contentPreview;
     extractTextAttachments: typeof agentClient.extractTextAttachments;
     getFileParts: typeof agentClient.getFileParts;
@@ -39,7 +66,20 @@ declare const BladeAgent: {
     isHiddenInternalMessage: typeof agentClient.isHiddenInternalMessage;
     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;
@@ -70,7 +110,11 @@ declare const BladeAgent: {
         disable_tools?: string[] | undefined;
         runtime_type?: string | null | undefined;
         daemon_id?: string | null | undefined;
+        agent_runtime_id?: string | null | undefined;
         workspace_path?: string | null | undefined;
+        ba_version?: string | null | undefined;
+        sandbox_version?: string | null | undefined;
+        chat_group_id?: string | null | undefined;
         match?: unknown;
     }, {}>;
     SessionStatus: import("arktype/internal/variants/string.ts").StringType<"completed" | "created" | "failed" | "interrupted" | "running" | "waiting_for_input", {}>;
@@ -86,7 +130,10 @@ declare const BladeAgent: {
     }, {}>;
     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;
     getChat: typeof getChat;
     BladeChatElement: typeof BladeChatElement;

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/hooks/use-agent-session.d.ts

@@ -4,6 +4,11 @@ export interface UseAgentSessionOptions {
     createOptions?: CreateSessionRequest;
     /** 自动创建出的 sessionId 通过此回调交还调用方持有（重挂载复用的依据）。 */
     onSessionCreated?: (sessionId: string) => void;
+    /**
+     * 会话进入实时事件路由后、历史加载与房间订阅开始前同步执行。
+     * 返回的清理函数会在切换会话或卸载时执行。
+     */
+    onSessionConnected?: (session: AgentSession) => () => void;
 }
 export interface UseAgentSessionResult {
     /** 连接/创建完成前为 null。 */

package/dist/hooks/use-message-pin.d.ts

@@ -0,0 +1,28 @@
+export interface UseMessagePinOptions {
+    targetKey: string | null;
+    pinTarget: boolean;
+    /**
+     * 省略时按旧行为处理（视为一直流式中，只靠 targetKey 变化释放）——
+     * useMessagePin 是导出的公开 hook，加这个字段前如果直接改成必填，
+     * 所有已经在调用这个 hook 的外部使用方都会编译不过。
+     */
+    isStreaming?: boolean;
+    layoutKey?: string;
+    getScrollElement: () => HTMLElement | null;
+    getContentElement?: () => HTMLElement | null;
+    getTargetElement: () => HTMLElement | null;
+    getTargetScrollTop?: (scroll: HTMLElement) => number | null;
+    getSpacerHeight: () => number;
+    setSpacerHeight: (height: number) => void;
+    stopAutoScroll: () => void;
+    scrollToBottom: () => void;
+    margin?: number;
+}
+/**
+ * 用户发言顶置的共享状态机。SDK 和内置轻量列表只提供 DOM/虚拟列表适配器，
+ * 触发、调度、resize、手动接管和跟随交还的决策只在这里维护。
+ */
+export declare function useMessagePin({ targetKey, pinTarget, isStreaming, layoutKey, getScrollElement, getContentElement, getTargetElement, getTargetScrollTop, getSpacerHeight, setSpacerHeight, stopAutoScroll, scrollToBottom, margin, }: UseMessagePinOptions): {
+    release: () => void;
+    isActive: () => boolean;
+};

package/dist/index.d.ts

@@ -5,19 +5,60 @@ export type { UseAgentSessionOptions, UseAgentSessionResult } from "./hooks/use-
 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 type { ChatCompletionTool, LlmChatOptions, LlmToolCall, UseLlmChatResult, } from "./hooks/use-llm-chat";
 export { ChatView } from "./components/ChatView";
 export type { ChatViewClassNames, ChatViewProps, ChatViewRenderers, ChatViewSlots, FollowupInteractionEvent, } 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 { normalizeAdjacentUrlFormatting } from "./components/MarkdownContent";
 export type { MarkdownContentProps } from "./components/MarkdownContent";
+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 { 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";