Bundle Node runtime for ACP desktop

Author: jinglinpeng

console/src-tauri/capabilities/default.json

@@ -12,6 +12,7 @@
     "core:default",
     "desktop-updater-check",
     "desktop-updater-install",
+    "dialog:allow-open",
     "dialog:allow-save",
     "open-external-link",
     "tray"

console/src-tauri/src/backend/command.rs

@@ -74,6 +74,15 @@ pub(super) fn create(app: &tauri::AppHandle) -> Result<Command, String> {
              installation will be unavailable"
         );
     }
+    if let Some(node_runtime) = packaged_node_runtime(app) {
+        log::info!("[backend] bundled node runtime: {}", node_runtime.display());
+        command = command.env(
+            "QWENPAW_DESKTOP_NODE_RUNTIME",
+            node_runtime.to_string_lossy().to_string(),
+        );
+    } else {
+        log::warn!("[backend] bundled node runtime not found");
+    }
     Ok(command)
 }
 
@@ -94,6 +103,22 @@ fn packaged_python_runtime(app: &tauri::AppHandle) -> Option<PathBuf> {
     candidates.into_iter().find(|path| path.is_file())
 }
 
+#[cfg(not(debug_assertions))]
+fn packaged_node_runtime(app: &tauri::AppHandle) -> Option<PathBuf> {
+    let root = app
+        .path()
+        .resource_dir()
+        .ok()?
+        .join("binaries")
+        .join("node-runtime");
+    let node = if cfg!(windows) {
+        root.join("node.exe")
+    } else {
+        root.join("bin").join("node")
+    };
+    node.is_file().then_some(root)
+}
+
 #[cfg(not(debug_assertions))]
 fn packaged_backend_executable(app: &tauri::AppHandle) -> Result<PathBuf, String> {
     let executable_name = if cfg!(windows) {

console/src-tauri/tauri.conf.json

@@ -39,7 +39,11 @@
       "../../scripts/pack/assets/icon.icns",
       "../../scripts/pack/assets/icon.ico"
     ],
-    "resources": ["binaries/qwenpaw-backend", "binaries/python-runtime"],
+    "resources": [
+      "binaries/qwenpaw-backend",
+      "binaries/python-runtime",
+      "binaries/node-runtime"
+    ],
     "windows": {
       "webviewInstallMode": {
         "type": "downloadBootstrapper",

console/src/api/modules/acp.ts

@@ -1,9 +1,17 @@
 import { request } from "../request";
-import type { ACPAgentConfig, ACPConfig } from "../types";
+import type {
+  ACPAgentConfig,
+  ACPConfig,
+  ACPNodeRuntimeStatus,
+  ACPNodeRuntimeUpdate,
+} from "../types";
 
 export const acpApi = {
   getACPConfig: () => request<ACPConfig>("/config/acp"),
 
+  getACPNodeRuntime: () =>
+    request<ACPNodeRuntimeStatus>("/config/acp/node-runtime"),
+
   getACPAgentConfig: (agentName: string) =>
     request<ACPAgentConfig>(`/config/acp/${encodeURIComponent(agentName)}`),
 
@@ -13,6 +21,12 @@ export const acpApi = {
       body: JSON.stringify(body),
     }),
 
+  updateACPNodeRuntime: (body: ACPNodeRuntimeUpdate) =>
+    request<ACPNodeRuntimeStatus>("/config/acp/node-runtime", {
+      method: "PUT",
+      body: JSON.stringify(body),
+    }),
+
   updateACPAgentConfig: (agentName: string, body: ACPAgentConfig) =>
     request<ACPAgentConfig>(`/config/acp/${encodeURIComponent(agentName)}`, {
       method: "PUT",

console/src/api/types/acp.ts

@@ -14,5 +14,28 @@ export interface ACPAgentConfig {
 }
 
 export interface ACPConfig {
+  node_path?: string;
   agents: Record<string, ACPAgentConfig>;
 }
+
+export interface ACPNodeRuntimeCandidate {
+  key: string;
+  label: string;
+  node_path: string;
+  npx_path: string;
+  node_version: string;
+  npx_version: string;
+  available: boolean;
+  reason_code: string;
+  reason: string;
+}
+
+export interface ACPNodeRuntimeStatus {
+  node_path: string;
+  effective_node_path: string;
+  candidates: ACPNodeRuntimeCandidate[];
+}
+
+export interface ACPNodeRuntimeUpdate {
+  node_path: string;
+}

console/src/locales/en.json

@@ -255,7 +255,27 @@
     "deleteTitle": "Delete {{name}}",
     "deleteConfirm": "Delete this ACP agent? This action cannot be undone.",
     "deleteSuccess": "ACP agent deleted",
-    "deleteFailed": "Failed to delete ACP agent"
+    "deleteFailed": "Failed to delete ACP agent",
+    "nodeSettings": "Node Settings",
+    "nodePath": "Node path",
+    "chooseOtherNode": "Choose another Node...",
+    "selectNodePath": "Select Node path",
+    "nodePathPrompt": "Enter the node executable path",
+    "nodeSaved": "Node settings saved",
+    "nodeLoadFailed": "Failed to load Node settings",
+    "nodeSaveFailed": "Node path is unavailable",
+    "nodeRuntime": {
+      "bundled": "Bundled Node",
+      "system": "System Node",
+      "custom": "Custom Node"
+    },
+    "nodeRuntimeReason": {
+      "systemNodeMissing": "System Node was not detected",
+      "nodeMissing": "Node path does not exist",
+      "npxMissing": "npx was not found",
+      "versionCheckFailed": "Version check failed",
+      "unavailable": "Unavailable"
+    }
   },
   "voiceTranscription": {
     "title": "Voice Transcription",

console/src/locales/id.json

@@ -1171,7 +1171,27 @@
     "deleteTitle": "Hapus {{name}}",
     "deleteConfirm": "Hapus agen ACP ini? Tindakan ini tidak dapat dibatalkan.",
     "deleteSuccess": "Agen ACP berhasil dihapus",
-    "deleteFailed": "Gagal menghapus agen ACP"
+    "deleteFailed": "Gagal menghapus agen ACP",
+    "nodeSettings": "Pengaturan Node",
+    "nodePath": "Path Node",
+    "chooseOtherNode": "Pilih Node lain...",
+    "selectNodePath": "Pilih path Node",
+    "nodePathPrompt": "Masukkan path file executable node",
+    "nodeSaved": "Pengaturan Node tersimpan",
+    "nodeLoadFailed": "Gagal memuat pengaturan Node",
+    "nodeSaveFailed": "Path Node tidak tersedia",
+    "nodeRuntime": {
+      "bundled": "Node bawaan",
+      "system": "Node sistem",
+      "custom": "Node kustom"
+    },
+    "nodeRuntimeReason": {
+      "systemNodeMissing": "Node sistem tidak terdeteksi",
+      "nodeMissing": "Path Node tidak ada",
+      "npxMissing": "npx tidak ditemukan",
+      "versionCheckFailed": "Pemeriksaan versi gagal",
+      "unavailable": "Tidak tersedia"
+    }
   },
   "sessions": {
     "title": "Sesi",

console/src/locales/ja.json

@@ -2218,7 +2218,27 @@
     "deleteTitle": "{{name}} を削除",
     "deleteConfirm": "この ACP Agent を削除しますか？この操作は元に戻せません。",
     "deleteSuccess": "ACP Agent を削除しました",
-    "deleteFailed": "ACP Agent の削除に失敗しました"
+    "deleteFailed": "ACP Agent の削除に失敗しました",
+    "nodeSettings": "Node 設定",
+    "nodePath": "Node パス",
+    "chooseOtherNode": "別の Node を選択...",
+    "selectNodePath": "Node パスを選択",
+    "nodePathPrompt": "node 実行ファイルのパスを入力してください",
+    "nodeSaved": "Node 設定を保存しました",
+    "nodeLoadFailed": "Node 設定の読み込みに失敗しました",
+    "nodeSaveFailed": "Node パスを利用できません",
+    "nodeRuntime": {
+      "bundled": "同梱 Node",
+      "system": "システム Node",
+      "custom": "カスタム Node"
+    },
+    "nodeRuntimeReason": {
+      "systemNodeMissing": "システム Node が検出されませんでした",
+      "nodeMissing": "Node パスが存在しません",
+      "npxMissing": "npx が見つかりません",
+      "versionCheckFailed": "バージョン確認に失敗しました",
+      "unavailable": "利用不可"
+    }
   },
   "backup": {
     "title": "バックアップ",

console/src/locales/pt-BR.json

@@ -138,7 +138,27 @@
     "deleteTitle": "Excluir {{name}}",
     "deleteConfirm": "Excluir este agente ACP? Esta acao nao pode ser desfeita.",
     "deleteSuccess": "Agente ACP excluido",
-    "deleteFailed": "Falha ao excluir agente ACP"
+    "deleteFailed": "Falha ao excluir agente ACP",
+    "nodeSettings": "Configuracoes do Node",
+    "nodePath": "Caminho do Node",
+    "chooseOtherNode": "Escolher outro Node...",
+    "selectNodePath": "Selecionar caminho do Node",
+    "nodePathPrompt": "Informe o caminho do executavel node",
+    "nodeSaved": "Configuracoes do Node salvas",
+    "nodeLoadFailed": "Falha ao carregar configuracoes do Node",
+    "nodeSaveFailed": "Caminho do Node indisponivel",
+    "nodeRuntime": {
+      "bundled": "Node embutido",
+      "system": "Node do sistema",
+      "custom": "Node personalizado"
+    },
+    "nodeRuntimeReason": {
+      "systemNodeMissing": "Node do sistema nao detectado",
+      "nodeMissing": "Caminho do Node nao existe",
+      "npxMissing": "npx nao encontrado",
+      "versionCheckFailed": "Falha na verificacao de versao",
+      "unavailable": "Indisponivel"
+    }
   },
   "voiceTranscription": {
     "title": "Transcricao de Voz",

console/src/locales/ru.json

@@ -2233,7 +2233,27 @@
     "deleteTitle": "Удалить {{name}}",
     "deleteConfirm": "Удалить этот ACP агент? Это действие нельзя отменить.",
     "deleteSuccess": "ACP агент удалён",
-    "deleteFailed": "Не удалось удалить ACP агент"
+    "deleteFailed": "Не удалось удалить ACP агент",
+    "nodeSettings": "Настройки Node",
+    "nodePath": "Путь к Node",
+    "chooseOtherNode": "Выбрать другой Node...",
+    "selectNodePath": "Выбрать путь к Node",
+    "nodePathPrompt": "Введите путь к исполняемому файлу node",
+    "nodeSaved": "Настройки Node сохранены",
+    "nodeLoadFailed": "Не удалось загрузить настройки Node",
+    "nodeSaveFailed": "Путь к Node недоступен",
+    "nodeRuntime": {
+      "bundled": "Встроенный Node",
+      "system": "Системный Node",
+      "custom": "Пользовательский Node"
+    },
+    "nodeRuntimeReason": {
+      "systemNodeMissing": "Системный Node не обнаружен",
+      "nodeMissing": "Путь к Node не существует",
+      "npxMissing": "npx не найден",
+      "versionCheckFailed": "Проверка версии не удалась",
+      "unavailable": "Недоступно"
+    }
   },
   "backup": {
     "title": "Резервные копии",