@blade-hq/agent-react 2612.0.0-beta.3 → 2612.0.0-beta.5

package/README.md

@@ -471,3 +471,13 @@ blade-chat::part(input-toolbar) { gap: 12px; }
 完整签名见 [public-api.md](./public-api.md)。本包公开声明：`BladeProvider`、`BladeProviderProps`、`BladeHost`、`HostAttachment`、`HostCatalogItem`、`useBladeClient`、`useAgentSession`、`UseAgentSessionOptions`、`UseAgentSessionResult`、`useReplay`、`UseReplayResult`、`ReplayMismatch`、`ReplayBar`、`ReplayBarProps`、`ReplayMismatchPrompt`、`ReplayMismatchPromptProps`、`ChatView`、`ChatViewProps`、`ChatViewClassNames`、`ChatViewRenderers`、`ChatViewSlots`、`UserMessageRendererProps`、`AssistantTextRendererProps`、`AskUserQuestionRendererProps`、`AskUserQuestionData`、`PlanUpdateRendererProps`、`PlanUpdateData`、`PlanStepStatus`、`ToolCallRenderer`、`ToolRendererProps`、`FollowupInteractionEvent`、`LlmChatHandle`、`LlmChatOptions`、`ChatCompletionTool`、`LlmToolCall`、`MarkdownContent`、`MarkdownContentProps`。
 
 `@blade-hq/agent-client` 不再从本包转出，`BladeClient`、`AgentSession` 等直接从 `@blade-hq/agent-client` import。
+
+## 主题资产 @
+
+主题资产候选通过当前主题的资产列表获取，使用专用 `TopicAssetMention` 药丸；没有关联主题时不展示候选。首页与会话输入框复用候选查询、引用序列化和展示结构。
+
+`queueTopicAssetReference(sessionId, { topic_id, path })`（`@blade-hq/agent-react/rich-input`）可在导航到当前用户的同主题会话前预填引用。发送只携带引用身份，元数据和权限由服务端重新判断；本轮续跑保留引用，下一条消息默认不继承。
+
+会话文件树可通过宿主提供的提交动作显示“提交到资产”；只读或未关联主题时不显示写入口，服务端仍会独立检查权限。
+
+文件提交共享组件：`TopicAssetSubmitDialog`（属性 `TopicAssetSubmitDialogProps`）提供目录选择和提交说明；`useTopicAssetSubmissionAccess` 查询当前会话的主题及写权限。二者用于宿主文件树接入，不能替代服务端鉴权。

package/dist/chat/customization.d.ts

@@ -30,7 +30,7 @@ export type ChatViewClassNames = Partial<{
     skillStatusBarInner: string;
 }>;
 /** 输入框提交时的附加项（模型、推理档位、知识库等由富输入给出）。 */
