Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Studio: let the desktop app stop a server it attached to, and show its port (#16595)

oobaboogaf10c0ca85f80
diff --git a/studio/frontend/src/app/provider.tsx b/studio/frontend/src/app/provider.tsx
index 48840277966..dccfd2832c2 100644
--- a/studio/frontend/src/app/provider.tsx
+++ b/studio/frontend/src/app/provider.tsx
@@ -505,17 +505,17 @@ function getTauriWindowMode(
}
function TauriUpdateLayer({
- isExternalServer,
+ externalServerPort,
children,
appContent,
onUpdateScreenChange,
}: {
- isExternalServer: boolean;
+ externalServerPort: number | null;
children?: ReactNode;
appContent: ReactNode;
onUpdateScreenChange: (shown: boolean) => void;
}) {
- const update = useTauriUpdate(isExternalServer);
+ const update = useTauriUpdate(externalServerPort);
const isUpdating =
update.status === "updating-backend" ||
update.status === "downloading" ||
@@ -571,7 +571,7 @@ function TauriUpdateLayer({
info={update.info}
dismissed={update.dismissed}
lastFailure={update.lastFailure}
- isExternalServer={isExternalServer}
+ externalServerPort={externalServerPort}
updatePolicyMode={update.updatePolicyMode}
manualReleaseUrl={update.manualReleaseUrl}
releasePageUrl={update.releasePageUrl}
@@ -701,6 +701,7 @@ function TauriWrapper({ children }: { children: ReactNode }) {
error,
installDiskFull,
isExternalServer,
+ externalServerPort,
currentStepIndex,
progressDetail,
startupMessage,
@@ -985,7 +986,7 @@ function TauriWrapper({ children }: { children: ReactNode }) {
>
<AppReadinessBoundary onReady={setAppShellReady} revealed={showApp}>
<TauriUpdateLayer
- isExternalServer={isExternalServer}
+ externalServerPort={externalServerPort}
onUpdateScreenChange={setUpdateScreenShown}
appContent={
<>
diff --git a/studio/frontend/src/components/tauri/update-banner.tsx b/studio/frontend/src/components/tauri/update-banner.tsx
index c5ba9ef50b3..1e106c16670 100644
--- a/studio/frontend/src/components/tauri/update-banner.tsx
+++ b/studio/frontend/src/components/tauri/update-banner.tsx
@@ -23,7 +23,8 @@ interface UpdateBannerProps {
info: UpdateInfo | null;
dismissed: boolean;
lastFailure: RetainedUpdateFailure | null;
- isExternalServer?: boolean;
+ // Set while attached to a server this app did not start, which blocks the update.
+ externalServerPort?: number | null;
updatePolicyMode: DesktopUpdatePolicyMode;
manualReleaseUrl: string | null;
// Release page for this version, preferred over the generic changelog.
@@ -48,7 +49,7 @@ export function UpdateBanner({
info,
dismissed,
lastFailure,
- isExternalServer = false,
+ externalServerPort = null,
updatePolicyMode,
manualReleaseUrl,
releasePageUrl = null,
@@ -72,6 +73,7 @@ export function UpdateBanner({
);
const show = showFailure || offerOpen;
const isManualLinuxPackage = updatePolicyMode === "manual_linux_package";
+ const isExternalServer = externalServerPort !== null;
const installDisabled = isManualLinuxPackage
? manualReleaseUrl === null
: isExternalServer;
@@ -172,7 +174,9 @@ export function UpdateBanner({
: isManualLinuxPackage
? t("desktopUpdate.banner.linuxManual")
: isExternalServer
- ? t("settings.about.update.desktopExternalServer")
+ ? t("settings.about.update.desktopExternalServer", {
+ port: externalServerPort,
+ })
: t("desktopUpdate.banner.available")}
</p>
</div>
diff --git a/studio/frontend/src/features/settings/components/desktop-update-control.tsx b/studio/frontend/src/features/settings/components/desktop-update-control.tsx
index f5279e56c10..1b0264ec768 100644
--- a/studio/frontend/src/features/settings/components/desktop-update-control.tsx
+++ b/studio/frontend/src/features/settings/components/desktop-update-control.tsx
@@ -35,7 +35,9 @@ export function DesktopUpdateControl(): ReactElement | null {
version: formatDesktopVersion(update.info.version),
});
description = update.isExternalServer
- ? t("settings.about.update.desktopExternalServer")
+ ? t("settings.about.update.desktopExternalServer", {
+ port: update.externalServerPort ?? "",
+ })
: update.updatePolicyMode === "manual_linux_package"
? t("settings.about.update.desktopManualInstall")
: t("settings.about.update.desktopAvailableDescription");
diff --git a/studio/frontend/src/hooks/use-tauri-backend.ts b/studio/frontend/src/hooks/use-tauri-backend.ts
index b2d85612d84..6d183ef16f2 100644
--- a/studio/frontend/src/hooks/use-tauri-backend.ts
+++ b/studio/frontend/src/hooks/use-tauri-backend.ts
@@ -9,6 +9,7 @@ import {
useSyncExternalStore,
} from "react";
import { isTauri, setApiBase } from "@/lib/api-base";
+import { toast } from "@/lib/toast";
import { invalidateHardwareInfo } from "@/hooks/use-hardware-info";
import {
MANAGED_ENVIRONMENT_BUSY,
@@ -146,8 +147,9 @@ export function useTauriBackend() {
);
// Dedupe step names (Strict Mode, event replay).
const seenStepsRef = useRef(new Set<string>());
- // Attached to a server we did not spawn, so we cannot stop it.
- const [isExternalServer, setIsExternalServer] = useState(false);
+ // Port of the attached server we did not spawn.
+ const [externalServerPort, setExternalServerPort] = useState<number | null>(null);
+ const isExternalServer = externalServerPort !== null;
const externalPollRef = useRef<ReturnType<typeof setInterval> | null>(null);
const externalPollAbortedRef = useRef(false);
const environmentWaitRef = useRef<ReturnType<typeof setTimeout> | null>(null);
@@ -243,7 +245,7 @@ export function useTauriBackend() {
}
if (failures >= 3) {
stopExternalServerPoll();
- setIsExternalServer(false);
+ setExternalServerPort(null);
setBackendError("External server is no longer responding");
}
}, 15_000);
@@ -312,7 +314,7 @@ export function useTauriBackend() {
}
setApiBase(preflight.port);
portRef.current = preflight.port;
- setIsExternalServer(true);
+ setExternalServerPort(preflight.port);
setStartupMessage(SERVER_STARTUP_MESSAGE);
setRunningStatus();
startExternalServerPoll(preflight.port);
@@ -325,20 +327,20 @@ export function useTauriBackend() {
}
setApiBase(preflight.port);
portRef.current = preflight.port;
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
setStartupMessage(SERVER_STARTUP_MESSAGE);
setRunningStatus();
return;
case "managed_ready":
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
setBackendStatus("starting");
await startManagedServer();
return;
case "owned_stale":
case "managed_stale":
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
if (
preflight.reason === MANAGED_ENVIRONMENT_BUSY ||
@@ -361,7 +363,7 @@ export function useTauriBackend() {
}
return;
case "external_conflict":
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
setBackendError(externalConflictMessage(preflight));
return;
@@ -456,7 +458,7 @@ export function useTauriBackend() {
seenStepsRef.current.clear();
startingRef.current = false;
portRef.current = null;
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
setLogs([]);
clearBackendError();
@@ -503,24 +505,18 @@ export function useTauriBackend() {
}
async function runStopServer() {
- if (isExternalServer) {
- startingRef.current = false;
- setIsExternalServer(false);
- stopExternalServerPoll();
- markServerStopIntent();
- setBackendStatus("stopped");
- return;
- }
const { invoke } = await import("@tauri-apps/api/core");
// Record intent before the await (reaping can block ~15s); roll back if the stop fails.
markServerStopIntent();
try {
- await invoke("stop_server");
+ await invoke("stop_server", { port: portRef.current });
} catch (e) {
clearServerStopIntent();
throw e;
}
startingRef.current = false;
+ setExternalServerPort(null);
+ stopExternalServerPoll();
setBackendStatus("stopped");
}
@@ -576,7 +572,7 @@ export function useTauriBackend() {
setProgressDetail(null);
setElevationPackages([]);
elevationResumeRef.current = null;
- setIsExternalServer(false);
+ setExternalServerPort(null);
stopExternalServerPoll();
stopManagedEnvironmentWait();
seenStepsRef.current.clear();
@@ -783,7 +779,9 @@ export function useTauriBackend() {
register<void>("tray-toggle-server", () => {
if (statusRef.current === "running") {
- stopServer();
+ stopServer().catch((e) => {
+ toast.error("Could not stop the server", { description: String(e) });
+ });
} else if (
statusRef.current === "stopped" ||
statusRef.current === "error"
@@ -827,6 +825,7 @@ export function useTauriBackend() {
return {
status, logs, error, installDiskFull, isExternalServer, closing,
+ externalServerPort,
currentStepIndex, progressDetail, startupMessage, elevationPackages,
startServer, stopServer, startInstall,
retry, retryInstall, approveElevation, copyDiagnostics,
diff --git a/studio/frontend/src/hooks/use-tauri-update.ts b/studio/frontend/src/hooks/use-tauri-update.ts
index 9331426ee3f..046ec57ce90 100644
--- a/studio/frontend/src/hooks/use-tauri-update.ts
+++ b/studio/frontend/src/hooks/use-tauri-update.ts
@@ -109,7 +109,8 @@ function manualReleasePageUrl(
return `${policy.releasePageBaseUrl}${policy.releaseTagPrefix}${normalized}`;
}
-export function useTauriUpdate(isExternalServer = false) {
+export function useTauriUpdate(externalServerPort: number | null = null) {
+ const isExternalServer = externalServerPort !== null;
const [status, setStatus] = useState<UpdateStatus>("idle");
const statusRef = useRef<UpdateStatus>("idle");
const [info, setInfo] = useState<UpdateInfo | null>(null);
@@ -598,6 +599,7 @@ export function useTauriUpdate(isExternalServer = false) {
phase,
lastFailure,
isExternalServer,
+ externalServerPort,
updatePolicyMode: updatePolicy.mode,
manualReleaseUrl,
releasePageUrl,
diff --git a/studio/frontend/src/i18n/locales/ar.ts b/studio/frontend/src/i18n/locales/ar.ts
index ab03a088e06..9c2f16df18e 100644
--- a/studio/frontend/src/i18n/locales/ar.ts
+++ b/studio/frontend/src/i18n/locales/ar.ts
@@ -3614,7 +3614,7 @@ export const ar = {
desktopAvailableDescription:
"حدّث الآن، وسيُعاد تشغيل تطبيق سطح المكتب عند اكتمال التحديث.",
desktopExternalServer:
- "اتصل التطبيق بخادم Unsloth يعمل مسبقًا ولا يمكنه تحديثه. أوقف ذلك الخادم، ثم أغلق تطبيق سطح المكتب وأعد فتحه للتحديث.",
+ "متصل بخادم Unsloth على المنفذ {port} لم يشغّله هذا التطبيق، مثل `unsloth studio` في نافذة طرفية. أوقفه من المكان الذي شُغّل منه، ثم أغلق التطبيق وأعد فتحه للتحديث.",
desktopManualInstall:
"افتح صفحة الإصدار لتثبيت أحدث حزمة لنظام Linux.",
desktopCheckFailed: "تعذّر التحقق من وجود تحديثات",
diff --git a/studio/frontend/src/i18n/locales/cs.ts b/studio/frontend/src/i18n/locales/cs.ts
index bdfbe032509..a521e9f6808 100644
--- a/studio/frontend/src/i18n/locales/cs.ts
+++ b/studio/frontend/src/i18n/locales/cs.ts
@@ -3932,7 +3932,7 @@ export const cs = {
desktopAvailableDescription:
"Aktualizujte nyní; po dokončení se desktopová aplikace restartuje.",
desktopExternalServer:
- "Aplikace se připojila k již spuštěnému serveru Unsloth a nemůže ho aktualizovat. Zastavte tento server, potom desktopovou aplikaci ukončete a znovu otevřete, aby se aktualizovala.",
+ "Připojeno k serveru Unsloth na portu {port}, který tato aplikace nespustila, například `unsloth studio` v terminálu. Zastavte ho tam, kde byl spuštěn, potom aplikaci ukončete a znovu otevřete, aby se aktualizovala.",
desktopManualInstall:
"Otevřete stránku vydání a nainstalujte nejnovější balíček pro Linux.",
desktopCheckFailed: "Aktualizace se nepodařilo zkontrolovat",
diff --git a/studio/frontend/src/i18n/locales/de.ts b/studio/frontend/src/i18n/locales/de.ts
index f5220c0068b..237772dafee 100644
--- a/studio/frontend/src/i18n/locales/de.ts
+++ b/studio/frontend/src/i18n/locales/de.ts
@@ -3662,7 +3662,7 @@ export const de = {
desktopAvailableDescription:
"Aktualisieren Sie jetzt. Die Desktop-App wird nach Abschluss des Updates neu gestartet.",
desktopExternalServer:
- "Die App ist mit einem bereits laufenden Unsloth-Server verbunden und kann ihn nicht aktualisieren. Stoppen Sie diesen Server, beenden Sie die Desktop-App und öffnen Sie sie erneut, um das Update zu installieren.",
+ "Verbunden mit einem Unsloth-Server auf Port {port}, den diese App nicht gestartet hat, zum Beispiel `unsloth studio` in einem Terminal. Stoppen Sie ihn dort, wo er gestartet wurde, beenden Sie dann die App und öffnen Sie sie erneut, um das Update zu installieren.",
desktopManualInstall:
"Öffnen Sie die Release-Seite, um das neueste Linux-Paket zu installieren.",
desktopCheckFailed: "Die Suche nach Updates ist fehlgeschlagen",
diff --git a/studio/frontend/src/i18n/locales/en.ts b/studio/frontend/src/i18n/locales/en.ts
index 19559ee9fa3..98203d245c4 100644
--- a/studio/frontend/src/i18n/locales/en.ts
+++ b/studio/frontend/src/i18n/locales/en.ts
@@ -3629,7 +3629,7 @@ export const en = {
desktopAvailableDescription:
"Update now and the desktop app will restart when it finishes.",
desktopExternalServer:
- "The app connected to an already-running Unsloth server and cannot update it. Stop that server, then quit and reopen the desktop app to update.",
+ "Connected to an Unsloth server on port {port} that this app did not start, such as `unsloth studio` in a terminal. Stop it where it was started, then quit and reopen the app to update.",
desktopManualInstall:
"Open the release page to install the latest Linux package.",
desktopCheckFailed: "Could not check for updates",
diff --git a/studio/frontend/src/i18n/locales/es-419.ts b/studio/frontend/src/i18n/locales/es-419.ts
index 06bb3e273f0..6722e6c7e7f 100644
--- a/studio/frontend/src/i18n/locales/es-419.ts
+++ b/studio/frontend/src/i18n/locales/es-419.ts
@@ -3977,7 +3977,7 @@ export const es419 = {
desktopAvailableDescription:
"Actualiza ahora y la app de escritorio se reiniciará cuando termine.",
desktopExternalServer:
- "La aplicación se conectó a un servidor de Unsloth que ya estaba en ejecución y no puede actualizarlo. Detén ese servidor, cierra la aplicación de escritorio y vuelve a abrirla para actualizar.",
+ "Conectada a un servidor de Unsloth en el puerto {port} que esta aplicación no inició, como `unsloth studio` en una terminal. Detenlo donde se inició y luego cierra y vuelve a abrir la aplicación para actualizar.",
desktopManualInstall:
"Abre la página de versiones para instalar el paquete más reciente para Linux.",
desktopCheckFailed: "No se pudieron buscar actualizaciones",
diff --git a/studio/frontend/src/i18n/locales/es.ts b/studio/frontend/src/i18n/locales/es.ts
index 22f5941894d..f8952dd7bf6 100644
--- a/studio/frontend/src/i18n/locales/es.ts
+++ b/studio/frontend/src/i18n/locales/es.ts
@@ -3656,7 +3656,7 @@ export const es = {
desktopAvailableDescription:
"Actualiza ahora y la app de escritorio se reiniciará cuando termine.",
desktopExternalServer:
- "La aplicación se conectó a un servidor de Unsloth que ya estaba en ejecución y no puede actualizarlo. Detén ese servidor, cierra la aplicación de escritorio y vuelve a abrirla para actualizar.",
+ "Conectada a un servidor de Unsloth en el puerto {port} que esta aplicación no inició, como `unsloth studio` en un terminal. Detenlo donde se inició y luego cierra y vuelve a abrir la aplicación para actualizar.",
desktopManualInstall:
"Abre la página de versiones para instalar el paquete más reciente para Linux.",
desktopCheckFailed: "No se pudo buscar actualizaciones",
diff --git a/studio/frontend/src/i18n/locales/fa.ts b/studio/frontend/src/i18n/locales/fa.ts
index 6944c056093..27d20ed5b3f 100644
--- a/studio/frontend/src/i18n/locales/fa.ts
+++ b/studio/frontend/src/i18n/locales/fa.ts
@@ -3901,7 +3901,7 @@ export const fa = {
desktopAvailableDescription:
"اکنون به‌روزرسانی کنید؛ برنامهٔ دسکتاپ پس از پایان کار دوباره راه‌اندازی می‌شود.",
desktopExternalServer:
- "برنامه به سرور Unsloth که از قبل در حال اجرا بود متصل شده است و نمی‌تواند آن را به‌روزرسانی کند. آن سرور را متوقف کنید، سپس برای به‌روزرسانی، برنامهٔ دسکتاپ را ببندید و دوباره باز کنید.",
+ "به سرور Unsloth روی پورت {port} متصل است که این برنامه آن را اجرا نکرده است، مانند `unsloth studio` در ترمینال. آن را از همان جایی که اجرا شده متوقف کنید، سپس برای به‌روزرسانی، برنامه را ببندید و دوباره باز کنید.",
desktopManualInstall:
"برای نصب آخرین بستهٔ Linux، صفحهٔ انتشار را باز کنید.",
desktopCheckFailed: "بررسی به‌روزرسانی‌ها ممکن نشد",
diff --git a/studio/frontend/src/i18n/locales/fr.ts b/studio/frontend/src/i18n/locales/fr.ts
index faa773515fb..40c0df0657b 100644
--- a/studio/frontend/src/i18n/locales/fr.ts
+++ b/studio/frontend/src/i18n/locales/fr.ts
@@ -3664,7 +3664,7 @@ export const fr = {
desktopAvailableDescription:
"Effectuez la mise à jour maintenant. L’application de bureau redémarrera une fois l’opération terminée.",
desktopExternalServer:
- "L’application est connectée à un serveur Unsloth déjà en cours d’exécution et ne peut pas le mettre à jour. Arrêtez ce serveur, puis quittez et rouvrez l’application de bureau pour effectuer la mise à jour.",
+ "Connectée à un serveur Unsloth sur le port {port} que cette application n’a pas démarré, comme `unsloth studio` dans un terminal. Arrêtez-le là où il a été démarré, puis quittez et rouvrez l’application pour effectuer la mise à jour.",
desktopManualInstall:
"Ouvrez la page des versions pour installer le dernier paquet Linux.",
desktopCheckFailed: "Impossible de rechercher les mises à jour",
diff --git a/studio/frontend/src/i18n/locales/he.ts b/studio/frontend/src/i18n/locales/he.ts
index e0a5bb37153..34f4fa3e998 100644
--- a/studio/frontend/src/i18n/locales/he.ts
+++ b/studio/frontend/src/i18n/locales/he.ts
@@ -3699,7 +3699,7 @@ export const he = {
desktopAvailableDescription:
"עדכן כעת ואפליקציית שולחן העבודה תופעל מחדש בסיום.",
desktopExternalServer:
- "האפליקציה התחברה לשרת Unsloth שכבר פועל ואינה יכולה לעדכן אותו. עצור את השרת, ואז צא מאפליקציית שולחן העבודה ופתח אותה מחדש כדי לעדכן.",
+ "מחובר לשרת Unsloth בפורט {port} שהאפליקציה הזו לא הפעילה, כמו `unsloth studio` בטרמינל. עצור אותו במקום שבו הופעל, ואז צא מהאפליקציה ופתח אותה מחדש כדי לעדכן.",
desktopManualInstall:
"פתח את דף השחרור כדי להתקין את חבילת ה-Linux העדכנית ביותר.",
desktopCheckFailed: "לא ניתן לבדוק עדכונים",
diff --git a/studio/frontend/src/i18n/locales/hi.ts b/studio/frontend/src/i18n/locales/hi.ts
index 4b9feb1bc01..78feaec6131 100644
--- a/studio/frontend/src/i18n/locales/hi.ts
+++ b/studio/frontend/src/i18n/locales/hi.ts
@@ -3624,7 +3624,7 @@ export const hi = {
desktopAvailableDescription:
"अभी अपडेट करें। अपडेट पूरा होने पर डेस्कटॉप ऐप फिर से शुरू होगा।",
desktopExternalServer:
- "ऐप पहले से चल रहे Unsloth सर्वर से जुड़ा है और उसे अपडेट नहीं कर सकता। उस सर्वर को रोकें, फिर अपडेट करने के लिए डेस्कटॉप ऐप बंद करके दोबारा खोलें।",
+ "पोर्ट {port} पर एक ऐसे Unsloth सर्वर से जुड़ा है जिसे इस ऐप ने शुरू नहीं किया, जैसे टर्मिनल में `unsloth studio`। उसे वहीं रोकें जहाँ से वह शुरू हुआ था, फिर अपडेट करने के लिए ऐप बंद करके दोबारा खोलें।",
desktopManualInstall:
"नवीनतम Linux पैकेज इंस्टॉल करने के लिए रिलीज़ पेज खोलें।",
desktopCheckFailed: "अपडेट की जाँच नहीं हो सकी",
diff --git a/studio/frontend/src/i18n/locales/id.ts b/studio/frontend/src/i18n/locales/id.ts
index d356caeb8b1..32ab2feff15 100644
--- a/studio/frontend/src/i18n/locales/id.ts
+++ b/studio/frontend/src/i18n/locales/id.ts
@@ -3913,7 +3913,7 @@ export const id = {
desktopAvailableDescription:
"Perbarui sekarang dan aplikasi desktop akan dimulai ulang setelah selesai.",
desktopExternalServer:
- "Aplikasi terhubung ke server Unsloth yang sudah berjalan dan tidak dapat memperbaruinya. Hentikan server tersebut, lalu tutup dan buka kembali aplikasi desktop untuk memperbarui.",
+ "Terhubung ke server Unsloth di port {port} yang tidak dijalankan oleh aplikasi ini, seperti `unsloth studio` di terminal. Hentikan server itu di tempat ia dijalankan, lalu tutup dan buka kembali aplikasi untuk memperbarui.",
desktopManualInstall:
"Buka halaman rilis untuk menginstal paket Linux terbaru.",
desktopCheckFailed: "Tidak dapat memeriksa pembaruan",
diff --git a/studio/frontend/src/i18n/locales/it.ts b/studio/frontend/src/i18n/locales/it.ts
index 97ee2b4182b..050824323e1 100644
--- a/studio/frontend/src/i18n/locales/it.ts
+++ b/studio/frontend/src/i18n/locales/it.ts
@@ -3560,7 +3560,7 @@ export const it = {
desktopAvailableDescription:
"Aggiorna ora: al termine, l'app desktop verrà riavviata.",
desktopExternalServer:
- "L’app si è connessa a un server Unsloth già in esecuzione e non può aggiornarlo. Arresta quel server, poi chiudi e riapri l’app desktop per aggiornare.",
+ "Connessa a un server Unsloth sulla porta {port} che questa app non ha avviato, come `unsloth studio` in un terminale. Arrestalo dove è stato avviato, poi chiudi e riapri l’app per aggiornare.",
desktopManualInstall:
"Apri la pagina della release per installare il pacchetto Linux più recente.",
desktopCheckFailed:
diff --git a/studio/frontend/src/i18n/locales/ja.ts b/studio/frontend/src/i18n/locales/ja.ts
index b3ffe1b8466..547da14b699 100644
--- a/studio/frontend/src/i18n/locales/ja.ts
+++ b/studio/frontend/src/i18n/locales/ja.ts
@@ -3583,7 +3583,7 @@ export const ja = {
desktopAvailableDescription:
"今すぐアップデートします。完了するとデスクトップアプリが再起動します。",
desktopExternalServer:
- "アプリはすでに実行中の Unsloth サーバーに接続しているため、更新できません。そのサーバーを停止し、デスクトップアプリを終了してから再度開き、更新してください。",
+ "このアプリが起動していないポート {port} の Unsloth サーバー(ターミナルで実行した `unsloth studio` など)に接続しています。起動した場所で停止してから、アプリを終了して再度開き、更新してください。",
desktopManualInstall:
"リリースページを開き、最新の Linux パッケージをインストールしてください。",
desktopCheckFailed: "アップデートを確認できませんでした",
diff --git a/studio/frontend/src/i18n/locales/ko.ts b/studio/frontend/src/i18n/locales/ko.ts
index c20caecb2e5..45d34af8fb1 100644
--- a/studio/frontend/src/i18n/locales/ko.ts
+++ b/studio/frontend/src/i18n/locales/ko.ts
@@ -3604,7 +3604,7 @@ export const ko = {
desktopAvailableDescription:
"지금 업데이트하면 완료 후 데스크톱 앱이 다시 시작됩니다.",
desktopExternalServer:
- "앱이 이미 실행 중인 Unsloth 서버에 연결되어 있어 업데이트할 수 없습니다. 해당 서버를 중지한 다음 데스크톱 앱을 종료하고 다시 열어 업데이트하세요.",
+ "이 앱이 시작하지 않은 포트 {port}의 Unsloth 서버(예: 터미널의 `unsloth studio`)에 연결되어 있습니다. 서버를 시작한 곳에서 중지한 다음 앱을 종료하고 다시 열어 업데이트하세요.",
desktopManualInstall:
"릴리스 페이지를 열어 최신 Linux 패키지를 설치하세요.",
desktopCheckFailed: "업데이트를 확인하지 못했습니다",
diff --git a/studio/frontend/src/i18n/locales/nl.ts b/studio/frontend/src/i18n/locales/nl.ts
index 346bddfeae4..cd498c5ad3b 100644
--- a/studio/frontend/src/i18n/locales/nl.ts
+++ b/studio/frontend/src/i18n/locales/nl.ts
@@ -3961,7 +3961,7 @@ export const nl = {
desktopAvailableDescription:
"Werk nu bij; de desktop-app start opnieuw wanneer dit klaar is.",
desktopExternalServer:
- "De app is verbonden met een Unsloth-server die al draaide en kan deze niet bijwerken. Stop die server, sluit de desktop-app af en open hem opnieuw om bij te werken.",
+ "Verbonden met een Unsloth-server op poort {port} die deze app niet heeft gestart, zoals `unsloth studio` in een terminal. Stop hem waar hij is gestart, sluit dan de app af en open hem opnieuw om bij te werken.",
desktopManualInstall:
"Open de releasepagina om het nieuwste Linux-pakket te installeren.",
desktopCheckFailed: "Kan niet controleren op updates",
diff --git a/studio/frontend/src/i18n/locales/pl.ts b/studio/frontend/src/i18n/locales/pl.ts
index a8452433581..95b111f0499 100644
--- a/studio/frontend/src/i18n/locales/pl.ts
+++ b/studio/frontend/src/i18n/locales/pl.ts
@@ -3962,7 +3962,7 @@ export const pl = {
desktopAvailableDescription:
"Zaktualizuj teraz, a aplikacja komputerowa uruchomi się ponownie po zakończeniu.",
desktopExternalServer:
- "Aplikacja połączyła się z już działającym serwerem Unsloth i nie może go zaktualizować. Zatrzymaj ten serwer, a następnie zamknij i ponownie otwórz aplikację komputerową, aby ją zaktualizować.",
+ "Połączono z serwerem Unsloth na porcie {port}, którego ta aplikacja nie uruchomiła, na przykład `unsloth studio` w terminalu. Zatrzymaj go tam, gdzie został uruchomiony, a następnie zamknij i ponownie otwórz aplikację, aby ją zaktualizować.",
desktopManualInstall:
"Otwórz stronę wydania, aby zainstalować najnowszy pakiet dla systemu Linux.",
desktopCheckFailed: "Nie udało się sprawdzić aktualizacji",
diff --git a/studio/frontend/src/i18n/locales/pt-br.ts b/studio/frontend/src/i18n/locales/pt-br.ts
index 39afa12bd48..9fcaecb32f0 100644
--- a/studio/frontend/src/i18n/locales/pt-br.ts
+++ b/studio/frontend/src/i18n/locales/pt-br.ts
@@ -3631,7 +3631,7 @@ export const ptBR = {
desktopAvailableDescription:
"Atualize agora. O aplicativo de desktop será reiniciado quando a atualização terminar.",
desktopExternalServer:
- "O aplicativo se conectou a um servidor Unsloth que já estava em execução e não pode atualizá-lo. Pare esse servidor, feche e reabra o aplicativo desktop para atualizar.",
+ "Conectado a um servidor Unsloth na porta {port} que este aplicativo não iniciou, como o `unsloth studio` em um terminal. Pare-o onde ele foi iniciado e depois feche e reabra o aplicativo para atualizar.",
desktopManualInstall:
"Abra a página de lançamentos para instalar o pacote mais recente para Linux.",
desktopCheckFailed: "Não foi possível verificar se há atualizações",
diff --git a/studio/frontend/src/i18n/locales/ru.ts b/studio/frontend/src/i18n/locales/ru.ts
index 4965b86eba2..c319a0aeff6 100644
--- a/studio/frontend/src/i18n/locales/ru.ts
+++ b/studio/frontend/src/i18n/locales/ru.ts
@@ -3629,7 +3629,7 @@ export const ru = {
desktopAvailableDescription:
"Установите обновление сейчас. После установки настольное приложение перезапустится.",
desktopExternalServer:
- "Приложение подключилось к уже запущенному серверу Unsloth и не может его обновить. Остановите этот сервер, затем закройте и снова откройте настольное приложение для обновления.",
+ "Подключено к серверу Unsloth на порту {port}, который это приложение не запускало, например к `unsloth studio` в терминале. Остановите его там, где он был запущен, затем закройте и снова откройте приложение для обновления.",
desktopManualInstall:
"Откройте страницу выпуска, чтобы установить последнюю версию пакета для Linux.",
desktopCheckFailed: "Не удалось проверить наличие обновлений",
diff --git a/studio/frontend/src/i18n/locales/sv.ts b/studio/frontend/src/i18n/locales/sv.ts
index 777ddb094d2..b3233c8faf7 100644
--- a/studio/frontend/src/i18n/locales/sv.ts
+++ b/studio/frontend/src/i18n/locales/sv.ts
@@ -3802,7 +3802,7 @@ export const sv = {
desktopAvailableDescription:
"Uppdatera nu så startar skrivbordsappen om när den är klar.",
desktopExternalServer:
- "Appen anslöt till en Unsloth-server som redan körs och kan inte uppdatera den. Stoppa servern, avsluta sedan skrivbordsappen och öppna den igen för att uppdatera.",
+ "Ansluten till en Unsloth-server på port {port} som den här appen inte har startat, till exempel `unsloth studio` i en terminal. Stoppa den där den startades, avsluta sedan appen och öppna den igen för att uppdatera.",
desktopManualInstall:
"Öppna utgåvesidan för att installera det senaste Linux-paketet.",
desktopCheckFailed: "Det gick inte att kontrollera uppdateringar",
diff --git a/studio/frontend/src/i18n/locales/th.ts b/studio/frontend/src/i18n/locales/th.ts
index 4add0ec55f4..e096257d559 100644
--- a/studio/frontend/src/i18n/locales/th.ts
+++ b/studio/frontend/src/i18n/locales/th.ts
@@ -3746,7 +3746,7 @@ export const th = {
desktopAvailableDescription:
"อัปเดตตอนนี้ แล้วแอปเดสก์ท็อปจะรีสตาร์ทเมื่ออัปเดตเสร็จ",
desktopExternalServer:
- "แอปเชื่อมต่อกับเซิร์ฟเวอร์ Unsloth ที่ทำงานอยู่แล้วและไม่สามารถอัปเดตเซิร์ฟเวอร์นั้นได้ ให้หยุดเซิร์ฟเวอร์นั้น แล้วออกและเปิดแอปเดสก์ท็อปอีกครั้งเพื่ออัปเดต",
+ "เชื่อมต่อกับเซิร์ฟเวอร์ Unsloth บนพอร์ต {port} ที่แอปนี้ไม่ได้เริ่ม เช่น `unsloth studio` ในเทอร์มินัล ให้หยุดเซิร์ฟเวอร์จากที่ที่เริ่มไว้ แล้วออกและเปิดแอปอีกครั้งเพื่ออัปเดต",
desktopManualInstall: "เปิดหน้ารุ่นเผยแพร่เพื่อติดตั้งแพ็กเกจ Linux ล่าสุด",
desktopCheckFailed: "ไม่สามารถตรวจหาการอัปเดตได้",
desktopCheckFailedDescription: "ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง",
diff --git a/studio/frontend/src/i18n/locales/tr.ts b/studio/frontend/src/i18n/locales/tr.ts
index e926ba5f314..41f9922b74e 100644
--- a/studio/frontend/src/i18n/locales/tr.ts
+++ b/studio/frontend/src/i18n/locales/tr.ts
@@ -3911,7 +3911,7 @@ export const tr = {
desktopAvailableDescription:
"Şimdi güncelleyin; işlem bittiğinde masaüstü uygulaması yeniden başlar.",
desktopExternalServer:
- "Uygulama zaten çalışan bir Unsloth sunucusuna bağlandı ve bu sunucuyu güncelleyemez. Güncellemek için o sunucuyu durdurun, ardından masaüstü uygulamasından çıkıp yeniden açın.",
+ "Bu uygulamanın başlatmadığı, {port} numaralı bağlantı noktasındaki bir Unsloth sunucusuna bağlı; örneğin bir terminaldeki `unsloth studio`. Güncellemek için sunucuyu başlatıldığı yerden durdurun, ardından uygulamadan çıkıp yeniden açın.",
desktopManualInstall:
"En son Linux paketini kurmak için sürüm sayfasını açın.",
desktopCheckFailed: "Güncellemeler denetlenemedi",
diff --git a/studio/frontend/src/i18n/locales/uk.ts b/studio/frontend/src/i18n/locales/uk.ts
index ae70cd5c800..52ccbefd86a 100644
--- a/studio/frontend/src/i18n/locales/uk.ts
+++ b/studio/frontend/src/i18n/locales/uk.ts
@@ -3945,7 +3945,7 @@ export const uk = {
desktopAvailableDescription:
"Оновіть зараз, і застосунок для комп’ютера перезапуститься після завершення.",
desktopExternalServer:
- "Застосунок під’єднався до вже запущеного сервера Unsloth і не може його оновити. Зупиніть цей сервер, потім закрийте й знову відкрийте застосунок для комп’ютера, щоб оновити його.",
+ "Під’єднано до сервера Unsloth на порту {port}, який цей застосунок не запускав, наприклад `unsloth studio` у терміналі. Зупиніть його там, де його було запущено, потім закрийте й знову відкрийте застосунок, щоб оновити його.",
desktopManualInstall:
"Відкрийте сторінку випуску, щоб інсталювати найновіший пакет для Linux.",
desktopCheckFailed: "Не вдалося перевірити наявність оновлень",
diff --git a/studio/frontend/src/i18n/locales/vi.ts b/studio/frontend/src/i18n/locales/vi.ts
index 07cbfdcf90b..e1f36813767 100644
--- a/studio/frontend/src/i18n/locales/vi.ts
+++ b/studio/frontend/src/i18n/locales/vi.ts
@@ -3916,7 +3916,7 @@ export const vi = {
desktopAvailableDescription:
"Cập nhật ngay, ứng dụng máy tính sẽ khởi động lại khi hoàn tất.",
desktopExternalServer:
- "Ứng dụng đã kết nối với một máy chủ Unsloth đang chạy sẵn và không thể cập nhật máy chủ đó. Hãy dừng máy chủ đó, rồi thoát và mở lại ứng dụng máy tính để cập nhật.",
+ "Đang kết nối với một máy chủ Unsloth trên cổng {port} mà ứng dụng này không khởi động, ví dụ `unsloth studio` trong terminal. Hãy dừng máy chủ tại nơi đã khởi động nó, rồi thoát và mở lại ứng dụng để cập nhật.",
desktopManualInstall:
"Mở trang phát hành để cài đặt gói Linux mới nhất.",
desktopCheckFailed: "Không thể kiểm tra bản cập nhật",
diff --git a/studio/frontend/src/i18n/locales/zh-CN.ts b/studio/frontend/src/i18n/locales/zh-CN.ts
index 5df6e1ba482..4e3cd76e02b 100644
--- a/studio/frontend/src/i18n/locales/zh-CN.ts
+++ b/studio/frontend/src/i18n/locales/zh-CN.ts
@@ -3556,7 +3556,7 @@ export const zhCN = {
desktopAvailable: "桌面应用 {version} 已可用",
desktopAvailableDescription: "立即更新,完成后桌面应用将自动重启。",
desktopExternalServer:
- "应用已连接到正在运行的 Unsloth 服务器,无法更新该服务器。请先停止该服务器,再退出并重新打开桌面应用以进行更新。",
+ "已连接到端口 {port} 上并非由此应用启动的 Unsloth 服务器,例如在终端中运行的 `unsloth studio`。请在启动它的地方停止它,然后退出并重新打开应用以进行更新。",
desktopManualInstall: "打开发布页面,安装最新的 Linux 软件包。",
desktopCheckFailed: "无法检查更新",
desktopCheckFailedDescription: "请检查网络连接后重试。",
diff --git a/studio/frontend/src/i18n/locales/zh-TW.ts b/studio/frontend/src/i18n/locales/zh-TW.ts
index 00b51a3900e..a6d38736488 100644
--- a/studio/frontend/src/i18n/locales/zh-TW.ts
+++ b/studio/frontend/src/i18n/locales/zh-TW.ts
@@ -3722,7 +3722,7 @@ export const zhTW = {
desktopAvailable: "桌面應用程式 {version} 已推出",
desktopAvailableDescription: "立即更新,完成後桌面應用程式將重新啟動。",
desktopExternalServer:
- "此應用程式連線到已在執行中的 Unsloth 伺服器,因此無法更新該伺服器。請停止該伺服器,然後結束並重新開啟桌面應用程式以進行更新。",
+ "已連線到連接埠 {port} 上並非由此應用程式啟動的 Unsloth 伺服器,例如在終端機中執行的 `unsloth studio`。請在啟動它的地方停止它,然後結束並重新開啟應用程式以進行更新。",
desktopManualInstall: "開啟發行頁面以安裝最新的 Linux 套件。",
desktopCheckFailed: "無法檢查更新",
desktopCheckFailedDescription: "請檢查您的網路連線,然後再試一次。",
diff --git a/studio/frontend/tests/desktop-stop-intent.test.ts b/studio/frontend/tests/desktop-stop-intent.test.ts
index 1994e4eec19..dbfb3b69ad1 100644
--- a/studio/frontend/tests/desktop-stop-intent.test.ts
+++ b/studio/frontend/tests/desktop-stop-intent.test.ts
@@ -179,7 +179,7 @@ test("stopping records the intent before the shutdown it can outlive", async ()
// Reaping can block ~15s, so the marker must be written before it; order is load bearing.
const mark = body.indexOf("markServerStopIntent();\n try {");
- const invoke = body.indexOf('await invoke("stop_server")');
+ const invoke = body.indexOf('await invoke("stop_server"');
assert.ok(
mark > 0 && invoke > mark,
"the marker is written after the stop it must survive",
@@ -190,11 +190,29 @@ test("stopping records the intent before the shutdown it can outlive", async ()
/catch \(e\) \{\s*clearServerStopIntent\(\);\s*throw e;\s*\}/,
"a failed stop keeps a marker it did not earn",
);
+});
- const external = body.slice(0, body.indexOf("const { invoke }"));
+test("an attached server is stopped, not only detached", async () => {
+ const hook = USE_TAURI_BACKEND;
+ const body = hook.slice(
+ hook.indexOf("async function runStopServer()"),
+ hook.indexOf("async function startInstall("),
+ );
+
+ assert.doesNotMatch(
+ body,
+ /isExternalServer\)/,
+ "the stop branches on render state the tray handler never sees",
+ );
+ const invoke = body.indexOf('await invoke("stop_server"');
+ const detach = body.indexOf("setExternalServerPort(null);");
+ assert.ok(
+ invoke > 0 && detach > invoke,
+ "the app lets go of an attached server without stopping it",
+ );
assert.match(
- external,
- /stopExternalServerPoll\(\);\s*markServerStopIntent\(\);/,
+ body.slice(detach),
+ /stopExternalServerPoll\(\);\s*setBackendStatus\("stopped"\);/,
);
});
@@ -203,8 +221,8 @@ test("a second stop cannot run while the first is in flight", async () => {
const tray = hook.slice(hook.indexOf('register<void>("tray-toggle-server"'));
assert.match(
- tray.slice(0, tray.indexOf("});")),
- /statusRef\.current === "running"\)\s*\{\s*stopServer\(\);/,
+ tray.slice(0, tray.indexOf("retry();")),
+ /statusRef\.current === "running"\)\s*\{\s*stopServer\(\)/,
);
const guard = hook.slice(
@@ -245,3 +263,63 @@ test("every deliberate start drops the marker", async () => {
assert.match(retry, /clearServerStopIntent\(\);/);
assert.match(retry, /checkInstallAndStart\(\);/);
});
+
+test("a tray stop that fails tells the user why", () => {
+ const hook = USE_TAURI_BACKEND;
+ const tray = hook.slice(hook.indexOf('register<void>("tray-toggle-server"'));
+ assert.match(
+ tray.slice(0, tray.indexOf("retry();")),
+ /stopServer\(\)\.catch\(\(e\) => \{\s*toast\.error\([^)]*String\(e\)/,
+ "the tray drops the reason a stop failed",
+ );
+});
+
+// The tray listener is registered once at mount, so run the real runStopServer with that
+// render's state: not attached, whatever the app is attached to now.
+function stopFromMountTimeListener(port: number, stopError?: Error) {
+ const hook = USE_TAURI_BACKEND;
+ const start = hook.indexOf(" async function runStopServer()");
+ const body = hook.slice(start, hook.indexOf("\n }\n", start) + 4);
+ const calls: string[] = [];
+ const scope: Record<string, unknown> = {
+ isExternalServer: false,
+ externalServerPort: null,
+ portRef: { current: port },
+ startingRef: { current: true },
+ importTauriCore: () =>
+ Promise.resolve({
+ invoke: (command: string, args: { port: number }) => {
+ calls.push(`${command}:${args.port}`);
+ return stopError ? Promise.reject(stopError) : Promise.resolve(null);
+ },
+ }),
+ setExternalServerPort: (next: number | null) => calls.push(`attached:${next}`),
+ stopExternalServerPoll: () => calls.push("stop-poll"),
+ markServerStopIntent: () => calls.push("mark-intent"),
+ clearServerStopIntent: () => calls.push("clear-intent"),
+ setBackendStatus: (status: string) => calls.push(`status:${status}`),
+ };
+ const source = `${body.replace('await import("@tauri-apps/api/core")', "await importTauriCore()")}
+ return runStopServer;`;
+ const keys = Object.keys(scope);
+ const run = new Function(...keys, source)(...keys.map((key) => scope[key])) as () => Promise<void>;
+ return { run, calls };
+}
+
+test("the tray's stop on an attached server stops it by port, then leaves attached mode", async () => {
+ const stop = stopFromMountTimeListener(8890);
+ await stop.run();
+ assert.deepEqual(stop.calls, [
+ "mark-intent",
+ "stop_server:8890",
+ "attached:null",
+ "stop-poll",
+ "status:stopped",
+ ]);
+});
+
+test("a stop the server refuses keeps the app attached and its health poll running", async () => {
+ const stop = stopFromMountTimeListener(8890, new Error("did not stop"));
+ await assert.rejects(stop.run(), /did not stop/);
+ assert.deepEqual(stop.calls, ["mark-intent", "stop_server:8890", "clear-intent"]);
+});
diff --git a/studio/frontend/tests/forced-repair-retry.test.ts b/studio/frontend/tests/forced-repair-retry.test.ts
index 63d55941c24..fb7531e3060 100644
--- a/studio/frontend/tests/forced-repair-retry.test.ts
+++ b/studio/frontend/tests/forced-repair-retry.test.ts
@@ -60,7 +60,7 @@ function runRetry(status: string, forced: boolean): Run {
setCurrentStepIndex: noop,
setProgressDetail: noop,
setElevationPackages: noop,
- setIsExternalServer: noop,
+ setExternalServerPort: noop,
stopExternalServerPoll: noop,
stopManagedEnvironmentWait: noop,
};
diff --git a/studio/frontend/tests/managed-environment-wait.test.ts b/studio/frontend/tests/managed-environment-wait.test.ts
index 6d069162b48..0353773cccf 100644
--- a/studio/frontend/tests/managed-environment-wait.test.ts
+++ b/studio/frontend/tests/managed-environment-wait.test.ts
@@ -116,7 +116,7 @@ function harness(
setError: (error: string) => errors.push(error),
setInstallDiskFull: noop,
setApiBase: noop,
- setIsExternalServer: noop,
+ setExternalServerPort: noop,
stopExternalServerPoll: noop,
startExternalServerPoll: noop,
setRunningStatus: noop,
diff --git a/studio/src-tauri/src/commands.rs b/studio/src-tauri/src/commands.rs
index bb3414a30a5..73ccc73a2e2 100644
--- a/studio/src-tauri/src/commands.rs
+++ b/studio/src-tauri/src/commands.rs
@@ -343,18 +343,27 @@ pub async fn start_managed_server(
Ok(())
}
-/// Stop the current desktop-owned backend if this app can safely control it.
+/// Stop the backend this app owns or is attached to, if it can safely control it.
#[tauri::command]
pub async fn stop_server(
state: tauri::State<'_, BackendState>,
shutdown: tauri::State<'_, ShutdownFlag>,
diagnostics: tauri::State<'_, DiagnosticsState>,
+ port: Option<u16>,
) -> Result<(), String> {
info!("stop_server command called");
let state = state.inner().clone();
let shutdown = shutdown.inner().clone();
let diagnostics = diagnostics.inner().clone();
tauri::async_runtime::spawn_blocking(move || {
+ let attached_port = state
+ .lock()
+ .ok()
+ .filter(|proc| !proc.has_owned_backend())
+ .and_then(|proc| port.or(proc.port));
+ if let Some(port) = attached_port {
+ process::stop_attached_backend(port)?;
+ }
process::stop_backend(&state, &shutdown, Some(&diagnostics))
})
.await
diff --git a/studio/src-tauri/src/process.rs b/studio/src-tauri/src/process.rs
index 806b5de109c..d301678950f 100644
--- a/studio/src-tauri/src/process.rs
+++ b/studio/src-tauri/src/process.rs
@@ -4210,6 +4210,59 @@ fn stop_adopted_backend(
)
}
+// An accepted shutdown first lets a training run save, within the backend's 120 s default budget.
+const ATTACHED_SHUTDOWN_WAIT: Duration = Duration::from_secs(130);
+
+pub fn stop_attached_backend(port: u16) -> Result<(), String> {
+ if !crate::desktop_backend_owner::port_is_listening_blocking(port, Duration::from_millis(150)) {
+ return Ok(());
+ }
+ if try_exact_port_http_shutdown(port, "Attached backend")
+ && wait_for_port_disconnect(port, ATTACHED_SHUTDOWN_WAIT)
+ {
+ return Ok(());
+ }
+ Err(format!(
+ "The Unsloth server on port {port} did not stop. Stop it from the terminal that started it, then try again."
+ ))
+}
+
+#[cfg(test)]
+mod attached_backend_stop_tests {
+ use super::*;
+ use std::io::{Read, Write};
+
+ #[test]
+ fn an_attached_port_with_nothing_on_it_is_already_stopped() {
+ let port = std::net::TcpListener::bind(("127.0.0.1", 0))
+ .unwrap()
+ .local_addr()
+ .unwrap()
+ .port();
+ assert_eq!(stop_attached_backend(port), Ok(()));
+ }
+
+ #[test]
+ fn a_server_that_refuses_this_install_is_left_running() {
+ let listener = std::net::TcpListener::bind(("127.0.0.1", 0)).unwrap();
+ let port = listener.local_addr().unwrap().port();
+ std::thread::spawn(move || {
+ for mut stream in listener.incoming().flatten() {
+ let _ = stream.read(&mut [0u8; 4096]);
+ let _ = stream.write_all(
+ b"HTTP/1.1 401 Unauthorized\r\nContent-Length: 0\r\nConnection: close\r\n\r\n",
+ );
+ }
+ });
+
+ assert!(stop_attached_backend(port).is_err());
+ assert!(crate::desktop_backend_owner::port_is_listening_blocking(
+ port,
+ Duration::from_millis(150)
+ ));
+ }
+}
+
/// Graceful shutdown of owned backend handles.
/// Unix spawned: SIGTERM to process group -> wait -> SIGKILL.
/// Windows spawned: exact-port HTTP shutdown -> CTRL_BREAK_EVENT -> taskkill.