@agent-native/core 0.117.0 → 0.117.2

package/corpus/core/src/server/email.ts

@@ -10,7 +10,10 @@
  * so the reset-password flow still works end-to-end for local development.
  */
 
+import { readFileSync } from "node:fs";
+
 import { resolveSecret } from "./credential-provider.js";
+import { AGENT_NATIVE_EMAIL_LOGO_CONTENT_ID } from "./email-template.js";
 
 export type EmailProvider = "resend" | "sendgrid" | "dev";
 
@@ -35,6 +38,38 @@ export interface SendEmailArgs {
   attachments?: EmailAttachment[];
 }
 
+let cachedAgentNativeLogo: Buffer | undefined;
+
+function getAgentNativeLogoAttachment(): EmailAttachment {
+  cachedAgentNativeLogo ??= readFileSync(
+    new URL("../../src/assets/branding/favicon.png", import.meta.url),
+  );
+  return {
+    filename: "agent-native-logo.png",
+    content: cachedAgentNativeLogo,
+    contentType: "image/png",
+    contentId: AGENT_NATIVE_EMAIL_LOGO_CONTENT_ID,
+    disposition: "inline",
+  };
+}
+
+function resolveAttachments(
+  args: SendEmailArgs,
+): EmailAttachment[] | undefined {
+  if (!args.html.includes(`cid:${AGENT_NATIVE_EMAIL_LOGO_CONTENT_ID}`)) {
+    return args.attachments;
+  }
+  if (
+    args.attachments?.some(
+      (attachment) =>
+        attachment.contentId === AGENT_NATIVE_EMAIL_LOGO_CONTENT_ID,
+    )
+  ) {
+    return args.attachments;
+  }
+  return [...(args.attachments ?? []), getAgentNativeLogoAttachment()];
+}
+
 interface EmailTransportConfig {
   provider: EmailProvider;
   resendApiKey?: string;
@@ -94,6 +129,7 @@ export async function sendEmail(args: SendEmailArgs): Promise<void> {
   const config = await resolveEmailTransport();
   const provider = config.provider;
   const from = getFromAddress(config, args.from);
+  const attachments = resolveAttachments(args);
 
   if (provider === "resend") {
     const payload: Record<string, unknown> = {
@@ -105,8 +141,8 @@ export async function sendEmail(args: SendEmailArgs): Promise<void> {
     };
     if (args.cc) payload.cc = Array.isArray(args.cc) ? args.cc : [args.cc];
     if (args.replyTo) payload.reply_to = args.replyTo;
-    if (args.attachments?.length) {
-      payload.attachments = args.attachments.map((a) => ({
+    if (attachments?.length) {
+      payload.attachments = attachments.map((a) => ({
         filename: a.filename,
         content:
           typeof a.content === "string"
@@ -159,8 +195,8 @@ export async function sendEmail(args: SendEmailArgs): Promise<void> {
     if (args.inReplyTo) sgHeaders["In-Reply-To"] = args.inReplyTo;
     if (args.references) sgHeaders["References"] = args.references;
     if (Object.keys(sgHeaders).length) sgPayload.headers = sgHeaders;
-    if (args.attachments?.length) {
-      sgPayload.attachments = args.attachments.map((a) => ({
+    if (attachments?.length) {
+      sgPayload.attachments = attachments.map((a) => ({
         filename: a.filename,
         content:
           typeof a.content === "string"

package/corpus/core/src/sharing/actions/share-resource.ts

@@ -299,6 +299,7 @@ export default defineAction({
           process.env.APP_NAME || process.env.VITE_APP_NAME || "Agent Native";
         const subject = `${actor} shared "${resourceTitle}" with you on ${appName}`;
         const { html, text } = renderEmail({
+          brandName: appName,
           preheader: subject,
           heading: "You've been given access",
           paragraphs: [

package/corpus/core/src/templates/default/.agents/skills/agent-native-toolkit/SKILL.md

@@ -59,6 +59,12 @@ quick controls and deep links such as:
 - `/settings/usage`
 - `/settings/apps/:appId`
 
+The shared Account section is the canonical profile surface at
+`/settings#account`. It owns the editable display name and existing avatar
+control through the authenticated `get-user-profile` and `update-user-profile`
+actions. Shared workspace chrome such as `OrgSwitcher` should link to this
+surface rather than creating an app-local profile page.
+
 When adding a new API key, OAuth grant, provider connection, model selector, app
 preference, notification preference, or usage/billing surface, register it as a
 settings tab or app settings panel first. Only add sidebar UI when it is needed

package/corpus/core/src/templates/default/app/global.css

@@ -52,7 +52,7 @@
   --muted-foreground: 0 0% 60%;
   --accent: 0 0% 18%;
   --accent-foreground: 0 0% 90%;
-  --destructive: 0 63% 51%;
+  --destructive: 0 84% 60%;
   --destructive-foreground: 0 0% 98%;
   --border: 0 0% 24%;
   --input: 0 0% 24%;

package/corpus/core/src/templates/default/app/i18n/ar-SA.ts

@@ -359,24 +359,24 @@ const messages = {
     hideEveryone: "إخفاء من الجميع",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "هل تريد أرشفة {{name}}؟",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "يؤدي هذا إلى إخفائه من قائمة الإضافات الخاصة بك دون حذفه لأي شخص آخر.",
     removeEverywhereDescription:
-      "يؤدي هذا إلى إزالته في كل مكان تتم مشاركته فيه.",
+      "يؤدي هذا إلى أرشفته في كل مكان تتم مشاركته فيه.",
     cancel: "إلغاء",
     remove: "إزالة",
     removing: "جارٍ الإزالة...",
-    delete: "حذف",
-    deleting: "جار الحذف...",
+    delete: "أرشفة",
+    deleting: "جارٍ الأرشفة...",
     openFullView: "فتح عرض كامل",
     removeFromWidgetArea: "إزالة من منطقة القطعة هذه",
-    deleteExtensionEllipsis: "حذف الامتداد...",
+    deleteExtensionEllipsis: "أرشفة الامتداد...",
     removeFromMyListEllipsis: "إزالة من قائمتي...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "يؤدي هذا إلى إزالة الامتداد في كل مكان، لكل شخص تمت مشاركته معه.",
+      "يؤدي هذا إلى أرشفة الامتداد في كل مكان، لكل شخص تمت مشاركته معه.",
     addWidget: "إضافة القطعة",
     loading: "جار التحميل...",
     noWidgetsAvailable: "لا توجد أدوات متاحة لهذه الفتحة حتى الآن.",

package/corpus/core/src/templates/default/app/i18n/de-DE.ts

@@ -352,24 +352,24 @@ const messages = {
     hideEveryone: "Versteck dich vor allen",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "{{name}} archivieren?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "Dadurch wird es aus Ihrer Erweiterungsliste ausgeblendet, ohne dass es für andere gelöscht wird.",
     removeEverywhereDescription:
-      "Dadurch wird es überall dort entfernt, wo es geteilt wird.",
+      "Dadurch wird es überall dort archiviert, wo es geteilt wird.",
     cancel: "Abbrechen",
     remove: "Entfernen",
     removing: "Entfernen...",
-    delete: "Löschen",
-    deleting: "Wird gelöscht...",
+    delete: "Archivieren",
+    deleting: "Wird archiviert...",
     openFullView: "Vollansicht öffnen",
     removeFromWidgetArea: "Aus diesem Widget-Bereich entfernen",
-    deleteExtensionEllipsis: "Erweiterung löschen...",
+    deleteExtensionEllipsis: "Erweiterung archivieren...",
     removeFromMyListEllipsis: "Von meiner Liste entfernen...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "Dadurch wird die Erweiterung überall und für alle entfernt, mit denen sie geteilt wird.",
+      "Dadurch wird die Erweiterung überall und für alle archiviert, mit denen sie geteilt wird.",
     addWidget: "Widget hinzufügen",
     loading: "Wird geladen...",
     noWidgetsAvailable: "Für diesen Slot sind noch keine Widgets verfügbar.",

package/corpus/core/src/templates/default/app/i18n/en-US.ts

@@ -344,23 +344,23 @@ const messages = {
     hideEveryone: "Hide from everyone",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "Archive {{name}}?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "This hides it from your Extensions list without deleting it for anyone else.",
-    removeEverywhereDescription: "This removes it everywhere it is shared.",
+    removeEverywhereDescription: "This archives it everywhere it is shared.",
     cancel: "Cancel",
     remove: "Remove",
     removing: "Removing...",
-    delete: "Delete",
-    deleting: "Deleting...",
+    delete: "Archive",
+    deleting: "Archiving...",
     openFullView: "Open full view",
     removeFromWidgetArea: "Remove from this widget area",
-    deleteExtensionEllipsis: "Delete extension...",
+    deleteExtensionEllipsis: "Archive extension...",
     removeFromMyListEllipsis: "Remove from my list...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "This removes the extension everywhere, for everyone it's shared with.",
+      "This archives the extension everywhere, for everyone it's shared with.",
     addWidget: "Add widget",
     loading: "Loading...",
     noWidgetsAvailable: "No widgets available for this slot yet.",

package/corpus/core/src/templates/default/app/i18n/es-ES.ts

@@ -355,24 +355,24 @@ const messages = {
     hideEveryone: "esconderse de todos",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "¿Archivar {{name}}?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "Esto lo oculta de su lista de Extensiones sin eliminarlo para nadie más.",
     removeEverywhereDescription:
-      "Esto lo elimina en todos los lugares donde se comparte.",
+      "Esto lo archiva en todos los lugares donde se comparte.",
     cancel: "Cancelar",
     remove: "Eliminar",
     removing: "Eliminando...",
-    delete: "Eliminar",
-    deleting: "Eliminando...",
+    delete: "Archivar",
+    deleting: "Archivando...",
     openFullView: "Abrir vista completa",
     removeFromWidgetArea: "Eliminar de esta área de widgets",
-    deleteExtensionEllipsis: "Eliminar extensión...",
+    deleteExtensionEllipsis: "Archivar extensión...",
     removeFromMyListEllipsis: "Quitar de mi lista...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "Esto elimina la extensión en todas partes, para todas las personas con las que se comparte.",
+      "Esto archiva la extensión en todas partes, para todas las personas con las que se comparte.",
     addWidget: "Agregar widget",
     loading: "Cargando...",
     noWidgetsAvailable:

package/corpus/core/src/templates/default/app/i18n/fr-FR.ts

@@ -355,23 +355,23 @@ const messages = {
     hideEveryone: "Cacher de tout le monde",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "Archiver {{name}} ?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "Cela le masque de votre liste d'extensions sans le supprimer pour quelqu'un d'autre.",
-    removeEverywhereDescription: "Cela le supprime partout où il est partagé.",
+    removeEverywhereDescription: "Cela l’archive partout où il est partagé.",
     cancel: "Annuler",
     remove: "Retirer",
     removing: "Suppression...",
-    delete: "Supprimer",
-    deleting: "Suppression...",
+    delete: "Archiver",
+    deleting: "Archivage...",
     openFullView: "Ouvrir la vue complète",
     removeFromWidgetArea: "Supprimer de cette zone de widget",
-    deleteExtensionEllipsis: "Supprimer l'extension...",
+    deleteExtensionEllipsis: "Archiver l'extension...",
     removeFromMyListEllipsis: "Supprimer de ma liste...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "Cela supprime l'extension partout, pour toutes les personnes avec lesquelles elle est partagée.",
+      "Cela archive l'extension partout, pour toutes les personnes avec lesquelles elle est partagée.",
     addWidget: "Ajouter un widget",
     loading: "Chargement...",
     noWidgetsAvailable:

package/corpus/core/src/templates/default/app/i18n/hi-IN.ts

@@ -338,24 +338,24 @@ const messages = {
     hideEveryone: "सबसे छुपाओ",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "{{name}} को संग्रहित करें?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "यह इसे किसी अन्य के लिए हटाए बिना आपकी एक्सटेंशन सूची से छिपा देता है।",
     removeEverywhereDescription:
-      "यह इसे हर जगह से हटा देता है जहां इसे साझा किया गया है।",
+      "यह इसे साझा किए गए हर स्थान पर संग्रहित कर देता है।",
     cancel: "रद्द करें",
     remove: "हटाएं",
     removing: "हटाया जा रहा है...",
-    delete: "हटाएं",
-    deleting: "हटाया जा रहा है...",
+    delete: "संग्रहित करें",
+    deleting: "संग्रहित किया जा रहा है...",
     openFullView: "पूरा दृश्य खोलें",
     removeFromWidgetArea: "इस विजेट क्षेत्र से हटाएँ",
-    deleteExtensionEllipsis: "एक्सटेंशन हटाएं...",
+    deleteExtensionEllipsis: "एक्सटेंशन संग्रहित करें...",
     removeFromMyListEllipsis: "मेरी सूची से हटाएं...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "यह एक्सटेंशन को हर जगह से हटा देता है, उन सभी के लिए जिनके साथ इसे साझा किया गया है।",
+      "यह एक्सटेंशन को साझा किए गए हर स्थान पर, सभी लोगों के लिए संग्रहित कर देता है।",
     addWidget: "विजेट जोड़ें",
     loading: "लोड हो रहा है...",
     noWidgetsAvailable: "इस स्लॉट के लिए अभी तक कोई विजेट उपलब्ध नहीं है।",

package/corpus/core/src/templates/default/app/i18n/ja-JP.ts

@@ -344,24 +344,24 @@ const messages = {
     hideEveryone: "みんなから隠れて",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "{{name}}をアーカイブしますか？",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "これにより、他のユーザーが削除することなく、拡張機能リストから非表示になります。",
     removeEverywhereDescription:
-      "これにより、共有されているすべての場所で削除されます。",
+      "これにより、共有されているすべての場所でアーカイブされます。",
     cancel: "キャンセル",
     remove: "削除",
     removing: "削除中...",
-    delete: "削除",
-    deleting: "削除中...",
+    delete: "アーカイブ",
+    deleting: "アーカイブ中...",
     openFullView: "フルビューを開く",
     removeFromWidgetArea: "このウィジェット領域から削除する",
-    deleteExtensionEllipsis: "拡張機能を削除...",
+    deleteExtensionEllipsis: "拡張機能をアーカイブ...",
     removeFromMyListEllipsis: "リストから削除...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "これにより、共有されているすべてのユーザーの拡張機能がどこからでも削除されます。",
+      "これにより、共有されているすべてのユーザーの拡張機能がどこからでもアーカイブされます。",
     addWidget: "ウィジェットを追加する",
     loading: "読み込み中...",
     noWidgetsAvailable:

package/corpus/core/src/templates/default/app/i18n/ko-KR.ts

@@ -337,24 +337,24 @@ const messages = {
     hideEveryone: "모든 사람에게서 숨기기",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "{{name}}을(를) 보관할까요?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "이렇게 하면 다른 사람을 위해 삭제하지 않고 확장 프로그램 목록에서 숨겨집니다.",
     removeEverywhereDescription:
-      "이렇게 하면 공유된 모든 위치에서 해당 항목이 제거됩니다.",
+      "이렇게 하면 공유된 모든 위치에서 해당 항목이 보관됩니다.",
     cancel: "취소",
     remove: "제거",
     removing: "삭제 중...",
-    delete: "삭제",
-    deleting: "삭제 중...",
+    delete: "보관",
+    deleting: "보관 중...",
     openFullView: "전체 보기 열기",
     removeFromWidgetArea: "이 위젯 영역에서 제거",
-    deleteExtensionEllipsis: "확장 프로그램 삭제...",
+    deleteExtensionEllipsis: "확장 프로그램 보관...",
     removeFromMyListEllipsis: "내 목록에서 제거...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "이렇게 하면 확장 프로그램을 공유하는 모든 사람의 모든 위치에서 확장 프로그램이 제거됩니다.",
+      "이렇게 하면 확장 프로그램을 공유하는 모든 사람의 모든 위치에서 확장 프로그램이 보관됩니다.",
     addWidget: "위젯 추가",
     loading: "로드 중...",
     noWidgetsAvailable: "이 슬롯에는 아직 사용할 수 있는 위젯이 없습니다.",

package/corpus/core/src/templates/default/app/i18n/pt-BR.ts

@@ -353,24 +353,24 @@ const messages = {
     hideEveryone: "Esconda-se de todos",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "Arquivar {{name}}?",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "Isso o oculta da sua lista de extensões sem excluí-lo para mais ninguém.",
     removeEverywhereDescription:
-      "Isso o remove em todos os lugares em que é compartilhado.",
+      "Isso o arquiva em todos os lugares em que é compartilhado.",
     cancel: "Cancelar",
     remove: "Remover",
     removing: "Removendo...",
-    delete: "Excluir",
-    deleting: "Excluindo...",
+    delete: "Arquivar",
+    deleting: "Arquivando...",
     openFullView: "Abrir visualização completa",
     removeFromWidgetArea: "Remover desta área de widget",
-    deleteExtensionEllipsis: "Excluir extensão...",
+    deleteExtensionEllipsis: "Arquivar extensão...",
     removeFromMyListEllipsis: "Remover da minha lista...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
     deleteEverywhereConfirmation:
-      "Isso remove a extensão de todos os lugares, para todas as pessoas com quem ela é compartilhada.",
+      "Isso arquiva a extensão em todos os lugares, para todas as pessoas com quem ela é compartilhada.",
     addWidget: "Adicionar widget",
     loading: "Carregando...",
     noWidgetsAvailable: "Ainda não há widgets disponíveis para este slot.",

package/corpus/core/src/templates/default/app/i18n/zh-CN.ts

@@ -330,22 +330,22 @@ const messages = {
     hideEveryone: "向所有人隐藏",
     localFileDescription:
       "This extension is backed by {{entryPath}}. Edit or remove it from the workspace.",
-    deleteQuestion: "Delete {{name}}?",
+    deleteQuestion: "要归档 {{name}} 吗？",
     removeQuestion: "Remove {{name}}?",
     hideForYouDescription:
       "这会将其从您的扩展列表中隐藏，而不会为其他任何人删除它。",
-    removeEverywhereDescription: "这会在共享的所有地方删除它。",
+    removeEverywhereDescription: "这会在共享的所有地方归档它。",
     cancel: "取消",
     remove: "移除",
-    removing: "正在删除...",
-    delete: "删除",
-    deleting: "正在删除...",
+    removing: "正在移除...",
+    delete: "归档",
+    deleting: "正在归档...",
     openFullView: "打开全视图",
     removeFromWidgetArea: "从此小部件区域中删除",
-    deleteExtensionEllipsis: "删除扩展...",
+    deleteExtensionEllipsis: "归档扩展...",
     removeFromMyListEllipsis: "从我的列表中删除...",
     removeFromWidgetAreaForMe: "Remove from this widget area (for me)",
-    deleteEverywhereConfirmation: "这会删除所有与之共享的每个人的扩展程序。",
+    deleteEverywhereConfirmation: "这会为所有与之共享的人归档该扩展程序。",
     addWidget: "添加小部件",
     loading: "正在加载...",
     noWidgetsAvailable: "此插槽尚无可用的小部件。",

package/corpus/core/src/templates/default/app/i18n/zh-TW.ts

@@ -330,22 +330,22 @@ const messages = {
     hideEveryone: "向所有人隱藏",
     localFileDescription:
       "此擴充功能由 {{entryPath}} 支援。請從工作區編輯或移除它。",
-    deleteQuestion: "要刪除 {{name}} 嗎？",
+    deleteQuestion: "要封存 {{name}} 嗎？",
     removeQuestion: "要移除 {{name}} 嗎？",
     hideForYouDescription:
       "這會將其從您的擴充功能清單中隱藏，而不會為其他任何人刪除它。",
-    removeEverywhereDescription: "這會在共用的所有地方刪除它。",
+    removeEverywhereDescription: "這會在共用的所有地方封存它。",
     cancel: "取消",
     remove: "移除",
-    removing: "正在刪除...",
-    delete: "刪除",
-    deleting: "正在刪除...",
+    removing: "正在移除...",
+    delete: "封存",
+    deleting: "正在封存...",
     openFullView: "開啟全檢視",
     removeFromWidgetArea: "從此小工具區域中刪除",
-    deleteExtensionEllipsis: "刪除擴充功能...",
+    deleteExtensionEllipsis: "封存擴充功能...",
     removeFromMyListEllipsis: "從我的清單中刪除...",
     removeFromWidgetAreaForMe: "從這個小工具區域移除（只套用於我）",
-    deleteEverywhereConfirmation: "這會刪除所有與之共用的每個人的擴充功能。",
+    deleteEverywhereConfirmation: "這會為所有與之共用的人封存該擴充功能。",
     addWidget: "新增小工具",
     loading: "正在載入...",
     noWidgetsAvailable: "此插槽尚無可用的小工具。",

package/corpus/core/src/templates/headless/.agents/skills/agent-native-toolkit/SKILL.md

@@ -59,6 +59,12 @@ quick controls and deep links such as:
 - `/settings/usage`
 - `/settings/apps/:appId`
 
+The shared Account section is the canonical profile surface at
+`/settings#account`. It owns the editable display name and existing avatar
+control through the authenticated `get-user-profile` and `update-user-profile`
+actions. Shared workspace chrome such as `OrgSwitcher` should link to this
+surface rather than creating an app-local profile page.
+
 When adding a new API key, OAuth grant, provider connection, model selector, app
 preference, notification preference, or usage/billing surface, register it as a
 settings tab or app settings panel first. Only add sidebar UI when it is needed

package/corpus/core/src/templates/workspace-core/.agents/skills/agent-native-toolkit/SKILL.md

@@ -59,6 +59,12 @@ quick controls and deep links such as:
 - `/settings/usage`
 - `/settings/apps/:appId`
 
+The shared Account section is the canonical profile surface at
+`/settings#account`. It owns the editable display name and existing avatar
+control through the authenticated `get-user-profile` and `update-user-profile`
+actions. Shared workspace chrome such as `OrgSwitcher` should link to this
+surface rather than creating an app-local profile page.
+
 When adding a new API key, OAuth grant, provider connection, model selector, app
 preference, notification preference, or usage/billing surface, register it as a
 settings tab or app settings panel first. Only add sidebar UI when it is needed

package/corpus/core/src/user-profile/actions/get-user-profile.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import type { UserProfile } from "../shared.js";
+import { getUserProfile } from "../store.js";
+
+export default defineAction({
+  description:
+    "Get the current user's profile, including the display name used across Agent-Native apps.",
+  schema: z.object({}),
+  http: { method: "GET" },
+  run: async (_args, ctx): Promise<UserProfile> => {
+    if (!ctx?.userEmail) throw new Error("Not authenticated.");
+    return getUserProfile(ctx.userEmail);
+  },
+});

package/corpus/core/src/user-profile/actions/update-user-profile.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+
+import { defineAction } from "../../action.js";
+import type { UserProfile } from "../shared.js";
+import { updateUserProfile } from "../store.js";
+
+export default defineAction({
+  description:
+    "Update the current user's display name used across Agent-Native apps. Do not change the user's email address with this action.",
+  schema: z.object({
+    name: z
+      .string()
+      .trim()
+      .min(1)
+      .max(120)
+      .describe(
+        "The display name to use when referring to the signed-in user.",
+      ),
+  }),
+  run: async ({ name }, ctx): Promise<UserProfile> => {
+    if (!ctx?.userEmail) throw new Error("Not authenticated.");
+    return updateUserProfile(ctx.userEmail, name);
+  },
+});

package/corpus/core/src/user-profile/index.ts

@@ -0,0 +1,5 @@
+export {
+  normalizeUserProfileName,
+  USER_PROFILE_SETTING_KEY,
+  type UserProfile,
+} from "./shared.js";

package/corpus/core/src/user-profile/shared.ts

@@ -0,0 +1,14 @@
+export const USER_PROFILE_SETTING_KEY = "user-profile";
+
+export interface UserProfile {
+  email: string;
+  name: string;
+}
+
+export function normalizeUserProfileName(
+  value: string | null | undefined,
+  email: string,
+): string {
+  const name = value?.trim();
+  return name || email;
+}

package/corpus/core/src/user-profile/store.ts

@@ -0,0 +1,50 @@
+import {
+  getBetterAuthInternalAdapter,
+  getBetterAuthSync,
+} from "../server/better-auth-instance.js";
+import { getUserSetting, putUserSetting } from "../settings/user-settings.js";
+import {
+  normalizeUserProfileName,
+  USER_PROFILE_SETTING_KEY,
+  type UserProfile,
+} from "./shared.js";
+
+async function getAuthUser(email: string) {
+  if (!getBetterAuthSync()) return null;
+  const adapter = await getBetterAuthInternalAdapter().catch(() => undefined);
+  if (!adapter) return null;
+  return adapter.findUserByEmail(email, { includeAccounts: false });
+}
+
+export async function getUserProfile(email: string): Promise<UserProfile> {
+  const stored = await getUserSetting(email, USER_PROFILE_SETTING_KEY);
+  const authUser = await getAuthUser(email);
+  const authName = authUser?.user.name;
+  const storedName = typeof stored?.name === "string" ? stored.name : null;
+
+  return {
+    email,
+    name: normalizeUserProfileName(storedName ?? authName, email),
+  };
+}
+
+export async function updateUserProfile(
+  email: string,
+  name: string,
+): Promise<UserProfile> {
+  const normalizedName = normalizeUserProfileName(name, email);
+  const authUser = await getAuthUser(email);
+  const adapter = authUser
+    ? await getBetterAuthInternalAdapter().catch(() => undefined)
+    : undefined;
+
+  if (authUser?.user.id && adapter?.updateUser) {
+    await adapter.updateUser(authUser.user.id, { name: normalizedName });
+  } else {
+    await putUserSetting(email, USER_PROFILE_SETTING_KEY, {
+      name: normalizedName,
+    });
+  }
+
+  return { email, name: normalizedName };
+}

package/corpus/templates/analytics/.agents/skills/agent-native-toolkit/SKILL.md

@@ -59,6 +59,12 @@ quick controls and deep links such as:
 - `/settings/usage`
 - `/settings/apps/:appId`
 
+The shared Account section is the canonical profile surface at
+`/settings#account`. It owns the editable display name and existing avatar
+control through the authenticated `get-user-profile` and `update-user-profile`
+actions. Shared workspace chrome such as `OrgSwitcher` should link to this
+surface rather than creating an app-local profile page.
+
 When adding a new API key, OAuth grant, provider connection, model selector, app
 preference, notification preference, or usage/billing surface, register it as a
 settings tab or app settings panel first. Only add sidebar UI when it is needed

package/corpus/templates/assets/.agents/skills/agent-native-toolkit/SKILL.md

@@ -59,6 +59,12 @@ quick controls and deep links such as:
 - `/settings/usage`
 - `/settings/apps/:appId`
 
+The shared Account section is the canonical profile surface at
+`/settings#account`. It owns the editable display name and existing avatar
+control through the authenticated `get-user-profile` and `update-user-profile`
+actions. Shared workspace chrome such as `OrgSwitcher` should link to this
+surface rather than creating an app-local profile page.
+
 When adding a new API key, OAuth grant, provider connection, model selector, app
 preference, notification preference, or usage/billing surface, register it as a
 settings tab or app settings panel first. Only add sidebar UI when it is needed