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.tsxindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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<Transcrvoid 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.tsindex 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(