@agent-native/core 0.75.5 → 0.76.1

package/corpus/templates/dispatch/app/i18n-data.ts

@@ -0,0 +1,267 @@
+import type { LocaleCode } from "@agent-native/core/client";
+
+const enUS = {
+  root: {
+    commandActions: "Actions",
+    commandSearch: "Search",
+    commandAppearance: "Appearance",
+    toggleTheme: "Toggle theme",
+  },
+  settings: {
+    title: "Settings",
+    description: "Language, workspace, resource, and agent preferences.",
+    languageTitle: "Language",
+    languageDescription:
+      "Choose the interface language. This preference is saved for your account.",
+    languageLabel: "Interface language",
+    workspaceTitle: "Workspace",
+    workspaceDescription:
+      "Manage team access and shared workspace resources for Dispatch.",
+    openTeamSettings: "Open team settings",
+    openResourceSettings: "Open resource settings",
+    agentTitle: "Agent settings",
+    agentDescription:
+      "Open the agent sidebar settings for model, API keys, automations, voice, and other agent controls.",
+    openAgentSettings: "Open agent settings",
+  },
+};
+
+type Messages = typeof enUS;
+type PartialMessages = { [K in keyof Messages]?: Partial<Messages[K]> };
+
+function mergeMessages(overrides: PartialMessages): Messages {
+  return {
+    root: { ...enUS.root, ...overrides.root },
+    settings: { ...enUS.settings, ...overrides.settings },
+  };
+}
+
+export const messagesByLocale = {
+  "en-US": enUS,
+  "zh-CN": mergeMessages({
+    root: {
+      commandActions: "操作",
+      commandSearch: "搜索",
+      commandAppearance: "外观",
+      toggleTheme: "切换主题",
+    },
+    settings: {
+      title: "设置",
+      description: "语言、工作区、资源和代理偏好设置。",
+      languageTitle: "语言",
+      languageDescription: "选择界面语言。此偏好会保存到你的账户。",
+      languageLabel: "界面语言",
+      workspaceTitle: "工作区",
+      workspaceDescription: "管理 Dispatch 的团队访问权限和共享工作区资源。",
+      openTeamSettings: "打开团队设置",
+      openResourceSettings: "打开资源设置",
+      agentTitle: "代理设置",
+      agentDescription:
+        "打开代理侧边栏设置，管理模型、API 密钥、自动化、语音和其他代理控制项。",
+      openAgentSettings: "打开代理设置",
+    },
+  }),
+  "es-ES": mergeMessages({
+    root: {
+      commandActions: "Acciones",
+      commandSearch: "Buscar",
+      commandAppearance: "Apariencia",
+      toggleTheme: "Cambiar tema",
+    },
+    settings: {
+      title: "Ajustes",
+      description:
+        "Preferencias de idioma, espacio de trabajo, recursos y agente.",
+      languageTitle: "Idioma",
+      languageDescription:
+        "Elige el idioma de la interfaz. Esta preferencia se guarda en tu cuenta.",
+      languageLabel: "Idioma de la interfaz",
+      workspaceTitle: "Espacio de trabajo",
+      workspaceDescription:
+        "Gestiona el acceso del equipo y los recursos compartidos de Dispatch.",
+      openTeamSettings: "Abrir ajustes del equipo",
+      openResourceSettings: "Abrir ajustes de recursos",
+      agentTitle: "Ajustes del agente",
+      agentDescription:
+        "Abre los ajustes del agente en la barra lateral para modelos, claves API, automatizaciones, voz y otros controles.",
+      openAgentSettings: "Abrir ajustes del agente",
+    },
+  }),
+  "fr-FR": mergeMessages({
+    root: {
+      commandActions: "Actions",
+      commandSearch: "Rechercher",
+      commandAppearance: "Apparence",
+      toggleTheme: "Changer de thème",
+    },
+    settings: {
+      title: "Paramètres",
+      description:
+        "Préférences de langue, d’espace de travail, de ressources et d’agent.",
+      languageTitle: "Langue",
+      languageDescription:
+        "Choisissez la langue de l’interface. Cette préférence est enregistrée dans votre compte.",
+      languageLabel: "Langue de l’interface",
+      workspaceTitle: "Espace de travail",
+      workspaceDescription:
+        "Gérez l’accès de l’équipe et les ressources partagées de Dispatch.",
+      openTeamSettings: "Ouvrir les paramètres d’équipe",
+      openResourceSettings: "Ouvrir les paramètres des ressources",
+      agentTitle: "Paramètres de l’agent",
+      agentDescription:
+        "Ouvrez les paramètres de l’agent dans la barre latérale pour les modèles, clés API, automatisations, voix et autres contrôles.",
+      openAgentSettings: "Ouvrir les paramètres de l’agent",
+    },
+  }),
+  "de-DE": mergeMessages({
+    root: {
+      commandActions: "Aktionen",
+      commandSearch: "Suchen",
+      commandAppearance: "Darstellung",
+      toggleTheme: "Theme wechseln",
+    },
+    settings: {
+      title: "Einstellungen",
+      description:
+        "Sprach-, Arbeitsbereichs-, Ressourcen- und Agent-Einstellungen.",
+      languageTitle: "Sprache",
+      languageDescription:
+        "Wähle die Sprache der Oberfläche. Diese Einstellung wird in deinem Konto gespeichert.",
+      languageLabel: "Oberflächensprache",
+      workspaceTitle: "Arbeitsbereich",
+      workspaceDescription:
+        "Verwalte Teamzugriff und gemeinsam genutzte Dispatch-Ressourcen.",
+      openTeamSettings: "Teameinstellungen öffnen",
+      openResourceSettings: "Ressourceneinstellungen öffnen",
+      agentTitle: "Agent-Einstellungen",
+      agentDescription:
+        "Öffne die Agent-Einstellungen in der Seitenleiste für Modell, API-Schlüssel, Automatisierungen, Sprache und weitere Steuerungen.",
+      openAgentSettings: "Agent-Einstellungen öffnen",
+    },
+  }),
+  "ja-JP": mergeMessages({
+    root: {
+      commandActions: "操作",
+      commandSearch: "検索",
+      commandAppearance: "外観",
+      toggleTheme: "テーマを切り替え",
+    },
+    settings: {
+      title: "設定",
+      description: "言語、ワークスペース、リソース、エージェント設定。",
+      languageTitle: "言語",
+      languageDescription:
+        "インターフェース言語を選択します。この設定はアカウントに保存されます。",
+      languageLabel: "インターフェース言語",
+      workspaceTitle: "ワークスペース",
+      workspaceDescription:
+        "Dispatch のチームアクセスと共有ワークスペースリソースを管理します。",
+      openTeamSettings: "チーム設定を開く",
+      openResourceSettings: "リソース設定を開く",
+      agentTitle: "エージェント設定",
+      agentDescription:
+        "右サイドバーのエージェント設定を開き、モデル、API キー、自動化、音声などを管理します。",
+      openAgentSettings: "エージェント設定を開く",
+    },
+  }),
+  "ko-KR": mergeMessages({
+    root: {
+      commandActions: "작업",
+      commandSearch: "검색",
+      commandAppearance: "모양",
+      toggleTheme: "테마 전환",
+    },
+    settings: {
+      title: "설정",
+      description: "언어, 워크스페이스, 리소스 및 에이전트 환경설정입니다.",
+      languageTitle: "언어",
+      languageDescription:
+        "인터페이스 언어를 선택하세요. 이 기본 설정은 계정에 저장됩니다.",
+      languageLabel: "인터페이스 언어",
+      workspaceTitle: "워크스페이스",
+      workspaceDescription:
+        "Dispatch의 팀 접근 권한과 공유 워크스페이스 리소스를 관리합니다.",
+      openTeamSettings: "팀 설정 열기",
+      openResourceSettings: "리소스 설정 열기",
+      agentTitle: "에이전트 설정",
+      agentDescription:
+        "오른쪽 사이드바의 에이전트 설정을 열어 모델, API 키, 자동화, 음성 및 기타 제어를 관리합니다.",
+      openAgentSettings: "에이전트 설정 열기",
+    },
+  }),
+  "pt-BR": mergeMessages({
+    root: {
+      commandActions: "Ações",
+      commandSearch: "Buscar",
+      commandAppearance: "Aparência",
+      toggleTheme: "Alternar tema",
+    },
+    settings: {
+      title: "Configurações",
+      description:
+        "Preferências de idioma, espaço de trabalho, recursos e agente.",
+      languageTitle: "Idioma",
+      languageDescription:
+        "Escolha o idioma da interface. Essa preferência é salva na sua conta.",
+      languageLabel: "Idioma da interface",
+      workspaceTitle: "Espaço de trabalho",
+      workspaceDescription:
+        "Gerencie acesso da equipe e recursos compartilhados do Dispatch.",
+      openTeamSettings: "Abrir configurações da equipe",
+      openResourceSettings: "Abrir configurações de recursos",
+      agentTitle: "Configurações do agente",
+      agentDescription:
+        "Abra as configurações do agente na barra lateral para modelos, chaves de API, automações, voz e outros controles.",
+      openAgentSettings: "Abrir configurações do agente",
+    },
+  }),
+  "hi-IN": mergeMessages({
+    root: {
+      commandActions: "क्रियाएं",
+      commandSearch: "खोजें",
+      commandAppearance: "रूप",
+      toggleTheme: "थीम बदलें",
+    },
+    settings: {
+      title: "सेटिंग्स",
+      description: "भाषा, कार्यस्थान, संसाधन और एजेंट प्राथमिकताएं।",
+      languageTitle: "भाषा",
+      languageDescription:
+        "इंटरफ़ेस भाषा चुनें। यह पसंद आपके खाते में सहेजी जाती है।",
+      languageLabel: "इंटरफ़ेस भाषा",
+      workspaceTitle: "कार्यस्थान",
+      workspaceDescription:
+        "Dispatch के लिए टीम पहुंच और साझा कार्यस्थान संसाधनों को प्रबंधित करें।",
+      openTeamSettings: "टीम सेटिंग्स खोलें",
+      openResourceSettings: "संसाधन सेटिंग्स खोलें",
+      agentTitle: "एजेंट सेटिंग्स",
+      agentDescription:
+        "मॉडल, API कुंजियों, ऑटोमेशन, आवाज़ और अन्य एजेंट नियंत्रणों के लिए साइडबार सेटिंग्स खोलें।",
+      openAgentSettings: "एजेंट सेटिंग्स खोलें",
+    },
+  }),
+  "ar-SA": mergeMessages({
+    root: {
+      commandActions: "الإجراءات",
+      commandSearch: "بحث",
+      commandAppearance: "المظهر",
+      toggleTheme: "تبديل السمة",
+    },
+    settings: {
+      title: "الإعدادات",
+      description: "تفضيلات اللغة ومساحة العمل والموارد والوكيل.",
+      languageTitle: "اللغة",
+      languageDescription: "اختر لغة الواجهة. يتم حفظ هذا التفضيل في حسابك.",
+      languageLabel: "لغة الواجهة",
+      workspaceTitle: "مساحة العمل",
+      workspaceDescription:
+        "إدارة وصول الفريق وموارد مساحة العمل المشتركة في Dispatch.",
+      openTeamSettings: "فتح إعدادات الفريق",
+      openResourceSettings: "فتح إعدادات الموارد",
+      agentTitle: "إعدادات الوكيل",
+      agentDescription:
+        "افتح إعدادات الوكيل في الشريط الجانبي لإدارة النموذج ومفاتيح API والأتمتة والصوت وعناصر التحكم الأخرى.",
+      openAgentSettings: "فتح إعدادات الوكيل",
+    },
+  }),
+} satisfies Record<LocaleCode, Messages>;

