super-agent-sdk 1.0.10 → 1.0.11

package/dist/widget.d.ts

@@ -81,6 +81,15 @@ export declare interface CapabilityItem {
     desc?: string;
 }
 
+/** 附件描述：前端直传 NOS（如 @netease-ehr/ui Upload 的 nosUpload onSuccess 结果）提取。 */
+export declare interface ChatAttachment {
+    nosKey: string;
+    filename: string;
+    size?: number;
+    mime?: string;
+    url?: string;
+}
+
 declare interface ChatEvent {
     type: "user" | "thinking" | "ai" | "tool_call" | "tool_result" | "done" | "stop" | "error" | "interrupt";
     content: string;
@@ -98,6 +107,8 @@ declare interface ChatEvent {
 declare interface ChatOptions {
     sessionId: string;
     message: string;
+    /** 附件（仅沙箱模式 Agent 支持，其他模式后端返回 400）。需先经直传组件传到 NOS 拿到 nosKey。 */
+    attachments?: ChatAttachment[];
     stream?: boolean;
     onMessage?: (event: ChatEvent) => void;
     onError?: (error: Error) => void;
@@ -109,11 +120,15 @@ declare interface ChatOptions {
     signal?: AbortSignal;
 }
 
-export declare function ChatProvider({ sdk, hooks, children }: ChatProviderProps): default_2.JSX.Element;
+export declare function ChatProvider({ sdk, hooks, attachmentUploader, nosUpload, children }: ChatProviderProps): default_2.JSX.Element;
 
 declare interface ChatProviderProps {
     sdk: SuperAgentSDK;
     hooks?: EventHooks;
+    /** 附件上传器（mount 配置注入；未配置 = 附件功能关闭） */
+    attachmentUploader?: (file: File) => Promise<ChatAttachment>;
+    /** 内置直传配置（attachmentUploader 优先） */
+    nosUpload?: NosUploadConfig;
     children: default_2.ReactNode;
 }
 
@@ -133,7 +148,11 @@ export declare interface ChatState {
     hasMore: boolean;
     conversationsLoading: boolean;
     messagesLoading: boolean;
-    sendMessage: (content: string) => void;
+    sendMessage: (content: string, attachments?: ChatAttachment[]) => void;
+    /** 附件上传器（attachmentUploader 直传 or nosUpload 桥解析后的统一入口；null = 未启用） */
+    attachmentUploader: ((file: File) => Promise<ChatAttachment>) | null;
+    /** 内置直传配置（@netease-ehr/ui 桥；attachmentUploader 优先） */
+    nosUpload: NosUploadConfig | null;
     stop: () => void;
     regenerate: () => void;
     switchConversation: (sessionId: string) => void;
@@ -169,13 +188,19 @@ declare interface ChatWidgetProps extends MountOptions {
 
 /**
  * 底部输入区（样式对齐 hr-for-help inputArea）：
- * 渐变描边输入框（聚焦/有内容时渐变点亮）+ 发送/停止按钮 + 底部 AI 提示文案。
+ * 渐变描边输入框（聚焦/有内容时渐变点亮）+ 附件按钮 + 发送/停止按钮 + 底部 AI 提示文案。
+ *
+ * 附件（两种启用方式，attachmentUploader 优先）：
+ * 1. mount({ attachmentUploader })：完全自定义上传函数；
+ * 2. mount({ nosUpload: { baseURL } })：SDK 内置 NOS 直传（协议对齐 @netease-ehr/ui，
+ *    零依赖该私有包）——nosKey 生成 → /nos/token → 分片直传 → /nos/url。
+ * 上传完成的 chip 随消息发送，上传中禁止发送。
  */
 export declare function Composer(): default_2.JSX.Element;
 
 export declare interface ComposerProps {
     status: ChatStatus;
-    onSend: (content: string) => void;
+    onSend: (content: string, attachments?: ChatAttachment[]) => void;
     onStop: () => void;
 }
 
@@ -375,6 +400,9 @@ declare type MessagePart = {
 } | {
     type: "error";
     content: string;
+} | {
+    type: "attachment";
+    attachment: ChatAttachment;
 } | {
     type: "interrupt";
     interrupt: InterruptEvent;
@@ -419,6 +447,26 @@ export declare interface MountOptions {
     triggerLogo?: string;
     /** 显示消息时间戳，默认 false（对齐 hr-for-help，不显示时间） */
     showTimestamp?: boolean;
+    /**
+     * 附件上传器（完全自定义，优先于 nosUpload）：把 File 直传 NOS 并返回 ChatAttachment。
+     * 不配置则输入区不显示附件按钮（功能关闭，零影响）。
+     */
+    attachmentUploader?: (file: File) => Promise<ChatAttachment>;
+    /**
+     * 内置 NOS 直传（零依赖 @netease-ehr/ui）：SDK 内置协议实现
+     * （nosKey 生成 → /nos/token → nos-js-sdk 分片直传 → /nos/url），配置即用。
+     */
+    nosUpload?: NosUploadConfig;
+}
+
+/** 内置 NOS 直传配置（协议对齐 @netease-ehr/ui Upload 的 nosUpload 路径） */
+export declare interface NosUploadConfig {
+    /** 业务网关（通常与业务系统接口网关一致，如 "/api/e5s"，token/url 相对同源请求） */
+    baseURL: string;
+    /** 网关自定义请求头（鉴权等） */
+    headers?: Record<string, string>;
+    /** 分片大小（默认 4MB） */
+    trunkSize?: number;
 }
 
 /**
@@ -651,7 +699,7 @@ declare interface UseChatReturn {
     messages: UIMessage[];
     status: ChatStatus;
     error: Error | null;
-    sendMessage: (content: string) => void;
+    sendMessage: (content: string, attachments?: ChatAttachment[]) => void;
     stop: () => void;
     regenerate: () => void;
     setMessages: (messages: UIMessage[]) => void;