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

package/dist/components/AgentChat.d.ts

@@ -1,4 +1,5 @@
 import type { AgentSession, CreateSessionRequest } from "@blade-hq/agent-client";
+import { type ReactNode } from "react";
 import { type ChatPresentationProps } from "./ChatSurface";
 import type { FollowupInteractionEvent } from "./PostChatFollowupBlock";
 export interface AgentChatProps extends ChatPresentationProps {
@@ -13,6 +14,8 @@ export interface AgentChatProps extends ChatPresentationProps {
     onSessionReady?: (session: AgentSession) => void;
     /** 智能体下发给宿主页面的指令处理器（action → handler）。 */
     commands?: Record<string, (data: unknown) => void>;
+    /** 覆盖默认会话插件选择器。 */
+    sessionPluginControls?: (sessionId: string) => ReactNode;
 }
 /**
  * 智能体模式的聊天界面：连接（或新建）一个 Blade 会话，渲染消息流与输入框。

package/dist/components/AgentLoopBlock.d.ts

@@ -2,9 +2,6 @@ import type { ToolCallInfo } from "@blade-hq/agent-client";
 interface Props {
     toolCall: ToolCallInfo;
 }
-/**
- * 子智能体（fork Agent）状态块的 SDK 简化版：只展示描述、状态与最终结果，
- * 不再嵌套渲染子循环的完整消息流（那是第一方界面的能力）。
- */
+/** SDK 没有第一方子循环消息流，只保留轻量意图行和可展开的最终结果。 */
 export declare function AgentLoopBlock({ toolCall }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/AskUserQuestionBlock.d.ts

@@ -28,4 +28,13 @@ interface Props {
 export declare function AskUserQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer, }: Props): import("react/jsx-runtime").JSX.Element;
 /** 解析 AskUserQuestion 的工具结果/参数，容错 LLM 把 questions 输出为字符串的情况。 */
 export declare function parseAskUserQuestion(toolResult: string | null | undefined): AskUserQuestionData | null;
+export interface AskUserQuestionError {
+    message: string;
+    detail: string | null;
+}
+/**
+ * Keep this parser synchronized with apps/web/AskUserQuestionBlock.tsx.
+ * The built-in Web cannot import agent-react, and this is not a public SDK protocol API.
+ */
+export declare function parseAskUserQuestionError(toolResult: string | null | undefined): AskUserQuestionError | null;
 export {};

package/dist/components/AssistantTurnBlock.d.ts

@@ -1,4 +1,4 @@
-import type { AskUserAnswerData, ChatMessage } from "@blade-hq/agent-client";
+import type { AskUserAnswerData, ChatMessage, MemoryRefInfo } from "@blade-hq/agent-client";
 import { type ToolCallRenderer } from "./ToolCallBlock";
 interface Props {
     messages: ChatMessage[];
@@ -7,12 +7,26 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     sessionStatus?: string;
     toolCallRenderer?: ToolCallRenderer;
+    /** Agent 模式把 update_plan 收口到输入框上方的任务面板；纯 LLM 同名工具照常展示。 */
+    hidePlanUpdateTools?: boolean;
     /** 会话 id；传给 Markdown 渲染的统一上下文。 */
     sessionId?: string;
 }
-/**
- * 一轮助手回复：按消息顺序渲染 thinking 折叠块、正文 Markdown 与工具调用。
- * 相比第一方版本去掉了紧凑/详细模式切换、文件交付卡片与内联资源 iframe。
- */
-export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
+export type TurnDisplayMode = "compact" | "detail";
+export declare function resolveTurnDisplayMode({ isStreaming: _isStreaming, displayMode, }: {
+    isStreaming: boolean;
+    displayMode: TurnDisplayMode;
+}): TurnDisplayMode;
+export declare function formatExecutionDuration(durationMs: number): string;
+export declare function getExecutionDurationMs({ messages, isStreaming, now, }: {
+    messages: ChatMessage[];
+    isStreaming: boolean;
+    now?: number;
+}): number;
+/** 一轮助手回复：执行过程默认折叠，最终正文始终显示在摘要下方。 */
+export declare function AssistantTurnBlock({ messages, isStreaming, askAnswers, onAnswer, sessionStatus, toolCallRenderer, hidePlanUpdateTools, sessionId, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function collectMemoryRefs(messages: ChatMessage[]): MemoryRefInfo[];
+export declare function MemoryRefsHint({ refs }: {
+    refs: MemoryRefInfo[];
+}): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ChatInput.d.ts

@@ -3,16 +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;
     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, onStop, isStreaming, isStopping, placeholder, className, }: 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,6 +45,7 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     onInputChange: (value: string) => void;
     onSuggestion?: (value: string) => void;
     onSend: (text: string) => Promise<boolean>;
+    onAppend?: (text: string) => void;
     onStop: () => void;
     sessionStatus?: string;
     askAnswers?: Record<string, AskUserAnswerData>;
@@ -55,6 +56,16 @@ interface ChatSurfaceProps extends ChatPresentationProps {
     onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
     /** 输入框上方的内部区域（纯 LLM 模式的高级设置用）。不传时不渲染任何节点。 */
     beforeInput?: ReactNode;
+    /** 仅 Agent 模式启用 Blade 的 update_plan 面板。 */
+    showPlanUpdates?: boolean;
+    /** 仅实时成功的 update_plan 递增；历史 hydration 不得改变。 */
+    planRevealRevision?: number;
+    historyPaging?: {
+        hasOlder: boolean;
+        loading: boolean;
+        /** Resolves true only when the paging cursor advanced. */
+        loadOlder: (beforeCommit?: () => void) => Promise<boolean>;
+    };
     /** 连接状态条下方的横幅（回放模式条用）。不传时不渲染任何节点。 */
     banner?: ReactNode;
 }
@@ -64,5 +75,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, onStop, sessionStatus, askAnswers, onAnswer, sessionId, isViewer, resultFeedbackByEntry, onResultFeedbackSaved, onFollowupInteraction, beforeInput, 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, showPlanUpdates, planRevealRevision, historyPaging, banner, }: ChatSurfaceProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ConnectionBanner.d.ts

@@ -3,6 +3,6 @@ interface Props {
     connection: ConnectionStatus;
     className?: string;
 }
-/** 连接状态提示条：数据来自 SessionState.connection，正常连接时不渲染。 */
+/** 连接状态提示条：短暂断线静默，超过容错时间后再逐级提示。 */
 export declare function ConnectionBanner({ connection, className }: Props): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/ContextCard.d.ts

@@ -0,0 +1,20 @@
+import { type ContextProjectionData } from "@blade-hq/agent-client";
+export interface ContextCardProps {
+    context: ContextProjectionData;
+    className?: string;
+}
+/** Business-facing Context summary. Native details keeps every card collapsed by default. */
+export declare function ContextCard({ context, className }: ContextCardProps): import("react/jsx-runtime").JSX.Element;
+export interface ContextGroupCardProps {
+    contexts: readonly ContextProjectionData[];
+    className?: string;
+}
+/**
+ * 一批上下文注入折叠成一行。会话首轮会一次注入十几个原子，一条一张卡片会把
+ * 真正的对话挤出屏幕。
+ *
+ * 单条和多条**共用同一个 details 外壳**，不在数量变化时切换组件：流式时第二条
+ * 到达会让这一行从单条变成多条，组件类型一换 React 就重挂 <details>，
+ * 用户刚展开的行会被收起来。同理，key 由调用方按组内第一条给，不能带数量。
+ */
+export declare function ContextGroupCard({ contexts, className }: ContextGroupCardProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/MarkdownContent.d.ts

@@ -1,3 +1,5 @@
+/** Keep inline formatting markers from being consumed by URL autolinking. */
+export declare function normalizeAdjacentUrlFormatting(value: string): string;
 export interface MarkdownContentProps {
     children: string;
     className?: string;

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/MessageList.d.ts

@@ -11,6 +11,7 @@ interface Props {
     askAnswers?: Record<string, AskUserAnswerData>;
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
     toolCallRenderer?: ToolCallRenderer;
+    hidePlanUpdateTools?: boolean;
     emptyState?: ReactNode;
     className?: string;
     /** 会话 id；传给助手消息的统一上下文。 */
@@ -19,10 +20,16 @@ interface Props {
     onFollowupInteraction?: (event: FollowupInteractionEvent) => void;
     resultFeedbackByEntry?: ReadonlyMap<string, ResultFeedback>;
     onResultFeedbackSaved?: (feedback: ResultFeedback) => void;
+    historyPaging?: {
+        hasOlder: boolean;
+        loading: boolean;
+        /** Resolves true only when the paging cursor advanced. */
+        loadOlder: (beforeCommit?: () => void) => Promise<boolean>;
+    };
 }
 /**
  * 消息列表：use-stick-to-bottom 自动滚动 + 按轮次分组渲染。
  * 相比第一方版本去掉了轮次导航栏、吸顶状态条与规划摘要卡片。
  */
-export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, emptyState, className, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function MessageList({ messages, postChatFollowup, onSuggestion, isStreaming, sessionStatus, askAnswers, onAnswer, toolCallRenderer, hidePlanUpdateTools, emptyState, className, sessionId, isViewer, onFollowupInteraction, resultFeedbackByEntry, onResultFeedbackSaved, historyPaging, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/PlanUpdateBlock.d.ts

@@ -0,0 +1,31 @@
+import type { ChatMessage, ToolCallInfo } from "@blade-hq/agent-client";
+export type PlanStepStatus = "pending" | "in_progress" | "completed";
+export interface PlanUpdateData {
+    plan: Array<{
+        step: string;
+        status: PlanStepStatus;
+    }>;
+}
+export declare const PLAN_AUTO_COLLAPSE_MS = 5000;
+export declare function isPlanUpdateTool(toolCall: Pick<ToolCallInfo, "name">): boolean;
+export interface PlanUpdateDisplayState {
+    current: ToolCallInfo | null;
+    updating: boolean;
+}
+export declare function getPlanUpdateDisplayState(messages: ChatMessage[]): PlanUpdateDisplayState;
+export declare function parsePlanUpdate(argumentsJson: string): PlanUpdateData | null;
+export declare function pickCurrentPlanStep(plan: PlanUpdateData["plan"]): PlanUpdateData["plan"][number] | null;
+export declare function PlanUpdateBlock({ toolCall, running, autoReveal, }: {
+    toolCall: ToolCallInfo;
+    running?: boolean;
+    /** 实时收到的新进度短暂展开；加载历史时保持默认收起。 */
+    autoReveal?: boolean;
+}): 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/SessionMemoryToggle.d.ts

@@ -0,0 +1,19 @@
+import type { BladeClient } from "@blade-hq/agent-client";
+export interface SessionMemoryToggleProps {
+    sessionId: string;
+    enabled: boolean;
+    /** 不在 BladeProvider 内使用时显式传入，与宿主现有 BladeClient 复用连接和鉴权。 */
+    client?: BladeClient;
+    disabled?: boolean;
+    label?: string;
+    className?: string;
+    labelClassName?: string;
+    inputClassName?: string;
+    onSaved?: (sessionId: string, enabled: boolean) => void;
+    onError?: (error: unknown) => void;
+}
+/**
+ * 当前会话记忆开关。同一 client + sessionId 的所有实例共享保存锁，避免多个聊天入口
+ * 或会话切换时发出乱序更新；服务端成功后才通过 onSaved 交还权威值。
+ */
+export declare function SessionMemoryToggle({ sessionId, enabled, client: clientProp, disabled, label, className, labelClassName, inputClassName, onSaved, onError, }: SessionMemoryToggleProps): 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/SessionPluginSelector.d.ts

@@ -0,0 +1,10 @@
+import type { BladeClient, SessionPluginActivation } from "@blade-hq/agent-client";
+export interface SessionPluginSelectorProps {
+    client: BladeClient;
+    sessionId: string;
+    className?: string;
+    side?: "top" | "bottom";
+    onChange?: (plugin: SessionPluginActivation) => void;
+}
+/** Shared selector for AgentChat and the built-in Web; no external query provider required. */
+export declare function SessionPluginSelector(props: SessionPluginSelectorProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ToolCallBlock.d.ts

@@ -8,6 +8,7 @@ interface Props {
     answered?: boolean;
     answerData?: AskUserAnswerData;
     sessionStatus?: string;
+    isActiveQuestion?: boolean;
     renderer?: ToolCallRenderer;
 }
 /**
@@ -19,10 +20,11 @@ interface Props {
  * 会同时把已经回答过的旧提问重新变成可作答（历史加载不会带回 answerData），
  * 而且会盖住投影层的错误——这个 bug 就是这么藏住的。
  */
-export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, }: {
+export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fallbackAnswered, fallbackAwaiting, }: {
     toolStatus: ToolCallInfo["status"];
     hasAnswerData: boolean;
     fallbackAnswered?: boolean;
+    fallbackAwaiting?: boolean;
 }): {
     awaitingAnswer: boolean;
     answered: boolean;
@@ -31,5 +33,5 @@ export declare function resolveAskQuestionState({ toolStatus, hasAnswerData, fal
  * 极简工具调用块：状态 + 展示名一行，点开后是参数/结果的 <pre> 折叠展示。
  * AskUserQuestion 特殊处理为提问选项卡片。
  */
-export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, renderer, }: Props): import("react/jsx-runtime").JSX.Element;
+export declare function ToolCallBlock({ toolCall, onAnswer, answered, answerData, sessionStatus, isActiveQuestion, renderer, }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

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/UserMessageBubble.d.ts

@@ -11,7 +11,7 @@ interface UserMessageProps {
     message: UserChatMessage;
     className?: string;
 }
-/** 用户消息气泡：文本 + 图片/文件附件展示（不含第一方的预览弹窗与 what-if 徽章）。 */
+/** 用户消息气泡：文本、canonical 引用消息与图片/文件附件。 */
 export declare function UserMessageBubble({ message, className }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
 /** 错误消息：居中红色提示条。 */
 export declare function ErrorMessageBlock({ message, className, }: {

package/dist/components/WhatIfUserBubble.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedWhatIfPrompt } from "../lib/whatif-prompt";
+export interface WhatIfUserBubbleProps {
+    parsed: ParsedWhatIfPrompt;
+    onQuoteClick?: (stepNumber: number) => void;
+}
+/** SDK 与内置 Web 共用的 canonical 引用消息渲染。 */
+export declare function WhatIfUserBubble({ parsed, onQuoteClick }: WhatIfUserBubbleProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/display-utils.d.ts

@@ -1,7 +1,17 @@
 import type { ToolCallInfo } from "@blade-hq/agent-client";
 export type ToolTone = "emerald" | "blue" | "amber" | "red";
+/**
+ * 技能入口文件的所在目录就是技能名（`.agent/skills/<技能名>/SKILL.md`）。
+ * 只显示 "SKILL.md" 用户看不出读的是哪个技能。
+ *
+ * 改这里必须同步 apps/web/src/agent/components/chat/display-utils.ts 的同名函数。
+ */
+export declare function getSkillNameFromFilePath(filePath: string | null | undefined): string | null;
 /** 归一化工具名：去掉命名空间前缀并映射到别名表（如 "fork:Agent" → "Agent"）。 */
 export declare function formatToolName(name: string): string;
+export declare function extractToolFilePath(toolCall: ToolCallInfo): string | null;
+/** 从文件类工具参数中提取全部可定位的文件路径（按出现顺序去重）。 */
+export declare function extractToolFilePaths(toolCall: ToolCallInfo): string[];
 /**
  * 返回工具调用的中文展示标签：优先取参数里的 description，
  * 其次取后端下发的 display_name / 系统工具中文名。

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

@@ -0,0 +1,51 @@
+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/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,35 @@ 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;
     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;
+    ChatProjectsResource: typeof agentClient.ChatProjectsResource;
+    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 +56,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 +100,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_project_id?: string | null | undefined;
         match?: unknown;
     }, {}>;
     SessionStatus: import("arktype/internal/variants/string.ts").StringType<"completed" | "created" | "failed" | "interrupted" | "running" | "waiting_for_input", {}>;
@@ -86,7 +120,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;
+};