@musicflowai/cli 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# MusicFlow CLI
+
+`@musicflowai/cli` is the command-line client for the MusicFlow agent API. It is designed to be small, scriptable, and safe to automate against. The CLI talks only to the public v1 API and stores local auth state in `~/.config/musicflow/config.json`.
+
+## Install
+
+```bash
+npm install @musicflowai/cli
+```
+
+Global install is also supported:
+
+```bash
+npm install -g @musicflowai/cli
+```
+
+## Authentication
+
+There are two ways to authenticate.
+
+### Interactive login
+
+Use `musicflow login` to open a browser-based login flow. After you approve the request, the CLI stores a local app-managed API key and reuses it for future requests.
+
+```bash
+musicflow login
+```
+
+### API key
+
+Set `MUSICFLOW_API_KEY` for non-interactive use:
+
+```bash
+export MUSICFLOW_API_KEY=mf_xxxxxxxxxxxxxxxxxxxx
+```
+
+You can also override the API base URL:
+
+```bash
+export MUSICFLOW_APP_URL=https://api.musicflowai.com
+```
+
+## Commands
+
+- `musicflow login`
+- `musicflow logout`
+- `musicflow whoami`
+- `musicflow account`
+- `musicflow auth status`
+- `musicflow capabilities`
+- `musicflow song create`
+- `musicflow video from-song`
+- `musicflow publish create`
+- `musicflow plan create`
+- `musicflow job get`
+
+## Examples
+
+Create a song draft:
+
+```bash
+musicflow song create \
+  --prompt "Write a reflective indie song about starting over" \
+  --producer-id 7d6b7b2a-7f1d-4f6d-bf4e-66ff5d9f0f4a \
+  --generate-audio
+```
+
+Create a song and wait for audio completion:
+
+```bash
+musicflow song create \
+  --prompt "Write a reflective indie song about starting over" \
+  --generate-audio \
+  --sync
+```
+
+Create a single video from a song:
+
+```bash
+musicflow video from-song \
+  --song-id 6c4ab1b7-b8b4-4c1f-9c8f-4c33b0ed7a83 \
+  --caption-mode auto \
+  --caption-style alexHormozi \
+  --aspect-ratio 9:16
+```
+
+Publish an existing video:
+
+```bash
+musicflow publish create \
+  --content-id 0d7df30d-4f42-4db5-b00d-43d48f8dc2f7 \
+  --youtube-channel-id 0b5b8ad0-4c6f-4b9f-8f08-dfe4e5f0f2d2 \
+  --privacy-status unlisted
+```
+
+Inspect a queued job:
+
+```bash
+musicflow job get --id render:4e6c6fd2-1ad4-4b89-8145-21c64f2c3e19
+```
+
+## Development
+
+This package is authored in `src/` and built to `dist/`.
+
+```bash
+cd packages/musicflow-cli
+npm install
+npm run build
+```
+
+For iterative development:
+
+```bash
+npm run dev -- song create --prompt "..."
+```
+
+If you want to lint or type-check the package only:
+
+```bash
+npm run check
+```
+
+## Release Notes
+
+### 0.1.0
+
+- Initial standalone package extraction.
+- Added browser-based login.
+- Added support for `whoami`, `capabilities`, song creation, video creation, publishing, plan creation, and job polling.
+- Switched published entrypoint to `dist/cli.js`.

package/dist/args.d.ts

@@ -0,0 +1,4 @@
+export declare function parseArgs(argv: string[]): {
+    positional: string[];
+    flags: Record<string, unknown>;
+};

package/dist/args.js

