Add Force reset to clear stuck jobs and kill a wedged Comfy.

Settings and the header menu can cancel invisible queue/pending work and force-stop Beast when Sleep is blocked.

Co-authored-by: Cursor <cursoragent@cursor.com>

server/utils/comfyLifecycle.ts

@@ -82,7 +82,7 @@ export async function fetchQueue() {
   }
 }
 
-async function controlRequest(path: string, method = 'GET', timeoutMs = 5000) {
+async function controlRequest(path: string, method = 'GET', timeoutMs = 5000, body?: Record<string, unknown>) {
   const { controlUrl, controlToken } = settings()
   if (!controlUrl) return null
   try {
@@ -90,11 +90,13 @@ async function controlRequest(path: string, method = 'GET', timeoutMs = 5000) {
       method,
       headers: {
         Accept: 'application/json',
+        ...(body ? { 'Content-Type': 'application/json' } : {}),
         ...(controlToken ? { Authorization: `Bearer ${controlToken}` } : {})
       },
+      ...(body ? { body: JSON.stringify(body) } : {}),
       signal: AbortSignal.timeout(timeoutMs)
     })
-    const body = await res.json().catch(() => null) as {
+    const payload = await res.json().catch(() => null) as {
       ok?: boolean
       http?: boolean
       process?: boolean
@@ -109,6 +111,7 @@ async function controlRequest(path: string, method = 'GET', timeoutMs = 5000) {
       proxyPort?: number | null
       stopped?: boolean
       killed?: unknown
+      forced?: boolean
       error?: string
       message?: string
       training?: { busy?: boolean; jobId?: string | null; status?: string | null; name?: string | null; message?: string }
@@ -120,15 +123,16 @@ async function controlRequest(path: string, method = 'GET', timeoutMs = 5000) {
       return {
         ok: false as const,
         status: res.status,
-        error: body?.error,
-        message: body?.message,
-        training: body?.training,
-        running: body?.running,
-        pending: body?.pending,
-        killed: body?.killed
+        error: payload?.error,
+        message: payload?.message,
+        training: payload?.training,
+        running: payload?.running,
+        pending: payload?.pending,
+        killed: payload?.killed,
+        forced: payload?.forced
       }
     }
-    return body || { ok: true }
+    return payload || { ok: true }
   } catch {
     return null
   }
@@ -216,6 +220,39 @@ export async function requestComfySleep() {
   }
 }
 
+/** Interrupt + clear Comfy queue, then kill the process even if a job is wedged. */
+export async function requestComfyForceReset() {
+  const { controlUrl } = settings()
+  if (!controlUrl) {
+    throw createError({
+      statusCode: 503,
+      statusMessage: 'COMFY_CONTROL_URL is not set. The studio cannot poke the Beast host agent.'
+    })
+  }
+  const { interruptComfy } = await import('~/server/utils/comfy')
+  await interruptComfy().catch(() => false)
+  const remote = await controlRequest('/stop', 'POST', 30_000, { force: true })
+  if (!remote) {
+    throw createError({
+      statusCode: 503,
+      statusMessage: 'Beast host agent is unreachable. Confirm it is running on the desktop.'
+    })
+  }
+  if (remote.ok === false) {
+    throw createError({
+      statusCode: Number(remote.status) || 502,
+      statusMessage: String(remote.message || remote.error || 'Beast host agent refused to force-stop Comfy.')
+    })
+  }
+  return {
+    ok: true,
+    stopped: true,
+    asleep: true,
+    forced: true,
+    killed: remote.killed ?? null
+  }
+}
+
 async function findLocalComfyProcess() {
   const platform = process.platform
   try {