fix(clip): a clip is held to its owner's storage cap, and its limits and failures say the server's truth

- The cut file is measured against what its owner has left, for a YouTube range (whose fetch never
  reads yt-dlp's size ceiling) and for a Plex clip (which fetches nothing), before the fetch and
  again before it is placed; a refusal leaves the asset pending for a Retry.
- A silent Plex file is cut silent; a file the probe cannot read says so.
- A second job on a failed or renamed clip gets the same YouTube diagnosis and the fetched title.
- The "too long" refusal names the server's cap; a contract test holds the client's copies of the
  clip limits to clip.py; the shipped player clients are pinned against the installed yt-dlp.
- One HDR transfer set and one rating_key lookup; job status words from JobStatus; the display-name
  guard sees subscript writes and the clip route; stale comments and types follow the clip job.

frontend/src/lib/api/core.test.ts

@@ -261,6 +261,24 @@ describe("req — a structured refusal reads in the user's language", () => {
     ).rejects.toMatchObject({ detail: localized });
   });
 
+  it("states the clip cap the server refused with, not a copy of it", async () => {
+    // The cap is the server's (downloads/clip.py MAX_CLIP_S): a message with "10 minutes" baked in
+    // goes stale the day it moves.
+    const i18n = (await import("../../i18n")).default;
+    const t = vi.spyOn(i18n, "t");
+    vi.spyOn(globalThis, "fetch").mockResolvedValue(
+      new Response(JSON.stringify({ detail: { code: "clip", reason: "too_long", limit_s: 300 } }), {
+        status: 422,
+        headers: { "content-type": "application/json" },
+      }),
+    );
+    await req("/api/downloads/clip", { method: "POST" }, { quiet: true }).catch(() => undefined);
+    expect(t).toHaveBeenCalledWith(
+      "clip.errors.too_long",
+      expect.objectContaining({ minutes: "5" }),
+    );
+  });
+
   it.each(["quota", "reconnect", "unavailable"])(
     "says what to do about an action YouTube refused (%s)",
     async (reason) => {

frontend/src/lib/api/core.ts

@@ -81,7 +81,7 @@ function localizeDetail(d: unknown): string {
   // "check your input" message rather than leaking them into a translated sentence.
   if (Array.isArray(d)) return t("errors.validation");
   const o = d as
-    | { code?: string; reason?: string; limit?: number; min?: number }
+    | { code?: string; reason?: string; limit?: number; limit_s?: number; min?: number }
     | null
     | undefined;
   if (o?.code === "quota") {
@@ -95,8 +95,12 @@ function localizeDetail(d: unknown): string {
   if (o?.code === "edit")
     return t(`downloads.errors.edit.${o.reason}`, t("downloads.errors.edit.generic"));
   // A clip the server will not cut (downloads/clip): the range, the frame, the source. An unknown
-  // reason reads as the plain failure rather than a key.
-  if (o?.code === "clip") return t(`clip.errors.${o.reason}`, t("clip.failed"));
+  // reason reads as the plain failure rather than a key; a cap comes with the refusal (`limit_s`).
+  if (o?.code === "clip")
+    return t(`clip.errors.${o.reason}`, {
+      defaultValue: t("clip.failed"),
+      minutes: o.limit_s == null ? undefined : formatDecimal(o.limit_s / 60, i18n.language, 1, 0),
+    });
   if (o?.code === "cookies")
     return t(`downloads.errors.cookies.${o.reason}`, t("downloads.errors.cookies.generic"));
   // Password sign-in refusals. The card renders the account-shaped ones as a full panel

frontend/src/lib/api/downloads.ts

@@ -49,8 +49,7 @@ export type DownloadStatus = "queued" | "running" | "paused" | "done" | "error"
 // from the source). Only a download has a re-fetchable source; re-download refuses the rest.
 export type DownloadJobKind = "download" | "edit" | "upload" | "clip";
 
-// Phase-2 editor recipe. A single `trim` (one output file) or a `segments` cut-list joined into
-// one file. `accurate` re-encodes for a frame-accurate cut (a crop always re-encodes).
+// An ad-hoc clip (backend downloads/clip): a marked range of a YouTube video or a Plex item.
 export interface ClipRequest {
   source: "youtube" | "plex";
   ref: string;
@@ -62,6 +61,8 @@ export interface ClipRequest {
   display_name?: string;
 }
 
+// Phase-2 editor recipe. A single `trim` (one output file) or a `segments` cut-list joined into
+// one file. `accurate` re-encodes for a frame-accurate cut (a crop always re-encodes).
 export interface EditSpec {
   trim?: { start_s: number; end_s?: number };
   segments?: { start_s: number; end_s: number }[];
@@ -102,7 +103,8 @@ export interface DownloadJob {
   extra_links: string[]; // extra reference URLs (beyond source_url)
   job_kind?: DownloadJobKind; // see DownloadJobKind; absent reads as "download"
   source_job_id?: number | null; // parent download an edit was cut from
-  edit_spec?: EditSpec | null;
+  // An edit's recipe, or a clip's spec (its request without the name) — by job_kind.
+  edit_spec?: EditSpec | Omit<ClipRequest, "display_name"> | null;
   can_download: boolean;
   expired: boolean;
   asset: DownloadAsset | null;