langgraph-vue3-chatbot 0.1.22 → 0.1.23

package/README.md

@@ -178,12 +178,96 @@ const suggestions = [
 | `systemPrompt` | 设置发送给模型的系统提示词 | `'你是一个有用的助手，帮用户解决各种问题。'` |
 | `threadId` | 指定已有会话线程 id；不传时由组件内部创建线程 | `undefined` |
 | `userId` | 标识当前用户，用于请求上下文区分 | `'user001'` |
-| `showHeaderActions` | 控制是否显示头部操作区，例如模型选择、工具开关等 | `true` |
+| `showHeaderActions` | 控制是否显示聊天面板头部右侧操作按钮，例如关闭、最大化等 | `true` |
 | `suggestions` | 配置输入区上方的建议问题列表 | `[]` |
 | `apiUrl` | 指定 LangGraph 服务地址 | `'http://localhost:2024'` |
 | `apiKey` | 指定 LangGraph 服务访问凭证 | `undefined` |
 | `theme` | 设置组件主题，可选 `light` / `dark` | `'light'` |
 
+## 组件实例 API
+
+`ChatBot` 和 `AskAiBot` 都支持通过 `ref` 调用少量公开实例方法，目前只暴露以下 3 个能力：
+
+- `setTextInput(text: string)`：设置输入框文本
+- `addAttachments(attachments: PromptInputAttachment[])`：添加附件
+- `sendMessage()`：触发现有发送流程
+
+其中：
+
+- `ChatBot` 会直接调用内部输入区现有逻辑
+- `AskAiBot` 在折叠状态下调用 `sendMessage()` 时，会先自动展开再发送
+
+### `ChatBot` 示例
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { ChatBot, type AiBotPublicApi, type PromptInputAttachment } from 'langgraph-vue3-chatbot'
+
+const chatBotRef = ref<AiBotPublicApi | null>(null)
+
+function askWithAttachment() {
+  chatBotRef.value?.setTextInput('请帮我分析这个附件')
+
+  const attachments: PromptInputAttachment[] = [
+    {
+      type: 'file_url',
+      url: 'https://example.com/report.pdf',
+      filename: 'report.pdf',
+      mediaType: 'application/pdf'
+    }
+  ]
+
+  chatBotRef.value?.addAttachments(attachments)
+  chatBotRef.value?.sendMessage()
+}
+</script>
+
+<template>
+  <button @click="askWithAttachment">
+    发送预设问题
+  </button>
+
+  <div style="height: 600px; margin-top: 12px;">
+    <ChatBot
+      ref="chatBotRef"
+      assistant-id="research"
+      assistant-name="AI 助手"
+      api-url="http://localhost:2024"
+    />
+  </div>
+</template>
+```
+
+### `AskAiBot` 示例
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { AskAiBot, type AskAiBotPublicApi } from 'langgraph-vue3-chatbot'
+
+const askAiBotRef = ref<AskAiBotPublicApi | null>(null)
+
+function quickAsk() {
+  askAiBotRef.value?.setTextInput('帮我总结今天的待办')
+  askAiBotRef.value?.sendMessage()
+}
+</script>
+
+<template>
+  <button @click="quickAsk">
+    唤起并发送
+  </button>
+
+  <AskAiBot
+    ref="askAiBotRef"
+    assistant-id="research"
+    assistant-name="AI 助手"
+    api-url="http://localhost:2024"
+  />
+</template>
+```
+
 ## Slots
 
 ### AskAiBot

package/dist-lib/components/ai-bot/AskAiBot.vue.d.ts

@@ -25,7 +25,11 @@ type __VLS_Slots = {
     }) => any;
     'attachment-trigger'?: (props: AttachmentTriggerSlotProps) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
+declare const __VLS_component: import("vue").DefineComponent<Props, {
+    setTextInput: (text: string) => void;
+    addAttachments: (attachments: import("./index.ts").PromptInputAttachment[]) => void;
+    sendMessage: (options?: import("./index.ts").AiBotVisibilityOptions) => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     height: number | string;
     width: number | string;
     theme: AiBotTheme;

package/dist-lib/components/ai-bot/AskAiBot.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AskAiBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/AskAiBot.vue"],"names":[],"mappings":"AA6LA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,UAAU,KAAK;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAiBD,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IACtF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IAClF,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AAiNF,QAAA,MAAM,eAAe;YAxOV,MAAM,GAAG,MAAM;WADhB,MAAM,GAAG,MAAM;WAEf,UAAU;iBALJ,MAAM,EAAE;YACb,MAAM;iBAPD,MAAM;mBACJ,MAAM;kBAEP,MAAM;YAEZ,MAAM;YAGN,MAAM;qBANG,OAAO;4EAuPzB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"AskAiBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/AskAiBot.vue"],"names":[],"mappings":"AA2NA,OAAO,KAAK,EAAqC,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AACtG,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAM7C,UAAU,KAAK;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAiBD,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IACtF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IAClF,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AAqPF,QAAA,MAAM,eAAe;;;yBAhSrB,CAjLyC;;YAqM9B,MAAM,GAAG,MAAM;WADhB,MAAM,GAAG,MAAM;WAEf,UAAU;iBALJ,MAAM,EAAE;YACb,MAAM;iBAPD,MAAM;mBACJ,MAAM;kBAEP,MAAM;YAEZ,MAAM;YAGN,MAAM;qBANG,OAAO;4EA4RzB,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist-lib/components/ai-bot/ChatBot.vue.d.ts

