@meistrari/chat-nuxt 4.1.0-rc.1 → 4.1.0-rc.3

package/README.md

@@ -45,6 +45,8 @@ bunx --bun typedoc --entryPoints typedoc.ts --out /tmp/chat-nuxt-api --skipError
 
 The table below is a quick index for reading in-repo. **When you change a prop, update its JSDoc and this row together.**
 
+The embed automatically sets the browser tab title to the active conversation title and synchronizes its ID to `?conversationId=` using router replacement, preserving other query parameters and the URL fragment. Starting a new conversation removes the conversation parameter. Opening or reloading that URL restores the conversation; existing `?conversation=` links are also accepted and converted to `?conversationId=`. Explicit `conversationId` and `initialConversationId` props take precedence over the URL on mount. Without a conversation title, the host application controls the tab title.
+
 ### `<MeistrariChatEmbed>` props
 
 Declared in `src/runtime/embed/types.ts`; prop, feature-flag, and event payload types are importable from the package root or `@meistrari/chat-nuxt/types/embed`.

package/dist/module.json

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

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

@@ -13,7 +13,8 @@ import ChatMessageInput from "../../messages/components/chat-message-input.vue";
 import { normalizeConversationId } from "../../conversations/scope";
 import { resolveChatFeatures } from "../feature-config";
 import { resolveConversationCreator } from "../../conversations/creator";
-import { buildConversationShareUrl } from "../conversation-share-url";
+import { buildConversationShareUrl, getSharedConversationId } from "../conversation-share-url";
+import { useConversationBrowserState } from "../composables/conversation-browser-state";
 import {
   resolveTelaAgentInputs,
   useChat
@@ -133,7 +134,7 @@ const {
   closePreview
 } = useFilePreviewPanel();
 const { isOpen: isCitationPanelOpen } = useCitationPanel();
-const sharedConversationId = typeof route.query.conversation === "string" ? route.query.conversation : null;
+const sharedConversationId = getSharedConversationId(route.query);
 const activeConversationId = ref(
   normalizeConversationId(props.conversationId) ?? normalizeConversationId(props.initialConversationId) ?? normalizeConversationId(sharedConversationId)
 );
@@ -492,6 +493,11 @@ function dismissOutdatedBanner() {
   }
 }
 const optimisticTitle = ref(null);
