@thenavidm/midjourney-mcp-cli 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Everything the server reads from the environment, in one place.
+ *
+ * Environment variables rather than flags, because a user configuring an MCP
+ * client is already editing a JSON `env` block, and flags would mean editing
+ * `args` separately for the same setting.
+ *
+ * There are no credentials here, and that is the point. The browser profile
+ * holds the session; this process never sees a cookie, a token or a password.
+ */
+export type Speed = "fast" | "relax" | "turbo";
+export type Config = {
+    origin: string;
+    cdpUrl: string;
+    profileDir: string;
+    chromePath?: string;
+    autoLaunch: boolean;
+    headless: boolean;
+    /** Midjourney's own id for the signed-in user. Discovered when not set. */
+    userId?: string;
+    requestTimeoutMs: number;
+    minRequestIntervalMs: number;
+    maxRetries: number;
+    jobTimeoutMs: number;
+    jobPollIntervalMs: number;
+    downloadDir: string;
+    defaultSpeed: Speed;
+    defaultVersion: string;
+    /** Reload the open window after a generation, so it shows the new work. */
+    refreshView: boolean;
+    readOnly: boolean;
+    allowDestructive: boolean;
+    auditPath?: string;
+};
+export declare function loadConfig(): Config;
+/** Every variable the code reads, so `--help`, the README and the tests agree. */
+export declare const ENV_VARS: readonly ["MIDJOURNEY_ORIGIN", "MIDJOURNEY_CDP_URL", "MIDJOURNEY_CHROME_PROFILE", "MIDJOURNEY_CHROME_PATH", "MIDJOURNEY_CHROME_LAUNCH", "MIDJOURNEY_HEADLESS", "MIDJOURNEY_USER_ID", "MIDJOURNEY_REQUEST_TIMEOUT_MS", "MIDJOURNEY_MIN_REQUEST_INTERVAL_MS", "MIDJOURNEY_MAX_RETRIES", "MIDJOURNEY_JOB_TIMEOUT_MS", "MIDJOURNEY_JOB_POLL_INTERVAL_MS", "MIDJOURNEY_DOWNLOAD_DIR", "MIDJOURNEY_DEFAULT_SPEED", "MIDJOURNEY_DEFAULT_VERSION", "MIDJOURNEY_REFRESH_VIEW", "MIDJOURNEY_READ_ONLY", "MIDJOURNEY_ALLOW_DESTRUCTIVE", "MIDJOURNEY_AUDIT_LOG", "MIDJOURNEY_HTTP_PORT", "MIDJOURNEY_HTTP_HOST", "MIDJOURNEY_HTTP_TOKEN"];

package/dist/config.js

