@meistrari/chat-nuxt 1.6.0 → 1.7.0

package/README.md

@@ -161,11 +161,18 @@ The chat workspace is resolved from the authenticated `activeOrganization` provi
 <MeistrariChatEmbed tela-agent-id="agent_123" />
 ```
 
+`conversationScope` works in both runtimes. In default chat mode, it isolates conversations inside the authenticated workspace without requiring a Tela agent:
+
+```vue
+<MeistrariChatEmbed :conversation-scope="`user:${userId}`" />
+```
+
 Host apps can also provide Tela agent inputs directly. When `telaAgentInputs` is non-null, the chat sends those inputs with each agent run and does not render the agent variables panel.
 
 ```vue
 <MeistrariChatEmbed
     tela-agent-id="agent_123"
+    :conversation-scope="`customer:${customerId}`"
     :tela-agent-inputs="[
         { type: 'text', name: 'customer_id', content: customerId },
     ]"
@@ -203,6 +210,7 @@ Key props for embedding:
 - **`:hide-sidebar="true"`** — removes the conversation list, keeps just the chat
 - **`v-model:conversation-id`** — sync the active conversation with your app's state
 - **`:initial-conversation-id`** — open a specific conversation on mount
+- **`conversation-scope`** — isolate conversation history inside the same workspace or Tela agent
 
 ## `<MeistrariChatEmbed>` Props
 
@@ -211,6 +219,7 @@ Key props for embedding:
 | `hideSidebar` | `boolean` | `false` | Hide conversation list sidebar |
 | `conversationId` | `string \| null` | `null` | Controlled conversation (supports v-model) |
 | `initialConversationId` | `string \| null` | `null` | Open this conversation on mount |
+| `conversationScope` | `string \| null` | `null` | Isolate conversation history by technical scope within the current workspace and runtime |
 | `telaAgentId` | `string` | — | Use Tela agent mode for this embed |
 | `telaAgentInputs` | `TelaAgentExecutionInput[] \| null` | `undefined` | Inputs sent with each Tela agent run; hides the variables panel when non-null |
 | `workspaceSettings` | `WorkspaceSettings \| null` | `null` | Override settings from host app |
@@ -221,6 +230,22 @@ Key props for embedding:
 
 `loadingMessagesMode` only applies when `loadingMessages` has at least one non-empty message.
 
+Use `conversationScope` when you need multiple chat surfaces to share the same authenticated workspace but keep separate histories. This is useful for per-user inboxes, record detail pages, customer workspaces, template previews, workflow steps, or any app route where the same chat should only show conversations for that route's domain object. The scope is applied together with the workspace and, when present, the `telaAgentId`.
+
+Scoped embeds only see conversations created with the same scope. Unscoped embeds only see unscoped conversations, so adding a scope will not mix with existing workspace-level history. Scope values are technical identifiers: they are trimmed, blank strings become `null`, and server requests accept 1-200 characters from `A-Z`, `a-z`, `0-9`, `.`, `_`, `:`, `/`, and `-`.
+
+```vue
+<!-- Default chat mode: workspace + scope -->
+<MeistrariChatEmbed :conversation-scope="`user:${userId}`" />
+<MeistrariChatEmbed :conversation-scope="`customer:${customerId}`" />
+
+<!-- Tela agent mode: workspace + telaAgentId + scope -->
+<MeistrariChatEmbed
+    tela-agent-id="agent_123"
+    :conversation-scope="`template:${templateId}`"
+/>
+```
+
 **Events:**
 
 | Event | Payload | Description |

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@meistrari/chat-nuxt",
   "configKey": "chatNuxt",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, mkdirSync, symlinkSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { join, dirname } from 'node:path';
