@meistrari/chat-nuxt 3.7.0 → 3.9.0

package/dist/runtime/citations/components/citation-highlight.vue.d.ts

@@ -0,0 +1,19 @@
+import type { CustomMarkdownNode } from '../../rendering/markdown/custom-components.js';
+type __VLS_Props = {
+    node: CustomMarkdownNode;
+    occurrence: string;
+    target?: boolean | string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/citations/composables/citation-panel.d.ts

@@ -0,0 +1,8 @@
+import type { CitationRef } from '../citation-links.js';
+import type { CitationMeta } from '../types.js';
+export declare function useCitationPanel(): {
+    isOpen: any;
+    active: any;
+    openCitationDocument: (citation: CitationRef, meta: CitationMeta | null) => void;
+    closeCitationDocument: () => void;
+};

package/dist/runtime/citations/composables/citation-panel.js

@@ -0,0 +1,17 @@
+const isOpen = ref(false);
+const active = ref(null);
+export function useCitationPanel() {
+  function openCitationDocument(citation, meta) {
+    active.value = { citation, meta };
+    isOpen.value = true;
+  }
+  function closeCitationDocument() {
+    isOpen.value = false;
+  }
+  return {
+    isOpen: readonly(isOpen),
+    active: readonly(active),
+    openCitationDocument,
+    closeCitationDocument
+  };
+}

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

@@ -0,0 +1,17 @@
+import type { Ref } from 'vue';
+import { type CitationRef } from '../citation-links.js';
+import type { ChatCitationsConfig, CitationMeta, CitationStatus } from '../types.js';
+export type CitationEntry = {
+    status: Ref<CitationStatus>;
+    meta: Ref<CitationMeta | null>;
+};
+/**
+ * Resolution cache shared by every chip in the session: one `resolve` call per document,
+ * no matter how many times (or with which locators) it is cited. Keyed by config identity
+ * so embeds with different resolvers (different backends/authorization scopes) never
+ * reuse each other's results.
+ */
+export declare function useCitations(): {
+    resolveCitation: (config: ChatCitationsConfig, citation: CitationRef) => CitationEntry;
+    retryCitation: (config: ChatCitationsConfig, citation: CitationRef) => CitationEntry;
+};

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,14 @@
+import type { CitationOccurrence } from './types.js';
+export type HighlightSegment = {
+    text: string;
+    /** 1-based occurrence number when this segment is a highlighted match. */
+    occurrence?: number;
+};
+export declare function escapeCitationMarkup(text: string, tagName: string, context: 'document' | 'highlight'): string;
+/**
+ * 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,43 @@
+export function escapeCitationMarkup(text, tagName, context) {
+  if (context === "highlight") {
+    return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+  }
+  const escapedTagName = tagName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const citationTag = new RegExp(`<\\/?${escapedTagName}(?=[\\s>])`, "gi");
+  return text.replace(citationTag, (match) => `&lt;${match.slice(1)}`);
+}
+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/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)
 );
@@ -975,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/configuration/chat-configuration-knowledge-sources-tab.d.vue.ts

@@ -8,11 +8,11 @@ type __VLS_Props = {
     getProjectNameForWorkstation: (w: TelaWorkstation) => string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:searchQuery": (value: string) => any;
     toggle: (sourceId: string) => any;
+    "update:searchQuery": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:searchQuery"?: ((value: string) => any) | undefined;
     onToggle?: ((sourceId: string) => any) | undefined;
+    "onUpdate:searchQuery"?: ((value: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/embed/components/configuration/chat-configuration-knowledge-sources-tab.vue.d.ts

@@ -8,11 +8,11 @@ type __VLS_Props = {
     getProjectNameForWorkstation: (w: TelaWorkstation) => string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:searchQuery": (value: string) => any;
     toggle: (sourceId: string) => any;
+    "update:searchQuery": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:searchQuery"?: ((value: string) => any) | undefined;
     onToggle?: ((sourceId: string) => any) | undefined;
+    "onUpdate:searchQuery"?: ((value: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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/components/mobile/chat-mobile-shell.d.vue.ts

@@ -57,12 +57,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:selectedModel": (value: string | null) => any;
 } & {
     delete: () => any;
+    cancel: () => any;
     rename: () => any;
     duplicate: () => any;
     export: () => any;
     copyLink: () => any;
     selectConversation: (id: string) => any;
-    cancel: () => any;
     settings: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
     debug: () => any;
@@ -78,12 +78,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:workspaceSheetOpen": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onDelete?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
     onRename?: (() => any) | undefined;
     onDuplicate?: (() => any) | undefined;
     onExport?: (() => any) | undefined;
     onCopyLink?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
-    onCancel?: (() => any) | undefined;
     onSettings?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;

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

@@ -57,12 +57,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:selectedModel": (value: string | null) => any;
 } & {
     delete: () => any;
+    cancel: () => any;
     rename: () => any;
     duplicate: () => any;
     export: () => any;
     copyLink: () => any;
     selectConversation: (id: string) => any;
-    cancel: () => any;
     settings: () => any;
     send: (content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any;
     debug: () => any;
@@ -78,12 +78,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     "update:workspaceSheetOpen": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onDelete?: (() => any) | undefined;
+    onCancel?: (() => any) | undefined;
     onRename?: (() => any) | undefined;
     onDuplicate?: (() => any) | undefined;
     onExport?: (() => any) | undefined;
     onCopyLink?: (() => any) | undefined;
     onSelectConversation?: ((id: string) => any) | undefined;
-    onCancel?: (() => any) | undefined;
     onSettings?: (() => any) | undefined;
     onSend?: ((content: string, files: FileUploadInput[], agentInputs?: TelaAgentExecutionInput[] | undefined) => any) | undefined;
     "onUpdate:selectedModel"?: ((value: string | null) => any) | undefined;

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);