@meistrari/chat-nuxt 3.9.2 → 3.10.0

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

@@ -1,6 +1,6 @@
 <script setup>
-import { computed } from "vue";
-const props = defineProps({
+import { computed, ref, watch } from "vue";
+const { hideSidebar = void 0, ...props } = defineProps({
   conversationId: { type: [String, null], required: false },
   initialConversationId: { type: [String, null], required: false },
   conversationScope: { type: [String, null], required: false },
@@ -8,7 +8,8 @@ const props = defineProps({
   hideSidebar: { type: Boolean, required: false },
   sidebar: { type: Object, required: false },
   hideSettings: { type: Boolean, required: false },
-  hideFolderHint: { type: Boolean, required: false },
+  compact: { type: Boolean, required: false },
+  suggestions: { type: [Array, null], required: false },
   loadingMessages: { type: [Array, null], required: false },
   loadingMessagesMode: { type: [String, null], required: false },
   customComponents: { type: Object, required: false },
@@ -20,70 +21,130 @@ const props = defineProps({
   telaAgentInputs: { type: null, required: false },
   workspaceSettings: { type: null, required: false },
   user: { type: null, required: false },
-  features: { type: Object, required: false }
+  features: { type: Object, required: false },
+  variant: { type: String, required: false },
+  defaultOpen: { type: Boolean, required: false },
+  launcherLabel: { type: String, required: false }
 });
-defineEmits(["update:conversationId", "action", "messageFeedback", "messageTerminal"]);
+const emit = defineEmits(["update:conversationId", "update:open", "action", "messageFeedback", "messageTerminal"]);
 defineSlots();
 const hideSettings = computed(() => props.hideSettings ?? false);
+const variant = computed(() => props.variant ?? "page");
+const isOpen = ref(props.defaultOpen ?? false);
+function setOpen(open) {
+  isOpen.value = open;
+  emit("update:open", open);
+}
+const widgetConversationId = ref(props.conversationId ?? props.initialConversationId ?? null);
+const widgetConversationTitle = ref(null);
+watch(() => props.conversationId, (value) => {
+  if (value !== void 0)
+    widgetConversationId.value = value;
+});
+function handleWidgetConversationIdChange(value) {
+  widgetConversationId.value = value;
+  if (!value)
+    widgetConversationTitle.value = null;
+  emit("update:conversationId", value);
+}
+function startWidgetConversation() {
+  handleWidgetConversationIdChange(null);
+}
+const sharedEmbedProps = computed(() => ({
+  conversationId: props.conversationId,
+  initialConversationId: props.initialConversationId,
+  conversationScope: props.conversationScope,
+  defaultConversationCreatorFilter: props.defaultConversationCreatorFilter,
+  hideSettings: hideSettings.value,
+  suggestions: props.suggestions,
+  features: props.features,
+  loadingMessages: props.loadingMessages,
+  loadingMessagesMode: props.loadingMessagesMode,
+  customComponents: props.customComponents,
+  customHtmlTags: props.customHtmlTags,
+  citations: props.citations,
+  feedbackConfig: props.feedbackConfig,
+  messageFeedback: props.messageFeedback,
+  ...props.telaAgentId ? { telaAgentId: props.telaAgentId, telaAgentInputs: props.telaAgentInputs } : { workspaceSettings: props.workspaceSettings, user: props.user }
+}));
+const pageEmbedProps = computed(() => ({
+  ...sharedEmbedProps.value,
+  hideSidebar,
+  sidebar: props.sidebar
+}));
+const widgetEmbedProps = computed(() => ({
+  ...sharedEmbedProps.value,
+  conversationId: widgetConversationId.value,
+  hideSidebar: hideSidebar ?? true
+}));
 </script>
 
 <template>
     <ChatEmbed
-        v-if="telaAgentId"
-        :tela-agent-id="telaAgentId"
-        :tela-agent-inputs="telaAgentInputs"
-        :conversation-id="conversationId"
-        :initial-conversation-id="initialConversationId"
-        :conversation-scope="conversationScope"
-        :default-conversation-creator-filter="defaultConversationCreatorFilter"
-        :hide-sidebar="hideSidebar"
-        :sidebar="sidebar"
-        :hide-settings="hideSettings"
-        :hide-folder-hint="hideFolderHint"
-        :features="features"
-        :loading-messages="loadingMessages"
-        :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)"
-        @action="$emit('action', $event)"
-        @message-feedback="$emit('messageFeedback', $event)"
-        @message-terminal="$emit('messageTerminal', $event)"
-    >
-        <template v-if="$slots['sidebar-bottom']" #sidebar-bottom>
-            <slot name="sidebar-bottom" />
-        </template>
-    </ChatEmbed>
-    <ChatEmbed
-        v-else
-        :workspace-settings="workspaceSettings"
-        :user="user"
-        :conversation-id="conversationId"
-        :initial-conversation-id="initialConversationId"
-        :conversation-scope="conversationScope"
-        :default-conversation-creator-filter="defaultConversationCreatorFilter"
-        :hide-sidebar="hideSidebar"
-        :sidebar="sidebar"
-        :hide-settings="hideSettings"
-        :hide-folder-hint="hideFolderHint"
-        :features="features"
-        :loading-messages="loadingMessages"
-        :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)"
-        @action="$emit('action', $event)"
-        @message-feedback="$emit('messageFeedback', $event)"
-        @message-terminal="$emit('messageTerminal', $event)"
+        v-if="variant === 'page'"
+        v-bind="pageEmbedProps"
+        @update:conversation-id="emit('update:conversationId', $event)"
+        @action="emit('action', $event)"
+        @message-feedback="emit('messageFeedback', $event)"
+        @message-terminal="emit('messageTerminal', $event)"
     >
         <template v-if="$slots['sidebar-bottom']" #sidebar-bottom>
             <slot name="sidebar-bottom" />
         </template>
     </ChatEmbed>
+
+    <ClientOnly v-else>
+        <!-- Floating: popover anchored to the launcher pill -->
+        <TelaChatFloatingWindow v-if="variant === 'floating'" :open="isOpen" @update:open="setOpen">
+            <template #launcher>
+                <TelaChatFloatingWindowTrigger :open="isOpen" :label="props.launcherLabel" />
+            </template>
+
+            <TelaChatWidgetHeader
+                :title="widgetConversationTitle ?? void 0"
+                @new-conversation="startWidgetConversation"
+                @select-conversation="handleWidgetConversationIdChange"
+                @close="setOpen(false)"
+            >
+                <template #history>
+                    <ChatWidgetHistoryList />
+                </template>
+            </TelaChatWidgetHeader>
+            <div flex-1 min-h-0>
+                <ChatEmbed
+                    v-bind="widgetEmbedProps"
+                    compact
+                    @update:conversation-id="handleWidgetConversationIdChange"
+                    @update:conversation-title="widgetConversationTitle = $event"
+                    @action="emit('action', $event)"
+                    @message-feedback="emit('messageFeedback', $event)"
+                    @message-terminal="emit('messageTerminal', $event)"
+                />
+            </div>
+        </TelaChatFloatingWindow>
+
+        <!-- Sidepanel: always-open docked panel, no launcher -->
+        <TelaChatSidepanelWindow v-else>
+            <TelaChatWidgetHeader
+                :title="widgetConversationTitle ?? void 0"
+                @new-conversation="startWidgetConversation"
+                @select-conversation="handleWidgetConversationIdChange"
+            >
+                <template #history>
+                    <ChatWidgetHistoryList />
+                </template>
+            </TelaChatWidgetHeader>
+            <div flex-1 min-h-0>
+                <ChatEmbed
+                    v-bind="widgetEmbedProps"
+                    compact
+                    @update:conversation-id="handleWidgetConversationIdChange"
+                    @update:conversation-title="widgetConversationTitle = $event"
+                    @action="emit('action', $event)"
+                    @message-feedback="emit('messageFeedback', $event)"
+                    @message-terminal="emit('messageTerminal', $event)"
+                />
+            </div>
+        </TelaChatSidepanelWindow>
+    </ClientOnly>
 </template>

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

@@ -3,11 +3,13 @@ import type { ChatActionPayload } from '../../messages/composables/chat-action.j
 import type { MessageFeedbackPayload } from '../../messages/composables/chat-feedback.js';
 import type { ChatMessageTerminalPayload } from '../../messages/composables/chat-message-terminal.js';
 import type { ChatFeatureConfig } from '../feature-config.js';
-import type { ChatSidebarConfig, DefaultChatEmbedProps, MeistrariChatEmbedProps, TelaAgentChatEmbedProps } from '../types.js';
+import type { ChatEmbedVariant, ChatEmbedVariantProps, ChatSidebarConfig, ChatSuggestion, DefaultChatEmbedProps, MeistrariChatEmbedProps, TelaAgentChatEmbedProps } from '../types.js';
 
 type MeistrariChatEmbedEmits = {
     /** Fired when the active conversation changes. Pairs with `v-model:conversation-id`. */
     'update:conversationId': (value: string | null) => any;
+    /** Fired when the floating widget window opens or closes. Widget variants only. */
+    'update:open': (value: boolean) => any;
     /** Fired when an assistant message triggers a host-handled action. */
     'action': (payload: ChatActionPayload) => any;
     /** Fired when a user submits feedback for an assistant message. */
@@ -17,7 +19,7 @@ type MeistrariChatEmbedEmits = {
 };
 
 type MeistrariChatEmbedSlots = SlotsType<{
-    /** Rendered in a dedicated bottom pane of the conversation sidebar, splitting it in half. */
+    /** Rendered in a dedicated bottom pane of the conversation sidebar, splitting it in half. Page variant only. */
     'sidebar-bottom'?: () => any;
 }>;
 
@@ -50,4 +52,4 @@ type MeistrariChatEmbedSlots = SlotsType<{
 declare const MeistrariChatEmbed: DefineSetupFnComponent<MeistrariChatEmbedProps, MeistrariChatEmbedEmits, MeistrariChatEmbedSlots>;
 
 export default MeistrariChatEmbed;
-export type { ChatActionPayload, ChatFeatureConfig, ChatMessageTerminalPayload, ChatSidebarConfig, DefaultChatEmbedProps, MeistrariChatEmbedProps, MessageFeedbackPayload, TelaAgentChatEmbedProps };
+export type { ChatActionPayload, ChatEmbedVariant, ChatEmbedVariantProps, ChatFeatureConfig, ChatMessageTerminalPayload, ChatSidebarConfig, ChatSuggestion, DefaultChatEmbedProps, MeistrariChatEmbedProps, MessageFeedbackPayload, TelaAgentChatEmbedProps };

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

@@ -5,7 +5,6 @@ type __VLS_Props = {
     conversations: DeepReadonly<Conversation[]>;
     activeId: string | null;
     loading?: boolean;
-    hideFolderHint?: boolean;
     userName?: string;
     userEmail?: string;
     userImage?: string;

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

@@ -13,7 +13,6 @@ const props = defineProps({
   conversations: { type: null, required: true },
   activeId: { type: [String, null], required: true },
   loading: { type: Boolean, required: false },
-  hideFolderHint: { type: Boolean, required: false },
   userName: { type: String, required: false },
   userEmail: { type: String, required: false },
   userImage: { type: String, required: false }
@@ -28,7 +27,6 @@ const conversationSearch = ref("");
 const draggedConversationId = ref(null);
 const dropTargetGroupId = ref(void 0);
 const openGroupIds = ref(/* @__PURE__ */ new Set());
-const groupsReady = ref(false);
 let dragOpenGroupTimeout = null;
 let dragOpenGroupId = null;
 const embedConfig = useEmbedConfig();
@@ -81,13 +79,10 @@ const visibleGroupBuckets = computed(() => groupedConversations.value.groups.fil
     showSearchEmpty: hasConversationSearchQuery.value && groupBucket.items.length === 0
   };
 }));
-const showGroupCreationPrompt = computed(
-  () => groupsReady.value && !hasConversationSearchQuery.value && groups.value.length === 0
-);
 const hasConversationContent = computed(() => {
   if (hasConversationSearchQuery.value)
     return visibleGroupBuckets.value.length > 0 || groupedConversations.value.unfiled.length > 0;
-  return showGroupCreationPrompt.value || groups.value.length > 0 || filteredConversations.value.length > 0;
+  return groups.value.length > 0 || filteredConversations.value.length > 0;
 });
 const shouldShowUngroupedHeader = computed(() => visibleGroupBuckets.value.length > 0);
 const ungroupedConversationLabel = computed(() => `Conversas \xB7 ${groupedConversations.value.unfiled.length}`);
@@ -96,9 +91,7 @@ const activeGroupId = computed(() => {
   return currentConversation?.groupId ?? null;
 });
 onMounted(() => {
-  void Promise.resolve(fetchGroups()).finally(() => {
-    groupsReady.value = true;
-  });
+  void fetchGroups();
   try {
     const stored = localStorage.getItem(openGroupsStorageKey.value);
     if (stored) {
@@ -309,42 +302,6 @@ async function handleConversationDrop(event, groupId) {
                 </p>
             </div>
             <div v-else flex="~ col" gap-8px>
-                <div
-                    v-if="showGroupCreationPrompt && !hideFolderHint"
-                    mx-4px
-                    flex="~ col" gap-10px
-                >
-                    <div h-20px flex items-center px-4px>
-                        <span text-12px font-semibold text-neutral-400 uppercase style="letter-spacing: 0">
-                            PASTAS
-                        </span>
-                    </div>
-                    <div flex="~ col" gap-6px>
-                        <div
-                            h-36px px-10px
-                            flex items-center gap-10px
-                            rounded-10px
-                            b=".5px dashed neutral-200"
-                        >
-                            <span i-ph-folder text-16px text-neutral-400 shrink-0 />
-                            <span h-10px w-120px rounded-full bg-neutral-100 />
-                        </div>
-                        <div
-                            h-36px px-10px
-                            flex items-center gap-10px
-                            rounded-10px
-                            b=".5px dashed neutral-200"
-                        >
-                            <span i-ph-folder text-16px text-neutral-400 shrink-0 />
-                            <span h-10px w-84px rounded-full bg-neutral-100 />
-                        </div>
-                    </div>
-                    <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" />
-                </div>
-
                 <div v-if="visibleGroupBuckets.length > 0" flex="~ col" gap-2px>
                     <div
                         v-for="groupBucket in visibleGroupBuckets"

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

@@ -5,7 +5,6 @@ type __VLS_Props = {
     conversations: DeepReadonly<Conversation[]>;
     activeId: string | null;
     loading?: boolean;
-    hideFolderHint?: boolean;
     userName?: string;
     userEmail?: string;
     userImage?: string;

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

@@ -1,7 +1,11 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    pick: (label: string) => any;
-}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{
-    onPick?: ((label: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+import type { ChatSuggestion } from '../../types.js';
+type __VLS_Props = {
+    suggestions?: readonly ChatSuggestion[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    pick: (prompt: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPick?: ((prompt: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/embed/components/mobile/chat-mobile-home-suggestions.vue

@@ -1,31 +1,20 @@
 <script setup>
+const props = defineProps({
+  suggestions: { type: Array, required: false }
+});
 const emit = defineEmits(["pick"]);
-const suggestions = [
-  { id: "s1", icon: "i-ph-file-text", label: "Resumir um documento longo" },
-  { id: "s2", icon: "i-ph-envelope", label: "Escrever um e-mail formal" },
-  { id: "s3", icon: "i-ph-lightbulb", label: "Brainstorm de campanha de marketing" }
-];
+const visibleSuggestions = computed(() => props.suggestions ?? []);
 </script>
 
 <template>
-    <div flex="~ col">
-        <span class="eyebrow">Sugestões</span>
-
-        <div class="chip-row">
-            <button
-                v-for="s in suggestions"
-                :key="s.id"
-                type="button"
-                class="chip"
-                @click="emit('pick', s.label)"
-            >
-                <span :class="s.icon" class="chip__icon" />
-                <span>{{ s.label }}</span>
-            </button>
-        </div>
-    </div>
+    <TelaChatSuggestions v-if="visibleSuggestions.length">
+        <TelaChatSuggestion
+            v-for="suggestion in visibleSuggestions"
+            :key="suggestion.title"
+            :suggestion="suggestion.prompt"
+            @click="emit('pick', $event)"
+        >
+            {{ suggestion.title }}
+        </TelaChatSuggestion>
+    </TelaChatSuggestions>
 </template>
-
-<style scoped>
-.eyebrow{color:#a3a3a3;font-size:11px;font-weight:580;letter-spacing:.6px;padding:0 18px 6px;text-transform:uppercase}.chip-row{display:flex;gap:8px;overflow-x:auto;padding:4px 14px 8px;scrollbar-width:none}.chip-row::-webkit-scrollbar{display:none}.chip{align-items:center;background:#fff;border:.5px solid #d9d9d9;border-radius:999px;color:#171717;display:inline-flex;flex-shrink:0;font-size:13px;font-weight:460;gap:8px;line-height:16px;padding:9px 13px;transition:background .12s;white-space:nowrap}.chip:active{background:#f5f5f5}.chip__icon{color:#737373;font-size:16px}
-</style>

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

@@ -1,7 +1,11 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    pick: (label: string) => any;
-}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{
-    onPick?: ((label: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+import type { ChatSuggestion } from '../../types.js';
+type __VLS_Props = {
+    suggestions?: readonly ChatSuggestion[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    pick: (prompt: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPick?: ((prompt: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -4,7 +4,7 @@ import type { ConversationFile } from '../../../types/schemas/chat/files.js';
 import type { TopbarTab } from '../../../types/schemas/chat/ui.js';
 import type { WorkspaceSettingsResponse as WorkspaceSettings } from '../../../types/schemas/chat/workspace-settings.js';
 import type { TelaAgentContextFile, TelaAgentInputVariable, TelaAgentSkill } from '../../../types/schemas/integrations/tela-agent-api.js';
-import type { ChatActor } from '../../types.js';
+import type { ChatActor, ChatSuggestion } from '../../types.js';
 type __VLS_Props = {
     currentConversation: DeepReadonly<ConversationWithMessages> | null;
     displayTitle: string;
@@ -27,8 +27,8 @@ type __VLS_Props = {
     hasPendingMessage?: boolean;
     hideSettings?: boolean;
     hideSidebar?: boolean;
-    hideFolderHint?: boolean;
     isEditing: boolean;
+    suggestions?: readonly ChatSuggestion[];
     loading?: boolean;
     messages: Message[];
     showCancelButton?: boolean;
@@ -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

@@ -32,8 +32,8 @@ const props = defineProps({
   hasPendingMessage: { type: Boolean, required: false },
   hideSettings: { type: Boolean, required: false },
   hideSidebar: { type: Boolean, required: false },
-  hideFolderHint: { type: Boolean, required: false },
   isEditing: { type: Boolean, required: true },
+  suggestions: { type: Array, required: false },
   loading: { type: Boolean, required: false },
   messages: { type: Array, required: true },
   showCancelButton: { type: Boolean, required: false },
@@ -140,7 +140,6 @@ function startNewConversationFromOutdatedSettings() {
         :conversations="conversations"
         :active-id="activeConversationId"
         :loading="conversationsLoading"
-        :hide-folder-hint="hideFolderHint"
         :user-name="currentUser?.name ?? void 0"
         :user-email="currentUser?.email ?? void 0"
         :user-image="currentUser?.image ?? void 0"
@@ -245,7 +244,7 @@ function startNewConversationFromOutdatedSettings() {
                     />
                 </div>
 
-                <ChatMobileHomeSuggestions @pick="applySuggestion" />
+                <ChatMobileHomeSuggestions :suggestions="suggestions" @pick="applySuggestion" />
             </div>
 
             <div v-if="showConversationHistory" mt-auto pt-12px pb-20px b-t=".5px solid #E8E8E8">

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

@@ -4,7 +4,7 @@ import type { ConversationFile } from '../../../types/schemas/chat/files.js';
 import type { TopbarTab } from '../../../types/schemas/chat/ui.js';
 import type { WorkspaceSettingsResponse as WorkspaceSettings } from '../../../types/schemas/chat/workspace-settings.js';
 import type { TelaAgentContextFile, TelaAgentInputVariable, TelaAgentSkill } from '../../../types/schemas/integrations/tela-agent-api.js';
-import type { ChatActor } from '../../types.js';
+import type { ChatActor, ChatSuggestion } from '../../types.js';
 type __VLS_Props = {
     currentConversation: DeepReadonly<ConversationWithMessages> | null;
     displayTitle: string;
@@ -27,8 +27,8 @@ type __VLS_Props = {
     hasPendingMessage?: boolean;
     hideSettings?: boolean;
     hideSidebar?: boolean;
-    hideFolderHint?: boolean;
     isEditing: boolean;
+    suggestions?: readonly ChatSuggestion[];
     loading?: boolean;
     messages: Message[];
     showCancelButton?: boolean;
@@ -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/feature-config.d.ts

@@ -1,6 +1,13 @@
+/**
+ * Optional UI toggles the host passes per embed instance. All default to `false`;
+ * the host owns the policy (hardcoded, role-gated, or from a feature-flag provider).
+ */
 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;
 };
 export type ResolvedChatFeatureConfig = {

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;