@legendzd/ai-agent-vue 1.0.4 → 1.1.0

package/dist/src/api/agent.d.ts

@@ -5,14 +5,21 @@ export declare function setAgentOptions(options: AgentPluginOptions): void;
 export declare function getAgentOptions(): AgentPluginOptions;
 /**
  * 创建会话
- * POST ${apiUrl}/agent/chat/session
+ * GET ${apiUrl}/external/chat/sessions
+ * 携带 agent_id（必传）、ext_user_id
  */
 export declare function createChatSession(options?: AgentPluginOptions): Promise<string>;
 /**
  * 获取历史会话列表
- * GET ${apiUrl}/agent/chat/sessions?userId=xxx
+ * GET ${apiUrl}/external/chat/sessions
+ * 携带 agent_id（必传）、ext_user_id
  */
 export declare function getChatSessions(options?: AgentPluginOptions): Promise<SessionInfo[]>;
+/**
+ * 获取历史会话的消息列表
+ * GET ${apiUrl}/external/chat/sessions/{id}/messages
+ */
+export declare function getSessionMessages(sessionId: number | string, options?: AgentPluginOptions): Promise<any[]>;
 /**
  * 流式文本生成接口
  * 使用 fetch + ReadableStream 实现 SSE 流式读取

package/dist/src/components/ChatMessage.vue.d.ts

@@ -1,7 +1,28 @@
 import { ChatMessage } from '../../types/agent';
 type __VLS_Props = {
     message: ChatMessage;
+    /** 用户头像 URL（svg/png/jpg 等） */
+    userAvatar?: string;
+    /** AI 助手头像 URL（svg/png/jpg 等） */
+    assistantAvatar?: string;
+    /** 是否显示 SQL 区域，默认 false */
+    showSql?: boolean;
+    /** 是否显示数据表格区域，默认 false */
+    showData?: boolean;
+    /** 是否显示执行计划，默认 true */
+    showRunPlan?: boolean;
+    /** 执行计划默认是否展开，默认 false */
+    defaultRunPlanExpanded?: boolean;
 };
-declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    reask: (content: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReask?: ((content: string) => any) | undefined;
+}>, {
+    showSql: boolean;
+    showData: boolean;
+    showRunPlan: boolean;
+    defaultRunPlanExpanded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/src/plugin/index.d.ts

@@ -24,6 +24,7 @@ export type {
   ChatMessage as ChatMessageType,
   ChatMessageRole,
   ChatMessageStatus,
+  MessageStructuredData,
   SessionInfo,
   SourceInfo,
   StreamCallbacks,

package/dist/src/stores/chat.d.ts

@@ -1,4 +1,4 @@
-import { AgentPluginOptions, ChatMessage, SessionInfo, SourceInfo } from '../../types/agent';
+import { AgentPluginOptions, ChatMessage, ChatMessageRole, ChatMessageStatus, MessageStructuredData, SessionInfo, SourceInfo } from '../../types/agent';
 /** 聊天 store 实例类型 */
 export type ChatStoreInstance = ReturnType<ReturnType<typeof createChatStoreDefinition>>;
 /** 获取或创建聊天实例 */
@@ -13,19 +13,19 @@ export declare function destroyChatInstance(instanceId: string): void;
 declare function createChatStoreDefinition(instanceId: string): import('pinia').StoreDefinition<`agent-chat-${string}`, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -39,11 +39,13 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -57,13 +59,19 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -72,25 +80,27 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "sessionId" | "sessions" | "messages" | "isStreaming" | "isSessionLoading">, Pick<{
+}, "sessionId" | "sessions" | "messages" | "runPlanVisible" | "isStreaming" | "isSessionLoading">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -104,11 +114,13 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -122,13 +134,19 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -137,25 +155,27 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, never>, Pick<{
+}, "isVirtualSession">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -169,11 +189,13 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -187,13 +209,19 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -202,27 +230,29 @@ declare function createChatStoreDefinition(instanceId: string): import('pinia').
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "initSession" | "loadSessions" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
+}, "initSession" | "loadSessions" | "syncSessionFromHistory" | "syncSessionId" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "updateRunPlan" | "getMessageData" | "markStreamDone" | "markStreamError" | "clearMessages">>;
 /** 默认聊天 store 实例（instanceId = 'default'） */
 export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -236,11 +266,13 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -254,13 +286,19 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -269,25 +307,27 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "sessionId" | "sessions" | "messages" | "isStreaming" | "isSessionLoading">, Pick<{
+}, "sessionId" | "sessions" | "messages" | "runPlanVisible" | "isStreaming" | "isSessionLoading">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -301,11 +341,13 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -319,13 +361,19 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -334,25 +382,27 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, never>, Pick<{
+}, "isVirtualSession">, Pick<{
     sessionId: import('vue').Ref<string, string>;
     sessions: import('vue').Ref<{
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[], SessionInfo[] | {
-        id: string;
+        id: number | string;
         title: string;
         created_at: string;
     }[]>;
     messages: import('vue').Ref<{
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -366,11 +416,13 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[], ChatMessage[] | {
         id: string;
-        role: import('../../types/agent').ChatMessageRole;
+        role: ChatMessageRole;
         content: string;
-        status: import('../../types/agent').ChatMessageStatus;
+        status: ChatMessageStatus;
         createdAt: number;
         reportId?: number | undefined;
         title?: string | undefined;
@@ -384,13 +436,19 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
             id: string;
             title: string;
         }[] | undefined;
+        runPlan?: string | undefined;
+        runPlanExpanded?: boolean | undefined;
     }[]>;
     isStreaming: import('vue').Ref<boolean, boolean>;
     isSessionLoading: import('vue').Ref<boolean, boolean>;
+    runPlanVisible: import('vue').Ref<boolean, boolean>;
     initSession: () => Promise<void>;
     loadSessions: () => Promise<void>;
-    switchSession: (id: string) => void;
-    newChat: () => Promise<void>;
+    isVirtualSession: import('vue').ComputedRef<boolean>;
+    syncSessionFromHistory: () => Promise<void>;
+    syncSessionId: (id: string) => void;
+    switchSession: (id: number | string) => Promise<void>;
+    newChat: () => void;
     addUserMessage: (content: string) => ChatMessage;
     addAssistantPlaceholder: () => ChatMessage;
     appendStreamContent: (content: string) => void;
@@ -399,8 +457,10 @@ export declare const chatStore: import('pinia').Store<`agent-chat-${string}`, Pi
     updateData: (data: any[]) => void;
     updateChartConfig: (config: any) => void;
     updateSources: (sources: SourceInfo[]) => void;
+    updateRunPlan: (text: string) => void;
+    getMessageData: (messageId: string) => MessageStructuredData | undefined;
     markStreamDone: (reportId?: number, title?: string) => void;
     markStreamError: (errorMessage: string) => void;
     clearMessages: () => void;
-}, "initSession" | "loadSessions" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "markStreamDone" | "markStreamError" | "clearMessages">>;
+}, "initSession" | "loadSessions" | "syncSessionFromHistory" | "syncSessionId" | "switchSession" | "newChat" | "addUserMessage" | "addAssistantPlaceholder" | "appendStreamContent" | "updateStatusText" | "updateSql" | "updateData" | "updateChartConfig" | "updateSources" | "updateRunPlan" | "getMessageData" | "markStreamDone" | "markStreamError" | "clearMessages">>;
 export {};

package/dist/src/types/agent.d.ts

@@ -3,8 +3,28 @@ import { ComputedRef, InjectionKey } from 'vue';
 export type AgentThemeMode = 'dark' | 'light';
 /** 主题变量覆盖：键为 CSS 变量名（含 --agent- 前缀），值为 CSS 值 */
 export type AgentThemeOverrides = Record<string, string>;
+/** 自定义请求参数 key 名称，用于适配不同后端接口的参数命名 */
+export interface ParamKeys {
+    /** 智能体 ID 参数名，默认 'agent_id' */
+    agent_id?: string;
+    /** 查询内容参数名，默认 'query' */
+    query?: string;
+    /** 会话 ID 参数名，默认 'session_id' */
+    session_id?: string;
+    /** 外部用户 ID 参数名，默认 'ext_user_id' */
+    ext_user_id?: string;
+}
+/** 解析后的参数 key 名称（合并默认值后所有字段必填） */
+export interface ResolvedParamKeys {
+    agent_id: string;
+    query: string;
+    session_id: string;
+    ext_user_id: string;
+}
 /** 拖拽约束模式 */
 export type DragConstrainMode = 'viewport' | 'none';
+/** 弹窗方位（9 个方向，类似 ElPopover/ElTooltip 的 placement） */
+export type AgentWindowPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right' | 'auto';
 /** 智能体插件配置（所有字段均可选，由组件 props 或 install 时传入） */
 export interface AgentPluginOptions {
     /** API 基础地址（如 http://host:port/api/v2） */
@@ -13,16 +33,24 @@ export interface AgentPluginOptions {
     getAccessToken?: () => string;
     /** 认证 session 获取函数 */
     getSession?: () => string;
-    /** 用户 ID 获取函数，用于创建/查询会话（动态场景优先使用） */
-    getUserId?: () => string;
-    /** 用户 ID 静态值（简化用法，getUserId 优先） */
-    userId?: string;
-    /** LLM 提供商 ID */
-    llmProviderId?: number;
-    /** 提示词模板 ID */
-    promptTemplateId?: number;
-    /** 自定义提示词 */
-    customPrompt?: string;
+    /** 智能体 ID 获取函数（动态场景优先使用，agent_id 为必传值） */
+    getAgentId?: () => string;
+    /** 智能体 ID 静态值（必传，getAgentId 优先） */
+    agentId?: string;
+    /** 外部用户 ID 获取函数，用于创建/查询会话（动态场景优先使用） */
+    getExtUserId?: () => string;
+    /** 外部用户 ID 静态值（简化用法，getExtUserId 优先） */
+    extUserId?: string;
+    /** 自定义请求参数 key 名称，默认 { agent_id, query, session_id, ext_user_id } */
+    paramKeys?: ParamKeys;
+    /** 应用 Key，用于自动生成 X-App-Key 等安全签名头（与 appSecret 配合使用） */
+    appKey?: string;
+    /** 应用密钥，用于 HMAC-SHA256 签名（与 appKey 配合使用） */
+    appSecret?: string;
+    /** 安全请求头获取函数，优先级高于 appKey/appSecret 自动签名，用于完全自定义签名逻辑 */
+    getSecurityHeaders?: () => Record<string, string>;
+    /** 自定义请求头，合并到安全签名头中，同名键覆盖自动生成的值（支持静态对象或动态函数） */
+    customHeaders?: Record<string, string> | (() => Record<string, string>);
     /** 窗口标题文本 */
     headerTitle?: string;
     /** 空状态提示文本 */
@@ -43,6 +71,24 @@ export interface AgentPluginOptions {
     draggable?: boolean;
     /** 拖拽约束模式：'viewport' 限制在视口内，'none' 不限制（但仍不超出可见区域），默认 'viewport' */
     dragConstrain?: DragConstrainMode;
+    /** 弹窗相对按钮的方位，默认 'top-end'（按钮上方右对齐） */
+    placement?: AgentWindowPlacement;
+    /** 用户头像 URL（支持 svg/png/jpg 等图片格式，不传则使用默认图标） */
+    userAvatar?: string;
+    /** AI 助手头像 URL（支持 svg/png/jpg 等图片格式，不传则使用默认图标） */
+    assistantAvatar?: string;
+    /** 是否显示欢迎气泡，默认 true */
+    showWelcome?: boolean;
+    /** 欢迎词文本，默认 '请问有什么可以帮你？' */
+    welcomeMessage?: string;
+    /** 是否在消息中显示 SQL，默认 false */
+    showSql?: boolean;
+    /** 是否在消息中显示数据表格，默认 false */
+    showData?: boolean;
+    /** 是否显示执行计划/思考过程，默认 true */
+    showRunPlan?: boolean;
+    /** 执行计划默认是否展开，默认 false */
+    defaultRunPlanExpanded?: boolean;
 }
 /** provide/inject key */
 export declare const AGENT_CONFIG_KEY: InjectionKey<ComputedRef<AgentPluginOptions>>;
@@ -87,21 +133,34 @@ export interface ChatMessage {
     chartConfig?: any;
     /** 来源依据 */
     sources?: SourceInfo[];
+    /** 执行计划/思考过程 */
+    runPlan?: string;
+    /** 执行计划是否展开 */
+    runPlanExpanded?: boolean;
 }
 /** 会话信息 */
 export interface SessionInfo {
-    id: string;
+    id: number | string;
     title: string;
     created_at: string;
 }
+/** 消息结构化数据（通过 getMessageData 获取） */
+export interface MessageStructuredData {
+    sql?: string;
+    data?: any[];
+    chartConfig?: any;
+    sources?: SourceInfo[];
+    runPlan?: string;
+}
 /** 流式请求参数 */
 export interface StreamRequestData {
-    sessionId: string;
+    /** 会话 ID（可选，选择历史记录后传入对应 session_id） */
+    sessionId?: string;
+    /** 用户查询内容 */
     query: string;
-    userId?: string;
 }
 /** 流式事件类型 */
-export type StreamEventType = 'status' | 'sql' | 'data' | 'chart_config' | 'sources' | 'analysis_chunk' | 'delta' | 'done' | 'error';
+export type StreamEventType = 'session' | 'status' | 'sql' | 'data' | 'chart_config' | 'sources' | 'run_plan' | 'analysis_chunk' | 'delta' | 'done' | 'error';
 /** 流式事件数据 */
 export interface StreamEvent {
     type: StreamEventType;
@@ -109,6 +168,8 @@ export interface StreamEvent {
     message?: string;
     report_id?: number;
     title?: string;
+    /** session 事件专用：后端返回的会话 ID */
+    session_id?: number | string;
 }
 /** 布局模式 */
 export type AgentLayoutMode = 'popup' | 'full' | 'mobile';
@@ -130,11 +191,14 @@ export interface AgentMobileLayoutProps {
 }
 /** 流式回调 */
 export interface StreamCallbacks {
+    /** session 事件：后端首条返回中携带的会话 ID，可立即绑定用于后续对话 */
+    onSession?: (sessionId: string) => void;
     onStatus?: (text: string) => void;
     onSql?: (sql: string) => void;
     onData?: (data: any[]) => void;
     onChartConfig?: (config: any) => void;
     onSources?: (sources: SourceInfo[]) => void;
+    onRunPlan?: (text: string) => void;
     onAnalysisChunk?: (chunk: string) => void;
     onDone?: (reportId: number, title: string) => void;
     onError?: (message: string) => void;