@@ -0,0 +1,90 @@
+/**
+ * Everything the server reads from the environment, in one place.
+ *
+ * Environment variables rather than flags, because a user configuring an MCP
+ * client is already editing a JSON `env` block, and flags would mean editing
+ * `args` separately for the same setting.
+ *
+ * There are no credentials here, and that is the point. The browser profile
+ * holds the session; this process never sees a cookie, a token or a password.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { defaultProfileDir } from "./transport/cdp.js";
+function bool(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    return !["0", "false", "no", "off"].includes(raw.trim().toLowerCase());
+}
+function int(name, fallback, min, max) {
+    const raw = process.env[name];
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const value = Number(raw);
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.min(Math.max(Math.trunc(value), min), max);
+}
+function str(name) {
+    const raw = process.env[name];
+    return raw && raw.trim() ? raw.trim() : undefined;
+}
+function speed(name, fallback) {
+    const raw = str(name)?.toLowerCase();
+    return raw === "fast" || raw === "relax" || raw === "turbo" ? raw : fallback;
+}
+export function loadConfig() {
+    return {
+        origin: str("MIDJOURNEY_ORIGIN") ?? "https://www.midjourney.com",
+        cdpUrl: str("MIDJOURNEY_CDP_URL") ?? "http://127.0.0.1:9222",
+        profileDir: str("MIDJOURNEY_CHROME_PROFILE") ?? defaultProfileDir(),
+        chromePath: str("MIDJOURNEY_CHROME_PATH"),
+        autoLaunch: bool("MIDJOURNEY_CHROME_LAUNCH", true),
+        // Signing in needs a window the user can see, and Cloudflare treats new
+        // headless sessions harshly, so a visible window is the working default.
+        headless: bool("MIDJOURNEY_HEADLESS", false),
+        userId: str("MIDJOURNEY_USER_ID"),
+        requestTimeoutMs: int("MIDJOURNEY_REQUEST_TIMEOUT_MS", 30_000, 1_000, 300_000),
+        // Paced rather than hammered. The web app does not fire requests back to
+        // back and neither should we; this is the difference between a session that
+        // lasts and one that trips a bot heuristic.
+        minRequestIntervalMs: int("MIDJOURNEY_MIN_REQUEST_INTERVAL_MS", 700, 0, 60_000),
+        maxRetries: int("MIDJOURNEY_MAX_RETRIES", 3, 0, 10),
+        jobTimeoutMs: int("MIDJOURNEY_JOB_TIMEOUT_MS", 600_000, 10_000, 3_600_000),
+        jobPollIntervalMs: int("MIDJOURNEY_JOB_POLL_INTERVAL_MS", 3_000, 1_000, 60_000),
+        downloadDir: str("MIDJOURNEY_DOWNLOAD_DIR") ?? join(homedir(), "Downloads", "midjourney"),
+        defaultSpeed: speed("MIDJOURNEY_DEFAULT_SPEED", "fast"),
+        defaultVersion: str("MIDJOURNEY_DEFAULT_VERSION") ?? "8.1",
+        refreshView: bool("MIDJOURNEY_REFRESH_VIEW", true),
+        readOnly: bool("MIDJOURNEY_READ_ONLY", false),
+        allowDestructive: bool("MIDJOURNEY_ALLOW_DESTRUCTIVE", true),
+        auditPath: str("MIDJOURNEY_AUDIT_LOG"),
+    };
+}
+/** Every variable the code reads, so `--help`, the README and the tests agree. */
+export const ENV_VARS = [
+    "MIDJOURNEY_ORIGIN",
+    "MIDJOURNEY_CDP_URL",
+    "MIDJOURNEY_CHROME_PROFILE",
+    "MIDJOURNEY_CHROME_PATH",
+    "MIDJOURNEY_CHROME_LAUNCH",
+    "MIDJOURNEY_HEADLESS",
+    "MIDJOURNEY_USER_ID",
+    "MIDJOURNEY_REQUEST_TIMEOUT_MS",
+    "MIDJOURNEY_MIN_REQUEST_INTERVAL_MS",
+    "MIDJOURNEY_MAX_RETRIES",
+    "MIDJOURNEY_JOB_TIMEOUT_MS",
+    "MIDJOURNEY_JOB_POLL_INTERVAL_MS",
+    "MIDJOURNEY_DOWNLOAD_DIR",
+    "MIDJOURNEY_DEFAULT_SPEED",
+    "MIDJOURNEY_DEFAULT_VERSION",
+    "MIDJOURNEY_REFRESH_VIEW",
+    "MIDJOURNEY_READ_ONLY",
+    "MIDJOURNEY_ALLOW_DESTRUCTIVE",
+    "MIDJOURNEY_AUDIT_LOG",
+    "MIDJOURNEY_HTTP_PORT",
+    "MIDJOURNEY_HTTP_HOST",
+    "MIDJOURNEY_HTTP_TOKEN",
+];
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/content/prompt.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Midjourney's prompt grammar, as a typed thing rather than string glue.
+ *
+ * A Midjourney prompt is text followed by double-dash parameters, and the
+ * parameters have real rules: ranges, mutual exclusions, values that only exist
+ * on some model versions. Building that by concatenation means every mistake
+ * costs a round trip and, on a paid plan, a fast-hour. Worse, Midjourney does
+ * not reject most bad values; it silently clamps or ignores them, so a wrong
+ * `--stylize 5000` looks like it worked and quietly did not.
+ *
+ * So the rules live here, checked before anything is spent. The reference
+ * implementation for this API passes these through as opaque strings; catching
+ * a bad `--ar` locally rather than after a minute of GPU time is most of why
+ * this file exists.
+ */
+export type PromptParams = {
+    /** The subject text. Everything before the first parameter. */
+    text: string;
+    /** Image URLs used as image prompts. Prepended to the text, not a parameter. */
+    imagePrompts?: string[];
+    aspect?: string;
+    version?: string;
+    niji?: string;
+    stylize?: number;
+    chaos?: number;
+    weird?: number;
+    seed?: number;
+    quality?: number;
+    stop?: number;
+    repeat?: number;
+    exp?: number;
+    styleRefs?: string[];
+    styleWeight?: number;
+    omniRefs?: string[];
+    omniWeight?: number;
+    imageWeight?: number;
+    profile?: string;
+    style?: string;
+    raw?: boolean;
+    tile?: boolean;
+    draft?: boolean;
+    negative?: string;
+};
+/** `16:9`, `3:2`, `1:1`. Midjourney rejects ratios beyond roughly 1:4 to 4:1. */
+export declare function validateAspect(aspect: string): void;
+/**
+ * A style or omni reference: a URL, a numeric sref code, or `random`.
+ *
+ * Getting this wrong is a common and expensive mistake, because Midjourney
+ * treats an unrecognised `--sref` value as part of the prompt text rather than
+ * failing, so the reference is silently dropped and the image comes back
+ * looking almost right.
+ */
+export declare function validateRef(value: string, flag: string): void;
+/**
+ * Assemble the prompt Midjourney receives.
+ *
+ * Order matters to Midjourney: image prompts first, then the text, then
+ * parameters. Everything is validated before a single character is joined, so a
+ * refusal costs nothing.
+ */
+export declare function buildPrompt(params: PromptParams, defaults: {
+    version: string;
+}): string;
+/** Split a raw prompt back into text and parameters, for echoing what was sent. */
+export declare function splitPrompt(prompt: string): {
+    text: string;
+    params: string;
+};

