@meistrari/chat-nuxt 3.9.2 → 3.11.0

package/dist/runtime/embed/composables/use-agent-wake.js

@@ -0,0 +1,182 @@
+import { useChatApi } from "../../shared/composables/chat-api.js";
+const WAKE_POLL_INTERVAL_MS = 1500;
+const WAKE_BUDGET_MS = 3e4;
+const WAKE_SETTLE_TIMEOUT_MS = 35e3;
+export async function pollAgentWake(options) {
+  const now = options.now ?? Date.now;
+  const deadline = now() + (options.budgetMs ?? WAKE_BUDGET_MS);
+  const wait = options.wait ?? ((delayMs, signal) => new Promise((resolve, reject) => {
+    let timer;
+    const onAbort = () => {
+      if (timer)
+        clearTimeout(timer);
+      reject(new DOMException("Aborted", "AbortError"));
+    };
+    timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, delayMs);
+    if (signal?.aborted)
+      onAbort();
+    else
+      signal?.addEventListener("abort", onAbort, { once: true });
+  }));
+  try {
+    while (!options.signal?.aborted && now() <= deadline) {
+      const response = await options.request();
+      options.onResponse?.(response);
+      if (response.status !== "waking")
+        return response;
+      const remaining = deadline - now();
+      if (remaining <= 0)
+        break;
+      await wait(Math.min(options.pollIntervalMs ?? WAKE_POLL_INTERVAL_MS, remaining), options.signal);
+    }
+  } catch (error) {
+    if (error instanceof DOMException && error.name === "AbortError")
+      throw error;
+    return { status: "unavailable" };
+  }
+  return { status: "unavailable" };
+}
+export function useAgentWake() {
+  const chatApi = useChatApi();
+  const snapshot = ref({ state: "idle" });
+  const state = computed(() => snapshot.value.state);
+  const sessionId = computed(() => snapshot.value.sessionId);
+  let generation = 0;
+  let abortController = null;
+  let activeWake = null;
+  function setSnapshot(next) {
+    snapshot.value = next;
+  }
+  function skip() {
+    generation++;
+    abortController?.abort();
+    abortController = null;
+    activeWake = null;
+    setSnapshot({
+      state: "idle",
+      ...snapshot.value.sessionId ? { sessionId: snapshot.value.sessionId } : {}
+    });
+  }
+  function consume() {
+    generation++;
+    abortController?.abort();
+    abortController = null;
+    activeWake = null;
+    setSnapshot({ state: "idle" });
+  }
+  async function wake(model, requestedSessionId) {
+    generation++;
+    const currentGeneration = generation;
+    abortController?.abort();
+    const controller = new AbortController();
+    abortController = controller;
+    let wakeSessionId = requestedSessionId ?? snapshot.value.sessionId;
+    setSnapshot({
+      state: "waking",
+      ...wakeSessionId ? { sessionId: wakeSessionId } : {},
+      ...model ? { model } : {}
+    });
+    if (import.meta.server) {
+      const unavailable = { status: "unavailable" };
+      setSnapshot({ state: unavailable.status });
+      return unavailable;
+    }
+    const run = async () => {
+      try {
+        const result = await pollAgentWake({
+          signal: controller.signal,
+          request: () => $fetch(
+            chatApi.path("/agent/wake"),
+            chatApi.withChatHeaders({
+              method: "POST",
+              signal: controller.signal,
+              body: {
+                ...wakeSessionId ? { sessionId: wakeSessionId } : {},
+                ...model ? { model } : {}
+              }
+            })
+          ),
+          onResponse: (response) => {
+            if (currentGeneration !== generation)
+              return;
+            wakeSessionId = response.sessionId ?? wakeSessionId;
+            setSnapshot({
+              state: response.status,
+              ...wakeSessionId ? { sessionId: wakeSessionId } : {},
+              ...model ? { model } : {}
+            });
+          }
+        });
+        if (currentGeneration === generation) {
+          setSnapshot({
+            state: result.status,
+            ...result.sessionId ? { sessionId: result.sessionId } : {},
+            ...model ? { model } : {}
+          });
+        }
+        return result;
+      } catch (error) {
+        if (!(error instanceof DOMException && error.name === "AbortError") && currentGeneration === generation)
+          setSnapshot({ state: "unavailable" });
+        return { status: "unavailable" };
+      } finally {
+        if (abortController === controller)
+          abortController = null;
+      }
+    };
+    const pending = run();
+    activeWake = pending;
+    try {
+      return await pending;
+    } finally {
+      if (activeWake === pending)
+        activeWake = null;
+    }
+  }
+  async function waitUntilSettled(signal) {
+    if (snapshot.value.state !== "waking" || !activeWake)
+      return snapshot.value;
+    const pending = activeWake;
+    await new Promise((resolve, reject) => {
+      let settled = false;
+      let timer;
+      let onAbort = () => {
+      };
+      const finish = (error) => {
+        if (settled)
+          return;
+        settled = true;
+        if (timer)
+          clearTimeout(timer);
+        signal?.removeEventListener("abort", onAbort);
+        if (error)
+          reject(error);
+        else
+          resolve();
+      };
+      onAbort = () => finish(new DOMException("Aborted", "AbortError"));
+      timer = setTimeout(() => finish(), WAKE_SETTLE_TIMEOUT_MS);
+      if (signal?.aborted)
+        onAbort();
+      else
+        signal?.addEventListener("abort", onAbort, { once: true });
+      pending.then(() => finish(), () => finish());
+    });
+    return snapshot.value;
+  }
+  onUnmounted(() => {
+    generation++;
+    abortController?.abort();
+  });
+  return {
+    state,
+    sessionId,
+    wake,
+    skip,
+    consume,
+    waitUntilSettled
+  };
+}