-import { defineNuxtModule, createResolver, addTemplate, addPlugin, addImportsDir, addComponent, addComponentsDir } from 'nuxt/kit';
+import { defineNuxtModule, createResolver, addTemplate, addTypeTemplate, addPlugin, addImportsDir, addComponent, addComponentsDir } from 'nuxt/kit';
 
 const agentEnvironmentResolverCandidates = [
   "server/chat/resolve-agent-environment.ts",
@@ -179,6 +179,7 @@ const DEFAULT_FEATURES = {
   generateTitle: false,
   credentials: false
 };
+const VUE_COMPONENT_EXTENSIONS = [".vue"];
 function resolveChatAuthMode(runtimeConfig) {
   const publicConfig = runtimeConfig.public;
   const telaAuth = publicConfig?.telaAuth;
@@ -342,6 +343,22 @@ const module$1 = defineNuxtModule({
       filename: "chat-nuxt/auth.mjs",
       getContents: () => buildChatAuthTemplate(chatAuthMode)
     });
+    const chatAuthTypeTemplate = addTypeTemplate({
+      filename: "chat-nuxt/chat-auth.d.ts",
+      src: join(runtimeDir, "types/chat-auth.d.ts")
+    });
+    addTypeTemplate({
+      filename: "chat-nuxt/chat-agent-environment-resolver.d.ts",
+      src: join(runtimeDir, "types/chat-agent-environment-resolver.d.ts")
+    }, {
+      nitro: true,
+      nuxt: true
+    });
+    nuxt.hook("prepare:types", ({ tsConfig }) => {
+      tsConfig.compilerOptions ||= {};
+      tsConfig.compilerOptions.paths ||= {};
+      tsConfig.compilerOptions.paths["#chat-auth"] = [chatAuthTypeTemplate.dst];
+    });
     if (!Array.isArray(nuxt.options.extends)) {
       nuxt.options.extends = nuxt.options.extends ? [nuxt.options.extends] : [];
     }
@@ -401,10 +418,12 @@ const module$1 = defineNuxtModule({
       priority: 1e3
     });
     addComponentsDir({
-      path: join(runtimeDir, "components")
+      path: join(runtimeDir, "components"),
+      extensions: VUE_COMPONENT_EXTENSIONS
     });
     addComponentsDir({
       path: join(runtimeDir, "embed/components"),
+      extensions: VUE_COMPONENT_EXTENSIONS,
       pathPrefix: false
     });
     nuxt.hook("vite:extendConfig", (config, { isServer }) => {

package/dist/runtime/components/MeistrariChatEmbed.vue

@@ -2,6 +2,7 @@
 defineProps({
   conversationId: { type: [String, null], required: false },
   initialConversationId: { type: [String, null], required: false },
+  conversationScope: { type: [String, null], required: false },
   hideSidebar: { type: Boolean, required: false },
   loadingMessages: { type: [Array, null], required: false },
   loadingMessagesMode: { type: [String, null], required: false },
@@ -23,6 +24,7 @@ defineEmits(["update:conversationId", "action"]);
         :tela-agent-inputs="telaAgentInputs"
         :conversation-id="conversationId"
         :initial-conversation-id="initialConversationId"
+        :conversation-scope="conversationScope"
         :hide-sidebar="hideSidebar"
         :features="features"
         :loading-messages="loadingMessages"
@@ -38,6 +40,7 @@ defineEmits(["update:conversationId", "action"]);
         :user="user"
         :conversation-id="conversationId"
         :initial-conversation-id="initialConversationId"
+        :conversation-scope="conversationScope"
         :hide-sidebar="hideSidebar"
         :features="features"
         :loading-messages="loadingMessages"

package/dist/runtime/composables/useChat.js

@@ -156,7 +156,8 @@ export function useChat() {
   const isTelaAgentMode = computed(() => !!embedConfig?.telaAgentId.value);
   const chatScope = computed(() => resolveChatStateScope(
     embedConfig?.workspaceId.value || activeOrganization.value?.id,
-    embedConfig?.telaAgentId.value
+    embedConfig?.telaAgentId.value,
+    embedConfig?.conversationScope?.value
   ));
   const currentConversationBuckets = useState("chat-current-conversation", () => ({}));
   const messageBuckets = useState("chat-messages", () => ({}));

package/dist/runtime/composables/useChatApi.js

@@ -14,6 +14,10 @@ export function useChatApi() {
     if (telaAgentId) {
       mergedHeaders["x-chat-tela-agent-id"] = telaAgentId;
     }
+    const conversationScope = embedConfig?.conversationScope?.value?.trim();
+    if (conversationScope) {
+      mergedHeaders["x-chat-conversation-scope"] = conversationScope;
+    }
     return Object.keys(mergedHeaders).length > 0 ? mergedHeaders : void 0;
   }
   function withChatHeaders(options) {

package/dist/runtime/composables/useConversations.js

@@ -38,7 +38,8 @@ export function useConversations() {
   const isTelaAgentMode = computed(() => !!embedConfig?.telaAgentId.value);
   const workspaceScope = computed(() => resolveChatStateScope(
     embedConfig?.workspaceId.value || activeOrganization.value?.id,
-    embedConfig?.telaAgentId.value
+    embedConfig?.telaAgentId.value,
+    embedConfig?.conversationScope?.value
   ));
   const conversations = computed({
     get: () => conversationBuckets.value[workspaceScope.value] ?? [],
@@ -230,6 +231,7 @@ export function useConversations() {
         appliedSettingsSnapshot: cloneAppliedSettingsSnapshot(updated.appliedSettingsSnapshot),
         telaAgentId: updated.telaAgentId,
         createdBy: updated.createdBy,
+        conversationScope: updated.conversationScope,
         createdAt: updated.createdAt,
         updatedAt: updated.updatedAt
       };

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

@@ -6,6 +6,7 @@ type ConfiguredTelaAgentInputs = DeepReadonly<TelaAgentExecutionInput[]> | null
 export type EmbedConfig = {
     workspaceId: Ref<string>;
     telaAgentId: Ref<string | null>;
+    conversationScope: Ref<string | null>;
     telaAgentInputs: Ref<ConfiguredTelaAgentInputs>;
     workspaceSettings: Ref<DeepReadonly<WorkspaceSettings> | WorkspaceSettings | null | undefined>;
     hideSidebar: Ref<boolean>;
@@ -17,6 +18,7 @@ export type EmbedConfig = {
 type EmbedConfigInput = {
     workspaceId: MaybeRefOrGetter<string>;
     telaAgentId?: MaybeRefOrGetter<string | null | undefined>;
+    conversationScope?: MaybeRefOrGetter<string | null | undefined>;
     telaAgentInputs?: MaybeRefOrGetter<ConfiguredTelaAgentInputs>;
     workspaceSettings?: MaybeRefOrGetter<DeepReadonly<WorkspaceSettings> | WorkspaceSettings | null | undefined>;
     hideSidebar?: MaybeRefOrGetter<boolean | undefined>;

package/dist/runtime/composables/useEmbedConfig.js

@@ -1,3 +1,4 @@
+import { normalizeConversationScope } from "../utils/tela-chat.js";
 const EMBED_CONFIG_KEY = "embed-config";
 function useGlobalCustomComponentsState() {
   const nuxtApp = useNuxtApp();
@@ -9,6 +10,7 @@ function useGlobalEmbedConfigState() {
     provided: useState("chat-embed-config-provided", () => false),
     workspaceId: useState("chat-embed-config-workspace-id", () => ""),
     telaAgentId: useState("chat-embed-config-tela-agent-id", () => null),
+    conversationScope: useState("chat-embed-config-conversation-scope", () => null),
     telaAgentInputs: useState("chat-embed-config-tela-agent-inputs", () => void 0),
     workspaceSettings: useState("chat-embed-config-workspace-settings", () => void 0),
     hideSidebar: useState("chat-embed-config-hide-sidebar", () => void 0),
@@ -22,6 +24,7 @@ export function provideEmbedConfig(input, options = {}) {
   const config = {
     workspaceId: computed(() => toValue(input.workspaceId)),
     telaAgentId: computed(() => toValue(input.telaAgentId) ?? null),
+    conversationScope: computed(() => normalizeConversationScope(toValue(input.conversationScope))),
     telaAgentInputs: computed(() => toValue(input.telaAgentInputs)),
     workspaceSettings: computed(() => toValue(input.workspaceSettings)),
     hideSidebar: computed(() => toValue(input.hideSidebar) ?? true),
@@ -36,6 +39,7 @@ export function provideEmbedConfig(input, options = {}) {
       globalConfig.provided.value = true;
       globalConfig.workspaceId.value = config.workspaceId.value;
       globalConfig.telaAgentId.value = config.telaAgentId.value;
+      globalConfig.conversationScope.value = config.conversationScope.value;
       globalConfig.telaAgentInputs.value = config.telaAgentInputs.value;
       globalConfig.workspaceSettings.value = config.workspaceSettings.value;
       globalConfig.hideSidebar.value = config.hideSidebar.value;
@@ -57,6 +61,7 @@ export function useEmbedConfig() {
   return {
     workspaceId: computed(() => globalConfig.workspaceId.value),
     telaAgentId: computed(() => globalConfig.telaAgentId.value),
+    conversationScope: computed(() => globalConfig.conversationScope.value),
     telaAgentInputs: computed(() => globalConfig.telaAgentInputs.value),
     workspaceSettings: computed(() => globalConfig.workspaceSettings.value),
     hideSidebar: computed(() => globalConfig.hideSidebar.value ?? true),

package/dist/runtime/embed/components/ChatEmbed.vue

@@ -2,11 +2,12 @@
 import { useChatAuth } from "#chat-auth";
 import { provideEmbedConfig, useEmbedConfig } from "../../composables/useEmbedConfig";
 import { provideChatAction } from "../../composables/useChatAction";
-import { normalizeTelaAgentId } from "../../utils/tela-chat";
+import { normalizeConversationScope, normalizeTelaAgentId, resolveConversationScopeKeySegment } from "../../utils/tela-chat";
 import ChatEmbedInner from "./ChatEmbedInner.vue";
 const props = defineProps({
   conversationId: { type: [String, null], required: false },
   initialConversationId: { type: [String, null], required: false },
+  conversationScope: { type: [String, null], required: false },
   hideSidebar: { type: Boolean, required: false },
   loadingMessages: { type: [Array, null], required: false },
   loadingMessagesMode: { type: [String, null], required: false },
@@ -23,10 +24,12 @@ const parentEmbedConfig = useEmbedConfig();
 const { activeOrganization } = useChatAuth();
 const workspaceId = computed(() => activeOrganization.value?.id?.trim() ?? "");
 const normalizedTelaAgentId = computed(() => normalizeTelaAgentId(props.telaAgentId));
+const normalizedConversationScope = computed(() => normalizeConversationScope(props.conversationScope));
 const ignoredPropsWarningKey = ref(null);
 provideEmbedConfig({
   workspaceId,
   telaAgentId: normalizedTelaAgentId,
+  conversationScope: normalizedConversationScope,
   telaAgentInputs: computed(() => props.telaAgentInputs),
   workspaceSettings: computed(() => props.workspaceSettings),
   hideSidebar: computed(() => props.hideSidebar),
@@ -62,7 +65,7 @@ provideChatAction((payload) => {
 <template>
     <ChatEmbedInner
         v-if="workspaceId"
-        :key="`${workspaceId}:${normalizedTelaAgentId ?? 'default-chat'}`"
+        :key="`${workspaceId}:${normalizedTelaAgentId ?? 'default-chat'}:scope:${resolveConversationScopeKeySegment(normalizedConversationScope)}`"
         :conversation-id="conversationId"
         :initial-conversation-id="initialConversationId"
         :hide-sidebar="hideSidebar"

package/dist/runtime/server/api/conversations/[id]/duplicate.post.js

@@ -30,6 +30,7 @@ export default defineEventHandler(async (event) => {
       title: `${original.title} (copy)`,
       createdBy: context.user.email,
       telaAgentId: original.telaAgentId,
+      conversationScope: original.conversationScope,
       threadSessionId: null,
       model: original.telaAgentId ? null : original.model,
       appliedSettingsAt: trustedSettings ? getWorkspaceSettingsUpdatedAt(trustedSettings) : null,

package/dist/runtime/server/api/conversations/index.post.js

@@ -30,6 +30,7 @@ export default defineEventHandler(async (event) => {
     userId: context.user.id,
     createdBy: context.user.email,
     telaAgentId: context.telaAgentId,
+    conversationScope: context.conversationScope,
     ...context.telaAgentId ? { model: null } : body.model ? { model: body.model } : {}
   }).returning();
   if (!conversation) {

package/dist/runtime/server/db/schema/conversations.d.ts

@@ -105,6 +105,23 @@ export declare const conversations: import("drizzle-orm/pg-core").PgTableWithCol
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        conversationScope: import("drizzle-orm/pg-core").PgColumn<{
+            name: "conversation_scope";
+            tableName: "conversations";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         model: import("drizzle-orm/pg-core").PgColumn<{
             name: "model";
             tableName: "conversations";

package/dist/runtime/server/db/schema/conversations.js

@@ -7,6 +7,7 @@ export const conversations = chatSchema.table("conversations", {
   title: text("title").notNull().default("Nova conversa"),
   threadSessionId: text("thread_session_id"),
   telaAgentId: text("tela_agent_id"),
+  conversationScope: text("conversation_scope"),
   model: text("model").default("claude-sonnet-4-5"),
   appliedSettingsAt: timestamp("applied_settings_at", { withTimezone: true }),
   appliedSettingsSnapshot: jsonb("applied_settings_snapshot").$type(),

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-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,15 @@ 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>
+    getToken: () => Promise<string | null | undefined>
+    getAvailableOrganizations: () => Promise<ChatAuthOrganization[]>
+    switchOrganization: (organizationId: string) => Promise<void>
 }

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

@@ -4,26 +4,45 @@ 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;
+    /** 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/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;

package/drizzle/meta/0015_snapshot.json

@@ -0,0 +1,738 @@
+{
+  "id": "4c144c5c-7df6-4aa0-9c2d-ac7d60864537",
+  "prevId": "00e3e29e-98c4-4e48-98f4-0af0913d882b",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "chat.conversation_usage": {
+      "name": "conversation_usage",
+      "schema": "chat",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "prompt_tokens": {
+          "name": "prompt_tokens",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "completion_tokens": {
+          "name": "completion_tokens",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "total_tokens": {
+          "name": "total_tokens",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "prompt_cost": {
+          "name": "prompt_cost",
+          "type": "numeric(12, 8)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "completion_cost": {
+          "name": "completion_cost",
+          "type": "numeric(12, 8)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "total_cost": {
+          "name": "total_cost",
+          "type": "numeric(12, 8)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "duration_ms": {
+          "name": "duration_ms",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "turns": {
+          "name": "turns",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "user_email": {
+          "name": "user_email",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "model": {
+          "name": "model",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "session_id": {
+          "name": "session_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "cache_read_input_tokens": {
+          "name": "cache_read_input_tokens",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "cache_creation_input_tokens": {
+          "name": "cache_creation_input_tokens",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "model_usage": {
+          "name": "model_usage",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "duration_api_ms": {
+          "name": "duration_api_ms",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "web_search_requests": {
+          "name": "web_search_requests",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "web_fetch_requests": {
+          "name": "web_fetch_requests",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "metadata": {
+          "name": "metadata",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_usage_workspace": {
+          "name": "idx_usage_workspace",
+          "columns": [
+            {
+              "expression": "workspace_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_usage_workspace_created": {
+          "name": "idx_usage_workspace_created",
+          "columns": [
+            {
+              "expression": "workspace_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "created_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_usage_conversation": {
+          "name": "idx_usage_conversation",
+          "columns": [
+            {
+              "expression": "conversation_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_usage_user": {
+          "name": "idx_usage_user",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "conversation_usage_conversation_id_conversations_id_fk": {
+          "name": "conversation_usage_conversation_id_conversations_id_fk",
+          "tableFrom": "conversation_usage",
+          "tableTo": "conversations",
+          "schemaTo": "chat",
+          "columnsFrom": [
+            "conversation_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "conversation_usage_conversation_id_unique": {
+          "name": "conversation_usage_conversation_id_unique",
+          "nullsNotDistinct": false,
+          "columns": [
+            "conversation_id"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "chat.conversations": {
+      "name": "conversations",
+      "schema": "chat",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "user_id": {
+          "name": "user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'Nova conversa'"
+        },
+        "thread_session_id": {
+          "name": "thread_session_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "tela_agent_id": {
+          "name": "tela_agent_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "conversation_scope": {
+          "name": "conversation_scope",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "model": {
+          "name": "model",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "default": "'claude-sonnet-4-5'"
+        },
+        "applied_settings_at": {
+          "name": "applied_settings_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "applied_settings_snapshot": {
+          "name": "applied_settings_snapshot",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_conversations_workspace": {
+          "name": "idx_conversations_workspace",
+          "columns": [
+            {
+              "expression": "workspace_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_conversations_user": {
+          "name": "idx_conversations_user",
+          "columns": [
+            {
+              "expression": "user_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_conversations_updated": {
+          "name": "idx_conversations_updated",
+          "columns": [
+            {
+              "expression": "updated_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_conversations_workspace_tela_agent_updated": {
+          "name": "idx_conversations_workspace_tela_agent_updated",
+          "columns": [
+            {
+              "expression": "workspace_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "tela_agent_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "updated_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "chat.external_skills": {
+      "name": "external_skills",
+      "schema": "chat",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "serial",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "ref": {
+          "name": "ref",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "''"
+        },
+        "runtime": {
+          "name": "runtime",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'unknown'"
+        },
+        "allowed_tools": {
+          "name": "allowed_tools",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'[]'::jsonb"
+        },
+        "is_public": {
+          "name": "is_public",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": true
+        },
+        "added_by_user_id": {
+          "name": "added_by_user_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "added_by_username": {
+          "name": "added_by_username",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "added_at": {
+          "name": "added_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {
+        "external_skills_workspace_ref_unique": {
+          "name": "external_skills_workspace_ref_unique",
+          "nullsNotDistinct": false,
+          "columns": [
+            "workspace_id",
+            "ref"
+          ]
+        }
+      },
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "chat.messages": {
+      "name": "messages",
+      "schema": "chat",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "conversation_id": {
+          "name": "conversation_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "default": "'completed'"
+        },
+        "reasoning_data": {
+          "name": "reasoning_data",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "files": {
+          "name": "files",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "external_uuid": {
+          "name": "external_uuid",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "ttft": {
+          "name": "ttft",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_by": {
+          "name": "created_by",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {
+        "idx_messages_conversation": {
+          "name": "idx_messages_conversation",
+          "columns": [
+            {
+              "expression": "conversation_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_messages_created": {
+          "name": "idx_messages_created",
+          "columns": [
+            {
+              "expression": "created_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "messages_conversation_id_conversations_id_fk": {
+          "name": "messages_conversation_id_conversations_id_fk",
+          "tableFrom": "messages",
+          "tableTo": "conversations",
+          "schemaTo": "chat",
+          "columnsFrom": [
+            "conversation_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "chat.workspace_settings": {
+      "name": "workspace_settings",
+      "schema": "chat",
+      "columns": {
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "system_message": {
+          "name": "system_message",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "context_files": {
+          "name": "context_files",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "canvas_tools": {
+          "name": "canvas_tools",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "knowledge_sources": {
+          "name": "knowledge_sources",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {
+    "chat": "chat"
+  },
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/drizzle/meta/_journal.json

@@ -106,6 +106,13 @@
       "when": 1777993742734,
       "tag": "0014_faulty_lake",
       "breakpoints": true
+    },
+    {
+      "idx": 15,
+      "version": "7",
+      "when": 1779212743677,
+      "tag": "0015_illegal_blindfold",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@meistrari/chat-nuxt",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/types.d.mts",
       "import": "./dist/module.mjs"
     },
+    "./components/MeistrariChatEmbed": {
+      "types": "./dist/runtime/components/MeistrariChatEmbed.vue.d.ts",
+      "import": "./dist/runtime/components/MeistrariChatEmbed.vue"
+    },
     "./assets/css/*": "./dist/runtime/assets/css/*",
     "./types/*": {
       "types": "./dist/runtime/types/*.d.ts",
@@ -26,6 +30,7 @@
   "scripts": {
     "build": "mkdir -p .nuxt && { [ -f .nuxt/tsconfig.json ] || printf '{}' > .nuxt/tsconfig.json; } && { [ -f .nuxt/tsconfig.server.json ] || printf '{}' > .nuxt/tsconfig.server.json; } && nuxt-module-build build",
     "dev:prepare": "nuxt-module-build build --stub",
+    "test:types": "pnpm build && tsc -p tsconfig.type-tests.json --noEmit",
     "smoke:pack": "./scripts/smoke-pack-consumer.sh",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",