@agent-native/core 0.225.2-nightly-20261106152255 → 0.226.0

package/src/templates/builder-code-starter/server/lib/composer-reference-messages.ts.patch

@@ -0,0 +1,44 @@
+--- a/server/lib/composer-reference-messages.ts
++++ b/server/lib/composer-reference-messages.ts
+@@ -1,5 +1 @@
+-import {
+-  DEFAULT_LOCALE,
+-  LOCALIZATION_SETTING_KEY,
+-  normalizeLocalizationPreference,
+-} from "@agent-native/core/localization";
++import { workspaceIntegrationMessagesForUser } from "@agent-native/core/localization/workspace-integration-messages";
+@@ -7 +2,0 @@
+-import { getUserSetting } from "@agent-native/core/settings";
+@@ -9,14 +3,0 @@
+-const catalogs = {
+-  "en-US": () => import("../../app/i18n/en-US.js"),
+-  "ar-SA": () => import("../../app/i18n/ar-SA.js"),
+-  "de-DE": () => import("../../app/i18n/de-DE.js"),
+-  "es-ES": () => import("../../app/i18n/es-ES.js"),
+-  "fr-FR": () => import("../../app/i18n/fr-FR.js"),
+-  "hi-IN": () => import("../../app/i18n/hi-IN.js"),
+-  "ja-JP": () => import("../../app/i18n/ja-JP.js"),
+-  "ko-KR": () => import("../../app/i18n/ko-KR.js"),
+-  "pt-BR": () => import("../../app/i18n/pt-BR.js"),
+-  "zh-CN": () => import("../../app/i18n/zh-CN.js"),
+-  "zh-TW": () => import("../../app/i18n/zh-TW.js"),
+-};
+-
+@@ -24,3 +5,2 @@
+-  const email = getRequestUserEmail();
+-  const preference = normalizeLocalizationPreference(
+-    email ? await getUserSetting(email, LOCALIZATION_SETTING_KEY) : undefined,
++  const messages = await workspaceIntegrationMessagesForUser(
++    getRequestUserEmail() ?? "",
+@@ -28,6 +8,5 @@
+-  const locale = preference.locale;
+-  const load =
+-    locale && locale in catalogs
+-      ? catalogs[locale as keyof typeof catalogs]
+-      : catalogs[DEFAULT_LOCALE];
+-  return (await load()).default.composerSources;
++  return {
++    authentication: messages.composerReferenceAuthentication,
++    invalid: messages.composerReferenceInvalid,
++    unavailable: messages.composerReferenceUnavailable,
++  };

package/src/templates/builder-code-starter/server/plugins/agent-chat.ts.patch

@@ -1,12 +1,16 @@
 ===================================================================
 --- a/server/plugins/agent-chat.ts
 +++ b/server/plugins/agent-chat.ts
-@@ -4,25 +4,21 @@
+@@ -4,21 +4,14 @@
    loadActionsFromStaticRegistry,
  } from "@agent-native/core/server";
 
  import actionsRegistry from "../../.generated/actions-registry.js";
 +import { appOperationFinalResponseGuard } from "../agent/app-operation-guard.js";
+ import {
+   searchConversationReferences,
+   validateConversationReferences,
+ } from "../lib/composer-references.js";
 
 -const INITIAL_TOOL_NAMES = [
 -  "view-screen",
@@ -18,6 +22,11 @@
 -
  export default createAgentChatPlugin({
    appId: "chat",
+   mentionProviders: {
+     chats: {
+@@ -30,12 +23,15 @@
+     await validateConversationReferences(references);
+   },
    actions: loadActionsFromStaticRegistry(actionsRegistry),
    mcp: { connectorCatalog: [], appApprovalPage: true },
 -  initialToolNames: INITIAL_TOOL_NAMES,

package/src/templates/chat/app/components/ChatComposerContext.tsx

@@ -0,0 +1,31 @@
+import { useT } from "@agent-native/core/client/i18n";
+import type { AssistantChatComposerContextProviderProps } from "@agent-native/toolkit/app/chat/chat";
+import type { ComposerContextMenuItem } from "@agent-native/toolkit/composer";
+import { IconMessages } from "@tabler/icons-react";
+
+export function useChatComposerMenuItems(): ComposerContextMenuItem[] {
+  const t = useT();
+  return [
+    {
+      id: "reference-chat",
+      label: t("composerSources.reference"),
+      icon: <IconMessages />,
+      section: "context",
+      order: 20,
+      referenceType: "chat",
+      referencePicker: { source: "chats", referenceType: "chat" },
+    },
+  ];
+}
+
+export function ChatComposerContextProvider({
+  children,
+}: AssistantChatComposerContextProviderProps) {
+  return children({
+    menuItems: useChatComposerMenuItems(),
+    contextItems: [],
+    onRemoveContextItem: () => {},
+    prepareSubmission: async (snapshot) => snapshot,
+    submissionAccepted: () => {},
+  });
+}

package/src/templates/chat/app/components/chat/ChatRouteContent.tsx

@@ -81,6 +81,7 @@ import {
 import { useLocation, useNavigate, useParams } from "react-router";
 import { toast } from "sonner";
 
+import { useChatComposerMenuItems } from "@/components/ChatComposerContext";
 import { Button } from "@/components/ui/button";
 import {
   Tooltip,
@@ -1390,6 +1391,7 @@ function ChatCanvas({
     ),
     [setWorkspaceOpen, t, workspaceOpen],
   );
+  const contextMenuItems = useChatComposerMenuItems();
   const chatTitle = thread.thread?.title?.trim() || APP_TITLE;
 
   return (
@@ -1406,6 +1408,7 @@ function ChatCanvas({
         expectExistingThread={!isDraftThread}
         onStartNewChat={() => void navigate(NEW_CHAT_PATH)}
         composerProps={{
+          contextMenuItems,
           requireAgentEngine: true,
           contextUsageSlot: <ChatContextRing threadId={threadId} />,
           ...(initialText === undefined ? {} : { initialText }),

package/src/templates/chat/app/components/home/HomePage.tsx

@@ -20,6 +20,7 @@ import {
 import { useState, type ReactNode } from "react";
 import { useNavigate } from "react-router";
 
+import { useChatComposerMenuItems } from "@/components/ChatComposerContext";
 import { Button } from "@/components/ui/button";
 import {
   Item,
@@ -120,14 +121,15 @@ function HomeAgentComposerInput({
 }) {
   const t = useT();
   const control = useAgentKitControl(threadId);
+  const contextMenuItems = useChatComposerMenuItems();
 
   return (
     <AgentKitComposer
       threadId={threadId}
       requireAgentEngine
       placeholder={t("chat.composerPlaceholder")}
-      plusMenuMode="hidden"
-      attachmentsEnabled={false}
+      plusMenuMode="full"
+      contextMenuItems={contextMenuItems}
       voiceEnabled
       onVoiceChatStart={onVoiceChatStart}
       onSubmit={async (text, files, references, options) => {

package/src/templates/chat/app/components/layout/AgentInspector.tsx

@@ -5,6 +5,7 @@ import { AgentSidebar } from "@agent-native/toolkit/app/chat";
 import { type ReactNode } from "react";
 import { useNavigate } from "react-router";
 
+import { ChatComposerContextProvider } from "@/components/ChatComposerContext";
 import { chatThreadPath } from "@/lib/chat-paths";
 import { TAB_ID } from "@/lib/tab-id";
 
@@ -30,6 +31,7 @@ export function AgentInspector({
 
   return (
     <AgentSidebar
+      composerContextProvider={ChatComposerContextProvider}
       position="right"
       chatViewTransition
       chatViewTransitionHandoff={chatHomeHandoffPending}

package/src/templates/chat/app/i18n/ar-SA.ts

@@ -1,4 +1,11 @@
 const messages = {
+  composerSources: {
+    reference: "الإشارة إلى محادثة…",
+    group: "المحادثات",
+    authentication: "سجّل الدخول لإضافة مرجع.",
+    invalid: "اختر مرجعًا صالحًا قبل الإرسال.",
+    unavailable: "لم يعد المرجع المحدد متاحًا. أزله أو اختره مرة أخرى.",
+  },
   composer: {
     removeAttachment: "إزالة {{name}}",
     removeReference: "إزالة مرجع {{name}}",

package/src/templates/chat/app/i18n/de-DE.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "Unterhaltung referenzieren…",
+    group: "Unterhaltungen",
+    authentication: "Melde dich an, um eine Referenz hinzuzufügen.",
+    invalid: "Wähle vor dem Senden eine gültige Referenz.",
+    unavailable:
+      "Eine ausgewählte Referenz ist nicht mehr verfügbar. Entferne sie oder wähle sie erneut.",
+  },
   composer: {
     removeAttachment: "{{name}} entfernen",
     removeReference: "Referenz {{name}} entfernen",

package/src/templates/chat/app/i18n/en-US.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "Reference a conversation…",
+    group: "Conversations",
+    authentication: "Sign in to add a reference.",
+    invalid: "Choose a valid reference before sending.",
+    unavailable:
+      "A selected reference is no longer available. Remove it or choose it again.",
+  },
   composer: {
     removeAttachment: "Remove {{name}}",
     removeReference: "Remove {{name}} reference",

package/src/templates/chat/app/i18n/es-ES.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "Referenciar una conversación…",
+    group: "Conversaciones",
+    authentication: "Inicia sesión para añadir una referencia.",
+    invalid: "Elige una referencia válida antes de enviar.",
+    unavailable:
+      "Una referencia seleccionada ya no está disponible. Elimínala o selecciónala de nuevo.",
+  },
   composer: {
     removeAttachment: "Quitar {{name}}",
     removeReference: "Eliminar la referencia {{name}}",

package/src/templates/chat/app/i18n/fr-FR.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "Référencer une conversation…",
+    group: "Conversations",
+    authentication: "Connectez-vous pour ajouter une référence.",
+    invalid: "Choisissez une référence valide avant l’envoi.",
+    unavailable:
+      "Une référence sélectionnée n’est plus disponible. Supprimez-la ou sélectionnez-la à nouveau.",
+  },
   composer: {
     removeAttachment: "Supprimer {{name}}",
     removeReference: "Supprimer la référence {{name}}",

package/src/templates/chat/app/i18n/hi-IN.ts

@@ -1,4 +1,11 @@
 const messages = {
+  composerSources: {
+    reference: "बातचीत का संदर्भ दें…",
+    group: "बातचीत",
+    authentication: "संदर्भ जोड़ने के लिए साइन इन करें।",
+    invalid: "भेजने से पहले एक मान्य संदर्भ चुनें।",
+    unavailable: "चुना गया संदर्भ अब उपलब्ध नहीं है। उसे हटाएँ या फिर से चुनें।",
+  },
   composer: {
     removeAttachment: "{{name}} हटाएँ",
     removeReference: "{{name}} संदर्भ हटाएँ",

package/src/templates/chat/app/i18n/ja-JP.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "会話を参照…",
+    group: "会話",
+    authentication: "参照を追加するにはログインしてください。",
+    invalid: "送信する前に有効な参照を選択してください。",
+    unavailable:
+      "選択した参照は利用できなくなりました。削除するか、もう一度選択してください。",
+  },
   composer: {
     removeAttachment: "{{name}} を削除",
     removeReference: "{{name}} の参照を削除",

package/src/templates/chat/app/i18n/ko-KR.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "대화 참조…",
+    group: "대화",
+    authentication: "참조를 추가하려면 로그인하세요.",
+    invalid: "전송하기 전에 유효한 참조를 선택하세요.",
+    unavailable:
+      "선택한 참조를 더 이상 사용할 수 없습니다. 제거하거나 다시 선택하세요.",
+  },
   composer: {
     removeAttachment: "{{name}} 제거",
     removeReference: "{{name}} 참조 제거",

package/src/templates/chat/app/i18n/pt-BR.ts

@@ -1,4 +1,12 @@
 const messages = {
+  composerSources: {
+    reference: "Referenciar uma conversa…",
+    group: "Conversas",
+    authentication: "Entre para adicionar uma referência.",
+    invalid: "Escolha uma referência válida antes de enviar.",
+    unavailable:
+      "Uma referência selecionada não está mais disponível. Remova-a ou selecione-a novamente.",
+  },
   composer: {
     removeAttachment: "Remover {{name}}",
     removeReference: "Remover referência {{name}}",

package/src/templates/chat/app/i18n/zh-CN.ts

@@ -1,4 +1,11 @@
 const messages = {
+  composerSources: {
+    reference: "引用对话…",
+    group: "对话",
+    authentication: "登录以添加引用。",
+    invalid: "发送前请选择有效的引用。",
+    unavailable: "所选引用已不可用。请移除或重新选择。",
+  },
   composer: {
     removeAttachment: "移除 {{name}}",
     removeReference: "移除 {{name}} 引用",

package/src/templates/chat/app/i18n/zh-TW.ts

@@ -1,4 +1,11 @@
 const messages = {
+  composerSources: {
+    reference: "引用對話…",
+    group: "對話",
+    authentication: "登入以新增引用。",
+    invalid: "傳送前請選擇有效的引用。",
+    unavailable: "所選引用已無法使用。請移除或重新選擇。",
+  },
   composer: {
     removeAttachment: "移除 {{name}}",
     removeReference: "移除 {{name}} 參照",

package/src/templates/chat/server/lib/composer-reference-messages.ts

@@ -0,0 +1,34 @@
+import {
+  DEFAULT_LOCALE,
+  LOCALIZATION_SETTING_KEY,
+  normalizeLocalizationPreference,
+} from "@agent-native/core/localization";
+import { getRequestUserEmail } from "@agent-native/core/server/request-context";
+import { getUserSetting } from "@agent-native/core/settings";
+
+const catalogs = {
+  "en-US": () => import("../../app/i18n/en-US.js"),
+  "ar-SA": () => import("../../app/i18n/ar-SA.js"),
+  "de-DE": () => import("../../app/i18n/de-DE.js"),
+  "es-ES": () => import("../../app/i18n/es-ES.js"),
+  "fr-FR": () => import("../../app/i18n/fr-FR.js"),
+  "hi-IN": () => import("../../app/i18n/hi-IN.js"),
+  "ja-JP": () => import("../../app/i18n/ja-JP.js"),
+  "ko-KR": () => import("../../app/i18n/ko-KR.js"),
+  "pt-BR": () => import("../../app/i18n/pt-BR.js"),
+  "zh-CN": () => import("../../app/i18n/zh-CN.js"),
+  "zh-TW": () => import("../../app/i18n/zh-TW.js"),
+};
+
+export async function composerReferenceMessages() {
+  const email = getRequestUserEmail();
+  const preference = normalizeLocalizationPreference(
+    email ? await getUserSetting(email, LOCALIZATION_SETTING_KEY) : undefined,
+  );
+  const locale = preference.locale;
+  const load =
+    locale && locale in catalogs
+      ? catalogs[locale as keyof typeof catalogs]
+      : catalogs[DEFAULT_LOCALE];
+  return (await load()).default.composerSources;
+}

package/src/templates/chat/server/lib/composer-references.ts

@@ -0,0 +1,60 @@
+import { getOrgContext } from "@agent-native/core/org";
+import {
+  listThreads,
+  searchThreads,
+  type AgentChatReference,
+} from "@agent-native/core/server";
+import { assertAccess, ForbiddenError } from "@agent-native/core/sharing";
+import { createError, type H3Event } from "h3";
+
+import { composerReferenceMessages } from "./composer-reference-messages.js";
+
+export async function searchConversationReferences(
+  query: string,
+  event?: H3Event,
+) {
+  if (!event)
+    throw createError({
+      statusCode: 401,
+      statusMessage: (await composerReferenceMessages()).authentication,
+    });
+  const { email, orgId } = await getOrgContext(event);
+  const options = { orgId, includeExternal: false, sourceAppId: "chat" };
+  const search = query.trim().slice(0, 200);
+  const rows = search
+    ? await searchThreads(email, search, 20, options)
+    : await listThreads(email, { ...options, limit: 20 });
+  return rows.map((row) => ({
+    id: `chat:${row.id}`,
+    label: row.title || row.id,
+    description: row.preview.slice(0, 500),
+    refType: "chat",
+    refId: row.id,
+    refPath: `/chat/${encodeURIComponent(row.id)}`,
+    icon: "message",
+  }));
+}
+
+export async function validateConversationReferences(
+  references: readonly AgentChatReference[],
+) {
+  for (const reference of references) {
+    if (reference.type !== "mention" || reference.refType !== "chat") continue;
+    if (!reference.refId)
+      throw createError({
+        statusCode: 400,
+        statusMessage: (await composerReferenceMessages()).invalid,
+      });
+    try {
+      await assertAccess("chat_thread", reference.refId, "viewer", undefined, {
+        skipResourceBody: true,
+      });
+    } catch (error) {
+      if (error instanceof ForbiddenError)
+        throw new ForbiddenError(
+          (await composerReferenceMessages()).unavailable,
+        );
+      throw error;
+    }
+  }
+}

package/src/templates/chat/server/plugins/agent-chat.ts

@@ -5,6 +5,10 @@ import {
 } from "@agent-native/core/server";
 
 import actionsRegistry from "../../.generated/actions-registry.js";
+import {
+  searchConversationReferences,
+  validateConversationReferences,
+} from "../lib/composer-references.js";
 
 const INITIAL_TOOL_NAMES = [
   "view-screen",
@@ -16,6 +20,15 @@ const INITIAL_TOOL_NAMES = [
 
 export default createAgentChatPlugin({
   appId: "chat",
+  mentionProviders: {
+    chats: {
+      label: "composerSources.group",
+      search: searchConversationReferences,
+    },
+  },
+  prepareRequest: async ({ references }) => {
+    await validateConversationReferences(references);
+  },
   actions: loadActionsFromStaticRegistry(actionsRegistry),
   mcp: { connectorCatalog: [], appApprovalPage: true },
   initialToolNames: INITIAL_TOOL_NAMES,