@meistrari/chat-nuxt 3.6.0 → 3.8.0

package/dist/runtime/citations/composables/citations.js

@@ -0,0 +1,44 @@
+import { citationCacheKey } from "../citation-links.js";
+export function useCitations() {
+  const nuxtApp = useNuxtApp();
+  const caches = nuxtApp._chatCitationEntries ??= /* @__PURE__ */ new WeakMap();
+  function entriesFor(config) {
+    let entries = caches.get(config);
+    if (!entries) {
+      entries = /* @__PURE__ */ new Map();
+      caches.set(config, entries);
+    }
+    return entries;
+  }
+  function resolveInto(entry, config, citation) {
+    entry.status.value = "loading";
+    config.resolve(citation).then((meta) => {
+      entry.meta.value = meta;
+      entry.status.value = meta ? "resolved" : "unresolved";
+    }).catch(() => {
+      entry.status.value = "unresolved";
+    });
+  }
+  function resolveCitation(config, citation) {
+    const entries = entriesFor(config);
+    const key = citationCacheKey(citation);
+    const existing = entries.get(key);
+    if (existing)
+      return existing;
+    const entry = {
+      status: ref("loading"),
+      meta: ref(null)
+    };
+    entries.set(key, entry);
+    resolveInto(entry, config, citation);
+    return entry;
+  }
+  function retryCitation(config, citation) {
+    const existing = entriesFor(config).get(citationCacheKey(citation));
+    if (!existing)
+      return resolveCitation(config, citation);
+    resolveInto(existing, config, citation);
+    return existing;
+  }
+  return { resolveCitation, retryCitation };
+}

package/dist/runtime/citations/document-highlight.d.ts

@@ -0,0 +1,13 @@
+import type { CitationOccurrence } from './types.js';
+export type HighlightSegment = {
+    text: string;
+    /** 1-based occurrence number when this segment is a highlighted match. */
+    occurrence?: number;
+};
+/**
+ * Fallback when the host provides no `locate` callback. Plain case-insensitive matching:
+ * accent variants won't match, which degrades to "term not found" rather than breaking.
+ */
+export declare function locateTermClientSide(content: string, term: string): CitationOccurrence[];
+/** Occurrence ranges are host data: invalid, out-of-bounds and overlapping ranges are dropped. */
+export declare function splitContentByOccurrences(content: string, occurrences: CitationOccurrence[]): HighlightSegment[];

package/dist/runtime/citations/document-highlight.js

@@ -0,0 +1,35 @@
+export function locateTermClientSide(content, term) {
+  const needle = term.toLowerCase();
+  if (!needle)
+    return [];
+  const haystack = content.toLowerCase();
+  const occurrences = [];
+  let cursor = 0;
+  while (true) {
+    const index = haystack.indexOf(needle, cursor);
+    if (index === -1)
+      break;
+    occurrences.push({ offset: index, end: index + needle.length });
+    cursor = index + needle.length;
+  }
+  return occurrences;
+}
+export function splitContentByOccurrences(content, occurrences) {
+  const ordered = [...occurrences].filter((occurrence) => Number.isInteger(occurrence.offset) && Number.isInteger(occurrence.end) && occurrence.offset >= 0 && occurrence.end > occurrence.offset && occurrence.offset < content.length).sort((a, b) => a.offset - b.offset);
+  const segments = [];
+  let lastEnd = 0;
+  let count = 0;
+  for (const occurrence of ordered) {
+    if (occurrence.offset < lastEnd)
+      continue;
+    const end = Math.min(occurrence.end, content.length);
+    if (occurrence.offset > lastEnd)
+      segments.push({ text: content.slice(lastEnd, occurrence.offset) });
+    count += 1;
+    segments.push({ text: content.slice(occurrence.offset, end), occurrence: count });
+    lastEnd = end;
+  }
+  if (lastEnd < content.length)
+    segments.push({ text: content.slice(lastEnd) });
+  return segments.length > 0 ? segments : [{ text: content }];
+}

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