-export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "kbIds" | "queueWhenRunning"> {
+export interface ChatSendOptions extends Pick<ChatSendExtras, "thinkingOverride" | "reasoningLevel" | "kbIds" | "topicAssetRefs" | "queueWhenRunning"> {
     /** 附件实际上传到的会话（首页新建会话时由输入框给出）。 */
     targetSessionId?: string;
     /** 本条消息用的模型；null 表示沿用会话已保存的模型。 */

package/dist/chat/runtime/actions.d.ts

@@ -10,6 +10,7 @@ export interface ChatSendExtras {
     thinkingOverride?: boolean;
     reasoningLevel?: string;
     kbIds?: number[];
+    topicAssetRefs?: SendOptions["topicAssetRefs"];
     whatif?: SendOptions["whatif"];
     replayDecision?: SendOptions["replayDecision"];
     /**

package/dist/chat/runtime/composer-channels.d.ts

@@ -1,3 +1,4 @@
+import { type TopicAssetRef } from "@blade-hq/agent-client";
 export interface PendingContextSignal {
     id: string;
     label: string;
@@ -13,6 +14,7 @@ export interface SendRequestSignal {
     id: string;
 }
 export interface ComposerChannelsState {
+    topicAssetReferences: Record<string, TopicAssetRef[]>;
     pendingContexts: Record<string, PendingContextSignal[]>;
     draftAppends: Record<string, DraftAppendSignal[]>;
     sendRequests: Record<string, SendRequestSignal[]>;
@@ -21,6 +23,8 @@ export interface ComposerChannelsState {
 }
 export declare const composerChannels: {
     getState: () => ComposerChannelsState;
+    addTopicAssetReference(sessionId: string, ref: TopicAssetRef): void;
+    consumeTopicAssetReferences: (sessionId: string) => TopicAssetRef[];
     subscribe(listener: () => void): () => void;
     addPendingContext(sessionId: string, context: Omit<PendingContextSignal, "id">): void;
     removePendingContext(sessionId: string, contextId: string): void;

package/dist/{chunk-WCMGQJLE.js → chunk-7IPINZHT.js}

@@ -6,7 +6,7 @@ import {
   catalogToConnectorItems,
   filterConnectorItems,
   useSessionPluginActivation
-} from "./chunk-FQQJP2GJ.js";
+} from "./chunk-XULCQP3Q.js";
 
 // src/components/connector-panel-types.ts
 function selectionFromItem(item) {
@@ -255,4 +255,4 @@ export {
   ConnectorPanel,
   PluginTriggerStack
 };
-//# sourceMappingURL=chunk-WCMGQJLE.js.map
+//# sourceMappingURL=chunk-7IPINZHT.js.map

package/dist/{chunk-5J54S5BK.js → chunk-T5WGKZN4.js}

@@ -24,6 +24,7 @@ import {
   Dialog,
   DialogClose,
   DialogContent,
+  DialogDescription,
   DialogTitle,
   Download,
   Earth,
@@ -120,7 +121,7 @@ import {
   useSessionSource,
   useSessionState,
   useSingleSessionSource
-} from "./chunk-FQQJP2GJ.js";
+} from "./chunk-XULCQP3Q.js";
 import {
   __export
 } from "./chunk-PR4QN5HX.js";
@@ -38728,9 +38729,14 @@ function UserMessageBubble({ message, className }) {
     contexts: textContexts
   } = extractTextAttachments(message.content);
   const trimmedClean = cleanText.trim();
+  const topicAssetPills = message.topic_asset_refs?.length ? /* @__PURE__ */ jsx34("div", { className: "flex max-w-full flex-wrap justify-end gap-1.5", "aria-label": "\u5F15\u7528\u7684\u4E3B\u9898\u8D44\u4EA7", children: message.topic_asset_refs.map((ref) => /* @__PURE__ */ jsxs29("span", { title: ref.path, className: "max-w-full truncate rounded-full border border-border bg-muted px-2.5 py-1 text-xs text-foreground", children: [
+    "\u4E3B\u9898\u8D44\u4EA7 \xB7 ",
+    ref.path
+  ] }, `${ref.topic_id}:${ref.path}`)) }) : null;
   const whatifParsed = trimmedClean && imageParts.length === 0 && fileParts.length === 0 && textAttachments.length === 0 ? parseWhatIfPrompt(cleanText) : null;
   if (whatifParsed && customBubble == null) {
     return /* @__PURE__ */ jsx34("div", { part: "user-row", className: "blade-chat-user-row flex justify-end", children: /* @__PURE__ */ jsxs29("div", { className: "blade-chat-user-col group flex max-w-[72%] flex-col items-end gap-2", children: [
+      topicAssetPills,
       /* @__PURE__ */ jsx34(WhatIfUserBubble, { parsed: whatifParsed }),
       whatifParsed.userText && /* @__PURE__ */ jsx34(
         MessageActions,
@@ -38866,6 +38872,7 @@ function UserMessageBubble({ message, className }) {
       }
     ),
     /* @__PURE__ */ jsx34(MessageContextPills, { contexts: textContexts }),
+    topicAssetPills,
     trimmedClean && // 原型：不对称圆角（指向发送侧的一角收窄），无边框、无内阴影。
     (customBubble != null ? customBubble : /* @__PURE__ */ jsx34(
       "div",
@@ -48240,6 +48247,7 @@ function ChatPanel({
         thinkingOverride: options?.thinkingOverride,
         reasoningLevel: options?.reasoningLevel,
         kbIds: options?.kbIds,
+        topicAssetRefs: options?.topicAssetRefs,
         queueWhenRunning: options?.queueWhenRunning
       });
     },
@@ -49291,6 +49299,99 @@ function ChatView(props) {
   return /* @__PURE__ */ jsx54(AgentChat, { ...rest });
 }
 
+// src/components/TopicAssetSubmitDialog.tsx
+import { useRef as useRef29, useState as useState40 } from "react";
+import { jsx as jsx55, jsxs as jsxs48 } from "react/jsx-runtime";
+function useTopicAssetSubmissionAccess(sessionId) {
+  const client = useBladeClient();
+  return useAsyncValue(sessionId, async (signal) => {
+    if (!sessionId) return null;
+    const [session, groups] = await Promise.all([
+      client.sessions.getSession(sessionId, { signal }),
+      client.chatGroups.list()
+    ]);
+    if (session.runtime_type !== "sandbox" || !session.chat_group_id || session.viewer_role === "viewer") return null;
+    const group = groups.find((item) => item.id === session.chat_group_id);
+    return group && (group.role === "owner" || group.role === "editor") ? group : null;
+  });
+}
+function TopicAssetSubmitDialog({ sessionId, topicId, path: path2, onClose, onSubmitted }) {
+  const client = useBladeClient();
+  const [folder, setFolder] = useState40("");
+  const [message, setMessage] = useState40("");
+  const [error61, setError] = useState40(null);
+  const [busy, setBusy] = useState40(false);
+  const submitting = useRef29(false);
+  const [revision, setRevision] = useState40(0);
+  const assets = useAsyncValue(`${sessionId}:${topicId}:${revision}`, async () => {
+    const [session, groups, result] = await Promise.all([
+      client.sessions.getSession(sessionId),
+      client.chatGroups.list(),
+      client.chatGroups.listAssets(topicId)
+    ]);
+    const role = groups.find((item) => item.id === topicId)?.role;
+    if (session.runtime_type !== "sandbox" || session.chat_group_id !== topicId || session.viewer_role === "viewer") throw new Error("\u8FD9\u4E2A\u4F1A\u8BDD\u4E0D\u80FD\u63D0\u4EA4\u5230\u8BE5\u4E3B\u9898");
+    if (role !== "owner" && role !== "editor") throw new Error("\u4F60\u5728\u8FD9\u4E2A\u4E3B\u9898\u6CA1\u6709\u63D0\u4EA4\u6743\u9650");
+    const folders = /* @__PURE__ */ new Set();
+    for (const asset of result.items) {
+      if (asset.is_dir) folders.add(asset.path);
+      const parts = asset.path.split("/");
+      for (let i2 = 1; i2 < parts.length; i2 += 1) folders.add(parts.slice(0, i2).join("/"));
+    }
+    return [...folders].sort((a, b2) => a.localeCompare(b2));
+  });
+  const submit = async () => {
+    if (submitting.current || !assets.data) return;
+    submitting.current = true;
+    setBusy(true);
+    setError(null);
+    try {
+      const name = path2.split("/").at(-1) ?? path2;
+      await client.chatGroups.submitSessionAsset({ session_id: sessionId, path: path2, target_path: folder ? `${folder}/${name}` : name, message: message.trim() });
+      onSubmitted?.();
+      onClose();
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : "\u63D0\u4EA4\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5");
+    } finally {
+      submitting.current = false;
+      setBusy(false);
+    }
+  };
+  return /* @__PURE__ */ jsx55(Dialog, { open: true, onOpenChange: (open2) => {
+    if (!open2 && !busy) onClose();
+  }, children: /* @__PURE__ */ jsxs48(DialogContent, { className: "max-w-md", children: [
+    /* @__PURE__ */ jsx55(DialogTitle, { children: "\u63D0\u4EA4\u5230\u8D44\u4EA7" }),
+    /* @__PURE__ */ jsx55(DialogDescription, { children: "\u5C06\u6587\u4EF6\u590D\u5236\u5230\u4E3B\u9898\u4F9B\u6210\u5458\u4F7F\u7528\uFF0C\u5DE5\u4F5C\u533A\u539F\u6587\u4EF6\u4F1A\u4FDD\u7559\u3002\u540C\u540D\u8D44\u4EA7\u4F1A\u88AB\u66FF\u6362\u3002" }),
+    /* @__PURE__ */ jsxs48("form", { onSubmit: (event) => {
+      event.preventDefault();
+      void submit();
+    }, className: "flex flex-col gap-4", children: [
+      /* @__PURE__ */ jsx55("p", { className: "break-all text-sm text-secondary-foreground", children: path2 }),
+      /* @__PURE__ */ jsxs48("label", { className: "flex flex-col gap-1 text-sm", children: [
+        "\u76EE\u6807\u6587\u4EF6\u5939",
+        /* @__PURE__ */ jsxs48("select", { "aria-label": "\u76EE\u6807\u6587\u4EF6\u5939", value: folder, onChange: (event) => setFolder(event.target.value), disabled: busy || !assets.data, className: "rounded-md border border-border bg-background p-2", children: [
+          /* @__PURE__ */ jsx55("option", { value: "", children: "\u8D44\u4EA7\u6839\u76EE\u5F55" }),
+          assets.data?.map((item) => /* @__PURE__ */ jsx55("option", { value: item, children: item }, item))
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs48("label", { className: "flex flex-col gap-1 text-sm", children: [
+        "\u8BF4\u660E\uFF08\u53EF\u9009\uFF09",
+        /* @__PURE__ */ jsx55("textarea", { "aria-label": "\u63D0\u4EA4\u8BF4\u660E", value: message, onChange: (event) => setMessage(event.target.value), maxLength: 1e3, disabled: busy, className: "min-h-20 rounded-md border border-border bg-background p-2" })
+      ] }),
+      assets.error ? /* @__PURE__ */ jsxs48("div", { role: "alert", className: "text-sm text-muted-foreground", children: [
+        assets.error instanceof Error ? assets.error.message : "\u8D44\u4EA7\u52A0\u8F7D\u5931\u8D25",
+        " ",
+        /* @__PURE__ */ jsx55("button", { type: "button", onClick: () => setRevision((n2) => n2 + 1), className: "underline", children: "\u91CD\u8BD5" })
+      ] }) : !assets.data ? /* @__PURE__ */ jsx55("output", { className: "text-sm text-muted-foreground", children: "\u6B63\u5728\u52A0\u8F7D\u8D44\u4EA7\u2026" }) : null,
+      error61 ? /* @__PURE__ */ jsx55("p", { role: "alert", className: "text-sm text-muted-foreground", children: error61 }) : null,
+      /* @__PURE__ */ jsxs48("div", { className: "flex justify-end gap-2", children: [
+        /* @__PURE__ */ jsx55("button", { type: "button", disabled: busy, onClick: onClose, className: "rounded-md border border-border px-3 py-2 text-sm", children: "\u53D6\u6D88" }),
+        /* @__PURE__ */ jsx55("button", { type: "submit", disabled: busy || !assets.data, className: "rounded-md bg-primary px-3 py-2 text-sm text-primary-foreground disabled:opacity-50", children: busy ? "\u63D0\u4EA4\u4E2D\u2026" : "\u63D0\u4EA4" })
+      ] })
+    ] })
+  ] }) });
+}
+
 export {
   useAgentSession,
   useReplay,
@@ -49319,7 +49420,9 @@ export {
   AgentChat,
   useLlmChat,
   LlmChat,
-  ChatView
+  ChatView,
+  useTopicAssetSubmissionAccess,
+  TopicAssetSubmitDialog
 };
 /*! Bundled license information:
 
@@ -49340,4 +49443,4 @@ use-stick-to-bottom/dist/StickToBottom.js:
 js-yaml/dist/js-yaml.mjs:
   (*! js-yaml 4.1.1 https://github.com/nodeca/js-yaml @license MIT *)
 */
-//# sourceMappingURL=chunk-5J54S5BK.js.map
+//# sourceMappingURL=chunk-T5WGKZN4.js.map