package/dist/content/prompt.js

@@ -0,0 +1,173 @@
+/**
+ * Midjourney's prompt grammar, as a typed thing rather than string glue.
+ *
+ * A Midjourney prompt is text followed by double-dash parameters, and the
+ * parameters have real rules: ranges, mutual exclusions, values that only exist
+ * on some model versions. Building that by concatenation means every mistake
+ * costs a round trip and, on a paid plan, a fast-hour. Worse, Midjourney does
+ * not reject most bad values; it silently clamps or ignores them, so a wrong
+ * `--stylize 5000` looks like it worked and quietly did not.
+ *
+ * So the rules live here, checked before anything is spent. The reference
+ * implementation for this API passes these through as opaque strings; catching
+ * a bad `--ar` locally rather than after a minute of GPU time is most of why
+ * this file exists.
+ */
+import { ValidationError } from "../api/errors.js";
+const RANGES = {
+    stylize: { min: 0, max: 1000, label: "--stylize" },
+    chaos: { min: 0, max: 100, label: "--chaos" },
+    weird: { min: 0, max: 3000, label: "--weird" },
+    seed: { min: 0, max: 4_294_967_295, label: "--seed" },
+    stop: { min: 10, max: 100, label: "--stop" },
+    repeat: { min: 1, max: 40, label: "--repeat" },
+    exp: { min: 0, max: 100, label: "--exp" },
+    styleWeight: { min: 0, max: 1000, label: "--sw" },
+    omniWeight: { min: 0, max: 1000, label: "--ow" },
+};
+const QUALITY = [0.25, 0.5, 1, 2, 4];
+function checkRange(value, key) {
+    if (value === undefined)
+        return;
+    const range = RANGES[key];
+    if (!range)
+        return;
+    if (!Number.isFinite(value) || value < range.min || value > range.max) {
+        throw new ValidationError(`${range.label} must be between ${range.min} and ${range.max}. Got ${value}. Midjourney clamps out-of-range values silently, so this is refused here instead.`, 0, "(local)");
+    }
+}
+/** `16:9`, `3:2`, `1:1`. Midjourney rejects ratios beyond roughly 1:4 to 4:1. */
+export function validateAspect(aspect) {
+    const match = /^(\d{1,3}):(\d{1,3})$/.exec(aspect.trim());
+    if (!match) {
+        throw new ValidationError(`--ar must look like 16:9. Got '${aspect}'.`, 0, "(local)");
+    }
+    const width = Number(match[1]);
+    const height = Number(match[2]);
+    if (width === 0 || height === 0) {
+        throw new ValidationError(`--ar cannot have a zero side. Got '${aspect}'.`, 0, "(local)");
+    }
+}
+/**
+ * A style or omni reference: a URL, a numeric sref code, or `random`.
+ *
+ * Getting this wrong is a common and expensive mistake, because Midjourney
+ * treats an unrecognised `--sref` value as part of the prompt text rather than
+ * failing, so the reference is silently dropped and the image comes back
+ * looking almost right.
+ */
+export function validateRef(value, flag) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new ValidationError(`${flag} cannot be empty.`, 0, "(local)");
+    if (trimmed.toLowerCase() === "random")
+        return;
+    if (/^\d+$/.test(trimmed))
+        return;
+    if (/^https?:\/\/\S+$/i.test(trimmed))
+        return;
+    throw new ValidationError(`${flag} must be an image URL, a numeric style code, or 'random'. Got '${trimmed}'. Midjourney does not reject a bad reference, it silently treats it as prompt text.`, 0, "(local)");
+}
+/**
+ * Midjourney's own asset hosts serve images from extensionless URLs.
+ *
+ * `https://s.mj.run/xE_f2o6GRl0` is what the web app produces when you drag an
+ * image in, and it is the form that appears in real prompts. An extension check
+ * alone rejects it, which would refuse the most common image prompt there is.
+ */
+const MIDJOURNEY_ASSET_HOSTS = /^https?:\/\/(s\.mj\.run|cdn\.midjourney\.com|storage\.googleapis\.com)\//i;
+function validateImagePrompt(value) {
+    const trimmed = value.trim();
+    if (MIDJOURNEY_ASSET_HOSTS.test(trimmed))
+        return;
+    if (/^https?:\/\/\S+\.(png|jpe?g|webp|gif)(\?\S*)?$/i.test(trimmed))
+        return;
+    throw new ValidationError(`An image prompt must be a direct URL to an image file, ending in .png, .jpg, .jpeg, .webp or .gif, or a Midjourney asset URL such as https://s.mj.run/... . Got '${value}'. A link to the page an image sits on will not work.`, 0, "(local)");
+}
+/**
+ * Assemble the prompt Midjourney receives.
+ *
+ * Order matters to Midjourney: image prompts first, then the text, then
+ * parameters. Everything is validated before a single character is joined, so a
+ * refusal costs nothing.
+ */
+export function buildPrompt(params, defaults) {
+    const text = params.text.trim();
+    if (!text && (params.imagePrompts?.length ?? 0) === 0) {
+        throw new ValidationError("A prompt needs text, an image prompt, or both.", 0, "(local)");
+    }
+    if (params.aspect)
+        validateAspect(params.aspect);
+    for (const ref of params.styleRefs ?? [])
+        validateRef(ref, "--sref");
+    for (const ref of params.omniRefs ?? [])
+        validateRef(ref, "--oref");
+    for (const image of params.imagePrompts ?? [])
+        validateImagePrompt(image);
+    for (const key of Object.keys(RANGES)) {
+        checkRange(params[key], key);
+    }
+    if (params.quality !== undefined && !QUALITY.includes(params.quality)) {
+        throw new ValidationError(`--q must be one of ${QUALITY.join(", ")}. Got ${params.quality}.`, 0, "(local)");
+    }
+    if (params.imageWeight !== undefined && (params.imageWeight < 0 || params.imageWeight > 3)) {
+        throw new ValidationError(`--iw must be between 0 and 3. Got ${params.imageWeight}.`, 0, "(local)");
+    }
+    if (params.niji && params.version) {
+        throw new ValidationError("Pass either version or niji, not both. Niji is its own model line and ignores --v.", 0, "(local)");
+    }
+    if (params.raw && params.style && params.style !== "raw") {
+        throw new ValidationError(`raw and style are the same parameter. Set style to '${params.style}' or set raw, not both.`, 0, "(local)");
+    }
+    const parts = [];
+    for (const image of params.imagePrompts ?? [])
+        parts.push(image.trim());
+    if (text)
+        parts.push(text);
+    const flag = (name, value) => {
+        if (value === undefined || value === "")
+            return;
+        parts.push(`--${name}`, String(value));
+    };
+    flag("ar", params.aspect);
+    for (const ref of params.styleRefs ?? [])
+        flag("sref", ref);
+    flag("sw", params.styleWeight);
+    for (const ref of params.omniRefs ?? [])
+        flag("oref", ref);
+    flag("ow", params.omniWeight);
+    flag("iw", params.imageWeight);
+    flag("profile", params.profile);
+    flag("no", params.negative);
+    if (params.niji) {
+        flag("niji", params.niji);
+    }
+    else {
+        flag("v", params.version ?? defaults.version);
+    }
+    flag("stylize", params.stylize);
+    flag("chaos", params.chaos);
+    flag("weird", params.weird);
+    flag("seed", params.seed);
+    flag("q", params.quality);
+    flag("stop", params.stop);
+    flag("repeat", params.repeat);
+    flag("exp", params.exp);
+    if (params.style)
+        flag("style", params.style);
+    else if (params.raw)
+        flag("style", "raw");
+    if (params.tile)
+        parts.push("--tile");
+    if (params.draft)
+        parts.push("--draft");
+    return parts.join(" ");
+}
+/** Split a raw prompt back into text and parameters, for echoing what was sent. */
+export function splitPrompt(prompt) {
+    const index = prompt.search(/\s--\w/);
+    if (index === -1)
+        return { text: prompt.trim(), params: "" };
+    return { text: prompt.slice(0, index).trim(), params: prompt.slice(index).trim() };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/content/prompt.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Say what is wrong, in the order it has to be fixed.
+ *
+ * Every failure mode here produces the same symptom from a tool call, a refused
+ * request, and they need completely different fixes: install Chrome, start it,
+ * sign in, wait out a challenge. Guessing between them is where people give up
+ * on a tool like this, so the checks run in dependency order and stop at the
+ * first one that fails, rather than printing four red lines and leaving the
+ * reader to work out which one matters.
+ */
+export declare function runDoctor(): Promise<number>;
+/**
+ * Open the controlled window and wait for the user to sign in.
+ *
+ * There is no password to collect and nothing to store: signing in happens in
+ * the browser, and the browser profile keeps the session. This command exists
+ * so nobody has to be told to construct a Chrome command line by hand.
+ */
+export declare function runLogin(): Promise<number>;

package/dist/doctor.js

@@ -0,0 +1,161 @@
+/**
+ * Say what is wrong, in the order it has to be fixed.
+ *
+ * Every failure mode here produces the same symptom from a tool call, a refused
+ * request, and they need completely different fixes: install Chrome, start it,
+ * sign in, wait out a challenge. Guessing between them is where people give up
+ * on a tool like this, so the checks run in dependency order and stop at the
+ * first one that fails, rather than printing four red lines and leaving the
+ * reader to work out which one matters.
+ */
+import { access, constants, mkdir } from "node:fs/promises";
+import { MidjourneyClient } from "./api/client.js";
+import { loadConfig } from "./config.js";
+import { CdpBrowser, findChrome } from "./transport/cdp.js";
+import { VERSION } from "./server.js";
+function line(check) {
+    const mark = check.ok ? "ok  " : "FAIL";
+    const base = `  ${mark}  ${check.label.padEnd(22)}${check.detail}`;
+    return check.fix && !check.ok ? `${base}\n        -> ${check.fix}` : base;
+}
+async function checkChrome(config) {
+    try {
+        const path = findChrome(config.chromePath);
+        return { label: "chrome", ok: true, detail: path };
+    }
+    catch (error) {
+        return {
+            label: "chrome",
+            ok: false,
+            detail: error.message,
+            fix: "Install Google Chrome, or set MIDJOURNEY_CHROME_PATH to the binary.",
+        };
+    }
+}
+async function checkDownloadDir(config) {
+    try {
+        await mkdir(config.downloadDir, { recursive: true });
+        await access(config.downloadDir, constants.W_OK);
+        return { label: "download dir", ok: true, detail: config.downloadDir };
+    }
+    catch (error) {
+        return {
+            label: "download dir",
+            ok: false,
+            detail: `${config.downloadDir}: ${error.message}`,
+            fix: "Set MIDJOURNEY_DOWNLOAD_DIR to somewhere writable.",
+        };
+    }
+}
+export async function runDoctor() {
+    const config = loadConfig();
+    const out = (text) => {
+        process.stdout.write(`${text}\n`);
+    };
+    out(`\nmidjourney-mcp ${VERSION}\n`);
+    out(`  profile     ${config.profileDir}`);
+    out(`  devtools    ${config.cdpUrl}`);
+    out(`  origin      ${config.origin}`);
+    out(`  mode        ${config.readOnly ? "read-only" : config.allowDestructive ? "writes enabled" : "writes disabled"}`);
+    out(``);
+    const checks = [];
+    const chrome = await checkChrome(config);
+    checks.push(chrome);
+    if (!chrome.ok) {
+        for (const check of checks)
+            out(line(check));
+        out(``);
+        return 1;
+    }
+    const browser = new CdpBrowser({
+        cdpUrl: config.cdpUrl,
+        profileDir: config.profileDir,
+        chromePath: config.chromePath,
+        autoLaunch: false,
+        headless: config.headless,
+        timeoutMs: config.requestTimeoutMs,
+        origin: config.origin,
+    });
+    const running = await browser.isRunning();
+    checks.push({
+        label: "browser running",
+        ok: running,
+        detail: running ? ((await browser.version())?.Browser ?? "yes") : `nothing on ${config.cdpUrl}`,
+        fix: `Run \`midjourney-cli login\` to start the controlled window and sign in. It also starts on demand on the first tool call${config.autoLaunch ? "" : ", except MIDJOURNEY_CHROME_LAUNCH=0 is set"}.`,
+    });
+    if (running) {
+        const client = new MidjourneyClient(config, browser);
+        try {
+            const userId = await client.userId();
+            checks.push({ label: "signed in", ok: true, detail: `user ${userId}` });
+        }
+        catch (error) {
+            checks.push({
+                label: "signed in",
+                ok: false,
+                detail: error.message,
+                fix: "Run `midjourney-cli login`, sign in to Midjourney in the window that opens, then try again.",
+            });
+        }
+        client.close();
+    }
+    checks.push(await checkDownloadDir(config));
+    for (const check of checks)
+        out(line(check));
+    out(``);
+    const failed = checks.filter((check) => !check.ok);
+    if (failed.length === 0) {
+        out(`  Everything checks out.\n`);
+        return 0;
+    }
+    out(`  ${failed.length} problem(s). Fix the first one; the rest often follow.\n`);
+    return 1;
+}
+/**
+ * Open the controlled window and wait for the user to sign in.
+ *
+ * There is no password to collect and nothing to store: signing in happens in
+ * the browser, and the browser profile keeps the session. This command exists
+ * so nobody has to be told to construct a Chrome command line by hand.
+ */
+export async function runLogin() {
+    const config = loadConfig();
+    const browser = new CdpBrowser({
+        cdpUrl: config.cdpUrl,
+        profileDir: config.profileDir,
+        chromePath: config.chromePath,
+        autoLaunch: true,
+        // Signing in needs a window regardless of what the config says.
+        headless: false,
+        timeoutMs: config.requestTimeoutMs,
+        origin: config.origin,
+    });
+    process.stderr.write(`\nOpening ${config.origin} in the controlled browser.\n`);
+    process.stderr.write(`Profile: ${config.profileDir}\n\n`);
+    try {
+        await browser.launch();
+    }
+    catch (error) {
+        process.stderr.write(`${error.message}\n`);
+        return 1;
+    }
+    const client = new MidjourneyClient(config, browser);
+    process.stderr.write("Sign in to Midjourney in that window. Waiting...\n");
+    const deadline = Date.now() + 5 * 60_000;
+    while (Date.now() < deadline) {
+        try {
+            const userId = await client.userId();
+            process.stderr.write(`\nSigned in as ${userId}.\n`);
+            process.stderr.write("The session persists in this profile, so this is a one-time step.\n\n");
+            client.close();
+            return 0;
+        }
+        catch {
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+        }
+    }
+    process.stderr.write("\nStill not signed in after five minutes. Leave the window open and run `midjourney-cli doctor` once you are.\n");
+    client.close();
+    return 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/format/jobs.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Normalising jobs out of an API with no contract.
+ *
+ * Everything here is defensive on purpose. Midjourney's web endpoints are not
+ * published, are not versioned and have already changed field names more than
+ * once, so anything that assumes an exact shape will break on a Tuesday for
+ * reasons nobody can debug from a stack trace.
+ *
+ * The rule this file follows: read what is recognisable, keep the untouched
+ * original alongside it, and never throw because a field moved. A tool that
+ * returns a job with a missing prompt is still useful. A tool that throws
+ * because `image_paths` became `imagePaths` is not.
+ */
+export type JobStatus = "queued" | "running" | "completed" | "failed" | "moderated" | "unknown";
+export type Job = {
+    id: string;
+    status: JobStatus;
+    /** The raw status string, because ours is a lossy mapping. */
+    rawStatus?: string;
+    prompt?: string;
+    fullCommand?: string;
+    /** Direct URLs to the rendered images, when the job has finished. */
+    images: string[];
+    createdAt?: string;
+    finishedAt?: string;
+    /** Percentage, when the app reported one. */
+    progress?: number;
+    eventType?: string;
+    parentId?: string;
+    width?: number;
+    height?: number;
+    /** How many images the job rendered. 4 for a normal grid. */
+    batchSize?: number;
+    /** Midjourney's own name for the job, e.g. `v8-1_diffusion`. */
+    jobType?: string;
+    /** Whatever else came back, untouched. */
+    raw: Record<string, unknown>;
+};
+export declare const CDN_ORIGIN = "https://cdn.midjourney.com";
+/**
+ * Where a finished job's images live.
+ *
+ * The history endpoint returns no image URLs at all, only the job id and a
+ * `batch_size`. The assets sit at a predictable path, which is how the web app
+ * renders a grid without a second request per tile. Verified against a real
+ * job: `<id>/0_0.png` is the full-resolution render, matching the `width` and
+ * `height` on the record.
+ *
+ * This is a derived URL, not a documented one. If Midjourney moves its assets
+ * these stop resolving, which is why `download_job` reports per-image failures
+ * rather than throwing the batch away.
+ */
+export declare function imageUrlsFor(jobId: string, batchSize: number): string[];
+export declare function isTerminal(status: JobStatus): boolean;
+export declare function normaliseStatus(value: unknown): {
+    status: JobStatus;
+    raw?: string;
+};
+/** Every image URL we can find on a job record, in order, deduplicated. */
+export declare function extractImages(record: Record<string, unknown>): string[];
+export declare function normaliseJob(input: unknown): Job | undefined;
+/**
+ * Find the job array inside whatever envelope came back.
+ *
+ * The app has returned a bare array, `{jobs: []}`, `{data: []}` and
+ * `{results: []}` at different times. Rather than track which, look for the
+ * first array whose members look like jobs.
+ */
+export declare function extractJobs(payload: unknown, depth?: number): Job[];
+/** The compact shape tools return, so a model is not handed forty raw fields. */
+export declare function summariseJob(job: Job): Record<string, unknown>;