nixamp 0.39.2 → 0.40.0

package/dist/ai-radio.d.ts

@@ -125,6 +125,8 @@ export declare class AiRadio {
     private composer;
     list(): AiStation[];
     get(key: string): AiStation | undefined;
+    /** The track AI radio composed at this path, if it did. */
+    trackAt(file: string): AiTrack | undefined;
     /** What the owner sees: the stations, this month's seconds, and why nothing is being made. */
     status(): Record<string, unknown>;
     /** Change the month's cap; `resume` clears a stop for lack of credit. */

package/dist/ai-radio.js

@@ -218,6 +218,15 @@ export class AiRadio {
     get(key) {
         return this.stations.get(key);
     }
+    /** The track AI radio composed at this path, if it did. */
+    trackAt(file) {
+        for (const station of this.stations.values()) {
+            const hit = station.tracks.find((one) => one.file === file);
+            if (hit)
+                return hit;
+        }
+        return undefined;
+    }
     /** What the owner sees: the stations, this month's seconds, and why nothing is being made. */
     status() {
         const month = monthOf(this.now());

package/dist/ai-routes.d.ts

@@ -11,11 +11,14 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { AiRadio } from "./ai-radio.ts";
 import { type ListenerShares } from "./listener-shares.ts";
+import type { HolderStore } from "./track-facts.ts";
 /** Whether this path is one anybody may use without the server's key. */
 export declare function isPublicSharePath(path: string): boolean;
 export interface AiRoutesContext {
     ai?: AiRadio;
     shares?: ListenerShares;
+    /** The copyright holders the owner registered, for the now-playing card. */
+    holders?: HolderStore;
     canControl: boolean;
     /** Who is asking, for per-sharer limits (an address; hashed before it is kept). */
     caller: string;

package/dist/ai-routes.js

@@ -25,7 +25,8 @@ async function jsonBody(ctx, request) {
 export async function handleAiRoutes(request, response, path, url, ctx) {
     const method = request.method ?? "GET";
     const publicPath = PUBLIC.exec(path);
-    const ownerPath = path === "/api/v1/stations/ai" || path.startsWith("/api/v1/stations/ai/") || path === "/api/v1/stations/shares" || path.startsWith("/api/v1/stations/shares/");
+    const ownerPath = path === "/api/v1/stations/ai" || path.startsWith("/api/v1/stations/ai/") || path === "/api/v1/stations/shares" || path.startsWith("/api/v1/stations/shares/")
+        || path === "/api/v1/stations/holders" || path.startsWith("/api/v1/stations/holders/");
     if (!publicPath && !ownerPath)
         return false;
     try {
@@ -81,6 +82,30 @@ export async function handleAiRoutes(request, response, path, url, ctx) {
             ctx.json(response, 403, { error: "only this server's owner manages AI radio and shares", code: "forbidden" });
             return true;
         }
+        if (path === "/api/v1/stations/holders" || path.startsWith("/api/v1/stations/holders/")) {
+            const holders = ctx.holders;
+            if (!holders) {
+                ctx.json(response, 404, { error: "copyright holders are not kept here", code: "not_found" });
+                return true;
+            }
+            if (path === "/api/v1/stations/holders" && method === "GET") {
+                ctx.json(response, 200, { holders: holders.list() });
+                return true;
+            }
+            if (path === "/api/v1/stations/holders" && method === "POST") {
+                ctx.json(response, 200, { holder: holders.set(await jsonBody(ctx, request)) });
+                return true;
+            }
+            const one = /^\/api\/v1\/stations\/holders\/([a-z0-9-]{1,40})$/.exec(path);
+            if (one && method === "DELETE") {
+                if (!holders.remove(one[1]))
+                    throw new StationError("not_found", "no such holder", 404);
+                ctx.json(response, 200, { deleted: one[1] });
+                return true;
+            }
+            ctx.json(response, 404, { error: "no such holder route", code: "not_found" });
+            return true;
+        }
         if (path === "/api/v1/stations/shares" || path.startsWith("/api/v1/stations/shares/")) {
             const shares = ctx.shares;
             if (!shares) {

package/dist/listener-shares.d.ts

@@ -101,6 +101,8 @@ export declare class ListenerShares {
     configure(input: Record<string, unknown>): ShareSettings;
     list(state?: string): Share[];
     get(id: string): Share | undefined;
+    /** The share whose copy is this file, if it is one. */
+    atFile(file: string): Share | undefined;
     /** The share, if this token is the one its sharer was given. */
     forSharer(id: string, token: string): Share | undefined;
     private fromOf;

package/dist/listener-shares.js

@@ -146,6 +146,10 @@ export class ListenerShares {
     get(id) {
         return this.shares.get(id);
     }
+    /** The share whose copy is this file, if it is one. */
+    atFile(file) {
+        return [...this.shares.values()].find((one) => one.file === file);
+    }
     /** The share, if this token is the one its sharer was given. */
     forSharer(id, token) {
         const share = this.shares.get(id);

package/dist/server.d.ts

@@ -26,9 +26,10 @@ import { ListenerStore } from "./library-user.ts";
 import { Importer } from "./handoff.ts";
 import { AiRadio } from "./ai-radio.ts";
 import { ListenerShares } from "./listener-shares.ts";
+import { Support } from "./support.ts";
 import { PeerGuides } from "./station-guide.ts";
 import { StationRunner } from "./station-runner.ts";
-import { StationStore } from "./stations.ts";
+import { StationStore, type Station } from "./stations.ts";
 import { StationUsage, type Limits } from "./station-metering.ts";
 import { CompressionService } from "./compression/service.ts";
 import { Enricher } from "./enrich.ts";
@@ -598,6 +599,10 @@ export interface HandlerOptions {
         ai?: AiRadio;
         /** Tracks anybody may share, sorted onto the air by AI. */
         shares?: ListenerShares;
+        /** What a listener may know about the track on the air. */
+        facts?: (station: Station, file: string) => Promise<import("./track-facts.ts").TrackFacts>;
+        /** Copyright holders, matched to tracks by artist or station. */
+        holders?: import("./track-facts.ts").HolderStore;
         /** Proxies (by address) whose X-Forwarded-For is believed, for per-sharer limits. */
         trustedProxies?: () => Set<string>;
         /** Other servers' public stations, for this guide to list beside its own. */
@@ -795,6 +800,8 @@ export interface HandlerOptions {
     speech?: Speech;
     liveVoice?: LiveVoice;
     translationPasses?: TranslationPasses;
+    /** Payments to copyright holders nixamp.com collects for (support.ts). */
+    support?: Support;
     /** Signing secret of nixamp's CoinPay business, for /api/v1/webhooks/coinpay. */
     coinpayWebhookSecret?: string;
     sharedTranslations?: SharedTranslations;

package/dist/server.js

@@ -63,6 +63,8 @@ import { handleHandoffs } from "./handoff-routes.js";
 import { handleAiRoutes, isPublicSharePath } from "./ai-routes.js";
 import { AiRadio } from "./ai-radio.js";
 import { ListenerShares } from "./listener-shares.js";
+import { HolderStore, TagReader, factsFor } from "./track-facts.js";
+import { SUPPORT_CSP, SUPPORT_PAGE, Support, SupportError, supportHoldersFrom } from "./support.js";
 import { STATION_APP_CSP, STATION_PAGE, STATION_PAGE_CSP, STATION_PAGE_HTML } from "./station-page.js";
 import { GUIDE_CSP, guideHosts, guidePeers, peerBase, PeerGuides, renderGuide } from "./station-guide.js";
 import { StationRunner } from "./station-runner.js";
@@ -2161,6 +2163,8 @@ export function createHandler(engine, options) {
             !isPublicSharePath(path) &&
             // What is on, as MCP, for anybody.
             path !== "/mcp/public" &&
+            // Supporting a copyright holder is for anybody listening.
+            !/^\/support\/[a-z0-9-]{1,40}$/.test(path) && !/^\/api\/v1\/support\/[a-z0-9-]{1,40}$/.test(path) &&
             // A station's short link, which sends the browser to wherever it plays.
             !/^\/watch\/[a-z0-9]{10}$/.test(path) &&
             !STATION_PAGE.test(path) &&
@@ -2227,6 +2231,57 @@ export function createHandler(engine, options) {
          * in the directory). It sends the browser to the station's own page, on
          * the server that plays it. Nothing private or unlisted is ever found.
          */
+        /* Support a copyright holder: the page, the coins, and a CoinPay checkout. */
+        const supportPage = /^\/support\/([a-z0-9-]{1,40})$/.exec(path);
+        if (supportPage && options.support && (request.method === "GET" || request.method === "HEAD")) {
+            if (!options.support.holder(supportPage[1])) {
+                json(response, 404, { error: "nobody by that name is supported here", code: "not_found" });
+                return;
+            }
+            response.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-cache", "content-security-policy": SUPPORT_CSP, "referrer-policy": "no-referrer", "x-content-type-options": "nosniff" });
+            response.end(request.method === "HEAD" ? undefined : SUPPORT_PAGE);
+            return;
+        }
+        const supportApi = /^\/api\/v1\/support\/([a-z0-9-]{1,40})$/.exec(path);
+        if (supportApi && options.support) {
+            const support = options.support;
+            const holder = support.holder(supportApi[1]);
+            if (!holder) {
+                json(response, 404, { error: "nobody by that name is supported here", code: "not_found" });
+                return;
+            }
+            try {
+                if (request.method === "GET") {
+                    const { coins } = support.enabled ? await support.coins() : { coins: [] };
+                    json(response, 200, { id: holder.id, name: holder.name, coins, ...(support.enabled ? {} : { error: "Support payments are not set up here." }) });
+                    return;
+                }
+                if (request.method === "POST") {
+                    const verdict = guard.check(`support:${callerOf(request.headers, request.socket.remoteAddress, behindProxy)}`, { allowed: 10, windowMs: 60_000 });
+                    if (!verdict.ok) {
+                        json(response, 429, { error: "too many at once; wait a minute", code: "rate_limited", retryAfter: verdict.retryAfter });
+                        return;
+                    }
+                    let body = {};
+                    try {
+                        body = JSON.parse(await readBody(request));
+                    }
+                    catch {
+                        body = {};
+                    }
+                    json(response, 200, await support.checkout({ ...body, holder: holder.id }));
+                    return;
+                }
+                json(response, 405, { error: "GET or POST", code: "method_not_allowed" });
+            }
+            catch (error) {
+                if (error instanceof SupportError)
+                    json(response, error.status, { error: error.message, code: error.code });
+                else
+                    json(response, 502, { error: "the payment service did not answer; nothing was charged", code: "provider" });
+            }
+            return;
+        }
         const stationShortLink = /^\/watch\/([a-z0-9]{10})$/.exec(path);
         if (stationShortLink && options.stations && (request.method === "GET" || request.method === "HEAD")) {
             const encrypted = request.socket.encrypted === true;
@@ -2325,7 +2380,7 @@ export function createHandler(engine, options) {
             });
             return;
         }
-        if (options.stations && (isPublicSharePath(path) || path.startsWith("/api/v1/stations/ai") || path.startsWith("/api/v1/stations/shares"))) {
+        if (options.stations && (isPublicSharePath(path) || path.startsWith("/api/v1/stations/ai") || path.startsWith("/api/v1/stations/shares") || path.startsWith("/api/v1/stations/holders"))) {
             const control = await controlOf();
             // Behind a proxy we trust (dev2 for live.streaming), the sharer is the
             // first address it names; otherwise whoever connected.
@@ -2335,6 +2390,7 @@ export function createHandler(engine, options) {
             const handled = await handleAiRoutes(request, response, path, url, {
                 ...(options.stations.ai ? { ai: options.stations.ai } : {}),
                 ...(options.stations.shares ? { shares: options.stations.shares } : {}),
+                ...(options.stations.holders ? { holders: options.stations.holders } : {}),
                 canControl: control.allowed,
                 caller,
                 json,
@@ -2387,6 +2443,7 @@ export function createHandler(engine, options) {
                 ...(options.stations.usage ? { usage: options.stations.usage } : {}),
                 ...(options.stations.limits ? { limits: options.stations.limits } : {}),
                 ...(options.stations.auto ? { auto: options.stations.auto } : {}),
+                ...(options.stations.facts ? { facts: options.stations.facts } : {}),
                 ...(options.stations.peers ? { peers: () => options.stations.peers.entries() } : {}),
                 throttle: () => {
                     const verdict = guard.check(`stations:${control.account || callerOf(request.headers, request.socket.remoteAddress, behindProxy)}`, STATION_CONTROL_LIMIT);
@@ -6517,6 +6574,23 @@ export async function serve(argv, version = "0.1.0") {
     });
     stations.ai = aiRadio;
     stations.shares = listenerShares;
+    // The now-playing card: the file's own tags, where it came from here, and
+    // the copyright holders the owner registered.
+    const tagReader = new TagReader(tools.ffprobe);
+    const holderStore = new HolderStore(HolderStore.fileFor(stateDir(), options.port));
+    stations.holders = holderStore;
+    stations.facts = async (station, file) => {
+        const share = listenerShares.atFile(file);
+        const composed = aiRadio.trackAt(file);
+        return factsFor({
+            station, file,
+            tags: await tagReader.read(file),
+            known: trackFor(engine, file),
+            holders: holderStore.list(),
+            share: share ? { basis: share.rights.basis, note: share.rights.note, by: share.by } : null,
+            aiTrack: composed ? { made: composed.made } : null,
+        });
+    };
     // Channels as HLS, on demand, for Safari on a phone: one ffmpeg copying a
     // channel's fragments into short files while somebody is asking for them.
     // What things are, from nichedb.dev, remembered beside the keys so a
@@ -6644,6 +6718,8 @@ export async function serve(argv, version = "0.1.0") {
     // is temporarily unconfigured. Self-hosters can explicitly sponsor usage.
     const translationPasses = accounts && pool && process.env["NIXAMP_TRANSLATION_BILLING"] !== "off"
         ? new TranslationPasses({ db: pool, key: coinpayKeyFrom(), site: nixampSite }) : undefined;
+    // Payments to the copyright holders nixamp.com collects for, on its own CoinPay business.
+    const supportPayments = accounts ? new Support({ key: coinpayKeyFrom(), site: nixampSite, holders: supportHoldersFrom() }) : undefined;
     if (translationPasses)
         void translationPasses.access().catch(() => console.error("nixamp: translation checkout could not warm; it will retry on demand"));
     const liveVoice = accounts && process.env["NIXAMP_DUBBING"] !== "off" ? new LiveVoice({
@@ -7192,6 +7268,7 @@ export async function serve(argv, version = "0.1.0") {
         ...(speech ? { speech } : {}),
         ...(liveVoice ? { liveVoice } : {}),
         ...(translationPasses ? { translationPasses } : {}),
+        ...(supportPayments ? { support: supportPayments } : {}),
         ...(process.env["COINPAY_WEBHOOK_SECRET"] ? { coinpayWebhookSecret: process.env["COINPAY_WEBHOOK_SECRET"] } : {}),
         ...(sharedTranslations ? { sharedTranslations } : {}),
         ...(translator ? { translator } : {}),

package/dist/station-cli.js

@@ -265,6 +265,37 @@ export async function station(argv) {
                 return await aiCommand(argv.slice(1), call, show, json);
             case "shares":
                 return await sharesCommand(argv.slice(1), call, show);
+            case "holder":
+            case "holders": {
+                const sub = argv[1] ?? "list";
+                const all = (flagName) => argv.flatMap((one, at) => (one === flagName && argv[at + 1] ? [argv[at + 1]] : []));
+                const line = (h) => `${String(h["name"])}  [${String(h["id"])}]\n  artists   ${(h["artists"] ?? []).join(", ") || "-"}\n  stations  ${(h["stations"] ?? []).join(", ") || "-"}\n  support   ${String(h["support"] || "-")}${h["license"] ? `\n  licence   ${String(h["license"])}` : ""}`;
+                if (sub === "list")
+                    return show(await call("GET", "/api/v1/stations/holders"), (body) => (body["holders"] ?? []).map(line).join("\n\n") || "No copyright holders yet. nixamp station holder set NAME --artist ARTIST --support URL");
+                if (sub === "remove")
+                    return show(await call("DELETE", `/api/v1/stations/holders/${argv[2] ?? ""}`), () => `Removed ${argv[2]}.`);
+                if (sub === "set") {
+                    const name = argv[2];
+                    if (!name || name.startsWith("--")) {
+                        console.error("nixamp station holder set needs a NAME");
+                        return 2;
+                    }
+                    const body = { name };
+                    if (all("--artist").length)
+                        body["artists"] = all("--artist");
+                    if (all("--station").length)
+                        body["stations"] = all("--station");
+                    if (flag(argv, "--support"))
+                        body["support"] = flag(argv, "--support");
+                    if (flag(argv, "--label"))
+                        body["label"] = flag(argv, "--label");
+                    if (flag(argv, "--license"))
+                        body["license"] = flag(argv, "--license");
+                    return show(await call("POST", "/api/v1/stations/holders", body), (answer) => line(answer["holder"]));
+                }
+                console.error(`nixamp station holder: no command "${sub}".\n\n${USAGE}`);
+                return 2;
+            }
             case "delete": {
                 const station = needId();
                 if (!station)

package/dist/station-mcp.d.ts

@@ -28,7 +28,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -36,7 +35,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -44,6 +42,13 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -83,7 +88,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -91,7 +95,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -99,6 +102,13 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -168,7 +178,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -176,6 +185,12 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -243,7 +258,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -251,6 +265,12 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -293,7 +313,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -308,6 +327,12 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -357,7 +382,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -365,7 +389,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -373,6 +396,13 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -421,7 +451,6 @@ export declare const STATION_TOOLS: ({
             };
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -429,7 +458,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -437,6 +465,13 @@ export declare const STATION_TOOLS: ({
             publish?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            action?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -515,6 +550,11 @@ export declare const STATION_TOOLS: ({
             moderation?: undefined;
             maxMb?: undefined;
             perHour?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -546,7 +586,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -589,6 +628,12 @@ export declare const STATION_TOOLS: ({
             perHour: {
                 type: string;
             };
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
             private?: undefined;
         };
         required?: undefined;
@@ -619,7 +664,6 @@ export declare const STATION_TOOLS: ({
             off?: undefined;
             key?: undefined;
             preset?: undefined;
-            name?: undefined;
             style?: undefined;
             description?: undefined;
             vocals?: undefined;
@@ -627,7 +671,6 @@ export declare const STATION_TOOLS: ({
             perDay?: undefined;
             enabled?: undefined;
             monthlySeconds?: undefined;
-            action?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -639,6 +682,93 @@ export declare const STATION_TOOLS: ({
                 type: "string";
                 description: string;
             };
+            action: {
+                type: string;
+                enum: string[];
+            };
+            id: {
+                readonly type: "string";
+            };
+            name: {
+                readonly type: "string";
+            };
+            artists: {
+                type: string;
+                items: {
+                    readonly type: "string";
+                };
+            };
+            stations: {
+                type: string;
+                items: {
+                    readonly type: "string";
+                };
+            };
+            support: {
+                type: "string";
+                description: string;
+            };
+            label: {
+                readonly type: "string";
+            };
+            license: {
+                readonly type: "string";
+            };
+            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;
+            key?: undefined;
+            preset?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
+            action?: undefined;
+            name?: undefined;
+            artists?: undefined;
+            stations?: undefined;
+            support?: undefined;
+            label?: undefined;
+            license?: undefined;
+            server: {
+                type: "string";
+                description: string;
+            };
             id: {
                 type: "string";
                 description: string;

package/dist/station-mcp.js

@@ -121,6 +121,21 @@ export const STATION_TOOLS = [
             },
         },
     },
+    {
+        name: "station_holders",
+        description: "Copyright holders for the now-playing card: who holds a track's copyright (matched by artist name or station) and the link that supports them. action list (default), set (name, artists, stations, support https URL, label, license), remove (id).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server: SERVER,
+                action: { type: "string", enum: ["list", "set", "remove"] },
+                id: STRING, name: STRING,
+                artists: { type: "array", items: STRING }, stations: { type: "array", items: STRING },
+                support: { ...STRING, description: "https link where listeners subscribe or donate, e.g. https://nixamp.com/support/profullstack" },
+                label: STRING, license: STRING,
+            },
+        },
+    },
     {
         name: "station_unpublish",
         description: "Take a station out of the directory, or make it private: its links stop working and listeners are disconnected.",
@@ -200,6 +215,16 @@ 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_holders") {
+            const action = String(args["action"] ?? "list");
+            const answer = action === "list" ? await call("GET", "/api/v1/stations/holders")
+                : action === "set" ? await call("POST", "/api/v1/stations/holders", pick(["id", "name", "artists", "stations", "support", "label", "license"]))
+                    : action === "remove" && typeof args["id"] === "string" ? await call("DELETE", `/api/v1/stations/holders/${encodeURIComponent(args["id"])}`)
+                        : null;
+            if (!answer)
+                return say("action is list, set or remove (remove needs id)", true);
+            return answer.ok ? say(JSON.stringify(answer.body, null, 2)) : refused(answer.body);
+        }
         if (name === "station_shares") {
             const action = String(args["action"] ?? "status");
             const share = typeof args["id"] === "string" && /^[a-f0-9]{12}$/.test(args["id"]) ? args["id"] : "";