@@ -23,7 +23,11 @@ type __VLS_Slots = {
     }) => any;
     'attachment-trigger'?: (props: AttachmentTriggerSlotProps) => any;
 };
-declare const __VLS_component: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<Props, {
+    setTextInput: (text: string) => void;
+    addAttachments: (attachments: import("./index.ts").PromptInputAttachment[]) => void;
+    sendMessage: (options?: import("./index.ts").AiBotVisibilityOptions) => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     close: () => any;
     "update:isMaximized": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{

package/dist-lib/components/ai-bot/ChatBot.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/ChatBot.vue"],"names":[],"mappings":"AA84BA,OAAO,KAAK,EAAE,0BAA0B,EAAsB,MAAM,mBAAmB,CAAA;AACvF,OAAO,KAAK,EAA2B,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAc7C,UAAU,KAAK;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAeD,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IACtF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IAClF,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AA08BF,QAAA,MAAM,eAAe;;;;;;;uBAl+BC,OAAO;WAInB,UAAU;iBAHJ,MAAM,EAAE;YACb,MAAM;iBAPD,MAAM;mBACJ,MAAM;kBACP,MAAM;YAEZ,MAAM;YAIN,MAAM;4EAu+Bf,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ChatBot.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/ChatBot.vue"],"names":[],"mappings":"AAm6BA,OAAO,KAAK,EAAiC,0BAA0B,EAAsB,MAAM,mBAAmB,CAAA;AACtH,OAAO,KAAK,EAA2B,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAgB7C,UAAU,KAAK;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAeD,KAAK,WAAW,GAAG;IACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IACtF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,GAAG,CAAA;IAClF,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AAq+BF,QAAA,MAAM,eAAe;;;yBAthCrB,CAt4BY;;;;;;;;uBA+5BU,OAAO;WAInB,UAAU;iBAHJ,MAAM,EAAE;YACb,MAAM;iBAPD,MAAM;mBACJ,MAAM;kBACP,MAAM;YAEZ,MAAM;YAIN,MAAM;4EAmgCf,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAa1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist-lib/components/ai-bot/ChatInput.vue.d.ts

@@ -1,5 +1,5 @@
 import type { ChatStatus } from './lib/message-types';
-import type { AttachmentFile, AttachmentTriggerSlotProps } from './lib/input-types';
+import type { AttachmentFile, AttachmentTriggerSlotProps, PromptInputAttachment } from './lib/input-types';
 import { type ModelInfo } from './lib/models';
 interface Props {
     status: ChatStatus;
@@ -15,7 +15,11 @@ type __VLS_Slots = {
 type __VLS_PublicProps = __VLS_Props & {
     'modelSelectorOpen'?: boolean;
 };
-declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {
+    setTextInput: (text: string) => void;
+    addAttachments: (attachments: PromptInputAttachment[]) => void;
+    sendMessage: (options?: import("./index.ts").AiBotVisibilityOptions) => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     stop: () => any;
     submit: (message: {
         text: string;

package/dist-lib/components/ai-bot/ChatInput.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/ChatInput.vue"],"names":[],"mappings":"AAqjBA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAA6C,MAAM,mBAAmB,CAAA;AAC9H,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAQrE,UAAU,KAAK;IACb,MAAM,EAAE,UAAU,CAAA;IAClB,YAAY,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,KAAK,WAAW,GAAG,KAAK,CAAC;AAczB,KAAK,WAAW,GAAG;IACjB,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AA4UF,KAAK,iBAAiB,GAAG,WAAW,GAAG;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAsdF,QAAA,MAAM,eAAe;;;cAhzBO,MAAM;eAAS,cAAc,EAAE;;;;;;;;;cAA/B,MAAM;eAAS,cAAc,EAAE;;;;;;kFAuzBzD,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAQ1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ChatInput.vue.d.ts","sourceRoot":"","sources":["../../../src/components/ai-bot/ChatInput.vue"],"names":[],"mappings":"AA+jBA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,KAAK,EAAiB,cAAc,EAAE,0BAA0B,EAAE,qBAAqB,EAAsB,MAAM,mBAAmB,CAAA;AAC7I,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAQrE,UAAU,KAAK;IACb,MAAM,EAAE,UAAU,CAAA;IAClB,YAAY,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,KAAK,WAAW,GAAG,KAAK,CAAC;AAczB,KAAK,WAAW,GAAG;IACjB,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,GAAG,CAAA;CAClE,CAAC;AAuVF,KAAK,iBAAiB,GAAG,WAAW,GAAG;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAsdF,QAAA,MAAM,eAAe;;;yBAp1BrB,CAtiBiB;;;;cA+jBW,MAAM;eAAS,cAAc,EAAE;;;;;;;;;cAA/B,MAAM;eAAS,cAAc,EAAE;;;;;;kFAm0BzD,CAAC;wBACkB,eAAe,CAAC,OAAO,eAAe,EAAE,WAAW,CAAC;AAAzE,wBAA0E;AAQ1E,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}