package/corpus/templates/dispatch/app/root.tsx

@@ -14,10 +14,12 @@ import {
   CommandMenu,
   configureTracking,
   createAgentNativeQueryClient,
+  getLocaleInitScript,
   getThemeInitScript,
   useCommandMenuShortcut,
   useDbSync,
   appPath,
+  useT,
 } from "@agent-native/core/client";
 import { useQueryClient } from "@tanstack/react-query";
 import { IconSun, IconMoon } from "@tabler/icons-react";
@@ -27,6 +29,7 @@ import type { LinksFunction } from "react-router";
 import { dispatchExtensions } from "./dispatch-extensions";
 import changelog from "../CHANGELOG.md?raw";
 import stylesheet from "./global.css?url";
+import { i18nCatalog } from "./i18n";
 
 configureTracking({
   getDefaultProps: (_name, properties) => ({
@@ -40,6 +43,7 @@ export const links: LinksFunction = () => [
 ];
 
 const THEME_INIT_SCRIPT = getThemeInitScript();
+const LOCALE_INIT_SCRIPT = getLocaleInitScript();
 
 export function Layout({ children }: { children: React.ReactNode }) {
   return (
@@ -54,6 +58,11 @@ export function Layout({ children }: { children: React.ReactNode }) {
           suppressHydrationWarning
           dangerouslySetInnerHTML={{ __html: THEME_INIT_SCRIPT }}
         />
+        <script
+          data-agent-native-locale-init
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{ __html: LOCALE_INIT_SCRIPT }}
+        />
         <link rel="manifest" href={appPath("/manifest.json")} />
         <meta name="theme-color" content="#0f172a" />
         <meta name="mobile-web-app-capable" content="yes" />
@@ -149,6 +158,7 @@ function useThreadDeepLink() {
 
 function ThemeToggleItem() {
   const { resolvedTheme, setTheme } = useTheme();
+  const t = useT();
   const isDark = resolvedTheme === "dark";
   return (
     <CommandMenu.Item
@@ -156,13 +166,14 @@ function ThemeToggleItem() {
       keywords={["theme", "dark", "light", "mode"]}
     >
       {isDark ? <IconSun size={16} /> : <IconMoon size={16} />}
-      Toggle theme
+      {t("root.toggleTheme")}
     </CommandMenu.Item>
   );
 }
 
 function AppContent() {
   const [cmdkOpen, setCmdkOpen] = useState(false);
+  const t = useT();
   useCommandMenuShortcut(useCallback(() => setCmdkOpen(true), []));
   return (
     <>
@@ -173,10 +184,12 @@ function AppContent() {
         changelog={changelog}
         changelogKey="dispatch"
       >
-        <CommandMenu.Group heading="Actions">
-          <CommandMenu.Item onSelect={() => {}}>Search</CommandMenu.Item>
+        <CommandMenu.Group heading={t("root.commandActions")}>
+          <CommandMenu.Item onSelect={() => {}}>
+            {t("root.commandSearch")}
+          </CommandMenu.Item>
         </CommandMenu.Group>
-        <CommandMenu.Group heading="Appearance">
+        <CommandMenu.Group heading={t("root.commandAppearance")}>
           <ThemeToggleItem />
         </CommandMenu.Group>
       </CommandMenu>
@@ -193,6 +206,7 @@ export default function Root() {
     <AppProviders
       queryClient={queryClient}
       toaster={<Toaster richColors position="bottom-left" closeButton />}
+      i18n={{ catalog: i18nCatalog }}
     >
       <AppContent />
     </AppProviders>

package/corpus/templates/dispatch/app/routes/settings.tsx

@@ -0,0 +1,86 @@
+import { Link } from "react-router";
+import {
+  ChangelogSettingsCard,
+  LanguagePicker,
+  openAgentSettings,
+  useT,
+} from "@agent-native/core/client";
+import { Button } from "@agent-native/dispatch/components/ui/button";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@agent-native/dispatch/components/ui/card";
+import { Label } from "@agent-native/dispatch/components/ui/label";
+import changelog from "../../CHANGELOG.md?raw";
+
+export function meta() {
+  return [{ title: "Settings - Dispatch" }];
+}
+
+export default function SettingsRoute() {
+  const t = useT();
+
+  return (
+    <main className="mx-auto w-full max-w-3xl space-y-6 px-4 py-6 sm:px-6 sm:py-10">
+      <div className="space-y-1">
+        <h1 className="text-2xl font-semibold tracking-tight">
+          {t("settings.title")}
+        </h1>
+        <p className="text-sm leading-6 text-muted-foreground">
+          {t("settings.description")}
+        </p>
+      </div>
+
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base">
+            {t("settings.languageTitle")}
+          </CardTitle>
+          <CardDescription>{t("settings.languageDescription")}</CardDescription>
+        </CardHeader>
+        <CardContent className="max-w-xs space-y-1.5">
+          <Label>{t("settings.languageLabel")}</Label>
+          <LanguagePicker label={t("settings.languageLabel")} />
+        </CardContent>
+      </Card>
+
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base">
+            {t("settings.workspaceTitle")}
+          </CardTitle>
+          <CardDescription>
+            {t("settings.workspaceDescription")}
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="flex flex-wrap gap-2">
+          <Button variant="outline" asChild>
+            <Link to="/team">{t("settings.openTeamSettings")}</Link>
+          </Button>
+          <Button variant="outline" asChild>
+            <Link to="/workspace">{t("settings.openResourceSettings")}</Link>
+          </Button>
+        </CardContent>
+      </Card>
+
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base">
+            {t("settings.agentTitle")}
+          </CardTitle>
+          <CardDescription>{t("settings.agentDescription")}</CardDescription>
+        </CardHeader>
+        <CardContent>
+          <Button variant="outline" onClick={() => openAgentSettings()}>
+            {t("settings.openAgentSettings")}
+          </Button>
+        </CardContent>
+      </Card>
+
+      <ChangelogSettingsCard markdown={changelog} />
+    </main>
+  );
+}

package/corpus/templates/dispatch/changelog/2026-06-24-a-new-settings-page-gives-quick-access-to-language-workspace.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-24
+---
+
+A new Settings page gives quick access to language, workspace, and agent preferences.

package/corpus/templates/dispatch/changelog/2026-06-24-added-a-language-picker-and-localized-app-chrome-for-support.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-06-24
+---
+
+Added a language picker and localized app chrome for supported languages.

package/corpus/templates/forms/.agents/skills/self-modifying-code/SKILL.md

@@ -66,6 +66,11 @@ el.dataset.selectedId = selectedItem?.id || "";
 
 **Use configuration-driven rendering** — Extract visual decisions (colors, layouts, sizes) into JSON config files in `data/`. The agent can modify the config (Tier 1) instead of the component source (Tier 2).
 
+**Keep localized copy in catalogs** — When editing visible UI copy, labels,
+toasts, empty states, prompts, or formatting, read `internationalization` and
+update `app/i18n/en-US.ts` plus existing locale catalogs instead of leaving new
+inline strings in components.
+
 ## Don't
 
 - Don't modify `.env` files or files containing secrets
@@ -80,3 +85,4 @@ el.dataset.selectedId = selectedItem?.id || "";
 - **actions** — The agent can create or modify actions to add new capabilities
 - **delegate-to-agent** — Self-modification requests come through the agent chat
 - **real-time-sync** — Database writes trigger change events to update the UI
+- **internationalization** — UI copy, language catalogs, locale switching, and RTL-safe edits

package/corpus/templates/forms/app/components/layout/Header.tsx

@@ -1,41 +1,48 @@
 import { useLocation } from "react-router";
 import { useHeaderTitle, useHeaderActions } from "./HeaderActions";
-import { AgentToggleButton } from "@agent-native/core/client";
+import {
+  AgentToggleButton,
+  LanguagePicker,
+  useT,
+} from "@agent-native/core/client";
 
 const pageTitles: Record<string, string> = {
-  "/": "Forms",
-  "/forms": "Forms",
-  "/team": "Team",
+  "/": "header.forms",
+  "/forms": "header.forms",
+  "/settings": "header.settings",
+  "/team": "header.team",
 };
 
 function resolveTitle(pathname: string): string {
   if (pageTitles[pathname]) return pageTitles[pathname];
 
   if (pathname.startsWith("/forms/") && pathname.endsWith("/responses")) {
-    return "Responses";
+    return "header.responses";
   }
-  if (pathname.startsWith("/forms/")) return "Form";
-  if (pathname.startsWith("/extensions")) return "Extensions";
+  if (pathname.startsWith("/forms/")) return "header.form";
+  if (pathname.startsWith("/extensions")) return "header.extensions";
 
-  return "Forms";
+  return "header.forms";
 }
 
 export function Header() {
   const location = useLocation();
   const title = useHeaderTitle();
   const actions = useHeaderActions();
+  const t = useT();
 
   return (
     <header className="flex h-12 items-center gap-3 border-b border-border bg-background px-4 lg:px-6 shrink-0">
       <div className="flex items-center gap-3 flex-1 min-w-0">
         {title ?? (
           <h1 className="text-lg font-semibold tracking-tight truncate">
-            {resolveTitle(location.pathname)}
+            {t(resolveTitle(location.pathname))}
           </h1>
         )}
       </div>
       <div className="flex items-center gap-2 shrink-0">
         {actions}
+        <LanguagePicker variant="icon" />
         <AgentToggleButton />
       </div>
     </header>

package/corpus/templates/forms/app/components/layout/Layout.tsx

@@ -8,6 +8,7 @@ import {
   focusAgentChat,
   navigateWithAgentChatViewTransition,
   useAgentChatHomeHandoff,
+  useT,
 } from "@agent-native/core/client";
 import { InvitationBanner } from "@agent-native/core/client/org";
 import { TAB_ID } from "@/lib/tab-id";
@@ -26,6 +27,7 @@ interface LayoutProps {
 export function Layout({ children }: LayoutProps) {
   const location = useLocation();
   const navigate = useNavigate();
+  const t = useT();
   const chatHomeHandoffActive = useAgentChatHomeHandoff({
     storageKey: "forms",
     activePath: location.pathname,
@@ -70,11 +72,11 @@ export function Layout({ children }: LayoutProps) {
           browserTabId={TAB_ID}
           openOnChatRunning={chatHomeHandoffActive}
           onFullscreenRequest={openAskAgentFullscreen}
-          emptyStateText="Ask me anything about your forms"
+          emptyStateText={t("agent.emptyState")}
           suggestions={[
-            "Build a customer feedback survey",
-            "Show submissions by day",
-            "Export responses to CSV",
+            t("agent.suggestionSurvey"),
+            t("agent.suggestionSubmissions"),
+            t("agent.suggestionExport"),
           ]}
           scope={sidebarScope}
         >