@meistrari/chat-nuxt 1.6.0 → 1.8.0

package/dist/runtime/server/utils/chat-context.d.ts

@@ -6,9 +6,11 @@ export type ChatContext = {
 };
 export type ChatRuntimeContext = ChatContext & {
     telaAgentId: string | null;
+    conversationScope: string | null;
 };
 export declare function resolveRequestedWorkspaceId(requestedWorkspaceId: string | null | undefined): string | null;
 export declare function resolveRequestedTelaAgentId(requestedTelaAgentId: string | null | undefined): string | null;
+export declare function resolveRequestedConversationScope(requestedConversationScope: string | null | undefined): string | null;
 export declare function resolveChatContextFromSession(session: AppSession, requestedWorkspaceId?: string | null): ChatContext;
 export declare function resolveChatContext(event: H3Event): ChatContext;
 export declare function resolveChatRuntimeContext(event: H3Event): ChatRuntimeContext;

package/dist/runtime/server/utils/chat-context.js

@@ -1,6 +1,7 @@
 import { createError, getHeader } from "h3";
 import { requireUser } from "#chat-runtime/server/utils/auth";
 const TELA_AGENT_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+const CONVERSATION_SCOPE_PATTERN = /^[A-Za-z0-9._:/-]{1,200}$/;
 export function resolveRequestedWorkspaceId(requestedWorkspaceId) {
   const normalized = requestedWorkspaceId?.trim();
   return normalized || null;
@@ -17,6 +18,18 @@ export function resolveRequestedTelaAgentId(requestedTelaAgentId) {
   }
   return normalized;
 }