package/dist/runtime/embed/feature-config.d.ts

@@ -1,11 +1,18 @@
+/** Optional UI toggles the host passes per embed instance. */
 export type ChatFeatureConfig = {
+    /** Usage tab in the chat topbar, with per-conversation token and cost stats. */
     showUsageTab?: boolean;
+    /** Debug entry in the topbar overflow menu. */
     showDebugOption?: boolean;
+    /** "Stop generation" button while a response streams. */
     showCancelButton?: boolean;
+    /** Time to first token shown in assistant message metadata. Defaults to true. */
+    showTtft?: boolean;
 };
 export type ResolvedChatFeatureConfig = {
     showUsageTab: boolean;
     showDebugOption: boolean;
     showCancelButton: boolean;
+    showTtft: boolean;
 };
 export declare function resolveChatFeatures(features?: Partial<ChatFeatureConfig>): ResolvedChatFeatureConfig;

package/dist/runtime/embed/feature-config.js

@@ -2,6 +2,7 @@ export function resolveChatFeatures(features) {
   return {
     showUsageTab: features?.showUsageTab ?? false,
     showDebugOption: features?.showDebugOption ?? false,
-    showCancelButton: features?.showCancelButton ?? false
+    showCancelButton: features?.showCancelButton ?? false,
+    showTtft: features?.showTtft ?? true
   };
 }

package/dist/runtime/embed/loading-messages.d.ts

@@ -1,4 +1,20 @@
 export declare const DEFAULT_CHAT_LOADING_MESSAGES: readonly ["Analisando sua pergunta", "Processando informações", "Consultando base de conhecimento", "Organizando ideias", "Elaborando resposta", "Refinando detalhes", "Verificando contexto", "Conectando conceitos", "Preparando resultado", "Quase lá", "Finalizando análise", "Estruturando resposta"];
