nixamp 0.36.4 → 0.37.0

package/dist/station-mcp.d.ts

@@ -10,14 +10,11 @@ export declare const STATION_TOOLS: ({
             };
             playlist?: undefined;
             idempotencyKey?: undefined;
-            name?: undefined;
-            description?: undefined;
             folder?: undefined;
             items?: undefined;
             shuffle?: undefined;
             repeat?: undefined;
             bitrate?: undefined;
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -29,6 +26,24 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            name?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -50,14 +65,11 @@ export declare const STATION_TOOLS: ({
             };
             playlist?: undefined;
             idempotencyKey?: undefined;
-            name?: undefined;
-            description?: undefined;
             folder?: undefined;
             items?: undefined;
             shuffle?: undefined;
             repeat?: undefined;
             bitrate?: undefined;
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -69,6 +81,24 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            name?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -119,7 +149,6 @@ export declare const STATION_TOOLS: ({
                 type: "string";
                 description: string;
             };
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -131,6 +160,22 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            style?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -162,24 +207,23 @@ export declare const STATION_TOOLS: ({
                 readonly type: "string";
             };
             items: {
-                description?: undefined;
                 type: string;
                 items: {
                     type: string;
                 };
+                description?: undefined;
             };
             shuffle: {
                 type: string;
             };
             repeat: {
-                description?: undefined;
                 type: string;
+                description?: undefined;
             };
             bitrate: {
-                description?: undefined;
                 type: string;
+                description?: undefined;
             };
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -191,6 +235,22 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            style?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -203,8 +263,6 @@ export declare const STATION_TOOLS: ({
         properties: {
             playlist?: undefined;
             idempotencyKey?: undefined;
-            name?: undefined;
-            description?: undefined;
             folder?: undefined;
             items?: undefined;
             shuffle?: undefined;
@@ -233,6 +291,23 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            name?: 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;
             private?: undefined;
         };
         required: string[];
@@ -245,14 +320,11 @@ export declare const STATION_TOOLS: ({
         properties: {
             playlist?: undefined;
             idempotencyKey?: undefined;
-            name?: undefined;
-            description?: undefined;
             folder?: undefined;
             items?: undefined;
             shuffle?: undefined;
             repeat?: undefined;
             bitrate?: undefined;
-            action?: undefined;
             server: {
                 type: "string";
                 description: string;
@@ -283,6 +355,24 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            name?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             private?: undefined;
         };
         required: string[];
@@ -295,14 +385,11 @@ export declare const STATION_TOOLS: ({
         properties: {
             playlist?: undefined;
             idempotencyKey?: undefined;
-            name?: undefined;
-            description?: undefined;
             folder?: undefined;
             items?: undefined;
             shuffle?: undefined;
             repeat?: undefined;
             bitrate?: undefined;
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -332,6 +419,24 @@ export declare const STATION_TOOLS: ({
             off: {
                 type: string;
             };
+            key?: undefined;
+            preset?: undefined;
+            name?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             id?: undefined;
             private?: undefined;
         };
@@ -345,14 +450,162 @@ export declare const STATION_TOOLS: ({
         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;
+            server: {
+                type: "string";
+                description: string;
+            };
+            action: {
+                type: string;
+                enum: string[];
+            };
+            key: {
+                type: "string";
+                description: string;
+            };
+            preset: {
+                readonly type: "string";
+            };
+            name: {
+                readonly type: "string";
+            };
+            style: {
+                type: "string";
+                description: string;
+            };
+            description: {
+                readonly type: "string";
+            };
+            vocals: {
+                type: string;
+            };
+            trackSeconds: {
+                type: string;
+            };
+            perDay: {
+                type: string;
+            };
+            enabled: {
+                type: string;
+            };
+            publish: {
+                type: string;
+            };
+            monthlySeconds: {
+                type: string;
+            };
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            maxMb?: undefined;
+            perHour?: 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;
+            key?: undefined;
+            preset?: undefined;
             name?: undefined;
+            style?: undefined;
             description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            server: {
+                type: "string";
+                description: string;
+            };
+            action: {
+                type: string;
+                enum: string[];
+            };
+            id: {
+                type: "string";
+                description: string;
+            };
+            state: {
+                type: string;
+                enum: string[];
+            };
+            reason: {
+                readonly type: "string";
+            };
+            open: {
+                type: string;
+            };
+            moderation: {
+                type: string;
+                enum: string[];
+            };
+            publish: {
+                type: string;
+            };
+            maxMb: {
+                type: string;
+            };
+            perHour: {
+                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;
-            action?: undefined;
             visibility?: undefined;
             listed?: undefined;
             basis?: undefined;
@@ -364,6 +617,24 @@ export declare const STATION_TOOLS: ({
             breaksEvery?: undefined;
             start?: undefined;
             off?: undefined;
+            key?: undefined;
+            preset?: undefined;
+            name?: undefined;
+            style?: undefined;
+            description?: undefined;
+            vocals?: undefined;
+            trackSeconds?: undefined;
+            perDay?: undefined;
+            enabled?: undefined;
+            monthlySeconds?: undefined;
+            action?: undefined;
+            state?: undefined;
+            reason?: undefined;
+            open?: undefined;
+            moderation?: undefined;
+            publish?: undefined;
+            maxMb?: undefined;
+            perHour?: undefined;
             server: {
                 type: "string";
                 description: string;

package/dist/station-mcp.js

@@ -90,6 +90,37 @@ export const STATION_TOOLS = [
             },
         },
     },
+    {
+        name: "station_ai",
+        description: "AI radio: stations whose music is composed by AI (ElevenLabs Music or a local model) a few tracks a day, within a monthly budget of seconds. action status (default), create (preset lofi|synthwave|ambient|chiptune|punk|jazz, or name + style), generate (one track now), update, remove, budget (monthlySeconds), resume. A created station is public on the guide with basis owned unless publish is false.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server: SERVER,
+                action: { type: "string", enum: ["status", "create", "generate", "update", "remove", "budget", "resume"] },
+                key: { ...STRING, description: "The AI station's key (10 hex characters), from status." },
+                preset: STRING, name: STRING, style: { ...STRING, description: "The music in words: genre, instruments, mood, tempo. Name no artist." },
+                description: STRING, vocals: { type: "boolean" }, trackSeconds: { type: "integer" }, perDay: { type: "integer" },
+                enabled: { type: "boolean" }, publish: { type: "boolean" }, monthlySeconds: { 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.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                server: SERVER,
+                action: { type: "string", enum: ["status", "list", "configure", "approve", "reject", "delete"] },
+                id: { ...STRING, description: "A share's id (12 hex characters)." },
+                state: { type: "string", enum: ["held", "approved", "reported", "rejected", "failed", "withdrawn"] },
+                reason: STRING,
+                open: { type: "boolean" }, moderation: { type: "string", enum: ["ai", "owner"] }, publish: { type: "boolean" },
+                maxMb: { type: "integer" }, perHour: { type: "integer" },
+            },
+        },
+    },
     {
         name: "station_unpublish",
         description: "Take a station out of the directory, or make it private: its links stop working and listeners are disconnected.",
@@ -150,6 +181,41 @@ export async function callStationTool(name, args, options = {}) {
             const answer = await call("POST", "/api/v1/stations/auto", pick(["video", "minItems", "minFilms", "maxVideoRunning", "breaksEvery", "start", "off"]));
             return answer.ok ? say(JSON.stringify(answer.body["report"], null, 2)) : refused(answer.body);
         }
+        if (name === "station_ai") {
+            const action = String(args["action"] ?? "status");
+            const key = typeof args["key"] === "string" && /^[a-f0-9]{10}$/.test(args["key"]) ? args["key"] : "";
+            const fields = ["preset", "name", "style", "description", "vocals", "trackSeconds", "perDay", "enabled", "publish"];
+            const answer = action === "status" ? await call("GET", "/api/v1/stations/ai")
+                : action === "create" ? await call("POST", "/api/v1/stations/ai/stations", pick(fields))
+                    : action === "budget" ? await call("POST", "/api/v1/stations/ai", pick(["monthlySeconds"]))
+                        : action === "resume" ? await call("POST", "/api/v1/stations/ai", { resume: true })
+                            : !key ? null
+                                : action === "generate" ? await call("POST", `/api/v1/stations/ai/stations/${key}/generate`, {})
+                                    : action === "update" ? await call("PATCH", `/api/v1/stations/ai/stations/${key}`, pick(fields))
+                                        : action === "remove" ? await call("DELETE", `/api/v1/stations/ai/stations/${key}`)
+                                            : undefined;
+            if (answer === null)
+                return say("Which AI station? Pass its key from action status.", true);
+            if (answer === undefined)
+                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_shares") {
+            const action = String(args["action"] ?? "status");
+            const share = typeof args["id"] === "string" && /^[a-f0-9]{12}$/.test(args["id"]) ? args["id"] : "";
+            const answer = action === "status" ? await call("GET", "/api/v1/stations/shares?state=held")
+                : action === "list" ? await call("GET", `/api/v1/stations/shares${typeof args["state"] === "string" ? `?state=${encodeURIComponent(args["state"])}` : ""}`)
+                    : action === "configure" ? await call("POST", "/api/v1/stations/shares", pick(["open", "moderation", "publish", "maxMb", "perHour"]))
+                        : !share ? null
+                            : action === "approve" || action === "reject" ? await call("POST", `/api/v1/stations/shares/${share}/${action}`, pick(["reason"]))
+                                : action === "delete" ? await call("DELETE", `/api/v1/stations/shares/${share}`)
+                                    : undefined;
+            if (answer === null)
+                return say("Which share? Pass its id from action status or list.", true);
+            if (answer === undefined)
+                return say("action is status, list, configure, approve, reject or delete", true);
+            return answer.ok ? say(JSON.stringify(answer.body, null, 2)) : refused(answer.body);
+        }
         if (!/^[a-z0-9]{10}$/.test(id) && name !== "station_create")
             return say("Which station? Pass its id from station_list.", true);
         if (name === "station_get") {

package/dist/station-routes.d.ts

@@ -70,10 +70,14 @@ declare function links(ctx: StationContext, station: Station, base?: string): {
     state: string;
 };
 export declare function publicView(ctx: StationContext, station: Station): PublicStation;
+/** Where the guide puts a station: composed by AI, shared by listeners, or the owner's radio or TV. */
+export type GuideGroup = "ai" | "shared" | "radio" | "tv";
+export declare function guideGroup(station: Station): GuideGroup;
 /** What the public guide shows: public, listed stations, linked at this server's public address. */
 export declare function guideEntries(ctx: StationContext): Array<PublicStation & {
     page: string;
     m3u: string;
+    group: GuideGroup;
 }>;
 export declare function ownerView(ctx: StationContext, station: Station): OwnerStation & {
     links: ReturnType<typeof links>;

package/dist/station-routes.js

@@ -50,12 +50,19 @@ export function publicView(ctx, station) {
         listeners: ctx.runner.listeners(station.id),
     };
 }
+export function guideGroup(station) {
+    if (station.auto.startsWith("ai:"))
+        return "ai";
+    if (station.auto.startsWith("share:"))
+        return "shared";
+    return station.video ? "tv" : "radio";
+}
 /** What the public guide shows: public, listed stations, linked at this server's public address. */
 export function guideEntries(ctx) {
     const base = ctx.publicBase || ctx.base;
     return ctx.store.list()
         .filter((one) => one.visibility === "public" && one.listed)
-        .map((one) => ({ ...publicView(ctx, one), page: links(ctx, one, base).page, m3u: links(ctx, one, base).m3u }));
+        .map((one) => ({ ...publicView(ctx, one), page: links(ctx, one, base).page, m3u: links(ctx, one, base).m3u, group: guideGroup(one) }));
 }
 export function ownerView(ctx, station) {
     const { failures, idempotencyKey: _key, ...rest } = station;

package/dist/station-usage.d.ts

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

package/dist/station-usage.js

@@ -18,6 +18,25 @@ export const USAGE = `nixamp station — make a collection into a station
   nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]
                      a station per genre, kept in step with the library (--off stops it)
 
+  AI radio (music composed for a station, a few tracks a day):
+  nixamp station ai                          what is composing, this month's seconds, the stations
+  nixamp station ai create (--preset lofi|synthwave|ambient|chiptune|punk|jazz | --name NAME --style TEXT)
+                     [--vocals] [--seconds 120] [--per-day 2] [--unlisted]   public on the guide unless --unlisted
+  nixamp station ai generate KEY             compose one now
+  nixamp station ai set KEY [--style TEXT] [--per-day N] [--seconds N] [--off|--on]
+  nixamp station ai remove KEY [--files]
+  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, from stdin
+
+  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
+  nixamp station shares on [--owner-moderation] [--unlisted] [--max-mb 60] [--per-hour 6]
+  nixamp station shares off
+  nixamp station shares list [--state held|approved|reported|rejected]
+  nixamp station shares approve|reject|delete SHARE
+  nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For
+
   --json        machine-readable output
   --url, --key  another server, as with \`nixamp admin\`
 

package/package.json

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

package/src/ai-keys.ts

@@ -0,0 +1,49 @@
+/**
+ * The keys AI radio uses, and where they come from.
+ *
+ * The environment first, as everywhere else; then `ai.json` beside the
+ * server's own keys (0600), which `nixamp station ai key NAME` fills from
+ * stdin so a daemon restarted by `nixamp update` still has them. A key is
+ * never shown back: the owner view says which ones are set, not what they are.
+ */
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { stateDir } from "./daemon.ts";
+
+export const AI_KEY_NAMES = ["ELEVENLABS_API_KEY", "GEMINI_API_KEY", "OPENAI_API_KEY", "ANTHROPIC_API_KEY"] as const;
+export type AiKeyName = (typeof AI_KEY_NAMES)[number];
+
+export function aiKeysFile(): string {
+  return join(stateDir(), "ai.json");
+}
+
+function saved(file = aiKeysFile()): Record<string, string> {
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8")) as unknown;
+    if (typeof parsed !== "object" || parsed === null) return {};
+    return Object.fromEntries(Object.entries(parsed).filter((pair): pair is [string, string] => typeof pair[1] === "string"));
+  } catch {
+    return {};
+  }
+}
+
+/** The key, from the environment or ai.json; "" when neither has it. */
+export function aiKey(name: AiKeyName, env: Record<string, string | undefined> = process.env, file = aiKeysFile()): string {
+  return (env[name] ?? "").trim() || (saved(file)[name] ?? "").trim();
+}
+
+/** Which keys are set, never their values. */
+export function aiKeysSet(env: Record<string, string | undefined> = process.env, file = aiKeysFile()): Record<AiKeyName, boolean> {
+  return Object.fromEntries(AI_KEY_NAMES.map((name) => [name, aiKey(name, env, file) !== ""])) as Record<AiKeyName, boolean>;
+}
+
+/** Keep (or with "" forget) a key in ai.json. */
+export function saveAiKey(name: AiKeyName, value: string, file = aiKeysFile()): void {
+  const next = saved(file);
+  if (value.trim()) next[name] = value.trim();
+  else delete next[name];
+  mkdirSync(dirname(file), { recursive: true });
+  const temporary = `${file}.${process.pid}.tmp`;
+  writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+  renameSync(temporary, file);
+}