nixamp 0.48.1 → 0.49.0

package/dist/station-cli.js

@@ -282,6 +282,8 @@ export async function station(argv) {
             }
             case "ai":
                 return await aiCommand(argv.slice(1), call, show, json);
+            case "label":
+                return await labelCommand(argv.slice(1), call, show);
             case "shares":
                 return await sharesCommand(argv.slice(1), call, show);
             case "lyrics":
@@ -438,6 +440,113 @@ async function aiCommand(argv, call, show, json) {
             return 2;
     }
 }
+/** `nixamp station label ...`: AI artists who put out an album a month (ai-label.ts). */
+async function labelCommand(argv, call, show) {
+    const [sub, key] = argv;
+    const when = (at) => at === -1 ? "never (off)" : at === 0 ? "now" : new Date(at).toISOString().slice(0, 10);
+    const describe = (one) => {
+        const albums = one["albums"] ?? [];
+        return [
+            `${String(one["name"])}  [${String(one["key"])}]  ${String(one["genre"])}${one["enabled"] ? "" : "  (off)"}`,
+            ...albums.map((album) => `  ${String(album["year"])}  ${String(album["title"])}  ${String(album["composed"])}/${String(album["songs"])} songs${album["doneAt"] ? "" : "  (recording)"}`),
+            `  next album ${when(Number(one["nextAlbumAt"] ?? -1))}`,
+            ...(one["lastError"] ? [`  problem    ${String(one["lastError"])}`] : []),
+        ].join("\n");
+    };
+    switch (sub) {
+        case undefined:
+        case "status":
+        case "list":
+            return show(await call("GET", "/api/v1/stations/label"), (body) => {
+                const settings = (body["settings"] ?? {});
+                const artists = body["artists"] ?? [];
+                const roster = body["roster"] ?? [];
+                return [
+                    `holder     ${String(settings["holder"])}${settings["enabled"] ? "" : "  (off)"}`,
+                    `files      ${String(body["root"])}/<genre>/<artist>/<year>-<album>/`,
+                    `composer   ${String(body["composer"] ?? "none")}; words by ${String(body["writer"] ?? "nobody (no model key)")}`,
+                    `this month ${String(body["secondsThisMonth"])} of ${Number(settings["monthlySeconds"]) === 0 ? "unlimited" : String(settings["monthlySeconds"])} s${body["busy"] ? `; recording ${String(body["busy"])}` : ""}`,
+                    `albums     ${String(settings["songsPerAlbum"])} songs of ${String(settings["songSeconds"])} s; ${String(settings["seedAlbums"])} to start, then one every ${String(settings["everyDays"])} days`,
+                    ...(body["waiting"] ? [`waiting    ${String(body["waiting"])}`] : []),
+                    "",
+                    ...(artists.length ? artists.map(describe) : ["Nobody signed yet. nixamp station label sign --roster"]),
+                    "",
+                    `roster     ${roster.map((one) => `${String(one["key"])}${one["signed"] ? " (signed)" : ""}`).join(", ")}`,
+                ].join("\n");
+            });
+        case "sign": {
+            const body = has(argv, "--roster") ? { roster: true } : {
+                ...(flag(argv, "--preset") ? { preset: flag(argv, "--preset") } : {}),
+                ...(flag(argv, "--name") ? { name: flag(argv, "--name") } : {}),
+                ...(flag(argv, "--genre") ? { genre: flag(argv, "--genre") } : {}),
+                ...(flag(argv, "--sound") ? { sound: flag(argv, "--sound") } : {}),
+                ...(flag(argv, "--voice") ? { voice: flag(argv, "--voice") } : {}),
+                ...(flag(argv, "--bio") ? { bio: flag(argv, "--bio") } : {}),
+                ...(flag(argv, "--themes") ? { themes: flag(argv, "--themes") } : {}),
+            };
+            return show(await call("POST", "/api/v1/stations/label/artists", body), (answer) => {
+                const signed = answer["artists"] ?? (answer["artist"] ? [answer["artist"]] : []);
+                return signed.length ? `Signed ${signed.map((one) => `${String(one["name"])} (${String(one["genre"])})`).join(", ")}. Their first albums are planned and recorded from here.` : "Everybody on the roster is already signed.";
+            });
+        }
+        case "album": {
+            if (!key) {
+                console.error("nixamp station label album needs the artist's key (nixamp station label)");
+                return 2;
+            }
+            return show(await call("POST", `/api/v1/stations/label/artists/${key}/album`, {}), (answer) => {
+                const album = answer["album"];
+                return `Planned "${String(album["title"])}" (${(album["songs"] ?? []).length} songs); recording now, a song at a time.`;
+            });
+        }
+        case "set": {
+            if (!key) {
+                console.error("nixamp station label set needs the artist's key");
+                return 2;
+            }
+            const body = {
+                ...(flag(argv, "--sound") ? { sound: flag(argv, "--sound") } : {}),
+                ...(flag(argv, "--voice") ? { voice: flag(argv, "--voice") } : {}),
+                ...(flag(argv, "--bio") ? { bio: flag(argv, "--bio") } : {}),
+                ...(flag(argv, "--themes") ? { themes: flag(argv, "--themes") } : {}),
+                ...(has(argv, "--off") ? { enabled: false } : has(argv, "--on") ? { enabled: true } : {}),
+            };
+            return show(await call("PATCH", `/api/v1/stations/label/artists/${key}`, body), (answer) => `${String(answer["artist"]["name"])} updated.`);
+        }
+        case "drop": {
+            if (!key) {
+                console.error("nixamp station label drop needs the artist's key");
+                return 2;
+            }
+            const files = has(argv, "--files");
+            return show(await call("DELETE", `/api/v1/stations/label/artists/${key}${files ? "?files=1" : ""}`), () => files ? "Dropped, with their music." : "Dropped. Their albums stay on the air; nothing new will be recorded.");
+        }
+        case "config": {
+            const number = (name) => (flag(argv, name) === undefined ? undefined : Number(flag(argv, name)));
+            const body = Object.fromEntries(Object.entries({
+                holder: flag(argv, "--holder"),
+                monthlySeconds: number("--budget"),
+                everyDays: number("--every-days"),
+                seedAlbums: number("--seed-albums"),
+                songsPerAlbum: number("--songs"),
+                songSeconds: number("--seconds"),
+                enabled: has(argv, "--off") ? false : has(argv, "--on") ? true : undefined,
+                publish: has(argv, "--unlisted") ? false : has(argv, "--public") ? true : undefined,
+            }).filter(([, value]) => value !== undefined));
+            return show(await call("POST", "/api/v1/stations/label", body), (answer) => {
+                const settings = answer["settings"];
+                return `Label: ${String(settings["holder"])}, ${String(settings["songsPerAlbum"])} songs of ${String(settings["songSeconds"])} s an album, every ${String(settings["everyDays"])} days, at most ${Number(settings["monthlySeconds"]) === 0 ? "unlimited" : `${String(settings["monthlySeconds"])} s`} a month${settings["enabled"] ? "" : " (off)"}.`;
+            });
+        }
+        case "run":
+            return show(await call("POST", "/api/v1/stations/label/run", {}), (body) => body["waiting"] ? `Nothing to record now: ${String(body["waiting"])}.` : "Recording whatever is due.");
+        case "resume":
+            return show(await call("POST", "/api/v1/stations/label", { resume: true }), () => "Recording again.");
+        default:
+            console.error(`nixamp station label: no command "${sub}".\n\n${USAGE}`);
+            return 2;
+    }
+}
 /** `nixamp station lyrics ...`: our own songs' words, published back to nichedb.dev. */
 async function lyricsCommand(argv, call, show, json) {
     const [sub, id] = argv;

package/dist/station-guide.d.ts

@@ -27,7 +27,7 @@ export interface GuideEntry {
  * gateway that cannot run its script against this server (the Moshpit's
  * /n/<name>), and for a crawler. Everything from a station is escaped.
  */
-export declare function renderGuide(entries: GuideEntry[], apiBase?: string, ads?: GuideAds): string;
+export declare function renderGuide(entries: GuideEntry[], apiBase?: string, ads?: GuideAds, labelHref?: string): string;
 export declare const GUIDE_HTML: string;
 /**
  * The guide's policy. With crawlproof configured (guideAds below) its tracker

package/dist/station-guide.js

@@ -150,7 +150,7 @@ const GROUPS = ["rooms", "vod", "ai", "shared", "radio", "tv"];
  * gateway that cannot run its script against this server (the Moshpit's
  * /n/<name>), and for a crawler. Everything from a station is escaped.
  */
-export function renderGuide(entries, apiBase = "", ads = {}) {
+export function renderGuide(entries, apiBase = "", ads = {}, labelHref = "") {
     const groupOf = (one) => one.group ?? (one.kind === "video" ? "tv" : "radio");
     const cards = (group) => entries
         .filter((one) => groupOf(one) === group && /^https?:\/\//.test(one.page))
@@ -172,6 +172,10 @@ export function renderGuide(entries, apiBase = "", ads = {}) {
         // The one ad goes at the top of the content, never against the footer.
         page = page.replace('<p class="lead">Radio and TV, on the air now. Pick one and press play.</p>\n', (lead) => `${lead}  <div class="ad-unit ad-${format}"><iframe src="${CRAWLPROOF}/api/ads/frame?slot=${encodeURIComponent(slot)}&amp;format=${format}" title="Advertisement" loading="lazy" referrerpolicy="strict-origin-when-cross-origin" sandbox="allow-scripts allow-popups allow-popups-to-escape-sandbox allow-top-navigation-by-user-activation" scrolling="no"></iframe></div>\n`);
     }
+    // The AI label's artists and albums, under the AI stations they play on.
+    if (/^\/[a-z]+$/.test(labelHref)) {
+        page = page.replace('<div id="ai" class="grid" aria-live="polite">', `<p class="lead"><a href="${labelHref}">The AI label: every artist, album and song, with the words →</a></p>\n  <div id="ai" class="grid" aria-live="polite">`);
+    }
     const api = /^https:\/\/[^\s"<>]+$/.test(apiBase) ? apiBase.replace(/\/+$/, "") : "";
     return (page.replace('<p id="empty" class="empty">', entries.length ? '<p id="empty" class="empty" hidden>' : '<p id="empty" class="empty">')).replace("<body>", api ? `<body data-api="${escape(api)}">` : "<body>");
 }

package/dist/station-mcp.d.ts

@@ -26,15 +26,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -86,15 +97,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -170,14 +192,25 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -250,14 +283,25 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -311,15 +355,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -380,15 +435,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -449,15 +515,26 @@ export declare const STATION_TOOLS: ({
             off: {
                 type: string;
             };
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -544,6 +621,17 @@ export declare const STATION_TOOLS: ({
             monthlySeconds: {
                 type: string;
             };
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
+            holder?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -584,15 +672,132 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            server: {
+                type: "string";
+                description: string;
+            };
+            action: {
+                type: string;
+                enum: string[];
+            };
+            key: {
+                type: "string";
+                description: string;
+            };
+            preset: {
+                readonly type: "string";
+            };
+            roster: {
+                type: string;
+            };
+            name: {
+                readonly type: "string";
+            };
+            genre: {
+                readonly type: "string";
+            };
+            sound: {
+                type: "string";
+                description: string;
+            };
+            voice: {
+                readonly type: "string";
+            };
+            bio: {
+                readonly type: "string";
+            };
+            themes: {
+                readonly type: "string";
+            };
+            enabled: {
+                type: string;
+            };
+            publish: {
+                type: string;
+            };
+            holder: {
+                readonly type: "string";
+            };
+            monthlySeconds: {
+                type: string;
+            };
+            everyDays: {
+                type: string;
+            };
+            seedAlbums: {
+                type: string;
+            };
+            songsPerAlbum: {
+                type: string;
+            };
+            songSeconds: {
+                type: string;
+            };
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
+            id?: undefined;
+            private?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            playlist?: undefined;
+            idempotencyKey?: undefined;
+            folder?: undefined;
+            items?: undefined;
+            shuffle?: undefined;
+            repeat?: undefined;
+            bitrate?: undefined;
+            visibility?: undefined;
+            listed?: undefined;
+            basis?: undefined;
+            note?: undefined;
+            video?: undefined;
+            minItems?: undefined;
+            minFilms?: undefined;
+            maxVideoRunning?: undefined;
+            breaksEvery?: undefined;
+            start?: undefined;
+            off?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             server: {
                 type: "string";
                 description: string;
@@ -662,15 +867,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -742,15 +958,26 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
-            key?: undefined;
-            preset?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
             trackSeconds?: undefined;
             perDay?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            roster?: undefined;
+            genre?: undefined;
+            sound?: undefined;
+            voice?: undefined;
+            bio?: undefined;
+            themes?: undefined;
             enabled?: undefined;
+            holder?: undefined;
             monthlySeconds?: undefined;
+            everyDays?: undefined;
+            seedAlbums?: undefined;
+            songsPerAlbum?: undefined;
+            songSeconds?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;

package/dist/station-mcp.js

@@ -105,6 +105,23 @@ export const STATION_TOOLS = [
             },
         },
     },
+    {
+        name: "station_label",
+        description: "The AI label: AI artists (a name, genre, sound and voice) who release albums on their own, written and sung in English, filed as <library>/ai/<genre>/<artist>/<year>-<album>/001. <title>.mp3 with .lyrics.txt, a public station per genre, and the catalogue at /label. action status (default), sign (preset from the roster, roster: true for all of it, or name + genre + sound), album (plan the artist's next album now), update, drop, configure (holder, monthlySeconds, everyDays, seedAlbums, songsPerAlbum, songSeconds, enabled, publish), run, resume.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server: SERVER,
+                action: { type: "string", enum: ["status", "sign", "album", "update", "drop", "configure", "run", "resume"] },
+                key: { ...STRING, description: "The artist's key (10 hex characters), from status." },
+                preset: STRING, roster: { type: "boolean" }, name: STRING, genre: STRING,
+                sound: { ...STRING, description: "The music in words: instruments, tempo, mood. Name no real artist." },
+                voice: STRING, bio: STRING, themes: STRING, enabled: { type: "boolean" }, publish: { type: "boolean" }, holder: STRING,
+                monthlySeconds: { type: "integer" }, everyDays: { type: "integer" }, seedAlbums: { type: "integer" },
+                songsPerAlbum: { type: "integer" }, songSeconds: { type: "integer" },
+            },
+        },
+    },
     {
         name: "station_shares",
         description: "Listener shares: anybody may share an MP3 link or file from the public guide; AI files it under a genre and holds anything that looks like a commercial release. action status (default; waiting shares), list (state), configure (open, moderation ai|owner, publish, maxMb, perHour), approve, reject, delete.",
@@ -215,6 +232,25 @@ export async function callStationTool(name, args, options = {}) {
                 return say("action is status, create, generate, update, remove, budget or resume", true);
             return answer.ok ? say(JSON.stringify(answer.body, null, 2)) : refused(answer.body);
         }
+        if (name === "station_label") {
+            const action = String(args["action"] ?? "status");
+            const key = typeof args["key"] === "string" && /^[a-f0-9]{10}$/.test(args["key"]) ? args["key"] : "";
+            const answer = action === "status" ? await call("GET", "/api/v1/stations/label")
+                : action === "sign" ? await call("POST", "/api/v1/stations/label/artists", pick(["preset", "roster", "name", "genre", "sound", "voice", "bio", "themes", "enabled"]))
+                    : action === "configure" ? await call("POST", "/api/v1/stations/label", pick(["holder", "monthlySeconds", "everyDays", "seedAlbums", "songsPerAlbum", "songSeconds", "enabled", "publish"]))
+                        : action === "run" ? await call("POST", "/api/v1/stations/label/run", {})
+                            : action === "resume" ? await call("POST", "/api/v1/stations/label", { resume: true })
+                                : !key ? null
+                                    : action === "album" ? await call("POST", `/api/v1/stations/label/artists/${key}/album`, {})
+                                        : action === "update" ? await call("PATCH", `/api/v1/stations/label/artists/${key}`, pick(["sound", "voice", "bio", "themes", "enabled"]))
+                                            : action === "drop" ? await call("DELETE", `/api/v1/stations/label/artists/${key}`)
+                                                : undefined;
+            if (answer === null)
+                return say("Which artist? Pass its key from action status.", true);
+            if (answer === undefined)
+                return say("action is status, sign, album, update, drop, configure, run or resume", true);
+            return answer.ok ? say(JSON.stringify(answer.body, null, 2)) : refused(answer.body);
+        }
         if (name === "station_holders") {
             const action = String(args["action"] ?? "list");
             const answer = action === "list" ? await call("GET", "/api/v1/stations/holders")

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] [--breaks 600 (the default; 0 for none)]\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 guide-ads [--site ID] [--slot ID] [--format banner_300x250|text_link] [--off]\n                     crawlproof analytics (project ID) and an ad unit (slot ID) on the guide\n  nixamp station guide-peer URL [--remove]\n                     the guide also lists the public, listed stations of the server at URL\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,\n                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in), 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  Lyrics (shown on the station page from each file's own tag, else nichedb.dev; ours published back):\n  nixamp station lyrics                      the key, what was published, which stations may publish\n  nixamp station lyrics publish ID           publish a station's words now (public, listed, basis owned only)\n  nixamp station lyrics key                  nichedb's key (NIXAMP_LYRICS_KEY), from stdin (--clear forgets it)\n\n  Copyright holders (the now-playing card: who holds a track's copyright, and how to support them):\n  nixamp station holder list\n  nixamp station holder set NAME [--artist ARTIST]... [--station ID]... [--support https://...] [--label Subscribe] [--license TEXT]\n  nixamp station holder remove ID\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 (the default; 0 for none)]\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 guide-ads [--site ID] [--slot ID] [--format banner_300x250|text_link] [--off]\n                     crawlproof analytics (project ID) and an ad unit (slot ID) on the guide\n  nixamp station guide-peer URL [--remove]\n                     the guide also lists the public, listed stations of the server at URL\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,\n                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in),\n                                             NIXAMP_MUSIC_MODEL (music_v1|music_v2|music_v2_5), from stdin\n\n  AI label (AI artists who release albums on their own; a station per genre; the catalogue at /label):\n  nixamp station label                       artists, albums, this month's seconds, what it is waiting for\n  nixamp station label sign --roster         the first roster: velvet-ruckus, juno-kincaid, chrome-orchard, delta-wren,\n                                             ashen-cartography, lumi-kestrel\n  nixamp station label sign (--preset KEY | --name NAME --genre GENRE --sound TEXT [--voice TEXT] [--bio TEXT] [--themes TEXT])\n  nixamp station label album KEY             plan the artist's next album now and record it\n  nixamp station label set KEY [--sound TEXT] [--voice TEXT] [--bio TEXT] [--themes TEXT] [--off|--on]\n  nixamp station label drop KEY [--files]\n  nixamp station label config [--holder \"Profullstack, Inc.\"] [--budget SECONDS] [--every-days 30] [--seed-albums 2]\n                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]\n  nixamp station label run                   record whatever is due now\n  nixamp station label resume                after the provider ran out of credit\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  Lyrics (shown on the station page from each file's own tag, else nichedb.dev; ours published back):\n  nixamp station lyrics                      the key, what was published, which stations may publish\n  nixamp station lyrics publish ID           publish a station's words now (public, listed, basis owned only)\n  nixamp station lyrics key                  nichedb's key (NIXAMP_LYRICS_KEY), from stdin (--clear forgets it)\n\n  Copyright holders (the now-playing card: who holds a track's copyright, and how to support them):\n  nixamp station holder list\n  nixamp station holder set NAME [--artist ARTIST]... [--station ID]... [--support https://...] [--label Subscribe] [--license TEXT]\n  nixamp station holder remove ID\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

@@ -33,7 +33,21 @@ export const USAGE = `nixamp station — make a collection into a station
   nixamp station ai budget SECONDS           seconds of music a month across AI stations (0: no cap)
   nixamp station ai resume                   after the provider ran out of credit
   nixamp station ai key NAME                 ELEVENLABS_API_KEY | GEMINI_API_KEY | OPENAI_API_KEY | ANTHROPIC_API_KEY,
-                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in), from stdin
+                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in),
+                                             NIXAMP_MUSIC_MODEL (music_v1|music_v2|music_v2_5), from stdin
+
+  AI label (AI artists who release albums on their own; a station per genre; the catalogue at /label):
+  nixamp station label                       artists, albums, this month's seconds, what it is waiting for
+  nixamp station label sign --roster         the first roster: velvet-ruckus, juno-kincaid, chrome-orchard, delta-wren,
+                                             ashen-cartography, lumi-kestrel
+  nixamp station label sign (--preset KEY | --name NAME --genre GENRE --sound TEXT [--voice TEXT] [--bio TEXT] [--themes TEXT])
+  nixamp station label album KEY             plan the artist's next album now and record it
+  nixamp station label set KEY [--sound TEXT] [--voice TEXT] [--bio TEXT] [--themes TEXT] [--off|--on]
+  nixamp station label drop KEY [--files]
+  nixamp station label config [--holder "Profullstack, Inc."] [--budget SECONDS] [--every-days 30] [--seed-albums 2]
+                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]
+  nixamp station label run                   record whatever is due now
+  nixamp station label resume                after the provider ran out of credit
 
   Listener shares (anybody shares an MP3 link or file from the guide; AI files and checks it):
   nixamp station shares                      the setting and what is waiting

package/package.json

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