+useConversationBrowserState(activeConversationId, computed(() => {
+  if (currentConversation.value?.id !== activeConversationId.value)
+    return null;
+  return optimisticTitle.value ?? currentConversation.value?.title ?? null;
+}));
 const displayTitle = computed(() => {
   if (optimisticTitle.value !== null)
     return optimisticTitle.value;

package/dist/runtime/embed/composables/conversation-browser-state.d.ts

@@ -0,0 +1,2 @@
+import type { Ref } from 'vue';
+export declare function useConversationBrowserState(conversationId: Ref<string | null>, title: Ref<string | null>): void;

package/dist/runtime/embed/composables/conversation-browser-state.js

@@ -0,0 +1,18 @@
+export function useConversationBrowserState(conversationId, title) {
+  const route = useRoute();
+  const router = useRouter();
+  useHead(computed(() => title.value ? { title: title.value } : {}));
+  onMounted(() => {
+    watch(conversationId, async (id) => {
+      if (route.query.conversationId === (id ?? void 0) && route.query.conversation === void 0)
+        return;
+      const query = { ...route.query };
+      delete query.conversation;
+      if (id)
+        query.conversationId = id;
+      else
+        delete query.conversationId;
+      await router.replace({ path: route.path, query, hash: route.hash });
+    }, { immediate: true });
+  });
+}

package/dist/runtime/embed/conversation-share-url.d.ts

@@ -1 +1,2 @@
+export declare function getSharedConversationId(query: Record<string, unknown>): string | null;
 export declare function buildConversationShareUrl(currentHref: string, conversationId: string): string;

package/dist/runtime/embed/conversation-share-url.js

@@ -1,5 +1,10 @@
+import { normalizeConversationId } from "../conversations/scope.js";
+export function getSharedConversationId(query) {
+  return normalizeConversationId(typeof query.conversationId === "string" ? query.conversationId : null) ?? normalizeConversationId(typeof query.conversation === "string" ? query.conversation : null);
+}
 export function buildConversationShareUrl(currentHref, conversationId) {
   const shareUrl = new URL(currentHref);
-  shareUrl.searchParams.set("conversation", conversationId);
+  shareUrl.searchParams.delete("conversation");
+  shareUrl.searchParams.set("conversationId", conversationId);
   return shareUrl.href;
 }

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

@@ -184,7 +184,7 @@ const hasDetectedFiles = computed(() => contentSegments.value.some((s) => s.type
                 :reasoning-data="message.reasoningData ?? []"
                 :completed="!isPending"
                 :preparing-steps="preparingSteps"
-                :created-at="message.createdAt"
+                :started-at="message.generationStartedAt ?? message.createdAt"
                 :updated-at="message.updatedAt"
             />
 

package/dist/runtime/messages/components/reasoning/chat-reasoning-thought.d.vue.ts

@@ -2,7 +2,7 @@ import { type ReasoningStep } from '../../reasoning.js';
 type __VLS_Props = {
     reasoningData: ReasoningStep[];
     completed: boolean;
-    createdAt: Date | string;
+    startedAt: Date | string;
     updatedAt?: Date | string | null;
     preparingSteps?: readonly string[] | null;
 };

package/dist/runtime/messages/components/reasoning/chat-reasoning-thought.vue

@@ -1,20 +1,23 @@
 <script setup>
 import { resolveDisplayedReasoning } from "../../reasoning";
+import { useReasoningTimer } from "../../composables/reasoning-timer";
 import { resolveToolTitle } from "../../tool-registry";
 import ChatReasoningCollapsibleContent from "./chat-reasoning-collapsible-content.vue";
 import ChatReasoningSteps from "./chat-reasoning-steps.vue";
 const props = defineProps({
   reasoningData: { type: Array, required: true },
   completed: { type: Boolean, required: true },
-  createdAt: { type: [Date, String], required: true },
+  startedAt: { type: [Date, String], required: true },
   updatedAt: { type: [Date, String, null], required: false },
   preparingSteps: { type: [Array, null], required: false }
 });
 const TEXT_TRUNCATE_LENGTH = 40;
 const isExpanded = ref(false);
-const elapsedTime = ref(0);
-let timerInterval;
-const storageKey = computed(() => `reasoning-timer-${new Date(props.createdAt).getTime()}`);
+const { elapsedTime, thinkingDuration } = useReasoningTimer({
+  startedAt: computed(() => props.startedAt),
+  updatedAt: computed(() => props.updatedAt),
+  completed: computed(() => props.completed)
+});
 const displayedReasoning = computed(
   () => resolveDisplayedReasoning(props.reasoningData, props.preparingSteps)
 );
@@ -37,14 +40,6 @@ const currentStepName = computed(() => {
   }
   return "Trabalhando";
 });
-const thinkingDuration = computed(() => {
-  if (!props.updatedAt)
-    return null;
-  const start = new Date(props.createdAt).getTime();
-  const end = new Date(props.updatedAt).getTime();
-  const duration = end - start;
-  return Number.isFinite(duration) && duration >= 0 ? duration : null;
-});
 const formattedDuration = computed(() => {
   if (!thinkingDuration.value)
     return null;
@@ -61,37 +56,6 @@ const liveFormattedDuration = computed(() => {
   const seconds = Math.round(elapsedTime.value / 1e3);
   return seconds > 0 ? `${seconds}s` : "";
 });
-watch(() => props.completed, (isCompleted) => {
-  if (!isCompleted && !timerInterval) {
-    const startTime = new Date(props.createdAt).getTime();
-    if (typeof window !== "undefined") {
-      localStorage.setItem(storageKey.value, startTime.toString());
-    }
-    elapsedTime.value = Date.now() - startTime;
-    timerInterval = setInterval(() => {
-      elapsedTime.value = Date.now() - startTime;
-    }, 1e3);
-  } else if (isCompleted && timerInterval) {
-    clearInterval(timerInterval);
-    timerInterval = void 0;
-    if (typeof window !== "undefined") {
-      localStorage.removeItem(storageKey.value);
-    }
-  }
-}, { immediate: true });
-onMounted(() => {
-  if (!props.completed && typeof window !== "undefined") {
-    const storedStartTime = localStorage.getItem(storageKey.value);
-    if (storedStartTime) {
-      const startTime = Number.parseInt(storedStartTime, 10);
-      elapsedTime.value = Date.now() - startTime;
-    }
-  }
-});
-onUnmounted(() => {
-  if (timerInterval)
-    clearInterval(timerInterval);
-});
 </script>
 
 <template>

package/dist/runtime/messages/components/reasoning/chat-reasoning-thought.vue.d.ts

@@ -2,7 +2,7 @@ import { type ReasoningStep } from '../../reasoning.js';
 type __VLS_Props = {
     reasoningData: ReasoningStep[];
     completed: boolean;
-    createdAt: Date | string;
+    startedAt: Date | string;
     updatedAt?: Date | string | null;
     preparingSteps?: readonly string[] | null;
 };

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

@@ -495,6 +495,7 @@ export function useChat(options = {}) {
       ttft: null,
       createdBy: authUser.value?.email ?? null,
       createdAt: /* @__PURE__ */ new Date(),
+      generationStartedAt: null,
       updatedAt: null
     };
     const optimisticAssistantMessage = existingOptimisticAssistantMessage ?? {
@@ -509,6 +510,7 @@ export function useChat(options = {}) {
       ttft: null,
       createdBy: null,
       createdAt: /* @__PURE__ */ new Date(),
+      generationStartedAt: /* @__PURE__ */ new Date(),
       updatedAt: null
     };
     streamingMessageId.value = optimisticAssistantMessage.id;
@@ -873,10 +875,13 @@ export function useChat(options = {}) {
       messages.value = retry.messages;
       streamingMessageId.value = messageId;
       directStream.beginMessage();
-      await $fetch(
+      const retriedMessage = await $fetch(
         chatApi.path(`/conversations/${conversationId}/messages/${messageId}/retry`),
         chatApi.withChatHeaders({ method: "POST" })
       );
+      if (currentConversation.value?.id !== conversationId)
+        return true;
+      messages.value = messages.value.map((message) => message.id === messageId ? { ...message, ...retriedMessage } : message);
       startPolling();
       return true;
     } catch (err) {

package/dist/runtime/messages/composables/reasoning-timer.d.ts

@@ -0,0 +1,9 @@
+import { type Ref } from 'vue';
+export declare function useReasoningTimer(options: {
+    startedAt: Readonly<Ref<Date | string>>;
+    updatedAt: Readonly<Ref<Date | string | null | undefined>>;
+    completed: Readonly<Ref<boolean>>;
+}): {
+    elapsedTime: Ref<number, number>;
+    thinkingDuration: import("vue").ComputedRef<number | null>;
+};

package/dist/runtime/messages/composables/reasoning-timer.js

@@ -0,0 +1,22 @@
+import { computed, ref, watch } from "vue";
+export function useReasoningTimer(options) {
+  const elapsedTime = ref(0);
+  const startTime = computed(() => new Date(options.startedAt.value).getTime());
+  const thinkingDuration = computed(() => {
+    if (!options.updatedAt.value)
+      return null;
+    const duration = new Date(options.updatedAt.value).getTime() - startTime.value;
+    return Number.isFinite(duration) && duration >= 0 ? duration : null;
+  });
+  watch([startTime, options.completed], ([start, completed], _previous, onCleanup) => {
+    if (completed)
+      return;
+    const update = () => {
+      elapsedTime.value = Number.isFinite(start) ? Math.max(0, Date.now() - start) : 0;
+    };
+    update();
+    const interval = setInterval(update, 1e3);
+    onCleanup(() => clearInterval(interval));
+  }, { immediate: true });
+  return { elapsedTime, thinkingDuration };
+}

package/dist/runtime/messages/debug/chat-debug-scenarios.js

@@ -88,6 +88,7 @@ function message(baseTime, offsetMs, input) {
     files: null,
     externalUuid: null,
     ttft: null,
+    generationStartedAt: null,
     createdBy: input.role === "user" ? "debugger@tela.com" : null,
     createdAt,
     updatedAt: input.updatedAt ?? createdAt,

package/dist/runtime/messages/debug/chat-debug-switch-scenario.js

@@ -31,6 +31,7 @@ function message(baseTime, offsetMs, input) {
     files: null,
     externalUuid: null,
     ttft: null,
+    generationStartedAt: null,
     createdBy: input.role === "user" ? "debugger@tela.com" : null,
     createdAt,
     updatedAt: createdAt,

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

@@ -37,7 +37,9 @@ export function beginAssistantMessageRetry(messages, messageId) {
         content: "",
         status: "pending",
         failReason: null,
-        reasoningData: null
+        reasoningData: null,
+        generationStartedAt: /* @__PURE__ */ new Date(),
+        updatedAt: null
       };
     })
   };

package/dist/runtime/types/schemas/chat/conversation-runtime.d.ts

@@ -114,6 +114,7 @@ export declare const sendMessageV2ResponseSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>;
     assistantMessage: z.ZodObject<{
         id: z.ZodString;
@@ -146,6 +147,7 @@ export declare const sendMessageV2ResponseSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>;
     turn: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;

package/dist/runtime/types/schemas/chat/conversations.d.ts

@@ -110,6 +110,7 @@ export declare const messageSchema: z.ZodObject<{
     createdBy: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodDate;
     updatedAt: z.ZodNullable<z.ZodDate>;
+    generationStartedAt: z.ZodNullable<z.ZodDate>;
 }, z.core.$strip>;
 export type Message = z.infer<typeof messageSchema>;
 export declare const conversationCreatorFilterCountsSchema: z.ZodRecord<z.ZodEnum<{
@@ -222,6 +223,7 @@ export declare const conversationWithMessagesSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ConversationWithMessages = z.infer<typeof conversationWithMessagesSchema>;

package/dist/runtime/types/schemas/chat/conversations.js

@@ -49,6 +49,7 @@ export const messageSchema = z.object({
     createdBy: z.string().nullable(),
     createdAt: z.date(),
     updatedAt: z.date().nullable(),
+    generationStartedAt: z.date().nullable(),
 });
 export const conversationCreatorFilterCountsSchema = z.record(conversationCreatorFilterSchema, z.number());
 export const conversationListMetadataSchema = z.object({

package/dist/runtime/types/schemas/chat/messages.d.ts

@@ -119,6 +119,7 @@ export declare const sendMessageResponseSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>;
     assistantMessage: z.ZodObject<{
         id: z.ZodString;
@@ -151,6 +152,7 @@ export declare const sendMessageResponseSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type SendMessageResponse = z.infer<typeof sendMessageResponseSchema>;
@@ -186,6 +188,7 @@ export declare const messagePollResponseSchema: z.ZodObject<{
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodDate;
         updatedAt: z.ZodNullable<z.ZodDate>;
+        generationStartedAt: z.ZodNullable<z.ZodDate>;
     }, z.core.$strip>>;
     newFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
         url: z.ZodString;

package/package.json

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