+/**
+ * Stand-in steps for a turn that has not produced its own reasoning yet. They
+ * accumulate, so the bubble reads as an agent working through the wait rather
+ * than as a loading placeholder. The user message is already delivered at this
+ * point, so the wait belongs to the answer.
+ */
+export declare const CHAT_PREPARING_STEPS: readonly ["Preparando o ambiente de trabalho", "Analisando a mensagem"];
+/**
+ * The first delay is measured from the send, every later one from the step
+ * before it — so the sequence paces itself instead of racing a shared clock.
+ * Late enough that a turn answering promptly never shows a stand-in, and
+ * jittered so it does not look like a fixed-timer artifact.
+ */
+export declare const CHAT_PREPARING_STEP_DELAYS_MS: readonly [2500, 4000];
+export declare const CHAT_PREPARING_STEP_JITTER_MS = 500;
+export declare function nextChatPreparingStepDelay(stepIndex: number, random?: () => number): number;
 export type ChatLoadingMessageMode = 'ordered' | 'random';
 export type ChatLoadingMessagesInput = {
     loadingMessages?: readonly string[] | null;

package/dist/runtime/embed/loading-messages.js

@@ -12,6 +12,16 @@ export const DEFAULT_CHAT_LOADING_MESSAGES = [
   "Finalizando an\xE1lise",
   "Estruturando resposta"
 ];
+export const CHAT_PREPARING_STEPS = [
+  "Preparando o ambiente de trabalho",
+  "Analisando a mensagem"
+];
+export const CHAT_PREPARING_STEP_DELAYS_MS = [2500, 4e3];
+export const CHAT_PREPARING_STEP_JITTER_MS = 500;
+export function nextChatPreparingStepDelay(stepIndex, random = Math.random) {
+  const base = CHAT_PREPARING_STEP_DELAYS_MS[stepIndex] ?? CHAT_PREPARING_STEP_DELAYS_MS.at(-1);
+  return base + Math.floor(random() * CHAT_PREPARING_STEP_JITTER_MS);
+}
 function normalizeMessages(messages) {
   if (!messages?.length)
     return [];

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

@@ -6,6 +6,13 @@ import type { ChatLoadingMessageMode } from './loading-messages.js';
 import type { ChatFeatureConfig } from './feature-config.js';
 import type { ChatCitationsConfig } from '../citations/types.js';
 import type { MessageFeedbackConfig, MessageFeedbackRating } from '../messages/composables/chat-feedback.js';
+export type ChatEmbedVariant = 'page' | 'floating' | 'sidepanel';
+export type ChatSuggestion = {
+    /** Short label rendered on the suggestion pill. */
+    title: string;
+    /** Full prompt written into the message input when the pill is clicked. */
+    prompt: string;
+};
 export type ChatActor = {
     name?: string | null;
     email?: string | null;
@@ -35,9 +42,18 @@ export type ChatEmbedSharedProps = {
     conversationId?: string | null;
     /** Conversation id to open once on mount when `conversationId` is uncontrolled. */
     initialConversationId?: string | null;
-    /** Technical scope that isolates conversation history within the current workspace and runtime. */
+    /**
+     * Technical scope that isolates conversation history within the current workspace and runtime.
+     * Scoped embeds only see conversations created with the same scope, and unscoped embeds only
+     * see unscoped ones, so adding a scope never mixes with existing workspace-level history.
+     * Values are trimmed, blank strings become `null`, and the server accepts 1-200 characters
+     * from `A-Z`, `a-z`, `0-9`, `.`, `_`, `:`, `/`, and `-`.
+     */
     conversationScope?: string | null;
-    /** Initial creator filter for the sidebar conversation list. Defaults to all conversations. */
+    /**
+     * Initial creator filter for the sidebar conversation list: `'all'` (default) shows every
+     * conversation in scope, `'mine'` shows only those created by the current user.
+     */
     defaultConversationCreatorFilter?: ConversationCreatorFilter;
     /** Hide the conversation list and render only the active chat surface. */
     hideSidebar?: boolean;
@@ -46,14 +62,24 @@ export type ChatEmbedSharedProps = {
     /** Hide workspace settings actions while keeping the chat header and content unchanged. */
     hideSettings?: boolean;
     /**
-     * Hide the empty-state folder onboarding block (PASTAS header, ghost rows, hint
-     * text and inline create button). Folder creation stays available through the
-     * new-group button in the sidebar header.
+     * Tighter spacing tuned for widget shells (floating/sidepanel). Hides the
+     * conversation topbar, since the widget header replaces it. Applied
+     * automatically by the `floating` and `sidepanel` variants.
+     */
+    compact?: boolean;
+    /**
+     * Suggestion pills rendered in the conversation empty state. Each pill shows
+     * its `title` and clicking it writes `prompt` into the message input. When
+     * omitted or empty no pills are rendered — the lib ships no defaults.
      */
-    hideFolderHint?: boolean;
+    suggestions?: readonly ChatSuggestion[] | null;
     /** Custom pending-response messages shown while the assistant is working. */
     loadingMessages?: readonly string[] | null;
-    /** How custom loading messages rotate. Defaults to ordered behavior when omitted. */
+    /**
+     * How custom loading messages rotate: `'ordered'` (default) cycles them in order,
+     * `'random'` picks at random. Only applies when `loadingMessages` has at least one
+     * non-empty message.
+     */
     loadingMessagesMode?: ChatLoadingMessageMode | null;
     /** Custom markdown component renderers keyed by markdown node or tag name. */
     customComponents?: Record<string, Component>;
@@ -103,4 +129,17 @@ export type TelaAgentChatEmbedProps = ChatEmbedSharedProps & {
     /** Optional UI feature toggles that are still supported in Tela agent mode. */
     features?: Partial<ChatFeatureConfig>;
 };
-export type MeistrariChatEmbedProps = DefaultChatEmbedProps | TelaAgentChatEmbedProps;
+export type ChatEmbedVariantProps = {
+    /**
+     * Presentation shell: `'page'` (default) renders the full-page embed,
+     * `'floating'` renders a launcher pill with an anchored popover window, and
+     * `'sidepanel'` renders an always-open docked column. Widget variants render
+     * client-only and default to `hideSidebar`.
+     */
+    variant?: ChatEmbedVariant;
+    /** Floating variant only: start with the widget window open. */
+    defaultOpen?: boolean;
+    /** Floating variant only: label of the launcher pill. Defaults to `'Ask Tela'`. */
+    launcherLabel?: string;
+};
+export type MeistrariChatEmbedProps = (DefaultChatEmbedProps | TelaAgentChatEmbedProps) & ChatEmbedVariantProps;

package/dist/runtime/files/icons.d.ts

@@ -1,4 +1,4 @@
 export declare const FILE_ICONS: Record<string, string>;
-export declare function getFileIcon(mimeType: string): string;
+export declare function getFileIcon(mimeType?: string): string;
 export declare function getMimeIcon(mimeType?: string): string;
 export declare function getMimeLabel(mimeType?: string): string;

package/dist/runtime/files/icons.js

@@ -42,7 +42,7 @@ export const FILE_ICONS = {
   "unknown": "/chat-files/generic.svg"
 };
 export function getFileIcon(mimeType) {
-  return FILE_ICONS[mimeType] ?? "/chat-files/generic.svg";
+  return FILE_ICONS[mimeType ?? "unknown"] ?? "/chat-files/generic.svg";
 }
 export function getMimeIcon(mimeType) {
   if (!mimeType)

package/dist/runtime/messages/components/chat-mention-dropdown.d.vue.ts

@@ -1,9 +1,14 @@
 import type { MentionItem } from '../../types/schemas/chat/ui.js';
+type MentionDropdownItem = MentionItem & {
+    iconUrl?: string;
+};
 type __VLS_Props = {
-    items: MentionItem[];
+    items: MentionDropdownItem[];
     highlightedIndex: number;
     trigger: '@' | '/';
     query: string;
+    /** Viewport rect of the trigger character ('@' / '/') the panel anchors to. */
+    caretRect?: DOMRect | null;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     select: (item: MentionItem) => any;

package/dist/runtime/messages/components/chat-mention-dropdown.vue

@@ -3,10 +3,21 @@ const props = defineProps({
   items: { type: Array, required: true },
   highlightedIndex: { type: Number, required: true },
   trigger: { type: String, required: true },
-  query: { type: String, required: true }
+  query: { type: String, required: true },
+  caretRect: { type: null, required: false }
 });
 const emit = defineEmits(["select"]);
 const listRef = ref(null);
+const panelStyle = computed(() => {
+  const rect = props.caretRect;
+  if (!rect)
+    return {};
+  return {
+    position: "fixed",
+    left: `${Math.max(8, Math.min(rect.left, window.innerWidth - 416))}px`,
+    bottom: `${window.innerHeight - rect.top + 4}px`
+  };
+});
 const sections = computed(() => {
   if (props.trigger === "@") {
     return [{
@@ -43,41 +54,54 @@ watch(() => props.highlightedIndex, () => {
 </script>
 
 <template>
+    <!-- Custom listbox (not a reka menu: it must stay open and keep focus in
+         the contenteditable while the user types). Surface and item styling
+         mirror TelaMenubarContent / TelaMenubarItem exactly. -->
     <div
-        absolute bottom="100%" left-0 right-0 mb-4px
-        z-10
-        bg-white
-        rounded-12px
-        class="mention-dropdown custom-scrollbar"
-        max-h-240px
-        overflow-y-auto
+        :style="panelStyle"
+        class="mention-dropdown"
+        w-max min-w-244px max-w-400px
+        max-h-260px overflow-y-auto no-scrollbar
+        rounded-2xl
+        b-0.5px border-strong
+        bg
+        p-4px
     >
-        <div v-if="items.length === 0" px-12px py-10px>
-            <span text-13px text-gray-400>{{ emptyMessage }}</span>
+        <div v-if="items.length === 0" px-12px py-6px>
+            <span body-14-regular text-tertiary>{{ emptyMessage }}</span>
         </div>
 
-        <div ref="listRef" pb-8px flex="~ col" gap-4px>
+        <div v-else ref="listRef" flex="~ col">
             <template v-for="section in sections" :key="section.title">
-                <div px-12px pt-10px pb-0>
-                    <span text-11px font-500 text-gray-400 uppercase tracking-wide>{{ section.title }}</span>
+                <div px-12px pb-2px>
+                    <span body-12-medium text-tertiary>{{ section.title }}</span>
                 </div>
                 <button
                     v-for="entry in section.items"
                     :key="entry.item.id"
+                    type="button"
                     :data-highlighted="entry.globalIndex === highlightedIndex"
                     flex items-center gap-8px
-                    w-full
-                    h-48px
-                    px-12px
+                    w-full min-w-0
+                    rounded-10px
+                    px-12px py-4px
                     text-left
-                    transition-colors
-                    :class="entry.globalIndex === highlightedIndex ? 'bg-gray-200' : 'hover:bg-gray-50'"
+                    cursor-pointer select-none
+                    outline-none
+                    :class="entry.globalIndex === highlightedIndex ? 'bg-muted' : 'hover:bg-muted'"
                     @mousedown.prevent="emit('select', entry.item)"
                 >
-                    <div :class="entry.item.icon" text-16px text-gray-500 shrink-0 />
+                    <img
+                        v-if="entry.item.iconUrl"
+                        :src="entry.item.iconUrl"
+                        alt=""
+                        aria-hidden="true"
+                        w-18px h-18px shrink-0
+                    >
+                    <TelaIcon v-else :name="entry.item.icon" size="18px" color="icon-secondary" shrink-0 />
                     <div flex="~ col" min-w-0>
-                        <span text-13px text-gray-900 truncate>{{ entry.item.label }}</span>
-                        <span v-if="entry.item.description" text-11px text-gray-400 truncate>{{ entry.item.description }}</span>
+                        <span body-12-medium text-primary truncate>{{ entry.item.label }}</span>
+                        <span v-if="entry.item.description" body-10-regular leading-12px text-tertiary truncate>{{ entry.item.description }}</span>
                     </div>
                 </button>
             </template>
@@ -86,5 +110,5 @@ watch(() => props.highlightedIndex, () => {
 </template>
 
 <style scoped>
-.mention-dropdown{animation:mention-dropdown-in .25s ease-out;border:.5px solid #e5e7eb;box-shadow:0 3px 10px 0 hsla(0,0%,64%,.08),0 12px 20px 0 hsla(0,0%,64%,.06)}.custom-scrollbar{scrollbar-color:#d1d5db transparent;scrollbar-width:thin}.custom-scrollbar::-webkit-scrollbar{width:4px}.custom-scrollbar::-webkit-scrollbar-track{background:transparent}.custom-scrollbar::-webkit-scrollbar-thumb{background-color:#d1d5db;border-radius:3px}@keyframes mention-dropdown-in{0%{opacity:0;transform:translateY(4px)}to{opacity:1;transform:translateY(0)}}
+.mention-dropdown{bottom:100%;box-shadow:0 4px 16px 0 rgba(85,91,98,.14);margin-left:-4px;position:absolute;z-index:50}
 </style>

package/dist/runtime/messages/components/chat-mention-dropdown.vue.d.ts

@@ -1,9 +1,14 @@
 import type { MentionItem } from '../../types/schemas/chat/ui.js';
+type MentionDropdownItem = MentionItem & {
+    iconUrl?: string;
+};
 type __VLS_Props = {
-    items: MentionItem[];
+    items: MentionDropdownItem[];
     highlightedIndex: number;
     trigger: '@' | '/';
     query: string;
+    /** Viewport rect of the trigger character ('@' / '/') the panel anchors to. */
+    caretRect?: DOMRect | null;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     select: (item: MentionItem) => any;

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

@@ -1,11 +1,20 @@
 import type { Message } from '../../types/schemas/chat/conversations.js';
 type __VLS_Props = {
     message: Message;
+    streamActive?: boolean;
+    /**
+     * Stand-in steps shown while this turn is still working towards its first
+     * output. They yield as soon as the run emits real reasoning or content.
+     */
+    preparingSteps?: readonly string[] | null;
+    showTtft?: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     retry: (messageId: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onRetry?: ((messageId: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+}>, {
+    showTtft: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;