nixamp 0.37.0 → 0.37.2

package/dist/ai-routes.js

@@ -94,7 +94,8 @@ export async function handleAiRoutes(request, response, path, url, ctx) {
                     return true;
                 }
                 if (method === "POST") {
-                    ctx.json(response, 200, { setting: shares.configure(await jsonBody(ctx, request)) });
+                    shares.configure(await jsonBody(ctx, request));
+                    ctx.json(response, 200, { setting: shares.setting() });
                     return true;
                 }
             }

package/dist/ai-text.js

@@ -41,62 +41,81 @@ export function hasModel(env = process.env) {
 export async function askJson(options) {
     const env = options.env ?? process.env;
     const send = options.fetcher ?? fetch;
-    const signal = AbortSignal.timeout(options.timeoutMs ?? 30_000);
     const gemini = aiKey("GEMINI_API_KEY", env);
     const openai = aiKey("OPENAI_API_KEY", env);
     const anthropic = aiKey("ANTHROPIC_API_KEY", env);
-    if (gemini) {
-        const model = env["NIXAMP_GEMINI_MODEL"] || "gemini-flash-latest";
-        const response = await send(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`, {
-            method: "POST",
-            signal,
-            headers: { "content-type": "application/json", "x-goog-api-key": gemini },
-            body: JSON.stringify({
-                systemInstruction: { parts: [{ text: options.system }] },
-                contents: [{ role: "user", parts: [{ text: options.prompt }] }],
-                generationConfig: { responseMimeType: "application/json", temperature: 0.9 },
-            }),
+    // Each model with a key, in turn: one that refuses this server (Gemini
+    // answers 400 "User location is not supported" from some networks) or is
+    // down is not a reason to go without when another can answer.
+    const tries = [];
+    if (gemini)
+        tries.push(async () => {
+            const model = env["NIXAMP_GEMINI_MODEL"] || "gemini-flash-latest";
+            const response = await send(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`, {
+                method: "POST",
+                signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
+                headers: { "content-type": "application/json", "x-goog-api-key": gemini },
+                body: JSON.stringify({
+                    systemInstruction: { parts: [{ text: options.system }] },
+                    contents: [{ role: "user", parts: [{ text: options.prompt }] }],
+                    generationConfig: { responseMimeType: "application/json", temperature: 0.9 },
+                }),
+            });
+            if (!response.ok) {
+                const said = (await response.json().catch(() => ({})));
+                throw new Error(`gemini answered HTTP ${response.status}${said.error?.message ? `: ${said.error.message}` : ""}`);
+            }
+            const body = (await response.json());
+            const text = body.candidates?.[0]?.content?.parts?.map((one) => one.text ?? "").join("") ?? "";
+            return { model, value: firstObject(text) };
         });
-        if (!response.ok)
-            throw new Error(`gemini answered HTTP ${response.status}`);
-        const body = (await response.json());
-        const text = body.candidates?.[0]?.content?.parts?.map((one) => one.text ?? "").join("") ?? "";
-        return { model, value: firstObject(text) };
-    }
-    if (openai) {
-        const model = env["NIXAMP_OPENAI_MODEL"] || "gpt-4.1-mini";
-        const response = await send("https://api.openai.com/v1/chat/completions", {
-            method: "POST",
-            signal,
-            headers: { "content-type": "application/json", authorization: `Bearer ${openai}` },
-            body: JSON.stringify({
-                model,
-                response_format: { type: "json_object" },
-                messages: [{ role: "system", content: options.system }, { role: "user", content: options.prompt }],
-            }),
+    if (openai)
+        tries.push(async () => {
+            const model = env["NIXAMP_OPENAI_MODEL"] || "gpt-4.1-mini";
+            const response = await send("https://api.openai.com/v1/chat/completions", {
+                method: "POST",
+                signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
+                headers: { "content-type": "application/json", authorization: `Bearer ${openai}` },
+                body: JSON.stringify({
+                    model,
+                    response_format: { type: "json_object" },
+                    messages: [{ role: "system", content: options.system }, { role: "user", content: options.prompt }],
+                }),
+            });
+            if (!response.ok)
+                throw new Error(`openai answered HTTP ${response.status}`);
+            const body = (await response.json());
+            return { model, value: firstObject(body.choices?.[0]?.message?.content ?? "") };
         });
-        if (!response.ok)
-            throw new Error(`openai answered HTTP ${response.status}`);
-        const body = (await response.json());
-        return { model, value: firstObject(body.choices?.[0]?.message?.content ?? "") };
-    }
-    if (anthropic) {
-        const model = env["NIXAMP_ANTHROPIC_MODEL"] || "claude-haiku-5-5";
-        const response = await send("https://api.anthropic.com/v1/messages", {
-            method: "POST",
-            signal,
-            headers: { "content-type": "application/json", "x-api-key": anthropic, "anthropic-version": "2023-06-01" },
-            body: JSON.stringify({
-                model,
-                max_tokens: 1024,
-                system: `${options.system}\nAnswer with one JSON object and nothing else.`,
-                messages: [{ role: "user", content: options.prompt }],
-            }),
+    if (anthropic)
+        tries.push(async () => {
+            const model = env["NIXAMP_ANTHROPIC_MODEL"] || "claude-haiku-5-5";
+            const response = await send("https://api.anthropic.com/v1/messages", {
+                method: "POST",
+                signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
+                headers: { "content-type": "application/json", "x-api-key": anthropic, "anthropic-version": "2023-06-01" },
+                body: JSON.stringify({
+                    model,
+                    max_tokens: 1024,
+                    system: `${options.system}\nAnswer with one JSON object and nothing else.`,
+                    messages: [{ role: "user", content: options.prompt }],
+                }),
+            });
+            if (!response.ok)
+                throw new Error(`anthropic answered HTTP ${response.status}`);
+            const body = (await response.json());
+            return { model, value: firstObject(body.content?.filter((one) => one.type === "text").map((one) => one.text ?? "").join("") ?? "") };
         });
-        if (!response.ok)
-            throw new Error(`anthropic answered HTTP ${response.status}`);
-        const body = (await response.json());
-        return { model, value: firstObject(body.content?.filter((one) => one.type === "text").map((one) => one.text ?? "").join("") ?? "") };
+    if (tries.length === 0)
+        throw new NoModel();
+    const failures = [];
+    for (const attempt of tries) {
+        try {
+            return await attempt();
+        }
+        catch (error) {
+            failures.push(error.message);
+        }
     }
-    throw new NoModel();
+    throw new Error(failures.join("; "));
 }

package/dist/playlist-input.d.ts

@@ -35,7 +35,7 @@ export interface PlaylistInput {
      * this time. The break is outside the rotation and the station's history.
      */
     breaks?: {
-        everySeconds: number;
+        everySeconds: number | (() => number);
         next: () => Promise<string | null>;
     };
     /** Told when an entry is passed over because it would not play. */

package/dist/playlist-input.js

@@ -97,7 +97,8 @@ export class PlaylistInputStream {
                     // A break, when one is due: in place of the next entry, which stays
                     // next. Not at the very start, and never inside an entry.
                     let breakFile = null;
-                    if (o.breaks && !first && offset - lastBreak >= o.breaks.everySeconds) {
+                    const every = typeof o.breaks?.everySeconds === "function" ? o.breaks.everySeconds() : (o.breaks?.everySeconds ?? 0);
+                    if (o.breaks && every > 0 && !first && offset - lastBreak >= every) {
                         lastBreak = offset;
                         breakFile = await o.breaks.next().catch(() => null);
                         if (signal.aborted)

package/dist/server.js

@@ -2335,6 +2335,7 @@ export function createHandler(engine, options) {
                     return selectStationFiles(engine, body);
                 },
                 trackFor: (file) => trackFor(engine, file),
+                ...(options.library ? { isVideo: (file) => options.library.index.itemAt(file)?.video === true } : {}),
                 base: `${scheme}://${request.headers.host ?? "localhost"}`,
                 publicBase: options.stations.publicBase?.() ?? "",
                 json,

package/dist/station-cli.js

@@ -87,6 +87,7 @@ export async function station(argv) {
             `  state       ${String(station["state"])} (wanted ${String(station["desired"])})`,
             `  visibility  ${String(station["visibility"])}${station["listed"] ? ", listed in the directory" : ""}`,
             `  rotation    ${station["shuffle"] ? "shuffle" : "in order"}${station["repeat"] ? ", repeating" : ", once"}; ${station["items"]?.length ?? 0} files at ${String(station["bitrate"])} kbps`,
+            `  breaks      ${Number(station["breaksEvery"] ?? 0) > 0 ? `a spot every ${Math.round(Number(station["breaksEvery"]) / 60)} min, between entries` : "none"}`,
             ...(station["error"] ? [`  problem     ${String(station["error"])}`] : []),
             ...(station["excluded"]?.length ? [`  left out   ${station["excluded"].length} files (nixamp station retry)`] : []),
             ...(station["visibility"] !== "private" && links["page"] ? [`  listen      ${links["page"]}`] : []),
@@ -127,6 +128,7 @@ export async function station(argv) {
                     shuffle: has(argv, "--shuffle"),
                     repeat: !has(argv, "--no-repeat"),
                     ...(bitrate ? { bitrate: Number(bitrate) } : {}),
+                    ...(flag(argv, "--breaks") ? { breaksEvery: Number(flag(argv, "--breaks")) } : {}),
                 });
                 return show(answer, (body) => `Made (private, stopped):\n${describe(body["station"])}`);
             }
@@ -146,6 +148,17 @@ export async function station(argv) {
                     return 2;
                 return show(await call("POST", `/api/v1/stations/${station}/${command}`, {}), (body) => describe(body["station"]));
             }
+            case "breaks": {
+                const station = needId();
+                if (!station)
+                    return 2;
+                const seconds = argv.includes("--off") ? 0 : Number(argv[argv.indexOf(station) + 1]);
+                if (!Number.isFinite(seconds)) {
+                    console.error("nixamp station breaks ID SECONDS (or --off)");
+                    return 2;
+                }
+                return show(await call("PATCH", `/api/v1/stations/${station}`, { breaksEvery: seconds }), (body) => describe(body["station"]));
+            }
             case "publish": {
                 const station = needId();
                 if (!station)
@@ -265,7 +278,7 @@ async function aiCommand(argv, call, show, json) {
     const describe = (one) => [
         `${String(one["name"])}  [${String(one["key"])}]${one["enabled"] ? "" : "  (off)"}`,
         `  style      ${String(one["style"])}`,
-        `  tracks     ${String(one["tracks"] ?? one["tracks"]?.length ?? 0)} of ${String(one["trackSeconds"])} s, ${String(one["perDay"])} a day${one["vocals"] ? ", with vocals" : ""}`,
+        `  tracks     ${Array.isArray(one["tracks"]) ? one["tracks"].length : Number(one["tracks"] ?? 0)} of ${String(one["trackSeconds"])} s, ${String(one["perDay"])} a day${one["vocals"] ? ", with vocals" : ""}`,
         `  station    ${one["stationId"] ? String(one["stationId"]) : "made with its first track"}${one["publish"] ? ", public on the guide" : ", unlisted"}`,
         ...(one["lastError"] ? [`  problem    ${String(one["lastError"])}`] : []),
     ].join("\n");
@@ -325,7 +338,7 @@ async function aiCommand(argv, call, show, json) {
                 ...(has(argv, "--off") ? { enabled: false } : has(argv, "--on") ? { enabled: true } : {}),
                 ...(has(argv, "--vocals") ? { vocals: true } : has(argv, "--instrumental") ? { vocals: false } : {}),
             };
-            return show(await call("PATCH", `/api/v1/stations/ai/stations/${key}`, body), (answer) => describe({ ...answer["station"], tracks: answer["station"]["tracks"].length }));
+            return show(await call("PATCH", `/api/v1/stations/ai/stations/${key}`, body), (answer) => describe(answer["station"]));
         }
         case "remove": {
             if (!key) {

package/dist/station-routes.d.ts

@@ -38,6 +38,8 @@ export interface StationContext {
         artist: string;
         album: string;
     } | null;
+    /** Whether the library knows this file as moving picture; absent in tests that do not care. */
+    isVideo?: (file: string) => boolean;
     /** This server's address as the asker reached it, for links. */
     base: string;
     /**

package/dist/station-routes.js

@@ -35,6 +35,9 @@ export function publicView(ctx, station) {
     const file = state === "live" || state === "recovering" ? nowPlayingFile(ctx, station) : "";
     // The tags the player read when it put this file on, else the library's.
     const track = file ? (ctx.channels.tagsOf(channelOf(station.id), file) ?? ctx.trackFor(file)) : null;
+    // What the channel is carrying wins over the flag: a station made by hand
+    // from films streams video whether or not anyone said so.
+    const video = station.video || ctx.channels.kindOf(channelOf(station.id)) === "video";
     return {
         id: station.id,
         name: station.name,
@@ -43,8 +46,8 @@ export function publicView(ctx, station) {
         state,
         // Tags, or nothing: a bare file name is the owner's, not the public's.
         nowPlaying: track && (track.title || track.artist) ? track : null,
-        kind: station.video ? "video" : "audio",
-        format: state === "stopped" || state === "offline" ? null : station.video
+        kind: video ? "video" : "audio",
+        format: state === "stopped" || state === "offline" ? null : video
             ? { codec: "h264+aac", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 }
             : { codec: "mp3", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 },
         listeners: ctx.runner.listeners(station.id),
@@ -277,6 +280,10 @@ export async function handleStations(request, response, path, url, ctx) {
                 const items = ctx.select(input);
                 if (items === null)
                     throw new StationError("items_required", "choose files by track index (items) or a folder");
+                // Unsaid, a station is TV when most of its files are.
+                if (input["video"] === undefined && ctx.isVideo) {
+                    input["video"] = items.filter((file) => ctx.isVideo(file)).length * 2 > items.length;
+                }
                 const station = ctx.store.create(input, items, ctx.account, Date.now(), key);
                 ctx.json(response, 201, { station: ownerView(ctx, station), created: true });
                 return true;

package/dist/station-runner.js

@@ -107,8 +107,10 @@ export class StationRunner {
                         return now ? this.playable(now) : [];
                     },
                     excluded: (file) => store.isExcluded(id, file),
-                    ...(station.breaksEvery > 0 && this.deps.breaks
-                        ? { breaks: { everySeconds: station.breaksEvery, next: () => this.deps.breaks(station.video) } }
+                    // Read at every boundary, so setting breaks on a running station
+                    // lands without a restart; 0 is none.
+                    ...(this.deps.breaks
+                        ? { breaks: { everySeconds: () => store.get(id)?.breaksEvery ?? 0, next: () => this.deps.breaks(station.video) } }
                         : {}),
                     onFailure: ({ file, reason }) => {
                         this.errors.set(id, reason);

package/dist/station-usage.d.ts

@@ -1,2 +1,2 @@
 /** `nixamp station` usage, apart so `nixamp help station` does not load the client. */
-export declare const USAGE = "nixamp station \u2014 make a collection into a station\n\n  nixamp station list\n  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128]\n  nixamp station show ID\n  nixamp station status ID\n  nixamp station start ID\n  nixamp station stop ID\n  nixamp station skip ID\n  nixamp station retry ID          try every left-out file again\n  nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]\n  nixamp station unpublish ID [--private]\n  nixamp station link ID [--rotate]\n  nixamp station delete ID\n  nixamp station guide-host NAME [--remove]\n                     NAME's front page is the public station guide (e.g. a Moshpit name)\n  nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]\n                     a station per genre, kept in step with the library (--off stops it)\n\n  AI radio (music composed for a station, a few tracks a day):\n  nixamp station ai                          what is composing, this month's seconds, the stations\n  nixamp station ai create (--preset lofi|synthwave|ambient|chiptune|punk|jazz | --name NAME --style TEXT)\n                     [--vocals] [--seconds 120] [--per-day 2] [--unlisted]   public on the guide unless --unlisted\n  nixamp station ai generate KEY             compose one now\n  nixamp station ai set KEY [--style TEXT] [--per-day N] [--seconds N] [--off|--on]\n  nixamp station ai remove KEY [--files]\n  nixamp station ai budget SECONDS           seconds of music a month across AI stations (0: no cap)\n  nixamp station ai resume                   after the provider ran out of credit\n  nixamp station ai key NAME                 ELEVENLABS_API_KEY | GEMINI_API_KEY | OPENAI_API_KEY | ANTHROPIC_API_KEY, from stdin\n\n  Listener shares (anybody shares an MP3 link or file from the guide; AI files and checks it):\n  nixamp station shares                      the setting and what is waiting\n  nixamp station shares on [--owner-moderation] [--unlisted] [--max-mb 60] [--per-hour 6]\n  nixamp station shares off\n  nixamp station shares list [--state held|approved|reported|rejected]\n  nixamp station shares approve|reject|delete SHARE\n  nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For\n\n  --json        machine-readable output\n  --url, --key  another server, as with `nixamp admin`\n\nA new station is private and stopped. Starting it does not publish it.";
+export declare const USAGE = "nixamp station \u2014 make a collection into a station\n\n  nixamp station list\n  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128] [--breaks 600]\n  nixamp station show ID\n  nixamp station status ID\n  nixamp station start ID\n  nixamp station stop ID\n  nixamp station skip ID\n  nixamp station breaks ID SECONDS a spot between entries every SECONDS (120..86400; --off for none)\n  nixamp station retry ID          try every left-out file again\n  nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]\n  nixamp station unpublish ID [--private]\n  nixamp station link ID [--rotate]\n  nixamp station delete ID\n  nixamp station guide-host NAME [--remove]\n                     NAME's front page is the public station guide (e.g. a Moshpit name)\n  nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]\n                     a station per genre, kept in step with the library (--off stops it)\n\n  AI radio (music composed for a station, a few tracks a day):\n  nixamp station ai                          what is composing, this month's seconds, the stations\n  nixamp station ai create (--preset lofi|synthwave|ambient|chiptune|punk|jazz | --name NAME --style TEXT)\n                     [--vocals] [--seconds 120] [--per-day 2] [--unlisted]   public on the guide unless --unlisted\n  nixamp station ai generate KEY             compose one now\n  nixamp station ai set KEY [--style TEXT] [--per-day N] [--seconds N] [--off|--on]\n  nixamp station ai remove KEY [--files]\n  nixamp station ai budget SECONDS           seconds of music a month across AI stations (0: no cap)\n  nixamp station ai resume                   after the provider ran out of credit\n  nixamp station ai key NAME                 ELEVENLABS_API_KEY | GEMINI_API_KEY | OPENAI_API_KEY | ANTHROPIC_API_KEY, from stdin\n\n  Listener shares (anybody shares an MP3 link or file from the guide; AI files and checks it):\n  nixamp station shares                      the setting and what is waiting\n  nixamp station shares on [--owner-moderation] [--unlisted] [--max-mb 60] [--per-hour 6]\n  nixamp station shares off\n  nixamp station shares list [--state held|approved|reported|rejected]\n  nixamp station shares approve|reject|delete SHARE\n  nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For\n\n  --json        machine-readable output\n  --url, --key  another server, as with `nixamp admin`\n\nA new station is private and stopped. Starting it does not publish it.";

package/dist/station-usage.js

@@ -2,12 +2,13 @@
 export const USAGE = `nixamp station — make a collection into a station
 
   nixamp station list
-  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128]
+  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128] [--breaks 600]
   nixamp station show ID
   nixamp station status ID
   nixamp station start ID
   nixamp station stop ID
   nixamp station skip ID
+  nixamp station breaks ID SECONDS a spot between entries every SECONDS (120..86400; --off for none)
   nixamp station retry ID          try every left-out file again
   nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]
   nixamp station unpublish ID [--private]

package/dist/stations.js

@@ -231,6 +231,8 @@ export class StationStore {
             station.bitrate = this.bitrateFrom(input.bitrate);
         if (input.breaksEvery !== undefined)
             station.breaksEvery = this.breaksFrom(input.breaksEvery);
+        if (input.video !== undefined)
+            station.video = input.video === true;
         if (items !== null) {
             if (items.length === 0)
                 throw new StationError("empty_station", "a station needs at least one file that plays");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nixamp",
-  "version": "0.37.0",
+  "version": "0.37.2",
   "description": "It really whips the terminal's ass. A Winamp-shaped audio player for your terminal.",
   "license": "MIT",
   "type": "module",

package/src/ai-routes.ts

@@ -127,7 +127,8 @@ export async function handleAiRoutes(
           return true;
         }
         if (method === "POST") {
-          ctx.json(response, 200, { setting: shares.configure(await jsonBody(ctx, request)) });
+          shares.configure(await jsonBody(ctx, request));
+          ctx.json(response, 200, { setting: shares.setting() });
           return true;
         }
       }

package/src/ai-text.ts

@@ -59,15 +59,18 @@ export function hasModel(env: Record<string, string | undefined> = process.env):
 export async function askJson(options: AskOptions): Promise<Answer> {
   const env = options.env ?? process.env;
   const send = options.fetcher ?? fetch;
-  const signal = AbortSignal.timeout(options.timeoutMs ?? 30_000);
   const gemini = aiKey("GEMINI_API_KEY", env);
   const openai = aiKey("OPENAI_API_KEY", env);
   const anthropic = aiKey("ANTHROPIC_API_KEY", env);
-  if (gemini) {
+  // Each model with a key, in turn: one that refuses this server (Gemini
+  // answers 400 "User location is not supported" from some networks) or is
+  // down is not a reason to go without when another can answer.
+  const tries: Array<() => Promise<Answer>> = [];
+  if (gemini) tries.push(async () => {
     const model = env["NIXAMP_GEMINI_MODEL"] || "gemini-flash-latest";
     const response = await send(`https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`, {
       method: "POST",
-      signal,
+      signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
       headers: { "content-type": "application/json", "x-goog-api-key": gemini },
       body: JSON.stringify({
         systemInstruction: { parts: [{ text: options.system }] },
@@ -75,16 +78,19 @@ export async function askJson(options: AskOptions): Promise<Answer> {
         generationConfig: { responseMimeType: "application/json", temperature: 0.9 },
       }),
     });
-    if (!response.ok) throw new Error(`gemini answered HTTP ${response.status}`);
+    if (!response.ok) {
+      const said = (await response.json().catch(() => ({}))) as { error?: { message?: string } };
+      throw new Error(`gemini answered HTTP ${response.status}${said.error?.message ? `: ${said.error.message}` : ""}`);
+    }
     const body = (await response.json()) as { candidates?: Array<{ content?: { parts?: Array<{ text?: string }> } }> };
     const text = body.candidates?.[0]?.content?.parts?.map((one) => one.text ?? "").join("") ?? "";
     return { model, value: firstObject(text) };
-  }
-  if (openai) {
+  });
+  if (openai) tries.push(async () => {
     const model = env["NIXAMP_OPENAI_MODEL"] || "gpt-4.1-mini";
     const response = await send("https://api.openai.com/v1/chat/completions", {
       method: "POST",
-      signal,
+      signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
       headers: { "content-type": "application/json", authorization: `Bearer ${openai}` },
       body: JSON.stringify({
         model,
@@ -95,12 +101,12 @@ export async function askJson(options: AskOptions): Promise<Answer> {
     if (!response.ok) throw new Error(`openai answered HTTP ${response.status}`);
     const body = (await response.json()) as { choices?: Array<{ message?: { content?: string } }> };
     return { model, value: firstObject(body.choices?.[0]?.message?.content ?? "") };
-  }
-  if (anthropic) {
+  });
+  if (anthropic) tries.push(async () => {
     const model = env["NIXAMP_ANTHROPIC_MODEL"] || "claude-haiku-5-5";
     const response = await send("https://api.anthropic.com/v1/messages", {
       method: "POST",
-      signal,
+      signal: AbortSignal.timeout(options.timeoutMs ?? 30_000),
       headers: { "content-type": "application/json", "x-api-key": anthropic, "anthropic-version": "2023-06-01" },
       body: JSON.stringify({
         model,
@@ -112,6 +118,15 @@ export async function askJson(options: AskOptions): Promise<Answer> {
     if (!response.ok) throw new Error(`anthropic answered HTTP ${response.status}`);
     const body = (await response.json()) as { content?: Array<{ type: string; text?: string }> };
     return { model, value: firstObject(body.content?.filter((one) => one.type === "text").map((one) => one.text ?? "").join("") ?? "") };
+  });
+  if (tries.length === 0) throw new NoModel();
+  const failures: string[] = [];
+  for (const attempt of tries) {
+    try {
+      return await attempt();
+    } catch (error) {
+      failures.push((error as Error).message);
+    }
   }
-  throw new NoModel();
+  throw new Error(failures.join("; "));
 }

package/src/playlist-input.ts

@@ -39,7 +39,7 @@ export interface PlaylistInput {
    * `next` answers a file to play (an advert, an ident) or null for no break
    * this time. The break is outside the rotation and the station's history.
    */
-  breaks?: { everySeconds: number; next: () => Promise<string | null> };
+  breaks?: { everySeconds: number | (() => number); next: () => Promise<string | null> };
   /** Told when an entry is passed over because it would not play. */
   onFailure?: (event: { at: number; file: string; reason: string }) => void;
 }
@@ -138,7 +138,8 @@ export class PlaylistInputStream {
           // A break, when one is due: in place of the next entry, which stays
           // next. Not at the very start, and never inside an entry.
           let breakFile: string | null = null;
-          if (o.breaks && !first && offset - lastBreak >= o.breaks.everySeconds) {
+          const every = typeof o.breaks?.everySeconds === "function" ? o.breaks.everySeconds() : (o.breaks?.everySeconds ?? 0);
+          if (o.breaks && every > 0 && !first && offset - lastBreak >= every) {
             lastBreak = offset;
             breakFile = await o.breaks.next().catch(() => null);
             if (signal.aborted) return;

package/src/server.ts

@@ -2861,6 +2861,7 @@ export function createHandler(engine: Engine, options: HandlerOptions) {
           return selectStationFiles(engine, body);
         },
         trackFor: (file) => trackFor(engine, file),
+        ...(options.library ? { isVideo: (file: string) => options.library!.index.itemAt(file)?.video === true } : {}),
         base: `${scheme}://${request.headers.host ?? "localhost"}`,
         publicBase: options.stations.publicBase?.() ?? "",
         json,

package/src/station-cli.ts

@@ -88,6 +88,7 @@ export async function station(argv: string[]): Promise<number> {
       `  state       ${String(station["state"])} (wanted ${String(station["desired"])})`,
       `  visibility  ${String(station["visibility"])}${station["listed"] ? ", listed in the directory" : ""}`,
       `  rotation    ${station["shuffle"] ? "shuffle" : "in order"}${station["repeat"] ? ", repeating" : ", once"}; ${(station["items"] as unknown[] | undefined)?.length ?? 0} files at ${String(station["bitrate"])} kbps`,
+      `  breaks      ${Number(station["breaksEvery"] ?? 0) > 0 ? `a spot every ${Math.round(Number(station["breaksEvery"]) / 60)} min, between entries` : "none"}`,
       ...(station["error"] ? [`  problem     ${String(station["error"])}`] : []),
       ...((station["excluded"] as unknown[] | undefined)?.length ? [`  left out   ${(station["excluded"] as unknown[]).length} files (nixamp station retry)`] : []),
       ...(station["visibility"] !== "private" && links["page"] ? [`  listen      ${links["page"]}`] : []),
@@ -128,6 +129,7 @@ export async function station(argv: string[]): Promise<number> {
           shuffle: has(argv, "--shuffle"),
           repeat: !has(argv, "--no-repeat"),
           ...(bitrate ? { bitrate: Number(bitrate) } : {}),
+          ...(flag(argv, "--breaks") ? { breaksEvery: Number(flag(argv, "--breaks")) } : {}),
         });
         return show(answer, (body) => `Made (private, stopped):\n${describe(body["station"] as Record<string, unknown>)}`);
       }
@@ -145,6 +147,16 @@ export async function station(argv: string[]): Promise<number> {
         if (!station) return 2;
         return show(await call("POST", `/api/v1/stations/${station}/${command}`, {}), (body) => describe(body["station"] as Record<string, unknown>));
       }
+      case "breaks": {
+        const station = needId();
+        if (!station) return 2;
+        const seconds = argv.includes("--off") ? 0 : Number(argv[argv.indexOf(station) + 1]);
+        if (!Number.isFinite(seconds)) {
+          console.error("nixamp station breaks ID SECONDS (or --off)");
+          return 2;
+        }
+        return show(await call("PATCH", `/api/v1/stations/${station}`, { breaksEvery: seconds }), (body) => describe(body["station"] as Record<string, unknown>));
+      }
       case "publish": {
         const station = needId();
         if (!station) return 2;
@@ -259,7 +271,7 @@ async function aiCommand(argv: string[], call: Call, show: Show, json: boolean):
   const describe = (one: Record<string, unknown>): string => [
     `${String(one["name"])}  [${String(one["key"])}]${one["enabled"] ? "" : "  (off)"}`,
     `  style      ${String(one["style"])}`,
-    `  tracks     ${String(one["tracks"] ?? (one["tracks"] as unknown[] | undefined)?.length ?? 0)} of ${String(one["trackSeconds"])} s, ${String(one["perDay"])} a day${one["vocals"] ? ", with vocals" : ""}`,
+    `  tracks     ${Array.isArray(one["tracks"]) ? one["tracks"].length : Number(one["tracks"] ?? 0)} of ${String(one["trackSeconds"])} s, ${String(one["perDay"])} a day${one["vocals"] ? ", with vocals" : ""}`,
     `  station    ${one["stationId"] ? String(one["stationId"]) : "made with its first track"}${one["publish"] ? ", public on the guide" : ", unlisted"}`,
     ...(one["lastError"] ? [`  problem    ${String(one["lastError"])}`] : []),
   ].join("\n");
@@ -313,7 +325,7 @@ async function aiCommand(argv: string[], call: Call, show: Show, json: boolean):
         ...(has(argv, "--off") ? { enabled: false } : has(argv, "--on") ? { enabled: true } : {}),
         ...(has(argv, "--vocals") ? { vocals: true } : has(argv, "--instrumental") ? { vocals: false } : {}),
       };
-      return show(await call("PATCH", `/api/v1/stations/ai/stations/${key}`, body), (answer) => describe({ ...(answer["station"] as Record<string, unknown>), tracks: ((answer["station"] as Record<string, unknown>)["tracks"] as unknown[]).length }));
+      return show(await call("PATCH", `/api/v1/stations/ai/stations/${key}`, body), (answer) => describe(answer["station"] as Record<string, unknown>));
     }
     case "remove": {
       if (!key) { console.error("nixamp station ai remove needs the AI station's key"); return 2; }

package/src/station-routes.ts

@@ -40,6 +40,8 @@ export interface StationContext {
   select: (body: { items?: unknown; folder?: unknown }) => string[] | null;
   /** What the library knows about a file, for now playing. */
   trackFor: (file: string) => { title: string; artist: string; album: string } | null;
+  /** Whether the library knows this file as moving picture; absent in tests that do not care. */
+  isVideo?: (file: string) => boolean;
   /** This server's address as the asker reached it, for links. */
   base: string;
   /**
@@ -92,6 +94,9 @@ export function publicView(ctx: StationContext, station: Station): PublicStation
   const file = state === "live" || state === "recovering" ? nowPlayingFile(ctx, station) : "";
   // The tags the player read when it put this file on, else the library's.
   const track = file ? (ctx.channels.tagsOf(channelOf(station.id), file) ?? ctx.trackFor(file)) : null;
+  // What the channel is carrying wins over the flag: a station made by hand
+  // from films streams video whether or not anyone said so.
+  const video = station.video || ctx.channels.kindOf(channelOf(station.id)) === "video";
   return {
     id: station.id,
     name: station.name,
@@ -100,8 +105,8 @@ export function publicView(ctx: StationContext, station: Station): PublicStation
     state,
     // Tags, or nothing: a bare file name is the owner's, not the public's.
     nowPlaying: track && (track.title || track.artist) ? track : null,
-    kind: station.video ? "video" : "audio",
-    format: state === "stopped" || state === "offline" ? null : station.video
+    kind: video ? "video" : "audio",
+    format: state === "stopped" || state === "offline" ? null : video
       ? { codec: "h264+aac", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 }
       : { codec: "mp3", bitrateKbps: station.bitrate, sampleRate: 48_000, channels: 2 },
     listeners: ctx.runner.listeners(station.id),
@@ -342,6 +347,10 @@ export async function handleStations(
         }
         const items = ctx.select(input);
         if (items === null) throw new StationError("items_required", "choose files by track index (items) or a folder");
+        // Unsaid, a station is TV when most of its files are.
+        if (input["video"] === undefined && ctx.isVideo) {
+          input["video"] = items.filter((file) => ctx.isVideo!(file)).length * 2 > items.length;
+        }
         const station = ctx.store.create(input, items, ctx.account, Date.now(), key);
         ctx.json(response, 201, { station: ownerView(ctx, station), created: true });
         return true;

package/src/station-runner.ts

@@ -145,8 +145,10 @@ export class StationRunner {
             return now ? this.playable(now) : [];
           },
           excluded: (file) => store.isExcluded(id, file),
-          ...(station.breaksEvery > 0 && this.deps.breaks
-            ? { breaks: { everySeconds: station.breaksEvery, next: () => this.deps.breaks!(station.video) } }
+          // Read at every boundary, so setting breaks on a running station
+          // lands without a restart; 0 is none.
+          ...(this.deps.breaks
+            ? { breaks: { everySeconds: () => store.get(id)?.breaksEvery ?? 0, next: () => this.deps.breaks!(station.video) } }
             : {}),
           onFailure: ({ file, reason }) => {
             this.errors.set(id, reason);

package/src/station-usage.ts

@@ -2,12 +2,13 @@
 export const USAGE = `nixamp station — make a collection into a station
 
   nixamp station list
-  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128]
+  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128] [--breaks 600]
   nixamp station show ID
   nixamp station status ID
   nixamp station start ID
   nixamp station stop ID
   nixamp station skip ID
+  nixamp station breaks ID SECONDS a spot between entries every SECONDS (120..86400; --off for none)
   nixamp station retry ID          try every left-out file again
   nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]
   nixamp station unpublish ID [--private]

package/src/stations.ts

@@ -284,6 +284,7 @@ export class StationStore {
     if (input.repeat !== undefined) station.repeat = input.repeat !== false;
     if (input.bitrate !== undefined) station.bitrate = this.bitrateFrom(input.bitrate);
     if (input.breaksEvery !== undefined) station.breaksEvery = this.breaksFrom(input.breaksEvery);
+    if (input.video !== undefined) station.video = input.video === true;
     if (items !== null) {
       if (items.length === 0) throw new StationError("empty_station", "a station needs at least one file that plays");
       if (items.length > MAX_ITEMS) throw new StationError("too_many_items", `a station holds at most ${MAX_ITEMS} files`);