@meistrari/chat-nuxt 4.12.0-rc.1 → 4.12.0-rc.2

package/README.md

@@ -240,3 +240,13 @@ Advanced picker flags default to `true`. Import `ChatExecutionControls` and
 `ChatExecutionProfile` from `@meistrari/chat-nuxt/types/embed` when declaring host
 configuration separately. `defaultModel` and `defaultReasoningEffort` are not
 deprecated.
+
+### Host chat controls
+
+The public embed exposes `sendMessage`, `cancel` and `clear` for host applications.
+
+### Create a new conversation
+
+Every embed offers `/new` (“Criar uma nova conversa”). Typing the command, selecting it from the menu or calling `sendMessage('/new')` opens a fresh chat. Like the sidebar action, it creates the new conversation on the first send. Previous conversations retain their messages and attachments.
+
+Hosts can call `ChatEmbedHost.clear(): Promise<boolean>` and listen for `@conversation-cleared="onCleared"` (payload: the unchanged conversation ID) to discard their own session state. The event fires only after a successful reset. On failure, history remains visible and the host can retry the clear. Clear is serialized against turn/wake admission; stale polling and wake completions cannot restore the previous session.

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@meistrari/chat-nuxt",
   "configKey": "chatNuxt",
-  "version": "4.12.0-rc.1",
+  "version": "4.12.0-rc.2",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/runtime/embed/components/chat-embed-inner.d.vue.ts

@@ -19,33 +19,49 @@ type __VLS_Props = {
     user?: EmbedUser | null;
     features?: Partial<ChatFeatureConfig>;
 };
-declare var __VLS_14: {}, __VLS_99: {}, __VLS_114: {
+declare function clearThread(): Promise<boolean>;
+declare function handleCancel(): Promise<void>;
+declare var __VLS_14: {}, __VLS_100: {}, __VLS_115: {
     message: useChatAuth;
-}, __VLS_127: {}, __VLS_136: {}, __VLS_207: {}, __VLS_228: {
+}, __VLS_118: {
     message: useChatAuth;
-}, __VLS_241: {};
+}, __VLS_132: {}, __VLS_141: {}, __VLS_213: {}, __VLS_234: {
+    message: useChatAuth;
+}, __VLS_237: {
+    message: useChatAuth;
+}, __VLS_251: {};
 type __VLS_Slots = {} & {
     'sidebar-bottom'?: (props: typeof __VLS_14) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_99) => any;
+    'composer-bottom'?: (props: typeof __VLS_100) => any;
+} & {
+    'failed-message-actions'?: (props: typeof __VLS_115) => any;
+} & {
+    'user-message'?: (props: typeof __VLS_118) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_114) => any;
+    'composer-bottom'?: (props: typeof __VLS_132) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_127) => any;
+    'topbar-leading'?: (props: typeof __VLS_141) => any;
 } & {
-    'topbar-leading'?: (props: typeof __VLS_136) => any;
+    'composer-bottom'?: (props: typeof __VLS_213) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_207) => any;
+    'failed-message-actions'?: (props: typeof __VLS_234) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_228) => any;
+    'user-message'?: (props: typeof __VLS_237) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_241) => any;
+    'composer-bottom'?: (props: typeof __VLS_251) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    clear: typeof clearThread;
+    sendMessage: (content: string, messageId?: string) => Promise<boolean>;
+    cancel: typeof handleCancel;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    conversationCleared: (conversationId: string) => any;
     "update:conversationId": (value: string | null) => any;
     "update:conversationTitle": (value: string | null) => any;
     "update:conversationCreatorFilter": (value: ConversationCreatorFilter) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onConversationCleared?: ((conversationId: string) => any) | undefined;
     "onUpdate:conversationId"?: ((value: string | null) => any) | undefined;
     "onUpdate:conversationTitle"?: ((value: string | null) => any) | undefined;
     "onUpdate:conversationCreatorFilter"?: ((value: ConversationCreatorFilter) => any) | undefined;

package/dist/runtime/embed/components/chat-embed-inner.vue

@@ -60,7 +60,7 @@ const props = defineProps({
   user: { type: [Object, null], required: false },
   features: { type: Object, required: false }
 });
