nixamp 0.59.5 → 0.60.1

package/dist/server.js

@@ -61,10 +61,11 @@ import { ListenerStore } from "./library-user.js";
 import { Importer } from "./handoff.js";
 import { handleHandoffs } from "./handoff-routes.js";
 import { handleAiRoutes, isPublicSharePath } from "./ai-routes.js";
-import { AiLabel } from "./ai-label.js";
+import { AiLabel, VeoUnavailable } from "./ai-label.js";
 import { buyLink, handleLabelRoutes, isPublicLabelPath } from "./label-routes.js";
 import { GrantVerifier, MusicStore, PRICES } from "./music-store.js";
 import { handleMusicRoutes, isMusicPath, MusicHub, musicPageFor, serverId } from "./music-hub.js";
+import { VeoBudgetError, VeoStudio } from "./veo-studio.js";
 import { handleStoreRoutes, isStorePath } from "./store-routes.js";
 import { AiRadio } from "./ai-radio.js";
 import { ListenerShares } from "./listener-shares.js";
@@ -78,7 +79,7 @@ import { handleRoomProxy, handleRooms, isRoomPath, ROOM_PAGE, roomAddress, RoomP
 import { handleVods, VodProbe, vodEntries, VodStore, vodView } from "./guide-vods.js";
 import { withPitFooter } from "./pit-footer.js";
 import { handleFollowPage } from "./follow-page.js";
-import { asRadioPage, buildCatalogue, isRadioPath, NAV_STYLE, RADIO_ALBUM, RADIO_ARTIST, RADIO_CSP, RADIO_STATION, RADIO_SUB, RADIO_BUY, radioBuyLink, radioBuyQuery, radioNav, radioPeers, radioRewriter, radioStations, renderAlbum, renderArtist, renderDirectory, renderMissing, rewriteResponse, } from "./radio-pages.js";
+import { asRadioPage, buildCatalogue, isRadioPath, NAV_STYLE, RADIO_ALBUM, RADIO_ARTIST, RADIO_CSP, RADIO_STATION, RADIO_SUB, RADIO_BUY, radioBuyLink, radioBuyQuery, radioNav, radioPeers, radioRewriter, radioStations, renderAlbum, stationImage, renderArtist, renderDirectory, renderMissing, rewriteResponse, } from "./radio-pages.js";
 import { adCsp, guideAds, guideCsp, withPageAd, guideHosts, guidePeers, peerBase, PeerGuides, renderGuide } from "./station-guide.js";
 import { StationRunner } from "./station-runner.js";
 import { StationError, StationStore, channelOf, stationOfChannel } from "./stations.js";
@@ -2290,6 +2291,15 @@ export function createHandler(engine, options) {
         const requestHost = String(request.headers["x-forwarded-host"] ?? request.headers.host ?? "").split(",")[0].trim().replace(/:\d+$/, "").toLowerCase();
         const isGuidePage = Boolean(options.stations) && (request.method === "GET" || request.method === "HEAD") &&
             (path === "/guide" || (path === "/" && guideHosts().has(requestHost)));
+        // nixamp.com's own /radio is the radio app (web/radio.html), not live.streaming's
+        // station list; its other /radio pages name nixamp.com, not the box behind it.
+        const onDirectory = (() => { try {
+            return new URL(storeSite).host === requestHost;
+        }
+        catch {
+            return false;
+        } })();
+        const radioPath = isRadioPath(path) && !(onDirectory && (path === "/radio" || path === "/radio/"));
         // The built web bundle is the same public code nixamp.com hands anyone;
         // a station's page loads it, and a station link carries no server key.
         const isPublicAsset = (request.method === "GET" || request.method === "HEAD") &&
@@ -2329,7 +2339,7 @@ export function createHandler(engine, options) {
             !((path === "/vod" || /^\/vod\/[A-Za-z0-9_-]{1,32}$/.test(path) || path === "/api/v1/guide/vods" || path.startsWith("/api/v1/guide/vods/")) && Boolean(options.stations?.vods)) &&
             !STATION_PAGE.test(path) &&
             // Public, listed stations under readable names, and their artists and albums (radio-pages.ts).
-            !(isRadioPath(path) && Boolean(options.stations)) &&
+            !(radioPath && Boolean(options.stations)) &&
             // Following an artist from those pages, signed in at nixamp.com.
             !(path === "/follow" && Boolean(options.follows && options.accounts)) &&
             !isPublicAsset &&
@@ -2656,11 +2666,11 @@ export function createHandler(engine, options) {
                 return;
             }
         }
-        if (options.stations && isRadioPath(path) && (request.method === "GET" || request.method === "HEAD")) {
+        if (options.stations && radioPath && (request.method === "GET" || request.method === "HEAD")) {
             const stations = options.stations;
             const named = radioStations(stations.store.list());
             const publicBase = stations.publicBase?.() ?? "";
-            const base = radioBaseFor(request, publicBase);
+            const base = onDirectory ? storeSite : radioBaseFor(request, publicBase);
             const nav = radioNav(guideHosts().has(requestHost) ? "/" : "/guide");
             const send = (status, page, csp = RADIO_CSP) => {
                 const ads = guideAds();
@@ -2764,7 +2774,9 @@ export function createHandler(engine, options) {
                 const built = web !== null && isFile(join(web, "station.html")) ? readFileSync(join(web, "station.html"), "utf8") : null;
                 // The built page carries the one ad; the inline fallback stays as it is.
                 const ads = built ? guideAds() : {};
-                const page = withPageAd(asRadioPage(built ?? STATION_PAGE_HTML, station, slug, base, nav), ads);
+                // Its link preview carries the cover of an album it plays.
+                const image = stationImage(radioCatalogue(), slug, base);
+                const page = withPageAd(asRadioPage(built ?? STATION_PAGE_HTML, station, slug, base, nav, undefined, image), ads);
                 response.writeHead(200, {
                     "content-type": "text/html; charset=utf-8",
                     "cache-control": "no-cache",
@@ -2887,7 +2899,9 @@ export function createHandler(engine, options) {
                 catch {
                     return null;
                 } },
+                site: storeSite,
                 released: music.released,
+                ...(music.veo ? { veo: music.veo } : {}),
             }))
                 return;
         }
@@ -7194,6 +7208,24 @@ export async function serve(argv, version = "0.1.0") {
         root: process.env["NIXAMP_LABEL_ROOT"] || (labelHome ? join(labelHome.root, "ai") : join(stateDir(), "ai-label")),
         owner: options.owner || "",
         mayStart: mayStartStation,
+        // Filmed shots for singles come from nixamp.com's Veo studio, asked as this server's owner, under its monthly cap.
+        veo: async (shot) => {
+            const session = readSession();
+            const here = stations.publicBase?.() ?? "";
+            if (!session?.token || !/^https:\/\//.test(here))
+                throw new VeoUnavailable("this server is not signed in to nixamp.com");
+            const answer = await fetch(`${session.site.replace(/\/+$/, "")}/api/v1/music/veo`, {
+                method: "POST",
+                headers: { "content-type": "application/json", authorization: `Bearer ${session.token}`, "x-nixamp-server": here },
+                body: JSON.stringify({ prompt: shot.prompt, seconds: shot.seconds, references: shot.references.map((one) => one.toString("base64")) }),
+                signal: AbortSignal.timeout(12 * 60_000),
+            });
+            if (answer.status === 402 || answer.status === 404)
+                throw new VeoUnavailable((await answer.json().catch(() => ({}))).error ?? `HTTP ${answer.status}`);
+            if (!answer.ok)
+                throw new Error((await answer.json().catch(() => ({}))).error ?? `nixamp.com answered ${answer.status}`);
+            return Buffer.from(await answer.arrayBuffer());
+        },
         // A release is told to nixamp.com as this server's owner; nixamp.com tells the artist's followers.
         announce: (release) => {
             const session = readSession();
@@ -7479,6 +7511,48 @@ export async function serve(argv, version = "0.1.0") {
      * followers are told. Only the account that owns a listed server may say
      * so, only for an artist that server's catalogue has, once per release.
      */
+    // Veo shots for label music videos, under a monthly dollar cap (veo-studio.ts). nixamp.com only.
+    const veoStudio = options.directory && process.env["NIXAMP_VEO_API_KEY"] ? new VeoStudio({
+        key: process.env["NIXAMP_VEO_API_KEY"],
+        file: VeoStudio.fileFor(stateDir(), options.port),
+        monthlyUsd: Number(process.env["NIXAMP_VEO_MONTHLY_USD"] ?? 50),
+        usdPerSecond: Number(process.env["NIXAMP_VEO_USD_PER_SECOND"] ?? 0.15),
+    }) : undefined;
+    /** The signed-in account owns a server listed in the directory at this base. */
+    const ownsListed = async (request, base) => {
+        const me = accounts ? await accounts.whoIs(tokenFrom(request.headers)).catch(() => null) : null;
+        return Boolean(me && base && directory?.list().some((one) => one.ownerId === me.id && peerBase(one.url) === base));
+    };
+    const musicVeo = async (request) => {
+        if (!veoStudio)
+            return { status: 404, body: { error: "Veo is not set up here" } };
+        const base = peerBase(String(request.headers["x-nixamp-server"] ?? ""));
+        if (!(await ownsListed(request, base)))
+            return { status: 403, body: { error: "only the owner of a listed server" } };
+        if (request.method === "GET")
+            return { status: 200, body: veoStudio.status() };
+        if (request.method !== "POST")
+            return { status: 405, body: { error: "GET or POST" } };
+        let input;
+        try {
+            input = JSON.parse(await readBody(request, 2 * 1024 * 1024));
+        }
+        catch {
+            return { status: 400, body: { error: "a JSON body under 2 MB" } };
+        }
+        const prompt = String(input.prompt ?? "").trim();
+        if (prompt.length < 20)
+            return { status: 400, body: { error: "describe the shot" } };
+        const references = (Array.isArray(input.references) ? input.references : []).slice(0, 3).map((one) => Buffer.from(String(one), "base64")).filter((one) => one.length > 1000);
+        try {
+            return { status: 200, body: null, video: await veoStudio.clip({ prompt, seconds: Number(input.seconds ?? 8), references }) };
+        }
+        catch (error) {
+            if (error instanceof VeoBudgetError)
+                return { status: 402, body: { error: error.message, code: "budget", ...veoStudio.status() } };
+            return { status: 422, body: { error: error.message, code: "refused" } };
+        }
+    };
     const announced = new Set();
     const musicReleased = async (request, body) => {
         const me = accounts ? await accounts.whoIs(tokenFrom(request.headers)).catch(() => null) : null;
@@ -8062,7 +8136,7 @@ export async function serve(argv, version = "0.1.0") {
         ...(supportPayments ? { support: supportPayments } : {}),
         ...(supportMonthly ? { supportSubscriptions: supportMonthly } : {}),
         ...(musicStore ? { musicStore } : {}),
-        ...(musicHub ? { music: { hub: musicHub, released: musicReleased } } : {}),
+        ...(musicHub ? { music: { hub: musicHub, released: musicReleased, veo: musicVeo } } : {}),
         ...(process.env["COINPAY_WEBHOOK_SECRET"] ? { coinpayWebhookSecret: process.env["COINPAY_WEBHOOK_SECRET"] } : {}),
         ...(sharedTranslations ? { sharedTranslations } : {}),
         ...(translator ? { translator } : {}),

package/dist/station-cli.js

@@ -538,6 +538,8 @@ async function labelCommand(argv, call, show) {
                 videos: has(argv, "--no-videos") ? false : has(argv, "--videos") ? true : undefined,
                 newArtistChance: number("--new-artists"),
                 resetDay: number("--reset-day"),
+                veo: has(argv, "--veo") ? true : has(argv, "--no-veo") ? false : undefined,
+                veoShots: number("--veo-shots"),
                 genreOrder: flag(argv, "--genres"),
                 enabled: has(argv, "--off") ? false : has(argv, "--on") ? true : undefined,
                 publish: has(argv, "--unlisted") ? false : has(argv, "--public") ? true : undefined,

package/dist/station-mcp.d.ts

@@ -50,6 +50,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -126,6 +128,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -225,6 +229,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -321,6 +327,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -399,6 +407,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -484,6 +494,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -569,6 +581,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -671,6 +685,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -793,6 +809,14 @@ export declare const STATION_TOOLS: ({
                 type: string;
                 description: string;
             };
+            veo: {
+                type: string;
+                description: string;
+            };
+            veoShots: {
+                type: string;
+                description: string;
+            };
             genreOrder: {
                 type: string;
                 items: {
@@ -864,6 +888,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             server: {
                 type: "string";
@@ -958,6 +984,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
@@ -1054,6 +1082,8 @@ export declare const STATION_TOOLS: ({
             albumsPerDay?: undefined;
             newArtistChance?: undefined;
             resetDay?: undefined;
+            veo?: undefined;
+            veoShots?: undefined;
             genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;

package/dist/station-mcp.js

@@ -122,6 +122,8 @@ export const STATION_TOOLS = [
                 albumsPerDay: { type: "integer", description: "After the first sweep: new albums a day, by a random artist or a newly invented one." },
                 newArtistChance: { type: "number", description: "0-1: how often the day's album is by a new artist." },
                 resetDay: { type: "integer", description: "Day of the month (1-28) the budget renews: the music provider's billing day." },
+                veo: { type: "boolean", description: "Each album's single gets filmed Veo shots of the band (nixamp.com's monthly Veo cap applies)." },
+                veoShots: { type: "integer", description: "8 s Veo shots per single (1-8)." },
                 genreOrder: { type: "array", items: STRING, description: "Genres whose artists get albums first, in order." },
             },
         },
@@ -241,7 +243,7 @@ export async function callStationTool(name, args, options = {}) {
             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", "parallel", "genreOrder", "albumsPerDay", "newArtistChance", "resetDay", "enabled", "publish"]))
+                    : action === "configure" ? await call("POST", "/api/v1/stations/label", pick(["holder", "monthlySeconds", "everyDays", "seedAlbums", "songsPerAlbum", "songSeconds", "parallel", "genreOrder", "albumsPerDay", "newArtistChance", "resetDay", "veo", "veoShots", "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

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),\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 roster: three artists in each of Rock, Hip-Hop, Synthwave, Country,\n                                             Metal and Pop (nixamp station label lists their keys)\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 1]\n                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]\n                              [--parallel 4] [--genres \"Punk,Blues,Country\"]   songs made at once; genres first\n                              [--per-day 1] [--new-artists 0.25]   after the first sweep: albums a day, share by new artists\n                              [--videos|--no-videos]   a music video per song and a TV station of them\n                              [--reset-day 21]   the day the monthly budget renews (the provider's billing day)\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.";
+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 roster: three artists in each of Rock, Hip-Hop, Synthwave, Country,\n                                             Metal and Pop (nixamp station label lists their keys)\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 1]\n                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]\n                              [--parallel 4] [--genres \"Punk,Blues,Country\"]   songs made at once; genres first\n                              [--per-day 1] [--new-artists 0.25]   after the first sweep: albums a day, share by new artists\n                              [--videos|--no-videos]   a music video per song and a TV station of them\n                              [--reset-day 21]   the day the monthly budget renews (the provider's billing day)\n                              [--veo|--no-veo] [--veo-shots 4]   filmed Veo shots of the band in each album's single (nixamp.com caps the month)\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

@@ -50,6 +50,7 @@ export const USAGE = `nixamp station — make a collection into a station
                               [--per-day 1] [--new-artists 0.25]   after the first sweep: albums a day, share by new artists
                               [--videos|--no-videos]   a music video per song and a TV station of them
                               [--reset-day 21]   the day the monthly budget renews (the provider's billing day)
+                              [--veo|--no-veo] [--veo-shots 4]   filmed Veo shots of the band in each album's single (nixamp.com caps the month)
   nixamp station label run                   record whatever is due now
   nixamp station label resume                after the provider ran out of credit
 

package/dist/veo-studio.d.ts

@@ -0,0 +1,39 @@
+export declare class VeoBudgetError extends Error {
+}
+export declare class VeoRefused extends Error {
+}
+export interface VeoStudioOptions {
+    key: string;
+    file: string;
+    monthlyUsd?: number;
+    usdPerSecond?: number;
+    model?: string;
+    fetcher?: typeof fetch;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class VeoStudio {
+    private readonly options;
+    private spent;
+    constructor(options: VeoStudioOptions);
+    static fileFor(stateDir: string, port: number): string;
+    private month;
+    private get cap();
+    private get rate();
+    private save;
+    status(): {
+        month: string;
+        spentUsd: number;
+        capUsd: number;
+        leftUsd: number;
+        usdPerSecond: number;
+        secondsLeft: number;
+    };
+    /** One shot: 4, 6 or 8 seconds, 16:9, with up to three reference images (JPEG). */
+    clip(input: {
+        prompt: string;
+        seconds: number;
+        references: Buffer[];
+    }): Promise<Buffer>;
+    private make;
+}

package/dist/veo-studio.js

@@ -0,0 +1,110 @@
+/**
+ * Veo clips for the AI label's music videos, made on nixamp.com.
+ *
+ * A label server asks for a shot (a prompt, its length, up to three member
+ * portraits as reference images) and gets back an MP4. Google's Veo 3.1 Fast
+ * makes it; nixamp.com keeps the month's spend under a cap in dollars
+ * (NIXAMP_VEO_MONTHLY_USD, $50 by default), counting every second at a
+ * deliberately high rate (NIXAMP_VEO_USD_PER_SECOND, $0.15) so the cap holds
+ * whatever Google's price is today. A shot is reserved before it is asked for
+ * and given back when Google makes nothing (a refusal, a filter, a timeout).
+ *
+ * The key is NIXAMP_VEO_API_KEY, its own name, so nothing else on nixamp.com
+ * starts spending Gemini credit because a Gemini key appeared.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export class VeoBudgetError extends Error {
+}
+export class VeoRefused extends Error {
+}
+const BASE = "https://generativelanguage.googleapis.com/v1beta";
+export class VeoStudio {
+    options;
+    spent = {};
+    constructor(options) {
+        this.options = options;
+        try {
+            this.spent = JSON.parse(readFileSync(options.file, "utf8")).spent ?? {};
+        }
+        catch {
+            this.spent = {};
+        }
+    }
+    static fileFor(stateDir, port) {
+        return join(stateDir, `veo-${port}.json`);
+    }
+    month() {
+        return new Date(this.options.now?.() ?? Date.now()).toISOString().slice(0, 7);
+    }
+    get cap() { return this.options.monthlyUsd ?? 50; }
+    get rate() { return this.options.usdPerSecond ?? 0.15; }
+    save() {
+        mkdirSync(dirname(this.options.file), { recursive: true });
+        const temporary = `${this.options.file}.${process.pid}.tmp`;
+        writeFileSync(temporary, `${JSON.stringify({ version: 1, spent: this.spent }, null, 2)}\n`, { mode: 0o600 });
+        renameSync(temporary, this.options.file);
+    }
+    status() {
+        const spent = this.spent[this.month()] ?? 0;
+        const left = Math.max(0, this.cap - spent);
+        return { month: this.month(), spentUsd: Math.round(spent * 100) / 100, capUsd: this.cap, leftUsd: Math.round(left * 100) / 100, usdPerSecond: this.rate, secondsLeft: Math.floor(left / this.rate) };
+    }
+    /** One shot: 4, 6 or 8 seconds, 16:9, with up to three reference images (JPEG). */
+    async clip(input) {
+        const seconds = [4, 6, 8].includes(input.seconds) ? input.seconds : 8;
+        const cost = seconds * this.rate;
+        const month = this.month();
+        if ((this.spent[month] ?? 0) + cost > this.cap + 1e-9)
+            throw new VeoBudgetError(`this month's $${this.cap} of Veo is spent`);
+        // Reserved first, so two at once cannot both squeeze under the cap.
+        this.spent[month] = (this.spent[month] ?? 0) + cost;
+        this.save();
+        try {
+            return await this.make(input.prompt, seconds, input.references.slice(0, 3));
+        }
+        catch (error) {
+            this.spent[month] = Math.max(0, (this.spent[month] ?? 0) - cost);
+            this.save();
+            throw error;
+        }
+    }
+    async make(prompt, seconds, references) {
+        const send = this.options.fetcher ?? fetch;
+        const headers = { "x-goog-api-key": this.options.key, "content-type": "application/json" };
+        const model = this.options.model ?? "veo-3.1-fast-generate-preview";
+        const started = await send(`${BASE}/models/${model}:predictLongRunning`, {
+            method: "POST",
+            headers,
+            signal: AbortSignal.timeout(60_000),
+            body: JSON.stringify({
+                instances: [{
+                        prompt: prompt.slice(0, 1800),
+                        ...(references.length ? { referenceImages: references.map((bytes) => ({ image: { bytesBase64Encoded: bytes.toString("base64"), mimeType: "image/jpeg" }, referenceType: "asset" })) } : {}),
+                    }],
+                parameters: { aspectRatio: "16:9", durationSeconds: seconds },
+            }),
+        });
+        const operation = await started.json().catch(() => ({}));
+        if (!started.ok || !operation.name)
+            throw new VeoRefused(`Veo refused the shot: ${operation.error?.message?.slice(0, 200) ?? `HTTP ${started.status}`}`);
+        const sleep = this.options.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
+        for (let tries = 0; tries < 60; tries++) {
+            await sleep(10_000);
+            const state = await (await send(`${BASE}/${operation.name}`, { headers, signal: AbortSignal.timeout(30_000) })).json().catch(() => ({}));
+            if (!state.done)
+                continue;
+            if (state.error)
+                throw new VeoRefused(`Veo failed: ${state.error.message?.slice(0, 200) ?? "no reason"}`);
+            const uri = state.response?.generateVideoResponse?.generatedSamples?.[0]?.video?.uri;
+            if (!uri)
+                throw new VeoRefused(`Veo made nothing: ${state.response?.generateVideoResponse?.raiMediaFilteredReasons?.[0]?.slice(0, 200) ?? "no sample"}`);
+            const video = await send(uri, { headers: { "x-goog-api-key": this.options.key }, signal: AbortSignal.timeout(120_000) });
+            const bytes = Buffer.from(await video.arrayBuffer());
+            if (!video.ok || bytes.length < 10_000)
+                throw new VeoRefused(`the Veo clip did not download (HTTP ${video.status})`);
+            return bytes;
+        }
+        throw new VeoRefused("Veo took too long (10 minutes)");
+    }
+}

package/package.json

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