@@ -0,0 +1,21 @@
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index];
+        if (!value.startsWith("--")) {
+            positional.push(value);
+            continue;
+        }
+        const key = value.slice(2).replace(/-/g, "_");
+        const next = argv[index + 1];
+        if (!next || next.startsWith("--")) {
+            flags[key] = true;
+            continue;
+        }
+        flags[key] = next;
+        index += 1;
+    }
+    return { positional, flags };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,MAAM,KAAK,GAA4B,EAAE,CAAA;IAEzC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,SAAQ;QACV,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;YACjB,SAAQ;QACV,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACjB,KAAK,IAAI,CAAC,CAAA;IACZ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9B,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { parseArgs } from "./args.js";
+import { login, logout } from "./login.js";
+import { capabilities, jobGet, planCreate, publishCreate, songCreate, videoFromSong, whoami, } from "./commands.js";
+async function main() {
+    const { positional, flags } = parseArgs(process.argv.slice(2));
+    const [group, command] = positional;
+    try {
+        if (group === "login") {
+            await login(flags);
+            return;
+        }
+        if (group === "logout") {
+            logout();
+            return;
+        }
+        if (group === "whoami" || (group === "auth" && command === "status")) {
+            await whoami(flags);
+            return;
+        }
+        if (group === "account") {
+            await whoami({ ...flags, json: flags.json ?? true });
+            return;
+        }
+        if (group === "capabilities") {
+            await capabilities(flags);
+            return;
+        }
+        if (group === "song" && command === "create") {
+            await songCreate(flags);
+            return;
+        }
+        if (group === "video" && command === "from-song") {
+            await videoFromSong(flags);
+            return;
+        }
+        if (group === "publish" && command === "create") {
+            await publishCreate(flags);
+            return;
+        }
+        if (group === "plan" && command === "create") {
+            await planCreate(flags);
+            return;
+        }
+        if (group === "job" && command === "get") {
+            await jobGet(flags);
+            return;
+        }
+        process.stdout.write(`Usage:
+  musicflow login
+  musicflow logout
+  musicflow whoami
+  musicflow capabilities
+  musicflow song create --prompt "..." [--generate-audio] [--sync]
+  musicflow video from-song --song-id <uuid>
+  musicflow publish create --content-id <uuid> --youtube-channel-id <uuid>
+  musicflow plan create --prompt "..."
+  musicflow job get --id <job-id>\n`);
+        process.exitCode = 1;
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+await main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EACL,YAAY,EACZ,MAAM,EACN,UAAU,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,MAAM,GACP,MAAM,eAAe,CAAA;AAEtB,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9D,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,UAAU,CAAA;IAEnC,IAAI,CAAC;QACH,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC,KAAK,CAAC,CAAA;YAClB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,EAAE,CAAA;YACR,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;YACrE,MAAM,MAAM,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAA;YACpD,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;YACzB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,UAAU,CAAC,KAAK,CAAC,CAAA;YACvB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,OAAO,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;YACjD,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,aAAa,CAAC,KAAK,CAAC,CAAA;YAC1B,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,UAAU,CAAC,KAAK,CAAC,CAAA;YACvB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACzC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;;;;;;;;;oCASW,CAAC,CAAA;QACjC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACtB,CAAC;AACH,CAAC;AAED,MAAM,IAAI,EAAE,CAAA"}

package/dist/commands.d.ts

@@ -0,0 +1,7 @@
+export declare function whoami(flags: Record<string, unknown>): Promise<void>;
+export declare function capabilities(flags: Record<string, unknown>): Promise<void>;
+export declare function songCreate(flags: Record<string, unknown>): Promise<void>;
+export declare function videoFromSong(flags: Record<string, unknown>): Promise<void>;
+export declare function publishCreate(flags: Record<string, unknown>): Promise<void>;
+export declare function planCreate(flags: Record<string, unknown>): Promise<void>;
+export declare function jobGet(flags: Record<string, unknown>): Promise<void>;

package/dist/commands.js

@@ -0,0 +1,95 @@
+import { requestApi } from "./http.js";
+function maybePrintJson(data, flags) {
+    if (flags.json) {
+        process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+        return true;
+    }
+    return false;
+}
+export async function whoami(flags) {
+    const data = await requestApi("GET", "/api/v1/account", undefined, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    const account = data.account;
+    const subscription = data.subscription;
+    process.stdout.write(`${account.email || account.id} (${subscription.tier})\n`);
+}
+export async function capabilities(flags) {
+    const data = await requestApi("GET", "/api/v1/capabilities", undefined, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    for (const capability of data.capabilities) {
+        process.stdout.write(`${capability.id}: ${capability.allowed ? "allowed" : "blocked"} (${capability.currentTier} -> ${capability.minimumTier})\n`);
+    }
+}
+export async function songCreate(flags) {
+    const data = await requestApi("POST", "/api/v1/songs", {
+        prompt: flags.prompt,
+        producer_id: flags.producer_id,
+        channel_id: flags.channel_id,
+        generate_audio: Boolean(flags.generate_audio),
+        sync: Boolean(flags.sync),
+        style_prompt: flags.style_prompt,
+    }, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    process.stdout.write(`Song ${data.song.id} created: ${data.song.title}\n`);
+    if (data.audio) {
+        process.stdout.write(`Audio ready: ${data.audio.url}\n`);
+    }
+    if (data.job) {
+        process.stdout.write(`Audio job queued: ${data.job.id}\n`);
+    }
+}
+export async function videoFromSong(flags) {
+    const data = await requestApi("POST", "/api/v1/videos/from-song", {
+        song_id: flags.song_id,
+        content_id: flags.content_id,
+        caption_mode: flags.caption_mode,
+        caption_style: flags.caption_style,
+        aspect_ratio: flags.aspect_ratio,
+        resolution: flags.resolution,
+        background_color: flags.background_color,
+        background_image_url: flags.background_image_url,
+        thumbnail_url: flags.thumbnail_url,
+        show_channel_logo: typeof flags.show_channel_logo === "boolean" ? flags.show_channel_logo : undefined,
+    }, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    process.stdout.write(`Video render queued: ${data.job.id}\n`);
+}
+export async function publishCreate(flags) {
+    const data = await requestApi("POST", "/api/v1/publishes", {
+        content_id: flags.content_id,
+        youtube_channel_id: flags.youtube_channel_id,
+        privacy_status: flags.privacy_status,
+        scheduled_publish_at: flags.scheduled_publish_at,
+        playlist_id: flags.playlist_id,
+    }, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    process.stdout.write(`Published: ${data.publish.youtube_url}\n`);
+}
+export async function planCreate(flags) {
+    const data = await requestApi("POST", "/api/v1/plans", {
+        prompt: flags.prompt,
+    }, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    process.stdout.write(`${data.plan.name}\n`);
+    process.stdout.write(`${data.plan.description}\n`);
+}
+export async function jobGet(flags) {
+    const data = await requestApi("GET", `/api/v1/jobs/${flags.id}`, undefined, flags);
+    if (maybePrintJson(data, flags)) {
+        return;
+    }
+    process.stdout.write(`${data.job.id}: ${data.job.status}\n`);
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface MusicflowConfig {
+    appUrl?: string;
+    apiKey?: string;
+    loggedInAt?: string;
+}
+export declare function getDefaultAppUrl(): string;
+export declare function loadConfig(): MusicflowConfig;
+export declare function saveConfig(config: MusicflowConfig): void;
+export declare function removeConfig(): void;

package/dist/config.js

@@ -0,0 +1,26 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const CONFIG_DIR = path.join(os.homedir(), ".config", "musicflow");
+const CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
+export function getDefaultAppUrl() {
+    return (process.env.MUSICFLOW_APP_URL ||
+        process.env.NEXT_PUBLIC_APP_URL ||
+        "http://localhost:3000").replace(/\/+$/, "");
+}
+export function loadConfig() {
+    if (!fs.existsSync(CONFIG_PATH)) {
+        return {};
+    }
+    return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8"));
+}
+export function saveConfig(config) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+export function removeConfig() {
+    if (fs.existsSync(CONFIG_PATH)) {
+        fs.unlinkSync(CONFIG_PATH);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAQ5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;AAClE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;AAExD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC/B,uBAAuB,CACxB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAoB,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,5 @@
+import { type MusicflowConfig } from "./config.js";
+export declare function getAuthHeaders(config: MusicflowConfig): {
+    Authorization: string;
+};
+export declare function requestApi(method: string, route: string, body?: unknown, flags?: Record<string, unknown>): Promise<any>;

package/dist/http.js

@@ -0,0 +1,37 @@
+import { loadConfig, getDefaultAppUrl } from "./config.js";
+export function getAuthHeaders(config) {
+    const apiKey = process.env.MUSICFLOW_API_KEY || config.apiKey;
+    if (!apiKey) {
+        throw new Error("Not authenticated. Run `musicflow login` or set MUSICFLOW_API_KEY.");
+    }
+    return {
+        Authorization: `Bearer ${apiKey}`,
+    };
+}
+export async function requestApi(method, route, body, flags = {}) {
+    const config = loadConfig();
+    const appUrl = String(flags.app_url || config.appUrl || getDefaultAppUrl());
+    const response = await fetch(`${appUrl}${route}`, {
+        method,
+        headers: {
+            "Content-Type": "application/json",
+            ...getAuthHeaders(config),
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const text = await response.text();
+    let data = null;
+    if (text) {
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = { raw: text };
+        }
+    }
+    if (!response.ok) {
+        throw new Error(data?.error?.message || `${response.status} ${response.statusText}`);
+    }
+    return data;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAwB,MAAM,aAAa,CAAA;AAEhF,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC,MAAM,CAAA;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;IAED,OAAO;QACL,aAAa,EAAE,UAAU,MAAM,EAAE;KAClC,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,KAAa,EACb,IAAc,EACd,QAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC,CAAA;IAC3E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,EAAE;QAChD,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,GAAG,cAAc,CAAC,MAAM,CAAC;SAC1B;QACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAClC,IAAI,IAAI,GAAQ,IAAI,CAAA;IACpB,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;QACtB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/login.d.ts

@@ -0,0 +1,2 @@
+export declare function login(flags: Record<string, unknown>): Promise<void>;
+export declare function logout(): void;

package/dist/login.js

@@ -0,0 +1,78 @@
+import http from "node:http";
+import crypto from "node:crypto";
+import { getDefaultAppUrl, loadConfig, removeConfig, saveConfig } from "./config.js";
+import { openBrowser } from "./platform.js";
+export async function login(flags) {
+    const appUrl = String(flags.app_url || getDefaultAppUrl()).replace(/\/+$/, "");
+    const state = crypto.randomUUID();
+    const apiKey = await new Promise((resolve, reject) => {
+        let timeout = null;
+        const sockets = new Set();
+        const server = http.createServer((request, response) => {
+            const requestUrl = new URL(request.url || "/", "http://127.0.0.1");
+            const returnedState = requestUrl.searchParams.get("state");
+            const returnedKey = requestUrl.searchParams.get("api_key");
+            const returnedError = requestUrl.searchParams.get("error");
+            response.writeHead(200, {
+                "Content-Type": "text/html; charset=utf-8",
+                Connection: "close",
+            });
+            response.end(returnedKey
+                ? "<html><body><p>MusicFlow CLI login complete. You can close this window.</p></body></html>"
+                : `<html><body><p>MusicFlow CLI login failed: ${returnedError || "unknown error"}</p></body></html>`, () => {
+                for (const socket of sockets) {
+                    socket.destroy();
+                }
+            });
+            server.close();
+            if (timeout) {
+                clearTimeout(timeout);
+            }
+            if (returnedState !== state) {
+                reject(new Error("CLI login state mismatch"));
+                return;
+            }
+            if (returnedError) {
+                reject(new Error(returnedError));
+                return;
+            }
+            if (!returnedKey) {
+                reject(new Error("CLI login did not return an API key"));
+                return;
+            }
+            resolve(returnedKey);
+        });
+        server.on("connection", (socket) => {
+            sockets.add(socket);
+            socket.on("close", () => {
+                sockets.delete(socket);
+            });
+        });
+        server.listen(0, "127.0.0.1", async () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                reject(new Error("Failed to start local callback server"));
+                return;
+            }
+            const callbackUrl = `http://127.0.0.1:${address.port}/callback`;
+            const loginUrl = `${appUrl}/api/v1/cli/login/start?callback_url=${encodeURIComponent(callbackUrl)}&state=${encodeURIComponent(state)}`;
+            process.stderr.write(`Opening browser for login: ${loginUrl}\n`);
+            await openBrowser(loginUrl);
+        });
+        timeout = setTimeout(() => {
+            server.close();
+            reject(new Error("CLI login timed out"));
+        }, 10 * 60 * 1000);
+    });
+    saveConfig({
+        ...loadConfig(),
+        appUrl,
+        apiKey,
+        loggedInAt: new Date().toISOString(),
+    });
+    process.stdout.write("Login complete.\n");
+}
+export function logout() {
+    removeConfig();
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"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"}

package/dist/platform.d.ts

@@ -0,0 +1 @@
+export declare function openBrowser(url: string): Promise<void>;

package/dist/platform.js

@@ -0,0 +1,18 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+export async function openBrowser(url) {
+    const platform = process.platform;
+    const command = platform === "darwin"
+        ? `open "${url}"`
+        : platform === "win32"
+            ? `start "" "${url}"`
+            : `xdg-open "${url}"`;
+    try {
+        await execAsync(command);
+    }
+    catch {
+        process.stderr.write(`Open this URL in your browser:\n${url}\n`);
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAEjC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,MAAM,OAAO,GACX,QAAQ,KAAK,QAAQ;QACnB,CAAC,CAAC,SAAS,GAAG,GAAG;QACjB,CAAC,CAAC,QAAQ,KAAK,OAAO;YACpB,CAAC,CAAC,aAAa,GAAG,GAAG;YACrB,CAAC,CAAC,aAAa,GAAG,GAAG,CAAA;IAE3B,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAAA;IAClE,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@musicflowai/cli",
+  "version": "0.1.0",
+  "description": "Command-line client for the MusicFlow agent API",
+  "type": "module",
+  "bin": {
+    "musicflow": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "dev": "tsx src/cli.ts",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}