+export function resolveRequestedConversationScope(requestedConversationScope) {
+  const normalized = requestedConversationScope?.trim();
+  if (!normalized)
+    return null;
+  if (!CONVERSATION_SCOPE_PATTERN.test(normalized)) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid conversation scope"
+    });
+  }
+  return normalized;
+}
 export function resolveChatContextFromSession(session, requestedWorkspaceId) {
   const normalizedRequestedWorkspaceId = resolveRequestedWorkspaceId(requestedWorkspaceId);
   if (normalizedRequestedWorkspaceId && normalizedRequestedWorkspaceId !== session.workspace.id) {
@@ -39,6 +52,7 @@ export function resolveChatRuntimeContext(event) {
   const context = resolveChatContext(event);
   return {
     ...context,
-    telaAgentId: resolveRequestedTelaAgentId(getHeader(event, "x-chat-tela-agent-id"))
+    telaAgentId: resolveRequestedTelaAgentId(getHeader(event, "x-chat-tela-agent-id")),
+    conversationScope: resolveRequestedConversationScope(getHeader(event, "x-chat-conversation-scope"))
   };
 }

package/dist/runtime/server/utils/conversation-message-sync.d.ts

@@ -17,9 +17,15 @@ type MessageUpdateResponse = {
     messages: Message[];
     newFiles?: MessageFile[];
 };
+export declare const PENDING_RESPONSE_GRACE_MS = 30000;
+export declare const THREAD_SESSION_START_ERROR = "Erro: N\u00E3o foi poss\u00EDvel iniciar a sess\u00E3o de resposta. Tente enviar a mensagem novamente.";
+export declare const SESSION_STATUS_CHECK_ERROR = "Erro: N\u00E3o foi poss\u00EDvel verificar o andamento da resposta. Tente enviar a mensagem novamente.";
+export declare function hasPendingMessageExceededGraceWindow(pendingMessage: Pick<Message, 'createdAt'>, now?: Date): boolean;
+export declare function buildFailedPendingMessageUpdate(content: string, now?: Date): MessageUpdate;
 export declare function mapAgentApiSessionToMessageUpdate(agentSession: AgentApiSession, options: {
-    pendingMessage: Pick<Message, 'ttft' | 'createdAt'>;
-    lastAssistantMessage?: Pick<Message, 'externalUuid'> | null;
+    pendingMessage: Pick<Message, 'ttft' | 'createdAt' | 'updatedAt'>;
+    lastAssistantMessage?: Pick<Message, 'externalUuid' | 'content'> | null;
+    lastSyncedMessage?: Pick<Message, 'externalUuid'> | null;
     userMessage?: Pick<Message, 'createdAt'> | null;
     now?: Date;
 }): MessageUpdate;

package/dist/runtime/server/utils/conversation-message-sync.js

@@ -1,19 +1,53 @@
 import { schema } from "#chat-runtime/server/db";
-import { extractContentFromSession } from "#chat-runtime/server/utils/agent-api";
+import { extractContentFromReasoning, extractContentFromSession } from "#chat-runtime/server/utils/agent-api";
 import { logger } from "#chat-runtime/server/utils/logger";
+const STALE_TERMINAL_CONTENT_GRACE_MS = 5e3;
+const STALE_TERMINAL_CONTENT_ERROR = "Erro: O servi\xE7o retornou uma resposta final inconsistente. Tente enviar a mensagem novamente.";
+export const PENDING_RESPONSE_GRACE_MS = 3e4;
+export const THREAD_SESSION_START_ERROR = "Erro: N\xE3o foi poss\xEDvel iniciar a sess\xE3o de resposta. Tente enviar a mensagem novamente.";
+export const SESSION_STATUS_CHECK_ERROR = "Erro: N\xE3o foi poss\xEDvel verificar o andamento da resposta. Tente enviar a mensagem novamente.";
+const NO_RESULT_ERROR = "Erro: O servi\xE7o terminou sem retornar uma resposta. Tente enviar a mensagem novamente.";
 function toMilliseconds(timestamp) {
   if (typeof timestamp !== "number" || !Number.isFinite(timestamp))
     return null;
   return timestamp < 1e10 ? timestamp * 1e3 : timestamp;
 }
+function resolveTerminalContentForPendingMessage(agentSession, newReasoning, lastAssistantMessage) {
+  const sessionContent = extractContentFromSession(agentSession);
+  if (!newReasoning?.length)
+    return sessionContent === lastAssistantMessage?.content ? null : sessionContent;
+  const reasoningContent = extractContentFromReasoning(newReasoning);
+  const hasSessionResultContent = typeof agentSession.result?.content === "string";
+  if (hasSessionResultContent && reasoningContent && sessionContent !== reasoningContent)
+    return null;
+  if (hasSessionResultContent && !reasoningContent && sessionContent === lastAssistantMessage?.content)
+    return null;
+  return sessionContent || reasoningContent;
+}
+export function hasPendingMessageExceededGraceWindow(pendingMessage, now = /* @__PURE__ */ new Date()) {
+  return now.getTime() - pendingMessage.createdAt.getTime() >= PENDING_RESPONSE_GRACE_MS;
+}
+export function buildFailedPendingMessageUpdate(content, now = /* @__PURE__ */ new Date()) {
+  return {
+    content,
+    status: "failed",
+    updatedAt: now
+  };
+}
+function resolveFailedSessionContent(error) {
+  if (error === "no_result")
+    return NO_RESULT_ERROR;
+  return `Error: ${error || "Agent execution failed"}`;
+}
 export function mapAgentApiSessionToMessageUpdate(agentSession, options) {
   const updateData = {};
-  const lastSyncedUuid = options.lastAssistantMessage?.externalUuid;
+  const lastSyncedMessage = options.lastSyncedMessage ?? options.lastAssistantMessage;
+  const lastSyncedUuid = lastSyncedMessage?.externalUuid;
   const lastSyncedIndex = lastSyncedUuid ? agentSession.reasoning?.findIndex((item) => item.uuid === lastSyncedUuid) ?? -1 : -1;
   const newReasoning = agentSession.reasoning?.slice(lastSyncedIndex + 1);
   const hasNewReasoning = newReasoning && newReasoning.length > 0;
   const sessionUpdatedAtMs = toMilliseconds(agentSession.updatedAt);
-  const terminalSessionBelongsToPendingMessage = hasNewReasoning || !options.lastAssistantMessage || sessionUpdatedAtMs !== null && sessionUpdatedAtMs >= options.pendingMessage.createdAt.getTime();
+  const terminalSessionBelongsToPendingMessage = hasNewReasoning || !!options.pendingMessage.updatedAt || !lastSyncedMessage || sessionUpdatedAtMs !== null && sessionUpdatedAtMs >= options.pendingMessage.createdAt.getTime();
   if (hasNewReasoning) {
     updateData.reasoningData = newReasoning;
     const lastReasoningItem = newReasoning.at(-1);
@@ -27,13 +61,25 @@ export function mapAgentApiSessionToMessageUpdate(agentSession, options) {
   }
   if (agentSession.status === "completed" || agentSession.status === "waiting_messages") {
     if (terminalSessionBelongsToPendingMessage) {
-      updateData.content = extractContentFromSession(agentSession);
+      const content = resolveTerminalContentForPendingMessage(agentSession, newReasoning, options.lastAssistantMessage);
+      if (content === null) {
+        const now = options.now ?? /* @__PURE__ */ new Date();
+        const staleSince = options.pendingMessage.updatedAt;
+        if (staleSince && now.getTime() - staleSince.getTime() >= STALE_TERMINAL_CONTENT_GRACE_MS) {
+          updateData.content = STALE_TERMINAL_CONTENT_ERROR;
+          updateData.status = "failed";
+          updateData.updatedAt = now;
+        } else if (!staleSince) {
+          updateData.updatedAt = now;
+        }
+        return updateData;
+      }
+      updateData.content = content;
       updateData.status = "completed";
       updateData.updatedAt = options.now ?? /* @__PURE__ */ new Date();
     }
   } else if (agentSession.status === "failed") {
-    const errorContent = agentSession.error || "Agent execution failed";
-    updateData.content = `Error: ${errorContent}`;
+    updateData.content = resolveFailedSessionContent(agentSession.error);
     updateData.status = "failed";
     updateData.updatedAt = options.now ?? /* @__PURE__ */ new Date();
   }

package/dist/runtime/server/utils/conversation-scope.js

@@ -3,7 +3,8 @@ import { schema } from "#chat-runtime/server/db";
 export function conversationScopeConditions(context, conversationId) {
   const conditions = [
     eq(schema.conversations.workspaceId, context.workspaceId),
-    context.telaAgentId ? eq(schema.conversations.telaAgentId, context.telaAgentId) : isNull(schema.conversations.telaAgentId)
+    context.telaAgentId ? eq(schema.conversations.telaAgentId, context.telaAgentId) : isNull(schema.conversations.telaAgentId),
+    context.conversationScope ? eq(schema.conversations.conversationScope, context.conversationScope) : isNull(schema.conversations.conversationScope)
   ];
   if (conversationId) {
     conditions.unshift(eq(schema.conversations.id, conversationId));

package/dist/runtime/types/chat-auth.d.ts

@@ -21,15 +21,16 @@ type ChatAuthMember = {
 
 type ChatAuthOrganization = {
     id: string
+    name?: string
+    logo?: string | null
     members?: ChatAuthMember[]
 }
 
-declare module '#chat-auth' {
-    export function useChatAuth(): {
-        user: Ref<ChatAuthUser | null>
-        activeOrganization: Ref<ChatAuthOrganization | null>
-        getToken: () => Promise<string | null | undefined>
-        getAvailableOrganizations: () => Promise<ChatAuthOrganization[]>
-        switchOrganization: (organizationId: string) => Promise<void>
-    }
+export function useChatAuth(): {
+    user: Ref<ChatAuthUser | null>
+    activeOrganization: Ref<ChatAuthOrganization | null>
+    logout: () => Promise<void>
+    getToken: () => Promise<string | null | undefined>
+    getAvailableOrganizations: () => Promise<ChatAuthOrganization[]>
+    switchOrganization: (organizationId: string) => Promise<void>
 }

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

@@ -4,26 +4,47 @@ import type { TelaAgentExecutionInput } from './tela-agent.js';
 import type { ChatLoadingMessageMode } from '../utils/chat-loading-messages.js';
 import type { ChatActor, ChatFeatureConfig } from '../utils/tela-chat.js';
 export type ChatEmbedSharedProps = {
+    /** Controlled conversation id. Use with `v-model:conversation-id` when the host owns active conversation state. */
     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. */
+    conversationScope?: string | null;
+    /** Hide the conversation list and render only the active chat surface. */
     hideSidebar?: boolean;
+    /** Hide workspace settings actions while keeping the chat header and content unchanged. */
+    hideSettings?: boolean;
+    /** 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. */
     loadingMessagesMode?: ChatLoadingMessageMode | null;
+    /** Custom markdown component renderers keyed by markdown node or tag name. */
     customComponents?: Record<string, Component>;
+    /** Extra HTML tags allowed by the markdown renderer. */
     customHtmlTags?: readonly string[];
 };
 export type DefaultChatEmbedProps = ChatEmbedSharedProps & {
+    /** Omitted in default chat mode. Set this to switch to Tela agent mode. */
     telaAgentId?: undefined;
+    /** Tela agent inputs are only accepted in Tela agent mode. */
     telaAgentInputs?: undefined;
+    /** Optional host-provided workspace settings. When omitted, chat-nuxt loads workspace settings itself. */
     workspaceSettings?: DeepReadonly<WorkspaceSettings> | WorkspaceSettings | null;
+    /** Optional display identity for messages created by the current user. */
     user?: ChatActor | null;
+    /** Optional UI feature toggles for the default chat runtime. */
     features?: Partial<ChatFeatureConfig>;
 };
 export type TelaAgentChatEmbedProps = ChatEmbedSharedProps & {
+    /** Tela agent id that switches the embed into Tela agent runtime mode. */
     telaAgentId: string;
+    /** Inputs sent with each Tela agent run. Non-null values hide the variables panel. */
     telaAgentInputs?: DeepReadonly<TelaAgentExecutionInput[]> | null;
+    /** Not accepted in Tela agent mode because the Tela agent owns runtime settings. */
     workspaceSettings?: never;
+    /** Not accepted in Tela agent mode because execution identity comes from the Tela agent runtime. */
     user?: never;
+    /** Optional UI feature toggles that are still supported in Tela agent mode. */
     features?: Partial<ChatFeatureConfig>;
 };
 export type MeistrariChatEmbedProps = DefaultChatEmbedProps | TelaAgentChatEmbedProps;

package/dist/runtime/utils/breakpoints.d.ts

@@ -0,0 +1 @@
+export declare const CHAT_MOBILE_BREAKPOINT = 481;

package/dist/runtime/utils/breakpoints.js

@@ -0,0 +1 @@
+export const CHAT_MOBILE_BREAKPOINT = 481;

package/dist/runtime/utils/tela-chat.d.ts

@@ -17,7 +17,9 @@ export type ChatActor = {
 };
 export declare function normalizeConversationId(value: string | null | undefined): string | null;
 export declare function normalizeTelaAgentId(value: string | null | undefined): string | null;
-export declare function resolveChatStateScope(workspaceId: string | null | undefined, telaAgentId: string | null | undefined): string;
+export declare function normalizeConversationScope(value: string | null | undefined): string | null;
+export declare function resolveConversationScopeKeySegment(value: string | null | undefined): string;
+export declare function resolveChatStateScope(workspaceId: string | null | undefined, telaAgentId: string | null | undefined, conversationScope?: string | null): string;
 export declare function resolveChatFeatures(features?: Partial<ChatFeatureConfig>): ResolvedChatFeatureConfig;
 export declare function resolveConversationCreator(conversationUserId: string | null | undefined, options: {
     currentUser?: ChatActor | null;

package/dist/runtime/utils/tela-chat.js

@@ -9,10 +9,19 @@ export function normalizeTelaAgentId(value) {
   const normalized = value?.trim();
   return normalized || null;
 }
-export function resolveChatStateScope(workspaceId, telaAgentId) {
+export function normalizeConversationScope(value) {
+  const normalized = value?.trim();
+  return normalized || null;
+}
+export function resolveConversationScopeKeySegment(value) {
+  const normalizedConversationScope = normalizeConversationScope(value);
+  return normalizedConversationScope ? `value:${normalizedConversationScope}` : "none";
+}
+export function resolveChatStateScope(workspaceId, telaAgentId, conversationScope) {
   const normalizedWorkspaceId = workspaceId?.trim() || "default";
   const normalizedTelaAgentId = normalizeTelaAgentId(telaAgentId);
-  return normalizedTelaAgentId ? `${normalizedWorkspaceId}:tela-agent:${normalizedTelaAgentId}` : `${normalizedWorkspaceId}:default-chat`;
+  const runtimeScope = normalizedTelaAgentId ? `${normalizedWorkspaceId}:tela-agent:${normalizedTelaAgentId}` : `${normalizedWorkspaceId}:default-chat`;
+  return `${runtimeScope}:scope:${resolveConversationScopeKeySegment(conversationScope)}`;
 }
 export function resolveChatFeatures(features) {
   return {

package/drizzle/0015_illegal_blindfold.sql

@@ -0,0 +1 @@
+ALTER TABLE "chat"."conversations" ADD COLUMN "conversation_scope" text;