@@ -0,0 +1,57 @@
+import type { Component } from 'vue';
+import type { CitationRef } from './citation-links.js';
+export type { CitationLocator, CitationRef } from './citation-links.js';
+export type CitationMeta = {
+    /** Human-readable document title. Hosts must never surface internal ids here. */
+    title: string;
+    /** Display name of the base/source the document belongs to. */
+    sourceLabel?: string;
+    /** Identifier of the document at its origin (case number, súmula number, ...). */
+    identifier?: string;
+    /** Link to the document at its original source, when one exists. */
+    url?: string;
+    /** ISO date associated with the document. */
+    date?: string;
+    /** What `date` refers to (julgamento, aprovação, publicação, ...). */
+    dateLabel?: string;
+    /** Short excerpt shown in the citation popover. */
+    snippet?: string;
+    /** Status badge, e.g. a súmula that is no longer in force. */
+    badge?: {
+        label: string;
+        tone?: 'neutral' | 'warning' | 'danger';
+    };
+};
+export type CitationDocument = {
+    /** Plain-text document content as stored by the host. */
+    content: string;
+    /** True when the host cut `content` short; the panel discloses it. */
+    truncated?: boolean;
+};
+export type CitationOccurrence = {
+    /** Inclusive char offset of the occurrence in the document content. */
+    offset: number;
+    /** Exclusive end offset of the occurrence. */
+    end: number;
+};
+/**
+ * Host-provided citation behavior. The lib owns detection, rendering and interaction
+ * states; the host owns data access (and with it, authorization: every callback runs
+ * against the host's own backend with the viewing user's identity).
+ *
+ * A `resolve` that returns `null` renders the citation as unverified — deliberately
+ * indistinguishable between "does not exist" and "not visible to this viewer".
+ */
+export type ChatCitationsConfig = {
+    /** Resolve a citation to display metadata; `null` marks it unverified. */
+    resolve: (ref: CitationRef) => Promise<CitationMeta | null>;
+    /** Fetch the document body; providing this enables the built-in document panel. */
+    getDocument?: (ref: CitationRef) => Promise<CitationDocument | null>;
+    /** Locate a term's occurrences for highlighting; absent = client-side best effort. */
+    locate?: (ref: CitationRef, term: string) => Promise<CitationOccurrence[] | null>;
+    /** Replaces the built-in citation chip. */
+    component?: Component;
+    /** Takes over the click entirely; the built-in panel is not opened. */
+    onOpen?: (ref: CitationRef, meta: CitationMeta | null) => void;
+};
+export type CitationStatus = 'loading' | 'resolved' | 'unresolved';

package/dist/runtime/conversations/components/chat-conversation-list.vue