-const emit = defineEmits(["update:conversationId", "update:conversationTitle", "update:conversationCreatorFilter"]);
+const emit = defineEmits(["conversationCleared", "update:conversationId", "update:conversationTitle", "update:conversationCreatorFilter"]);
 const sidebarPosition = computed(() => props.sidebar?.position ?? "left");
 const sidebarWidth = computed(() => props.sidebar?.width ?? 240);
 const sidebarBottomHeight = computed(
@@ -300,6 +300,7 @@ const {
   startPolling,
   reconnect,
   clearConversation,
+  clearConversationThread,
   error: chatError
 } = createChat({
   outboundQueueEnabled: computed(() => resolvedFeatures.value.chatOutboundQueue),
@@ -314,7 +315,7 @@ watch(chatError, (message) => {
   if (message)
     statusToast.update({ text: message, icon: "i-ph-warning" });
 });
-const { total, files: conversationFiles, loading: conversationFilesLoading } = useConversationFiles(activeConversationId);
+const { total, files: conversationFiles, loading: conversationFilesLoading, clearFiles } = useConversationFiles(activeConversationId);
 function resolveSelectedModel(value) {
   return nativeModels ? nativeModels.resolve(value) : value;
 }
@@ -606,12 +607,38 @@ const pendingFork = computed(() => {
   return fork && fork.status !== "ready" ? fork : null;
 });
 const forkBlocked = computed(() => Boolean(pendingFork.value));
+const clearRevision = ref(0);
 function claimableWakeSessionId() {
   return agentWake?.state.value === "ready" && !currentConversation.value?.threadSessionId ? agentWake.sessionId.value : void 0;
 }
+async function clearThread() {
+  const conversationId = currentConversation.value?.id;
+  if (!conversationId || forkBlocked.value)
+    return false;
+  const cleared = await clearConversationThread();
+  if (cleared && activeConversationId.value === conversationId && currentConversation.value?.id === conversationId) {
+    agentWake?.consume();
+    const key = composerKey(conversationId);
+    if (key) {
+      writeComposerDraft(key, "");
+      writeComposerDraft(`${key}:pending-send`, "");
+    }
+    unconfirmedDraft = null;
+    clearFiles();
+    closeFilesPanel();
+    clearRevision.value++;
+  }
+  if (cleared)
+    emit("conversationCleared", conversationId);
+  return cleared;
+}
 async function handleSend(content, files, agentInputs) {
   if (forkBlocked.value)
     return;
+  if (content.trim() === "/new") {
+    await handleNewConversation();
+    return;
+  }
   const prepared = composerExtension?.prepareSend?.(content);
   const outbound = prepared?.content ?? content;
   unconfirmedDraft = {
@@ -627,7 +654,7 @@ async function handleSend(content, files, agentInputs) {
   if (!sent)
     restoreQueuedSend({ content: prepared?.retryContent?.() ?? content, files, agentInputs: resolvedAgentInputs });
 }
-async function dispatchMessage(outbound, files, resolvedAgentInputs) {
+async function dispatchMessage(outbound, files, resolvedAgentInputs, messageId) {
   const executionSettings = { model: selectedModel.value, reasoningEffort: selectedReasoningEffort.value };
   if (props.sendBlocked)
     return false;
@@ -681,7 +708,7 @@ async function dispatchMessage(outbound, files, resolvedAgentInputs) {
     if (!conversation.threadSessionId && !claimedWakeSessionId)
       throw new Error("N\xE3o foi poss\xEDvel acordar o agente. Tente novamente.");
     return { executionSettings, ...claimedWakeSessionId ? { wakeSessionId: claimedWakeSessionId } : {} };
-  });
+  }, void 0, messageId);
   if (sent && claimedWakeSessionId)
     agentWake?.consume();
   return sent;
@@ -833,11 +860,12 @@ const displayConversationEvents = computed(() => [...new Map([
 ].filter((event) => event.conversationId === currentConversation.value?.id).map((event) => [event.id, event])).values()]);
 watch([
   () => currentConversation.value?.id,
+  () => clearRevision.value,
   () => JSON.stringify(chatApi.withChatHeaders().headers),
   () => JSON.stringify(messages.value.filter((message) => message.role === "user").map((message) => [message.id, message.createdAt, message.externalUuid])),
   () => isPolling.value
-], async ([conversationId], previous, onCleanup) => {
-  if (conversationId !== previous?.[0] || JSON.stringify(chatApi.withChatHeaders().headers) !== previous?.[1])
+], async ([conversationId, revision, headers], previous, onCleanup) => {
+  if (conversationId !== previous?.[0] || revision !== previous?.[1] || headers !== previous?.[2])
     persistedConversationEvents.value = [];
   if (!conversationId)
     return;
@@ -958,6 +986,11 @@ async function handleDelete() {
     await handleNewConversation();
   }
 }
+defineExpose({
+  clear: clearThread,
+  sendMessage: async (content, messageId) => content.trim() === "/new" ? handleNewConversation().then(() => true) : Boolean(await dispatchMessage(content, [], void 0, messageId)),
+  cancel: handleCancel
+});
 </script>
 
 <template>
@@ -1136,6 +1169,7 @@ async function handleDelete() {
                         variant="mobile"
                     />
                     <ChatMessageInput
+                        :key="clearRevision"
                         v-model:selected-model="selectedModel"
                         v-model:selected-reasoning-effort="selectedReasoningEffort"
                         :disabled="true"
@@ -1180,6 +1214,7 @@ async function handleDelete() {
 
                         <template #input>
                             <ChatMessageInput
+                                :key="clearRevision"
                                 ref="messageInputRef"
                                 v-model:selected-model="selectedModel"
                                 v-model:selected-reasoning-effort="selectedReasoningEffort"
@@ -1206,6 +1241,7 @@ async function handleDelete() {
                                 centered
                                 @select-execution-profile="selectExecutionProfile"
                                 @send="handleSend"
+                                @new-conversation="handleNewConversation"
                                 @cancel="handleCancel"
                             />
                             <div v-if="$slots['composer-bottom']" data-chat-composer-bottom w-full>
@@ -1236,10 +1272,14 @@ async function handleDelete() {
                     <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
                         <slot name="failed-message-actions" v-bind="slotProps" />
                     </template>
+                    <template v-if="$slots['user-message']" #user-message="slotProps">
+                        <slot name="user-message" v-bind="slotProps" />
+                    </template>
                 </ChatMessageList>
                 <div ref="composerRef" data-chat-composer flex="~ col" gap-12px min-h-0>
                     <div :ref="setAnswerTarget" data-chat-answer-dock class="empty:hidden max-h-[50dvh] overflow-y-auto" />
                     <ChatMessageInput
+                        :key="clearRevision"
                         ref="messageInputRef"
                         v-model:selected-model="selectedModel"
                         v-model:selected-reasoning-effort="selectedReasoningEffort"
@@ -1267,6 +1307,7 @@ async function handleDelete() {
                         has-disclaimer
                         @select-execution-profile="selectExecutionProfile"
                         @send="handleSend"
+                        @new-conversation="handleNewConversation"
                         @cancel="handleCancel"
                     />
                     <div v-if="$slots['composer-bottom']" data-chat-composer-bottom w-full max-w-700px mx-auto mt--12px>
@@ -1358,6 +1399,7 @@ async function handleDelete() {
                     :variant="compact ? 'widget' : 'page'"
                 />
                 <ChatMessageInput
+                    :key="clearRevision"
                     v-model:selected-model="selectedModel"
                     v-model:selected-reasoning-effort="selectedReasoningEffort"
                     :disabled="true"
@@ -1408,6 +1450,7 @@ async function handleDelete() {
 
                 <template #input>
                     <ChatMessageInput
+                        :key="clearRevision"
                         ref="messageInputRef"
                         v-model:selected-model="selectedModel"
                         v-model:selected-reasoning-effort="selectedReasoningEffort"
@@ -1434,6 +1477,7 @@ async function handleDelete() {
                         centered
                         @select-execution-profile="selectExecutionProfile"
                         @send="handleSend"
+                        @new-conversation="handleNewConversation"
                         @cancel="handleCancel"
                     />
                     <div v-if="$slots['composer-bottom']" data-chat-composer-bottom w-full>
@@ -1467,10 +1511,14 @@ async function handleDelete() {
                     <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
                         <slot name="failed-message-actions" v-bind="slotProps" />
                     </template>
+                    <template v-if="$slots['user-message']" #user-message="slotProps">
+                        <slot name="user-message" v-bind="slotProps" />
+                    </template>
                 </ChatMessageList>
                 <div ref="composerRef" data-chat-composer flex="~ col" gap-12px min-h-0>
                     <div :ref="setAnswerTarget" data-chat-answer-dock class="empty:hidden max-h-[50dvh] overflow-y-auto" />
                     <ChatMessageInput
+                        :key="clearRevision"
                         ref="messageInputRef"
                         v-model:selected-model="selectedModel"
                         v-model:selected-reasoning-effort="selectedReasoningEffort"
@@ -1498,6 +1546,7 @@ async function handleDelete() {
                         has-disclaimer
                         @select-execution-profile="selectExecutionProfile"
                         @send="handleSend"
+                        @new-conversation="handleNewConversation"
                         @cancel="handleCancel"
                     />
                     <div v-if="$slots['composer-bottom']" data-chat-composer-bottom w-full max-w-700px mx-auto mt--12px>

package/dist/runtime/embed/components/chat-embed-inner.vue.d.ts

@@ -19,33 +19,49 @@ type __VLS_Props = {
     user?: EmbedUser | null;
     features?: Partial<ChatFeatureConfig>;
 };
-declare var __VLS_14: {}, __VLS_99: {}, __VLS_114: {
+declare function clearThread(): Promise<boolean>;
+declare function handleCancel(): Promise<void>;
+declare var __VLS_14: {}, __VLS_100: {}, __VLS_115: {
     message: useChatAuth;
-}, __VLS_127: {}, __VLS_136: {}, __VLS_207: {}, __VLS_228: {
+}, __VLS_118: {
     message: useChatAuth;
-}, __VLS_241: {};
+}, __VLS_132: {}, __VLS_141: {}, __VLS_213: {}, __VLS_234: {
+    message: useChatAuth;
+}, __VLS_237: {
+    message: useChatAuth;
+}, __VLS_251: {};
 type __VLS_Slots = {} & {
     'sidebar-bottom'?: (props: typeof __VLS_14) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_99) => any;
+    'composer-bottom'?: (props: typeof __VLS_100) => any;
+} & {
+    'failed-message-actions'?: (props: typeof __VLS_115) => any;
+} & {
+    'user-message'?: (props: typeof __VLS_118) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_114) => any;
+    'composer-bottom'?: (props: typeof __VLS_132) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_127) => any;
+    'topbar-leading'?: (props: typeof __VLS_141) => any;
 } & {
-    'topbar-leading'?: (props: typeof __VLS_136) => any;
+    'composer-bottom'?: (props: typeof __VLS_213) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_207) => any;
+    'failed-message-actions'?: (props: typeof __VLS_234) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_228) => any;
+    'user-message'?: (props: typeof __VLS_237) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_241) => any;
+    'composer-bottom'?: (props: typeof __VLS_251) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    clear: typeof clearThread;
+    sendMessage: (content: string, messageId?: string) => Promise<boolean>;
+    cancel: typeof handleCancel;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    conversationCleared: (conversationId: string) => any;
     "update:conversationId": (value: string | null) => any;
     "update:conversationTitle": (value: string | null) => any;
     "update:conversationCreatorFilter": (value: ConversationCreatorFilter) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onConversationCleared?: ((conversationId: string) => any) | undefined;
     "onUpdate:conversationId"?: ((value: string | null) => any) | undefined;
     "onUpdate:conversationTitle"?: ((value: string | null) => any) | undefined;
     "onUpdate:conversationCreatorFilter"?: ((value: ConversationCreatorFilter) => any) | undefined;

package/dist/runtime/embed/components/chat-embed.d.vue.ts

@@ -1,12 +1,14 @@
-declare var __VLS_26: {}, __VLS_29: {}, __VLS_32: {}, __VLS_35: any;
+declare var __VLS_29: {}, __VLS_32: {}, __VLS_35: {}, __VLS_38: any, __VLS_41: any;
 type __VLS_Slots = {} & {
-    'sidebar-bottom'?: (props: typeof __VLS_26) => any;
+    'sidebar-bottom'?: (props: typeof __VLS_29) => any;
 } & {
-    'topbar-leading'?: (props: typeof __VLS_29) => any;
+    'topbar-leading'?: (props: typeof __VLS_32) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_32) => any;
+    'composer-bottom'?: (props: typeof __VLS_35) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_35) => any;
+    'failed-message-actions'?: (props: typeof __VLS_38) => any;
+} & {
+    'user-message'?: (props: typeof __VLS_41) => any;
 };
 declare const __VLS_base: import("vue").DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import("vue").PublicProps>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/runtime/embed/components/chat-embed.vue

@@ -50,7 +50,7 @@ const props = defineProps({
   keepMounted: { type: Boolean, required: false },
   launcherLabel: { type: String, required: false }
 });
-const emit = defineEmits(["update:conversationId", "update:conversationTitle", "update:conversationCreatorFilter", "action", "messageFeedback", "messageTerminal", "messageSent"]);
+const emit = defineEmits(["conversationCleared", "update:conversationId", "update:conversationTitle", "update:conversationCreatorFilter", "action", "messageFeedback", "messageTerminal", "messageSent"]);
 const LightweightAdapter = defineAsyncComponent(() => import("../../lightweight/embed/components/chat-embed-adapter.vue"));
 const parentEmbedConfig = useEmbedConfig();
 const { activeOrganization } = useChatAuth();
@@ -145,6 +145,17 @@ provideChatMessageTerminal((payload) => {
 provideChatMessageSent((payload) => {
   emit("messageSent", payload);
 });
+const host = ref(null);
+function requireHost() {
+  if (!host.value)
+    throw new Error("Chat is not ready");
+  return host.value;
+}
+defineExpose({
+  sendMessage: (content, messageId) => requireHost().sendMessage(content, messageId),
+  cancel: () => requireHost().cancel(),
+  clear: () => requireHost().clear()
+});
 </script>
 
 <template>
@@ -162,6 +173,7 @@ provideChatMessageSent((payload) => {
     <component
         :is="harnessComponent"
         v-if="workspaceId && harnessComponent"
+        ref="host"
         :key="`${harness}:${workspaceId}:${normalizedTelaAgentId ?? 'default-chat'}:branch:${telaAgentBranch ?? ''}:scope:${resolveConversationScopeKeySegment(normalizedConversationScope)}`"
         :sync-browser-state="syncBrowserState"
         :conversation-id="selectedConversationId"
@@ -176,6 +188,7 @@ provideChatMessageSent((payload) => {
         :suggestions="suggestions"
         :user="normalizedTelaAgentId ? null : user"
         :features="features"
+        @conversation-cleared="emit('conversationCleared', $event)"
         @update:conversation-id="selectConversation"
         @update:conversation-title="$emit('update:conversationTitle', $event)"
         @update:conversation-creator-filter="$emit('update:conversationCreatorFilter', $event)"
@@ -192,6 +205,9 @@ provideChatMessageSent((payload) => {
         <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
             <slot name="failed-message-actions" v-bind="slotProps" />
         </template>
+        <template v-if="$slots['user-message']" #user-message="slotProps">
+            <slot name="user-message" v-bind="slotProps" />
+        </template>
     </component>
     <TelaChatEmptyState v-else-if="workspaceId && harnessLoading" compact role="status" aria-live="polite">
         <TelaChatTextShimmer>Carregando agente…</TelaChatTextShimmer>

package/dist/runtime/embed/components/chat-embed.vue.d.ts

@@ -1,12 +1,14 @@
-declare var __VLS_26: {}, __VLS_29: {}, __VLS_32: {}, __VLS_35: any;
+declare var __VLS_29: {}, __VLS_32: {}, __VLS_35: {}, __VLS_38: any, __VLS_41: any;
 type __VLS_Slots = {} & {
-    'sidebar-bottom'?: (props: typeof __VLS_26) => any;
+    'sidebar-bottom'?: (props: typeof __VLS_29) => any;
 } & {
-    'topbar-leading'?: (props: typeof __VLS_29) => any;
+    'topbar-leading'?: (props: typeof __VLS_32) => any;
 } & {
-    'composer-bottom'?: (props: typeof __VLS_32) => any;
+    'composer-bottom'?: (props: typeof __VLS_35) => any;
 } & {
-    'failed-message-actions'?: (props: typeof __VLS_35) => any;
+    'failed-message-actions'?: (props: typeof __VLS_38) => any;
+} & {
+    'user-message'?: (props: typeof __VLS_41) => any;
 };
 declare const __VLS_base: import("vue").DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import("vue").PublicProps>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/runtime/embed/components/meistrari-chat-embed.d.vue.ts

@@ -1,4 +1,5 @@
 import type { DefineSetupFnComponent, SlotsType } from 'vue';
+import type { ChatEmbedHost } from '../../types/embed.js';
 import type { ChatActionPayload } from '../../messages/composables/chat-action.js';
 import type { MessageFeedbackPayload } from '../../messages/composables/chat-feedback.js';
 import type { ChatMessageTerminalPayload } from '../../messages/composables/chat-message-terminal.js';
@@ -22,6 +23,8 @@ type MeistrariChatEmbedEmits = {
     'messageTerminal': (payload: ChatMessageTerminalPayload) => any;
     /** Fired once the server accepts a user message, including retries of a failed answer. */
     'messageSent': (payload: ChatMessageSentPayload) => any;
+    /** Fired after an in-place reset; the conversation ID is unchanged. */
+    'conversationCleared': (conversationId: string) => any;
 };
 
 type MeistrariChatEmbedSlots = SlotsType<{
@@ -33,6 +36,8 @@ type MeistrariChatEmbedSlots = SlotsType<{
     'composer-bottom'?: () => any;
     /** Rendered inside a failed assistant message's error box, next to "Tentar novamente"; receives the failed message. */
     'failed-message-actions'?: (props: { message: Message }) => any;
+    /** Replaces the text of a user message, keeping its attachments, sender and timestamp; render nothing to keep the default text. */
+    'user-message'?: (props: { message: Message }) => any;
 }>;
 
 /**
@@ -61,7 +66,8 @@ type MeistrariChatEmbedSlots = SlotsType<{
  * </template>
  * ```
  */
-declare const MeistrariChatEmbed: DefineSetupFnComponent<MeistrariChatEmbedProps, MeistrariChatEmbedEmits, MeistrariChatEmbedSlots>;
+type EmbedComponent = DefineSetupFnComponent<MeistrariChatEmbedProps, MeistrariChatEmbedEmits, MeistrariChatEmbedSlots>;
+declare const MeistrariChatEmbed: EmbedComponent & { new (): InstanceType<EmbedComponent> & ChatEmbedHost };
 
 export default MeistrariChatEmbed;
 export type { AvailableChatModels, ChatActionPayload, ChatEmbedVariant, ChatEmbedVariantProps, ChatFeatureConfig, ChatMessageSentPayload, ChatMessageTerminalPayload, ChatSidebarConfig, ChatSuggestion, DefaultChatEmbedProps, MeistrariChatEmbedProps, Message, MessageFeedbackPayload, TelaAgentChatEmbedProps };

package/dist/runtime/embed/components/meistrari-chat-embed.vue

@@ -41,7 +41,7 @@ const { hideSidebar = void 0, syncBrowserState = true, closeOnOutsideClick = tru
   keepMounted: { type: Boolean, required: false },
   launcherLabel: { type: String, required: false }
 });
-const emit = defineEmits(["update:conversationId", "update:conversationCreatorFilter", "update:open", "action", "messageFeedback", "messageTerminal", "messageSent"]);
+const emit = defineEmits(["conversationCleared", "update:conversationId", "update:conversationCreatorFilter", "update:open", "action", "messageFeedback", "messageTerminal", "messageSent"]);
 defineSlots();
 provideConversationCreatorFilterState({
   defaultConversationCreatorFilter: () => props.defaultConversationCreatorFilter,
@@ -107,11 +107,23 @@ const widgetEmbedProps = computed(() => ({
   conversationId: widgetConversationId.value,
   hideSidebar: hideSidebar ?? true
 }));
+const host = ref(null);
+function requireHost() {
+  if (!host.value)
+    throw new Error("Chat is not ready");
+  return host.value;
+}
+defineExpose({
+  sendMessage: (content, messageId) => requireHost().sendMessage(content, messageId),
+  cancel: () => requireHost().cancel(),
+  clear: () => requireHost().clear()
+});
 </script>
 
 <template>
     <ChatEmbed
         v-if="variant === 'page'"
+        ref="host"
         v-bind="pageEmbedProps"
         @update:conversation-id="emit('update:conversationId', $event)"
         @update:conversation-creator-filter="emit('update:conversationCreatorFilter', $event)"
@@ -119,6 +131,7 @@ const widgetEmbedProps = computed(() => ({
         @message-feedback="emit('messageFeedback', $event)"
         @message-terminal="emit('messageTerminal', $event)"
         @message-sent="emit('messageSent', $event)"
+        @conversation-cleared="emit('conversationCleared', $event)"
     >
         <template v-if="$slots['sidebar-bottom']" #sidebar-bottom>
             <slot name="sidebar-bottom" />
@@ -132,6 +145,9 @@ const widgetEmbedProps = computed(() => ({
         <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
             <slot name="failed-message-actions" v-bind="slotProps" />
         </template>
+        <template v-if="$slots['user-message']" #user-message="slotProps">
+            <slot name="user-message" v-bind="slotProps" />
+        </template>
     </ChatEmbed>
 
     <ClientOnly v-else>
@@ -153,6 +169,7 @@ const widgetEmbedProps = computed(() => ({
             </TelaChatWidgetHeader>
             <div flex-1 min-h-0>
                 <ChatEmbed
+                    ref="host"
                     v-bind="widgetEmbedProps"
                     compact
                     @update:conversation-id="handleWidgetConversationIdChange"
@@ -162,10 +179,14 @@ const widgetEmbedProps = computed(() => ({
                     @message-feedback="emit('messageFeedback', $event)"
                     @message-terminal="emit('messageTerminal', $event)"
                     @message-sent="emit('messageSent', $event)"
+                    @conversation-cleared="emit('conversationCleared', $event)"
                 >
                     <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
                         <slot name="failed-message-actions" v-bind="slotProps" />
                     </template>
+                    <template v-if="$slots['user-message']" #user-message="slotProps">
+                        <slot name="user-message" v-bind="slotProps" />
+                    </template>
                 </ChatEmbed>
             </div>
         </TelaChatFloatingWindow>
@@ -183,6 +204,7 @@ const widgetEmbedProps = computed(() => ({
             </TelaChatWidgetHeader>
             <div flex-1 min-h-0>
                 <ChatEmbed
+                    ref="host"
                     v-bind="widgetEmbedProps"
                     compact
                     @update:conversation-id="handleWidgetConversationIdChange"
@@ -192,10 +214,14 @@ const widgetEmbedProps = computed(() => ({
                     @message-feedback="emit('messageFeedback', $event)"
                     @message-terminal="emit('messageTerminal', $event)"
                     @message-sent="emit('messageSent', $event)"
+                    @conversation-cleared="emit('conversationCleared', $event)"
                 >
                     <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
                         <slot name="failed-message-actions" v-bind="slotProps" />
                     </template>
+                    <template v-if="$slots['user-message']" #user-message="slotProps">
+                        <slot name="user-message" v-bind="slotProps" />
+                    </template>
                 </ChatEmbed>
             </div>
         </TelaChatSidepanelWindow>

package/dist/runtime/embed/components/meistrari-chat-embed.vue.d.ts

@@ -1,4 +1,5 @@
 import type { DefineSetupFnComponent, SlotsType } from 'vue';
+import type { ChatEmbedHost } from '../../types/embed.js';
 import type { ChatActionPayload } from '../../messages/composables/chat-action.js';
 import type { MessageFeedbackPayload } from '../../messages/composables/chat-feedback.js';
 import type { ChatMessageTerminalPayload } from '../../messages/composables/chat-message-terminal.js';
@@ -22,6 +23,8 @@ type MeistrariChatEmbedEmits = {
     'messageTerminal': (payload: ChatMessageTerminalPayload) => any;
     /** Fired once the server accepts a user message, including retries of a failed answer. */
     'messageSent': (payload: ChatMessageSentPayload) => any;
+    /** Fired after an in-place reset; the conversation ID is unchanged. */
+    'conversationCleared': (conversationId: string) => any;
 };
 
 type MeistrariChatEmbedSlots = SlotsType<{
@@ -33,6 +36,8 @@ type MeistrariChatEmbedSlots = SlotsType<{
     'composer-bottom'?: () => any;
     /** Rendered inside a failed assistant message's error box, next to "Tentar novamente"; receives the failed message. */
     'failed-message-actions'?: (props: { message: Message }) => any;
+    /** Replaces the text of a user message, keeping its attachments, sender and timestamp; render nothing to keep the default text. */
+    'user-message'?: (props: { message: Message }) => any;
 }>;
 
 /**
@@ -61,7 +66,8 @@ type MeistrariChatEmbedSlots = SlotsType<{
  * </template>
  * ```
  */
-declare const MeistrariChatEmbed: DefineSetupFnComponent<MeistrariChatEmbedProps, MeistrariChatEmbedEmits, MeistrariChatEmbedSlots>;
+type EmbedComponent = DefineSetupFnComponent<MeistrariChatEmbedProps, MeistrariChatEmbedEmits, MeistrariChatEmbedSlots>;
+declare const MeistrariChatEmbed: EmbedComponent & { new (): InstanceType<EmbedComponent> & ChatEmbedHost };
 
 export default MeistrariChatEmbed;
 export type { AvailableChatModels, ChatActionPayload, ChatEmbedVariant, ChatEmbedVariantProps, ChatFeatureConfig, ChatMessageSentPayload, ChatMessageTerminalPayload, ChatSidebarConfig, ChatSuggestion, DefaultChatEmbedProps, MeistrariChatEmbedProps, Message, MessageFeedbackPayload, TelaAgentChatEmbedProps };

package/dist/runtime/embed/components/mobile/chat-mobile-outdated-settings-sheet.d.vue.ts

@@ -3,12 +3,12 @@ type __VLS_Props = {
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     close: () => any;
-    dismiss: () => any;
     newConversation: () => any;
+    dismiss: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
-    onDismiss?: (() => any) | undefined;
     onNewConversation?: (() => any) | undefined;
+    onDismiss?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/embed/components/mobile/chat-mobile-outdated-settings-sheet.vue.d.ts

@@ -3,12 +3,12 @@ type __VLS_Props = {
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     close: () => any;
-    dismiss: () => any;
     newConversation: () => any;
+    dismiss: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onClose?: (() => any) | undefined;
-    onDismiss?: (() => any) | undefined;
     onNewConversation?: (() => any) | undefined;
+    onDismiss?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/embed/components/mobile/chat-mobile-shell.d.vue.ts

@@ -52,13 +52,13 @@ type __VLS_ModelProps = {
     'selectedReasoningEffort'?: ChatReasoningEffort | null;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_54: {}, __VLS_100: {}, __VLS_102: {};
+declare var __VLS_54: {}, __VLS_101: {}, __VLS_103: {};
 type __VLS_Slots = {} & {
     loading?: (props: typeof __VLS_54) => any;
 } & {
-    empty?: (props: typeof __VLS_100) => any;
+    empty?: (props: typeof __VLS_101) => any;
 } & {
-    default?: (props: typeof __VLS_102) => any;
+    default?: (props: typeof __VLS_103) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:selectedModel": (value: string | null) => any;
@@ -74,9 +74,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     selectConversation: (id: string) => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
     settings: () => any;
+    newConversation: (groupId?: string | null | undefined) => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
     tabChange: (tab: TopbarTab) => any;
-    newConversation: (groupId?: string | null | undefined) => any;
     switchWorkspace: () => any;
     signout: () => any;
     cancelEditing: () => any;
@@ -96,11 +96,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onSelectConversation?: ((id: string) => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
     onSettings?: (() => any) | undefined;
+    onNewConversation?: ((groupId?: string | null | undefined) => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;
     onTabChange?: ((tab: TopbarTab) => any) | undefined;
-    onNewConversation?: ((groupId?: string | null | undefined) => any) | undefined;
     onSwitchWorkspace?: (() => any) | undefined;
     onSignout?: (() => any) | undefined;
     onCancelEditing?: (() => any) | undefined;

package/dist/runtime/embed/components/mobile/chat-mobile-shell.vue

@@ -253,6 +253,7 @@ function startNewConversationFromOutdatedSettings() {
                         :execution-controls-disabled="executionControlsDisabled"
                         centered
                         @select-execution-profile="emit('selectExecutionProfile', $event)"
+                        @new-conversation="emit('newConversation')"
                         @send="(content, files, agentInputs) => emit('send', content, files, agentInputs)"
                         @cancel="emit('cancel')"
                     />

package/dist/runtime/embed/components/mobile/chat-mobile-shell.vue.d.ts

@@ -52,13 +52,13 @@ type __VLS_ModelProps = {
     'selectedReasoningEffort'?: ChatReasoningEffort | null;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_54: {}, __VLS_100: {}, __VLS_102: {};
+declare var __VLS_54: {}, __VLS_101: {}, __VLS_103: {};
 type __VLS_Slots = {} & {
     loading?: (props: typeof __VLS_54) => any;
 } & {
-    empty?: (props: typeof __VLS_100) => any;
+    empty?: (props: typeof __VLS_101) => any;
 } & {
-    default?: (props: typeof __VLS_102) => any;
+    default?: (props: typeof __VLS_103) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:selectedModel": (value: string | null) => any;
@@ -74,9 +74,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     selectConversation: (id: string) => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
     settings: () => any;
+    newConversation: (groupId?: string | null | undefined) => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
     tabChange: (tab: TopbarTab) => any;
-    newConversation: (groupId?: string | null | undefined) => any;
     switchWorkspace: () => any;
     signout: () => any;
     cancelEditing: () => any;
@@ -96,11 +96,11 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onSelectConversation?: ((id: string) => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
     onSettings?: (() => any) | undefined;
+    onNewConversation?: ((groupId?: string | null | undefined) => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;
     onTabChange?: ((tab: TopbarTab) => any) | undefined;
-    onNewConversation?: ((groupId?: string | null | undefined) => any) | undefined;
     onSwitchWorkspace?: (() => any) | undefined;
     onSignout?: (() => any) | undefined;
     onCancelEditing?: (() => any) | undefined;

package/dist/runtime/files/composables/conversation-files.d.ts

@@ -14,4 +14,5 @@ export declare function useConversationFiles(conversationId: Ref<string | null |
     documentFiles: any;
     otherFiles: any;
     fetchFiles: () => Promise<void>;
+    clearFiles: () => void;
 };

package/dist/runtime/files/composables/conversation-files.js

@@ -4,7 +4,8 @@ function useConversationFilesState() {
   return {
     files: useState("conversationFiles", () => ({})),
     loading: useState("conversationFilesLoading", () => ({})),
-    error: useState("conversationFilesError", () => ({}))
+    error: useState("conversationFilesError", () => ({})),
+    revisions: useState("conversationFilesRevisions", () => ({}))
   };
 }
 function addFilesToConversationState(state, conversationId, newFiles, messageId, messageRole) {
@@ -57,6 +58,7 @@ export function useConversationFiles(conversationId) {
     const id = conversationId.value;
     if (!id)
       return;
+    const revision = state.revisions.value[id] ?? 0;
     const fetchId = ++currentFetchId;
     state.loading.value = { ...state.loading.value, [id]: true };
     state.error.value = { ...state.error.value, [id]: null };
@@ -65,11 +67,11 @@ export function useConversationFiles(conversationId) {
         chatApi.path(`/conversations/${id}/files`),
         chatApi.withChatHeaders()
       );
-      if (fetchId === currentFetchId) {
+      if (fetchId === currentFetchId && revision === (state.revisions.value[id] ?? 0)) {
         state.files.value = { ...state.files.value, [id]: response.files };
       }
     } catch (err) {
-      if (fetchId === currentFetchId) {
+      if (fetchId === currentFetchId && revision === (state.revisions.value[id] ?? 0)) {
         state.error.value = {
           ...state.error.value,
           [id]: err instanceof Error ? err.message : "Falha ao buscar arquivos"
@@ -77,11 +79,21 @@ export function useConversationFiles(conversationId) {
         state.files.value = { ...state.files.value, [id]: [] };
       }
     } finally {
-      if (fetchId === currentFetchId) {
+      if (fetchId === currentFetchId && revision === (state.revisions.value[id] ?? 0)) {
         state.loading.value = { ...state.loading.value, [id]: false };
       }
     }
   }
+  function clearFiles() {
+    currentFetchId++;
+    const id = conversationId.value;
+    if (!id)
+      return;
+    state.revisions.value = { ...state.revisions.value, [id]: (state.revisions.value[id] ?? 0) + 1 };
+    state.files.value = { ...state.files.value, [id]: [] };
+    state.loading.value = { ...state.loading.value, [id]: false };
+    state.error.value = { ...state.error.value, [id]: null };
+  }
   const hasFiles = computed(() => files.value.length > 0);
   const imageFiles = computed(
     () => files.value.filter((f) => f.mimeType.startsWith("image/"))
@@ -108,6 +120,7 @@ export function useConversationFiles(conversationId) {
     imageFiles,
     documentFiles,
     otherFiles,
-    fetchFiles
+    fetchFiles,
+    clearFiles
   };
 }

package/dist/runtime/lightweight/embed/components/chat-embed-adapter.d.vue.ts

@@ -1,8 +1,12 @@
-declare var __VLS_10: string, __VLS_11: any;
+declare var __VLS_11: string, __VLS_12: any;
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+    [K in NonNullable<typeof __VLS_11>]?: (props: typeof __VLS_12) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<{}, {
+    clear: () => any;
+    sendMessage: (content: string, messageId?: string) => any;
+    cancel: () => any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/lightweight/embed/components/chat-embed-adapter.vue

@@ -4,6 +4,12 @@ import { provideChatHarnessAdapter } from "../../../embed/composables/harness-ad
 import { useChat } from "../../messages/composables/chat";
 import { useLightweightModelSelection } from "../composables/model-selection";
 defineOptions({ inheritAttrs: false });
+const host = ref(null);
+defineExpose({
+  clear: () => host.value?.clear() ?? Promise.resolve(false),
+  sendMessage: (content, messageId) => host.value?.sendMessage(content, messageId) ?? Promise.resolve(false),
+  cancel: () => host.value?.cancel() ?? Promise.resolve()
+});
 provideChatHarnessAdapter({
   useChat,
   useModelSelection: useLightweightModelSelection,
@@ -12,7 +18,7 @@ provideChatHarnessAdapter({
 </script>
 
 <template>
-    <ChatEmbedInner v-bind="$attrs">
+    <ChatEmbedInner ref="host" v-bind="$attrs">
         <template v-for="(_, name) in $slots" #[name]="slotProps">
             <slot :name="name" v-bind="slotProps || {}" />
         </template>

package/dist/runtime/lightweight/embed/components/chat-embed-adapter.vue.d.ts

@@ -1,8 +1,12 @@
-declare var __VLS_10: string, __VLS_11: any;
+declare var __VLS_11: string, __VLS_12: any;
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+    [K in NonNullable<typeof __VLS_11>]?: (props: typeof __VLS_12) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<{}, {
+    clear: () => any;
+    sendMessage: (content: string, messageId?: string) => any;
+    cancel: () => any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/lightweight/messages/composables/chat.d.ts

@@ -34,7 +34,7 @@ export declare function useChat(options?: Parameters<typeof useSharedChat>[0]):
         wakeSessionId?: string;
         defer?: boolean;
         executionSettings?: ExecutionSettings;
-    }>, queuedSend?: import("../../../messages/composables/outbound-queue.js").QueuedSend) => Promise<Message | null>;
+    }>, queuedSend?: import("../../../messages/composables/outbound-queue.js").QueuedSend, messageId?: string) => Promise<Message | null>;
     flushOutboundQueue: (wakeSessionId?: string) => Promise<Message | null>;
     failOutboundQueue: (message: string) => boolean;
     retryMessage: (messageId: string, prepare?: () => Promise<{

package/dist/runtime/messages/components/chat-message-bubble.d.vue.ts

@@ -20,6 +20,13 @@ type __VLS_Slots = {
     'failed-message-actions'?: (props: {
         message: Message;
     }) => unknown;
+    /**
+     * Replaces the text of a user message. Attachments, sender and timestamp
+     * stay in place, and rendering nothing keeps the default text.
+     */
+    'user-message'?: (props: {
+        message: Message;
+    }) => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     retry: (messageId: string) => any;

package/dist/runtime/messages/components/chat-message-bubble.vue

@@ -196,10 +196,12 @@ const attachedFiles = computed(() => {
                         </template>
                     </div>
                     <div body-16-regular whitespace-pre-wrap break-words>
-                        <template v-for="(segment, index) in userContentSegments" :key="`${index}-${segment.type === 'citation' ? segment.citation.raw : 'text'}`">
-                            <ChatCitation v-if="segment.type === 'citation'" :citation="segment.citation" :label="segment.label" />
-                            <span v-else v-html="renderUserText(segment.content)" />
-                        </template>
+                        <slot name="user-message" :message="message">
+                            <template v-for="(segment, index) in userContentSegments" :key="`${index}-${segment.type === 'citation' ? segment.citation.raw : 'text'}`">
+                                <ChatCitation v-if="segment.type === 'citation'" :citation="segment.citation" :label="segment.label" />
+                                <span v-else v-html="renderUserText(segment.content)" />
+                            </template>
+                        </slot>
                     </div>
                 </TelaChatMessageContent>
 

package/dist/runtime/messages/components/chat-message-bubble.vue.d.ts

@@ -20,6 +20,13 @@ type __VLS_Slots = {
     'failed-message-actions'?: (props: {
         message: Message;
     }) => unknown;
+    /**
+     * Replaces the text of a user message. Attachments, sender and timestamp
+     * stay in place, and rendering nothing keeps the default text.
+     */
+    'user-message'?: (props: {
+        message: Message;
+    }) => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     retry: (messageId: string) => any;

package/dist/runtime/messages/components/chat-message-input.d.vue.ts

@@ -51,10 +51,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
 } & {
     cancel: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
+    newConversation: () => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onCancel?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
+    onNewConversation?: (() => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;

package/dist/runtime/messages/components/chat-message-input.vue

@@ -35,7 +35,7 @@ const props = defineProps({
   sendBlocked: { type: Boolean, required: false },
   draftStorageKey: { type: [String, null], required: false }
 });
-const emit = defineEmits(["send", "cancel", "selectExecutionProfile"]);
+const emit = defineEmits(["send", "newConversation", "cancel", "selectExecutionProfile"]);
 const selectedModel = defineModel("selectedModel", { type: [String, null], ...{ default: null } });
 const composerExtension = inject(CHAT_COMPOSER_EXTENSION_KEY, null);
 const selectedReasoningEffort = defineModel("selectedReasoningEffort", { type: null, ...{ default: null } });
@@ -125,7 +125,10 @@ const skillItems = computed(() => {
   }
   return items;
 });
-const commandItems = computed(() => composerExtension?.commands ?? []);
+const commandItems = computed(() => [
+  { id: "new", label: "/new", description: "Criar uma nova conversa", icon: "i-ph-plus", run: startNewConversation },
+  ...(composerExtension?.commands ?? []).filter((command) => command.id !== "new")
+]);
 const mentionAutocomplete = useMentionAutocomplete({
   editorRef,
   fileItems,
@@ -134,8 +137,18 @@ const mentionAutocomplete = useMentionAutocomplete({
   disabled: isLocked,
   onInsert: handleInput
 });
+function startNewConversation() {
+  if (isLocked.value || props.sendBlocked || uploading.value)
+    return;
+  setDraft("");
+  pendingFiles.value = [];
+  agentInputTexts.value = {};
+  mentionAutocomplete.resetMentions();
+  inputHistory.resetNavigation();
+  emit("newConversation");
+}
 const canSend = computed(
-  () => content.value.trim().length > 0 && !isLocked.value && !props.sendBlocked && !uploading.value && !props.agentInputSchemaLoading && agentInputReadiness.value.ready
+  () => content.value.trim().length > 0 && !isLocked.value && !props.sendBlocked && !uploading.value && (content.value.trim() === "/new" || !props.agentInputSchemaLoading && agentInputReadiness.value.ready)
 );
 const submitStatus = computed(() => {
   if (uploading.value)
@@ -278,6 +291,10 @@ function buildAgentInputs(files, queuedFiles) {
 async function handleSend() {
   if (!canSend.value)
     return;
+  if (content.value.trim() === "/new") {
+    startNewConversation();
+    return;
+  }
   let files = [];
   const queuedFiles = [...pendingFiles.value];
   if (queuedFiles.length > 0) {

package/dist/runtime/messages/components/chat-message-input.vue.d.ts

@@ -51,10 +51,12 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
 } & {
     cancel: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
+    newConversation: () => any;
     selectExecutionProfile: (profile: ChatExecutionProfile) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onCancel?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
+    onNewConversation?: (() => any) | undefined;
     onSelectExecutionProfile?: ((profile: ChatExecutionProfile) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;
     "onUpdate:selectedReasoningEffort"?: ((value: any) => any) | undefined;

package/dist/runtime/messages/components/chat-message-list.d.vue.ts

@@ -22,6 +22,9 @@ type __VLS_Slots = {
     'failed-message-actions'?: (props: {
         message: Message;
     }) => unknown;
+    'user-message'?: (props: {
+        message: Message;
+    }) => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     isPinned: import("vue").Ref<boolean, boolean>;

package/dist/runtime/messages/components/chat-message-list.vue

@@ -153,6 +153,9 @@ defineExpose({
                             <template v-if="$slots['failed-message-actions']" #failed-message-actions="slotProps">
                                 <slot name="failed-message-actions" v-bind="slotProps" />
                             </template>
+                            <template v-if="$slots['user-message']" #user-message="slotProps">
+                                <slot name="user-message" v-bind="slotProps" />
+                            </template>
                         </ChatMessageBubble>
                     </template>
                     <p

package/dist/runtime/messages/components/chat-message-list.vue.d.ts

@@ -22,6 +22,9 @@ type __VLS_Slots = {
     'failed-message-actions'?: (props: {
         message: Message;
     }) => unknown;
+    'user-message'?: (props: {
+        message: Message;
+    }) => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
     isPinned: import("vue").Ref<boolean, boolean>;

package/dist/runtime/messages/composables/chat.d.ts

@@ -72,7 +72,7 @@ export declare function useChat(options?: {
         wakeSessionId?: string;
         defer?: boolean;
         executionSettings?: ExecutionSettings;
-    }>, queuedSend?: QueuedSend) => Promise<Message | null>;
+    }>, queuedSend?: QueuedSend, messageId?: string) => Promise<Message | null>;
     flushOutboundQueue: (wakeSessionId?: string) => Promise<Message | null>;
     failOutboundQueue: (message: string) => boolean;
     retryMessage: (messageId: string, prepare?: () => Promise<{

package/dist/runtime/messages/composables/chat.js

@@ -165,8 +165,9 @@ export function useChat(options = {}, adapter = {}) {
   const streamingMessageId = ref(null);
   const pendingStreamReconciliationIds = ref(/* @__PURE__ */ new Set());
   const pendingRealResultIds = ref(/* @__PURE__ */ new Set());
+  const clearing = ref(false);
   const composerLocked = computed(
-    () => hasPendingMessage.value || runtimeBlocked.value || pendingRealResultIds.value.size > 0 || outbound.occupied.value
+    () => clearing.value || hasPendingMessage.value || runtimeBlocked.value || pendingRealResultIds.value.size > 0 || outbound.occupied.value
   );
   const queuedMessageContent = computed(() => outbound.slot.value?.content ?? null);
   let requestDurableRecovery = () => {
@@ -562,7 +563,9 @@ export function useChat(options = {}, adapter = {}) {
         loading.value = false;
     }
   };
-  const sendMessage = async (content, files, agentInputs, prepare, queuedSend) => {
+  const sendMessage = async (content, files, agentInputs, prepare, queuedSend, messageId) => {
+    if (clearing.value)
+      return null;
     if (!currentConversation.value && !prepare)
       return null;
     if (outboundQueueEnabled.value && outbound.occupied.value && !queuedSend)
@@ -579,6 +582,7 @@ export function useChat(options = {}, adapter = {}) {
     const existingOptimisticUserMessage = queuedSend ? messages.value.find((message) => message.id === queuedSend.optimisticIds.user) : void 0;
     const existingOptimisticAssistantMessage = queuedSend ? messages.value.find((message) => message.id === queuedSend.optimisticIds.assistant) : void 0;
     const optimisticPair = createOptimisticMessagePair({
+      messageId,
       conversationId,
       content,
       files: filesWithSource,
@@ -957,30 +961,48 @@ export function useChat(options = {}, adapter = {}) {
     }
   };
   const clearConversationThread = async () => {
-    if (!currentConversation.value)
+    const conversationId = currentConversation.value?.id;
+    if (!conversationId || clearing.value || hasPendingMessage.value || sending.value || outbound.occupied.value)
       return false;
+    const generation = loadGeneration;
+    const ownsView = () => generation === loadGeneration && currentConversation.value?.id === conversationId;
+    clearing.value = true;
     error.value = null;
+    stopPolling();
     try {
       const updated = await $fetch(
-        chatApi.path(`/conversations/${currentConversation.value.id}/clear`),
+        chatApi.path(`/conversations/${conversationId}/clear`),
         chatApi.withChatHeaders({ method: "POST" })
       );
-      currentConversation.value = {
-        ...currentConversation.value,
-        ...updated,
-        messages: []
-      };
+      if (!ownsView())
+        return true;
+      stopPolling();
+      loadGeneration++;
+      loading.value = false;
+      gateController?.abort();
+      outbound.clear();
+      uncertainSend = null;
+      clearPreparingSteps();
+      directStream.disconnect();
+      currentConversation.value = { ...currentConversation.value, ...updated, messages: [] };
       messages.value = [];
+      runtimeBlocked.value = false;
       pendingStreamReconciliationIds.value = /* @__PURE__ */ new Set();
       pendingRealResultIds.value = /* @__PURE__ */ new Set();
       streamingMessageId.value = null;
-      directStream.disconnect();
+      agentSessionStatus.value = null;
+      agentSessionExecutable.value = false;
+      agentSessionRewakeable.value = false;
       return true;
     } catch (err) {
-      const message = err instanceof Error ? err.message : "Erro ao limpar conversa";
-      error.value = message;
+      if (ownsView()) {
+        error.value = err instanceof Error ? err.message : "Erro ao limpar conversa";
+        startPolling();
+      }
       Sentry.captureException(err);
       return false;
+    } finally {
+      clearing.value = false;
     }
   };
   const retryMessage = async (messageId, prepare) => {

package/dist/runtime/messages/message-state.d.ts

@@ -8,6 +8,7 @@ export declare function createOptimisticMessagePair(input: {
     files: Message['files'];
     createdBy: string | null;
     now?: Date;
+    messageId?: string;
     createId?: () => string;
 }): {
     user: Message;

package/dist/runtime/messages/message-state.js

@@ -7,7 +7,7 @@ export function createOptimisticMessagePair(input) {
   const assistantCreatedAt = new Date(userCreatedAt.getTime() + 1);
   return {
     user: {
-      id: createId(),
+      id: input.messageId ?? createId(),
       conversationId: input.conversationId,
       role: "user",
       content: input.content,

package/dist/runtime/types/embed.d.ts

@@ -11,3 +11,11 @@ export type { ConversationEvent, Message } from './schemas/chat/conversations.js
 export type { MessageOverviewResponse } from './schemas/chat/messages.js';
 export type { ConversationCreatorFilter } from './schemas/chat/primitives.js';
 export type { TelaAgentExecutionInput } from './schemas/integrations/tela-agent-api.js';
+/** Host controls for a ready Claude/v4 embed; these add no recording UI. */
+export interface ChatEmbedHost {
+    /** True transfers ownership to chat, including pending network reconciliation; do not submit it again. */
+    sendMessage: (content: string, messageId?: string) => Promise<boolean>;
+    /** Clear history and runtime bindings while preserving the conversation ID. */
+    clear: () => Promise<boolean>;
+    cancel: () => Promise<void>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meistrari/chat-nuxt",
-  "version": "4.12.0-rc.1",
+  "version": "4.12.0-rc.2",
   "type": "module",
   "exports": {
     ".": {