Skip to content

Open source CapCut alternative.

TypeScript

fix(site): name a full disk plainly and show engine errors as their message [rebuild]

David Le2810974ec400
diff --git a/site/src/cut/components/AiPanel.tsx b/site/src/cut/components/AiPanel.tsx
index 280fb2f9..b02a4cb3 100644
--- a/site/src/cut/components/AiPanel.tsx
+++ b/site/src/cut/components/AiPanel.tsx
@@ -48,7 +48,7 @@ import {
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
-import { engineReady } from "@/cut/lib/api";
+import { apiJson, engineReady } from "@/cut/lib/api";
import { useCutCaps, useLocalCompute } from "@/cut/lib/backend/hooks";
import { localBackend } from "@/cut/lib/backend/local";
import { setAssetDragData } from "@/cut/lib/assetDrag";
@@ -1094,6 +1094,12 @@ function ChatSession({
let engineTransport: DefaultChatTransport<UIMessage> | null = null;
const engine = () =>
(engineTransport ??= new DefaultChatTransport<UIMessage>({
+ // A refused turn reads as its message; the transport would show the raw body.
+ fetch: async (input, init) => {
+ const res = await fetch(input, init);
+ if (res.ok) return res;
+ throw new Error((await apiJson(res)).error ?? `The engine replied ${res.status}.`);
+ },
// The engine origin is discovered asynchronously; await it per request
// (not at mount) so an early send still targets the local engine rather
// than the hosted origin, where the Cut APIs 404. engineReady memoizes,
@@ -1974,7 +1980,7 @@ function ChatSession({
{((error && !retryDisconnect) || sendError) && (
<div className="ai-error mt-2 flex items-start gap-2 rounded-lg bg-red-50 px-2.5 py-2 text-[11.5px] leading-relaxed text-red-700">
<TriangleAlert className="mt-0.5 size-3.5 shrink-0" />
- <span>
+ <span className="min-w-0 break-words">
{error ? (
<HostedErrorText error={error.message} link={false} />
) : (
diff --git a/site/src/cut/engine/serve.ts b/site/src/cut/engine/serve.ts
index 02c11125..dae717a7 100644
--- a/site/src/cut/engine/serve.ts
+++ b/site/src/cut/engine/serve.ts
@@ -4,6 +4,7 @@ import { flattenCutUsers, migrateCutDataDir } from "../server/migrateDataDir";
import { sweepPhoneInbox } from "../server/phoneLink";
import { reconcileProjectDirs } from "../server/projects";
import { ensureToolPath, resolveOnPath } from "../server/tool-path";
+import { errorMessage } from "../server/util";
import { enginePort } from "./config";
// Throws (and exits with a clear message) on a bad DONKEY_CUT_PORT rather than
@@ -84,7 +85,7 @@ async function start() {
status: response.status, statusText: response.statusText, headers: merged,
});
} catch (error) {
- return Response.json({ error: error instanceof Error ? error.message : String(error) }, { status: 500, headers });
+ return Response.json({ error: errorMessage(error, String(error)) }, { status: 500, headers });
}
},
});
diff --git a/site/src/cut/server/ai/turnStreams.ts b/site/src/cut/server/ai/turnStreams.ts
index a2cdf62e..026927c9 100644
--- a/site/src/cut/server/ai/turnStreams.ts
+++ b/site/src/cut/server/ai/turnStreams.ts
@@ -4,6 +4,7 @@ import { createHash } from "node:crypto";
import path from "node:path";
import type { UIMessageChunk } from "ai";
import { cutDataRoot } from "../dataDir";
+import { errorMessage } from "../util";
type Turn = { abort: AbortController; clients: number; finished: boolean; detached: () => void; attached: () => void };
const globalTurns = globalThis as unknown as { __cutChatTurns?: Map<string, Turn> };
@@ -44,7 +45,7 @@ export async function startTurnStream(
}
} catch (error) {
turn.abort.abort();
- await file.write(`data: ${JSON.stringify({ type: "error", errorText: error instanceof Error ? error.message : "Chat stopped." })}\n\n`);
+ await file.write(`data: ${JSON.stringify({ type: "error", errorText: errorMessage(error, "Chat stopped.") })}\n\n`);
} finally {
try { await file.write("data: [DONE]\n\n"); }
finally {
diff --git a/site/src/cut/server/http/ai.ts b/site/src/cut/server/http/ai.ts
index 380c8a63..6cc2ca71 100644
--- a/site/src/cut/server/http/ai.ts
+++ b/site/src/cut/server/http/ai.ts
@@ -23,6 +23,7 @@ import { writeVisualCues, type VisualFrame } from "../ai/visualSubtitles";
import { AI_SKILL_INDEX, AI_TOOLS, attachedAssetsBlock, readSkill, skillRelevanceBlock, systemPrompt } from "../ai/catalog";
import { STEP_BUDGET, stopText, turnClose, type TurnEnd } from "../../lib/turnBudget";
import { codexCommand } from "../tool-path";
+import { errorMessage } from "../util";
interface ChatBody {
threadId: string;
@@ -420,7 +421,7 @@ export const aiApi = {
return Response.json({ texts });
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Could not write captions." },
+ { error: errorMessage(e, "Could not write captions.") },
{ status: 500 }
);
}
@@ -442,7 +443,7 @@ export const aiApi = {
return Response.json({ cues });
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Could not caption the visuals." },
+ { error: errorMessage(e, "Could not caption the visuals.") },
{ status: 500 }
);
}
@@ -489,7 +490,7 @@ export const aiApi = {
await runCodex(emit, prompt, body, base, sessionKey, signal);
}
} catch (err) {
- emit({ type: "error", errorText: err instanceof Error ? err.message : String(err) });
+ emit({ type: "error", errorText: errorMessage(err, String(err)) });
} finally {
unregisterSession(sessionKey);
emit({ type: "finish" });
diff --git a/site/src/cut/server/http/convert.ts b/site/src/cut/server/http/convert.ts
index a08016f1..6c0a06fa 100644
--- a/site/src/cut/server/http/convert.ts
+++ b/site/src/cut/server/http/convert.ts
@@ -2,6 +2,7 @@ import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import { convertToMp4, mp4NameFor } from "../convert";
+import { errorMessage } from "../util";
/**
* Convert media the caller supplies, for a project this engine does not store.
@@ -33,7 +34,7 @@ export const convertApi = {
});
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Could not convert that file." },
+ { error: errorMessage(e, "Could not convert that file.") },
{ status: 500 }
);
} finally {
diff --git a/site/src/cut/server/http/export.ts b/site/src/cut/server/http/export.ts
index 00f7b938..0653bdf8 100644
--- a/site/src/cut/server/http/export.ts
+++ b/site/src/cut/server/http/export.ts
@@ -10,6 +10,7 @@ import {
type ExportSpec,
} from "../jobs";
import { serveFileRange } from "../serveFile";
+import { errorMessage } from "../util";
/** Export rendering: start a job, poll it, cancel it, download the result. */
export const exportApi = {
@@ -29,7 +30,7 @@ export const exportApi = {
return Response.json({ id: job.id });
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Export failed to start." },
+ { error: errorMessage(e, "Export failed to start.") },
{ status: 500 }
);
}
@@ -50,7 +51,7 @@ export const exportApi = {
return Response.json({ id: job.id, outName: job.outName });
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Export failed to start." },
+ { error: errorMessage(e, "Export failed to start.") },
{ status: 500 }
);
}
diff --git a/site/src/cut/server/http/library.ts b/site/src/cut/server/http/library.ts
index f8663f87..28d52062 100644
--- a/site/src/cut/server/http/library.ts
+++ b/site/src/cut/server/http/library.ts
@@ -24,11 +24,12 @@ import {
} from "../library";
import { serveFileRange, wantsDownload } from "../serveFile";
import { importFromUrl } from "../urlImport";
+import { errorMessage } from "../util";
const err = (message: string, status: number) =>
Response.json({ error: message }, { status });
const caught = (e: unknown, fallback: string) =>
- err(e instanceof Error ? e.message : fallback, 500);
+ err(errorMessage(e, fallback), 500);
/** The shared library: reusable media outside any project. */
export const libraryApi = {
diff --git a/site/src/cut/server/http/mic.ts b/site/src/cut/server/http/mic.ts
index 7e0eca30..8d8563ea 100644
--- a/site/src/cut/server/http/mic.ts
+++ b/site/src/cut/server/http/mic.ts
@@ -1,4 +1,5 @@
import { cancelMic, feedMic, getMicJob, startMicJob, stopMic } from "../mic";
+import { errorMessage } from "../util";
const err = (message: string, status: number) => Response.json({ error: message }, { status });
@@ -10,7 +11,7 @@ export const micApi = {
const job = await startMicJob(typeof body.locale === "string" ? body.locale : "en-US");
return Response.json({ id: job.id });
} catch (e) {
- return err(e instanceof Error ? e.message : "Could not start dictation.", 500);
+ return err(errorMessage(e, "Could not start dictation."), 500);
}
},
diff --git a/site/src/cut/server/http/phoneLink.ts b/site/src/cut/server/http/phoneLink.ts
index ffe0b246..cb2ee6b9 100644
--- a/site/src/cut/server/http/phoneLink.ts
+++ b/site/src/cut/server/http/phoneLink.ts
@@ -16,10 +16,11 @@ import {
removePhoneDevice,
} from "../phoneLink";
import { serveFileRange } from "../serveFile";
+import { errorMessage } from "../util";
const err = (message: string, status: number) => Response.json({ error: message }, { status });
const caught = (e: unknown, fallback: string) =>
- err(e instanceof Error ? e.message : fallback, 500);
+ err(errorMessage(e, fallback), 500);
/** The header a paired phone's traffic carries. The app's listener copies it
* across from the peer connection; nothing else on this Mac sets it. */
diff --git a/site/src/cut/server/http/projects.ts b/site/src/cut/server/http/projects.ts
index 083daa06..f8458722 100644
--- a/site/src/cut/server/http/projects.ts
+++ b/site/src/cut/server/http/projects.ts
@@ -29,11 +29,11 @@ import { makeProxy, proxyNameFor } from "../proxy";
import { serveFileRange, wantsDownload } from "../serveFile";
import { importUrlToProject } from "../urlImport";
import { createTranscribeJob, getTranscribeJob, type TranscribeSpec } from "../transcribe";
-import { exists, uniqueName } from "../util";
+import { exists, uniqueName, errorMessage } from "../util";
const err = (message: string, status: number) => Response.json({ error: message }, { status });
const caught = (e: unknown, fallback: string, status = 500) =>
- err(e instanceof Error ? e.message : fallback, status);
+ err(errorMessage(e, fallback), status);
const clamp = (v: number, lo: number, hi: number) => Math.max(lo, Math.min(hi, v));
/** Project CRUD, media, exports, transcription, freeze-frames. */
diff --git a/site/src/cut/server/http/proxy.ts b/site/src/cut/server/http/proxy.ts
index 3ad8cb8d..e07f516c 100644
--- a/site/src/cut/server/http/proxy.ts
+++ b/site/src/cut/server/http/proxy.ts
@@ -2,6 +2,7 @@ import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import { makeProxy, proxyNameFor } from "../proxy";
+import { errorMessage } from "../util";
/**
* Build a preview proxy of a master the caller supplies, for a project this
@@ -37,7 +38,7 @@ export const proxyApi = {
});
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Could not make the preview proxy." },
+ { error: errorMessage(e, "Could not make the preview proxy.") },
{ status: 500 }
);
} finally {
diff --git a/site/src/cut/server/http/routes.ts b/site/src/cut/server/http/routes.ts
index 85701596..ec78aa81 100644
--- a/site/src/cut/server/http/routes.ts
+++ b/site/src/cut/server/http/routes.ts
@@ -1,4 +1,5 @@
import { matchRouteTable } from "./match";
+import { errorMessage } from "../util";
import { aiApi } from "./ai";
import { localSceneLease } from "../ai/sceneLease";
import { convertApi } from "./convert";
@@ -140,7 +141,11 @@ export async function runCutRoute(
req: Request,
match: { handler: TableHandler; params: Record<string, string> }
): Promise<Response> {
- return match.handler(req, match.params);
+ try {
+ return await match.handler(req, match.params);
+ } catch (error) {
+ return Response.json({ error: errorMessage(error, "The request failed.") }, { status: 500 });
+ }
}
/**
diff --git a/site/src/cut/server/http/stt.ts b/site/src/cut/server/http/stt.ts
index a963e769..cff4a6ab 100644
--- a/site/src/cut/server/http/stt.ts
+++ b/site/src/cut/server/http/stt.ts
@@ -1,4 +1,5 @@
import { createAudioTranscribeJob, getTranscribeJob } from "../transcribe";
+import { errorMessage } from "../util";
/** On-device speech for audio the caller supplies, rather than for a project
* this engine stores: a cloud project renders its audible mix in the browser
@@ -22,7 +23,7 @@ export const sttApi = {
return Response.json({ id: job.id });
} catch (e) {
return Response.json(
- { error: e instanceof Error ? e.message : "Transcription failed to start." },
+ { error: errorMessage(e, "Transcription failed to start.") },
{ status: 500 }
);
}
diff --git a/site/src/cut/server/jobs.ts b/site/src/cut/server/jobs.ts
index 12c5105e..67f85e0a 100644
--- a/site/src/cut/server/jobs.ts
+++ b/site/src/cut/server/jobs.ts
@@ -7,6 +7,7 @@ import { createJobRegistry } from "./jobRegistry";
import { containerExtension, runExport, type ExportSpec } from "./exportPipeline";
import { exportBaseName } from "../lib/exportDelivery";
import { exportsDir, mediaPath, projectDir, readProject, setActiveJobGuard } from "./projects";
+import { errorMessage } from "./util";
export type { ExportSpec } from "./exportPipeline";
@@ -142,7 +143,7 @@ function startRun(job: Job, spec: ExportSpec) {
})
.catch((err: unknown) => {
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
void rm(job.outPath, { force: true }); // no half-written files in exports/
})
.finally(() => {
@@ -326,7 +327,7 @@ export async function createJob(form: FormData): Promise<Job> {
}
} catch (err) {
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
if (job.tmpDir) void rm(job.tmpDir, { recursive: true, force: true });
retire(job);
}
@@ -371,7 +372,7 @@ export async function createClientJob(
await mkdir(path.dirname(job.outPath), { recursive: true });
} catch (err) {
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
retire(job);
}
return job;
@@ -416,7 +417,7 @@ export async function completeClientJob(
} catch (err) {
await rm(partial, { force: true });
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
} finally {
retire(job);
}
diff --git a/site/src/cut/server/transcribe.ts b/site/src/cut/server/transcribe.ts
index 3e66ab27..522564c2 100644
--- a/site/src/cut/server/transcribe.ts
+++ b/site/src/cut/server/transcribe.ts
@@ -9,7 +9,7 @@ import { createJobRegistry } from "./jobRegistry";
import { mediaPath, readProject } from "./projects";
import { retimeOf, type SpeedNode } from "@donkeycut/effects-kit";
import { bakeRetimedAudio, type BakedAudio } from "./retimeAudio";
-import { atempoChain, findOnPath, hasStream, num, round } from "./util";
+import { atempoChain, findOnPath, hasStream, num, round, errorMessage } from "./util";
/** The audible slice of the cut, in timeline time (mirrors ExportSpec). */
export interface TranscribeSpec {
@@ -249,7 +249,7 @@ export async function createAudioTranscribeJob(
void runAudioTranscribe(job, audio, opts)
.catch((err: unknown) => {
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
})
.finally(() => retire(job));
return job;
@@ -301,7 +301,7 @@ export async function createTranscribeJob(spec: TranscribeSpec): Promise<Transcr
void runTranscribe(job, spec)
.catch((err: unknown) => {
job.status = "error";
- job.error = err instanceof Error ? err.message : String(err);
+ job.error = errorMessage(err, String(err));
})
.finally(() => retire(job));
return job;
diff --git a/site/src/cut/server/util.ts b/site/src/cut/server/util.ts
index a5fb5916..3cc21f70 100644
--- a/site/src/cut/server/util.ts
+++ b/site/src/cut/server/util.ts
@@ -2,6 +2,14 @@ import { spawn } from "node:child_process";
import { access, constants, rename, stat, writeFile } from "node:fs/promises";
import path from "node:path";
+/** A failure's message for the person. A full disk names itself in plain words;
+ * its raw text carries a code and a private path. */
+export function errorMessage(e: unknown, fallback: string): string {
+ const code = (e as { code?: unknown } | null)?.code;
+ if (code === "ENOSPC" || code === "EDQUOT") return "This Mac is out of disk space. Free up space and try again.";
+ return e instanceof Error ? e.message : fallback;
+}
+
/** Does a file/dir exist? (stat, coerced to a boolean.) */
export async function exists(p: string) {
return stat(p).then(