@thenavidm/midjourney-mcp-cli 1.0.0

package/dist/api/jobs.js

@@ -0,0 +1,296 @@
+/**
+ * Submitting work and following it to the end.
+ *
+ * This is the part the reference CLI for this API does not have, and it is the
+ * part that makes the difference between a toy and something an agent can use.
+ * Submitting returns a job id in about a second; the image does not exist for
+ * another thirty to ninety. A tool that returns the id and stops has handed the
+ * caller a polling loop to write, and a model asked to "make me a logo" will
+ * either return an id nobody can use or invent a wait and guess wrong.
+ *
+ * So submission and completion are one operation here, with the polling,
+ * back-off and terminal-state detection on this side of the boundary.
+ */
+import { JobTimeoutError, MidjourneyError, ValidationError } from "./errors.js";
+import { extractJobs, isTerminal } from "../format/jobs.js";
+export const ENDPOINTS = {
+    submit: "/api/submit-jobs",
+    jobs: "/api/imagine",
+    updates: "/api/imagine-update",
+    queue: "/api/user-queue",
+    folders: "/api/folders",
+    moodboards: "/api/moodboards",
+    storage: "/api/storage",
+    explore: "/api/explore",
+    exploreStyleLikes: "/api/explore-styles-likes",
+    personalizedProfiles: "/api/personalized-profiles",
+    following: "/api/following-for-user",
+    modelRatings: "/api/model-ratings",
+    contestsRankingCount: "/api/contests-ranking-count",
+    jobStatus: "/api/job-status",
+};
+/** `singleplayer_<uuid>` is what the web app calls a solo user's own channel. */
+export function channelIdFor(userId) {
+    const trimmed = userId.trim();
+    return trimmed.startsWith("singleplayer_") ? trimmed : `singleplayer_${trimmed}`;
+}
+function metadataFor(options) {
+    return {
+        isMobile: null,
+        imagePrompts: options.imagePromptCount ?? 0,
+        imageReferences: options.styleRefCount ?? 0,
+        characterReferences: options.omniRefCount ?? 0,
+        depthReferences: 0,
+        lightboxOpen: null,
+    };
+}
+/** Job ids out of a submission response, whatever it is wrapped in. */
+export function extractJobIds(payload, depth = 0) {
+    if (depth > 5 || payload === null || payload === undefined)
+        return [];
+    if (typeof payload === "string") {
+        return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(payload)
+            ? [payload]
+            : [];
+    }
+    if (Array.isArray(payload)) {
+        return payload.flatMap((item) => extractJobIds(item, depth + 1));
+    }
+    if (typeof payload !== "object")
+        return [];
+    const record = payload;
+    const found = [];
+    for (const key of ["job_id", "jobId", "id", "success_jobs", "jobs"]) {
+        if (key in record)
+            found.push(...extractJobIds(record[key], depth + 1));
+    }
+    if (found.length === 0) {
+        for (const value of Object.values(record))
+            found.push(...extractJobIds(value, depth + 1));
+    }
+    return [...new Set(found)];
+}
+/** Submit an imagine. Returns the job ids Midjourney accepted. */
+export async function submitImagine(client, prompt, options = {}) {
+    const userId = await client.userId();
+    const body = {
+        f: { mode: options.speed ?? client.config.defaultSpeed, private: options.private ?? false },
+        channelId: channelIdFor(userId),
+        metadata: metadataFor(options),
+        t: "imagine",
+        prompt,
+    };
+    // Never retried. A retry after a timeout would submit a second job and charge
+    // for it, and there is no way from here to tell a lost response from a lost
+    // request.
+    const raw = await client.request(ENDPOINTS.submit, {
+        method: "POST",
+        body,
+        noRetry: true,
+    });
+    refreshView(client, options.refresh !== false);
+    return { jobIds: extractJobIds(raw), raw };
+}
+/**
+ * Nudge the open window, without ever letting it affect the result.
+ *
+ * Deliberately not awaited: the generation has already been paid for by the
+ * time this runs, and a cosmetic reload must not be able to turn a successful
+ * submission into a thrown error.
+ */
+function refreshView(client, enabled = true) {
+    if (!enabled || !client.config.refreshView)
+        return;
+    void client.transport.refreshView().catch(() => undefined);
+}
+/** Re-run an existing job, unchanged or with a new prompt. */
+export async function submitRerun(client, jobId, options = {}) {
+    const userId = await client.userId();
+    const body = {
+        f: { mode: options.speed ?? client.config.defaultSpeed, private: options.private ?? false },
+        channelId: channelIdFor(userId),
+        metadata: metadataFor(options),
+        t: "reroll",
+        newPrompt: options.newPrompt ?? null,
+        id: jobId.trim(),
+    };
+    const raw = await client.request(ENDPOINTS.submit, {
+        method: "POST",
+        body,
+        noRetry: true,
+    });
+    refreshView(client, options.refresh !== false);
+    return { jobIds: extractJobIds(raw), raw };
+}
+/**
+ * Vary one image from a finished grid.
+ *
+ * Captured from the web app rather than guessed: `Vary Subtle` and `Vary
+ * Strong` are the same job type with a `strong` boolean, addressing one tile by
+ * `index`. Note the metadata block here is all nulls, where an imagine sends
+ * counts. That difference is what the app sends, so it is what we send.
+ */
+export async function submitVary(client, jobId, index, options = {}) {
+    const userId = await client.userId();
+    const body = {
+        f: { mode: options.speed ?? client.config.defaultSpeed, private: options.private ?? false },
+        channelId: channelIdFor(userId),
+        metadata: {
+            isMobile: null,
+            imagePrompts: null,
+            imageReferences: null,
+            characterReferences: null,
+            depthReferences: null,
+            lightboxOpen: null,
+        },
+        t: "vary",
+        strong: options.strong ?? false,
+        v8_1_hd: null,
+        v8_2_hd: null,
+        id: jobId.trim(),
+        index,
+    };
+    const raw = await client.request(ENDPOINTS.submit, {
+        method: "POST",
+        body,
+        noRetry: true,
+    });
+    refreshView(client, options.refresh !== false);
+    return { jobIds: extractJobIds(raw), raw };
+}
+/**
+ * Submit an arbitrary job type.
+ *
+ * The escape hatch, and deliberately not dressed up as anything else. Only
+ * `imagine` and `reroll` are confirmed against observed traffic. The web app
+ * sends other values of `t` for upscales and variations, but guessing at their
+ * payloads and shipping them as named tools would mean charging the user for
+ * requests that quietly do nothing. Capture the real traffic first:
+ * `midjourney-cli capture` records what the app actually sends.
+ */
+export async function submitRaw(client, jobType, extra, options = {}) {
+    if (!jobType.trim())
+        throw new ValidationError("A job type is required.", 0, "(local)");
+    const userId = await client.userId();
+    const body = {
+        f: { mode: options.speed ?? client.config.defaultSpeed, private: options.private ?? false },
+        channelId: channelIdFor(userId),
+        metadata: metadataFor(options),
+        t: jobType.trim(),
+        ...extra,
+    };
+    const raw = await client.request(ENDPOINTS.submit, {
+        method: "POST",
+        body,
+        noRetry: true,
+    });
+    refreshView(client, options.refresh !== false);
+    return { jobIds: extractJobIds(raw), raw };
+}
+/** Recent jobs for the signed-in account. */
+export async function listJobs(client, options = {}) {
+    const userId = options.userId ?? (await client.userId());
+    const raw = await client.request(ENDPOINTS.jobs, {
+        query: {
+            user_id: userId.replace(/^singleplayer_/, ""),
+            page_size: options.limit ?? 25,
+            cursor: options.cursor,
+        },
+    });
+    return { jobs: extractJobs(raw), raw };
+}
+/** The update feed, which is what the web app polls while work is running. */
+export async function jobUpdates(client, options = {}) {
+    const userId = options.userId ?? (await client.userId());
+    const raw = await client.request(ENDPOINTS.updates, {
+        query: {
+            user_id: userId.replace(/^singleplayer_/, ""),
+            page_size: options.limit ?? 25,
+            checkpoint: options.checkpoint,
+        },
+    });
+    return { jobs: extractJobs(raw), raw };
+}
+/**
+ * Ask about specific jobs by id.
+ *
+ * The one endpoint that answers "is this done?" honestly. It carries
+ * `current_status`, and it works for a job that has not reached the history
+ * feed yet, which is every job while it is still rendering.
+ *
+ * Everything else here was built before this was found, by inferring completion
+ * from whether image URLs could be derived. That inference happened to be right
+ * because the history feed only lists finished work, but it could never have
+ * reported "running" for anything.
+ */
+export async function jobStatus(client, jobIds) {
+    if (jobIds.length === 0)
+        return [];
+    const raw = await client.request(ENDPOINTS.jobStatus, {
+        method: "POST",
+        body: { jobIds, _frontend_source: "midjourney-mcp" },
+    });
+    return extractJobs(raw);
+}
+/** One job by id, asking the status endpoint first. */
+export async function findJob(client, jobId) {
+    const id = jobId.trim();
+    const direct = await jobStatus(client, [id]).catch(() => []);
+    const found = direct.find((job) => job.id === id);
+    if (found)
+        return found;
+    // Fallbacks, for a job the status endpoint does not know: it may have been
+    // submitted a moment ago, or belong to an older model line.
+    const fromUpdates = await jobUpdates(client, { limit: 50 }).catch(() => undefined);
+    const inUpdates = fromUpdates?.jobs.find((job) => job.id === id);
+    if (inUpdates)
+        return inUpdates;
+    const fromList = await listJobs(client, { limit: 50 }).catch(() => undefined);
+    return fromList?.jobs.find((job) => job.id === id);
+}
+/**
+ * Poll until a job reaches a terminal state.
+ *
+ * The interval widens as the wait goes on. A generation is quick at fast speed
+ * and can be twenty minutes at relax, and polling every three seconds for
+ * twenty minutes is four hundred requests nobody needs, on an endpoint we would
+ * rather not be conspicuous on.
+ */
+export async function waitForJob(client, jobId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? client.config.jobTimeoutMs;
+    const baseInterval = options.pollIntervalMs ?? client.config.jobPollIntervalMs;
+    const startedAt = Date.now();
+    for (let poll = 0;; poll++) {
+        const elapsed = Date.now() - startedAt;
+        if (elapsed > timeoutMs) {
+            throw new JobTimeoutError(`Job ${jobId} had not finished after ${Math.round(timeoutMs / 1000)}s. It may still be running: check with get_job. Relax-mode jobs regularly take longer than the default timeout, so raise MIDJOURNEY_JOB_TIMEOUT_MS if this is normal for your plan.`, jobId);
+        }
+        const job = await findJob(client, jobId).catch((error) => {
+            // A single failed poll is not a failed job. Keep waiting unless the
+            // failure is one that will repeat forever.
+            if (error instanceof MidjourneyError && ["NotSignedInError", "WriteBlockedError"].includes(error.name)) {
+                throw error;
+            }
+            return undefined;
+        });
+        options.onProgress?.(job, elapsed);
+        if (job && isTerminal(job.status)) {
+            // Again on completion: the reload at submit time showed an empty slot,
+            // this one shows the finished images.
+            refreshView(client);
+            return job;
+        }
+        // 3s, 3s, 4.5s, 6.75s ... capped at 20s.
+        const interval = Math.min(baseInterval * Math.pow(1.5, Math.max(0, poll - 1)), 20_000);
+        await new Promise((resolve) => setTimeout(resolve, interval));
+        // No early bail-out for a job that has not appeared yet.
+        //
+        // `/api/imagine` is a history feed: a job shows up in it once it has
+        // finished, not while it renders. So "not in the feed" is the normal state
+        // for the entire render, and giving up after a handful of polls would fail
+        // every relax-mode job, which is exactly when waiting matters most.
+        // Verified: a fast v8.1 job is absent at t+5s and present, complete, at
+        // t+10s. The only honest deadline is the timeout the caller asked for.
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/api/jobs.js.map

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

package/dist/api/moodboards.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Moodboards and personalisation, as things a prompt can actually use.
+ *
+ * A moodboard in the web app is a named pile of reference images. The API hands
+ * back each image as an `s.mj.run` URL, which is the same form `--sref` takes,
+ * so a moodboard is already a style reference, it just has to be looked up by
+ * the name a person calls it rather than a nineteen-digit id.
+ *
+ * That lookup is the point of this file. "Use my High Fashion moodboard" is how
+ * someone thinks about it; `--sref https://s.mj.run/gJFLgT-zAvg --sref ...` is
+ * what Midjourney needs, and nobody should be pasting those by hand.
+ */
+import type { MidjourneyClient } from "./client.js";
+export type MoodboardImage = {
+    url: string;
+    width?: number;
+    height?: number;
+};
+export type Moodboard = {
+    id: string;
+    title: string;
+    personalize: boolean;
+    created?: string;
+    images: MoodboardImage[];
+};
+export type PersonalizationProfile = {
+    id: string;
+    title: string;
+    rankingCount?: number;
+    majorVersion?: string;
+};
+export declare function listMoodboards(client: MidjourneyClient): Promise<Moodboard[]>;
+export declare function listProfiles(client: MidjourneyClient): Promise<PersonalizationProfile[]>;
+/**
+ * Find a moodboard by the name someone would say, or by id.
+ *
+ * Exact title first, then case-insensitive, then a unique substring. An
+ * ambiguous substring is an error naming the candidates rather than a silent
+ * pick: choosing "Porsche Campaign" when someone meant "Mercedes Campaign"
+ * would be wrong in a way that costs a generation to discover.
+ */
+export declare function matchMoodboard(boards: Moodboard[], query: string): Moodboard;
+/**
+ * Pick references out of a moodboard.
+ *
+ * Every image would make an unusable prompt: a 242-image board becomes 242
+ * `--sref` flags. A handful is what the web app effectively does too, and
+ * spreading the pick across the board rather than taking the first few avoids
+ * always drawing on whatever was added first.
+ */
+export declare function pickReferences(board: Moodboard, count: number): string[];
+/** Resolve "use my High Fashion moodboard" to the style references it means. */
+export declare function referencesFromMoodboard(client: MidjourneyClient, query: string, count: number): Promise<{
+    board: Moodboard;
+    refs: string[];
+}>;
+/**
+ * The write API, captured from the web app rather than guessed at.
+ *
+ * Worth writing down how it actually works, because none of it is guessable.
+ * Creating is a POST to the collection. Adding is a PATCH to the *collection*
+ * with the board in a query parameter, not a POST to the board, and the body
+ * carries an `add` array of image records rather than bare URLs. Every shape I
+ * tried before capturing the real call returned a 500 that said nothing.
+ *
+ * The web app also uploads the image into the account's own storage first, via
+ * `/api/storage-upload-moodboard-file`, and adds the re-hosted copy. That step
+ * turns out to be skippable: a `cdn.midjourney.com` job URL patches in directly
+ * and the board renders it. Verified against a real board.
+ */
+export type AddImage = {
+    url: string;
+    width?: number;
+    height?: number;
+};
+export declare function createMoodboard(client: MidjourneyClient, title: string): Promise<{
+    id?: string;
+    title: string;
+    raw: unknown;
+}>;
+export declare function addToMoodboard(client: MidjourneyClient, moodboardId: string, images: AddImage[]): Promise<{
+    added: number;
+    raw: unknown;
+}>;
+export declare function removeFromMoodboard(client: MidjourneyClient, moodboardId: string, urls: string[]): Promise<{
+    removed: number;
+    raw: unknown;
+}>;

package/dist/api/moodboards.js

@@ -0,0 +1,189 @@
+/**
+ * Moodboards and personalisation, as things a prompt can actually use.
+ *
+ * A moodboard in the web app is a named pile of reference images. The API hands
+ * back each image as an `s.mj.run` URL, which is the same form `--sref` takes,
+ * so a moodboard is already a style reference, it just has to be looked up by
+ * the name a person calls it rather than a nineteen-digit id.
+ *
+ * That lookup is the point of this file. "Use my High Fashion moodboard" is how
+ * someone thinks about it; `--sref https://s.mj.run/gJFLgT-zAvg --sref ...` is
+ * what Midjourney needs, and nobody should be pasting those by hand.
+ */
+import { NotFoundError } from "./errors.js";
+import { ENDPOINTS } from "./jobs.js";
+function asArray(payload) {
+    if (Array.isArray(payload))
+        return payload.filter((item) => !!item && typeof item === "object");
+    if (payload && typeof payload === "object") {
+        for (const key of ["moodboards", "profiles", "data", "results", "items"]) {
+            const nested = payload[key];
+            if (Array.isArray(nested))
+                return asArray(nested);
+        }
+    }
+    return [];
+}
+function normaliseMoodboard(record) {
+    const id = record.moodboard_id ?? record.id;
+    if (typeof id !== "string" && typeof id !== "number")
+        return undefined;
+    const rawImages = Array.isArray(record.images) ? record.images : [];
+    const images = [];
+    for (const item of rawImages) {
+        if (!item || typeof item !== "object")
+            continue;
+        const url = item.url;
+        if (typeof url !== "string" || !/^https?:\/\//i.test(url))
+            continue;
+        const width = item.width;
+        const height = item.height;
+        images.push({
+            url,
+            ...(typeof width === "number" ? { width } : {}),
+            ...(typeof height === "number" ? { height } : {}),
+        });
+    }
+    return {
+        id: String(id),
+        title: typeof record.title === "string" ? record.title : "(untitled)",
+        personalize: record.personalize === true,
+        ...(typeof record.created === "string" ? { created: record.created } : {}),
+        images,
+    };
+}
+export async function listMoodboards(client) {
+    const raw = await client.request(ENDPOINTS.moodboards);
+    return asArray(raw)
+        .map(normaliseMoodboard)
+        .filter((board) => board !== undefined);
+}
+export async function listProfiles(client) {
+    const raw = await client.request(ENDPOINTS.personalizedProfiles);
+    return asArray(raw)
+        .map((record) => {
+        const id = record.id;
+        if (typeof id !== "string" && typeof id !== "number")
+            return undefined;
+        return {
+            id: String(id),
+            title: typeof record.title === "string" ? record.title : "(untitled)",
+            ...(typeof record.rankingCount === "number" ? { rankingCount: record.rankingCount } : {}),
+            ...(typeof record.majorVersion === "string" ? { majorVersion: record.majorVersion } : {}),
+        };
+    })
+        .filter((profile) => profile !== undefined);
+}
+/**
+ * Find a moodboard by the name someone would say, or by id.
+ *
+ * Exact title first, then case-insensitive, then a unique substring. An
+ * ambiguous substring is an error naming the candidates rather than a silent
+ * pick: choosing "Porsche Campaign" when someone meant "Mercedes Campaign"
+ * would be wrong in a way that costs a generation to discover.
+ */
+export function matchMoodboard(boards, query) {
+    const wanted = query.trim();
+    if (!wanted)
+        throw new NotFoundError("A moodboard name or id is required.", 404, "(local)");
+    const byId = boards.find((board) => board.id === wanted);
+    if (byId)
+        return byId;
+    const exact = boards.find((board) => board.title === wanted);
+    if (exact)
+        return exact;
+    const lower = wanted.toLowerCase();
+    const insensitive = boards.filter((board) => board.title.toLowerCase() === lower);
+    if (insensitive.length === 1 && insensitive[0])
+        return insensitive[0];
+    const partial = boards.filter((board) => board.title.toLowerCase().includes(lower));
+    if (partial.length === 1 && partial[0])
+        return partial[0];
+    if (partial.length > 1) {
+        throw new NotFoundError(`'${query}' matches ${partial.length} moodboards: ${partial.map((board) => board.title).join(", ")}. Name one exactly.`, 404, "(local)");
+    }
+    throw new NotFoundError(`No moodboard called '${query}'. Available: ${boards.map((board) => board.title).join(", ") || "none"}.`, 404, "(local)");
+}
+/**
+ * Pick references out of a moodboard.
+ *
+ * Every image would make an unusable prompt: a 242-image board becomes 242
+ * `--sref` flags. A handful is what the web app effectively does too, and
+ * spreading the pick across the board rather than taking the first few avoids
+ * always drawing on whatever was added first.
+ */
+export function pickReferences(board, count) {
+    const wanted = Math.max(1, Math.min(Math.trunc(count), 10));
+    const urls = board.images.map((image) => image.url);
+    if (urls.length === 0) {
+        throw new NotFoundError(`Moodboard '${board.title}' has no images, so there is nothing to reference. Add some in the web app first.`, 404, "(local)");
+    }
+    if (urls.length <= wanted)
+        return urls;
+    const step = urls.length / wanted;
+    return Array.from({ length: wanted }, (_, index) => urls[Math.floor(index * step)]);
+}
+/** Resolve "use my High Fashion moodboard" to the style references it means. */
+export async function referencesFromMoodboard(client, query, count) {
+    const board = matchMoodboard(await listMoodboards(client), query);
+    return { board, refs: pickReferences(board, count) };
+}
+function imageRecord(image) {
+    return {
+        url: image.url,
+        width: image.width ?? null,
+        height: image.height ?? null,
+        created: Date.now(),
+        // The app uses these to render a tile before the server confirms it. We are
+        // not rendering anything, so the record is sent already settled.
+        optimistic: false,
+        optimisticId: null,
+        state: null,
+    };
+}
+export async function createMoodboard(client, title) {
+    const name = title.trim();
+    if (!name)
+        throw new NotFoundError("A moodboard needs a title.", 400, "(local)");
+    const userId = await client.userId();
+    const raw = await client.request(ENDPOINTS.moodboards, {
+        method: "POST",
+        body: { session_id: userId, title: name },
+        noRetry: true,
+    });
+    // The response shape is not documented, so the id is looked for rather than
+    // assumed, and its absence is not treated as a failure: the board exists.
+    let id;
+    if (raw && typeof raw === "object") {
+        const record = raw;
+        const candidate = record.moodboard_id ?? record.id;
+        if (typeof candidate === "string" || typeof candidate === "number")
+            id = String(candidate);
+    }
+    return { ...(id ? { id } : {}), title: name, raw };
+}
+export async function addToMoodboard(client, moodboardId, images) {
+    if (images.length === 0) {
+        throw new NotFoundError("Nothing to add: no image URLs were given.", 400, "(local)");
+    }
+    const userId = await client.userId();
+    const raw = await client.request(`${ENDPOINTS.moodboards}?moodboard_id=${encodeURIComponent(moodboardId)}`, {
+        method: "PATCH",
+        body: { session_id: userId, add: images.map(imageRecord) },
+        noRetry: true,
+    });
+    return { added: images.length, raw };
+}
+export async function removeFromMoodboard(client, moodboardId, urls) {
+    if (urls.length === 0) {
+        throw new NotFoundError("Nothing to remove: no image URLs were given.", 400, "(local)");
+    }
+    const userId = await client.userId();
+    const raw = await client.request(`${ENDPOINTS.moodboards}?moodboard_id=${encodeURIComponent(moodboardId)}`, {
+        method: "PATCH",
+        body: { session_id: userId, remove: urls.map((url) => ({ url })) },
+        noRetry: true,
+    });
+    return { removed: urls.length, raw };
+}
+//# sourceMappingURL=moodboards.js.map

package/dist/api/moodboards.js.map

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

package/dist/capture.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Record what the Midjourney web app actually calls.
+ *
+ * Midjourney has no API documentation, so every endpoint this server knows
+ * about was learned by watching the site. The reference implementation for this
+ * API did that once, by hand, and froze the result: twelve read endpoints from
+ * a single browsing session, and no way for anyone to extend it without
+ * repeating the whole exercise.
+ *
+ * Making it a command changes that. Run capture, use the site normally, click
+ * the thing that has no tool yet, and the request appears in the output with
+ * its method, path, query and body. That is the input to a new tool, and it
+ * takes a minute rather than an afternoon.
+ *
+ * It records the account's own traffic in its own browser. It never touches the
+ * request headers, which is deliberate: the interesting part is the shape of
+ * the call, and writing session cookies into a file people will paste into
+ * issues is a good way to leak an account.
+ */
+import type { Config } from "./config.js";
+export type CaptureOptions = {
+    seconds: number;
+    outPath?: string;
+    /** Record every request, not only the ones under /api/. */
+    all?: boolean;
+};
+export declare function runCapture(config: Config, options: CaptureOptions): Promise<number>;