v0.8.5

# v0.8.5 — Multi-Language Support & Pi SDK Upgrade

## Features
- **Multi-language support (i18n)** — The entire UI is now localized. Ships with **English**, **Spanish (es)**, **Simplified Chinese (zh-Hans)**, and **Japanese (ja)** — over 1,050 translated strings covering every page, menu, toast, tooltip, and dialog. Switch languages in Settings > Appearance. Session titles and AI responses also follow the selected language.
- **Pi SDK upgrade (0.56.2 → 0.66.1)** — Major upgrade spanning multiple upstream releases. Models like **GLM 5**, **GLM 5.1**, and **Minimax 2.7** should now work thanks to upstream fixes. Also picks up: Bedrock throttling no longer misidentified as context overflow, Anthropic HTTP 413 detection for compaction/retry, Z.ai tool streaming support, OpenAI streaming fixes, and bash output truncation fix. (Fixes #503, addresses #513)

## Improvements
- **Canonical locale registry** — Adding a new language is now a single-file change. The registry auto-derives all language codes, display names, i18n resources, and date-fns locales.
- **Unified language setting** — Removed the duplicate free-text "Language" field from Preferences. The Appearance language dropdown is now the single source of truth for both UI language and AI response language.
- **i18n developer tooling** — Pre-commit hook catches hardcoded English strings in staged `.tsx` files. Locale parity test ensures all translations stay in sync. `localize-agents` skill automates adding new languages.

## Bug Fixes
- **Session messages lost after PC wake** — After sleep/wake, if the server subprocess died, session messages were lost and the content area appeared empty. Fixed with retry logic, lazy-loading fallback, and active session message re-fetch.

## Known Limitations
- **Headless server responses are in English** — When using the WebUI connected to a remote headless server, the UI is fully localized (based on browser language), but the AI agent still responds in English. Session titles are also generated in English. Per-client language support for the headless server will be added in a future release.

## Breaking Changes
- The free-text "Language" field in Preferences has been removed. Use the language dropdown in Settings > Appearance instead. Existing `preferences.json` files with a `language` field are safely ignored.

Author: github-actions[bot]

apps/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-agent/cli",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "license": "Apache-2.0",
   "description": "Terminal client for Craft Agent server",
   "type": "module",

apps/electron/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-agent/electron",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Electron desktop app for Craft Agents",
   "main": "dist/main.cjs",
   "private": true,
@@ -37,8 +37,8 @@
   },
   "dependencies": {
     "@craft-agent/core": "workspace:*",
-    "@craft-agent/shared": "workspace:*",
     "@craft-agent/server-core": "workspace:*",
+    "@craft-agent/shared": "workspace:*",
     "@craft-agent/ui": "workspace:*",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
@@ -56,12 +56,14 @@
     "cmdk": "^1.1.1",
     "electron-log": "^5.4.3",
     "electron-updater": "^6.8.0",
+    "i18next-browser-languagedetector": "^8.2.1",
     "jotai-family": "^1.0.1",
     "motion": "^12.23.26",
     "next-themes": "^0.4.6",
     "react": "^18.3.1",
     "react-day-picker": "^9.13.0",
     "react-dom": "^18.3.1",
+    "react-i18next": "^17.0.2",
     "react-pdf": "^10.3.0",
     "react-simple-code-editor": "^0.14.1",
     "remark": "^15.0.1",

apps/electron/resources/release-notes/0.8.5.md

@@ -0,0 +1,19 @@
+# v0.8.5 — Multi-Language Support & Pi SDK Upgrade
+
+## Features
+- **Multi-language support (i18n)** — The entire UI is now localized. Ships with **English**, **Spanish (es)**, **Simplified Chinese (zh-Hans)**, and **Japanese (ja)** — over 1,050 translated strings covering every page, menu, toast, tooltip, and dialog. Switch languages in Settings > Appearance. Session titles and AI responses also follow the selected language.
+- **Pi SDK upgrade (0.56.2 → 0.66.1)** — Major upgrade spanning multiple upstream releases. Models like **GLM 5**, **GLM 5.1**, and **Minimax 2.7** should now work thanks to upstream fixes. Also picks up: Bedrock throttling no longer misidentified as context overflow, Anthropic HTTP 413 detection for compaction/retry, Z.ai tool streaming support, OpenAI streaming fixes, and bash output truncation fix. (Fixes #503, addresses #513)
+
+## Improvements
+- **Canonical locale registry** — Adding a new language is now a single-file change. The registry auto-derives all language codes, display names, i18n resources, and date-fns locales.
+- **Unified language setting** — Removed the duplicate free-text "Language" field from Preferences. The Appearance language dropdown is now the single source of truth for both UI language and AI response language.
+- **i18n developer tooling** — Pre-commit hook catches hardcoded English strings in staged `.tsx` files. Locale parity test ensures all translations stay in sync. `localize-agents` skill automates adding new languages.
+
+## Bug Fixes
+- **Session messages lost after PC wake** — After sleep/wake, if the server subprocess died, session messages were lost and the content area appeared empty. Fixed with retry logic, lazy-loading fallback, and active session message re-fetch.
+
+## Known Limitations
+- **Headless server responses are in English** — When using the WebUI connected to a remote headless server, the UI is fully localized (based on browser language), but the AI agent still responds in English. Session titles are also generated in English. Per-client language support for the headless server will be added in a future release.
+
+## Breaking Changes
+- The free-text "Language" field in Preferences has been removed. Use the language dropdown in Settings > Appearance instead. Existing `preferences.json` files with a `language` field are safely ignored.

apps/electron/src/main/index.ts

@@ -58,6 +58,10 @@ Sentry.init({
   },
 })
 
+// Initialize i18n for main process (menus, dialogs, etc.)
+import { setupI18n, i18n } from '@craft-agent/shared/i18n'
+setupI18n()
+
 // Set anonymous machine ID for Sentry user tracking (no PII — just a hash).
 // Uses hostname + homedir to produce a stable per-machine identifier.
 const machineId = createHash('sha256').update(hostname() + homedir()).digest('hex').slice(0, 16)
@@ -693,6 +697,13 @@ app.whenReady().then(async () => {
         app.exit(0)
       })
 
+      // Language change: sync from renderer to main process and rebuild native menu
+      ipcMain.handle('i18n:changeLanguage', async (_event, lang: string) => {
+        i18n.changeLanguage(lang)
+        const { rebuildMenu } = await import('./menu')
+        await rebuildMenu()
+      })
+
       ipcMain.on('__get-ws-port', (e) => {
         e.returnValue = instance.port
       })

apps/electron/src/main/menu.ts

@@ -1,4 +1,5 @@
 import { Menu, app, shell, BrowserWindow } from 'electron'
+import { i18n } from '@craft-agent/shared/i18n'
 import { RPC_CHANNELS, type BroadcastEventMap } from '../shared/types'
 import { EDIT_MENU, VIEW_MENU, WINDOW_MENU } from '../shared/menu-schema'
 import type { MenuItem } from '../shared/menu-schema'
@@ -63,13 +64,13 @@ export async function rebuildMenu(): Promise<void> {
   // Build the update menu item based on state
   const updateMenuItem: Electron.MenuItemConstructorOptions = updateReady
     ? {
-        label: `Install Update…\t【${updateInfo.latestVersion}】`,
+        label: i18n.t("menu.installUpdateVersion", { version: updateInfo.latestVersion }),
         click: async () => {
           await installUpdate()
         }
       }
     : {
-        label: 'Check for Updates…',
+        label: i18n.t("menu.checkForUpdatesEllipsis"),
         click: async () => {
           await checkForUpdates({ autoDownload: true })
         }
@@ -80,36 +81,36 @@ export async function rebuildMenu(): Promise<void> {
     ...(isMac ? [{
       label: 'Craft Agents',
       submenu: [
-        { role: 'about' as const, label: 'About Craft Agents' },
+        { role: 'about' as const, label: i18n.t('menu.aboutCraftAgents') },
         updateMenuItem,
         { type: 'separator' as const },
         {
-          label: 'Settings...',
+          label: i18n.t("menu.settings"),
           accelerator: 'CmdOrCtrl+,',
           registerAccelerator: false,  // Action registry handles the keyboard shortcut
           click: () => sendToRenderer(RPC_CHANNELS.menu.OPEN_SETTINGS)
         },
         { type: 'separator' as const },
-        { role: 'hide' as const, label: 'Hide Craft Agents' },
+        { role: 'hide' as const, label: i18n.t('menu.hideCraftAgents') },
         { role: 'hideOthers' as const },
         { role: 'unhide' as const },
         { type: 'separator' as const },
-        { role: 'quit' as const, label: 'Quit Craft Agents' }
+        { role: 'quit' as const, label: i18n.t('menu.quitCraftAgents') }
       ]
     }] : []),
 
     // File menu
     {
-      label: 'File',
+      label: i18n.t("menu.file"),
       submenu: [
         {
-          label: 'New Chat',
+          label: i18n.t("menu.newChat"),
           accelerator: 'CmdOrCtrl+N',
           registerAccelerator: false,  // Action registry handles the keyboard shortcut
           click: () => sendToRenderer(RPC_CHANNELS.menu.NEW_CHAT)
         },
         {
-          label: 'New Window',
+          label: i18n.t("menu.newWindow"),
           accelerator: 'CmdOrCtrl+Shift+N',
           registerAccelerator: false,  // Action registry handles the keyboard shortcut
           click: () => {
@@ -129,21 +130,21 @@ export async function rebuildMenu(): Promise<void> {
 
     // Edit menu (from shared schema)
     {
-      label: EDIT_MENU.label,
+      label: i18n.t(EDIT_MENU.labelKey),
       submenu: EDIT_MENU.items.map(toElectronMenuItem),
     },
 
     // View menu (from shared schema + dev-only items)
     {
-      label: VIEW_MENU.label,
+      label: i18n.t(VIEW_MENU.labelKey),
       submenu: [
         ...VIEW_MENU.items.map(toElectronMenuItem),
         // Dev tools — available in dev mode or when started with --debug
         ...(!app.isPackaged || isDebugMode ? [
           { type: 'separator' as const },
           ...(!app.isPackaged ? [
             {
-              label: 'Reload',
+              label: i18n.t("menu.reload"),
               accelerator: 'CmdOrCtrl+R',
               click: (_menuItem: Electron.MenuItem, window: Electron.BaseWindow | undefined) => {
                 const browserWindow = window instanceof BrowserWindow ? window : BrowserWindow.getFocusedWindow()
@@ -157,7 +158,7 @@ export async function rebuildMenu(): Promise<void> {
               }
             },
             {
-              label: 'Force Reload',
+              label: i18n.t("menu.forceReload"),
               accelerator: 'CmdOrCtrl+Shift+R',
               click: (_menuItem: Electron.MenuItem, window: Electron.BaseWindow | undefined) => {
                 const browserWindow = window instanceof BrowserWindow ? window : BrowserWindow.getFocusedWindow()
@@ -178,7 +179,7 @@ export async function rebuildMenu(): Promise<void> {
 
     // Window menu (from shared schema + macOS-specific items)
     {
-      label: WINDOW_MENU.label,
+      label: i18n.t(WINDOW_MENU.labelKey),
       submenu: [
         ...WINDOW_MENU.items.map(toElectronMenuItem),
         ...(isMac ? [
@@ -190,18 +191,18 @@ export async function rebuildMenu(): Promise<void> {
 
     // Debug menu (development only)
     ...(!app.isPackaged ? [{
-      label: 'Debug',
+      label: i18n.t("menu.debug"),
       submenu: [
         {
-          label: 'Check for Updates',
+          label: i18n.t("menu.checkForUpdates"),
           click: async () => {
             const { checkForUpdates } = await import('./auto-update')
             const info = await checkForUpdates({ autoDownload: true })
             mainLog.info('[debug-menu] Update check result:', info)
           }
         },
         {
-          label: 'Install Update',
+          label: i18n.t("menu.installUpdate"),
           click: async () => {
             const { installUpdate } = await import('./auto-update')
             try {
@@ -213,14 +214,14 @@ export async function rebuildMenu(): Promise<void> {
         },
         { type: 'separator' as const },
         {
-          label: 'Reset to Defaults...',
+          label: i18n.t("menu.resetToDefaults"),
           click: async () => {
             const { dialog } = await import('electron')
             await dialog.showMessageBox({
               type: 'info',
-              message: 'Reset to Defaults',
-              detail: 'To reset Craft Agent to defaults, quit the app and run:\n\nbun run fresh-start\n\nThis will delete all configuration, credentials, workspaces, and sessions.',
-              buttons: ['OK']
+              message: i18n.t("menu.resetToDefaultsTitle"),
+              detail: i18n.t("menu.resetToDefaultsDetail"),
+              buttons: [i18n.t("common.ok")]
             })
           }
         }
@@ -229,14 +230,14 @@ export async function rebuildMenu(): Promise<void> {
 
     // Help menu
     {
-      label: 'Help',
+      label: i18n.t("menu.help"),
       submenu: [
         {
-          label: 'Help & Documentation',
+          label: i18n.t("menu.helpAndDocs"),
           click: () => shell.openExternal('https://agents.craft.do/docs')
         },
         {
-          label: 'Keyboard Shortcuts',
+          label: i18n.t("menu.keyboardShortcuts"),
           accelerator: 'CmdOrCtrl+/',
           registerAccelerator: false,  // Action registry handles the keyboard shortcut
           click: () => sendToRenderer(RPC_CHANNELS.menu.KEYBOARD_SHORTCUTS)
@@ -281,7 +282,7 @@ function toElectronMenuItem(item: MenuItem): Electron.MenuItemConstructorOptions
 
   if (item.type === 'action') {
     return {
-      label: item.label,
+      label: i18n.t(item.labelKey),
       accelerator: item.shortcut,
       registerAccelerator: false,  // Action registry handles the keyboard shortcut
       click: () => sendToRenderer(item.ipcChannel as MenuBroadcastChannel),

apps/electron/src/preload/bootstrap.ts

@@ -414,4 +414,7 @@ client.onConnectionStateChanged((state) => {
   downloadUrl: process.env.CRAFT_VCREDIST_URL,
 })
 
+// i18n: sync language changes to main process (for native menus/dialogs)
+;(api as ElectronAPI).changeLanguage = (lang: string) => ipcRenderer.invoke('i18n:changeLanguage', lang)
+
 contextBridge.exposeInMainWorld('electronAPI', api)