@@ -84,7 +84,7 @@ const {
 
         <template v-else>
             <div
-                v-if="showGroupCreationPrompt"
+                v-if="showGroupCreationPrompt && !hideFolderHint"
                 mx-8px
                 flex="~ col" gap-10px
             >
@@ -113,7 +113,7 @@ const {
                         <span h-10px w-84px rounded-full bg-neutral-100 />
                     </div>
                 </div>
-                <p v-if="!hideFolderHint" px-4px text-14px text-neutral-500 leading-20px>
+                <p px-4px text-14px text-neutral-500 leading-20px>
                     Suas pastas aparecem aqui. Crie uma para começar a agrupar conversas.
                 </p>
                 <ChatConversationNewGroupButton label="Criar pasta" variant="empty-state" />

package/dist/runtime/conversations/composables/conversations.js

@@ -293,6 +293,7 @@ export function useConversations() {
   };
   const createConversation = async (input) => {
     error.value = null;
+    const statusToast = useStatusToast();
     const requestRuntimeScope = runtimeScope.value;
     const metadataSnapshot = snapshotConversationMetadata(requestRuntimeScope);
     const now = /* @__PURE__ */ new Date();
@@ -333,6 +334,10 @@ export function useConversations() {
       restoreConversationMetadata(requestRuntimeScope, metadataSnapshot);
       const message = err instanceof Error ? err.message : "Erro ao criar conversa";
       error.value = message;
+      statusToast.update({
+        text: "Erro ao criar conversa",
+        icon: "i-ph-warning"
+      });
       return null;
     }
   };

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

@@ -81,6 +81,7 @@ const effectiveWorkspaceSettings = computed(() => {
 });
 const { closePanel: closeFilesPanel } = useConversationFilesPanel();
 const { isOpen: isPreviewPanelOpen, panelWidth: previewPanelWidth, currentFile: currentPreviewFile, closePreview } = useFilePreviewPanel();
+const { isOpen: isCitationPanelOpen } = useCitationPanel();
 const activeConversationId = ref(
   normalizeConversationId(props.conversationId) ?? normalizeConversationId(props.initialConversationId)
 );
@@ -398,6 +399,32 @@ const editTitle = ref("");
 const justStartedEditing = ref(false);
 const showDebugModal = ref(false);
 const debugSessionId = computed(() => currentConversation.value?.threadSessionId ?? "Sess\xE3o ainda n\xE3o criada");
+async function copyDebugInfo() {
+  const conversation = currentConversation.value;
+  const conversationId = conversation?.id ?? activeConversationId.value;
+  const sessionId = conversation?.threadSessionId ?? null;
+  const telaAgentId = conversation?.telaAgentId ?? null;
+  const createdAt = conversation?.createdAt ? new Date(conversation.createdAt) : null;
+  const datadogTimeRange = createdAt ? `&from_ts=${createdAt.getTime()}&to_ts=${Date.now()}&live=false` : "";
+  const datadogLogsUrl = (facet, value) => `https://us5.datadoghq.com/logs?query=${encodeURIComponent(`@${facet}:${value}`)}${datadogTimeRange}`;
+  const environment = useRuntimeConfig().public.environment;
+  const telaAppUrl = environment === "production" ? "https://app.tela.com" : "https://app.telastaging.com";
+  const debugInfo = {
+    conversationId: conversationId ?? null,
+    sessionId,
+    telaAgentId,
+    createdAt: createdAt?.toISOString() ?? null,
+    seeConversationInDatadog: conversationId ? datadogLogsUrl("conversationId", conversationId) : null,
+    seeSessionInDatadog: sessionId ? datadogLogsUrl("sessionId", sessionId) : null,
+    linkToTelaAgent: telaAgentId ? `${telaAppUrl}/agent/${telaAgentId}` : null
+  };
+  try {
+    await navigator.clipboard.writeText(JSON.stringify(debugInfo, null, 2));
+    statusToast.update({ text: "Dados de debug copiados", icon: "i-ph-check" });
+  } catch {
+    statusToast.update({ text: "Erro ao copiar dados de debug", icon: "i-ph-warning" });
+  }
+}
 function startEditing() {
   editTitle.value = displayTitle.value;
   isEditing.value = true;
@@ -888,7 +915,7 @@ async function handleDelete() {
                 <div flex="~ col" w-full my-24px gap-24px>
                     <div flex="~ col" gap-4px w-full>
                         <p text-14px font-580 text-gray-700 leading-18px>
-                            Chat Id
+                            Conversation Id
                         </p>
                         <div
                             px-12px py-10px
@@ -906,7 +933,7 @@ async function handleDelete() {
                     </div>
                     <div flex="~ col" gap-4px w-full>
                         <p text-14px font-580 text-gray-700 leading-18px>
-                            Thread Session Id
+                            Session Id
                         </p>
                         <div
                             px-12px py-10px
@@ -923,6 +950,16 @@ async function handleDelete() {
                         </div>
                     </div>
                 </div>
+                <template #footer>
+                    <div flex justify-between items-center gap-12px w-full>
+                        <p text-12px font-400 leading-16px text-tertiary>
+                            Inclui os ids da conversa e os links de debug no Datadog e no Tela
+                        </p>
+                        <TelaButton variant="primary" icon="i-ph-copy" leading flex-shrink-0 @click="copyDebugInfo">
+                            Copiar dados completos
+                        </TelaButton>
+                    </div>
+                </template>
             </TelaModal>
         </div>
 
@@ -939,6 +976,20 @@ async function handleDelete() {
         >
             <FilePreviewPanel />
         </div>
+
+        <div
+            v-if="isCitationPanelOpen && !isMobile"
+            h-full flex-shrink-0 pt-64px
+            w-440px
+        >
+            <CitationDocumentPanel />
+        </div>
+        <div
+            v-else-if="isCitationPanelOpen && isMobile"
+            fixed inset-0 z-50 bg-neutral-50
+        >
+            <CitationDocumentPanel />
+        </div>
     </div>
 </template>
 

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

@@ -20,6 +20,7 @@ const props = defineProps({
   loadingMessagesMode: { type: [String, null], required: false },
   customComponents: { type: Object, required: false },
   customHtmlTags: { type: Array, required: false },
+  citations: { type: [Object, null], required: false },
   feedbackConfig: { type: [Object, null], required: false },
   messageFeedback: { type: [Object, null], required: false },
   telaAgentId: { type: null, required: false },
@@ -49,6 +50,7 @@ provideEmbedConfig({
   loadingMessagesMode: computed(() => props.loadingMessagesMode),
   customComponents: computed(() => props.customComponents),
   customHtmlTags: computed(() => props.customHtmlTags),
+  citations: computed(() => props.citations),
   feedbackConfig: computed(() => props.feedbackConfig),
   messageFeedback: computed(() => props.messageFeedback)
 }, { syncGlobal: !parentEmbedConfig });

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

@@ -13,6 +13,7 @@ const props = defineProps({
   loadingMessagesMode: { type: [String, null], required: false },
   customComponents: { type: Object, required: false },
   customHtmlTags: { type: Array, required: false },
+  citations: { type: [Object, null], required: false },
   feedbackConfig: { type: [Object, null], required: false },
   messageFeedback: { type: [Object, null], required: false },
   telaAgentId: { type: null, required: false },
@@ -44,6 +45,7 @@ const hideSettings = computed(() => props.hideSettings ?? false);
         :loading-messages-mode="loadingMessagesMode"
         :custom-components="customComponents"
         :custom-html-tags="customHtmlTags"
+        :citations="citations"
         :feedback-config="feedbackConfig"
         :message-feedback="messageFeedback"
         @update:conversation-id="$emit('update:conversationId', $event)"
@@ -72,6 +74,7 @@ const hideSettings = computed(() => props.hideSettings ?? false);
         :loading-messages-mode="loadingMessagesMode"
         :custom-components="customComponents"
         :custom-html-tags="customHtmlTags"
+        :citations="citations"
         :feedback-config="feedbackConfig"
         :message-feedback="messageFeedback"
         @update:conversation-id="$emit('update:conversationId', $event)"

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

@@ -310,7 +310,7 @@ async function handleConversationDrop(event, groupId) {
             </div>
             <div v-else flex="~ col" gap-8px>
                 <div
-                    v-if="showGroupCreationPrompt"
+                    v-if="showGroupCreationPrompt && !hideFolderHint"
                     mx-4px
                     flex="~ col" gap-10px
                 >
@@ -339,7 +339,7 @@ async function handleConversationDrop(event, groupId) {
                             <span h-10px w-84px rounded-full bg-neutral-100 />
                         </div>
                     </div>
-                    <p v-if="!hideFolderHint" px-4px text-14px text-neutral-500 leading-20px>
+                    <p px-4px text-14px text-neutral-500 leading-20px>
                         Suas pastas aparecem aqui. Crie uma para começar a agrupar conversas.
                     </p>
                     <ChatConversationNewGroupButton label="Criar pasta" variant="empty-state" />

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

@@ -3,6 +3,7 @@ import type { ConversationCreatorFilter } from '../../types/schemas/chat/primiti
 import type { WorkspaceSettingsResponse as WorkspaceSettings } from '../../types/schemas/chat/workspace-settings.js';
 import type { TelaAgentExecutionInput } from '../../types/schemas/integrations/tela-agent-api.js';
 import type { ChatLoadingMessageMode } from '../loading-messages.js';
+import type { ChatCitationsConfig } from '../../citations/types.js';
 import type { MessageFeedbackConfig, MessageFeedbackRating } from '../../messages/composables/chat-feedback.js';
 type ConfiguredTelaAgentInputs = DeepReadonly<TelaAgentExecutionInput[]> | null | undefined;
 type ConfiguredMessageFeedback = Readonly<Record<string, MessageFeedbackRating>> | null | undefined;
@@ -19,6 +20,7 @@ export type EmbedConfig = {
     loadingMessagesMode: Ref<ChatLoadingMessageMode | null | undefined>;
     customComponents: Ref<Record<string, Component> | undefined>;
     customHtmlTags: Ref<readonly string[] | undefined>;
+    citations: Ref<ChatCitationsConfig | null | undefined>;
     feedbackConfig: Ref<MessageFeedbackConfig | null | undefined>;
     messageFeedback: Ref<ConfiguredMessageFeedback>;
 };
@@ -35,6 +37,7 @@ type EmbedConfigInput = {
     loadingMessagesMode?: MaybeRefOrGetter<ChatLoadingMessageMode | null | undefined>;
     customComponents?: MaybeRefOrGetter<Record<string, Component> | undefined>;
     customHtmlTags?: MaybeRefOrGetter<readonly string[] | undefined>;
+    citations?: MaybeRefOrGetter<ChatCitationsConfig | null | undefined>;
     feedbackConfig?: MaybeRefOrGetter<MessageFeedbackConfig | null | undefined>;
     messageFeedback?: MaybeRefOrGetter<ConfiguredMessageFeedback>;
 };

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

@@ -5,6 +5,11 @@ function useGlobalCustomComponentsState() {
   nuxtApp._chatEmbedConfigCustomComponents ??= shallowRef(void 0);
   return nuxtApp._chatEmbedConfigCustomComponents;
 }
+function useGlobalCitationsState() {
+  const nuxtApp = useNuxtApp();
+  nuxtApp._chatEmbedConfigCitations ??= shallowRef(void 0);
+  return nuxtApp._chatEmbedConfigCitations;
+}
 function useGlobalEmbedConfigState() {
   return {
     provided: useState("chat-embed-config-provided", () => false),
@@ -20,6 +25,7 @@ function useGlobalEmbedConfigState() {
     loadingMessagesMode: useState("chat-embed-config-loading-messages-mode", () => void 0),
     customComponents: useGlobalCustomComponentsState(),
     customHtmlTags: useState("chat-embed-config-custom-html-tags", () => void 0),
+    citations: useGlobalCitationsState(),
     feedbackConfig: useState("chat-embed-config-feedback-config", () => void 0),
     messageFeedback: useState("chat-embed-config-message-feedback", () => void 0)
   };
@@ -38,6 +44,7 @@ export function provideEmbedConfig(input, options = {}) {
     loadingMessagesMode: computed(() => toValue(input.loadingMessagesMode)),
     customComponents: computed(() => toValue(input.customComponents)),
     customHtmlTags: computed(() => toValue(input.customHtmlTags)),
+    citations: computed(() => toValue(input.citations)),
     feedbackConfig: computed(() => toValue(input.feedbackConfig)),
     messageFeedback: computed(() => toValue(input.messageFeedback))
   };
@@ -57,6 +64,7 @@ export function provideEmbedConfig(input, options = {}) {
       globalConfig.loadingMessagesMode.value = config.loadingMessagesMode.value;
       globalConfig.customComponents.value = config.customComponents.value;
       globalConfig.customHtmlTags.value = config.customHtmlTags.value;
+      globalConfig.citations.value = config.citations.value;
       globalConfig.feedbackConfig.value = config.feedbackConfig.value;
       globalConfig.messageFeedback.value = config.messageFeedback.value;
     });
@@ -83,6 +91,7 @@ export function useEmbedConfig() {
     loadingMessagesMode: computed(() => globalConfig.loadingMessagesMode.value),
     customComponents: computed(() => globalConfig.customComponents.value),
     customHtmlTags: computed(() => globalConfig.customHtmlTags.value),
+    citations: computed(() => globalConfig.citations.value),
     feedbackConfig: computed(() => globalConfig.feedbackConfig.value),
     messageFeedback: computed(() => globalConfig.messageFeedback.value)
   };

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

@@ -4,6 +4,7 @@ import type { TelaAgentExecutionInput } from '../types/schemas/integrations/tela
 import type { ConversationCreatorFilter } from '../types/schemas/chat/primitives.js';
 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 ChatActor = {
     name?: string | null;
@@ -44,7 +45,11 @@ export type ChatEmbedSharedProps = {
     sidebar?: ChatSidebarConfig;
     /** Hide workspace settings actions while keeping the chat header and content unchanged. */
     hideSettings?: boolean;
-    /** Hide the folder onboarding hint while keeping folder creation actions available. */
+    /**
+     * 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.
+     */
     hideFolderHint?: boolean;
     /** Custom pending-response messages shown while the assistant is working. */
     loadingMessages?: readonly string[] | null;
@@ -54,6 +59,12 @@ export type ChatEmbedSharedProps = {
     customComponents?: Record<string, Component>;
     /** Extra HTML tags allowed by the markdown renderer. */
     customHtmlTags?: readonly string[];
+    /**
+     * Enables `cite://` citations in assistant messages. The host resolves each
+     * citation against its own backend (carrying the viewing user's authorization);
+     * the lib renders chips, the metadata popover and the document panel.
+     */
+    citations?: ChatCitationsConfig | null;
     /**
      * Enables 👍/👎 feedback on assistant messages and configures the reason
      * popovers. Providing the prop (even `{}`) shows the controls; votes reach

package/dist/runtime/files/components/chat-vault-link.vue

@@ -1,11 +1,19 @@
 <script setup>
+import { parseCitationUrl } from "../../citations/citation-links";
+import { useEmbedConfig } from "../../embed/composables/embed-config";
 import { detectFileFromUrl } from "../content-detection";
 const props = defineProps({
   node: { type: Object, required: true },
   indexKey: { type: [Number, String], required: true },
   customId: { type: String, required: false }
 });
+const embedConfig = useEmbedConfig();
 const detectedFile = computed(() => detectFileFromUrl(props.node.href));
+const detectedCitation = computed(() => {
+  if (!embedConfig?.citations.value)
+    return null;
+  return parseCitationUrl(props.node.href);
+});
 const linkText = computed(() => {
   if (props.node.children?.length > 0) {
     return props.node.children.map((c) => c.raw).join("");
@@ -23,6 +31,11 @@ const linkText = computed(() => {
         w-full
         my-4px
     />
+    <ChatCitation
+        v-else-if="detectedCitation"
+        :citation="detectedCitation"
+        :label="linkText"
+    />
     <a
         v-else
         :href="node.href"

package/dist/runtime/files/content-detection.d.ts

@@ -1,3 +1,4 @@
+import { type CitationRef } from '../citations/citation-links.js';
 import { type VaultHashParams } from './vault-links.js';
 export type DetectedFile = {
     type: 'vault' | 'url';
@@ -12,7 +13,14 @@ export type ContentSegment = {
 } | {
     type: 'file';
     file: DetectedFile;
+} | {
+    type: 'citation';
+    citation: CitationRef;
+};
+export type ParseContentOptions = {
+    /** Detect bare `cite://` tokens as citation segments. Off by default: only hosts that configured citations opt in. */
+    detectCitations?: boolean;
 };
 export declare function detectFilesInText(text: string): DetectedFile[];
-export declare function parseContentWithFiles(text: string): ContentSegment[];
+export declare function parseContentWithFiles(text: string, options?: ParseContentOptions): ContentSegment[];
 export declare function detectFileFromUrl(url: string): DetectedFile | null;

package/dist/runtime/files/content-detection.js

@@ -1,3 +1,4 @@
+import { CITE_REGEX, parseCitationUrl } from "../citations/citation-links.js";
 import { getExtensionFromUrl, getMimeTypeFromExtension, isFileUrl } from "./mime.js";
 import {
   getPermalinkId,
@@ -128,7 +129,7 @@ export function detectFilesInText(text) {
   }
   return files;
 }
-export function parseContentWithFiles(text) {
+export function parseContentWithFiles(text, options) {
   const segments = [];
   const fileMatches = collectMarkdownFileLinkMatches(text);
   for (const match of text.matchAll(VAULT_REGEX)) {
@@ -198,18 +199,38 @@ export function parseContentWithFiles(text) {
       });
     }
   }
-  if (fileMatches.length === 0)
+  const matches = fileMatches.map((fm) => ({
+    start: fm.start,
+    end: fm.end,
+    segment: { type: "file", file: fm.file }
+  }));
+  if (options?.detectCitations) {
+    for (const match of text.matchAll(CITE_REGEX)) {
+      const url = stripTrailingPunctuation(match[0]);
+      if (overlapsFileMatch(match.index, match.index + url.length, fileMatches))
+        continue;
+      const citation = parseCitationUrl(url);
+      if (!citation)
+        continue;
+      matches.push({
+        start: match.index,
+        end: match.index + url.length,
+        segment: { type: "citation", citation }
+      });
+    }
+  }
+  if (matches.length === 0)
     return [{ type: "text", content: text }];
-  fileMatches.sort((a, b) => a.start - b.start);
+  matches.sort((a, b) => a.start - b.start);
   let lastEnd = 0;
-  for (const fm of fileMatches) {
-    if (fm.start > lastEnd) {
-      const textContent = text.slice(lastEnd, fm.start);
+  for (const m of matches) {
+    if (m.start > lastEnd) {
+      const textContent = text.slice(lastEnd, m.start);
       if (textContent)
         segments.push({ type: "text", content: textContent });
     }
-    segments.push({ type: "file", file: fm.file });
-    lastEnd = fm.end;
+    segments.push(m.segment);
+    lastEnd = m.end;
   }
   if (lastEnd < text.length) {
     const textContent = text.slice(lastEnd);

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

@@ -98,9 +98,9 @@ const contentSegments = computed(() => {
   const content = displayContent.value;
   if (!content)
     return [];
-  return parseContentWithFiles(content);
+  return parseContentWithFiles(content, { detectCitations: Boolean(embedConfig?.citations.value) });
 });
-const hasDetectedFiles = computed(() => contentSegments.value.some((s) => s.type === "file"));
+const hasDetectedFiles = computed(() => contentSegments.value.some((s) => s.type !== "text"));
 </script>
 
 <template>
@@ -258,13 +258,17 @@ const hasDetectedFiles = computed(() => contentSegments.value.some((s) => s.type
                                 />
                             </ClientOnly>
                             <ChatFilePreview
-                                v-else
+                                v-else-if="segment.type === 'file'"
                                 :file="segment.file"
                                 inline-block
                                 align-middle
                                 w-full
                                 my-4px
                             />
+                            <ChatCitation
+                                v-else
+                                :citation="segment.citation"
+                            />
                         </template>
                     </div>
                     <ClientOnly v-else>

package/dist/runtime/server/utils/chat-api-proxy.js

@@ -58,8 +58,17 @@ function buildProxyHeaders(event) {
     });
   }
   const headers = {
-    authorization: `Bearer ${token}`
+    "authorization": `Bearer ${token}`,
+    "x-chat-client": "chat-nuxt"
   };
+  const config = useRuntimeConfig(event);
+  if (config.chatNuxt?.clientVersion) {
+    headers["x-chat-client-version"] = config.chatNuxt.clientVersion;
+  }
+  const source = config.chatNuxt?.source || getRequestURL(event).host;
+  if (source) {
+    headers["x-chat-source"] = source;
+  }
   for (const headerName of CHAT_COMPAT_HEADERS) {
     const value = getHeader(event, headerName)?.trim();
     if (value) {

package/dist/runtime/shared/composables/feature-flags.d.ts

@@ -8,7 +8,14 @@ type Workspace = {
     id: string;
     name?: string | null;
 };
-export declare function initPosthog(publicKey: string, host: string, defaults: string): Promise<void>;
+export type PosthogLogsOptions = {
+    captureConsoleLogs?: boolean;
+    /** Shown as `service.name` in the PostHog Logs UI. Defaults to `unknown_service`. */
+    serviceName?: string;
+    /** Shown as `deployment.environment` in the PostHog Logs UI. */
+    environment?: string;
+};
+export declare function initPosthog(publicKey: string, host: string, defaults: string, logs?: PosthogLogsOptions): Promise<void>;
 export declare function identifyPosthogUser(user: AuthUser): void;
 export declare function resetPosthogIdentity(): void;
 export declare function setPosthogWorkspace(workspace: Workspace): void;

package/dist/runtime/shared/composables/feature-flags.js

@@ -1,7 +1,7 @@
 const posthogClient = shallowRef(null);
 const flagsVersion = ref(0);
 let identifiedUserFingerprint = null;
-export async function initPosthog(publicKey, host, defaults) {
+export async function initPosthog(publicKey, host, defaults, logs) {
   if (posthogClient.value)
     return;
   try {
@@ -10,6 +10,15 @@ export async function initPosthog(publicKey, host, defaults) {
       api_host: host,
       defaults,
       person_profiles: "identified_only",
+      // serviceName/environment are supported at runtime but missing
+      // from PostHogConfig['logs'] in the pinned posthog-js version.
+      ...logs?.captureConsoleLogs ? {
+        logs: {
+          captureConsoleLogs: true,
+          serviceName: logs.serviceName,
+          environment: logs.environment
+        }
+      } : {},
       loaded: (c) => {
         if (import.meta.dev)
           c.debug();